claude-code-rust 0.13.4 → 0.14.1

package/README.md

@@ -16,28 +16,33 @@ A native Rust terminal interface for Claude Code. Drop-in replacement for Anthro
 
 Claude Code Rust replaces the stock Claude Code terminal interface with a native Rust binary built on [Ratatui](https://ratatui.rs/). It connects to the same Claude API through a local Agent SDK bridge. Core Claude Code functionality - tool calls, file editing, terminal commands, and permissions - works unchanged.
 
-## Requisites
+## Prerequisite
 
-- Existing Claude Code authentication (`~/.claude/config.json`)
+- The Claude Code CLI must be installed as fallback for some SDK-unsupported features.
 
 ## Install
 
-### npm (global, recommended)
+### Install script (recommended, v0.14.0+)
+
+**macOS/Linux:**
 
 ```bash
-npm install -g claude-code-rust
+curl -fsSL https://raw.githubusercontent.com/srothgan/claude-code-rust/main/scripts/install/install.sh | sh
 ```
 
-The npm package installs a small launcher plus a platform-specific optional dependency containing the prebuilt Rust binary for your OS and architecture.
+**Windows PowerShell:**
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm 'https://raw.githubusercontent.com/srothgan/claude-code-rust/main/scripts/install/install.ps1' | iex"
+```
 
-If `claude-rs` reports a missing platform package, check whether optional dependencies were omitted:
+### npm (global)
 
 ```bash
-npm config get omit
 npm install -g claude-code-rust
 ```
 
-If `claude-rs` resolves to an older global shim, ensure your npm global bin directory comes first on `PATH` or remove the stale shim before retrying.
+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
 
@@ -66,13 +71,15 @@ Claude Code Rust addresses these with a native terminal UI that uses diffed, dir
 
 ## Documentation
 
-The manual covers installation from npm and source, 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/command_dispatch.js

@@ -1,8 +1,26 @@
+import { bridgeLogger, LOG_TARGETS } from "./logger.js";
 export async function dispatchCancelTurnCommand(command, deps) {
     const session = deps.sessionById(command.session_id);
     if (!session) {
         deps.slashError(command.session_id, `unknown session: ${command.session_id}`, deps.requestId);
         return;
     }
-    await session.query.interrupt();
+    const receipt = await session.query.interrupt();
+    const stillQueued = Array.isArray(receipt?.still_queued)
+        ? receipt.still_queued.filter((entry) => typeof entry === "string")
+        : [];
+    if (stillQueued.length > 0) {
+        bridgeLogger.info({
+            target: LOG_TARGETS.APP_SESSION,
+            eventName: "interrupt_receipt_still_queued",
+            message: "interrupt receipt reported queued async messages",
+            outcome: "success",
+            sessionId: command.session_id,
+            ...(deps.requestId ? { requestId: deps.requestId } : {}),
+            fields: {
+                still_queued_count: stillQueued.length,
+                still_queued: stillQueued,
+            },
+        });
+    }
 }

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

@@ -307,6 +307,7 @@ export function parseCommandEnvelope(line) {
                     session_id: expectString(raw, "session_id", "reload_plugins"),
                 };
             case "mcp_status":
+            // Rust historically sends `get_mcp_snapshot`; normalize it to the bridge-internal command.
             case "get_mcp_snapshot":
                 return {
                     command: "mcp_status",
@@ -450,6 +451,9 @@ function parseQuestionAnnotation(value) {
     };
 }
 export function toPermissionMode(mode) {
+    if (mode === "manual") {
+        return "default";
+    }
     if (mode === "default" ||
         mode === "auto" ||
         mode === "acceptEdits" ||

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

@@ -3,12 +3,12 @@ import { toPermissionMode, buildModeState, refreshSupportedModesForSession } fro
 import { writeEvent, emitSessionUpdate, emitConnectEvent, emitSessionReplacedEvent, } from "./events.js";
 import { TOOL_RESULT_TYPES, isToolSearchToolName, isToolSearchToolResultType, unwrapToolUseResult, } from "./tooling.js";
 import { emitToolCall, emitToolCallUpdate, emitToolResultUpdate, finalizeOpenToolCalls, emitToolProgressUpdate, emitToolSummaryUpdate, ensureToolCallVisible, resolveTaskToolUseId, defersTaskNotificationCompletion, toolAcceptsTaskLifecycle, taskProgressText, taskUpdatedFields, } from "./tool_calls.js";
-import { applyTaskLifecycleState } from "./tasks.js";
+import { applyBackgroundTasksChanged, applyTaskLifecycleState } from "./tasks.js";
 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";
@@ -39,6 +39,7 @@ function sdkCorrelationMetadata(msg) {
         requestId: typeof msg.request_id === "string" ? msg.request_id : undefined,
         subagentType: typeof msg.subagent_type === "string" ? msg.subagent_type : undefined,
         taskDescription: typeof msg.task_description === "string" ? msg.task_description : undefined,
+        parentAgentId: typeof msg.parent_agent_id === "string" ? msg.parent_agent_id : undefined,
     };
 }
 function sdkTaskMetadata(msg) {
@@ -53,12 +54,14 @@ function sdkTaskMetadata(msg) {
         ...(metadata.requestId ? { request_id: metadata.requestId } : {}),
         ...(metadata.subagentType ? { subagent_type: metadata.subagentType } : {}),
         ...(metadata.taskDescription ? { task_description: metadata.taskDescription } : {}),
+        ...(metadata.parentAgentId ? { parent_agent_id: metadata.parentAgentId } : {}),
         ...(taskType ? { task_type: taskType } : {}),
         ...(workflowName ? { workflow_name: workflowName } : {}),
         ...(prompt ? { prompt } : {}),
         ...(outputFile ? { output_file: outputFile } : {}),
         ...(summary ? { summary } : {}),
         ...(status ? { terminal_status: status } : {}),
+        ...(typeof msg.blocked === "boolean" ? { blocked: msg.blocked } : {}),
     };
     return Object.keys(taskMetadata).length > 0 ? taskMetadata : undefined;
 }
@@ -822,6 +825,13 @@ function terminalReasonFromValue(value) {
         case "hook_stopped":
         case "tool_deferred":
         case "max_turns":
+        case "background_requested":
+        case "api_error":
+        case "malformed_tool_use_exhausted":
+        case "budget_exhausted":
+        case "structured_output_retry_exhausted":
+        case "tool_deferred_unavailable":
+        case "turn_setup_failed":
         case "completed":
             return value;
         default:
@@ -848,6 +858,10 @@ export function handleSdkMessage(session, message) {
             updateAvailableCommands(session, "commands_changed", mapSdkSlashCommands(msg.commands));
             return;
         }
+        if (subtype === "background_tasks_changed") {
+            applyBackgroundTasksChanged(session, msg);
+            return;
+        }
         if (subtype === "notification") {
             const text = typeof msg.text === "string" ? msg.text : "";
             emitSystemNoticeUpdate(session, notificationSeverity(msg.priority), text);
@@ -1145,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;
@@ -542,6 +547,8 @@ function permissionModeFromSettingsValue(rawMode) {
         return undefined;
     }
     switch (rawMode) {
+        case "manual":
+            return "default";
         case "default":
         case "auto":
         case "acceptEdits":
@@ -610,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/tasks.js

@@ -9,6 +9,7 @@ const TASK_TOOL_NAMES = new Set([
     "TaskOutput",
     "TaskStop",
 ]);
+const BACKGROUND_TASK_METADATA_KEY = "sdk_background_task";
 export function isTaskToolName(name) {
     return TASK_TOOL_NAMES.has(name);
 }
@@ -806,6 +807,8 @@ function lifecycleMetadata(msg) {
         "summary",
         "end_time",
         "total_paused_ms",
+        "blocked",
+        "parent_agent_id",
     ]) {
         copyValue(msg, key);
         copyValue(patch, key);
@@ -857,6 +860,43 @@ export function applyTaskLifecycleState(session, subtype, msg) {
         }),
     ]);
 }
+export function applyBackgroundTasksChanged(session, msg) {
+    const rawTasks = Array.isArray(msg.tasks) ? msg.tasks : [];
+    const nextTasks = rawTasks
+        .map((entry) => {
+        const task = asRecordOrNull(entry);
+        const taskId = nonEmptyString(task?.task_id);
+        if (!task || !taskId) {
+            return undefined;
+        }
+        const taskType = nonEmptyString(task.task_type);
+        const description = nonEmptyString(task.description);
+        return {
+            task_id: taskId,
+            subject: description ?? taskType ?? taskId,
+            description,
+            status: "in_progress",
+            blocks: [],
+            blocked_by: [],
+            metadata: {
+                [BACKGROUND_TASK_METADATA_KEY]: true,
+                ...(taskType ? { task_type: taskType } : {}),
+            },
+        };
+    })
+        .filter((task) => Boolean(task));
+    const nextIds = new Set(nextTasks.map((task) => task.task_id));
+    const removedTaskIds = session.taskOrder.filter((taskId) => {
+        if (nextIds.has(taskId)) {
+            return false;
+        }
+        const metadata = asRecordOrNull(session.tasksById.get(taskId)?.metadata);
+        return metadata?.[BACKGROUND_TASK_METADATA_KEY] === true;
+    });
+    const tasks = nextTasks.map((task) => upsertTask(session, task));
+    const removed = removeTasks(session, removedTaskIds);
+    emitTaskStateUpdate(session, "background_tasks", tasks, removed, true);
+}
 export function currentTaskSnapshot(session) {
     return orderedTasks(session);
 }

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);
@@ -423,6 +457,12 @@ function buildTaskMetadata(patch) {
     if (typeof patch.status === "string" && ["completed", "failed", "killed"].includes(patch.status)) {
         taskMetadata.terminal_status = patch.status;
     }
+    if (typeof patch.blocked === "boolean") {
+        taskMetadata.blocked = patch.blocked;
+    }
+    if (typeof patch.parent_agent_id === "string" && patch.parent_agent_id.length > 0) {
+        taskMetadata.parent_agent_id = patch.parent_agent_id;
+    }
     return Object.keys(taskMetadata).length > 0 ? taskMetadata : undefined;
 }
 export function taskUpdatedFields(msg) {

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

@@ -261,7 +261,6 @@ export function toolTitle(name, input, context = {}) {
         return label ? `${ARTIFACT_TOOL_NAME}: ${label}` : ARTIFACT_TOOL_NAME;
     }
     if (name === SHOW_ONBOARDING_ROLE_PICKER_TOOL_NAME) {
-        // TODO: The TUI accepts this SDK tool call but does not implement an onboarding role flow yet.
         return SHOW_ONBOARDING_ROLE_PICKER_TOOL_NAME;
     }
     if (name === "EnterWorktree") {
@@ -483,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;
             }
@@ -494,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;
@@ -737,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}.`;
     }
@@ -813,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;
@@ -858,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");
@@ -879,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")}`);
     }
@@ -938,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.198";
+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.13.4",
+  "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.198"
+    "@anthropic-ai/claude-agent-sdk": "0.3.214"
   },
   "optionalDependencies": {
-    "@srothgan/claude-code-rust-darwin-arm64": "0.13.4",
-    "@srothgan/claude-code-rust-darwin-x64": "0.13.4",
-    "@srothgan/claude-code-rust-linux-x64-gnu": "0.13.4",
-    "@srothgan/claude-code-rust-linux-arm64-gnu": "0.13.4",
-    "@srothgan/claude-code-rust-win32-x64-msvc": "0.13.4",
-    "@srothgan/claude-code-rust-win32-arm64-msvc": "0.13.4"
+    "@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"