@armadra/agent 0.2.1 → 0.4.0

package/dist/modes/interactive/startup-header.js

@@ -0,0 +1,169 @@
+/**
+ * 交互模式启动头（终端界面视觉设计 v1 §3.1）。
+ *
+ * - `normal`：宽度 ≥ 56 且非 `ui.compact` 时画框（宽 `min(width, 64)`，左对齐）——标题 `✻ ama x.y.z`、
+ *   键值行（模型 / 目录 / 模式 / 已加载 / 宿主 / 警告）、按键提示；否则去框去键列，每项一行。
+ * - `header`：一行 `✻ ama x.y.z · 模型 · 模式 · /help`，无框。`silent` 不输出（调用方不加本组件）。
+ * - 着色：`✻` accent、标题粗体；键列 dim；模型 accent；已信任 success / 未信任 warning；Bypass 模式 warning；
+ *   按键提示 dim。路径过长时从左截断（`…/armadra-agent`）。宽度变化时按新宽重算是否去框。
+ */
+import { permissionModeLabel } from "../../permissions/modes.js";
+import { Box, KeyValue, padToWidth, truncateToWidth, visibleWidth, } from "../../tui.js";
+/** 画框的最小宽度；更窄时去框去键列。 */
+export const HEADER_BOX_MIN_WIDTH = 56;
+/** 设计稿写 60；常见的「供应商/模型@渠道 · 思考 级别」要 62 列左右才不截断，取 64。 */
+export const HEADER_BOX_MAX_WIDTH = 64;
+/** 从左截断到 `width` 列（保留末尾，前面加省略号）。 */
+export function truncateLeft(text, width, ellipsis = "…") {
+    if (visibleWidth(text) <= width)
+        return text;
+    const room = width - visibleWidth(ellipsis);
+    if (room <= 0)
+        return truncateToWidth(ellipsis, width);
+    const chars = [...text];
+    let out = "";
+    let used = 0;
+    for (let i = chars.length - 1; i >= 0; i--) {
+        const w = visibleWidth(chars[i]);
+        if (used + w > room)
+            break;
+        out = chars[i] + out;
+        used += w;
+    }
+    return ellipsis + out;
+}
+/** 去掉模型引用里的渠道（`@messages`）。 */
+function withoutChannel(model) {
+    const at = model.indexOf("@");
+    return at === -1 ? model : model.slice(0, at);
+}
+export class StartupHeader {
+    info;
+    options;
+    cache = null;
+    constructor(info, options) {
+        this.info = info;
+        this.options = options;
+    }
+    get theme() {
+        return this.options.theme;
+    }
+    title() {
+        const t = this.theme;
+        return `${t.fg("accent", t.glyphs.thinking)} ${t.bold(`ama ${this.info.version}`)}`;
+    }
+    modeText() {
+        const label = permissionModeLabel(this.info.permissionMode);
+        return this.info.permissionMode === "full-auto" ? this.theme.fg("warning", label) : label;
+    }
+    trustText(withSource) {
+        const { trusted, trustSource } = this.info;
+        const text = `${trusted ? "已信任" : "未信任"}${withSource ? `（${trustSource}）` : ""}`;
+        return this.theme.fg(trusted ? "success" : "warning", text);
+    }
+    loadedText() {
+        const { contextFiles, skills, prompts, hooks } = this.info;
+        const parts = [];
+        if (contextFiles.length > 0)
+            parts.push(contextFiles.join(", "));
+        if (skills > 0)
+            parts.push(`${skills} Skill`);
+        if (prompts > 0)
+            parts.push(`${prompts} 模板`);
+        if (hooks > 0)
+            parts.push(`${hooks} Hook`);
+        return parts.length === 0 ? undefined : parts.join(" · ");
+    }
+    codemodeText() {
+        return this.info.codemode === "off" ? undefined : `codemode ${this.info.codemode}`;
+    }
+    render(width) {
+        if (this.cache?.width === width)
+            return this.cache.lines;
+        const lines = this.options.level === "header"
+            ? [this.headerLine(width)]
+            : this.options.compact === true || width < HEADER_BOX_MIN_WIDTH
+                ? this.plainLines(width)
+                : this.boxLines(width);
+        this.cache = { width, lines };
+        return lines;
+    }
+    headerLine(width) {
+        const t = this.theme;
+        const sep = t.fg("dim", " · ");
+        const parts = [
+            this.title(),
+            t.fg("accent", withoutChannel(this.info.model)),
+            this.modeText(),
+            t.fg("dim", "/help"),
+        ];
+        return truncateToWidth(parts.join(sep), width);
+    }
+    plainLines(width) {
+        const t = this.theme;
+        const sep = t.fg("dim", " · ");
+        const ellipsis = t.glyphs.ellipsis;
+        const { info } = this;
+        const lines = [this.title()];
+        lines.push(t.fg("accent", withoutChannel(info.model)) + sep + info.thinking);
+        const trust = this.trustText(false);
+        const room = Math.max(4, width - visibleWidth(trust) - 3);
+        lines.push(truncateLeft(info.cwd, room, ellipsis) + sep + trust);
+        const mode = [this.modeText(), info.preset, this.codemodeText()].filter((p) => p !== undefined);
+        lines.push(mode.join(sep));
+        const loaded = this.loadedText();
+        if (loaded !== undefined)
+            lines.push(loaded);
+        if (info.host !== undefined)
+            lines.push(`宿主 ${info.host}`);
+        if (info.warnings > 0)
+            lines.push(t.fg("warning", `警告 ${info.warnings} 条（ama doctor）`));
+        lines.push(t.fg("dim", "/help · Shift+Tab 切模式"));
+        return lines.map((line) => truncateToWidth(line, width));
+    }
+    boxLines(width) {
+        const t = this.theme;
+        const sep = t.fg("dim", " · ");
+        const { info } = this;
+        const boxWidth = Math.min(width, HEADER_BOX_MAX_WIDTH);
+        /** 框内文本宽：边框 2 + 内边距 2；键列 6 + 间隔 1。 */
+        const valueWidth = boxWidth - 4 - 7;
+        const trust = this.trustText(true);
+        const cwdRoom = Math.max(4, valueWidth - visibleWidth(trust) - 3);
+        const rows = [
+            { key: "模型", value: t.fg("accent", info.model) + sep + `思考 ${info.thinking}` },
+            { key: "目录", value: truncateLeft(info.cwd, cwdRoom, t.glyphs.ellipsis) + sep + trust },
+            {
+                key: "模式",
+                value: [this.modeText(), `预设 ${info.preset}`, this.codemodeText()]
+                    .filter((p) => p !== undefined)
+                    .join(sep),
+            },
+        ];
+        const loaded = this.loadedText();
+        if (loaded !== undefined)
+            rows.push({ key: "已加载", value: loaded });
+        if (info.host !== undefined)
+            rows.push({ key: "宿主", value: info.host });
+        if (info.warnings > 0) {
+            rows.push({ key: "警告", value: t.fg("warning", `${info.warnings} 条（ama doctor 查看）`) });
+        }
+        // 键列固定 6 列（「已加载」的宽度），没有这一行时也对齐
+        const padded = rows.map((row) => ({ ...row, key: padToWidth(row.key, 6) }));
+        const kv = new KeyValue(padded, { theme: t, gap: 1, maxKeyRatio: 1 });
+        const body = {
+            render: (inner) => [
+                this.title(),
+                "",
+                ...kv.render(inner),
+                "",
+                t.fg("dim", "/help 命令 · Shift+Tab 切模式 · Ctrl+O 展开工具输出"),
+            ],
+            invalidate: () => kv.invalidate(),
+        };
+        return new Box(body, { theme: t }).render(boxWidth);
+    }
+    invalidate() {
+        this.cache = null;
+    }
+}

