@ycodium-ai/agent-claude 0.2.3020 → 0.2.3028

package/dist/index.js

@@ -19840,15 +19840,21 @@ function claudeSignedOutMessage(input) {
 }
 function claudeFailureHint(input) {
   if (input.authenticationFailed) {
-    return claudeSignedOutMessage({
-      configDir: input.environment.CLAUDE_CONFIG_DIR,
-      credentialsDir: input.environment[CLAUDE_CREDENTIALS_DIR_ENVIRONMENT_VARIABLE],
-      cwd: input.cwd
-    });
+    return {
+      category: "auth",
+      text: claudeSignedOutMessage({
+        configDir: input.environment.CLAUDE_CONFIG_DIR,
+        credentialsDir: input.environment[CLAUDE_CREDENTIALS_DIR_ENVIRONMENT_VARIABLE],
+        cwd: input.cwd
+      })
+    };
   }
   const limit = input.usageLimit;
   if (limit !== void 0 && (limit.rejected.size > 0 || limit.latestAssistantRateLimited)) {
-    return describeUsageLimitFailure(limit.rejected, limit.nowMs);
+    return {
+      category: limit.rejected.size > 0 ? "quota" : "rate-limit",
+      text: describeUsageLimitFailure(limit.rejected, limit.nowMs)
+    };
   }
   return void 0;
 }
@@ -21022,10 +21028,10 @@ function resultListedError(result) {
   }
   return result.errors.find((error) => !error.startsWith("[ede_diagnostic]"));
 }
