lark-remote 0.1.13 → 0.2.0

package/dist/card/run-state.d.ts

@@ -1,4 +1,4 @@
-import type { AgentEvent, ApprovalView } from '../runner/index.js';
+import type { AgentEvent, ApprovalView, ToolHint } from '../runner/index.js';
 export type RunTerminal = 'running' | 'finalizing' | 'done' | 'error' | 'interrupted' | 'idle_timeout';
 export type RunFooter = 'thinking' | 'tool_running' | 'streaming' | null;
 /** 中断来源（interrupted 终态的原因），供卡片如实归因。 */
@@ -22,6 +22,10 @@ export interface ToolEntry {
     status: ToolStatus;
     startedAt?: string;
     completedAt?: string;
+    /** 工具渲染 hint（turn_diff 首见时携带；渲染层只消费不推断）。 */
+    toolHint?: ToolHint;
+    /** 工具原始 title（ACP kind 映射后与 name 不同时存在；渲染做副标题）。 */
+    summary?: string;
 }
 export type RunBlock = {
     kind: 'thinking';
@@ -56,6 +60,14 @@ export type RunBlock = {
     timestamp?: string;
     completedAt?: string;
 };
+/** 运行期通知（warning / 重路由 / 压缩提示）。保留到达时间，渲染层可将其
+ *  按时间线插入内容流当普通消息；无时间戳时兜底置于内容流末尾。 */
+export interface RunNotice {
+    level: 'info' | 'warn' | 'error';
+    code?: string;
+    text: string;
+    timestamp?: string;
+}
 export interface RunState {
     runId: string;
     terminal: RunTerminal;
@@ -90,6 +102,20 @@ export interface RunState {
     /** 会话累计 cache creation token（所有 run 之和）。 */
     cumulativeCacheCreationTokens?: number;
     plan?: string;
+    /** 实际生效模型（system.init 携带；失败兜底 synthetic init 为 ''，渲染须容忍）。 */
+    model?: string;
+    /** 本次 run 花费（USD，result 事件 total_cost_usd）。 */
+    costUsd?: number;
+    /** 运行期通知（warning / 重路由 / 压缩提示），按到达顺序。 */
+    notices?: RunNotice[];
+    /** 被 MAX_BLOCKS 静默丢弃的早期块计数（>0 时渲染「已省略 N 个早期步骤」）。 */
+    omittedBlocks?: number;
+    /** 会话标题（ACP session_info_update.title）。 */
+    sessionTitle?: string;
+    /** 当前模式（ACP current_mode_update.currentModeId）。 */
+    mode?: string;
+    /** 推理 token（pi usage.reasoning 累加，经 finish meta 写入）。 */
+    reasoningTokens?: number;
     /** Codex 操作类型：'turn' 表示普通 run，'compaction' 表示 compact 运行。 */
     operationKind?: 'turn' | 'compaction';
     /** 压缩前上下文水位（codex compact 卡展示「压缩前 X → 压缩后 Y」）。 */
@@ -135,6 +161,8 @@ export interface FinishMeta {
     cumulativeOutputTokens?: number;
     cumulativeCacheReadTokens?: number;
     cumulativeCacheCreationTokens?: number;
+    /** 推理 token（pi usage.reasoning 累加，经 usageMeta 透传）。 */
+    reasoningTokens?: number;
 }
 export declare function createInitialRunState(runId: string): RunState;
 export declare function reduceRunState(state: RunState, event: AgentEvent): RunState;

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