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

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, 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, UserPromptSubmitHookInput, createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
+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 { ZodObject, ZodRawShape } from 'zod';
 
 type StreamingInputMode = 'auto' | 'always' | 'off';
@@ -117,6 +117,11 @@ interface ClaudeCodeSettings {
      * Resume a specific session by ID
      */
     resume?: string;
+    /**
+     * Use a specific session ID for this query.
+     * Allows deterministic session identifiers for tracking and correlation.
+     */
+    sessionId?: string;
     /**
      * Tools to explicitly allow during execution
      * Examples: ['Read', 'LS', 'Bash(git log:*)']
@@ -195,6 +200,14 @@ interface ClaudeCodeSettings {
      * Enable verbose logging for debugging
      */
     verbose?: boolean;
+    /**
+     * Enable programmatic debug logging from the SDK.
+     */
+    debug?: boolean;
+    /**
+     * Path to a file for SDK debug log output.
+     */
+    debugFile?: string;
     /**
      * Custom logger for handling warnings and errors.
      * - Set to `false` to disable all logging
@@ -592,6 +605,12 @@ type ContentAnnotations = {
     /** ISO 8601 timestamp of last modification */
     lastModified?: string;
 };
+/**
+ * MCP tool annotations for hinting tool behavior to the model.
+ * Derived from the SDK's SdkMcpToolDefinition type to stay in sync
+ * with the upstream MCP ToolAnnotations definition.
+ */
+type ToolAnnotations = NonNullable<SdkMcpToolDefinition['annotations']>;
 /**
  * Convenience helper to create an SDK MCP server from a simple tool map.
  * Each tool provides a description, a Zod object schema, and a handler.
@@ -670,6 +689,7 @@ declare function createCustomMcpServer<Tools extends Record<string, {
     description: string;
     inputSchema: ZodObject<ZodRawShape>;
     handler: (args: Record<string, unknown>, extra: unknown) => Promise<MinimalCallToolResult>;
+    annotations?: ToolAnnotations;
 }>>(config: {
     name: string;
     version?: string;
@@ -825,4 +845,4 @@ declare function isTimeoutError(error: unknown): boolean;
  */
 declare function getErrorMetadata(error: unknown): ClaudeCodeErrorMetadata | undefined;
 
-export { type ClaudeCodeErrorMetadata, ClaudeCodeLanguageModel, type ClaudeCodeLanguageModelOptions, type ClaudeCodeModelId, type ClaudeCodeProvider, type ClaudeCodeProviderSettings, type ClaudeCodeSettings, type Logger, type MessageInjector, claudeCode, createAPICallError, createAuthenticationError, createClaudeCode, createCustomMcpServer, createTimeoutError, getErrorMetadata, isAuthenticationError, isTimeoutError };
+export { type ClaudeCodeErrorMetadata, ClaudeCodeLanguageModel, type ClaudeCodeLanguageModelOptions, type ClaudeCodeModelId, type ClaudeCodeProvider, type ClaudeCodeProviderSettings, type ClaudeCodeSettings, type Logger, type MessageInjector, type MinimalCallToolResult, type ToolAnnotations, claudeCode, createAPICallError, createAuthenticationError, createClaudeCode, createCustomMcpServer, createTimeoutError, getErrorMetadata, isAuthenticationError, isTimeoutError };

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, 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, UserPromptSubmitHookInput, createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
+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 { ZodObject, ZodRawShape } from 'zod';
 
 type StreamingInputMode = 'auto' | 'always' | 'off';
@@ -117,6 +117,11 @@ interface ClaudeCodeSettings {
      * Resume a specific session by ID
      */
     resume?: string;
+    /**
+     * Use a specific session ID for this query.
+     * Allows deterministic session identifiers for tracking and correlation.
+     */
+    sessionId?: string;
     /**
      * Tools to explicitly allow during execution
      * Examples: ['Read', 'LS', 'Bash(git log:*)']
@@ -195,6 +200,14 @@ interface ClaudeCodeSettings {
      * Enable verbose logging for debugging
      */
     verbose?: boolean;
+    /**
+     * Enable programmatic debug logging from the SDK.
+     */
+    debug?: boolean;
+    /**
+     * Path to a file for SDK debug log output.
+     */
+    debugFile?: string;
     /**
      * Custom logger for handling warnings and errors.
      * - Set to `false` to disable all logging
@@ -592,6 +605,12 @@ type ContentAnnotations = {
     /** ISO 8601 timestamp of last modification */
     lastModified?: string;
 };
+/**
+ * MCP tool annotations for hinting tool behavior to the model.
+ * Derived from the SDK's SdkMcpToolDefinition type to stay in sync
+ * with the upstream MCP ToolAnnotations definition.
+ */
+type ToolAnnotations = NonNullable<SdkMcpToolDefinition['annotations']>;
 /**
  * Convenience helper to create an SDK MCP server from a simple tool map.
  * Each tool provides a description, a Zod object schema, and a handler.
@@ -670,6 +689,7 @@ declare function createCustomMcpServer<Tools extends Record<string, {
     description: string;
     inputSchema: ZodObject<ZodRawShape>;
     handler: (args: Record<string, unknown>, extra: unknown) => Promise<MinimalCallToolResult>;
+    annotations?: ToolAnnotations;
 }>>(config: {
     name: string;
     version?: string;
@@ -825,4 +845,4 @@ declare function isTimeoutError(error: unknown): boolean;
  */
 declare function getErrorMetadata(error: unknown): ClaudeCodeErrorMetadata | undefined;
 