-function terminalResultError(reason, failureHint) {
+function terminalResultError(reason) {
   switch (reason) {
     case "api_error":
-      return failureHint ?? "Claude gave up after repeated API errors.";
+      return "Claude gave up after repeated API errors.";
     case "malformed_tool_use_exhausted":
       return "Claude gave up after repeated malformed tool calls.";
     case "budget_exhausted":
@@ -21037,7 +21043,7 @@ function terminalResultError(reason, failureHint) {
     case "turn_setup_failed":
       return "Claude could not start the turn.";
     case "blocking_limit":
-      return failureHint ?? "Claude stopped: a usage limit blocked the request.";
+      return "Claude stopped: a usage limit blocked the request.";
     case "rapid_refill_breaker":
       return "Claude stopped: the context refilled too quickly after compaction.";
     case "prompt_too_long":
@@ -21063,17 +21069,30 @@ function isInterruptedResult(result) {
   }
   return result.subtype === "error_during_execution" && result.is_error === false && (errors.includes("request was aborted") || errors.includes("interrupted by user") || errors.includes("aborted"));
 }
-function resultOutcome(result, failureHint) {
-  const structuredError = isOverloadedResult(result) ? "Claude API is overloaded (529). Try again shortly." : terminalResultError(result.terminal_reason, failureHint);
-  const successTaggedFailure = result.subtype === "success" && result.is_error;
-  const errorMessage = (successTaggedFailure ? failureHint : void 0) ?? resultListedError(result) ?? structuredError;
-  if (structuredError !== void 0) return { status: "failed", errorMessage };
+function resultOutcome(result, hint) {
+  const overloaded = isOverloadedResult(result);
+  const terminalText = overloaded ? void 0 : terminalResultError(result.terminal_reason);
+  const fromResult = {
+    from: "result",
+    reason: overloaded ? "overloaded" : terminalText === void 0 ? void 0 : result.terminal_reason
+  };
+  const hinted = hint === void 0 ? void 0 : { text: hint.text, cause: { from: "hint", category: hint.category } };
+  const listed = resultListedError(result);
+  const terminalReason = result.terminal_reason;
+  const blanketTerminal = terminalReason === "api_error" || terminalReason === "blocking_limit";
+  const chosen = result.subtype === "success" && result.is_error && hinted !== void 0 ? hinted : listed !== void 0 ? { text: listed, cause: fromResult } : overloaded ? { text: "Claude API is overloaded (529). Try again shortly.", cause: fromResult } : terminalText !== void 0 && blanketTerminal && hinted !== void 0 ? hinted : { text: terminalText, cause: fromResult };
+  const errorMessage = chosen.text;
+  if (overloaded || terminalText !== void 0) {
+    return { status: "failed", errorMessage, cause: chosen.cause };
+  }
   if (result.subtype === "success" && !result.is_error) {
-    return { status: "completed", errorMessage };
+    return { status: "completed", errorMessage, cause: void 0 };
   }
-  if (isInterruptedResult(result)) return { status: "interrupted", errorMessage };
-  const cancelled = resultErrorsText(result).includes("cancel");
-  return cancelled ? { status: "cancelled", errorMessage } : { status: "failed", errorMessage: errorMessage ?? failureHint };
+  if (isInterruptedResult(result)) return { status: "interrupted", errorMessage, cause: void 0 };
+  if (resultErrorsText(result).includes("cancel")) {
+    return { status: "cancelled", errorMessage, cause: void 0 };
+  }
+  return errorMessage === void 0 && hinted !== void 0 ? { status: "failed", errorMessage: hinted.text, cause: hinted.cause } : { status: "failed", errorMessage, cause: chosen.cause };
 }
 function streamKindFromDeltaType(deltaType) {
   return deltaType.includes("thinking") ? "reasoning_text" : "assistant_text";
@@ -21520,6 +21539,48 @@ var makeAssistantText = (emitter) => {
   };
 };
 
+// src/failureCategory.ts
+var namesNoReason = (signals) => {
+  const reason = signals.cause?.from === "result" ? signals.cause.reason : void 0;
+  return (reason === void 0 || reason === "api_error") && (signals.resultSubtype == null || signals.resultSubtype === "success" || signals.resultSubtype === "error_during_execution");
+};
+var claudeFailureCategory = (signals) => {
+  const cause = signals.cause;
+  if (cause?.from === "hint") return cause.category;
+  switch (cause?.reason) {
+    case "overloaded":
+      return "model-unavailable";
+    case "prompt_too_long":
+      return "context-limit";
+    case "blocking_limit":
+      return "quota";
+    default:
+      break;
+  }
+  if (!namesNoReason(signals)) return void 0;
+  const status = signals.apiErrorStatus ?? signals.retryErrorStatus;
+  if (signals.assistantError === "authentication_failed" || signals.assistantError === "oauth_org_not_allowed" || status === 401 || status === 403) {
+    return "auth";
+  }
+  if (status === 529 || signals.structuredErrorType === "overloaded_error" || signals.assistantError === "overloaded" || signals.assistantError === "model_not_found") {
+    return "model-unavailable";
+  }
+  if (signals.assistantError === "billing_error") return "quota";
+  if (signals.assistantError === "rate_limit" || status === 429) {
+    return signals.quotaWindowRejected === true ? "quota" : "rate-limit";
+  }
+  if (signals.establishedStreamExit === true) return "transport";
+  return void 0;
+};
+var failureCategoryField = (category) => category === void 0 ? {} : { failureCategory: category };
+var claudeStructuredErrorType = (value) => {
+  if (typeof value !== "object" || value === null) return void 0;
+  const error = value.error;
+  if (typeof error !== "object" || error === null) return void 0;
+  const type4 = error.type;
+  return typeof type4 === "string" ? type4 : void 0;
+};
+
 // src/usage.ts
 function maxClaudeContextWindowFromModelUsage(modelUsage) {
   if (!modelUsage) return void 0;
@@ -21964,7 +22025,7 @@ var makeEmitters = (emitter) => {
       });
     }
   };
-  const emitRuntimeError = async (context, message, cause) => {
+  const emitRuntimeError = async (context, message, cause, failureCategory) => {
     const turnState = context.turnState;
     const stamp = await makeEventStamp();
     offerRuntimeEvent(context, {
@@ -21974,7 +22035,8 @@ var makeEmitters = (emitter) => {
       payload: {
         message,
         class: "provider_error",
-        ...cause !== void 0 ? { detail: cause } : {}
+        ...cause !== void 0 ? { detail: cause } : {},
+        ...failureCategoryField(failureCategory)
       },
       providerRefs: nativeProviderRefs()
     });
@@ -22504,17 +22566,23 @@ var makeSdkStream = (deps) => {
     }
   };
   const runSdkStream = async (context) => {
+    let handlerThrew = false;
     try {
       for await (const message of context.query) {
         if (context.stopped) break;
-        await handleSdkMessage(context, message);
+        try {
+          await handleSdkMessage(context, message);
+        } catch (cause) {
+          handlerThrew = true;
+          throw cause;
+        }
       }
-      await handleStreamExit(context, null);
+      await handleStreamExit(context, null, false);
     } catch (cause) {
-      await handleStreamExit(context, cause);
+      await handleStreamExit(context, cause, !handlerThrew);
     }
   };
-  const handleStreamExit = async (context, cause) => {
+  const handleStreamExit = async (context, cause, streamBroke) => {
     if (context.stopped) {
       return;
     }
@@ -22527,8 +22595,11 @@ var makeSdkStream = (deps) => {
         const cliSaid = context.stderrTail.read();
         const reason = cause instanceof Error ? cause.message : "Claude runtime stream failed.";
         const message = cliSaid.length > 0 ? `${reason}: ${cliSaid}` : reason;
-        await emitRuntimeError(context, message, { cause: String(cause) });
-        await completeTurn(context, "failed", message);
+        const category = claudeFailureCategory({
+          establishedStreamExit: streamBroke && context.sessionEstablished
+        });
+        await emitRuntimeError(context, message, { cause: String(cause) }, category);
+        await completeTurn(context, "failed", message, void 0, category);
       }
     } else if (context.turnState) {
       await completeTurn(context, "interrupted", "Claude runtime stream ended.");
@@ -22935,7 +23006,8 @@ var makeSendTurn = (deps) => {
         nextSyntheticAssistantBlockIndex: -1,
         rejectedRateLimits: /* @__PURE__ */ new Map(),
         announcedUsageLimits: /* @__PURE__ */ new Set(),
-        latestAssistantRateLimited: false
+        latestAssistantError: void 0,
+        lastRetryErrorStatus: void 0
       };
       const updatedAt = nowIso();
       context.turnState = turnState;
@@ -23869,6 +23941,7 @@ var makeStartSession = (deps) => {
       lastThreadStartedId: void 0,
       stopping: false,
       stopped: false,
+      sessionEstablished: false,
       stopWork: void 0
     };
     contextDeferred.resolve(context);
@@ -23943,6 +24016,7 @@ var makeStreamEventHandler = (deps) => {
       const turnState = context.turnState;
       if (!turnState?.retrying) return;
       turnState.retrying = false;
+      turnState.lastRetryErrorStatus = void 0;
       const stamp = await makeEventStamp();
       offerRuntimeEvent(context, {
         type: "session.state.changed",
@@ -24361,6 +24435,7 @@ var makeSystemMessageHandler = (deps) => {
     if (message.type !== "system") {
       return;
     }
+    context.sessionEstablished = true;
     const stamp = await makeEventStamp();
     const base = {
       ...eventHeader(context, stamp),
@@ -24698,7 +24773,10 @@ var makeSystemMessageHandler = (deps) => {
         return;
       case "api_retry":
         if (message.parent_tool_use_id != null) return;
-        if (context.turnState) context.turnState.retrying = true;
+        if (context.turnState) {
+          context.turnState.retrying = true;
+          context.turnState.lastRetryErrorStatus = message.error_status;
+        }
         offerRuntimeEvent(context, {
           ...base,
           type: "session.state.changed",
@@ -24715,7 +24793,10 @@ var makeSystemMessageHandler = (deps) => {
         });
         return;
       case "session_state_changed":
-        if (message.state === "idle" && context.turnState) context.turnState.retrying = false;
+        if (message.state === "idle" && context.turnState) {
+          context.turnState.retrying = false;
+          context.turnState.lastRetryErrorStatus = void 0;
+        }
         offerRuntimeEvent(context, {
           ...base,
           type: "session.state.changed",
@@ -24886,7 +24967,8 @@ var makeTurnLifecycle = (deps) => {
       nextSyntheticAssistantBlockIndex: -1,
       rejectedRateLimits: /* @__PURE__ */ new Map(),
       announcedUsageLimits: /* @__PURE__ */ new Set(),
-      latestAssistantRateLimited: false
+      latestAssistantError: void 0,
+      lastRetryErrorStatus: void 0
     };
     context.session = {
       ...context.session,
@@ -24911,7 +24993,7 @@ var makeTurnLifecycle = (deps) => {
       }
     });
   };
-  const completeTurn = async (context, status, errorMessage, result) => {
+  const completeTurn = async (context, status, errorMessage, result, failureCategory) => {
     const resultContextWindow = maxClaudeContextWindowFromModelUsage(result?.modelUsage);
     if (resultContextWindow !== void 0) {
       context.lastKnownContextWindow = resultContextWindow;
@@ -25020,7 +25102,8 @@ var makeTurnLifecycle = (deps) => {
         ...result?.usage ? { usage: result.usage } : {},
         ...result?.modelUsage ? { modelUsage: result.modelUsage } : {},
         ...typeof result?.total_cost_usd === "number" ? { totalCostUsd: result.total_cost_usd } : {},
-        ...errorMessage ? { errorMessage } : {}
+        ...errorMessage ? { errorMessage } : {},
+        ...status === "failed" ? failureCategoryField(failureCategory) : {}
       },
       providerRefs: nativeProviderRefs()
     });
@@ -25223,7 +25306,7 @@ var makeTurnMessageHandlers = (deps) => {
     }
     const rateLimitParent = message.parent_tool_use_id;
     if (context.turnState && (rateLimitParent === null || rateLimitParent === void 0)) {
-      context.turnState.latestAssistantRateLimited = message.error === "rate_limit";
+      context.turnState.latestAssistantError = typeof message.error === "string" ? message.error : void 0;
     }
     if (isClaudeSyntheticApiErrorMessage(message)) {
       if (context.turnState && message.error === "authentication_failed") {
@@ -25305,17 +25388,27 @@ var makeTurnMessageHandlers = (deps) => {
         ...context.turnState === void 0 ? {} : {
           usageLimit: {
             rejected: context.turnState.rejectedRateLimits,
-            latestAssistantRateLimited: context.turnState.latestAssistantRateLimited,
+            latestAssistantRateLimited: context.turnState.latestAssistantError === "rate_limit",
             nowMs: now()
           }
         }
       })
     );
-    const { status, errorMessage } = outcome;
+    const { status, errorMessage, cause } = outcome;
+    const turn = context.turnState;
+    const category = status === "failed" ? claudeFailureCategory({
+      cause,
+      resultSubtype: message.subtype,
+      apiErrorStatus: "api_error_status" in message ? message.api_error_status : void 0,
+      retryErrorStatus: turn?.lastRetryErrorStatus,
+      assistantError: turn?.latestAssistantError,
+      quotaWindowRejected: (turn?.rejectedRateLimits.size ?? 0) > 0,
+      structuredErrorType: claudeStructuredErrorType(message)
+    }) : void 0;
     if (status === "failed") {
-      await emitRuntimeError(context, errorMessage ?? "Claude turn failed.");
+      await emitRuntimeError(context, errorMessage ?? "Claude turn failed.", void 0, category);
     }
-    await completeTurn(context, status, errorMessage, message);
+    await completeTurn(context, status, errorMessage, message, category);
   };
   return { handleUserMessage, handleAssistantMessage, handleResultMessage };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-claude",
-  "version": "0.2.3020",
+  "version": "0.2.3028",
   "description": "Claude executor: Claude Code CLI via @anthropic-ai/claude-agent-sdk.",
   "keywords": [
     "ycodium",
@@ -24,10 +24,10 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
-    "ycodium-composer-tokens": "0.0.0",
-    "ycodium-executor-testing": "0.0.0",
+    "@ycodium-ai/plugin-api": "0.2.3028",
     "ycodium-jsonl-stream": "0.0.0",
-    "@ycodium-ai/plugin-api": "0.2.3020"
+    "ycodium-executor-testing": "0.0.0",
+    "ycodium-composer-tokens": "0.0.0"
   },
   "ycodium": {
     "plugin": "./dist/index.js",