@ycodium-ai/agent-claude 0.2.2596 → 0.2.2658

package/dist/index.js

@@ -19650,7 +19650,11 @@ function HU(e, t) {
 }
 
 // src/claudeInstance.ts
-import { mergeLaunchEnv as mergeLaunchEnv2 } from "@ycodium-ai/plugin-api/executor";
+import {
+  describeExecutorSpawnFailure,
+  ExecutorSpawnRefusedError,
+  mergeLaunchEnv as mergeLaunchEnv2
+} from "@ycodium-ai/plugin-api/executor";
 
 // src/claudeAccount.ts
 import * as NodeFS from "node:fs";
@@ -19854,6 +19858,34 @@ function makeClaudeEnvironment(config, baseEnv) {
   if (Object.keys(variables).length === 0) return resolvedBaseEnv;
   return { ...resolvedBaseEnv, ...variables };
 }
+var quoteLiteral = (value) => JSON.stringify(value);
+function claudeSignedOutMessage(input) {
+  const variables = [];
+  const configDir = input.configDir?.trim() ?? "";
+  if (configDir.length > 0) {
+    variables.push(
+      `CLAUDE_CONFIG_DIR set to ${quoteLiteral(NodePath4.resolve(input.cwd, configDir))}`
+    );
+  }
+  const credentialsDir = input.credentialsDir?.trim() ?? "";
+  if (credentialsDir.length > 0) {
+    variables.push(
+      `${CLAUDE_CREDENTIALS_DIR_ENVIRONMENT_VARIABLE} set to ${quoteLiteral(NodePath4.resolve(input.cwd, credentialsDir))}`
+    );
+  }
+  const withVariables = variables.length > 0 ? `, with ${variables.join(" and ")}` : "";
+  return `Claude could not authenticate. For subscription login, run \`claude auth login\` on this machine${withVariables}, then start a new thread. For API-key authentication, check this instance's configured credentials.`;
+}
+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 void 0;
+}
 
 // src/claudeSignIn.ts
 var POSIX_BARE_VALUE = /^[A-Za-z0-9_@%+=:,./-]+$/;
