ai-sdk-provider-claude-code 3.5.2 → 3.5.3

package/README.md

@@ -616,6 +616,22 @@ All requests made through this provider report timing in `providerMetadata['clau
 - When replaying conversation history through the prompt, assistant tool calls are serialized as text lines — `[Tool call: Read({"file_path":"/x"})]` (inputs truncated at 1000 characters) — paired with `Tool Result (Read): ...` lines for tool messages
 - `canUseTool` requires streaming input at the SDK level (AsyncIterable prompt). This provider supports it via `streamingInput`: use `'auto'` (default when `canUseTool` is set) or `'always'`. See GUIDE for details.
 
+## Error Diagnostics
+
+Mapped provider errors append a trimmed stderr tail directly to the message as `... | stderr (tail): <last lines>`, making failures visible in logs without inspecting metadata. The full captured stderr (capped at 4000 characters) remains available through `getErrorMetadata`:
+
+```typescript
+import { generateText } from 'ai';
+import { claudeCode, getErrorMetadata } from 'ai-sdk-provider-claude-code';
+try {
+  await generateText({ model: claudeCode('haiku'), prompt: 'Hello, Claude!' });
+} catch (error) {
+  console.error(getErrorMetadata(error)?.stderr);
+}
+```
+
+Authentication and timeout failures are also classified when the only evidence is in stderr, using high-precision matching to avoid false positives from unrelated stderr output.
+
 ## Tool Error Parity (Streaming)
 
 - In addition to `tool-call` and `tool-result`, this provider emits a distinct `tool-error` stream event when a tool execution fails.

package/dist/index.cjs

@@ -376,6 +376,21 @@ ${segmentText}`;
 
 // src/errors.ts
 var import_provider = require("@ai-sdk/provider");
