pi-ui-extension 1.1.10 → 1.1.11

package/README.md

@@ -100,7 +100,22 @@ For tool definitions, the extension prefers the observable provider-request tool
 
 Modes can be changed directly with mouse clicks.
 
-When Fabric takes ownership of tool rendering, the panel remains visible for usage statistics but the local mode selector is hidden and replaced with `View controlled by Fabric`. This avoids conflicting display control.
+Tool View uses Pi's official `pi.registerToolRenderer()` hook for the built-in tools (`read`, `bash`, `edit`, `write`, `grep`, `find`, and `ls`) **and the built-in `codemode` tool**. It never replaces tool definitions or execution functions. Other tools retain their own renderers.
+
+For **Codemode** specifically:
+
+- **Normal** retains Pi's native script, nested-call, and output rendering (including its own expand/collapse behavior).
+- **Compact** uses a two-line, status-colored summary with Chinese labels: a highlighted Codemode title and script line count, followed by grouped execution status, nested-call counts, output size, and duration. It omits script source, nested-call arguments, and actual output, even if the row is expanded or execution fails. On narrow terminals it keeps each part to one row and prioritizes status and failures over less important metrics.
+- **Hidden** removes the Codemode transcript row, including expanded and failed results, without stopping execution or removing Tool/MCP usage accounting.
+
+Example Compact output:
+
+```text
+▸ codemode  8 行代码
+✓ 已完成  │  1 次调用 · 1 成功  │  59 行输出 · 85ms
+```
+
+Changing the Tool View mode also updates previously rendered tool rows in the current session. Other third-party tools are unaffected.
 
 ### 6. Tool / MCP usage statistics
 
@@ -165,7 +180,7 @@ Example configuration:
 To pin a specific version:
 
 ```bash
-pi install npm:pi-ui-extension@1.1.10
+pi install npm:pi-ui-extension@1.1.11
 ```
 
 or:
@@ -173,7 +188,7 @@ or:
 ```json
 {
   "packages": [
-    "npm:pi-ui-extension@1.1.10"
+    "npm:pi-ui-extension@1.1.11"
   ]
 }
 ```
@@ -201,7 +216,7 @@ Configuration form:
 Pin to a Git tag:
 
 ```bash
-pi install git:github.com/1993yihuan/pi-ui-extension@v1.1.10
+pi install git:github.com/1993yihuan/pi-ui-extension@v1.1.11
 ```
 
 ### Temporary local-source testing
@@ -300,7 +315,7 @@ npm run typecheck
 npm test
 ```
 
-The test suite covers the main behavior of Sidebar, CTX, Session management, Tool View, MCP resources, Fabric detection, mouse scrolling, and resize handling.
+The test suite covers Sidebar, CTX, Session management, official Tool View renderers, MCP resources, mouse scrolling, and resize handling.
 
 During development, Pi can load the local source directory directly:
 
@@ -325,7 +340,6 @@ pi-ui-extension/
 │   ├── session/             # Session list and actions
 │   ├── sidebar/             # Sidebar layout, scrolling, resize
 │   ├── tool-view/           # Tool View modes and usage statistics
-│   ├── fabric-detection.ts  # Fabric ownership detection
 │   └── index.ts             # Pi Extension entry point
 ├── .github/workflows/
 │   ├── ci.yml               # Automatic checks on push / PR
@@ -386,14 +400,14 @@ npm publishing uses GitHub Actions OIDC Trusted Publishing, so no long-lived `NP
 
 - Does not modify Pi Core.
 - `@earendil-works/pi-coding-agent` and `@earendil-works/pi-tui` are host-provided peer dependencies to avoid duplicate runtime instances.
-- Fabric ownership is detected explicitly to avoid conflicting Tool View controls.
+- Tool View changes only how built-in tool calls are rendered, using Pi's public renderer resolver rather than overriding their implementations.
 - Session and resource operations use Pi public APIs wherever possible.
 - Context composition is clearly presented as an estimate, not provider-exact token accounting.
 - Fullscreen sidebar behavior degrades safely when fullscreen layout is unavailable.
 
 ## Requirements
 
-- Pi Coding Agent
+- Pi Coding Agent with the official `registerToolRenderer()` API (tested with `@earendil-works/pi-coding-agent@1.1.0`)
 - Node.js `>= 22.19.0` (use a Node version supported by your Pi installation)
 - CI validates Node.js 22.19.0 and 24; releases use Node.js 24
 