@@ -20135,8 +20167,8 @@ var EventBus = class {
         const queued = this.#queued.shift();
         if (queued !== void 0) return Promise.resolve({ done: false, value: queued });
         if (this.#closed) return Promise.resolve({ done: true, value: void 0 });
-        return new Promise((resolve2) => {
-          this.#waiters.push(resolve2);
+        return new Promise((resolve3) => {
+          this.#waiters.push(resolve3);
         });
       }
     };
@@ -20323,9 +20355,9 @@ var claudeCatalogFromSdk = (models) => {
 };
 var silentPrompt = (signal) => ({
   [Symbol.asyncIterator]: () => ({
-    next: () => new Promise((resolve2) => {
-      if (signal.aborted) resolve2({ done: true, value: void 0 });
-      signal.addEventListener("abort", () => resolve2({ done: true, value: void 0 }), {
+    next: () => new Promise((resolve3) => {
+      if (signal.aborted) resolve3({ done: true, value: void 0 });
+      signal.addEventListener("abort", () => resolve3({ done: true, value: void 0 }), {
         once: true
       });
     }),
@@ -20369,6 +20401,14 @@ var readClaudeSdkModels = async (input) => {
     }
   }
 };
+function claudeModelProbeEnvironment(environment) {
+  return {
+    ...environment,
+    FORCE_CODE_TERMINAL: void 0,
+    CLAUDE_CODE_AUTO_CONNECT_IDE: "0",
+    CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL: "1"
+  };
+}
 var claudeSdkModelsCwd = () => NodeOS5.tmpdir();
 
 // src/util.ts
@@ -20912,7 +20952,7 @@ function isClaudeInterruptedCause(cause) {
 function resultErrorsText(result) {
   return "errors" in result && Array.isArray(result.errors) ? result.errors.join(" ").toLowerCase() : "";
 }
-function resultUserFacingError(result) {
+function resultListedError(result) {
   if (result.subtype === "success") {
     return result.is_error ? result.result : void 0;
   }
@@ -20921,6 +20961,37 @@ function resultUserFacingError(result) {
   }
   return result.errors.find((error) => !error.startsWith("[ede_diagnostic]"));
 }
+function terminalResultError(reason, failureHint) {
+  switch (reason) {
+    case "api_error":
+      return failureHint ?? "Claude gave up after repeated API errors.";
+    case "malformed_tool_use_exhausted":
+      return "Claude gave up after repeated malformed tool calls.";
+    case "budget_exhausted":
+      return "Claude stopped: the turn's token budget was exhausted.";
+    case "structured_output_retry_exhausted":
+      return "Claude could not produce the requested structured output.";
+    case "tool_deferred_unavailable":
+      return "Claude could not resume a deferred tool call: the tool is no longer available.";
+    case "turn_setup_failed":
+      return "Claude could not start the turn.";
+    case "blocking_limit":
+      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":
+      return "Claude stopped: the prompt exceeds the model's context window.";
+    case "image_error":
+      return "Claude stopped: an image in the conversation could not be processed.";
+    case "model_error":
+      return "Claude stopped: the model returned an error.";
+    default:
+      return void 0;
+  }
+}
+function isOverloadedResult(result) {
+  return result.subtype === "success" && result.api_error_status === 529;
+}
 function isInterruptedResult(result) {
   if (result.terminal_reason === "aborted_tools" || result.terminal_reason === "aborted_streaming") {
     return true;
@@ -20931,18 +21002,19 @@ 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 turnStatusFromResult(result) {
+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 };
   if (result.subtype === "success" && !result.is_error) {
-    return "completed";
-  }
-  const errors = resultErrorsText(result);
-  if (isInterruptedResult(result)) {
-    return "interrupted";
+    return { status: "completed", errorMessage };
   }
-  if (errors.includes("cancel")) {
-    return "cancelled";
-  }
-  return "failed";
+  if (isInterruptedResult(result)) return { status: "interrupted", errorMessage };
+  return {
+    status: resultErrorsText(result).includes("cancel") ? "cancelled" : "failed",
+    errorMessage
+  };
 }
 function streamKindFromDeltaType(deltaType) {
   return deltaType.includes("thinking") ? "reasoning_text" : "assistant_text";
@@ -23111,9 +23183,9 @@ var PromptQueue = class {
     const queued = this.#queued.shift();
     if (queued !== void 0) return Promise.resolve(queued);
     if (this.#closed) return Promise.resolve(void 0);
-    return new Promise((resolve2) => {
+    return new Promise((resolve3) => {
       this.#waiters.push((result) => {
-        resolve2(result.done ? void 0 : result.value);
+        resolve3(result.done ? void 0 : result.value);
       });
     });
   }
@@ -23257,6 +23329,7 @@ function toClaudeMcpServers(entries) {
   }
   return servers;
 }
+var CLAUDE_PROGRAM_NOT_CONFIGURED = "Claude program path is not configured";
 function createClaudeAdapter(recipe, host, options) {
   const boundInstanceId = options?.instanceId ?? host.instanceId ?? "claudeAgent";
   const claudeHomeEnvironment = makeClaudeEnvironment(recipe, options?.environment);
@@ -23264,10 +23337,14 @@ function createClaudeAdapter(recipe, host, options) {
     recipe.binaryPath,
     claudeHomeEnvironment
   );
-  const createQuery = options?.createQuery ?? ((input) => XAe({
+  const sdkCreateQuery = options?.createQuery ?? ((input) => XAe({
     prompt: input.prompt,
     options: input.options
   }));
+  const createQuery = (input) => {
+    if (recipe.binaryPath.length === 0) throw new Error(CLAUDE_PROGRAM_NOT_CONFIGURED);
+    return sdkCreateQuery(input);
+  };
   const buildLaunchEnvironment = () => mergeLaunchEnv2({
     inherited: { ...process.env, ...options?.environment },
     instanceTable: recipe.environment,
@@ -23293,7 +23370,7 @@ function createClaudeAdapter(recipe, host, options) {
           cwd: claudeSdkModelsCwd(),
           pathToClaudeCodeExecutable: claudeSdkExecutablePath,
           settingSources: [...CLAUDE_SETTING_SOURCES],
-          env: compactEnv(buildLaunchEnvironment()),
+          env: compactEnv(claudeModelProbeEnvironment(buildLaunchEnvironment())),
           ...Object.keys(extraArgs).length > 0 ? { extraArgs } : {}
         }
       });
@@ -23660,6 +23737,7 @@ function createClaudeAdapter(recipe, host, options) {
       latestAssistantUsage: void 0,
       compactedSinceLatestAssistantUsage: false,
       retrying: false,
+      authenticationFailed: false,
       nextSyntheticAssistantBlockIndex: -1
     };
     context.session = {
@@ -24248,6 +24326,9 @@ function createClaudeAdapter(recipe, host, options) {
       return;
     }
     if (isClaudeSyntheticApiErrorMessage(message)) {
+      if (context.turnState && message.error === "authentication_failed") {
+        context.turnState.authenticationFailed = true;
+      }
       context.lastAssistantUuid = message.uuid;
       await updateResumeCursor(context);
       return;
@@ -24315,8 +24396,14 @@ function createClaudeAdapter(recipe, host, options) {
       return;
     }
     context.compactionInProgress = false;
-    const status = turnStatusFromResult(message);
-    const errorMessage = resultUserFacingError(message);
+    const { status, errorMessage } = resultOutcome(
+      message,
+      claudeFailureHint({
+        authenticationFailed: context.turnState?.authenticationFailed === true,
+        environment: buildLaunchEnvironment(),
+        cwd: NodePath8.resolve(context.session.cwd ?? ".")
+      })
+    );
     if (status === "failed") {
       await emitRuntimeError(context, errorMessage ?? "Claude turn failed.");
     }
@@ -24399,11 +24486,28 @@ function createClaudeAdapter(recipe, host, options) {
         payload: message
       }
     };
-    switch (message.subtype) {
+    const subtype = message.subtype;
+    const record = message;
+    switch (subtype) {
       case "background_tasks_changed":
       case "vcs_state_changed":
       case "code_change_published":
+      case "control_request_progress":
+      case "worker_shutting_down":
+      case "conversation_reset":
+        return;
+      case "informational":
+        if (record.level === "warning" && typeof record.content === "string") {
+          await emitRuntimeWarning(context, record.content, message);
+        }
+        return;
+      case "model_refusal_no_fallback": {
+        const explanation = typeof record.api_refusal_explanation === "string" ? record.api_refusal_explanation.trim() : "";
+        const content = typeof record.content === "string" ? record.content : "";
+        const text = explanation || content;
+        if (text.length > 0) await emitRuntimeWarning(context, text, message);
         return;
+      }
     }
     switch (message.subtype) {
       case "init":
@@ -24829,6 +24933,9 @@ function createClaudeAdapter(recipe, host, options) {
     if (sdkMessageType(message) === "command_lifecycle") {
       return;
     }
+    if (sdkMessageType(message) === "conversation_reset") {
+      return;
+    }
     switch (message.type) {
       case "stream_event":
         await handleStreamEvent(context, message);
@@ -24964,7 +25071,7 @@ function createClaudeAdapter(recipe, host, options) {
       if (streamFiber) {
         await Promise.race([
           streamFiber.catch(() => void 0),
-          new Promise((resolve2) => setTimeout(resolve2, 1e3))
+          new Promise((resolve3) => setTimeout(resolve3, 1e3))
         ]);
       }
       const updatedAt = nowIso();
@@ -25074,7 +25181,14 @@ function createClaudeAdapter(recipe, host, options) {
     return withProcessGeneration(context.session, context);
   };
   const startSession = async (input) => {
-    const extraArgs = parseCliArgs(recipe.launchArgs).flags;
+    if (recipe.binaryPath.length === 0) throw new Error(CLAUDE_PROGRAM_NOT_CONFIGURED);
+    const {
+      "permission-mode": launchArgPermissionMode,
+      "dangerously-skip-permissions": launchArgSkipPermissions,
+      ...extraArgs
+    } = parseCliArgs(recipe.launchArgs, {
+      booleanFlags: ["dangerously-skip-permissions"]
+    }).flags;
     const modelSelection = boundModelSelection(input.modelSelection, boundInstanceId);
     await modelCatalogRead;
     const caps = claudeModelCapabilities(
@@ -25103,6 +25217,21 @@ function createClaudeAdapter(recipe, host, options) {
     const ultracode = isClaudeUltracodeEffort(effort);
     const effectiveEffort = getEffectiveClaudeAgentEffort(effort);
     const permissionMode = claudePermissionModeFor(input.runtimeMode, input.nativeModeId);
+    if (launchArgPermissionMode !== void 0) {
+      (options?.log ?? host.log).warn("claude.launchArgs.permissionModeIgnored", {
+        threadId: input.threadId,
+        launchArgValue: launchArgPermissionMode,
+        seatMode: permissionMode,
+        reason: "permission mode follows the permission seat; the launch argument was removed"
+      });
+    }
+    if (launchArgSkipPermissions !== void 0) {
+      (options?.log ?? host.log).warn("claude.launchArgs.skipPermissionsIgnored", {
+        threadId: input.threadId,
+        seatMode: permissionMode,
+        reason: "permission mode follows the permission seat; --dangerously-skip-permissions was removed"
+      });
+    }
     const settings = buildClaudeSessionSettings({
       thinking,
       fastMode,
@@ -25153,7 +25282,7 @@ function createClaudeAdapter(recipe, host, options) {
         return await Promise.race([
           contextDeferred.promise,
           new Promise(
-            (resolve2) => setTimeout(() => resolve2(void 0), CLAUDE_SESSION_CONTEXT_WAIT_MS)
+            (resolve3) => setTimeout(() => resolve3(void 0), CLAUDE_SESSION_CONTEXT_WAIT_MS)
           )
         ]);
       } catch {
@@ -25687,6 +25816,7 @@ function createClaudeAdapter(recipe, host, options) {
         latestAssistantUsage: void 0,
         compactedSinceLatestAssistantUsage: false,
         retrying: false,
+        authenticationFailed: false,
         nextSyntheticAssistantBlockIndex: -1
       };
       const updatedAt = nowIso();
@@ -25740,7 +25870,7 @@ function createClaudeAdapter(recipe, host, options) {
         context.query.interrupt().then(() => settled.promise).then(() => {
           acknowledged = true;
         }),
-        new Promise((resolve2) => setTimeout(resolve2, CLAUDE_INTERRUPT_GRACE_MS))
+        new Promise((resolve3) => setTimeout(resolve3, CLAUDE_INTERRUPT_GRACE_MS))
       ]);
     } catch (cause) {
       throw toRequestError(threadId, "turn/interrupt", cause);
@@ -25913,19 +26043,32 @@ function createClaudeInstance(config, host, attachments, overrides) {
       return {
         installed: false,
         version: null,
-        readiness: "error",
+        readiness: "not-installed",
         auth: { status: "unknown" },
-        detail: "Claude program path is not configured"
+        detail: CLAUDE_PROGRAM_NOT_CONFIGURED
       };
     }
     if (signal?.aborted) {
       throw new Error("aborted");
     }
-    const handle = await host.process.spawn({
-      program: recipe.binaryPath,
-      args: ["--version"],
-      owner: { bindingId: host.bindingId }
-    });
+    let handle;
+    try {
+      handle = await host.process.spawn({
+        program: recipe.binaryPath,
+        args: ["--version"],
+        owner: { bindingId: host.bindingId }
+      });
+    } catch (error) {
+      if (error instanceof ExecutorSpawnRefusedError) throw error;
+      const failure = describeExecutorSpawnFailure(error);
+      return {
+        installed: false,
+        version: null,
+        readiness: failure.readiness,
+        auth: { status: "unknown" },
+        detail: failure.detail
+      };
+    }
     const [stdout, stderr, exitCode] = await Promise.all([
       collectProcessText(handle.stdout),
       collectProcessText(handle.stderr),

package/locales/en.json

@@ -22,7 +22,7 @@
     },
     "launchArgs": {
       "title": "Launch arguments",
-      "description": "Additional CLI arguments passed on session start.",
+      "description": "Additional CLI arguments passed on session start. --permission-mode and --dangerously-skip-permissions are ignored here; choose the permission mode in the chat input.",
       "placeholder": "e.g. --chrome"
     }
   }

package/locales/zh-CN.json

@@ -22,7 +22,7 @@
     },
     "launchArgs": {
       "title": "启动参数",
-      "description": "会话启动时传入的额外命令行参数。",
+      "description": "会话启动时传入的额外命令行参数。其中的 --permission-mode 与 --dangerously-skip-permissions 会被忽略，权限模式请在输入区选择。",
       "placeholder": "例如 --chrome"
     }
   }

package/package.json

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