ai-sdk-provider-claude-code 2.0.4 → 2.1.0

package/README.md

@@ -45,12 +45,69 @@ npm install ai-sdk-provider-claude-code@ai-sdk-v4 ai@^4.3.16
 
 ## Zod Compatibility
 
-This package supports both **Zod 3** and **Zod 4**:
+This package is **tested and compatible with both Zod 3 and Zod 4**, but there's an important peer dependency consideration:
 
-- ✅ **Zod 4** (Recommended): `npm install zod@^4.0.0`
-- ✅ **Zod 3** (Still supported): `npm install zod@^3.0.0`
+### Current Status
 
-The package uses Zod for schema validation and works seamlessly with both versions. All 302 tests pass with both Zod 3 and Zod 4. See `examples/zod4-compatibility-test.ts` for comprehensive compatibility tests.
+- ✅ **Zod 3** (fully supported, no warnings)
+- ⚠️ **Zod 4** (functional, but requires `--legacy-peer-deps`)
+
+While this package declares support for both versions (`peerDependencies: "zod": "^3.0.0 || ^4.0.0"`), the underlying `@anthropic-ai/claude-agent-sdk` currently only declares support for Zod 3 (`peerDependencies: "zod": "^3.24.1"`).
+
+**All 302 tests pass with both Zod 3 and Zod 4.** See `examples/zod4-compatibility-test.ts` for comprehensive compatibility verification.
+
+### Installation Instructions
+
+**With Zod 3 (recommended for now):**
+
+```bash
+npm install ai-sdk-provider-claude-code ai zod@^3.0.0
+```
+
+**With Zod 4 (requires package manager-specific flags):**
+
+For **npm**:
+
+```bash
+npm install ai-sdk-provider-claude-code ai zod@^4.0.0 --legacy-peer-deps
+```
+
+For **pnpm**:
+
+```bash
+pnpm install ai-sdk-provider-claude-code ai zod@^4.0.0 --no-strict-peer-dependencies
+# Or configure it project-wide:
+pnpm config set strict-peer-dependencies false
+```
+
+For **Yarn** (Berry/v2+):
+
+```bash
+yarn add ai-sdk-provider-claude-code ai zod@^4.0.0
+# Yarn's peer resolution typically doesn't error here
+```
+
+### For Package Developers
+
+If you're developing with this package in your repository, add a configuration file to avoid needing the flag on every install:
+
+**For npm** (`.npmrc`):
+
+```ini
+# .npmrc
+legacy-peer-deps=true
+```
+
+**For pnpm** (`.npmrc`):
+
+```ini
+# .npmrc
+strict-peer-dependencies=false
+```
+
+> **Note**: The `.npmrc` file in this repository is committed for CI/development consistency but is **not included in the published package** (it's excluded via the `files` field in `package.json`). End users will still need to use the appropriate flags when installing with Zod 4.
+
+> **Temporary Workaround**: This configuration is needed until `@anthropic-ai/claude-agent-sdk` adds official Zod 4 support to their peer dependencies. Track progress in the [claude-agent-sdk repository](https://github.com/anthropics/anthropic-sdk-typescript).
 
 ## Installation
 

package/dist/index.cjs

@@ -509,6 +509,12 @@ function mapClaudeCodeFinishReason(subtype) {
 var import_zod = require("zod");
 var import_fs = require("fs");
 var loggerFunctionSchema = import_zod.z.object({
+  debug: import_zod.z.any().refine((val) => typeof val === "function", {
+    message: "debug must be a function"
+  }),
+  info: import_zod.z.any().refine((val) => typeof val === "function", {
+    message: "info must be a function"
+  }),
   warn: import_zod.z.any().refine((val) => typeof val === "function", {
     message: "warn must be a function"
   }),
@@ -689,10 +695,16 @@ function validateSessionId(sessionId) {
 
 // src/logger.ts
 var defaultLogger = {
-  warn: (message) => console.warn(message),
-  error: (message) => console.error(message)
+  debug: (message) => console.debug(`[DEBUG] ${message}`),
+  info: (message) => console.info(`[INFO] ${message}`),
+  warn: (message) => console.warn(`[WARN] ${message}`),
+  error: (message) => console.error(`[ERROR] ${message}`)
 };
 var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
   warn: () => {
   },
   error: () => {
@@ -707,83 +719,54 @@ function getLogger(logger) {
   }
   return logger;
 }
+function createVerboseLogger(logger, verbose = false) {
+  if (verbose) {
+    return logger;
+  }
+  return {
+    debug: () => {
+    },
+    // No-op when not verbose
+    info: () => {
+    },
+    // No-op when not verbose
+    warn: logger.warn.bind(logger),
+    error: logger.error.bind(logger)
+  };
+}
 
 // src/claude-code-language-model.ts
 var import_claude_agent_sdk = require("@anthropic-ai/claude-agent-sdk");
-var CLAUDE_CODE_TRUNCATION_WARNING = "Claude Code CLI output ended unexpectedly; returning truncated response from buffered text. Await upstream fix to avoid data loss.";
-var MIN_TRUNCATION_LENGTH = 1024;
-var POSITION_PATTERN = /position\s+(\d+)/i;
-function hasUnclosedJsonStructure(text) {
-  let depth = 0;
-  let inString = false;
-  let escapeNext = false;
-  for (let i = 0; i < text.length; i++) {
-    const char = text[i];
-    if (escapeNext) {
-      escapeNext = false;
-      continue;
-    }
-    if (inString) {
-      if (char === "\\") {
-        escapeNext = true;
-        continue;
-      }
-      if (char === '"') {
-        inString = false;
-      }
-      continue;
-    }
-    if (char === '"') {
-      inString = true;
-      continue;
-    }
-    if (char === "{" || char === "[") {
-      depth++;
-      continue;
-    }
-    if (char === "}" || char === "]") {
-      if (depth > 0) {
-        depth--;
-      }
-    }
-  }
-  return depth > 0 || inString;
-}
+var CLAUDE_CODE_TRUNCATION_WARNING = "Claude Code SDK output ended unexpectedly; returning truncated response from buffered text. Await upstream fix to avoid data loss.";
+var MIN_TRUNCATION_LENGTH = 512;
 function isClaudeCodeTruncationError(error, bufferedText) {
-  if (!(error instanceof SyntaxError)) {
+  const isSyntaxError = error instanceof SyntaxError || // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  typeof error?.name === "string" && // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  error.name.toLowerCase() === "syntaxerror";
+  if (!isSyntaxError) {
     return false;
   }
   if (!bufferedText) {
     return false;
   }
-  const rawMessage = typeof error.message === "string" ? error.message : "";
+  const rawMessage = typeof error?.message === "string" ? error.message : "";
   const message = rawMessage.toLowerCase();
   const truncationIndicators = [
     "unexpected end of json input",
     "unexpected end of input",
     "unexpected end of string",
-    "unterminated string"
+    "unexpected eof",
+    "end of file",
+    "unterminated string",
+    "unterminated string constant"
   ];
   if (!truncationIndicators.some((indicator) => message.includes(indicator))) {
     return false;
   }
-  const positionMatch = rawMessage.match(POSITION_PATTERN);
-  if (positionMatch) {
-    const position = Number.parseInt(positionMatch[1], 10);
-    if (Number.isFinite(position)) {
-      const isNearBufferEnd = Math.abs(position - bufferedText.length) <= 16;
-      if (isNearBufferEnd && position >= MIN_TRUNCATION_LENGTH) {
-        return true;
-      }
-      if (!isNearBufferEnd) {
-        return false;
-      }
-    }
-  }
   if (bufferedText.length < MIN_TRUNCATION_LENGTH) {
     return false;
   }
-  return hasUnclosedJsonStructure(bufferedText);
+  return true;
 }
 function isAbortError(err) {
   if (err && typeof err === "object") {
@@ -842,7 +825,8 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     this.modelId = options.id;
     this.settings = options.settings ?? {};
     this.settingsValidationWarnings = options.settingsValidationWarnings ?? [];
-    this.logger = getLogger(this.settings.logger);
+    const baseLogger = getLogger(this.settings.logger);
+    this.logger = createVerboseLogger(baseLogger, this.settings.verbose ?? false);
     if (!this.modelId || typeof this.modelId !== "string" || this.modelId.trim() === "") {
       throw new import_provider2.NoSuchModelError({
         modelId: this.modelId,
@@ -930,7 +914,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       );
     }
     if (length > _ClaudeCodeLanguageModel.MAX_TOOL_INPUT_WARN) {
-      console.warn(
+      this.logger.warn(
         `[claude-code] Large tool input detected: ${length} bytes. Performance may be impacted. Consider chunking or reducing input size.`
       );
     }
@@ -1142,7 +1126,11 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     }
   }
   async doGenerate(options) {
+    this.logger.debug(`[claude-code] Starting doGenerate request with model: ${this.modelId}`);
     const mode = options.responseFormat?.type === "json" ? { type: "object-json" } : { type: "regular" };
+    this.logger.debug(
+      `[claude-code] Request mode: ${mode.type}, response format: ${options.responseFormat?.type ?? "none"}`
+    );
     const {
       messagesPrompt,
       warnings: messageWarnings,
@@ -1153,6 +1141,9 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       mode,
       options.responseFormat?.type === "json" ? options.responseFormat.schema : void 0
     );
+    this.logger.debug(
+      `[claude-code] Converted ${options.prompt.length} messages, hasImageParts: ${hasImageParts}`
+    );
     const abortController = new AbortController();
     let abortListener;
     if (options.abortSignal?.aborted) {
@@ -1206,11 +1197,15 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
         this.settings.resume ?? this.sessionId,
         streamingContentParts
       ) : messagesPrompt;
+      this.logger.debug(
+        `[claude-code] Executing query with streamingInput: ${wantsStreamInput}, session: ${this.settings.resume ?? this.sessionId ?? "new"}`
+      );
       const response = (0, import_claude_agent_sdk.query)({
         prompt: sdkPrompt,
         options: queryOptions
       });
       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("");
         } else if (message.type === "result") {
@@ -1218,6 +1213,9 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
           this.setSessionId(message.session_id);
           costUsd = message.total_cost_usd;
           durationMs = message.duration_ms;
+          this.logger.info(
+            `[claude-code] Request completed - Session: ${message.session_id}, Cost: $${costUsd?.toFixed(4) ?? "N/A"}, Duration: ${durationMs ?? "N/A"}ms`
+          );
           if ("usage" in message) {
             rawUsage = message.usage;
             usage = {
@@ -1225,18 +1223,30 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               outputTokens: message.usage.output_tokens ?? 0,
               totalTokens: (message.usage.cache_creation_input_tokens ?? 0) + (message.usage.cache_read_input_tokens ?? 0) + (message.usage.input_tokens ?? 0) + (message.usage.output_tokens ?? 0)
             };
+            this.logger.debug(
+              `[claude-code] Token usage - Input: ${usage.inputTokens}, Output: ${usage.outputTokens}, Total: ${usage.totalTokens}`
+            );
           }
           finishReason = mapClaudeCodeFinishReason(message.subtype);
+          this.logger.debug(`[claude-code] Finish reason: ${finishReason}`);
         } else if (message.type === "system" && message.subtype === "init") {
           this.setSessionId(message.session_id);
+          this.logger.info(`[claude-code] Session initialized: ${message.session_id}`);
         }
       }
     } catch (error) {
       done();
+      this.logger.debug(
+        `[claude-code] Error during doGenerate: ${error instanceof Error ? error.message : String(error)}`
+      );
       if (isAbortError(error)) {
+        this.logger.debug("[claude-code] Request aborted by user");
         throw options.abortSignal?.aborted ? options.abortSignal.reason : error;
       }
       if (isClaudeCodeTruncationError(error, text)) {
+        this.logger.warn(
+          `[claude-code] Detected truncated response, returning ${text.length} characters of buffered text`
+        );
         wasTruncated = true;
         finishReason = "length";
         warnings.push({
@@ -1279,7 +1289,11 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     };
   }
   async doStream(options) {
+    this.logger.debug(`[claude-code] Starting doStream request with model: ${this.modelId}`);
     const mode = options.responseFormat?.type === "json" ? { type: "object-json" } : { type: "regular" };
+    this.logger.debug(
+      `[claude-code] Stream mode: ${mode.type}, response format: ${options.responseFormat?.type ?? "none"}`
+    );
     const {
       messagesPrompt,
       warnings: messageWarnings,
@@ -1290,6 +1304,9 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       mode,
       options.responseFormat?.type === "json" ? options.responseFormat.schema : void 0
     );
+    this.logger.debug(
+      `[claude-code] Converted ${options.prompt.length} messages for streaming, hasImageParts: ${hasImageParts}`
+    );
     const abortController = new AbortController();
     let abortListener;
     if (options.abortSignal?.aborted) {
@@ -1383,16 +1400,19 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
             this.settings.resume ?? this.sessionId,
             streamingContentParts
           ) : messagesPrompt;
+          this.logger.debug(
+            `[claude-code] Starting stream query with streamingInput: ${wantsStreamInput}, session: ${this.settings.resume ?? this.sessionId ?? "new"}`
+          );
           const response = (0, import_claude_agent_sdk.query)({
             prompt: sdkPrompt,
             options: queryOptions
           });
           for await (const message of response) {
+            this.logger.debug(`[claude-code] Stream received message type: ${message.type}`);
             if (message.type === "assistant") {
               if (!message.message?.content) {
-                console.warn(
-                  `[claude-code] Unexpected assistant message structure: missing content field. Message type: ${message.type}. This may indicate an SDK protocol violation.`,
-                  message
+                this.logger.warn(
+                  `[claude-code] Unexpected assistant message structure: missing content field. Message type: ${message.type}. This may indicate an SDK protocol violation.`
                 );
                 continue;
               }
@@ -1408,9 +1428,15 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
                     callEmitted: false
                   };
                   toolStates.set(toolId, state);
+                  this.logger.debug(
+                    `[claude-code] New tool use detected - Tool: ${tool3.name}, ID: ${toolId}`
+                  );
                 }
                 state.name = tool3.name;
                 if (!state.inputStarted) {
+                  this.logger.debug(
+                    `[claude-code] Tool input started - Tool: ${tool3.name}, ID: ${toolId}`
+                  );
                   controller.enqueue({
                     type: "tool-input-start",
                     id: toolId,
@@ -1463,9 +1489,8 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               }
             } else if (message.type === "user") {
               if (!message.message?.content) {
-                console.warn(
-                  `[claude-code] Unexpected user message structure: missing content field. Message type: ${message.type}. This may indicate an SDK protocol violation.`,
-                  message
+                this.logger.warn(
+                  `[claude-code] Unexpected user message structure: missing content field. Message type: ${message.type}. This may indicate an SDK protocol violation.`
                 );
                 continue;
               }
@@ -1473,8 +1498,11 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               for (const result of this.extractToolResults(content)) {
                 let state = toolStates.get(result.id);
                 const toolName = result.name ?? state?.name ?? _ClaudeCodeLanguageModel.UNKNOWN_TOOL_NAME;
+                this.logger.debug(
+                  `[claude-code] Tool result received - Tool: ${toolName}, ID: ${result.id}`
+                );
                 if (!state) {
-                  console.warn(
+                  this.logger.warn(
                     `[claude-code] Received tool result for unknown tool ID: ${result.id}`
                   );
                   state = {
@@ -1535,8 +1563,11 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               for (const error of this.extractToolErrors(content)) {
                 let state = toolStates.get(error.id);
                 const toolName = error.name ?? state?.name ?? _ClaudeCodeLanguageModel.UNKNOWN_TOOL_NAME;
+                this.logger.debug(
+                  `[claude-code] Tool error received - Tool: ${toolName}, ID: ${error.id}`
+                );
                 if (!state) {
-                  console.warn(
+                  this.logger.warn(
                     `[claude-code] Received tool error for unknown tool ID: ${error.id}`
                   );
                   state = {
@@ -1572,6 +1603,9 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               }
             } else if (message.type === "result") {
               done();
+              this.logger.info(
+                `[claude-code] Stream completed - Session: ${message.session_id}, Cost: $${message.total_cost_usd?.toFixed(4) ?? "N/A"}, Duration: ${message.duration_ms ?? "N/A"}ms`
+              );
               let rawUsage;
               if ("usage" in message) {
                 rawUsage = message.usage;
@@ -1580,10 +1614,14 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
                   outputTokens: message.usage.output_tokens ?? 0,
                   totalTokens: (message.usage.cache_creation_input_tokens ?? 0) + (message.usage.cache_read_input_tokens ?? 0) + (message.usage.input_tokens ?? 0) + (message.usage.output_tokens ?? 0)
                 };
+                this.logger.debug(
+                  `[claude-code] Stream token usage - Input: ${usage.inputTokens}, Output: ${usage.outputTokens}, Total: ${usage.totalTokens}`
+                );
               }
               const finishReason = mapClaudeCodeFinishReason(
                 message.subtype
               );
+              this.logger.debug(`[claude-code] Stream finish reason: ${finishReason}`);
               this.setSessionId(message.session_id);
               if (options.responseFormat?.type === "json" && accumulatedText) {
                 const extractedJson = this.handleJsonExtraction(accumulatedText, streamWarnings);
@@ -1632,6 +1670,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
               });
             } else if (message.type === "system" && message.subtype === "init") {
               this.setSessionId(message.session_id);
+              this.logger.info(`[claude-code] Stream session initialized: ${message.session_id}`);
               controller.enqueue({
                 type: "response-metadata",
                 id: message.session_id,
@@ -1641,10 +1680,17 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
             }
           }
           finalizeToolCalls();
+          this.logger.debug("[claude-code] Stream finalized, closing stream");
           controller.close();
         } catch (error) {
           done();
+          this.logger.debug(
+            `[claude-code] Error during doStream: ${error instanceof Error ? error.message : String(error)}`
+          );
           if (isClaudeCodeTruncationError(error, accumulatedText)) {
+            this.logger.warn(
+              `[claude-code] Detected truncated stream response, returning ${accumulatedText.length} characters of buffered text`
+            );
             const truncationWarning = {
               type: "other",
               message: CLAUDE_CODE_TRUNCATION_WARNING