package/README.zh-CN.md

@@ -100,7 +100,22 @@ Composition 会将当前可观测上下文拆分为：
 
 可以直接使用鼠标点击模式进行切换。
 
-当 Fabric 接管工具展示行为时，扩展会保留 Tool View 面板和调用统计，但不再显示本地模式选择器，并提示 `View controlled by Fabric`，避免与 Fabric 的展示逻辑互相抢占。
+Tool View 使用 Pi 官方的 `pi.registerToolRenderer()` 接口管理内置工具（`read`、`bash`、`edit`、`write`、`grep`、`find` 和 `ls`）**以及内置 `codemode` 工具**的展示，不再重注册工具定义或接管工具执行逻辑。其他 Tool 保留其自身的渲染方式。
+
+对于 **Codemode**：
+
+- **Normal**：保留 Pi 原生的脚本、子工具调用、输出详情，以及原生展开 / 收起行为。
+- **Compact**：采用带有状态颜色的双行摘要。第一行突出 Codemode 和代码行数；第二行将状态、子调用统计、输出规模与耗时分组展示，并统一使用中文单位。即使展开或执行失败，也不会展示完整代码、子调用参数或真实输出；终端宽度不足时优先保留状态、失败信息和调用次数，避免摘要自动换成多行。
+- **Hidden**：隐藏 Codemode 工具记录（包括展开和失败结果），但不影响实际执行或 Tool / MCP 调用统计。
+
+Compact 效果示例：
+
+```text
+▸ codemode  8 行代码
+✓ 已完成  │  1 次调用 · 1 成功  │  59 行输出 · 85ms
+```
+
+切换 Tool View 模式也会更新当前会话中已经展示的历史工具记录；其他第三方工具保持原有渲染方式。
 
 ### 6. Tool / MCP 调用统计
 
@@ -165,7 +180,7 @@ Pi 会安装 package，并将声明写入个人配置：
 如果希望固定版本：
 
 ```bash
-pi install npm:pi-ui-extension@1.1.10
+pi install npm:pi-ui-extension@1.1.11
 ```
 
 或者：
@@ -173,7 +188,7 @@ pi install npm:pi-ui-extension@1.1.10
 ```json
 {
   "packages": [
-    "npm:pi-ui-extension@1.1.10"
+    "npm:pi-ui-extension@1.1.11"
   ]
 }
 ```
@@ -201,7 +216,7 @@ pi install git:github.com/1993yihuan/pi-ui-extension
 固定到 Git tag：
 
 ```bash
-pi install git:github.com/1993yihuan/pi-ui-extension@v1.1.10
+pi install git:github.com/1993yihuan/pi-ui-extension@v1.1.11
 ```
 
 ### 临时加载本地源码
