ai-sdk-provider-claude-code 2.2.3 → 2.3.0

package/README.md

@@ -9,7 +9,7 @@
 
 # AI SDK Provider for Claude Code SDK
 
-> **Latest Release**: Version 2.x uses the Claude Agent SDK with native structured outputs support (v2.2.0+). For AI SDK v4 support, use the `ai-sdk-v4` tag or version 0.2.x.
+> **Latest Release**: Version 2.x uses the Claude Agent SDK with native structured outputs support (v2.2.0+). For AI SDK v6 beta support, use the `beta` tag. For AI SDK v4 support, use the `ai-sdk-v4` tag.
 
 **ai-sdk-provider-claude-code** lets you use Claude via the [Vercel AI SDK](https://sdk.vercel.ai/docs) through the official `@anthropic-ai/claude-agent-sdk` and the Claude Code CLI.
 
@@ -17,13 +17,22 @@
 
 | Provider Version | AI SDK Version | Underlying SDK                       | NPM Tag              | Status | Branch                                                                                  |
 | ---------------- | -------------- | ------------------------------------ | -------------------- | ------ | --------------------------------------------------------------------------------------- |
+| 3.x.x-beta       | v6 (beta)      | `@anthropic-ai/claude-agent-sdk`     | `beta`               | Beta   | [`ai-sdk-v6`](https://github.com/ben-vargas/ai-sdk-provider-claude-code/tree/ai-sdk-v6) |
 | 2.x.x            | v5             | `@anthropic-ai/claude-agent-sdk`     | `latest`             | Stable | `main`                                                                                  |
 | 1.x.x            | v5             | `@anthropic-ai/claude-code` (legacy) | `v1-claude-code-sdk` | Stable | [`v1`](https://github.com/ben-vargas/ai-sdk-provider-claude-code/tree/v1)               |
 | 0.x.x            | v4             | `@anthropic-ai/claude-code`          | `ai-sdk-v4`          | Legacy | [`ai-sdk-v4`](https://github.com/ben-vargas/ai-sdk-provider-claude-code/tree/ai-sdk-v4) |
 
 ### Installing the Right Version
 
-**For AI SDK v5 with Claude Agent SDK (recommended):**
+**For AI SDK v6 beta (early adopters):**
+
+```bash
+npm install ai-sdk-provider-claude-code@beta ai@beta
+```
+
+> ⚠️ **Note:** AI SDK v6 is in beta. The `ai-sdk-v6` branch and `beta` npm tag track upstream changes. When v6 goes stable, this will be merged to `main` and released as 3.0.0.
+
+**For AI SDK v5 with Claude Agent SDK (recommended for production):**
 
 ```bash
 npm install ai-sdk-provider-claude-code ai
@@ -308,6 +317,28 @@ console.log(result.object); // Guaranteed to match schema
 - 🔧 Tool management (MCP servers, permissions)
 - 🧩 Callbacks (hooks, canUseTool)
 
+## Agent SDK Options (Advanced)
+
+This provider now exposes additional Agent SDK options directly (e.g. `betas`, `sandbox`,
+`plugins`, `resumeSessionAt`, `enableFileCheckpointing`, `maxBudgetUsd`, `tools`,
+`allowDangerouslySkipPermissions`).
+
+For newer SDK options, 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.
+
+```ts
+const model = claudeCode('sonnet', {
+  betas: ['context-1m-2025-08-07'],
+  sandbox: { enabled: true },
+  sdkOptions: {
+    maxBudgetUsd: 1,
+    resume: 'session-abc',
+  },
+});
+```
+
 ## Image Inputs (Streaming Only)
 
 - Enable streaming input (`streamingInput: 'always'` or provide `canUseTool`) before sending images.

package/dist/index.cjs

@@ -450,6 +450,27 @@ var claudeCodeSettingsSchema = import_zod.z.object({
   resume: import_zod.z.string().optional(),
   allowedTools: import_zod.z.array(import_zod.z.string()).optional(),
   disallowedTools: import_zod.z.array(import_zod.z.string()).optional(),
+  betas: import_zod.z.array(import_zod.z.string()).optional(),
+  allowDangerouslySkipPermissions: import_zod.z.boolean().optional(),
+  enableFileCheckpointing: import_zod.z.boolean().optional(),
+  maxBudgetUsd: import_zod.z.number().min(0).optional(),
+  plugins: import_zod.z.array(
+    import_zod.z.object({
+      type: import_zod.z.string(),
+      path: import_zod.z.string()
+    }).passthrough()
+  ).optional(),
+  resumeSessionAt: import_zod.z.string().optional(),
+  sandbox: import_zod.z.any().refine((val) => val === void 0 || typeof val === "object", {
+    message: "sandbox must be an object"
+  }).optional(),
+  tools: import_zod.z.union([
+    import_zod.z.array(import_zod.z.string()),
+    import_zod.z.object({
+      type: import_zod.z.literal("preset"),
+      preset: import_zod.z.literal("claude_code")
+    })
+  ]).optional(),
   settingSources: import_zod.z.array(import_zod.z.enum(["user", "project", "local"])).optional(),
   streamingInput: import_zod.z.enum(["auto", "always", "off"]).optional(),
   // Hooks and tool-permission callback (permissive validation of shapes)
@@ -515,7 +536,8 @@ var claudeCodeSettingsSchema = import_zod.z.object({
     message: "stderr must be a function"
   }).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()
+  extraArgs: import_zod.z.record(import_zod.z.string(), import_zod.z.union([import_zod.z.string(), import_zod.z.null()])).optional(),
+  sdkOptions: import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional()
 }).strict();
 function validateModelId(modelId) {
   const knownModels = ["opus", "sonnet", "haiku"];
@@ -592,7 +614,9 @@ function validateSessionId(sessionId) {
 
 // src/logger.ts
 var defaultLogger = {
+  // eslint-disable-next-line no-console
   debug: (message) => console.debug(`[DEBUG] ${message}`),
+  // eslint-disable-next-line no-console
   info: (message) => console.info(`[INFO] ${message}`),
   warn: (message) => console.warn(`[WARN] ${message}`),
   error: (message) => console.error(`[ERROR] ${message}`)
@@ -674,6 +698,7 @@ function isAbortError(err) {
   return false;
 }
 var STREAMING_FEATURE_WARNING = "Claude Agent SDK features (hooks/MCP/images) require streaming input. Set `streamingInput: 'always'` or provide `canUseTool` (auto streams only when canUseTool is set).";
+var SDK_OPTIONS_BLOCKLIST = /* @__PURE__ */ new Set(["model", "abortController", "prompt", "outputFormat"]);
 function toAsyncIterablePrompt(messagesPrompt, outputStreamEnded, sessionId, contentParts) {
   const content = contentParts && contentParts.length > 0 ? contentParts : [{ type: "text", text: messagesPrompt }];
   const msg = {
@@ -742,6 +767,25 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     const mapped = modelMap[this.modelId];
     return mapped ?? this.modelId;
   }
+  getSanitizedSdkOptions() {
+    if (!this.settings.sdkOptions || typeof this.settings.sdkOptions !== "object") {
+      return void 0;
+    }
+    const sanitized = { ...this.settings.sdkOptions };
+    const blockedKeys = Array.from(SDK_OPTIONS_BLOCKLIST).filter((key) => key in sanitized);
+    if (blockedKeys.length > 0) {
+      this.logger.warn(
+        `[claude-code] sdkOptions includes provider-managed fields (${blockedKeys.join(
+          ", "
+        )}); these will be ignored.`
+      );
+      blockedKeys.forEach((key) => delete sanitized[key]);
+    }
+    return sanitized;
+  }
+  getEffectiveResume(sdkOptions) {
+    return sdkOptions?.resume ?? this.settings.resume ?? this.sessionId;
+  }
   extractToolUses(content) {
     if (!Array.isArray(content)) {
       return [];
@@ -875,11 +919,11 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     }
     return warnings;
   }
-  createQueryOptions(abortController, responseFormat) {
+  createQueryOptions(abortController, responseFormat, stderrCollector, sdkOptions, effectiveResume) {
     const opts = {
       model: this.getModel(),
       abortController,
-      resume: this.settings.resume ?? this.sessionId,
+      resume: effectiveResume ?? this.settings.resume ?? this.sessionId,
       pathToClaudeCodeExecutable: this.settings.pathToClaudeCodeExecutable,
       maxTurns: this.settings.maxTurns,
       maxThinkingTokens: this.settings.maxThinkingTokens,
@@ -891,6 +935,14 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       continue: this.settings.continue,
       allowedTools: this.settings.allowedTools,
       disallowedTools: this.settings.disallowedTools,
+      betas: this.settings.betas,
+      allowDangerouslySkipPermissions: this.settings.allowDangerouslySkipPermissions,
+      enableFileCheckpointing: this.settings.enableFileCheckpointing,
+      maxBudgetUsd: this.settings.maxBudgetUsd,
+      plugins: this.settings.plugins,
+      resumeSessionAt: this.settings.resumeSessionAt,
+      sandbox: this.settings.sandbox,
+      tools: this.settings.tools,
       mcpServers: this.settings.mcpServers,
       canUseTool: this.settings.canUseTool
     };
@@ -929,9 +981,6 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     if (this.settings.forkSession !== void 0) {
       opts.forkSession = this.settings.forkSession;
     }
-    if (this.settings.stderr !== void 0) {
-      opts.stderr = this.settings.stderr;
-    }
     if (this.settings.strictMcpConfig !== void 0) {
       opts.strictMcpConfig = this.settings.strictMcpConfig;
     }
@@ -941,8 +990,24 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     if (this.settings.hooks) {
       opts.hooks = this.settings.hooks;
     }
-    if (this.settings.env !== void 0) {
-      opts.env = { ...process.env, ...this.settings.env };
+    const sdkOverrides = sdkOptions ? sdkOptions : void 0;
+    const sdkEnv = sdkOverrides && typeof sdkOverrides.env === "object" && sdkOverrides.env !== null ? sdkOverrides.env : void 0;
+    const sdkStderr = sdkOverrides && typeof sdkOverrides.stderr === "function" ? sdkOverrides.stderr : void 0;
+    if (sdkOverrides) {
+      const rest = { ...sdkOverrides };
+      delete rest.env;
+      delete rest.stderr;
+      Object.assign(opts, rest);
+    }
+    const userStderrCallback = sdkStderr ?? this.settings.stderr;
+    if (stderrCollector || userStderrCallback) {
+      opts.stderr = (data) => {
+        if (stderrCollector) stderrCollector(data);
+        if (userStderrCallback) userStderrCallback(data);
+      };
+    }
+    if (this.settings.env !== void 0 || sdkEnv !== void 0) {
+      opts.env = { ...process.env, ...this.settings.env, ...sdkEnv };
     }
     if (responseFormat?.type === "json" && responseFormat.schema) {
       opts.outputFormat = {
@@ -952,7 +1017,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     }
     return opts;
   }
-  handleClaudeCodeError(error, messagesPrompt) {
+  handleClaudeCodeError(error, messagesPrompt, collectedStderr) {
     if (isAbortError(error)) {
       throw error;
     }
@@ -988,11 +1053,13 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       });
     }
     const isRetryable = errorCode === "ENOENT" || errorCode === "ECONNREFUSED" || errorCode === "ETIMEDOUT" || errorCode === "ECONNRESET";
+    const stderrFromError = isErrorWithCode(error) && typeof error.stderr === "string" ? error.stderr : void 0;
+    const stderr = stderrFromError || collectedStderr || void 0;
     return createAPICallError({
       message: isErrorWithMessage(error) && error.message ? error.message : "Claude Code SDK error",
       code: errorCode || void 0,
       exitCode,
-      stderr: isErrorWithCode(error) && typeof error.stderr === "string" ? error.stderr : void 0,
+      stderr,
       promptExcerpt: messagesPrompt.substring(0, 200),
       isRetryable
     });
@@ -1024,7 +1091,19 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       abortListener = () => abortController.abort(options.abortSignal?.reason);
       options.abortSignal.addEventListener("abort", abortListener, { once: true });
     }
-    const queryOptions = this.createQueryOptions(abortController, options.responseFormat);
+    let collectedStderr = "";
+    const stderrCollector = (data) => {
+      collectedStderr += data;
+    };
+    const sdkOptions = this.getSanitizedSdkOptions();
+    const effectiveResume = this.getEffectiveResume(sdkOptions);
+    const queryOptions = this.createQueryOptions(
+      abortController,
+      options.responseFormat,
+      stderrCollector,
+      sdkOptions,
+      effectiveResume
+    );
     let text = "";
     let structuredOutput;
     let usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
@@ -1046,7 +1125,9 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       });
     }
     const modeSetting = this.settings.streamingInput ?? "auto";
-    const wantsStreamInput = modeSetting === "always" || modeSetting === "auto" && !!this.settings.canUseTool;
+    const effectiveCanUseTool = sdkOptions?.canUseTool ?? this.settings.canUseTool;
+    const effectivePermissionPromptToolName = sdkOptions?.permissionPromptToolName ?? this.settings.permissionPromptToolName;
+    const wantsStreamInput = modeSetting === "always" || modeSetting === "auto" && !!effectiveCanUseTool;
     if (!wantsStreamInput && hasImageParts) {
       warnings.push({
         type: "other",
@@ -1059,7 +1140,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       done = () => resolve(void 0);
     });
     try {
-      if (this.settings.canUseTool && this.settings.permissionPromptToolName) {
+      if (effectiveCanUseTool && effectivePermissionPromptToolName) {
         throw new Error(
           "canUseTool requires streamingInput mode ('auto' or 'always') and cannot be used with permissionPromptToolName (SDK constraint). Set streamingInput: 'auto' (or 'always') and remove permissionPromptToolName, or remove canUseTool."
         );
@@ -1067,11 +1148,11 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       const sdkPrompt = wantsStreamInput ? toAsyncIterablePrompt(
         messagesPrompt,
         outputStreamEnded,
-        this.settings.resume ?? this.sessionId,
+        effectiveResume,
         streamingContentParts
       ) : messagesPrompt;
       this.logger.debug(
-        `[claude-code] Executing query with streamingInput: ${wantsStreamInput}, session: ${this.settings.resume ?? this.sessionId ?? "new"}`
+        `[claude-code] Executing query with streamingInput: ${wantsStreamInput}, session: ${effectiveResume ?? "new"}`
       );
       const response = (0, import_claude_agent_sdk.query)({
         prompt: sdkPrompt,
@@ -1136,7 +1217,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           message: CLAUDE_CODE_TRUNCATION_WARNING
         });
       } else {
-        throw this.handleClaudeCodeError(error, messagesPrompt);
+        throw this.handleClaudeCodeError(error, messagesPrompt, collectedStderr);
       }
     } finally {
       if (options.abortSignal && abortListener) {
@@ -1188,7 +1269,19 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       abortListener = () => abortController.abort(options.abortSignal?.reason);
       options.abortSignal.addEventListener("abort", abortListener, { once: true });
     }
-    const queryOptions = this.createQueryOptions(abortController, options.responseFormat);
+    let collectedStderr = "";
+    const stderrCollector = (data) => {
+      collectedStderr += data;
+    };
+    const sdkOptions = this.getSanitizedSdkOptions();
+    const effectiveResume = this.getEffectiveResume(sdkOptions);
+    const queryOptions = this.createQueryOptions(
+      abortController,
+      options.responseFormat,
+      stderrCollector,
+      sdkOptions,
+      effectiveResume
+    );
     if (queryOptions.includePartialMessages === void 0) {
       queryOptions.includePartialMessages = true;
     }
@@ -1205,7 +1298,9 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       });
     }
     const modeSetting = this.settings.streamingInput ?? "auto";
-    const wantsStreamInput = modeSetting === "always" || modeSetting === "auto" && !!this.settings.canUseTool;
+    const effectiveCanUseTool = sdkOptions?.canUseTool ?? this.settings.canUseTool;
+    const effectivePermissionPromptToolName = sdkOptions?.permissionPromptToolName ?? this.settings.permissionPromptToolName;
+    const wantsStreamInput = modeSetting === "always" || modeSetting === "auto" && !!effectiveCanUseTool;
     if (!wantsStreamInput && hasImageParts) {
       warnings.push({
         type: "other",
@@ -1267,7 +1362,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
         let hasReceivedStreamEvents = false;
         try {
           controller.enqueue({ type: "stream-start", warnings });
-          if (this.settings.canUseTool && this.settings.permissionPromptToolName) {
+          if (effectiveCanUseTool && effectivePermissionPromptToolName) {
             throw new Error(
               "canUseTool requires streamingInput mode ('auto' or 'always') and cannot be used with permissionPromptToolName (SDK constraint). Set streamingInput: 'auto' (or 'always') and remove permissionPromptToolName, or remove canUseTool."
             );
@@ -1275,11 +1370,11 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           const sdkPrompt = wantsStreamInput ? toAsyncIterablePrompt(
             messagesPrompt,
             outputStreamEnded,
-            this.settings.resume ?? this.sessionId,
+            effectiveResume,
             streamingContentParts
           ) : messagesPrompt;
           this.logger.debug(
-            `[claude-code] Starting stream query with streamingInput: ${wantsStreamInput}, session: ${this.settings.resume ?? this.sessionId ?? "new"}`
+            `[claude-code] Starting stream query with streamingInput: ${wantsStreamInput}, session: ${effectiveResume ?? "new"}`
           );
           const response = (0, import_claude_agent_sdk.query)({
             prompt: sdkPrompt,
@@ -1715,7 +1810,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           if (isAbortError(error)) {
             errorToEmit = options.abortSignal?.aborted ? options.abortSignal.reason : error;
           } else {
-            errorToEmit = this.handleClaudeCodeError(error, messagesPrompt);
+            errorToEmit = this.handleClaudeCodeError(error, messagesPrompt, collectedStderr);
           }
           controller.enqueue({
             type: "error",