lark-remote 0.1.13 → 0.2.1

package/dist/card/run-state.js

@@ -33,6 +33,10 @@ export function reduceRunState(state, event) {
         return reducePlanEvent(state, event);
     if (event.type === 'file_change')
         return reduceFileChangeEvent(state, event);
+    if (event.type === 'notice')
+        return reduceNoticeEvent(state, event);
+    if (event.type === 'session_info')
+        return reduceSessionInfoEvent(state, event);
     if (event.type === 'turn_started')
         return reduceTurnStartedEvent(state, event);
     if (event.type === 'turn_diff')
@@ -97,96 +101,116 @@ function reduceTurnDiffEvent(state, event) {
     const complete = event.complete === true;
     if (event.text !== undefined) {
         const blocks = markThinkingInactive(next.blocks);
+        const capped = upsertSnapshotBlock(blocks, (b) => b.kind === 'text' && b.itemId === event.itemId, () => ({
+            kind: 'text',
+            itemId: event.itemId,
+            content: keepTailMarked(event.text, MAX_TEXT_CHARS),
+            timestamp: ts,
+            ...(complete ? { completedAt: ts } : {}),
+        }), (existing) => {
+            const textBlock = existing;
+            return {
+                ...textBlock,
+                content: keepTailMarked(event.text, MAX_TEXT_CHARS),
+                // kimi：块锚点时间改为本次 diff 时间（整轮累积流不断续写，
+                // 标题应反映“最后写入时刻”而非首见时刻；move-to-end 后位置
+                // 与标题才一致）。codex app-server 不置 refreshTimestamp，
+                // 保持“首见时间戳不刷新”的既有契约。
+                ...(event.refreshTimestamp ? { timestamp: ts } : {}),
+                ...(complete ? { completedAt: ts } : {}),
+            };
+        }, !complete);
         next = {
             ...next,
-            blocks: keepLatestBlocks(upsertSnapshotBlock(blocks, (b) => b.kind === 'text' && b.itemId === event.itemId, () => ({
-                kind: 'text',
-                itemId: event.itemId,
-                content: keepTail(event.text, MAX_TEXT_CHARS),
-                timestamp: ts,
-                ...(complete ? { completedAt: ts } : {}),
-            }), (existing) => {
-                const textBlock = existing;
-                return {
-                    ...textBlock,
-                    content: keepTail(event.text, MAX_TEXT_CHARS),
-                    ...(complete ? { completedAt: ts } : {}),
-                };
-            }, !complete)),
+            blocks: keepLatestBlocks(capped),
+            omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, capped.length - MAX_BLOCKS),
             footer: 'streaming',
         };
     }
     if (event.reasoning !== undefined) {
-        next = {
-            ...next,
-            blocks: keepLatestBlocks(upsertSnapshotBlock(next.blocks, (b) => b.kind === 'thinking' && b.itemId === event.itemId, () => ({
-                kind: 'thinking',
-                itemId: event.itemId,
-                content: keepTail(event.reasoning, MAX_REASONING_CHARS),
+        const capped = upsertSnapshotBlock(next.blocks, (b) => b.kind === 'thinking' && b.itemId === event.itemId, () => ({
+            kind: 'thinking',
+            itemId: event.itemId,
+            content: keepTailMarked(event.reasoning, MAX_REASONING_CHARS),
+            active: !complete,
+            timestamp: ts,
+            ...(complete ? { completedAt: ts } : {}),
+        }), (existing) => {
+            const thinkingBlock = existing;
+            return {
+                ...thinkingBlock,
+                content: keepTailMarked(event.reasoning, MAX_REASONING_CHARS),
                 active: !complete,
-                timestamp: ts,
+                ...(event.refreshTimestamp ? { timestamp: ts } : {}),
                 ...(complete ? { completedAt: ts } : {}),
-            }), (existing) => {
-                const thinkingBlock = existing;
-                return {
-                    ...thinkingBlock,
-                    content: keepTail(event.reasoning, MAX_REASONING_CHARS),
-                    active: !complete,
-                    ...(complete ? { completedAt: ts } : {}),
-                };
-            }, !complete)),
+            };
+        }, !complete);
+        next = {
+            ...next,
+            blocks: keepLatestBlocks(capped),
+            omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, capped.length - MAX_BLOCKS),
             footer: 'thinking',
         };
     }
     if (event.toolOutput !== undefined) {
-        next = {
-            ...next,
-            blocks: keepLatestBlocks(upsertSnapshotBlock(next.blocks, (b) => b.kind === 'tool' && b.tool.id === event.itemId, () => ({
+        const capped = upsertSnapshotBlock(next.blocks, (b) => b.kind === 'tool' && b.tool.id === event.itemId, () => {
+            // 身份只在首见时写入（existing 分支不动）：toolName/toolInput/toolHint。
+            const inputStr = truncateDetail(stringifyUnknown(event.toolInput ?? {}));
+            return {
                 kind: 'tool',
                 tool: {
                     id: event.itemId,
-                    name: 'command',
-                    input: '',
+                    name: event.toolName ?? 'command',
+                    input: inputStr,
+                    parsedInput: tryParseRecord(inputStr),
+                    ...(event.toolHint !== undefined ? { toolHint: event.toolHint } : {}),
                     output: keepTail(event.toolOutput, MAX_TOOL_DETAIL_CHARS),
                     status: complete ? (event.toolStatus ?? 'ok') : 'running',
                     startedAt: ts,
                     ...(complete ? { completedAt: ts } : {}),
                 },
-            }), (existing) => ({
-                kind: 'tool',
-                tool: {
-                    ...existing.tool,
-                    output: keepTail(event.toolOutput, MAX_TOOL_DETAIL_CHARS),
-                    status: complete
-                        ? (event.toolStatus ?? 'ok')
-                        : existing.tool.status,
-                    ...(complete ? { completedAt: ts } : {}),
-                },
-            }), !complete)),
+            };
+        }, (existing) => ({
+            kind: 'tool',
+            tool: {
+                ...existing.tool,
+                output: keepTail(event.toolOutput, MAX_TOOL_DETAIL_CHARS),
+                status: complete
+                    ? (event.toolStatus ?? 'ok')
+                    : existing.tool.status,
+                ...(complete ? { completedAt: ts } : {}),
+            },
+        }), !complete);
+        next = {
+            ...next,
+            blocks: keepLatestBlocks(capped),
+            omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, capped.length - MAX_BLOCKS),
             footer: 'tool_running',
         };
     }
     if (event.plan !== undefined) {
-        const newPlan = keepTail(event.plan, MAX_REASONING_CHARS * 2);
-        next = {
-            ...next,
-            plan: newPlan,
-            blocks: keepLatestBlocks(upsertSnapshotBlock(next.blocks, (b) => b.kind === 'plan' && b.itemId === event.itemId, () => ({
-                kind: 'plan',
-                itemId: event.itemId,
+        const newPlan = keepTailMarked(event.plan, MAX_REASONING_CHARS * 2);
+        const capped = upsertSnapshotBlock(next.blocks, (b) => b.kind === 'plan' && b.itemId === event.itemId, () => ({
+            kind: 'plan',
+            itemId: event.itemId,
+            content: newPlan,
+            active: !complete,
+            timestamp: ts,
+            ...(complete ? { completedAt: ts } : {}),
+        }), (existing) => {
+            const planBlock = existing;
+            return {
+                ...planBlock,
                 content: newPlan,
                 active: !complete,
-                timestamp: ts,
                 ...(complete ? { completedAt: ts } : {}),
-            }), (existing) => {
-                const planBlock = existing;
-                return {
-                    ...planBlock,
-                    content: newPlan,
-                    active: !complete,
-                    ...(complete ? { completedAt: ts } : {}),
-                };
-            }, !complete)),
+            };
+        }, !complete);
+        next = {
+            ...next,
+            plan: newPlan,
+            blocks: keepLatestBlocks(capped),
+            omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, capped.length - MAX_BLOCKS),
         };
     }
     if (event.fileChanges !== undefined) {
@@ -204,7 +228,12 @@ function reduceTurnDiffEvent(state, event) {
             // 同一 item 的同一路径原地替换（权威 diff 校正），新路径/新 item 追加。
             blocks = upsertSnapshotBlock(blocks, (b) => b.kind === 'file_change' && b.itemId === event.itemId && b.path === fc.path, () => fileBlock, () => fileBlock, !complete);
         }
-        next = { ...next, blocks: keepLatestBlocks(blocks) };
+        const capped = blocks;
+        next = {
+            ...next,
+            blocks: keepLatestBlocks(capped),
+            omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, capped.length - MAX_BLOCKS),
+        };
     }
     return next;
 }