-export { type ClaudeCodeErrorMetadata, ClaudeCodeLanguageModel, type ClaudeCodeLanguageModelOptions, type ClaudeCodeModelId, type ClaudeCodeProvider, type ClaudeCodeProviderSettings, type ClaudeCodeSettings, type Logger, type MessageInjector, claudeCode, createAPICallError, createAuthenticationError, createClaudeCode, createCustomMcpServer, createTimeoutError, getErrorMetadata, isAuthenticationError, isTimeoutError };
+export { type ClaudeCodeErrorMetadata, ClaudeCodeLanguageModel, type ClaudeCodeLanguageModelOptions, type ClaudeCodeModelId, type ClaudeCodeProvider, type ClaudeCodeProviderSettings, type ClaudeCodeSettings, type Logger, type MessageInjector, type MinimalCallToolResult, type ToolAnnotations, claudeCode, createAPICallError, createAuthenticationError, createClaudeCode, createCustomMcpServer, createTimeoutError, getErrorMetadata, isAuthenticationError, isTimeoutError };

package/dist/index.js

@@ -367,18 +367,33 @@ function getErrorMetadata(error) {
 }
 
 // src/map-claude-code-finish-reason.ts
-function mapClaudeCodeFinishReason(subtype) {
+function mapClaudeCodeFinishReason(subtype, stopReason) {
+  if (stopReason != null) {
+    switch (stopReason) {
+      case "end_turn":
+        return { unified: "stop", raw: "end_turn" };
+      case "max_tokens":
+        return { unified: "length", raw: "max_tokens" };
+      case "stop_sequence":
+        return { unified: "stop", raw: "stop_sequence" };
+      case "tool_use":
+        return { unified: "tool-calls", raw: "tool_use" };
+      default:
+        break;
+    }
+  }
+  const raw = stopReason ?? subtype;
   switch (subtype) {
     case "success":
-      return { unified: "stop", raw: subtype };
+      return { unified: "stop", raw };
     case "error_max_turns":
-      return { unified: "length", raw: subtype };
+      return { unified: "length", raw };
     case "error_during_execution":
-      return { unified: "error", raw: subtype };
+      return { unified: "error", raw };
     case void 0:
-      return { unified: "stop", raw: void 0 };
+      return { unified: "stop", raw };
     default:
-      return { unified: "other", raw: subtype };
+      return { unified: "other", raw };
   }
 }
 
@@ -428,6 +443,7 @@ var claudeCodeSettingsSchema = z.object({
   permissionPromptToolName: z.string().optional(),
   continue: z.boolean().optional(),
   resume: z.string().optional(),
+  sessionId: z.string().optional(),
   allowedTools: z.array(z.string()).optional(),
   disallowedTools: z.array(z.string()).optional(),
   betas: z.array(z.string()).optional(),
@@ -497,6 +513,8 @@ var claudeCodeSettingsSchema = z.object({
     ])
   ).optional(),
   verbose: z.boolean().optional(),
+  debug: z.boolean().optional(),
+  debugFile: z.string().optional(),
   logger: z.union([z.literal(false), loggerFunctionSchema]).optional(),
   env: z.record(z.string(), z.string().optional()).optional(),
   additionalDirectories: z.array(z.string()).optional(),
@@ -1223,6 +1241,15 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     if (this.settings.hooks) {
       opts.hooks = this.settings.hooks;
     }
+    if (this.settings.sessionId !== void 0) {
+      opts.sessionId = this.settings.sessionId;
+    }
+    if (this.settings.debug !== void 0) {
+      opts.debug = this.settings.debug;
+    }
+    if (this.settings.debugFile !== void 0) {
+      opts.debugFile = this.settings.debugFile;
+    }
     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;
@@ -1426,7 +1453,8 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               `[claude-code] Token usage - Input: ${usage.inputTokens.total}, Output: ${usage.outputTokens.total}`
             );
           }
-          finishReason = mapClaudeCodeFinishReason(message.subtype);
+          const stopReason = "stop_reason" in message ? message.stop_reason : void 0;
+          finishReason = mapClaudeCodeFinishReason(message.subtype, stopReason);
           this.logger.debug(`[claude-code] Finish reason: ${finishReason.unified}`);
         } else if (message.type === "system" && message.subtype === "init") {
           this.setSessionId(message.session_id);
@@ -2169,8 +2197,10 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
                   `[claude-code] Stream token usage - Input: ${usage.inputTokens.total}, Output: ${usage.outputTokens.total}`
                 );
               }
+              const stopReason = "stop_reason" in message ? message.stop_reason : void 0;
               const finishReason = mapClaudeCodeFinishReason(
-                message.subtype
+                message.subtype,
+                stopReason
               );
               this.logger.debug(`[claude-code] Stream finish reason: ${finishReason.unified}`);
               this.setSessionId(message.session_id);
@@ -2431,7 +2461,8 @@ function createCustomMcpServer(config) {
       name,
       def.description,
       def.inputSchema.shape,
-      (args, extra) => def.handler(args, extra)
+      (args, extra) => def.handler(args, extra),
+      def.annotations ? { annotations: def.annotations } : void 0
     )
   );
   return createSdkMcpServer({ name: config.name, version: config.version, tools: defs });