+var STDERR_TAIL_MARKER = " | stderr (tail):";
+var ANSI_ESCAPE_SEQUENCE = (
+  // eslint-disable-next-line no-control-regex
+  /\x1b(?:\][^\x07\x1b]*(?:\x07|\x1b\\)|\[[0-?]*[ -/]*[@-~])/g
+);
+function stderrTail(raw) {
+  const withoutAnsi = raw.replace(ANSI_ESCAPE_SEQUENCE, "");
+  const withoutControlCharacters = Array.from(withoutAnsi).filter((character) => {
+    const codePoint = character.codePointAt(0) ?? 0;
+    return character === "\r" || character === "\n" || codePoint === 8232 || codePoint === 8233 || codePoint >= 32 && codePoint < 127 || codePoint > 159;
+  }).join("");
+  const tail = withoutControlCharacters.split(/\r\n|\r|\n|\u2028|\u2029/).map((line) => line.trim()).filter((line) => line.length > 0).slice(-5).join("; ");
+  const codePoints = Array.from(tail);
+  return codePoints.length > 600 ? `\u2026${codePoints.slice(-599).join("")}` : tail;
+}
 function createAPICallError({
   message,
   code,
@@ -390,26 +405,37 @@ function createAPICallError({
     stderr,
     promptExcerpt
   };
+  const tail = typeof stderr === "string" && stderr.length > 0 ? stderrTail(stderr) : "";
+  const enrichedMessage = tail && !message.includes(STDERR_TAIL_MARKER) ? `${message}${STDERR_TAIL_MARKER} ${tail}` : message;
   return new import_provider.APICallError({
-    message,
+    message: enrichedMessage,
     isRetryable,
     url: "claude-code-cli://command",
     requestBodyValues: promptExcerpt ? { prompt: promptExcerpt } : void 0,
     data: metadata
   });
 }
-function createAuthenticationError({ message }) {
-  return new import_provider.LoadAPIKeyError({
+function createAuthenticationError({
+  message,
+  stderr
+}) {
+  const error = new import_provider.LoadAPIKeyError({
     message: message || "Authentication failed. Please ensure Claude Code SDK is properly authenticated."
   });
+  if (stderr) {
+    error.data = { stderr };
+  }
+  return error;
 }
 function createTimeoutError({
   message,
+  stderr,
   promptExcerpt,
   timeoutMs
 }) {
   const metadata = {
     code: "TIMEOUT",
+    stderr,
     promptExcerpt
   };
   return new import_provider.APICallError({
@@ -435,6 +461,9 @@ function getErrorMetadata(error) {
   if (error instanceof import_provider.APICallError && error.data) {
     return error.data;
   }
+  if (error instanceof import_provider.LoadAPIKeyError && error.data) {
+    return error.data;
+  }
   return void 0;
 }
 
@@ -1012,10 +1041,16 @@ function createVerboseLogger(logger, verbose = false) {
 
 // src/claude-code-language-model.ts
 var import_claude_agent_sdk = require("@anthropic-ai/claude-agent-sdk");
-var PROVIDER_VERSION = "3.5.2";
+var PROVIDER_VERSION = "3.5.3";
 var DEFAULT_CLIENT_APP = `ai-sdk-provider-claude-code/${PROVIDER_VERSION}`;
 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 capStderr(raw) {
+  if (raw.length <= 4e3) {
+    return raw;
+  }
+  return Array.from(raw).slice(-4e3).join("");
+}
 function isClaudeCodeTruncationError(error, bufferedText) {
   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
@@ -2024,12 +2059,18 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     return opts;
   }
   handleClaudeCodeError(error, messagesPrompt, collectedStderr) {
-    if (isAbortError(error)) {
-      throw error;
-    }
     if (error instanceof import_provider2.APICallError || error instanceof import_provider2.LoadAPIKeyError) {
       return error;
     }
+    const rawSdkStderr = typeof error === "object" && error !== null && "stderr" in error && typeof error.stderr === "string" ? error.stderr : void 0;
+    const cappedSdkStderr = rawSdkStderr !== void 0 ? capStderr(rawSdkStderr) : void 0;
+    const selectedStderr = cappedSdkStderr !== void 0 && stderrTail(cappedSdkStderr) ? cappedSdkStderr : collectedStderr ? capStderr(collectedStderr) : void 0;
+    const stderr = selectedStderr || void 0;
+    const tail = stderr ? stderrTail(stderr) : "";
+    const appendStderrTail = (message) => tail && !message.includes(STDERR_TAIL_MARKER) ? `${message}${STDERR_TAIL_MARKER} ${tail}` : message;
+    if (isAbortError(error)) {
+      throw error;
+    }
     const isErrorWithMessage = (err) => {
       return typeof err === "object" && err !== null && "message" in err;
     };
@@ -2050,26 +2091,43 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
       "oauth_org_not_allowed"
       // SDK 0.3.x assistant error kind: OAuth org not permitted
     ];
+    const stderrAuthPatterns = [
+      "not logged in",
+      "not authenticated",
+      "auth failed",
+      "please login",
+      "please run /login",
+      "claude login",
+      "claude auth login",
+      "invalid api key",
+      "oauth token revoked",
+      "oauth_org_not_allowed"
+    ];
     const errorMessage = isErrorWithMessage(error) && error.message ? error.message.toLowerCase() : "";
+    const stderrMessage = stderr?.toLowerCase() ?? "";
     const errorKind = getStructuredErrorKind(error);
     const exitCode = isErrorWithCode(error) && typeof error.exitCode === "number" ? error.exitCode : void 0;
-    const isAuthError = errorKind === "authentication_failed" || errorKind === "oauth_org_not_allowed" || authErrorPatterns.some((pattern) => errorMessage.includes(pattern)) || exitCode === 401;
+    const isAuthError = errorKind === "authentication_failed" || errorKind === "oauth_org_not_allowed" || authErrorPatterns.some((pattern) => errorMessage.includes(pattern)) || stderrAuthPatterns.some((pattern) => stderrMessage.includes(pattern)) || exitCode === 401;
     if (isAuthError) {
       return createAuthenticationError({
-        message: isErrorWithMessage(error) && error.message ? error.message : "Authentication failed. Please ensure Claude Code SDK is properly authenticated."
+        message: appendStderrTail(
+          isErrorWithMessage(error) && error.message ? error.message : "Authentication failed. Please ensure Claude Code SDK is properly authenticated."
+        ),
+        stderr
       });
     }
     const errorCode = isErrorWithCode(error) && typeof error.code === "string" ? error.code : "";
-    if (errorCode === "ETIMEDOUT" || errorMessage.includes("timeout")) {
+    if (errorCode === "ETIMEDOUT" || errorMessage.includes("timeout") || /request timed out|etimedout/i.test(stderr ?? "")) {
       return createTimeoutError({
-        message: isErrorWithMessage(error) && error.message ? error.message : "Request timed out",
+        message: appendStderrTail(
+          isErrorWithMessage(error) && error.message ? error.message : "Request timed out"
+        ),
+        stderr,
         promptExcerpt: messagesPrompt.substring(0, 200)
         // Don't specify timeoutMs since we don't know the actual timeout value
         // It's controlled by the consumer via AbortSignal
       });
     }
-    const stderrFromError = isErrorWithCode(error) && typeof error.stderr === "string" ? error.stderr : void 0;
-    const stderr = stderrFromError || collectedStderr || void 0;
     if (errorKind === "overloaded" || errorKind === "rate_limit" || errorMessage.includes("overloaded")) {
       return createAPICallError({
         message: isErrorWithMessage(error) && error.message ? error.message : "Anthropic API is overloaded. Please retry.",
@@ -2293,6 +2351,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     let collectedStderr = "";
     const stderrCollector = (data) => {
       collectedStderr += data;
+      collectedStderr = capStderr(collectedStderr);
     };
     const sdkOptions = this.getSanitizedSdkOptions();
     const effectiveResume = this.getEffectiveResume(sdkOptions);
@@ -2771,6 +2830,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     let collectedStderr = "";
     const stderrCollector = (data) => {
       collectedStderr += data;
+      collectedStderr = capStderr(collectedStderr);
     };
     const sdkOptions = this.getSanitizedSdkOptions();
     const effectiveResume = this.getEffectiveResume(sdkOptions);