@@ -237,7 +266,7 @@ function reduceSystemEvent(state, event) {
     if (event.type !== 'system')
         return state;
     if (event.subtype === 'init') {
-        return { ...state, sessionId: event.session_id, footer: 'thinking' };
+        return { ...state, sessionId: event.session_id, model: event.model, footer: 'thinking' };
     }
     if (event.subtype === 'compact_boundary' && event.compactMetadata) {
         return {
@@ -285,6 +314,10 @@ function reduceResultEvent(state, event) {
         blocks: markThinkingInactive(state.blocks),
         resultSubtype: mergedSubtype,
         errorMsg: mergedErrorMsg,
+        // costUsd：首个非 undefined 胜出（与 errorMsg 合并语义一致）
+        ...(event.total_cost_usd !== undefined && state.costUsd === undefined
+            ? { costUsd: event.total_cost_usd }
+            : {}),
     };
 }
 /** Handle assistant thinking/text/tool_use content blocks. */
@@ -300,7 +333,7 @@ function reduceAssistantEvent(state, event) {
                     ...next.blocks.slice(0, -1),
                     {
                         kind: 'thinking',
-                        content: keepTail(last.content + '\n' + content.thinking, MAX_REASONING_CHARS),
+                        content: keepTailMarked(last.content + '\n' + content.thinking, MAX_REASONING_CHARS),
                         active: true,
                         timestamp: last.timestamp ?? event.timestamp,
                     },
@@ -309,7 +342,7 @@ function reduceAssistantEvent(state, event) {
                     ...next.blocks,
                     {
                         kind: 'thinking',
-                        content: keepTail(content.thinking, MAX_REASONING_CHARS),
+                        content: keepTailMarked(content.thinking, MAX_REASONING_CHARS),
                         active: true,
                         timestamp: event.timestamp,
                     },
@@ -317,6 +350,7 @@ function reduceAssistantEvent(state, event) {
             next = {
                 ...next,
                 blocks: keepLatestBlocks(newBlocks),
+                omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, newBlocks.length - MAX_BLOCKS),
                 footer: 'thinking',
             };
         }
@@ -328,7 +362,7 @@ function reduceAssistantEvent(state, event) {
                     ...blocks.slice(0, -1),
                     {
                         kind: 'text',
-                        content: keepTail(last.content + content.text, MAX_TEXT_CHARS),
+                        content: keepTailMarked(last.content + content.text, MAX_TEXT_CHARS),
                         timestamp: last.timestamp ?? event.timestamp,
                     },
                 ]
@@ -336,13 +370,14 @@ function reduceAssistantEvent(state, event) {
                     ...blocks,
                     {
                         kind: 'text',
-                        content: keepTail(content.text, MAX_TEXT_CHARS),
+                        content: keepTailMarked(content.text, MAX_TEXT_CHARS),
                         timestamp: event.timestamp,
                     },
                 ];
             next = {
                 ...next,
                 blocks: keepLatestBlocks(newBlocks),
+                omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, newBlocks.length - MAX_BLOCKS),
                 footer: 'streaming',
             };
         }
@@ -353,22 +388,25 @@ function reduceAssistantEvent(state, event) {
             // string as the old per-render parse, so truncation-broken JSON still
             // yields null (over-cap input renders no summary — behavior preserved).
             const inputStr = truncateDetail(stringifyUnknown(content.input));
+            const capped = [
+                ...markThinkingInactive(next.blocks),
+                {
+                    kind: 'tool',
+                    tool: {
+                        id: content.id,
+                        name: content.name,
+                        input: inputStr,
+                        parsedInput: tryParseRecord(inputStr),
+                        ...(content.summary !== undefined ? { summary: content.summary } : {}),
+                        status: 'running',
+                        startedAt: event.timestamp,
+                    },
+                },
+            ];
             next = {
                 ...next,
-                blocks: keepLatestBlocks([
-                    ...markThinkingInactive(next.blocks),
-                    {
-                        kind: 'tool',
-                        tool: {
-                            id: content.id,
-                            name: content.name,
-                            input: inputStr,
-                            parsedInput: tryParseRecord(inputStr),
-                            status: 'running',
-                            startedAt: event.timestamp,
-                        },
-                    },
-                ]),
+                blocks: keepLatestBlocks(capped),
+                omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, capped.length - MAX_BLOCKS),
                 footer: 'tool_running',
             };
         }
