ai-sdk-provider-claude-code 3.4.1 → 3.4.3

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { LanguageModelV3, ProviderV3, APICallError, LoadAPIKeyError } from '@ai-sdk/provider';
-import { PermissionMode, SdkBeta, SdkPluginConfig, SandboxSettings, Options, McpServerConfig, CanUseTool, AgentMcpServerSpec, SpawnOptions, SpawnedProcess, Query, SdkMcpToolDefinition, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
-export { AgentMcpServerSpec, CanUseTool, HookCallback, HookCallbackMatcher, HookEvent, HookInput, HookJSONOutput, McpSdkServerConfigWithInstance, McpServerConfig, OutputFormat, PermissionBehavior, PermissionResult, PermissionRuleValue, PermissionUpdate, PostToolUseHookInput, PreToolUseHookInput, Query, SessionEndHookInput, SessionStartHookInput, SpawnOptions, SpawnedProcess, TaskCompletedHookInput, TeammateIdleHookInput, UserPromptSubmitHookInput, createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
+import { ThinkingConfig, PermissionMode, SdkBeta, SdkPluginConfig, SandboxSettings, Options, McpServerConfig, CanUseTool, AgentMcpServerSpec, SpawnOptions, SpawnedProcess, Query, SdkMcpToolDefinition, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
+export { AgentMcpServerSpec, CanUseTool, HookCallback, HookCallbackMatcher, HookEvent, HookInput, HookJSONOutput, McpSdkServerConfigWithInstance, McpServerConfig, OutputFormat, PermissionBehavior, PermissionResult, PermissionRuleValue, PermissionUpdate, PostToolUseHookInput, PreToolUseHookInput, Query, SessionEndHookInput, SessionStartHookInput, SpawnOptions, SpawnedProcess, TaskCompletedHookInput, TeammateIdleHookInput, ThinkingAdaptive, ThinkingConfig, ThinkingDisabled, ThinkingEnabled, UserPromptSubmitHookInput, createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
 import { ZodObject, ZodRawShape } from 'zod';
 
 type StreamingInputMode = 'auto' | 'always' | 'off';
@@ -85,8 +85,37 @@ interface ClaudeCodeSettings {
     maxTurns?: number;
     /**
      * Maximum thinking tokens for the model
+     *
+     * @deprecated Use `thinking` instead.
      */
     maxThinkingTokens?: number;
+    /**
+     * Controls Claude's thinking/reasoning behavior.
+     * Takes precedence over the deprecated `maxThinkingTokens`.
+     *
+     * - `{ type: 'adaptive' }` — Claude decides when and how much to think (Opus 4.6+, default)
+     * - `{ type: 'enabled', budgetTokens?: number }` — Fixed thinking token budget
+     * - `{ type: 'disabled' }` — No extended thinking
+     *
+     * @see https://docs.anthropic.com/en/docs/build-with-claude/adaptive-thinking
+     */
+    thinking?: ThinkingConfig;
+    /**
+     * Controls how much effort Claude puts into its response.
+     *
+     * - `'low'` — Minimal thinking, fastest responses
+     * - `'medium'` — Moderate thinking
+     * - `'high'` — Deep reasoning (default)
+     * - `'max'` — Maximum effort (Opus 4.6 only)
+     *
+     * @see https://docs.anthropic.com/en/docs/build-with-claude/effort
+     */
+    effort?: 'low' | 'medium' | 'high' | 'max';
+    /**
+     * Enable prompt suggestions. When true, the agent emits a predicted
+     * next user prompt after each turn (arrives after the result message).
+     */
+    promptSuggestions?: boolean;
     /**
      * Working directory for CLI operations
      */
@@ -476,6 +505,7 @@ declare class ClaudeCodeLanguageModel implements LanguageModelV3 {
     private getModel;
     private getSanitizedSdkOptions;
     private getEffectiveResume;
+    private extractTextAndThinking;
     private extractToolUses;
     private extractToolResults;
     private extractToolErrors;
@@ -486,6 +516,7 @@ declare class ClaudeCodeLanguageModel implements LanguageModelV3 {
     private createQueryOptions;
     private handleClaudeCodeError;
     private setSessionId;
+    private logMcpConnectionIssues;
     doGenerate(options: Parameters<LanguageModelV3['doGenerate']>[0]): Promise<Awaited<ReturnType<LanguageModelV3['doGenerate']>>>;
     doStream(options: Parameters<LanguageModelV3['doStream']>[0]): Promise<Awaited<ReturnType<LanguageModelV3['doStream']>>>;
     private serializeWarningsForMetadata;
@@ -758,7 +789,7 @@ declare function createAPICallError({ message, code, exitCode, stderr, promptExc
  * @example
  * ```typescript
  * throw createAuthenticationError({
- *   message: 'Please run "claude login" to authenticate'
+ *   message: 'Please run "claude auth login" to authenticate'
  * });
  * ```
  */

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { LanguageModelV3, ProviderV3, APICallError, LoadAPIKeyError } from '@ai-sdk/provider';
-import { PermissionMode, SdkBeta, SdkPluginConfig, SandboxSettings, Options, McpServerConfig, CanUseTool, AgentMcpServerSpec, SpawnOptions, SpawnedProcess, Query, SdkMcpToolDefinition, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
-export { AgentMcpServerSpec, CanUseTool, HookCallback, HookCallbackMatcher, HookEvent, HookInput, HookJSONOutput, McpSdkServerConfigWithInstance, McpServerConfig, OutputFormat, PermissionBehavior, PermissionResult, PermissionRuleValue, PermissionUpdate, PostToolUseHookInput, PreToolUseHookInput, Query, SessionEndHookInput, SessionStartHookInput, SpawnOptions, SpawnedProcess, TaskCompletedHookInput, TeammateIdleHookInput, UserPromptSubmitHookInput, createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
+import { ThinkingConfig, PermissionMode, SdkBeta, SdkPluginConfig, SandboxSettings, Options, McpServerConfig, CanUseTool, AgentMcpServerSpec, SpawnOptions, SpawnedProcess, Query, SdkMcpToolDefinition, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
+export { AgentMcpServerSpec, CanUseTool, HookCallback, HookCallbackMatcher, HookEvent, HookInput, HookJSONOutput, McpSdkServerConfigWithInstance, McpServerConfig, OutputFormat, PermissionBehavior, PermissionResult, PermissionRuleValue, PermissionUpdate, PostToolUseHookInput, PreToolUseHookInput, Query, SessionEndHookInput, SessionStartHookInput, SpawnOptions, SpawnedProcess, TaskCompletedHookInput, TeammateIdleHookInput, ThinkingAdaptive, ThinkingConfig, ThinkingDisabled, ThinkingEnabled, UserPromptSubmitHookInput, createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
 import { ZodObject, ZodRawShape } from 'zod';
 
 type StreamingInputMode = 'auto' | 'always' | 'off';
@@ -85,8 +85,37 @@ interface ClaudeCodeSettings {
     maxTurns?: number;
     /**
      * Maximum thinking tokens for the model
+     *
+     * @deprecated Use `thinking` instead.
      */
     maxThinkingTokens?: number;
+    /**
+     * Controls Claude's thinking/reasoning behavior.
+     * Takes precedence over the deprecated `maxThinkingTokens`.
+     *
+     * - `{ type: 'adaptive' }` — Claude decides when and how much to think (Opus 4.6+, default)
+     * - `{ type: 'enabled', budgetTokens?: number }` — Fixed thinking token budget
+     * - `{ type: 'disabled' }` — No extended thinking
+     *
+     * @see https://docs.anthropic.com/en/docs/build-with-claude/adaptive-thinking
+     */
+    thinking?: ThinkingConfig;
+    /**
+     * Controls how much effort Claude puts into its response.
+     *
+     * - `'low'` — Minimal thinking, fastest responses
+     * - `'medium'` — Moderate thinking
+     * - `'high'` — Deep reasoning (default)
+     * - `'max'` — Maximum effort (Opus 4.6 only)
+     *
+     * @see https://docs.anthropic.com/en/docs/build-with-claude/effort
+     */
+    effort?: 'low' | 'medium' | 'high' | 'max';
+    /**
+     * Enable prompt suggestions. When true, the agent emits a predicted
+     * next user prompt after each turn (arrives after the result message).
+     */
+    promptSuggestions?: boolean;
     /**
      * Working directory for CLI operations
      */
@@ -476,6 +505,7 @@ declare class ClaudeCodeLanguageModel implements LanguageModelV3 {
     private getModel;
     private getSanitizedSdkOptions;
     private getEffectiveResume;
+    private extractTextAndThinking;
     private extractToolUses;
     private extractToolResults;
     private extractToolErrors;
@@ -486,6 +516,7 @@ declare class ClaudeCodeLanguageModel implements LanguageModelV3 {
     private createQueryOptions;
     private handleClaudeCodeError;
     private setSessionId;
+    private logMcpConnectionIssues;
     doGenerate(options: Parameters<LanguageModelV3['doGenerate']>[0]): Promise<Awaited<ReturnType<LanguageModelV3['doGenerate']>>>;
     doStream(options: Parameters<LanguageModelV3['doStream']>[0]): Promise<Awaited<ReturnType<LanguageModelV3['doStream']>>>;
     private serializeWarningsForMetadata;
@@ -758,7 +789,7 @@ declare function createAPICallError({ message, code, exitCode, stderr, promptExc
  * @example
  * ```typescript
  * throw createAuthenticationError({
- *   message: 'Please run "claude login" to authenticate'
+ *   message: 'Please run "claude auth login" to authenticate'
  * });
  * ```
  */

package/dist/index.js

@@ -428,6 +428,16 @@ var claudeCodeSettingsSchema = z.object({
   ]).optional(),
   maxTurns: z.number().int().min(1).max(100).optional(),
   maxThinkingTokens: z.number().int().positive().max(1e5).optional(),
+  thinking: z.union([
+    z.object({ type: z.literal("adaptive") }).strict(),
+    z.object({
+      type: z.literal("enabled"),
+      budgetTokens: z.number().int().positive().optional()
+    }).strict(),
+    z.object({ type: z.literal("disabled") }).strict()
+  ]).optional(),
+  effort: z.enum(["low", "medium", "high", "max"]).optional(),
+  promptSuggestions: z.boolean().optional(),
   cwd: z.string().refine(
     (val) => {
       if (typeof process === "undefined" || !process.versions?.node) {
@@ -754,6 +764,22 @@ function getBaseProcessEnv() {
 }
 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 isContentBlock(item) {
+  return typeof item === "object" && item !== null && "type" in item;
+}
+function filterContentBlocks(content, type) {
+  if (!Array.isArray(content)) return [];
+  const blocks = content.filter(
+    (item) => isContentBlock(item) && item.type === type
+  );
+  const mismatch = blocks.find((b) => b.type !== type);
+  if (mismatch) {
+    throw new Error(
+      `filterContentBlocks: block type '${mismatch.type}' passed filter for '${type}'`
+    );
+  }
+  return blocks;
+}
 function createEmptyUsage() {
   return {
     inputTokens: {
@@ -1009,14 +1035,29 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
   getEffectiveResume(sdkOptions) {
     return sdkOptions?.resume ?? this.settings.resume ?? this.sessionId;
   }
-  extractToolUses(content) {
-    if (!Array.isArray(content)) {
-      return [];
+  extractTextAndThinking(content) {
+    if (!Array.isArray(content)) return { text: "", thinking: [] };
+    let text = "";
+    const thinking = [];
+    for (const part of content) {
+      if (!isContentBlock(part)) continue;
+      if (part.type === "text" && typeof part.text === "string") {
+        text += part.text;
+      } else if (part.type === "thinking" && typeof part.thinking === "string") {
+        thinking.push(part.thinking);
+      }
+    }
+    if (text.length > 0 && typeof text !== "string") {
+      throw new Error("extractTextAndThinking: accumulated text must be a string");
+    }
+    if (thinking.some((t) => typeof t !== "string")) {
+      throw new Error("extractTextAndThinking: all thinking entries must be strings");
     }
-    return content.filter(
-      (item) => typeof item === "object" && item !== null && "type" in item && item.type === "tool_use"
-    ).map((item) => {
-      const { id, name, input, parent_tool_use_id } = item;
+    return { text, thinking };
+  }
+  extractToolUses(content) {
+    return filterContentBlocks(content, "tool_use").map((block) => {
+      const { id, name, input, parent_tool_use_id } = block;
       return {
         id: typeof id === "string" && id.length > 0 ? id : generateId(),
         name: typeof name === "string" && name.length > 0 ? name : _ClaudeCodeLanguageModel.UNKNOWN_TOOL_NAME,
@@ -1026,13 +1067,8 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     });
   }
   extractToolResults(content) {
-    if (!Array.isArray(content)) {
-      return [];
-    }
-    return content.filter(
-      (item) => typeof item === "object" && item !== null && "type" in item && item.type === "tool_result"
-    ).map((item) => {
-      const { tool_use_id, content: content2, is_error, name } = item;
+    return filterContentBlocks(content, "tool_result").map((block) => {
+      const { tool_use_id, content: content2, is_error, name } = block;
       return {
         id: typeof tool_use_id === "string" && tool_use_id.length > 0 ? tool_use_id : generateId(),
         name: typeof name === "string" && name.length > 0 ? name : void 0,
@@ -1042,13 +1078,8 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     });
   }
   extractToolErrors(content) {
-    if (!Array.isArray(content)) {
-      return [];
-    }
-    return content.filter(
-      (item) => typeof item === "object" && item !== null && "type" in item && item.type === "tool_error"
-    ).map((item) => {
-      const { tool_use_id, error, name } = item;
+    return filterContentBlocks(content, "tool_error").map((block) => {
+      const { tool_use_id, error, name } = block;
       return {
         id: typeof tool_use_id === "string" && tool_use_id.length > 0 ? tool_use_id : generateId(),
         name: typeof name === "string" && name.length > 0 ? name : void 0,
@@ -1172,6 +1203,9 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       pathToClaudeCodeExecutable: this.settings.pathToClaudeCodeExecutable,
       maxTurns: this.settings.maxTurns,
       maxThinkingTokens: this.settings.maxThinkingTokens,
+      thinking: this.settings.thinking,
+      effort: this.settings.effort,
+      promptSuggestions: this.settings.promptSuggestions,
       cwd: this.settings.cwd,
       executable: this.settings.executable,
       executableArgs: this.settings.executableArgs,
@@ -1295,6 +1329,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       "auth failed",
       "please login",
       "claude login",
+      "claude auth login",
       "/login",
       // CLI returns "Please run /login"
       "invalid api key"
@@ -1335,6 +1370,25 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       this.logger.warn(`Claude Code Session: ${warning}`);
     }
   }
+  logMcpConnectionIssues(mcpServers) {
+    if (!Array.isArray(mcpServers) || mcpServers.length === 0) {
+      return;
+    }
+    const serversNeedingAttention = mcpServers.filter((server) => {
+      const status = typeof server.status === "string" ? server.status.toLowerCase() : "";
+      return status === "failed" || status === "needs-auth";
+    });
+    if (serversNeedingAttention.length === 0) {
+      return;
+    }
+    const details = serversNeedingAttention.map((server) => {
+      const name = typeof server.name === "string" && server.name.trim().length > 0 ? server.name : "<unknown>";
+      const status = typeof server.status === "string" && server.status.trim().length > 0 ? server.status : "unknown";
+      const error = typeof server.error === "string" && server.error.trim().length > 0 ? ` (${server.error})` : "";
+      return `${name}:${status}${error}`;
+    }).join(", ");
+    this.logger.warn(`[claude-code] MCP servers not connected: ${details}`);
+  }
   async doGenerate(options) {
     this.logger.debug(`[claude-code] Starting doGenerate request with model: ${this.modelId}`);
     this.logger.debug(`[claude-code] Response format: ${options.responseFormat?.type ?? "none"}`);
@@ -1369,6 +1423,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       effectiveResume
     );
     let text = "";
+    const thinkingTraces = [];
     let structuredOutput;
     let usage = createEmptyUsage();
     let finishReason = { unified: "stop", raw: void 0 };
@@ -1424,7 +1479,11 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       for await (const message of response) {
         this.logger.debug(`[claude-code] Received message type: ${message.type}`);
         if (message.type === "assistant") {
-          text += message.message.content.map((c) => c.type === "text" ? c.text : "").join("");
+          const { text: messageText, thinking: messageThinking } = this.extractTextAndThinking(
+            message.message.content
+          );
+          text += messageText;
+          thinkingTraces.push(...messageThinking);
         } else if (message.type === "result") {
           done();
           this.setSessionId(message.session_id);
@@ -1457,6 +1516,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           finishReason = mapClaudeCodeFinishReason(message.subtype, stopReason);
           this.logger.debug(`[claude-code] Finish reason: ${finishReason.unified}`);
         } else if (message.type === "system" && message.subtype === "init") {
+          this.logMcpConnectionIssues(message.mcp_servers);
           this.setSessionId(message.session_id);
           this.logger.info(`[claude-code] Session initialized: ${message.session_id}`);
         }
@@ -1490,7 +1550,13 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     }
     const finalText = structuredOutput !== void 0 ? JSON.stringify(structuredOutput) : text;
     return {
-      content: [{ type: "text", text: finalText }],
+      content: [
+        ...thinkingTraces.map((trace) => ({
+          type: "reasoning",
+          text: trace
+        })),
+        { type: "text", text: finalText }
+      ],
       usage,
       finishReason,
       warnings,
@@ -1508,7 +1574,8 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           ...costUsd !== void 0 && { costUsd },
           ...durationMs !== void 0 && { durationMs },
           ...modelUsage !== void 0 && { modelUsage },
-          ...wasTruncated && { truncated: true }
+          ...wasTruncated && { truncated: true },
+          ...thinkingTraces.length > 0 && { thinkingTraces }
         }
       }
     };
@@ -2278,6 +2345,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               controller.close();
               return;
             } else if (message.type === "system" && message.subtype === "init") {
+              this.logMcpConnectionIssues(message.mcp_servers);
               this.setSessionId(message.session_id);
               this.logger.info(`[claude-code] Stream session initialized: ${message.session_id}`);
               controller.enqueue({