@armadra/agent 0.3.0 → 0.4.0

package/dist/modes/interactive/pickers.js

@@ -4,14 +4,17 @@
  * - 模型：按供应商分组并标 key 状态（`modelItems`，与启动期共用），当前模型预选；
  * - 会话：名字或首条提示、相对时间、消息数（`sessionItems`）；
  * - 树：会话文件里全部用户消息，按分叉缩进，`●` 标出当前分支；选中项回填编辑器（由 commands.ts 处理）；
- * - 权限模式（从严到宽）与思考级别。
+ * - 权限模式（标题「权限模式」，界面顺序 1–6，当前模式 ✓ / Default dim / Recommended accent，底部按键提示，
+ *   上下留白，见 permissionItems）与思考级别；
+ * - 所有选择器底部一行按键提示（dim），模型选择器带 (i/n) 并给当前模型打 ✓。
  */
 import { THINKING_LEVELS } from "../../ai/thinking.js";
-import { PERMISSION_MODES_STRICT_FIRST } from "../../permissions/types.js";
+import { PERMISSION_MODE_INFO, PERMISSION_MODE_ORDER, RECOMMENDED_PERMISSION_MODE, } from "../../permissions/modes.js";
 import { Box, SelectList, } from "../../tui.js";
 import { contentText } from "./message-view.js";
 import { relativeTime } from "./startup-ui.js";
 export { modelItems, sessionItems } from "./startup-ui.js";