@@ -409,12 +447,39 @@ function reduceToolResultEvent(state, event) {
     }
     return next;
 }
+/** Handle notice event — append a runtime notice (warning / reroute / compaction). */
+function reduceNoticeEvent(state, event) {
+    if (event.type !== 'notice')
+        return state;
+    return {
+        ...state,
+        notices: [
+            ...(state.notices ?? []),
+            {
+                level: event.level,
+                ...(event.code !== undefined ? { code: event.code } : {}),
+                text: event.text,
+                ...(event.timestamp !== undefined ? { timestamp: event.timestamp } : {}),
+            },
+        ],
+    };
+}
+/** Handle session_info event — update sessionTitle / mode only when present. */
+function reduceSessionInfoEvent(state, event) {
+    if (event.type !== 'session_info')
+        return state;
+    return {
+        ...state,
+        ...(event.title !== undefined ? { sessionTitle: event.title } : {}),
+        ...(event.mode !== undefined ? { mode: event.mode } : {}),
+    };
+}
 /** Handle plan event — accumulate plan text for Codex-style agents. */
 function reducePlanEvent(state, event) {
     if (event.type !== 'plan')
         return state;
     const currentPlan = state.plan ?? '';
-    const newPlan = keepTail(currentPlan + '\n' + event.plan, MAX_REASONING_CHARS * 2);
+    const newPlan = keepTailMarked(currentPlan + '\n' + event.plan, MAX_REASONING_CHARS * 2);
     // Plan is a single evolving document — replace the existing plan block
     // instead of appending a new one (avoids N overlapping blocks after N events).
     const withoutOldPlan = state.blocks.filter((b) => b.kind !== 'plan');
@@ -426,6 +491,7 @@ function reducePlanEvent(state, event) {
         ...state,
         plan: newPlan,
         blocks: keepLatestBlocks(newBlocks),
+        omittedBlocks: (state.omittedBlocks ?? 0) + Math.max(0, newBlocks.length - MAX_BLOCKS),
     };
 }
 /** Handle file_change event — emit a file_change block for rendering (Codex-style agents). */
