ai-sdk-provider-claude-code 3.1.0 → 3.2.1

package/README.md

@@ -46,17 +46,13 @@ npm install ai-sdk-provider-claude-code@ai-sdk-v4 ai@^4.3.16
 
 ## Zod Compatibility
 
-This package is **fully compatible with both Zod 3 and Zod 4**.
+**Starting from v3.2.0, this package requires Zod 4.**
 
 ```bash
-# With Zod 3
-npm install ai-sdk-provider-claude-code ai zod@^3.0.0
-
-# With Zod 4
 npm install ai-sdk-provider-claude-code ai zod@^4.0.0
 ```
 
-Both this package and the underlying `@anthropic-ai/claude-agent-sdk` declare support for both versions (`peerDependencies: "zod": "^3.24.1 || ^4.0.0"`).
+> **Note:** Zod 3 support was dropped in v3.2.0 due to the underlying `@anthropic-ai/claude-agent-sdk@0.2.x` requiring Zod 4. If you need Zod 3 support, use `ai-sdk-provider-claude-code@3.1.x`.
 
 ## Installation
 
@@ -271,11 +267,31 @@ console.log(result.object); // Guaranteed to match schema
 
 ## Agent SDK Options (Advanced)
 
-This provider now exposes additional Agent SDK options directly (e.g. `betas`, `sandbox`,
-`plugins`, `resumeSessionAt`, `enableFileCheckpointing`, `maxBudgetUsd`, `tools`,
-`allowDangerouslySkipPermissions`).
+This provider exposes Agent SDK options directly. Key options include:
+
+| Option                            | Description                                                                                               |
+| --------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `betas`                           | Enable beta features (e.g., `['context-1m-2025-08-07']`)                                                  |
+| `sandbox`                         | Configure sandbox behavior (`{ enabled: true }`)                                                          |
+| `plugins`                         | Load custom plugins from local paths                                                                      |
+| `resumeSessionAt`                 | Resume session at a specific message UUID                                                                 |
+| `enableFileCheckpointing`         | Enable file rewind support                                                                                |
+| `maxBudgetUsd`                    | Maximum budget in USD for the query                                                                       |
+| `tools`                           | Tool configuration (array of names or preset)                                                             |
+| `allowDangerouslySkipPermissions` | Allow bypassing permissions                                                                               |
+| `persistSession`                  | When `false`, disables session persistence to disk (v3.2.0+)                                              |
+| `spawnClaudeCodeProcess`          | Custom process spawner for VMs/containers (v3.2.0+)                                                       |
+| `permissionMode`                  | Permission mode: `'default'`, `'acceptEdits'`, `'bypassPermissions'`, `'plan'`, `'delegate'`, `'dontAsk'` |
+
+**Agent definitions** (`agents`) now support additional fields (v3.2.0+):
+
+- `disallowedTools` - Tools to explicitly disallow for the agent
+- `mcpServers` - MCP servers available to the agent
+- `criticalSystemReminder_EXPERIMENTAL` - Experimental critical reminder
+
+See [`ClaudeCodeSettings`](https://github.com/ben-vargas/ai-sdk-provider-claude-code/blob/main/src/types.ts) for the full list of supported options (e.g., `allowedTools`, `disallowedTools`, `hooks`, `canUseTool`, `env`, `settingSources`).
 
-For newer SDK options, use the `sdkOptions` escape hatch. It **overrides** explicit settings,
+For options not explicitly exposed, use the `sdkOptions` escape hatch. It **overrides** explicit settings,
 but provider-managed fields are ignored (`model`, `abortController`, `prompt`, `outputFormat`).
 If you set `sdkOptions.resume`, it also drives the streaming prompt `session_id` so the SDK
 and prompt target the same session.
@@ -284,6 +300,7 @@ and prompt target the same session.
 const model = claudeCode('sonnet', {
   betas: ['context-1m-2025-08-07'],
   sandbox: { enabled: true },
+  persistSession: false, // Don't persist session to disk
   sdkOptions: {
     maxBudgetUsd: 1,
     resume: 'session-abc',

package/dist/index.cjs

@@ -461,7 +461,7 @@ var claudeCodeSettingsSchema = import_zod.z.object({
   ).optional(),
   executable: import_zod.z.enum(["bun", "deno", "node"]).optional(),
   executableArgs: import_zod.z.array(import_zod.z.string()).optional(),
-  permissionMode: import_zod.z.enum(["default", "acceptEdits", "bypassPermissions", "plan"]).optional(),
+  permissionMode: import_zod.z.enum(["default", "acceptEdits", "bypassPermissions", "plan", "delegate", "dontAsk"]).optional(),
   permissionPromptToolName: import_zod.z.string().optional(),
   continue: import_zod.z.boolean().optional(),
   resume: import_zod.z.string().optional(),
@@ -542,9 +542,18 @@ var claudeCodeSettingsSchema = import_zod.z.object({
     import_zod.z.object({
       description: import_zod.z.string(),
       tools: import_zod.z.array(import_zod.z.string()).optional(),
+      disallowedTools: import_zod.z.array(import_zod.z.string()).optional(),
       prompt: import_zod.z.string(),
-      model: import_zod.z.enum(["sonnet", "opus", "haiku", "inherit"]).optional()
-    })
+      model: import_zod.z.enum(["sonnet", "opus", "haiku", "inherit"]).optional(),
+      mcpServers: import_zod.z.array(
+        import_zod.z.union([
+          import_zod.z.string(),
+          import_zod.z.record(import_zod.z.string(), import_zod.z.any())
+          // McpServerConfigForProcessTransport
+        ])
+      ).optional(),
+      criticalSystemReminder_EXPERIMENTAL: import_zod.z.string().optional()
+    }).passthrough()
   ).optional(),
   includePartialMessages: import_zod.z.boolean().optional(),
   fallbackModel: import_zod.z.string().optional(),
@@ -554,6 +563,10 @@ var claudeCodeSettingsSchema = import_zod.z.object({
   }).optional(),
   strictMcpConfig: import_zod.z.boolean().optional(),
   extraArgs: import_zod.z.record(import_zod.z.string(), import_zod.z.union([import_zod.z.string(), import_zod.z.null()])).optional(),
+  persistSession: import_zod.z.boolean().optional(),
+  spawnClaudeCodeProcess: import_zod.z.any().refine((val) => val === void 0 || typeof val === "function", {
+    message: "spawnClaudeCodeProcess must be a function"
+  }).optional(),
   sdkOptions: import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional()
 }).strict();
 function validateModelId(modelId) {
@@ -1045,6 +1058,12 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     if (this.settings.extraArgs !== void 0) {
       opts.extraArgs = this.settings.extraArgs;
     }
+    if (this.settings.persistSession !== void 0) {
+      opts.persistSession = this.settings.persistSession;
+    }
+    if (this.settings.spawnClaudeCodeProcess !== void 0) {
+      opts.spawnClaudeCodeProcess = this.settings.spawnClaudeCodeProcess;
+    }
     if (this.settings.hooks) {
       opts.hooks = this.settings.hooks;
     }
@@ -1412,6 +1431,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
         let textPartId;
         let streamedTextLength = 0;
         let hasReceivedStreamEvents = false;
+        let hasStreamedJson = false;
         try {
           controller.enqueue({ type: "stream-start", warnings });
           if (effectiveCanUseTool && effectivePermissionPromptToolName) {
@@ -1478,6 +1498,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
                   });
                   accumulatedText += jsonDelta;
                   streamedTextLength += jsonDelta.length;
+                  hasStreamedJson = true;
                 }
               }
               continue;
@@ -1490,7 +1511,15 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
                 continue;
               }
               const content = message.message.content;