+export const PICKER_FOOTER = "↑↓ 选择 · Enter 确认 · Esc 取消";
 /** 打开一个居中选择器；Enter 返回选中项，Esc / Ctrl+C 返回 undefined。 */
 export function openPicker(host, spec) {
     return new Promise((resolve) => {
@@ -26,30 +29,60 @@ export function openPicker(host, spec) {
             filterable: spec.filterable ?? spec.items.length > 8,
             ...(host.keybindings !== undefined ? { keybindings: host.keybindings } : {}),
             ...(spec.emptyText !== undefined ? { emptyText: spec.emptyText } : {}),
+            ...(spec.numberKeys === true ? { numberKeys: true } : {}),
+            ...(spec.stacked === true ? { stacked: true } : {}),
+            ...(spec.currentValue !== undefined ? { currentValue: spec.currentValue } : {}),
+            ...(spec.showCount === true ? { showCount: true } : {}),
+            footer: spec.footer ?? PICKER_FOOTER,
             onSelect: (item) => close(item),
             onCancel: () => close(undefined),
         });
         if (spec.selected !== undefined)
             list.selectValue(spec.selected);
         const width = Math.max(20, Math.min(host.columns() - 2, 72));
-        handle = host.showOverlay(new Box(list, { title: spec.title, theme: host.theme }), {
+        const box = new Box(list, {
+            title: spec.title,
+            theme: host.theme,
+            ...(spec.paddingY !== undefined ? { paddingY: spec.paddingY } : {}),
+        });
+        handle = host.showOverlay(box, {
             anchor: "center",
             width,
         });
     });
 }
-const PERMISSION_TEXT = {
-    plan: "只读，不改文件不跑命令",
-    default: "写入与命令逐次确认",
-    "auto-edit": "文件编辑自动放行，命令确认",
-    "full-auto": "全部放行（危险命令仍确认）",
-};
-export function permissionItems() {
-    return PERMISSION_MODES_STRICT_FIRST.map((mode) => ({
-        value: mode,
-        label: mode,
-        description: PERMISSION_TEXT[mode],
-    }));
+/**
+ * 模式选择器（标题「权限模式」）：界面顺序、当前模式打勾（`currentValue`）、配置里的缺省模式标
+ * `Default`、Auto 标 `Recommended`，右侧数字快捷键 1–6，说明在下一行。
+ */
+export function permissionItems(_current, configDefault = "default") {
+    return PERMISSION_MODE_ORDER.map((mode) => {
+        const info = PERMISSION_MODE_INFO[mode];
+        const item = { value: mode, label: info.label, description: info.description };
+        const badges = [
+            ...(mode === configDefault ? ["Default"] : []),
+            ...(mode === RECOMMENDED_PERMISSION_MODE ? ["Recommended"] : []),
+        ];
+        if (badges.length > 0) {
+            item.badge = badges.join(" · ");
+            if (mode !== RECOMMENDED_PERMISSION_MODE)
+                item.badgeColor = "dim";
+        }
+        return item;
+    });
+}
+export function permissionPickerSpec(current, configDefault = "default") {
+    return {
+        title: "权限模式",
+        items: permissionItems(current, configDefault),
+        selected: current,
+        currentValue: current,
+        filterable: false,
+        numberKeys: true,
+        stacked: true,
+        footer: "↑↓ 选择 · 1-6 直接选 · Enter 确认 · Esc 取消",
+        paddingY: 1,
+    };
 }
 export function thinkingItems(reasoning) {
     return THINKING_LEVELS.map((level) => {

package/dist/modes/interactive/run-indicator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 运行指示与排队消息（终端界面视觉设计 v1 §3.7、§3.8）：输入框上方的 Loader 动词状态机与排队列表。
+ *
+ * 动词按「当前最深状态」取，避免事件乱序时闪回：
+ *   审批打开 → `等待确认`（无 Esc 提示，Esc 由对话框消费）
+ *   有运行中的工具 → `运行 bash` / `运行 3 个工具`
+ *   自动重试等待中 → `重试 2/3 · 2s 后`（不显示已用时）
+ *   压缩中 → `压缩上下文`
+ *   助手在流式输出 → 末块是思考 `思考中`，否则 `回复中 · ↓≈1.2k`（本条输出的估算 token，4 字符 ≈ 1）
+ *   其余（等首个 token）→ `思考中`
+ * 运行或压缩时 Loader 才挂进槽位；附加项 `Esc 中断`。
+ *
+ * 排队消息：缩进 2 列（挂在当前回合下），`↳ 插话 / 之后  文本` 整体 muted、标签 dim；超过 3 条首行
+ * `… 另 N 条`；末行 `Alt+↑ 取回 · Esc 回填并中断`。
+ */
+import type { SessionEvent } from "../../agent/types.js";
+import { Container, Text, type Loader, type Theme } from "../../tui.js";
+import type { ToolTracker } from "./tool-view.js";
+export declare const QUEUE_PREVIEW = 3;
+export interface RunIndicatorDeps {
+    theme: Theme;
+    loader: Loader;
+    /** Loader 的挂载槽位（运行时才有子组件）。 */
+    slot: Container;
+    tools: ToolTracker;
+    render(): void;
+}
+export declare class RunIndicator {
+    private readonly deps;
+    running: boolean;
+    compacting: boolean;
+    private approval;
+    private retry;
+    private stream;
+    constructor(deps: RunIndicatorDeps);
+    get busy(): boolean;
+    setApproval(open: boolean): void;
+    /** 会话切换后清零。 */
+    reset(): void;
+    /** 会话事件 → 状态；返回后已同步 Loader。 */
+    onEvent(event: SessionEvent): void;
+    /** 按当前状态换动词，并挂上 / 撤下 Loader。 */
+    sync(): void;
+    private applyVerb;
+}
+/** 排队消息（插话 / 之后），挂在 Loader 之上。 */
+export declare class QueueView extends Text {
+    private readonly theme;
+    constructor(theme: Theme);
+    setQueue(steering: readonly string[], followUp: readonly string[]): void;
+}

package/dist/modes/interactive/run-indicator.js

@@ -0,0 +1,189 @@
+/**
+ * 运行指示与排队消息（终端界面视觉设计 v1 §3.7、§3.8）：输入框上方的 Loader 动词状态机与排队列表。
+ *
+ * 动词按「当前最深状态」取，避免事件乱序时闪回：
+ *   审批打开 → `等待确认`（无 Esc 提示，Esc 由对话框消费）
+ *   有运行中的工具 → `运行 bash` / `运行 3 个工具`
+ *   自动重试等待中 → `重试 2/3 · 2s 后`（不显示已用时）
+ *   压缩中 → `压缩上下文`
+ *   助手在流式输出 → 末块是思考 `思考中`，否则 `回复中 · ↓≈1.2k`（本条输出的估算 token，4 字符 ≈ 1）
+ *   其余（等首个 token）→ `思考中`
+ * 运行或压缩时 Loader 才挂进槽位；附加项 `Esc 中断`。
+ *
+ * 排队消息：缩进 2 列（挂在当前回合下），`↳ 插话 / 之后  文本` 整体 muted、标签 dim；超过 3 条首行
+ * `… 另 N 条`；末行 `Alt+↑ 取回 · Esc 回填并中断`。
+ */
+import { Container, Text } from "../../tui.js";
+import { ORIGIN_LABELS } from "./message-view.js";
+import { formatTokens } from "./status-bar.js";
+export const QUEUE_PREVIEW = 3;
+function oneLine(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+/** 助手消息里已流出的文字（思考 + 正文）的估算 token 与末块类型。 */
+function streamState(message) {
+    let chars = 0;
+    let last;
+    for (const block of message.content) {
+        if (block.type === "text") {
+            chars += block.text.length;
+            if (block.text !== "")
+                last = "text";
+        }
+        else if (block.type === "thinking") {
+            chars += block.thinking.length;
+            if (block.thinking !== "")
+                last = "thinking";
+        }
+        else if (block.type === "toolCall")
+            last = "toolCall";
+    }
+    return { tokens: Math.ceil(chars / 4), thinking: last === "thinking" };
+}
+export class RunIndicator {
+    deps;
+    running = false;
+    compacting = false;
+    approval = false;
+    retry;
+    stream;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get busy() {
+        return this.running || this.compacting;
+    }
+    setApproval(open) {
+        this.approval = open;
+        this.sync();
+    }
+    /** 会话切换后清零。 */
+    reset() {
+        this.running = false;
+        this.compacting = false;
+        this.approval = false;
+        this.retry = undefined;
+        this.stream = undefined;
+        this.sync();
+    }
+    /** 会话事件 → 状态；返回后已同步 Loader。 */
+    onEvent(event) {
+        switch (event.type) {
+            case "agent_start":
+                this.running = true;
+                break;
+            case "agent_settled":
+                this.running = false;
+                this.retry = undefined;
+                this.stream = undefined;
+                break;
+            case "message_start":
+                if (event.message.role === "assistant") {
+                    this.retry = undefined;
+                    this.stream = streamState(event.message);
+                }
+                break;
+            case "message_update":
+                if (event.message.role === "assistant")
+                    this.stream = streamState(event.message);
+                break;
+            case "message_end":
+                if (event.message.role === "assistant")
+                    this.stream = undefined;
+                break;
+            case "compaction_start":
+                this.compacting = true;
+                break;
+            case "compaction_end":
+                this.compacting = false;
+                break;
+            case "auto_retry_start":
+                this.retry = { attempt: event.attempt, max: event.maxAttempts, delayMs: event.delayMs };
+                break;
+            case "auto_retry_end":
+                this.retry = undefined;
+                break;
+            case "tool_execution_start":
+            case "tool_execution_end":
+                break;
+            default:
+                return;
+        }
+        this.sync();
+    }
+    /** 按当前状态换动词，并挂上 / 撤下 Loader。 */
+    sync() {
+        const { loader, slot, render } = this.deps;
+        const active = this.busy;
+        if (active)
+            this.applyVerb();
+        if (active && slot.children.length === 0) {
+            slot.addChild(loader);
+            loader.start();
+        }
+        else if (!active && slot.children.length > 0) {
+            loader.stop();
+            slot.clear();
+        }
+        render();
+    }
+    applyVerb() {
+        const { loader, tools } = this.deps;
+        const esc = ["Esc 中断"];
+        if (this.approval) {
+            loader.setVerb("等待确认");
+            return;
+        }
+        const running = tools.running();
+        const top = running.filter((view) => !running.some((p) => p.children.includes(view)));
+        if (top.length === 1) {
+            loader.setVerb(`运行 ${top[0].toolName}`, esc);
+            return;
+        }
+        if (top.length > 1) {
+            loader.setVerb(`运行 ${top.length} 个工具`, esc);
+            return;
+        }
+        if (this.retry !== undefined) {
+            const seconds = Math.max(1, Math.round(this.retry.delayMs / 1000));
+            loader.setVerb(`重试 ${this.retry.attempt}/${this.retry.max}`, [`${seconds}s 后`], {
+                elapsed: false,
+            });
+            return;
+        }
+        if (this.compacting) {
+            loader.setVerb("压缩上下文", esc);
+            return;
+        }
+        const stream = this.stream;
+        if (stream !== undefined && !stream.thinking && stream.tokens > 0) {
+            loader.setVerb("回复中", [`↓≈${formatTokens(stream.tokens)}`, ...esc]);
+            return;
+        }
+        loader.setVerb("思考中", esc);
+    }
+}
+/** 排队消息（插话 / 之后），挂在 Loader 之上。 */
+export class QueueView extends Text {
+    theme;
+    constructor(theme) {
+        super("");
+        this.theme = theme;
+    }
+    setQueue(steering, followUp) {
+        const t = this.theme;
+        const row = (origin, text) => `  ${t.fg("dim", `${t.glyphs.queued} ${ORIGIN_LABELS[origin]}`)}  ${t.fg("muted", oneLine(text))}`;
+        const rows = [
+            ...steering.map((text) => row("steer", text)),
+            ...followUp.map((text) => row("followUp", text)),
+        ];
+        const shown = rows.slice(-QUEUE_PREVIEW);
+        if (rows.length > shown.length) {
+            shown.unshift("  " + t.fg("dim", `${t.glyphs.ellipsis} 另 ${rows.length - shown.length} 条`));
+        }
+        if (rows.length > 0) {
+            shown.push("    " + t.fg("dim", `Alt+${t.glyphs.arrowUp} 取回 · Esc 回填并中断`));
+        }
+        this.setText(shown.join("\n"));
+    }
+}

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

@@ -0,0 +1,40 @@
+/**
+ * 交互模式启动头（终端界面视觉设计 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 type { StartupInfo } from "../../cli/startup-screen.js";
+import { type Component, type Theme } from "../../tui.js";
+/** 画框的最小宽度；更窄时去框去键列。 */
+export declare const HEADER_BOX_MIN_WIDTH = 56;
+/** 设计稿写 60；常见的「供应商/模型@渠道 · 思考 级别」要 62 列左右才不截断，取 64。 */
+export declare const HEADER_BOX_MAX_WIDTH = 64;
+export interface StartupHeaderOptions {
+    theme: Theme;
+    level: "normal" | "header";
+    /** `ui.compact`：normal 也不画框。 */
+    compact?: boolean;
+}
+/** 从左截断到 `width` 列（保留末尾，前面加省略号）。 */
+export declare function truncateLeft(text: string, width: number, ellipsis?: string): string;
+export declare class StartupHeader implements Component {
+    private readonly info;
+    private readonly options;
+    private cache;
+    constructor(info: StartupInfo, options: StartupHeaderOptions);
+    private get theme();
+    private title;
+    private modeText;
+    private trustText;
+    private loadedText;
+    private codemodeText;
+    render(width: number): string[];
+    private headerLine;
+    private plainLines;
+    private boxLines;
+    invalidate(): void;
+}

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/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;
 }