@@ -446,6 +512,7 @@ function reduceFileChangeEvent(state, event) {
     return {
         ...state,
         blocks: keepLatestBlocks(newBlocks),
+        omittedBlocks: (state.omittedBlocks ?? 0) + Math.max(0, newBlocks.length - MAX_BLOCKS),
     };
 }
 export function finishRun(state, terminal, meta = {}) {
@@ -522,6 +589,27 @@ function tryParseRecord(input) {
 function keepLatestBlocks(blocks) {
     return blocks.length <= MAX_BLOCKS ? blocks : blocks.slice(-MAX_BLOCKS);
 }
+/**
+ * keepTail + 截断标记：被去头的存储内容以前缀如实标注（信息保真红线：禁止静默丢弃）。
+ * 标记计入 maxChars 预算（存储总量仍 ≤ maxChars，保持既有长度不变量）。
+ */
+function keepTailMarked(value, maxChars) {
+    if (value.length <= maxChars)
+        return value;
+    // marker 计入 maxChars 预算（总量不变量）。省略数 = value.length - kept.length，
+    // 而 kept 长度取决于 marker 长度、marker 长度又取决于省略数的位数——
+    // 不动点迭代（marker 固定部分 12 字符，位数至多几次即收敛）。
+    let dropped = value.length - maxChars + 12;
+    for (;;) {
+        const next = value.length - maxChars + 12 + String(dropped).length;
+        if (next === dropped)
+            break;
+        dropped = next;
+    }
+    const marker = `…（前 ${dropped} 字符已省略）\n`;
+    const kept = keepTail(value, Math.max(0, maxChars - marker.length));
+    return marker + kept;
+}
 function truncateDetail(value) {
     return value.length <= MAX_TOOL_DETAIL_CHARS
         ? value

package/dist/card/text-truncate.d.ts

@@ -22,15 +22,6 @@ export declare const FEISHU_MAX_TABLES = 5;
  * 共用，避免三处各自定义后数值漂移。
  */
 export declare const CARD_BUDGET_BYTES = 28000;
-/**
- * Max byte budget for a single session `tool_result` event's content when
- * replaying an opencode session (L2 pre-fold). The static card budget enforcer
- * (`enforceCardBudget`, maxPanelContentBytes = 2000) would truncate it again at
- * render time anyway; pre-folding here bounds the in-memory `events[]` array
- * and the intermediate card JSON so a single pathological tool_result (e.g. a
- * 500KB file listing) never inflates the replay payload to megabytes.
- */
-export declare const TOOL_RESULT_MAX_BYTES = 4000;
 /**
  * Count the number of markdown tables in a string.
  *

package/dist/card/text-truncate.js

@@ -22,15 +22,6 @@ export const FEISHU_MAX_TABLES = 5;
  * 共用，避免三处各自定义后数值漂移。
  */
 export const CARD_BUDGET_BYTES = 28_000;
-/**
- * Max byte budget for a single session `tool_result` event's content when
- * replaying an opencode session (L2 pre-fold). The static card budget enforcer
- * (`enforceCardBudget`, maxPanelContentBytes = 2000) would truncate it again at
- * render time anyway; pre-folding here bounds the in-memory `events[]` array
- * and the intermediate card JSON so a single pathological tool_result (e.g. a
- * 500KB file listing) never inflates the replay payload to megabytes.
- */
-export const TOOL_RESULT_MAX_BYTES = 4000;
 /**
  * Count the number of markdown tables in a string.
  *

package/dist/card/tool-render.d.ts

@@ -20,6 +20,9 @@ export declare function toolHeaderText(tool: ToolEntry): string;
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
  * (Bash → command, Read/Edit/Write → file_path, etc.) and output in a code
- * block. Falls back to a raw JSON dump for unknown tools.
+ * block. An explicit `toolHint` (declared by the runner, 信息保真 C5) selects
+ * the same rendering by family instead of name. There is no raw-JSON fallback
+ * for unknown tools: `default` returns '' and unknown tools only surface their
+ * args through the panel header's `summarizeInput` fallback.
  */
 export declare function toolBodyMd(tool: ToolEntry): string;

package/dist/card/tool-render.js

@@ -9,6 +9,7 @@
  * under formatting noise. `toolHeaderText` produces a compact one-liner header
  * like `✅ **Bash** — pwd` so collapsed panels stay informative.
  */
+import { truncate } from '../common/truncate.js';
 const HEADER_SUMMARY_MAX = 80;
 const BODY_FIELD_MAX = 600;
 const OUTPUT_MAX = 1200;
@@ -31,12 +32,25 @@ export function toolHeaderText(tool) {
     // P3-6: use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
     const summary = summarizeInput(tool.name, input);
-    return summary ? `${icon} **${tool.name}** — ${summary}` : `${icon} **${tool.name}**`;
+    // 信息保真 C3.1：ACP kind 映射后 name 与原始 title 不同时，title 以
+    // ` — {summary}` 追加在标题末尾（截断沿用 HEADER_SUMMARY_MAX）。
+    // 用 truncate（suffix 为空）而非裸 slice：裸 slice 按 UTF-16 码元切，
+    // 切点落在 emoji 代理对中间会留下孤立代理项（P2-31 同族）。
+    const blockSummary = tool.summary
+        ? truncate(tool.summary.replace(/\s+/g, ' ').trim(), HEADER_SUMMARY_MAX, { suffix: '' })
+        : '';
+    const parts = [summary, blockSummary].filter(Boolean);
+    return parts.length > 0
+        ? `${icon} **${tool.name}** — ${parts.join(' — ')}`
+        : `${icon} **${tool.name}**`;
 }
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
  * (Bash → command, Read/Edit/Write → file_path, etc.) and output in a code
- * block. Falls back to a raw JSON dump for unknown tools.
+ * block. An explicit `toolHint` (declared by the runner, 信息保真 C5) selects
+ * the same rendering by family instead of name. There is no raw-JSON fallback
+ * for unknown tools: `default` returns '' and unknown tools only surface their
+ * args through the panel header's `summarizeInput` fallback.
  */
 export function toolBodyMd(tool) {
     const parts = [];
@@ -58,7 +72,8 @@ export function toolBodyMd(tool) {
     const body = parts.join('\n\n');
     if (body.length <= BODY_TOTAL_MAX)
         return body;
-    return `${body.slice(0, BODY_TOTAL_MAX)}…\n\n_（body 已截断，完整内容查日志）_`;
+    // 同上：走 truncate 保证切点不落在代理对中间（末尾 '…' 由 truncate 附加以对齐预算）。
+    return `${truncate(body, BODY_TOTAL_MAX)}\n\n_（body 已截断，完整内容查日志）_`;
 }
 function summarizeInput(name, input) {
     const rec = asRecord(input);
@@ -105,6 +120,37 @@ function summarizeInput(name, input) {
             return pick('command') || pick('file_path') || pick('path') || pick('query');
     }
 }
+// --- Named render bodies (shared by tool-name cases and toolHint branches) ---
+function renderBashInput(str) {
+    const cmd = str('command');
+    return cmd ? `**Command**\n\`\`\`bash\n${truncate(cmd, BODY_FIELD_MAX)}\n\`\`\`` : '';
+}
+function renderFileInput(str) {
+    const fp = str('file_path') || str('path');
+    return fp ? `**File** \`${fp}\`` : '';
+}
+function renderGrepInput(str) {
+    const lines = [];
+    if (str('pattern'))
+        lines.push(`**Pattern** \`${str('pattern')}\``);
+    if (str('path'))
+        lines.push(`**Path** \`${str('path')}\``);
+    return lines.join('\n');
+}
+function renderGlobInput(str) {
+    const p = str('pattern');
+    return p ? `**Pattern** \`${truncate(p, BODY_FIELD_MAX)}\`` : '';
+}
+function renderLsInput(str) {
+    const p = str('path');
+    return p ? `**Path** \`${p}\`` : '';
+}
+function renderWebFetchInput(str) {
+    return str('url') ? `**URL** ${str('url')}` : '';
+}
+function renderWebSearchInput(str) {
+    return str('query') ? `**Query** \`${truncate(str('query'), BODY_FIELD_MAX)}\`` : '';
+}
 function renderInput(tool) {
     // P3-6: use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
@@ -112,44 +158,45 @@ function renderInput(tool) {
     if (!rec)
         return '';
     const str = (k) => (typeof rec[k] === 'string' ? rec[k] : '');
+    // 信息保真 C5：hint 优先（runner 自愿声明，只消费不推断）；缺失时与现状
+    // 完全一致。hint 分支与 name case 共用同一渲染函数，无复制粘贴。
+    switch (tool.toolHint) {
+        case 'shell':
+            return renderBashInput(str);
+        case 'file':
+        case 'patch':
+            return renderFileInput(str);
+        case 'search':
+            return renderGrepInput(str);
+        case 'web':
+            return renderWebFetchInput(str) || renderWebSearchInput(str);
+        default:
+            break;
+    }
     switch (tool.name) {
         case 'Bash':
-        case 'bash': {
-            const cmd = str('command');
-            return cmd ? `**Command**\n\`\`\`bash\n${truncate(cmd, BODY_FIELD_MAX)}\n\`\`\`` : '';
-        }
+        case 'bash':
+            return renderBashInput(str);
         case 'Read':
         case 'Edit':
         case 'Write':
         case 'NotebookEdit':
         case 'read':
         case 'edit':
-        case 'write': {
-            const fp = str('file_path') || str('path');
-            return fp ? `**File** \`${fp}\`` : '';
-        }
+        case 'write':
+            return renderFileInput(str);
         case 'Grep':
-        case 'grep': {
-            const lines = [];
-            if (str('pattern'))
-                lines.push(`**Pattern** \`${str('pattern')}\``);
-            if (str('path'))
-                lines.push(`**Path** \`${str('path')}\``);
-            return lines.join('\n');
-        }
+        case 'grep':
+            return renderGrepInput(str);
         case 'Glob':
-        case 'find': {
-            const p = str('pattern');
-            return p ? `**Pattern** \`${truncate(p, BODY_FIELD_MAX)}\`` : '';
-        }
-        case 'ls': {
-            const p = str('path');
-            return p ? `**Path** \`${p}\`` : '';
-        }
+        case 'find':
+            return renderGlobInput(str);
+        case 'ls':
+            return renderLsInput(str);
         case 'WebFetch':
-            return str('url') ? `**URL** ${str('url')}` : '';
+            return renderWebFetchInput(str);
         case 'WebSearch':
-            return str('query') ? `**Query** \`${truncate(str('query'), BODY_FIELD_MAX)}\`` : '';
+            return renderWebSearchInput(str);
         default:
             return '';
     }
@@ -170,7 +217,4 @@ function asRecord(input) {
     }
     return null;
 }
-function truncate(s, max) {
-    return s.length > max ? `${s.slice(0, max)}…` : s;
-}
 //# sourceMappingURL=tool-render.js.map

package/dist/cli.js

@@ -14,7 +14,7 @@ export function decideRuntime(isBun, probe) {
 /** Check whether `bun` is present and runs `--version` successfully. */
 function probeBun() {
     try {
-        const res = spawnSync('bun', ['--version'], { stdio: 'ignore' });
+        const res = spawnSync('bun', ['--version'], { stdio: 'ignore', windowsHide: true });
         return { error: res.error !== undefined, status: res.status };
     }
     catch {
@@ -75,7 +75,7 @@ function main() {
         isBun: process.isBun ?? false,
         probe: probeBun(),
         importEntry: () => import(entryUrl.href),
-        spawnBun: (e, a) => spawn('bun', [e, ...a], { stdio: 'inherit' }),
+        spawnBun: (e, a) => spawn('bun', [e, ...a], { stdio: 'inherit', windowsHide: true }),
         onSignal: (sig, handler) => process.on(sig, handler),
         offSignal: (sig, handler) => process.off(sig, handler),
         killSelf: (sig) => process.kill(process.pid, sig),

package/dist/common/fs.d.ts

@@ -6,3 +6,17 @@
  * an error worth propagating.
  */
 export declare function silentlyUnlink(path: string): void;
+export declare function isBusyError(err: unknown): boolean;
+export interface BusyRetryOptions {
+    /** 平台注入（测试用）；默认当前宿主。占用重试仅 win32 生效 */
+    platform?: NodeJS.Platform;
+    /** 重试耗尽（或 posix 首次占用即失败）时回调，用于告警/保留现场 */
+    onGiveUp?: (err: unknown) => void;
+}
+/**
+ * 对 sync 文件操作套占用退避重试：win32 上遇 EPERM/EBUSY 按退避序列重试，
+ * 其他错误或重试耗尽后抛最后一个错误；posix 上占用错误不重试、立即失败。
+ * `onGiveUp` 仅在「占用导致的放弃」时回调（告警/保留现场）；非占用错误
+ * （如 EXDEV）不走回调、直接透传，避免误触发调用方的占用善后逻辑。
+ */
+export declare function withBusyRetry<T>(op: () => T, opts?: BusyRetryOptions): T;