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

package/README.md

@@ -284,6 +284,9 @@ This provider exposes Agent SDK options directly. Key options include:
 | `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'` |
+| `sessionId`                       | Use a specific session ID for deterministic tracking and correlation (v3.4.0+)                            |
+| `debug`                           | Enable programmatic debug logging from the SDK (v3.4.0+)                                                  |
+| `debugFile`                       | Path to a file for SDK debug log output (v3.4.0+)                                                         |
 
 **Agent definitions** (`agents`) now support additional fields (v3.2.0+):
 

package/dist/index.cjs

@@ -404,18 +404,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 };
   }
 }
 
@@ -465,6 +480,7 @@ var claudeCodeSettingsSchema = import_zod.z.object({
   permissionPromptToolName: import_zod.z.string().optional(),
   continue: import_zod.z.boolean().optional(),
   resume: import_zod.z.string().optional(),
+  sessionId: 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(),
@@ -534,6 +550,8 @@ var claudeCodeSettingsSchema = import_zod.z.object({
     ])
   ).optional(),
   verbose: import_zod.z.boolean().optional(),
+  debug: import_zod.z.boolean().optional(),
+  debugFile: import_zod.z.string().optional(),
   logger: import_zod.z.union([import_zod.z.literal(false), loggerFunctionSchema]).optional(),
   env: import_zod.z.record(import_zod.z.string(), import_zod.z.string().optional()).optional(),
   additionalDirectories: import_zod.z.array(import_zod.z.string()).optional(),
@@ -1260,6 +1278,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;
@@ -1463,7 +1490,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);
@@ -2206,8 +2234,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);
@@ -2468,7 +2498,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 (0, import_claude_agent_sdk2.createSdkMcpServer)({ name: config.name, version: config.version, tools: defs });