@@ -300,7 +315,7 @@ npm run typecheck
 npm test
 ```
 
-当前自动化测试覆盖 Sidebar、CTX、Session、Tool View、MCP resource、Fabric detection、鼠标滚轮 / resize 等主要行为。
+当前自动化测试覆盖 Sidebar、CTX、Session、官方 Tool Renderer、MCP resource、鼠标滚轮 / resize 等主要行为。
 
 开发时可以直接让 Pi 加载本地目录：
 
@@ -325,7 +340,6 @@ pi-ui-extension/
 │   ├── session/             # Session 列表与操作
 │   ├── sidebar/             # Sidebar 布局、滚动和 resize
 │   ├── tool-view/           # Tool View 模式与调用统计
-│   ├── fabric-detection.ts  # Fabric 工具接管检测
 │   └── index.ts             # Pi Extension 入口
 ├── .github/workflows/
 │   ├── ci.yml               # push / PR 自动检查
@@ -386,14 +400,14 @@ npm 发布使用 GitHub Actions OIDC Trusted Publishing，不需要在 GitHub Re
 
 - 不修改 Pi Core。
 - Pi host 提供的 `@earendil-works/pi-coding-agent` 和 `@earendil-works/pi-tui` 使用 `peerDependencies`，避免产生重复运行时实例。
-- 对 Fabric 做显式检测，避免 Tool View 模式控制发生冲突。
+- Tool View 只通过 Pi 官方 Renderer Resolver 控制内置工具的显示，不覆写工具定义或执行逻辑。
 - Session 与资源操作尽量通过 Pi 已公开 API 完成。
 - Context composition 明确标记为估算值，不冒充 provider 精确 token 统计。
 - fullscreen Sidebar 不可用时安全降级，不影响 Pi 主流程。
 
 ## Requirements
 
-- Pi Coding Agent
+- 支持官方 `registerToolRenderer()` API 的 Pi Coding Agent（已使用 `@earendil-works/pi-coding-agent@1.1.0` 验证）
 - Node.js `>= 22.19.0`（建议使用当前 Pi 支持的 Node 版本）
 - CI 覆盖 Node.js 22.19.0 和 24；发布工作流使用 Node.js 24
 

package/extensions/ctx/README.md

@@ -6,11 +6,11 @@
 
 - approx = 本地可观测文本 UTF-16 长度 / 4，逐消息向上取整；不是模型 tokenizer。已知消息先经公开 SDK `convertToLlm` 转换，再提取文本，因此包含摘要包装、bash 无输出/退出/取消/截断提示；仍按原始角色分类。未知角色安全降级为外层 content 文本，`excludeFromContext` 的 bash 不计入。
 - 六类为 System、Tools、Messages、Tool Results、Summary、Other。百分比分母是已覆盖分类的估算 token 合计，不是模型窗口；pi usage 单独展示，不校准分类。
-- System 使用 ctx.getSystemPrompt() 的可观测字符串；无法取得时 unknown。Tools 通过 pi.getActiveTools()/getAllTools() 仅选取当前启用的工具，逐工具序列化 `{name, description, parameters}`，按 UTF-16 长度 / 4 向上取整后合计，并纳入分类百分比分母。不计 sourceInfo、执行函数及已归入 System 的 promptGuidelines；Fabric 捕获但未直接启用的工具不重复计入。无启用工具为 0；API 不可用、启用工具缺少定义或 schema 无法序列化时保持 unknown，避免显示不完整合计。工具定义在每次现有快照事件刷新时重新读取（包括动态启用/禁用），不在 render 中读取；空闲时注册工具将在下一次快照事件反映。
+- System 使用 ctx.getSystemPrompt() 的可观测字符串；无法取得时 unknown。Tools 通过 pi.getActiveTools()/getAllTools() 仅选取当前启用的工具，逐工具序列化 `{name, description, parameters}`，按 UTF-16 长度 / 4 向上取整后合计，并纳入分类百分比分母。不计 sourceInfo、执行函数及已归入 System 的 promptGuidelines；未直接启用的工具不重复计入。无启用工具为 0；API 不可用、启用工具缺少定义或 schema 无法序列化时保持 unknown，避免显示不完整合计。工具定义在每次现有快照事件刷新时重新读取（包括动态启用/禁用），不在 render 中读取；空闲时注册工具将在下一次快照事件反映。
 - Tools 在 `before_provider_request` 事件后优先统计 provider-specific payload 的 `tools` 字段序列化文本（仍按 UTF-16 长度 / 4 估算）；请求发出前未观察到 payload 时，回退到当前启用工具 schema 的本地估算。它仍不是模型 tokenizer、HTTP 字节数或计费 token，也不包含 headers；如果后续扩展继续改写 payload，面板值可能是本扩展处理时观察到的版本。Images 仅统计图片块数量，不序列化请求或计算未展示的字节数；在 `before_provider_request` 可取得最终 provider payload 时优先统计该 payload，否则统计当前 context 消息；未能观测时显示 `not observed`。
 - context 事件提供调用前的消息快照；session_start/tree/compact、turn_end、agent_settled 使用 buildContextEntries() 重建 compaction-applied active branch。后者显示 active branch，前者显示 context hook。事件之外只读取缓存，不在 render 中扫描历史。
 - Messages 包括 user/assistant 文本、thinking 和 tool call 名称/参数；Tool Results 仅计 content；Summary 包括 compaction/branch summary；Other 包括可发送 custom message 和非排除的用户 bash。
-- Tool Results 按当前快照工具结果文本估算。Fabric 外层 content 只计一次，不遍历内部操作；不读 details、全量 JSONL、沙箱、截断前原始输出或被压缩结果。已返回 content 内的截断提示本身仍属于可发送文本。
+- Tool Results 按当前快照工具结果文本估算。每条 Tool Result 的 content 只计一次，不遍历内部操作；不读 details、全量 JSONL、沙箱、截断前原始输出或被压缩结果。已返回 content 内的截断提示本身仍属于可发送文本。
 
 Composition 的 token 估算使用 `~` 前缀及 K/M 紧凑缩写（四舍五入），百分比保留一位小数。宽度不足时标签与数值拆行；支持的最小侧栏宽 18 可完整显示如 `~100K 100.0%`。
 
@@ -32,4 +32,4 @@ Composition 的 token 估算使用 `~` 前缀及 K/M 紧凑缩写（四舍五入
 
 这是明确标记的本地估算，不宣称最终请求精确统计。后加载扩展仍可能改写 context 或 provider payload；不同 provider 的转换、剔除、包装开销未知。恢复/回合结束时 active branch 可能不同于上次请求经过 context 扩展裁剪后的快照；下一次 context 事件会替换它。模型生成过程中不逐 token 更新分类，最终回合/settled 时更新。只含图片的消息可见文本为零，不代表图片成本为零。
 
-未修改 pi core、Fabric 或全局配置。全屏鼠标/极短终端还应在用户真实终端手工确认。
+未修改 Pi Core 或全局配置。全屏鼠标/极短终端还应在用户真实终端手工确认。

package/extensions/ctx/data.test.ts

@@ -3,8 +3,8 @@ import test from "node:test";
 import { createReadTool, SessionManager } from "@earendil-works/pi-coding-agent";
 import { estimateContext, installContextEstimates, messagesFromContextEntries } from "./data.ts";
 
-const result = (n: number) => ({ role: "toolResult", toolName: "fabric_exec", toolCallId: String(n), content: [{ type: "text", text: "x".repeat(n * 4) }], details: { fullOutput: "x".repeat(100000), operations: [{ toolName: "read" }] } });
-const tool = { name: "fabric_exec", description: "Execute TypeScript", parameters: createReadTool(process.cwd()).parameters };
+const result = (n: number) => ({ role: "toolResult", toolName: "sample_runner", toolCallId: String(n), content: [{ type: "text", text: "x".repeat(n * 4) }], details: { fullOutput: "x".repeat(100000), operations: [{ toolName: "read" }] } });
+const tool = { name: "sample_runner", description: "Execute TypeScript", parameters: createReadTool(process.cwd()).parameters };
 
 test("context estimate keeps tool schemas, summaries, images and active branch semantics", () => {
   const snapshot = estimateContext([{role:"user",content:"abcd"}, result(4), {role:"compactionSummary",summary:"abcd"}], "abcd", "context hook", [tool]);
@@ -16,7 +16,7 @@ test("context estimate keeps tool schemas, summaries, images and active branch s
 
 test("tracker filters active tools, refreshes schemas, caches snapshots and resets", () => {
   const handlers = new Map<string, Function>();
-  let active = ["fabric_exec"];
+  let active = ["sample_runner"];
   let all = [tool];
   const tracker = installContextEstimates({
     on: (name: string, fn: Function) => handlers.set(name, fn),

package/extensions/ctx/tools.test.ts

@@ -3,7 +3,7 @@ import test from "node:test";
 import { createReadTool } from "@earendil-works/pi-coding-agent";
 import { estimateContext, estimateProviderToolsTokens, installContextEstimates } from "./data.ts";
 
-const tool = { name: "fabric_exec", description: "Execute TypeScript", parameters: createReadTool(process.cwd()).parameters };
+const tool = { name: "sample_runner", description: "Execute TypeScript", parameters: createReadTool(process.cwd()).parameters };
 const expected = Math.ceil(JSON.stringify(tool).length / 4);
 const toolsCategory = (snapshot: ReturnType<typeof estimateContext>) => snapshot.categories.find(c => c.name === "Tools")!;
 
@@ -25,7 +25,7 @@ test("Tools counts schema JSON only and contributes to totals and percentages",
 
 test("tracker filters active tools, refreshes dynamic schemas, caches reads and resets", () => {
  const handlers = new Map<string, Function>();
- let active = ["fabric_exec", "fabric_exec"];
+ let active = ["sample_runner", "sample_runner"];
  let all = [tool, {...tool,name:"captured_read",description:"not exposed".repeat(100)}];
  let reads = 0;
  let fail = false;
@@ -44,7 +44,7 @@ test("tracker filters active tools, refreshes dynamic schemas, caches reads and
  assert.ok(toolsCategory(tracker.getSnapshot()).tokens! > expected);
  handlers.get("before_provider_request")!({payload:{tools:[tool]}},ctx);
  assert.equal(toolsCategory(tracker.getSnapshot()).tokens, Math.ceil(JSON.stringify([tool]).length/4));
- all = [{...tool,description:"changed"}]; active = ["fabric_exec"];
+ all = [{...tool,description:"changed"}]; active = ["sample_runner"];
  handlers.get("turn_end")!({},ctx);
  // The last provider payload remains authoritative through active-branch refresh.
  assert.equal(toolsCategory(tracker.getSnapshot()).tokens, Math.ceil(JSON.stringify([tool]).length/4));

package/extensions/index.ts

@@ -12,7 +12,6 @@ import {
 import { installContextEstimates } from "./ctx/data.ts";
 import { createActivityTracker, type ActivityTracker } from "./ctx/activity.ts";
 import { installFooter, type FooterController } from "./footer/index.ts";
-import { isFabricFullCodeMode } from "./fabric-detection.ts";
 import { adapterMcpServers, buildMcpStatusSnapshot, describeMcpStatus, type McpStatusSnapshot } from "./mcp/status-center.ts";
 import {
   createDefaultSidebarPanels,
@@ -524,7 +523,6 @@ export default async function piUiExtension(pi: ExtensionAPI): Promise<void> {
     toolUsage = createToolUsageTracker([], getMcpServerNames);
     toolUsage.resetSession(branch);
     if (ctx.mode !== "tui") return;
-    const showToolViewModeSelector = (): boolean => !isFabricFullCodeMode(pi.getActiveTools());
 
     activity = createActivityTracker(ctx.cwd, refreshContextUi);
     footer = installFooter(
@@ -543,7 +541,6 @@ export default async function piUiExtension(pi: ExtensionAPI): Promise<void> {
           onSelectToolViewMode: (mode): void => {
             void toolView.setMode(mode, ctx);
           },
-          showToolViewModeSelector,
           loadSessions: async (): Promise<readonly SessionListItem[]> => {
             const currentSessionId = ctx.sessionManager.getSessionId();
             const sessions = await SessionManager.list(ctx.cwd, ctx.sessionManager.getSessionDir());

package/extensions/mcp/integration.test.ts

@@ -20,7 +20,7 @@ test("entry wires early/late MCP status into restored and live usage without dou
   };
   const theme: any = { fg: (_: string, text: string) => text, bold: (text: string) => text };
   const pi: any = {
-    registerTool() {}, registerCommand() {}, registerShortcut() {},
+    registerTool() { throw new Error("Tool View must not register tools"); }, registerToolRenderer() {}, registerCommand() {}, registerShortcut() {},
     getCommands: () => [], getActiveTools: () => [], getAllTools: () => [], getThinkingLevel: () => "off",
     getMcpServers: () => registrations,
     on(name: string, fn: any) { handlers.set(name, [...(handlers.get(name) ?? []), fn]); },

package/extensions/sidebar/default-panels.test.ts

@@ -4,7 +4,7 @@ import { createDefaultSidebarPanels, createToolViewScrollView, SESSION_PANEL_ID,
 import { renderLayoutFrame } from "@earendil-works/pi-tui/dist/layout.js";
 import { ToolViewPanel } from "../tool-view/panel.ts";
 
-function options(showToolViewModeSelector?: boolean): Parameters<typeof createDefaultSidebarPanels>[0] {
+function options(): Parameters<typeof createDefaultSidebarPanels>[0] {
   return {
     getContextUsage: () => undefined,
     getModel: () => "test-model",
@@ -12,7 +12,6 @@ function options(showToolViewModeSelector?: boolean): Parameters<typeof createDe
     getToolViewMode: () => "compact",
     getToolUsage: () => undefined,
     onSelectToolViewMode() {},
-    showToolViewModeSelector: () => showToolViewModeSelector ?? true,
     loadSessions: async () => [],
     onSelectSession() {},
     onRenameSession() {},
@@ -23,12 +22,12 @@ function options(showToolViewModeSelector?: boolean): Parameters<typeof createDe
 }
 
 test("registers sessions without removed standalone panels", () => {
-  const ids = createDefaultSidebarPanels(options(true)).map((panel) => panel.id);
+  const ids = createDefaultSidebarPanels(options()).map((panel) => panel.id);
   assert.deepEqual(ids, [SESSION_PANEL_ID, "context", TOOL_VIEW_PANEL_ID]);
   assert.ok(!ids.includes("activity"));
   assert.ok(ids.includes("context"));
-  const context = createDefaultSidebarPanels(options(true)).find(panel => panel.id === "context")!;
-  const sessions = createDefaultSidebarPanels(options(true)).find(panel => panel.id === SESSION_PANEL_ID)!;
+  const context = createDefaultSidebarPanels(options()).find(panel => panel.id === "context")!;
+  const sessions = createDefaultSidebarPanels(options()).find(panel => panel.id === SESSION_PANEL_ID)!;
   assert.equal(sessions.layout?.maxSize, 9);
   assert.equal(context.layout?.minSize, 10);
   assert.ok(!ids.includes("resources"));
@@ -36,15 +35,11 @@ test("registers sessions without removed standalone panels", () => {
 });
 
 
-test("always registers Tool View without Fabric", () => {
-  const ids = createDefaultSidebarPanels(options(true)).map((panel) => panel.id);
+test("always registers Tool View", () => {
+  const ids = createDefaultSidebarPanels(options()).map((panel) => panel.id);
   assert.ok(ids.includes(TOOL_VIEW_PANEL_ID));
 });
 
-test("keeps Tool View registered when Fabric hides only its selector", () => {
-  const ids = createDefaultSidebarPanels(options(false)).map((panel) => panel.id);
-  assert.ok(ids.includes(TOOL_VIEW_PANEL_ID));
-});
 
 test("keeps Tool View anchored at the top when usage rows overflow", () => {
   const tui = { addInputListener: () => () => {}, requestRender() {} } as any;

package/extensions/sidebar/default-panels.ts

@@ -65,7 +65,6 @@ export type DefaultSidebarPanelOptions = {
   readonly getToolViewMode: () => ToolViewMode | undefined;
   readonly getToolUsage: () => ToolUsageSnapshot | undefined;
   readonly onSelectToolViewMode: (mode: ToolViewMode) => void;
-  readonly showToolViewModeSelector?: () => boolean;
   readonly loadSessions: () => Promise<readonly SessionListItem[]>;
   readonly onSelectSession: (session: SessionListItem) => void;
   readonly onRenameSession: (session: SessionListItem) => void;
@@ -142,7 +141,6 @@ export function createDefaultSidebarPanels(
         getMode: options.getToolViewMode,
         getUsage: options.getToolUsage,
         onSelect: options.onSelectToolViewMode,
-        showModeSelector: options.showToolViewModeSelector,
         showBottomBorder: false,
       });
       const scroll = createToolViewScrollView(panel, theme);

package/extensions/tool-view/codemode-compact.ts

@@ -0,0 +1,135 @@
+import type {
+  AgentToolResult,
+  Theme,
+  ToolRenderers,
+  ToolRenderResultOptions,
+} from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth, type Component } from "@earendil-works/pi-tui";
+
+type RenderContext = Parameters<NonNullable<ToolRenderers["renderCall"]>>[2];
+type MetricColor = "text" | "success" | "error" | "warning" | "muted";
+type Metric = {
+  label: string;
+  color: MetricColor;
+  group: "calls" | "output";
+  /** Lower priority number survives narrower terminals first. */
+  priority: number;
+};
+
+const CALL_SEPARATOR = "  │  ";
+const METRIC_SEPARATOR = " · ";
+
+/** One terminal row regardless of viewport width; no wrapping or padding. */
+function singleLine(line: string): Component {
+  return {
+    render(width: number): string[] {
+      return width > 0 ? [truncateToWidth(line, width, "…")] : [];
+    },
+    invalidate() {},
+  };
+}
+
+function formatDuration(durationMs: unknown): string | undefined {
+  if (typeof durationMs !== "number" || !Number.isFinite(durationMs) || durationMs < 0) return undefined;
+  return durationMs < 1000 ? `${Math.round(durationMs)}ms` : `${(durationMs / 1000).toFixed(1)}s`;
+}
+
+function countContent(result: AgentToolResult<any>): { lines: number; images: number } {
+  let lines = 0;
+  let images = 0;
+  for (const block of result.content) {
+    if (block.type === "image") images++;
+    else if (block.type === "text" &&
+      !/^Script (completed|failed)\nWall time [\d.]+ seconds\nOutput:\n$/.test(block.text)) {
+      lines += block.text.split("\n").filter((line) => line.trim().length > 0).length;
+    }
+  }
+  return { lines, images };
+}
+
+function codeLineCount(args: unknown): string {
+  const code = args !== null && typeof args === "object" && "code" in args
+    ? (args as { code?: unknown }).code : undefined;
+  if (typeof code !== "string") return "代码行数未知";
+  return `${code ? code.split("\n").length : 0} 行代码`;
+}
+
+export function renderCodemodeCompactCall(args: unknown, theme: Theme): Component {
+  const label = theme.fg("accent", "▸ ") +
+    theme.fg("toolTitle", theme.bold("codemode")) +
+    theme.fg("dim", `  ${codeLineCount(args)}`);
+  return singleLine(label);
+}
+
+function formatSummary(
+  theme: Theme,
+  state: string,
+  stateColor: "success" | "error" | "warning",
+  metrics: readonly Metric[],
+  width: number,
+): string {
+  const heading = theme.fg(stateColor, state);
+  if (width <= visibleWidth(heading)) return truncateToWidth(heading, width, "…");
+
+  // Work out which complete metrics can be shown, then restore display order.
+  // Never show half a metric or let Text wrap the row across multiple lines.
+  const selected = new Set<Metric>();
+  const ranked = metrics.slice().sort((a, b) => a.priority - b.priority);
+  const compose = (): string => {
+    let row = heading;
+    let lastGroup: Metric["group"] | undefined;
+    for (const metric of metrics) {
+      if (!selected.has(metric)) continue;
+      const separator = lastGroup && lastGroup === metric.group ? METRIC_SEPARATOR : CALL_SEPARATOR;
+      row += theme.fg("dim", separator) + theme.fg(metric.color, metric.label);
+      lastGroup = metric.group;
+    }
+    return row;
+  };
+  for (const metric of ranked) {
+    selected.add(metric);
+    if (visibleWidth(compose()) > width) selected.delete(metric);
+  }
+  return compose();
+}
+
+export function renderCodemodeCompactResult(
+  result: AgentToolResult<any>,
+  theme: Theme,
+  context: RenderContext,
+  options: ToolRenderResultOptions,
+): Component {
+  const status = options.isPartial ? "… 运行中" : context.isError ? "✗ 失败" : "✓ 已完成";
+  const stateColor = options.isPartial ? "warning" : context.isError ? "error" : "success";
+  const rawCalls: unknown = result.details?.calls;
+  const calls: readonly unknown[] = Array.isArray(rawCalls) ? rawCalls : [];
+  const statuses = { ok: 0, error: 0, cancelled: 0, running: 0 };
+  for (const call of calls) {
+    if (!call || typeof call !== "object") continue;
+    const state: unknown = (call as { status?: unknown }).status;
+    if (state === "ok" || state === "error" || state === "cancelled" || state === "running") {
+      statuses[state]++;
+    }
+  }
+  const metrics: Metric[] = [];
+  if (calls.length > 0) metrics.push({ label: `${calls.length} 次调用`, color: "text", group: "calls", priority: 1 });
+  if (statuses.ok) metrics.push({ label: `${statuses.ok} 成功`, color: "success", group: "calls", priority: 5 });
+  if (statuses.error) metrics.push({ label: `${statuses.error} 失败`, color: "error", group: "calls", priority: 2 });
+  if (statuses.cancelled) metrics.push({ label: `${statuses.cancelled} 取消`, color: "muted", group: "calls", priority: 3 });
+  if (statuses.running) metrics.push({ label: `${statuses.running} 进行中`, color: "warning", group: "calls", priority: 3 });
+  if (!options.isPartial) {
+    const { lines, images } = countContent(result);
+    if (lines) metrics.push({ label: `${lines} 行输出`, color: "muted", group: "output", priority: 6 });
+    if (images) metrics.push({ label: `${images} 张图片`, color: "muted", group: "output", priority: 7 });
+  }
+  const duration = formatDuration(context.durationMs);
+  if (duration) metrics.push({ label: duration, color: "muted", group: "output", priority: 4 });
+
+  // All necessary data is captured by the component, with only width varying on render.
+  return {
+    render(width: number): string[] {
+      return width > 0 ? [formatSummary(theme, status, stateColor, metrics, width)] : [];
+    },
+    invalidate() {},
+  };
+}