package/dist/modes/interactive/startup-ui.d.ts

@@ -7,7 +7,7 @@
  *
  * `modelItems` / `sessionItems` 同时供交互模式里的选择器（pickers.ts）使用。
  */
-import type { ProviderRegistryApi } from "../../ai/types.js";
+import type { Model, ProviderRegistryApi } from "../../ai/types.js";
 import type { InteractiveUi } from "../../cli/deps.js";
 import type { SessionListItem } from "../../session/types.js";
 import { type Keybindings, type SelectItem, type Terminal, type Theme } from "../../tui.js";
@@ -19,7 +19,12 @@ export interface StartupUiOptions {
     /** 会话列表的相对时间基准（测试注入）。 */
     now?: () => number;
 }
-/** 模型按供应商分组；有 key（或本地）的供应商排前，组标题标 key 状态。 */
+/** 选择器里模型的说明：名称（与 id 不同时）、上下文、`img`（收图片）。 */
+export declare function modelDescription(model: Model): string | undefined;
+/**
+ * 模型按「供应商 · 渠道」分组；有 key（或本地）的供应商排前，组标题标 key 状态。多渠道供应商的模型在
+ * 每个挂载的渠道下各出现一次，非首选渠道的值带 `@渠道`。
+ */
 export declare function modelItems(providers: ProviderRegistryApi): Promise<SelectItem[]>;
 /** `刚刚 / 5 分钟前 / 3 小时前 / 2 天前 / 2026-09-01`。 */
 export declare function relativeTime(iso: string, now: number): string;

