ai-sdk-provider-claude-code 4.0.0 → 4.0.1

package/README.md

@@ -706,6 +706,23 @@ All requests made through this provider report timing in `finalStep.providerMeta
 - 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), and image prompts use the same path. This provider supports it via `streamingInput`: use `'auto'` (streams when `canUseTool` is set or image parts are present), `'always'`, or `'off'` (`'off'` disables streaming image input, emits a generic `type: 'other'` image streaming-input warning, and omits image parts). See GUIDE for details.
 
+## Error Diagnostics
+
+Mapped errors from this provider append a trimmed stderr tail to the error message as `... | stderr (tail): <last lines>`, making CLI failures visible in logs without inspecting metadata.
+
+```ts
+import { generateText } from 'ai';
+import { claudeCode, getErrorMetadata } from 'ai-sdk-provider-claude-code';
+
+try {
+  await generateText({ model: claudeCode('sonnet'), prompt: 'Hello!' });
+} catch (error) {
+  console.error(getErrorMetadata(error)?.stderr);
+}
+```
+
+The metadata accessor returns the full captured stderr, capped at 4000 characters. 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)
 
 - AI SDK v7 represents failed tool executions with the standard `tool-result` stream event/part and `isError: true`.

package/dist/index.d.ts

@@ -1428,8 +1428,9 @@ declare function createAPICallError({ message, code, exitCode, stderr, promptExc
  * });
  * ```
  */
-declare function createAuthenticationError({ message }: {
+declare function createAuthenticationError({ message, stderr, }: {
     message: string;
+    stderr?: string;
 }): LoadAPIKeyError;
 /**
  * Creates a timeout error for Claude Code SDK operations.
@@ -1448,8 +1449,9 @@ declare function createAuthenticationError({ message }: {
  * });
  * ```
  */
-declare function createTimeoutError({ message, promptExcerpt, timeoutMs, }: {
+declare function createTimeoutError({ message, stderr, promptExcerpt, timeoutMs, }: {
     message: string;
+    stderr?: string;
     promptExcerpt?: string;
     timeoutMs?: number;
 }): APICallError;

package/dist/index.js

@@ -488,6 +488,21 @@ ${segmentText}`;
 
 // src/errors.ts
 import { APICallError, LoadAPIKeyError } from "@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,
@@ -502,26 +517,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 APICallError({
-    message,
+    message: enrichedMessage,
     isRetryable,
     url: "claude-code-cli://command",
     requestBodyValues: promptExcerpt ? { prompt: promptExcerpt } : void 0,
     data: metadata
   });
 }
-function createAuthenticationError({ message }) {
-  return new LoadAPIKeyError({
+function createAuthenticationError({
+  message,
+  stderr
+}) {
+  const error = new 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 APICallError({
@@ -547,6 +573,9 @@ function getErrorMetadata(error) {
   if (error instanceof APICallError && error.data) {
     return error.data;
   }
+  if (error instanceof LoadAPIKeyError && error.data) {
+    return error.data;
+  }
   return void 0;
 }
 
@@ -1177,10 +1206,16 @@ function createClaudeCodeQueryController(query2) {
 
 // src/claude-code-language-model.ts
 import { query } from "@anthropic-ai/claude-agent-sdk";
-var PROVIDER_VERSION = "4.0.0";
+var PROVIDER_VERSION = "4.0.1";
 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
@@ -2401,12 +2436,18 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     return opts;
   }
   handleClaudeCodeError(error, messagesPrompt, collectedStderr) {
-    if (isAbortError(error)) {
-      throw error;
-    }
     if (error instanceof APICallError2 || error instanceof LoadAPIKeyError2) {
       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;
     };
@@ -2427,26 +2468,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.",
@@ -2822,6 +2880,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     let collectedStderr = "";
     const stderrCollector = (data) => {
       collectedStderr += data;
+      collectedStderr = capStderr(collectedStderr);
     };
     const sdkOptions = this.getSanitizedSdkOptions();
     const effectiveResume = this.getEffectiveResume(sdkOptions);
@@ -3322,6 +3381,7 @@ var ClaudeCodeLanguageModel = class _ClaudeCodeLanguageModel {
     let collectedStderr = "";
     const stderrCollector = (data) => {
       collectedStderr += data;
+      collectedStderr = capStderr(collectedStderr);
     };
     const sdkOptions = this.getSanitizedSdkOptions();
     const effectiveResume = this.getEffectiveResume(sdkOptions);