From fef332d213404bc85505e8734fa6abf6aafceac7 Mon Sep 17 00:00:00 2001
From: Alex Newman <thedotmack@gmail.com>
Date: Wed, 31 Dec 2025 16:37:49 -0500
Subject: [PATCH] feat: add examples for Claude Agent SDK V2 including basic,
 multi-turn, one-shot, and session resume functionalities

---
 docs/context/agent-sdk-v2-examples.ts | 128 ++++++++++++++++++++++++++
 1 file changed, 128 insertions(+)
 create mode 100644 docs/context/agent-sdk-v2-examples.ts

diff --git a/docs/context/agent-sdk-v2-examples.ts b/docs/context/agent-sdk-v2-examples.ts
new file mode 100644
index 00000000..961581d7
--- /dev/null
+++ b/docs/context/agent-sdk-v2-examples.ts
@@ -0,0 +1,128 @@
+/**
+ * Claude Agent SDK V2 Examples
+ *
+ * The V2 API provides a session-based interface with separate send()/receive(),
+ * ideal for multi-turn conversations. Run with: npx tsx v2-examples.ts
+ */
+
+import {
+  unstable_v2_createSession,
+  unstable_v2_resumeSession,
+  unstable_v2_prompt,
+} from '@anthropic-ai/claude-agent-sdk';
+
+async function main() {
+  const example = process.argv[2] || 'basic';
+
+  switch (example) {
+    case 'basic':
+      await basicSession();
+      break;
+    case 'multi-turn':
+      await multiTurn();
+      break;
+    case 'one-shot':
+      await oneShot();
+      break;
+    case 'resume':
+      await sessionResume();
+      break;
+    default:
+      console.log('Usage: npx tsx v2-examples.ts [basic|multi-turn|one-shot|resume]');
+  }
+}
+
+// Basic session with send/receive pattern
+async function basicSession() {
+  console.log('=== Basic Session ===\n');
+
+  await using session = unstable_v2_createSession({ model: 'sonnet' });
+  await session.send('Hello! Introduce yourself in one sentence.');
+
+  for await (const msg of session.receive()) {
+    if (msg.type === 'assistant') {
+      const text = msg.message.content.find((c): c is { type: 'text'; text: string } => c.type === 'text');
+      console.log(`Claude: ${text?.text}`);
+    }
+  }
+}
+
+// Multi-turn conversation - V2's key advantage
+async function multiTurn() {
+  console.log('=== Multi-Turn Conversation ===\n');
+
+  await using session = unstable_v2_createSession({ model: 'sonnet' });
+
+  // Turn 1
+  await session.send('What is 5 + 3? Just the number.');
+  for await (const msg of session.receive()) {
+    if (msg.type === 'assistant') {
+      const text = msg.message.content.find((c): c is { type: 'text'; text: string } => c.type === 'text');
+      console.log(`Turn 1: ${text?.text}`);
+    }
+  }
+
+  // Turn 2 - Claude remembers context
+  await session.send('Multiply that by 2. Just the number.');
+  for await (const msg of session.receive()) {
+    if (msg.type === 'assistant') {
+      const text = msg.message.content.find((c): c is { type: 'text'; text: string } => c.type === 'text');
+      console.log(`Turn 2: ${text?.text}`);
+    }
+  }
+}
+
+// One-shot convenience function
+async function oneShot() {
+  console.log('=== One-Shot Prompt ===\n');
+
+  const result = await unstable_v2_prompt('What is the capital of France? One word.', { model: 'sonnet' });
+
+  if (result.subtype === 'success') {
+    console.log(`Answer: ${result.result}`);
+    console.log(`Cost: $${result.total_cost_usd.toFixed(4)}`);
+  }
+}
+
+// Session resume - persist context across sessions
+async function sessionResume() {
+  console.log('=== Session Resume ===\n');
+
+  let sessionId: string | undefined;
+
+  // First session - establish a memory
+  {
+    await using session = unstable_v2_createSession({ model: 'sonnet' });
+    console.log('[Session 1] Telling Claude my favorite color...');
+    await session.send('My favorite color is blue. Remember this!');
+
+    for await (const msg of session.receive()) {
+      if (msg.type === 'system' && msg.subtype === 'init') {
+        sessionId = msg.session_id;
+        console.log(`[Session 1] ID: ${sessionId}`);
+      }
+      if (msg.type === 'assistant') {
+        const text = msg.message.content.find((c): c is { type: 'text'; text: string } => c.type === 'text');
+        console.log(`[Session 1] Claude: ${text?.text}\n`);
+      }
+    }
+  }
+
+  console.log('--- Session closed. Time passes... ---\n');
+
+  // Resume and verify Claude remembers
+  {
+    await using session = unstable_v2_resumeSession(sessionId!, { model: 'sonnet' });
+    console.log('[Session 2] Resuming and asking Claude...');
+    await session.send('What is my favorite color?');
+
+    for await (const msg of session.receive()) {
+      if (msg.type === 'assistant') {
+        const text = msg.message.content.find((c): c is { type: 'text'; text: string } => c.type === 'text');
+        console.log(`[Session 2] Claude: ${text?.text}`);
+      }
+    }
+  }
+}
+
+main().catch(console.error);
\ No newline at end of file