package/dist/modes/interactive/startup-ui.js

@@ -102,7 +102,24 @@ function askText(r, prompt) {
 // ---------------------------------------------------------------------------
 // 列表项（选择器共用）
 // ---------------------------------------------------------------------------
-/** 模型按供应商分组；有 key（或本地）的供应商排前，组标题标 key 状态。 */
+/** 选择器里模型的说明：名称（与 id 不同时）、上下文、`img`（收图片）。 */
+export function modelDescription(model) {
+    const ctx = model.contextWindow;
+    const parts = [
+        model.name !== "" && model.name !== model.id ? model.name : undefined,
+        ctx === undefined
+            ? undefined
+            : ctx >= 1_000_000
+                ? `${Math.round(ctx / 100_000) / 10}M`
+                : `${Math.round(ctx / 1000)}k`,
+        model.input.includes("image") ? "img" : undefined,
+    ].filter((x) => x !== undefined);
+    return parts.length > 0 ? parts.join(" · ") : undefined;
+}
+/**
+ * 模型按「供应商 · 渠道」分组；有 key（或本地）的供应商排前，组标题标 key 状态。多渠道供应商的模型在
+ * 每个挂载的渠道下各出现一次，非首选渠道的值带 `@渠道`。
+ */
 export async function modelItems(providers) {
     const groups = [];
     for (const provider of providers.list()) {
@@ -117,16 +134,29 @@ export async function modelItems(providers) {
             ready = key.apiKey !== undefined;
             status = ready ? "key ✓" : "无 key";
         }
-        const group = `${provider.id} · ${status}`;
-        groups.push({
-            ready,
-            items: provider.models.map((model) => {
-                const item = { value: `${provider.id}/${model.id}`, label: model.id, group };
-                if (model.name !== "" && model.name !== model.id)
-                    item.description = model.name;
-                return item;
-            }),
-        });
+        const item = (model, group, channel) => {
+            const suffix = channel !== undefined && channel !== model.channel ? `@${channel}` : "";
+            const out = {
+                value: `${provider.id}/${model.id}${suffix}`,
+                label: `${model.id}${suffix}`,
+                group,
+            };
+            const description = modelDescription(model);
+            if (description !== undefined)
+                out.description = description;
+            return out;
+        };
+        if (provider.channels === undefined) {
+            const group = `${provider.id} · ${status}`;
+            groups.push({ ready, items: provider.models.map((model) => item(model, group)) });
+            continue;
+        }
+        for (const channel of provider.channels) {
+            const group = `${provider.id} · ${channel.name} · ${status}`;
+            const models = provider.models.filter((m) => m.channels?.includes(channel.name));
+            if (models.length > 0)
+                groups.push({ ready, items: models.map((model) => item(model, group, channel.name)) });
+        }
     }
     return [...groups.filter((g) => g.ready), ...groups.filter((g) => !g.ready)].flatMap((g) => g.items);
 }

package/dist/modes/interactive/status-bar.d.ts

@@ -1,20 +1,20 @@
 /**
- * 状态栏（设计 §12.6）：编辑器下方一行。[B7]
+ * 状态栏（设计 §12.6；终端界面视觉设计 v1 §3.10）：编辑器下方一行，永远是最后一行。[B7]
  *
- * `provider/model · think:medium · ↑12.3k ↓1.2k · cache 80% ♨ · $0.12 · rebill $0.11 · ctx 34%
- *  · queue 1 · mode:default · codemode:only net! · preset:default · [宿主状态]`
+ * 两区：左区「权限模式 · shift+tab 切换」，右区用量，中间用空格撑开；空隙不足 4 列时退回单区（` · ` 连接）。
+ * `Accept edits · shift+tab 切换        sonnet-4-5 · medium · ↑12.3k ↓1.2k · cache 80% ♨ · $0.12 · ctx 34%`
  *
- * - 用量来自 `session.getStats()`（`↑` = 输入含缓存读写，`↓` = 输出），只在 `refresh()` 时读取
- *   （事件驱动），渲染只拼字符串；
- * - [W3-C2] `cache` 是**最近一次**请求的命中率（会话累计在 `/session`）；端点三态：`unknown` →
- *   `cache —`，`silent` → `cache 未报告`；保温计时中追加 `♨`；会话有重计费时显示 `rebill $x`
- *   （无价模型显示重计费 token）；会话层缓存未接线时回落到会话命中率 `cacheHitRate`；
- * - `ctx ?` 表示模型没有上下文窗口；≥ 70% 黄、≥ 90% 红；没有用量时不显示 token / cache / 费用；
- * - [W3-C2 A4] codemode 生效时显示 `codemode:on|only`，运行时 Node 的权限模型不隔离网络
- *   （`detectSandboxCapability().strict` 为 false）时追加红色 `net!`；
- * - 宿主状态读 `HostAdapterHandle.status()`（宿主 `ui.setStatus`），每次渲染现取；
- * - 宽度不够时按优先级丢弃（宿主 → 预设 → rebill → 费用 → cache → token → think → 队列 →
- *   codemode），模型、ctx、权限模式最后丢。
+ * - 右区顺序固定：模型 · 思考级别（只显示值，off 不显示）· `↑` 输入（含缓存读写）`↓` 输出 · cache · 费用 ·
+ *   rebill · ctx · queue · codemode · 预设（非 default 才显示）· [宿主状态]；分隔符固定为 ` · `，
+ *   模式永远在最左（tmux 宿主可按此解析）。
+ * - 用量来自 `session.getStats()`，只在 `refresh()` 时读取（事件驱动），渲染只拼字符串；
+ * - [W3-C2] `cache` 是**最近一次**请求的命中率；端点三态 `cache —` / `cache 未报告`；保温中追加 `♨`；
+ *   重计费 `rebill $x`（无价模型显示 token）；codemode 生效时 `codemode on|only`，网络未隔离追加 `net!`；
+ * - 着色：整行 dim；模式名正文色（Bypass permissions warning、Plan accent）；模型 accent；ctx 按阈值
+ *   success / warning / error；rebill、queue warning；`net!` error。宽 ≥ 110 时 ctx 用余量表。
+ * - 模型名缩写：宽 < 100 去掉供应商前缀，< 60 再去掉 `@渠道`，< 48 去掉版本后缀（第一个 `-数字` 起）。
+ * - 宽度不够时按优先级丢弃（数字大的先丢）：切换提示 12 → 宿主 11 → 预设 10 → rebill 9 → 费用 8 →
+ *   cache 7 → token 6 → 思考 5 → 队列 4 → codemode 3 → ctx 1 → 模型 0；模式永不丢。
  */
 import type { AgentSession, SessionCacheStats } from "../../agent/types.js";
 import { type Component, type Theme } from "../../tui.js";
@@ -32,7 +32,9 @@ export interface StatusBarSource {
 export declare function formatTokens(count: number): string;
 export declare function formatCost(cost: number): string;
 /** `cache 83%` / `cache —` / `cache 未报告`，保温计时中追加 ` ♨`。 */
-export declare function cacheText(cache: SessionCacheStats): string;
+export declare function cacheText(cache: SessionCacheStats, warm?: string): string;
+/** 按终端宽度缩写模型名（§3.10）。 */
+export declare function abbreviateModel(ref: string, width: number): string;
 export declare class StatusBar implements Component {
     private readonly source;
     private readonly theme;
@@ -43,6 +45,7 @@ export declare class StatusBar implements Component {
     refresh(): void;
     setQueue(steering: number, followUp: number): void;
     private parts;
+    private ctxText;
     render(width: number): string[];
     invalidate(): void;
 }

package/dist/modes/interactive/status-bar.js

@@ -1,22 +1,24 @@
 /**
- * 状态栏（设计 §12.6）：编辑器下方一行。[B7]
+ * 状态栏（设计 §12.6；终端界面视觉设计 v1 §3.10）：编辑器下方一行，永远是最后一行。[B7]
  *
- * `provider/model · think:medium · ↑12.3k ↓1.2k · cache 80% ♨ · $0.12 · rebill $0.11 · ctx 34%
- *  · queue 1 · mode:default · codemode:only net! · preset:default · [宿主状态]`
+ * 两区：左区「权限模式 · shift+tab 切换」，右区用量，中间用空格撑开；空隙不足 4 列时退回单区（` · ` 连接）。
+ * `Accept edits · shift+tab 切换        sonnet-4-5 · medium · ↑12.3k ↓1.2k · cache 80% ♨ · $0.12 · ctx 34%`
  *
- * - 用量来自 `session.getStats()`（`↑` = 输入含缓存读写，`↓` = 输出），只在 `refresh()` 时读取
- *   （事件驱动），渲染只拼字符串；
- * - [W3-C2] `cache` 是**最近一次**请求的命中率（会话累计在 `/session`）；端点三态：`unknown` →
- *   `cache —`，`silent` → `cache 未报告`；保温计时中追加 `♨`；会话有重计费时显示 `rebill $x`
- *   （无价模型显示重计费 token）；会话层缓存未接线时回落到会话命中率 `cacheHitRate`；
- * - `ctx ?` 表示模型没有上下文窗口；≥ 70% 黄、≥ 90% 红；没有用量时不显示 token / cache / 费用；
- * - [W3-C2 A4] codemode 生效时显示 `codemode:on|only`，运行时 Node 的权限模型不隔离网络
- *   （`detectSandboxCapability().strict` 为 false）时追加红色 `net!`；
- * - 宿主状态读 `HostAdapterHandle.status()`（宿主 `ui.setStatus`），每次渲染现取；
- * - 宽度不够时按优先级丢弃（宿主 → 预设 → rebill → 费用 → cache → token → think → 队列 →
- *   codemode），模型、ctx、权限模式最后丢。
+ * - 右区顺序固定：模型 · 思考级别（只显示值，off 不显示）· `↑` 输入（含缓存读写）`↓` 输出 · cache · 费用 ·
+ *   rebill · ctx · queue · codemode · 预设（非 default 才显示）· [宿主状态]；分隔符固定为 ` · `，
+ *   模式永远在最左（tmux 宿主可按此解析）。
+ * - 用量来自 `session.getStats()`，只在 `refresh()` 时读取（事件驱动），渲染只拼字符串；
+ * - [W3-C2] `cache` 是**最近一次**请求的命中率；端点三态 `cache —` / `cache 未报告`；保温中追加 `♨`；
+ *   重计费 `rebill $x`（无价模型显示 token）；codemode 生效时 `codemode on|only`，网络未隔离追加 `net!`；
+ * - 着色：整行 dim；模式名正文色（Bypass permissions warning、Plan accent）；模型 accent；ctx 按阈值
+ *   success / warning / error；rebill、queue warning；`net!` error。宽 ≥ 110 时 ctx 用余量表。
+ * - 模型名缩写：宽 < 100 去掉供应商前缀，< 60 再去掉 `@渠道`，< 48 去掉版本后缀（第一个 `-数字` 起）。
+ * - 宽度不够时按优先级丢弃（数字大的先丢）：切换提示 12 → 宿主 11 → 预设 10 → rebill 9 → 费用 8 →
+ *   cache 7 → token 6 → 思考 5 → 队列 4 → codemode 3 → ctx 1 → 模型 0；模式永不丢。
  */
-import { truncateToWidth, visibleWidth } from "../../tui.js";
+import { permissionModeLabel } from "../../permissions/modes.js";
+import { formatModelRef } from "../../ai/providers/channels.js";
+import { Meter, levelColor, truncateToWidth, visibleWidth, } from "../../tui.js";
 export function formatTokens(count) {
     if (count < 1000)
         return String(count);
@@ -32,14 +34,29 @@ export function formatCost(cost) {
     return `$${cost.toFixed(3)}`;
 }
 /** `cache 83%` / `cache —` / `cache 未报告`，保温计时中追加 ` ♨`。 */
-export function cacheText(cache) {
+export function cacheText(cache, warm = "♨") {
     const rate = cache.lastHitRate ?? cache.hitRate;
     const value = cache.reporting === "silent"
         ? "未报告"
         : cache.reporting === "reported" && rate !== undefined
             ? `${Math.round(rate * 100)}%`
             : "—";
-    return `cache ${value}${cache.warming.state === "scheduled" ? " ♨" : ""}`;
+    return `cache ${value}${cache.warming.state === "scheduled" ? ` ${warm}` : ""}`;
+}
+/** 两区之间至少留的空格；不足时退回单区。 */
+const MIN_GAP = 4;
+/** ctx 改用余量表的最小宽度。 */
+const METER_WIDTH = 110;
+/** 按终端宽度缩写模型名（§3.10）。 */
+export function abbreviateModel(ref, width) {
+    let out = ref;
+    if (width < 100)
+        out = out.slice(out.indexOf("/") + 1);
+    if (width < 60)
+        out = out.replace(/@.*$/, "");
+    if (width < 48)
+        out = out.replace(/-\d.*$/, "");
+    return out;
 }
 export class StatusBar {
     source;
@@ -57,81 +74,106 @@ export class StatusBar {
     setQueue(steering, followUp) {
         this.queue = steering + followUp;
     }
-    parts() {
+    parts(width) {
         const theme = this.theme;
+        const g = theme.glyphs;
         const session = this.source.session();
         const state = session.state;
         const stats = this.stats ?? session.getStats();
         this.stats = stats;
         const parts = [];
-        const model = state.model === undefined ? "?" : `${state.model.provider}/${state.model.id}`;
-        parts.push({ text: theme.fg("accent", model), priority: 0 });
-        parts.push({ text: `think:${state.thinkingLevel}`, priority: 5 });
+        /** 普通项整项 dim；`colored` 的项已自带颜色。 */
+        const tone = (text, colored) => colored ? text : theme.fg("dim", text);
+        const left = (text, priority, colored = false) => void parts.push({ text: tone(text, colored), priority, zone: "left" });
+        const right = (text, priority, colored = false) => void parts.push({ text: tone(text, colored), priority, zone: "right" });
+        const mode = permissionModeLabel(state.permissionMode);
+        left(state.permissionMode === "full-auto"
+            ? theme.fg("warning", mode)
+            : state.permissionMode === "plan"
+                ? theme.fg("accent", mode)
+                : theme.fg("text", mode), undefined, true);
+        if (width >= 40)
+            left("shift+tab 切换", 12);
+        const model = state.model === undefined ? "?" : abbreviateModel(formatModelRef(state.model), width);
+        right(theme.fg("accent", model), 0, true);
+        if (state.thinkingLevel !== "off")
+            right(state.thinkingLevel, 5);
         const t = stats.tokens;
         const prompt = t.input + t.cacheRead + t.cacheWrite;
+        const cache = stats.cache;
         if (prompt + t.output > 0) {
-            parts.push({ text: `↑${formatTokens(prompt)} ↓${formatTokens(t.output)}`, priority: 6 });
-            const cache = stats.cache;
+            right(`${g.arrowUp}${formatTokens(prompt)} ${g.arrowDown}${formatTokens(t.output)}`, 6);
             if (cache !== undefined)
-                parts.push({ text: cacheText(cache), priority: 7 });
+                right(cacheText(cache, g.warm), 7);
             else if (stats.cacheHitRate !== undefined) {
-                parts.push({ text: `cache ${Math.round(stats.cacheHitRate * 100)}%`, priority: 7 });
+                right(`cache ${Math.round(stats.cacheHitRate * 100)}%`, 7);
             }
             if (stats.cost === undefined)
-                parts.push({ text: "$?", priority: 8 });
+                right("$?", 8);
             else if (stats.cost > 0)
-                parts.push({ text: formatCost(stats.cost), priority: 8 });
+                right(formatCost(stats.cost), 8);
             if (cache !== undefined && cache.reBilledTokens > 0) {
                 const amount = cache.reBilledUsd === undefined
                     ? `${formatTokens(cache.reBilledTokens)} tok`
                     : formatCost(cache.reBilledUsd);
-                parts.push({ text: theme.fg("warning", `rebill ${amount}`), priority: 9 });
+                right(theme.fg("warning", `rebill ${amount}`), 9, true);
             }
         }
-        const ctx = stats.contextPercent;
-        const ctxText = ctx === undefined ? "ctx ?" : `ctx ${Math.round(ctx)}%`;
-        parts.push({
-            text: ctx !== undefined && ctx >= 90
-                ? theme.fg("error", ctxText)
-                : ctx !== undefined && ctx >= 70
-                    ? theme.fg("warning", ctxText)
-                    : ctxText,
-            priority: 1,
-        });
+        right(this.ctxText(stats.contextPercent, width), 1, true);
         if (this.queue > 0)
-            parts.push({ text: theme.fg("warning", `queue ${this.queue}`), priority: 4 });
-        const mode = `mode:${state.permissionMode}`;
-        parts.push({
-            text: state.permissionMode === "full-auto" ? theme.fg("warning", mode) : mode,
-            priority: 2,
-        });
+            right(theme.fg("warning", `queue ${this.queue}`), 4, true);
         const codemode = this.source.codemode?.();
         if (codemode !== undefined) {
             const strict = this.source.sandboxStrict?.() ?? true;
-            parts.push({
-                text: `codemode:${codemode}${strict ? "" : ` ${theme.fg("error", "net!")}`}`,
-                priority: 3,
-            });
+            const label = theme.fg("dim", `codemode ${codemode}`);
+            right(strict ? label : `${label} ${theme.fg("error", "net!")}`, 3, true);
         }
-        parts.push({ text: `preset:${this.source.preset()}`, priority: 10 });
+        const preset = this.source.preset();
+        if (preset !== "default")
+            right(`preset ${preset}`, 10);
         const host = this.source.hostStatus?.();
         if (host !== undefined && host.size > 0) {
             const values = [...host.values()].filter((v) => v.trim() !== "");
             if (values.length > 0)
-                parts.push({ text: `[${values.join(" · ")}]`, priority: 11 });
+                right(`[${values.join(" · ")}]`, 11);
         }
         return parts;
     }
+    ctxText(percent, width) {
+        const theme = this.theme;
+        if (percent === undefined)
+            return theme.fg("dim", "ctx ?");
+        const color = levelColor(percent / 100);
+        if (width >= METER_WIDTH) {
+            const meter = new Meter(percent / 100, { label: theme.fg("dim", "ctx"), theme });
+            return meter.render(80)[0] ?? "";
+        }
+        return theme.fg("dim", "ctx ") + theme.fg(color, `${Math.round(percent)}%`);
+    }
     render(width) {
-        const parts = this.parts();
-        const sep = this.theme.fg("dim", " · ");
+        const theme = this.theme;
+        const sep = theme.fg("dim", " · ");
         const join = (list) => list.map((p) => p.text).join(sep);
-        let kept = parts;
-        while (kept.length > 1 && visibleWidth(join(kept)) > width) {
-            const drop = kept.reduce((worst, p) => (p.priority > worst.priority ? p : worst));
+        let kept = this.parts(width);
+        const zones = () => [
+            join(kept.filter((p) => p.zone === "left")),
+            join(kept.filter((p) => p.zone === "right")),
+        ];
+        const fits = () => {
+            const [l, r] = zones();
+            return visibleWidth(l) + (r === "" ? 0 : 3 + visibleWidth(r)) <= width;
+        };
+        while (!fits()) {
+            const droppable = kept.filter((p) => p.priority !== undefined);
+            if (droppable.length === 0)
+                break;
+            const drop = droppable.reduce((worst, p) => (p.priority > worst.priority ? p : worst));
             kept = kept.filter((p) => p !== drop);
         }
-        return [truncateToWidth(join(kept), width)];
+        const [l, r] = zones();
+        const gap = width - visibleWidth(l) - visibleWidth(r);
+        const line = r === "" ? l : gap >= MIN_GAP ? l + " ".repeat(gap) + r : l + sep + r;
+        return [truncateToWidth(line, width)];
     }
     invalidate() {
         this.stats = undefined;

package/dist/modes/interactive/tool-summary.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 工具调用的文字摘要（终端界面视觉设计 v1 §3.5）：标题行的参数摘要、`⎿` 后的一行结果摘要、
+ * 统一 diff 解析与输出清洗。纯函数，ToolView 负责排版与着色之外的状态。
+ *
+ * 结果摘要（完成后）：
+ * - read `读取 N 行`（图片 `图片 mime`、空文件 `空文件`）；edit `N 处修改 · +a −b`；write `新建 / 覆盖 · N 行`；
+ * - bash `退出 c · 耗时 · N 行`（超时 `超时 · 耗时`、中断 `已中断 · 耗时`）；
+ * - grep `N 处匹配 · M 个文件`；glob `N 个文件`；codemode `N 个内层调用 · 脚本输出 M 行`；
+ * - task `完成 · 耗时 · ↑in ↓out`；其它 `N 行输出`；失败（非 bash）取错误首行。
+ */
+import type { ToolResult } from "../../tools/types.js";
+import { type Theme } from "../../tui.js";
+/** 工具输出 → 可安全显示的行。 */
+export declare function cleanLines(text: string): string[];
+export declare function flat(text: string, max?: number): string;
+export declare function displayPath(path: string, cwd: string | undefined): string;
+/** 标题行里的参数摘要。 */
+export declare function toolSummary(name: string, args: unknown, cwd?: string): string;
+/** 完成耗时：< 10s 一位小数（`2.1s`），< 60s 整秒，再长 `1m05s`。 */
+export declare function formatDuration(ms: number): string;
+export interface DiffRow {
+    kind: "hunk" | "add" | "del" | "ctx";
+    /** 原行（含 `+` / `-` / ` ` 前缀）。 */
+    text: string;
+    /** 行号：删除行取旧号，其余取新号；hunk 行没有。 */
+    num?: number;
+}
+/** 统一 diff → 行（去掉 `---` / `+++` 文件头），带行号。 */
+export declare function parseDiff(diff: string): DiffRow[];
+export declare function diffOf(result: ToolResult | undefined): string | undefined;
+/** bash 完成后的正文：优先 `details.output`（不含退出码等附注）。 */
+export declare function bashOutput(result: ToolResult): string | undefined;
+export interface SummaryInput {
+    name: string;
+    args: unknown;
+    result: ToolResult;
+    isError: boolean;
+    /** 结果正文（已清洗）。 */
+    lines: readonly string[];
+    /** 完成耗时（ms）；重放的历史调用没有，bash 取 `details.wall_time_seconds`。 */
+    elapsedMs: number | undefined;
+    /** 已显示的内层调用数（codemode 没有 details 时用）。 */
+    nestedCount?: number;
+}
+/** 完成后的一行结果摘要（已着色，不含 `⎿`）。 */
+export declare function resultSummary(input: SummaryInput, theme: Theme): string;