claude-code-rust 0.14.0 → 0.14.1

package/README.md

@@ -18,14 +18,12 @@ Claude Code Rust replaces the stock Claude Code terminal interface with a native
 
 ## Prerequisite
 
-- Install the Claude Code CLI. You do not need to authenticate before installing or starting `claude-rs`; sign in later with `/login` or `claude auth login` when needed.
+- The Claude Code CLI must be installed as fallback for some SDK-unsupported features.
 
 ## Install
 
 ### Install script (recommended, v0.14.0+)
 
-The install script downloads a complete GitHub Release archive. It does not require Rust, Node.js, npm, or Bun on the user's machine.
-
 **macOS/Linux:**
 
 ```bash
@@ -40,15 +38,11 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm 'https://raw.githubu
 
 ### npm (global)
 
-npm remains supported for users who prefer package-manager ownership of the global command:
-
 ```bash
 npm install -g claude-code-rust
 ```
 
-This option requires Node.js 24 and npm. The npm package installs a small launcher plus a platform-specific optional dependency containing the prebuilt Rust binary, Agent SDK bridge, and bundled private Bun runtime for your OS and architecture. A separate Rust toolchain or Bun installation is not required.
-
-See the [installation guide](https://srothgan.github.io/claude-code-rust/installation.html) for release pinning, custom locations, switching install methods, and troubleshooting.
+See the [installation guide](https://srothgan.github.io/claude-code-rust/installation.html) for release pinning, custom install locations, switching install methods, uninstall, and troubleshooting.
 
 ## Usage
 
@@ -77,13 +71,15 @@ Claude Code Rust addresses these with a native terminal UI that uses diffed, dir
 
 ## Documentation
 
-The manual covers installation with scripts, npm, and source builds, plus help, slash commands, keyboard shortcuts, settings, diagnostics, architecture, and the changelog:
+The manual covers installation with scripts and npm, plus help, slash commands, keyboard shortcuts, settings, diagnostics, troubleshooting, building from source, architecture, and the changelog:
 
 - [Installation](https://srothgan.github.io/claude-code-rust/installation.html)
 - [Usage](https://srothgan.github.io/claude-code-rust/usage.html)
 - [Help](https://srothgan.github.io/claude-code-rust/help.html)
 - [Slash commands](https://srothgan.github.io/claude-code-rust/commands.html)
 - [Settings](https://srothgan.github.io/claude-code-rust/settings.html)
+- [Troubleshooting](https://srothgan.github.io/claude-code-rust/troubleshooting.html)
+- [Development](https://srothgan.github.io/claude-code-rust/development.html)
 
 ## Status
 

package/agent-sdk/dist/bridge/account_metadata.js

@@ -4,6 +4,7 @@ const KNOWN_API_PROVIDERS = new Set([
     "vertex",
     "foundry",
     "anthropicAws",
+    "anthropicGoogleCloud",
     "mantle",
     "gateway",
 ]);

package/agent-sdk/dist/bridge/message_handlers.js

@@ -8,7 +8,7 @@ import { linkTaskToolUse, unlinkTaskToolUse } from "./task_links.js";
 import { emitAuthRequired, classifyTurnErrorKind, emitFastModeUpdateIfChanged } from "./error_classification.js";
 import { mapAvailableAgentsFromNames, emitAvailableAgentsIfChanged, refreshAvailableAgents } from "./agents.js";
 import { mapInitSlashCommands, mapSdkSlashCommands, updateAvailableCommands, } from "./available_commands.js";
-import { buildApiRetryUpdate, buildRateLimitUpdate, normalizeSettingsParseErrors, numberField, parseApiRetryError, parseRuntimeSessionState, } from "./state_parsing.js";
+import { buildApiRetryUpdate, buildRateLimitUpdate, buildSubagentRetryUpdate, normalizeSettingsParseErrors, numberField, parseApiRetryError, parseRuntimeSessionState, } from "./state_parsing.js";
 import { looksLikeAuthRequired } from "./auth.js";
 import { emitCurrentModelUpdate, refreshCurrentModel, updateSessionId } from "./session_lifecycle.js";
 import { bridgeLogger, LOG_TARGETS } from "./logger.js";
@@ -1159,7 +1159,29 @@ export function handleSdkMessage(session, message) {
             },
         });
         if (resolvedToolUseId) {
-            emitToolProgressUpdate(session, resolvedToolUseId, toolName);
+            const hasSubagentRetry = Object.hasOwn(msg, "subagent_retry");
+            const subagentRetry = hasSubagentRetry ? buildSubagentRetryUpdate(msg) : null;
+            if (hasSubagentRetry && !subagentRetry) {
+                bridgeLogger.warn({
+                    target: LOG_TARGETS.APP_TOOL,
+                    eventName: "sdk_subagent_retry_rejected",
+                    message: "ignored malformed SDK subagent retry progress",
+                    outcome: "invalid_payload",
+                    sessionId: session.sessionId,
+                    toolCallId: resolvedToolUseId,
+                });
+            }
+            const subagentType = typeof msg.subagent_type === "string" && msg.subagent_type.trim()
+                ? msg.subagent_type.trim()
+                : undefined;
+            emitToolProgressUpdate(session, resolvedToolUseId, toolName, {
+                ...(subagentRetry
+                    ? { subagentRetry }
+                    : hasSubagentRetry
+                        ? {}
+                        : { subagentRetry: { state: "clear" } }),
+                ...(subagentType ? { subagentType } : {}),
+            });
         }
         return;
     }

package/agent-sdk/dist/bridge/session_lifecycle.js

@@ -100,23 +100,28 @@ function settingsObjectFromLaunchSettings(launchSettings) {
     return launchSettings.settings;
 }
 function normalizedSettingsFromLaunchSettings(launchSettings) {
-    const settings = settingsObjectFromLaunchSettings(launchSettings);
-    if (!settings) {
-        return undefined;
-    }
+    const settings = settingsObjectFromLaunchSettings(launchSettings) ?? {};
+    // SendFeedback queues a local draft that can only be reviewed, edited, and
+    // discarded through the native /feedback surface. Agent SDK command
+    // snapshots do not expose that command to this host, so enabling drafts
+    // would create content that claude-rs cannot safely let the user approve.
+    const hostSettings = {
+        ...settings,
+        feedbackDrafts: "off",
+    };
     const sandbox = settings.sandbox && typeof settings.sandbox === "object" && !Array.isArray(settings.sandbox)
         ? settings.sandbox
         : undefined;
     if (sandbox?.enabled === true && sandbox.failIfUnavailable === undefined) {
         return {
-            ...settings,
+            ...hostSettings,
             sandbox: {
                 ...sandbox,
                 failIfUnavailable: false,
             },
         };
     }
-    return settings;
+    return hostSettings;
 }
 export function sessionById(sessionId) {
     return sessions.get(sessionId) ?? null;
@@ -612,9 +617,13 @@ export function buildQueryOptions(params) {
         includePartialMessages: true,
         promptSuggestions: true,
         enableFileCheckpointing: true,
+        // ProposeSkills reports only a proposal count and expects a native review
+        // surface. Keep it out of this host until claude-rs can display the actual
+        // proposal input and accept/reject it without losing content.
+        disallowedTools: ["ProposeSkills"],
         executable: "bun",
         ...(params.resume ? {} : { sessionId: params.provisionalSessionId }),
-        ...(settings ? { settings } : {}),
+        settings,
         ...modelOption,
         ...permissionModeOptions,
         toolConfig: { askUserQuestion: { previewFormat: "markdown" } },

package/agent-sdk/dist/bridge/state_parsing.js

@@ -15,6 +15,34 @@ function nonNegativeNumberField(record, ...keys) {
     }
     return value;
 }
+function nonNegativeIntegerField(record, ...keys) {
+    const value = numberField(record, ...keys);
+    return value !== undefined && value >= 0 && Number.isInteger(value) ? value : undefined;
+}
+export function buildSubagentRetryUpdate(message) {
+    const retry = asRecordOrNull(message.subagent_retry);
+    if (!retry) {
+        return null;
+    }
+    const attempt = nonNegativeIntegerField(retry, "attempt");
+    const maxRetries = nonNegativeIntegerField(retry, "max_retries", "maxRetries");
+    const retryDelayMs = nonNegativeIntegerField(retry, "retry_delay_ms", "retryDelayMs");
+    if (attempt === undefined || maxRetries === undefined || retryDelayMs === undefined) {
+        return null;
+    }
+    const agentId = typeof retry.agent_id === "string" ? retry.agent_id.trim() : "";
+    const errorCategory = typeof retry.error_category === "string" ? retry.error_category.trim() : "";
+    const errorStatus = nonNegativeIntegerField(retry, "error_status", "errorStatus");
+    return {
+        state: "waiting",
+        ...(agentId ? { agent_id: agentId } : {}),
+        attempt,
+        max_retries: maxRetries,
+        retry_delay_ms: retryDelayMs,
+        ...(errorStatus !== undefined ? { error_status: errorStatus } : {}),
+        ...(errorCategory ? { error_category: errorCategory } : {}),
+    };
+}
 export function parseFastModeState(value) {
     if (value === "off" || value === "cooldown" || value === "on") {
         return value;

package/agent-sdk/dist/bridge/tool_calls.js

@@ -112,10 +112,14 @@ function mergeTaskMetadata(current, update) {
     if (update === undefined) {
         return current;
     }
-    return {
+    const merged = {
         ...(current ?? {}),
         ...update,
     };
+    if (update.subagent_retry?.state === "clear") {
+        delete merged.subagent_retry;
+    }
+    return merged;
 }
 function applyFieldsToBase(base, fields) {
     if (fields.title !== undefined) {
@@ -237,6 +241,16 @@ function taskTitleContext(session, name, input) {
 }
 export function emitToolCallUpdate(session, toolUseId, fields, updateKind, sourceMessageUuid) {
     const base = session.toolCalls.get(toolUseId);
+    const nextStatus = fields.status ?? base?.status;
+    const terminal = nextStatus === "completed" || nextStatus === "failed" || nextStatus === "killed";
+    const hasActiveRetry = base?.task_metadata?.subagent_retry?.state === "waiting" ||
+        fields.task_metadata?.subagent_retry?.state === "waiting";
+    if (terminal && hasActiveRetry) {
+        fields.task_metadata = {
+            ...(fields.task_metadata ?? {}),
+            subagent_retry: { state: "clear" },
+        };
+    }
     logToolCallUpdateEmitted(session.sessionId, toolUseId, fields, base, updateKind);
     emitSessionUpdate(session.sessionId, {
         type: "tool_call_update",
@@ -324,19 +338,39 @@ export function finalizeOpenToolCalls(session, status) {
         emitToolCallUpdate(session, toolUseId, { status }, "finalize");
     }
 }
-export function emitToolProgressUpdate(session, toolUseId, toolName) {
-    const existing = session.toolCalls.get(toolUseId);
+export function emitToolProgressUpdate(session, toolUseId, toolName, progress = {}) {
+    let existing = session.toolCalls.get(toolUseId);
     if (!existing) {
         emitToolCall(session, toolUseId, toolName, {});
-        return;
+        existing = session.toolCalls.get(toolUseId);
     }
-    if (existing.status === "in_progress" ||
+    if (!existing ||
         existing.status === "completed" ||
         existing.status === "failed" ||
         existing.status === "killed") {
         return;
     }
-    emitToolCallUpdate(session, toolUseId, { status: "in_progress" }, "progress");
+    const taskMetadata = {};
+    if (progress.subagentRetry?.state === "waiting") {
+        taskMetadata.subagent_retry = progress.subagentRetry;
+    }
+    else if (progress.subagentRetry?.state === "clear" &&
+        existing.task_metadata?.subagent_retry?.state === "waiting") {
+        taskMetadata.subagent_retry = progress.subagentRetry;
+    }
+    if (progress.subagentType && progress.subagentType !== existing.task_metadata?.subagent_type) {
+        taskMetadata.subagent_type = progress.subagentType;
+    }
+    const fields = {};
+    if (existing.status !== "in_progress") {
+        fields.status = "in_progress";
+    }
+    if (Object.keys(taskMetadata).length > 0) {
+        fields.task_metadata = taskMetadata;
+    }
+    if (Object.keys(fields).length > 0) {
+        emitToolCallUpdate(session, toolUseId, fields, "progress");
+    }
 }
 export function emitToolSummaryUpdate(session, toolUseId, summary) {
     const base = session.toolCalls.get(toolUseId);

package/agent-sdk/dist/bridge/tooling.js

@@ -482,9 +482,19 @@ function extractToolOutputMetadata(toolName, rawResult, rawContent) {
     if (toolName === "Bash") {
         for (const candidate of candidates) {
             const hasAssistantAutoBackgrounded = typeof candidate.assistantAutoBackgrounded === "boolean";
-            if (hasAssistantAutoBackgrounded) {
+            const timedOutAfterMs = nonNegativeInteger(candidate.timedOutAfterMs);
+            const backgroundCwdHint = nonEmptyString(candidate.backgroundCwdHint);
+            if (hasAssistantAutoBackgrounded || timedOutAfterMs !== undefined || backgroundCwdHint) {
                 const bashMetadata = {};
-                bashMetadata.assistant_auto_backgrounded = candidate.assistantAutoBackgrounded;
+                if (hasAssistantAutoBackgrounded) {
+                    bashMetadata.assistant_auto_backgrounded = candidate.assistantAutoBackgrounded;
+                }
+                if (timedOutAfterMs !== undefined) {
+                    bashMetadata.timed_out_after_ms = timedOutAfterMs;
+                }
+                if (backgroundCwdHint) {
+                    bashMetadata.background_cwd_hint = backgroundCwdHint;
+                }
                 metadata.bash = bashMetadata;
                 break;
             }
@@ -493,9 +503,11 @@ function extractToolOutputMetadata(toolName, rawResult, rawContent) {
     if (toolName === "Agent" || toolName === "Task") {
         for (const candidate of candidates) {
             const resolvedModel = nonEmptyString(candidate.resolvedModel);
-            if (resolvedModel) {
+            const modelsUsed = orderedNonEmptyStrings(candidate.modelsUsed);
+            if (resolvedModel || modelsUsed) {
                 const agentMetadata = {
-                    resolved_model: resolvedModel,
+                    ...(resolvedModel ? { resolved_model: resolvedModel } : {}),
+                    ...(modelsUsed ? { models_used: modelsUsed } : {}),
                 };
                 metadata.agent = agentMetadata;
                 break;
@@ -736,6 +748,10 @@ function shellBackgroundMessage(record) {
     if (!backgroundTaskId) {
         return "";
     }
+    const timedOutAfterMs = nonNegativeInteger(record.timedOutAfterMs);
+    if (timedOutAfterMs !== undefined) {
+        return `Command was auto-backgrounded after ${timedOutAfterMs.toLocaleString("en-US")} ms with ID: ${backgroundTaskId}.`;
+    }
     if (record.assistantAutoBackgrounded === true) {
         return `Command was auto-backgrounded by assistant mode with ID: ${backgroundTaskId}.`;
     }
@@ -812,6 +828,9 @@ function recordNumber(record, key) {
     const value = record[key];
     return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
+function recordNonNegativeInteger(record, key) {
+    return nonNegativeInteger(record[key]);
+}
 function recordString(record, key) {
     const value = record[key];
     return typeof value === "string" ? value : undefined;
@@ -857,8 +876,13 @@ function globResultText(record) {
 function grepResultText(record) {
     const filenames = searchFilenames(record);
     const content = recordString(record, "content") ?? "";
-    const numFiles = recordNumber(record, "numFiles") ?? filenames.length;
-    const numLines = recordNumber(record, "numLines");
+    const hasVisibleMatches = content.trim().length > 0 || filenames.length > 0;
+    const totalFiles = recordNonNegativeInteger(record, "totalFiles");
+    const legacyNumFiles = recordNonNegativeInteger(record, "numFiles");
+    const numFiles = totalFiles ??
+        (legacyNumFiles !== 0 || !hasVisibleMatches ? legacyNumFiles : undefined) ??
+        (filenames.length > 0 ? filenames.length : undefined);
+    const numLines = recordNonNegativeInteger(record, "totalLines") ?? recordNonNegativeInteger(record, "numLines");
     const numMatches = recordNumber(record, "numMatches");
     const appliedLimit = recordNumber(record, "appliedLimit");
     const appliedOffset = recordNumber(record, "appliedOffset");
@@ -878,7 +902,9 @@ function grepResultText(record) {
         lines.push("No matches found");
     }
     const summaryParts = [];
-    summaryParts.push(`${numFiles} ${pluralize(numFiles, "file")}`);
+    if (numFiles !== undefined) {
+        summaryParts.push(`${numFiles} ${pluralize(numFiles, "file")}`);
+    }
     if (numMatches !== undefined) {
         summaryParts.push(`${numMatches} ${pluralize(numMatches, "match", "matches")}`);
     }
@@ -937,6 +963,26 @@ function pushBooleanField(lines, label, value) {
 function nonEmptyString(value) {
     return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
+function nonNegativeInteger(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0
+        ? Math.trunc(value)
+        : undefined;
+}
+function orderedNonEmptyStrings(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const seen = new Set();
+    const values = [];
+    for (const item of value) {
+        const normalized = nonEmptyString(item);
+        if (normalized && !seen.has(normalized)) {
+            seen.add(normalized);
+            values.push(normalized);
+        }
+    }
+    return values.length > 0 ? values : undefined;
+}
 const CRON_MONTH_NAMES = [
     "January",
     "February",

package/agent-sdk/dist/bridge.js

@@ -108,9 +108,23 @@ export async function generatePersistedSessionTitle(query, description) {
     return title;
 }
 export async function applySessionEffort(query, effort) {
-    const settings = { effortLevel: effort };
-    // applyFlagSettings controls live session settings; SDK Settings typings model persisted effort levels.
-    await query.applyFlagSettings(settings);
+    await query.applyFlagSettings({ effortLevel: effort });
+}
+export function buildPromptUserMessage(command, sessionId) {
+    const content = contentFromPrompt(command);
+    if (content.length === 0) {
+        return undefined;
+    }
+    return {
+        type: "user",
+        session_id: sessionId,
+        parent_tool_use_id: null,
+        origin: { kind: "human" },
+        message: {
+            role: "user",
+            content,
+        },
+    };
 }
 export async function applySessionAgent(query, agent) {
     const settings = { agent };
@@ -130,7 +144,7 @@ export function emitAgentConfigOptionUpdate(sessionId, agent) {
         value: agent,
     });
 }
-const EXPECTED_AGENT_SDK_VERSION = "0.3.207";
+const EXPECTED_AGENT_SDK_VERSION = "0.3.214";
 const require = createRequire(import.meta.url);
 export function resolveInstalledAgentSdkVersion() {
     try {
@@ -662,19 +676,10 @@ async function handleCommand(command, requestId) {
                 slashError(command.session_id, `unknown session: ${command.session_id}`, requestId);
                 return;
             }
-            const content = contentFromPrompt(command);
-            if (content.length === 0) {
+            const message = buildPromptUserMessage(command, session.sessionId);
+            if (!message) {
                 return;
             }
-            const message = {
-                type: "user",
-                session_id: session.sessionId,
-                parent_tool_use_id: null,
-                message: {
-                    role: "user",
-                    content,
-                },
-            };
             session.input.enqueue(message);
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-rust",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Claude Code Rust - native Rust terminal interface for Claude Code",
   "keywords": [
     "cli",
@@ -33,15 +33,15 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.3.207"
+    "@anthropic-ai/claude-agent-sdk": "0.3.214"
   },
   "optionalDependencies": {
-    "@srothgan/claude-code-rust-darwin-arm64": "0.14.0",
-    "@srothgan/claude-code-rust-darwin-x64": "0.14.0",
-    "@srothgan/claude-code-rust-linux-x64-gnu": "0.14.0",
-    "@srothgan/claude-code-rust-linux-arm64-gnu": "0.14.0",
-    "@srothgan/claude-code-rust-win32-x64-msvc": "0.14.0",
-    "@srothgan/claude-code-rust-win32-arm64-msvc": "0.14.0"
+    "@srothgan/claude-code-rust-darwin-arm64": "0.14.1",
+    "@srothgan/claude-code-rust-darwin-x64": "0.14.1",
+    "@srothgan/claude-code-rust-linux-x64-gnu": "0.14.1",
+    "@srothgan/claude-code-rust-linux-arm64-gnu": "0.14.1",
+    "@srothgan/claude-code-rust-win32-x64-msvc": "0.14.1",
+    "@srothgan/claude-code-rust-win32-arm64-msvc": "0.14.1"
   },
   "engines": {
     "node": ">=24"