-              for (const tool3 of this.extractToolUses(content)) {
+              const tools = this.extractToolUses(content);
+              if (textPartId && tools.length > 0) {
+                controller.enqueue({
+                  type: "text-end",
+                  id: textPartId
+                });
+                textPartId = void 0;
+              }
+              for (const tool3 of tools) {
                 const toolId = tool3.id;
                 let state = toolStates.get(toolId);
                 if (!state) {
@@ -1721,12 +1750,14 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               this.logger.debug(`[claude-code] Stream finish reason: ${finishReason.unified}`);
               this.setSessionId(message.session_id);
               const structuredOutput = "structured_output" in message ? message.structured_output : void 0;
-              const alreadyStreamedJson = textPartId && options.responseFormat?.type === "json" && hasReceivedStreamEvents;
-              if (alreadyStreamedJson && textPartId) {
-                controller.enqueue({
-                  type: "text-end",
-                  id: textPartId
-                });
+              const alreadyStreamedJson = hasStreamedJson && options.responseFormat?.type === "json" && hasReceivedStreamEvents;
+              if (alreadyStreamedJson) {
+                if (textPartId) {
+                  controller.enqueue({
+                    type: "text-end",
+                    id: textPartId
+                  });
+                }
               } else if (structuredOutput !== void 0) {
                 const jsonTextId = (0, import_provider_utils.generateId)();
                 const jsonText = JSON.stringify(structuredOutput);