@armadra/agent 0.5.1 → 0.6.1

package/dist/trace/types.d.ts

@@ -0,0 +1,243 @@
+/**
+ * 轨迹（docs/wave6-plan.md §2.1、§2.2、D5、D6）。[W6-C0] 纯类型，经 `@armadra/agent` 导出。
+ *
+ * 两部分：
+ * - **持久化**：`custom{customType:"ama.trace"}` 条目的 `data`（`TraceEntryData`），由
+ *   `agent/session-trace-writer.ts` 在事件发生后追加；不进上下文、不改请求字节、不改已落条目。
+ *   只记 id、时间与计数——**不含正文**（提示、参数、结果、外部 Agent 的工具标题 / 命令行 / 路径）。
+ * - **轨迹树**：`Trace`，由 `trace/build.ts` 的 `buildTrace()`（[W6-T1]，纯函数）从会话条目构建，TUI `/trace`、
+ *   `ama sessions trace`、RPC `get_trace` 三方共用；老会话（无 `ama.trace`）回退推算并标 `approx`。
+ */
+import type { Usage } from "../ai/types.js";
+export declare const TRACE_CUSTOM_TYPE = "ama.trace";
+/** `TraceEntryData.reason` 的最大长度（字符）。 */
+export declare const TRACE_REASON_MAX = 200;
+/** 一次工具调用的计时（顶层调用；`id` = toolCallId）。 */
+export interface TraceToolTiming {
+    id: string;
+    startedAt: number;
+    endedAt?: number;
+    /** 等审批的时长（`permission_request` → `permission_resolved`）。 */
+    approvalMs?: number;
+    /** 被拒（权限管线 / Hook / 审批 / 无人值守），没有执行。 */
+    denied?: boolean;
+}
+/** codemode 脚本里的内层调用（`parentId` = 外层 codemode 调用的 toolCallId）。 */
+export interface TraceSubcallTiming {
+    id: string;
+    parentId: string;
+    name: string;
+    startedAt: number;
+    endedAt?: number;
+    isError?: boolean;
+}
+/** 一次模型请求（成功、失败、被重试掉的都写一条）；写在该批 toolResult 之后（无工具时紧跟 assistant）。 */
+export interface TraceStepData {
+    kind: "step";
+    /** 该请求的 assistant 条目。 */
+    assistantEntryId?: string;
+    requestAt?: number;
+    firstTokenAt?: number;
+    doneAt?: number;
+    outputTokens?: number;
+    tps?: number;
+    /** 本周期内第几次尝试（1 起；重试 / 回退后递增）。 */
+    attempt: number;
+    /** 回退前的模型 `provider/model`。 */
+    fallbackFrom?: string;
+    /** 中断时 `agent_end` 兜底写入。 */
+    status?: "aborted";
+    tools?: TraceToolTiming[];
+    subcalls?: TraceSubcallTiming[];
+}
+export interface TraceRetryWaitData {
+    kind: "retry_wait";
+    /** 即将进行的尝试序号（2 起）。 */
+    attempt: number;
+    delayMs: number;
+    startedAt: number;
+    /** 失败原因（≤ 200 字符）。 */
+    reason?: string;
+}
+export interface TraceFallbackData {
+    kind: "fallback";
+    from: string;
+    to: string;
+    reason?: string;
+}
+export interface TraceCompactionData {
+    kind: "compaction";
+    trigger: "threshold" | "overflow" | "manual";
+    startedAt: number;
+    endedAt: number;
+    compactionEntryId?: string;
+    aborted?: boolean;
+}
+export interface TraceAuxData {
+    kind: "aux";
+    purpose: "cache_warm" | "permission_classify" | (string & {});
+    usageEntryId: string;
+    startedAt?: number;
+    endedAt: number;
+}
+/** 外部 Agent 工具的骨架：只有种类与状态，**不含标题 / 命令行 / 路径**。 */
+export interface TraceExternalTool {
+    kind: string;
+    status: "completed" | "failed" | "in_progress";
+    startedAt?: number;
+    endedAt?: number;
+}
+/** 外部 Agent 的一个回合（写在父会话，`taskId` 关联）。 */
+export interface TraceExternalTurnData {
+    kind: "external_turn";
+    taskId?: string;
+    agent: string;
+    sessionId: string;
+    turn: number;
+    startedAt: number;
+    endedAt: number;
+    stopReason: string;
+    tools: TraceExternalTool[];
+    toolCount: number;
+    filesTouched: number;
+}
+export type TraceEntryData = TraceStepData | TraceRetryWaitData | TraceFallbackData | TraceCompactionData | TraceAuxData | TraceExternalTurnData;
+export type TraceEntryKind = TraceEntryData["kind"];
+export type TraceNodeKind = "turn" | "step" | "tool" | "subcall" | "subagent" | "compaction" | "retry_wait" | "aux";
+export type TraceNodeStatus = "ok" | "error" | "aborted" | "denied" | "running" | "retried" | "interrupted";
+export interface TraceNodeBase {
+    /** turn = 用户消息 entryId；step = assistant entryId；tool = toolCallId；subagent = taskId。 */
+    id: string;
+    kind: TraceNodeKind;
+    startedAt?: number;
+    /** 进行中只有 startedAt，不编造时长。 */
+    endedAt?: number;
+    /** 时间来自回退推算（老会话 / 缺 ama.trace）。 */
+    approx?: boolean;
+    status: TraceNodeStatus;
+    /** 回到会话条目（详情、跳转用）。 */
+    entryIds: string[];
+}
+export interface TraceTotals {
+    requests: number;
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    cost?: number;
+    durationMs?: number;
+    toolCalls: number;
+    /** 只用非 approx 的 step。 */
+    ttftP50?: number;
+    ttftP90?: number;
+    avgTps?: number;
+    cacheHitRatio?: number;
+}
+export interface TraceTurnNode extends TraceNodeBase {
+    kind: "turn";
+    /** 用户消息的 origin（`steer` / `followUp` / `host` / `direct` …）。 */
+    origin?: string;
+    steps: (TraceStepNode | TraceCompactionNode | TraceRetryWaitNode)[];
+    usage: TraceTotals;
+}
+export interface TraceStepNode extends TraceNodeBase {
+    kind: "step";
+    provider: string;
+    model: string;
+    attempt: number;
+    fallbackFrom?: string;
+    requestAt?: number;
+    firstTokenAt?: number;
+    doneAt?: number;
+    ttftMs?: number;
+    tps?: number;
+    usage: Usage;
+    stopReason: string;
+    errorMessage?: string;
+    thinkingLevel?: string;
+    cacheHitRatio?: number;
+    tools: TraceToolNode[];
+}
+export interface TraceToolNode extends TraceNodeBase {
+    kind: "tool";
+    name: string;
+    isError: boolean;
+    approvalMs?: number;
+    denied?: boolean;
+    children: (TraceSubcallNode | TraceSubagentNode)[];
+}
+export interface TraceSubcallNode extends TraceNodeBase {
+    kind: "subcall";
+    name: string;
+    parentToolCallId: string;
+    isError: boolean;
+}
+export interface TraceExternalTurnNode extends Omit<TraceNodeBase, "kind"> {
+    kind: "external_turn";
+    turn: number;
+    stopReason: string;
+    tools: TraceExternalTool[];
+    toolCount: number;
+    filesTouched: number;
+}
+export interface TraceSubagentNode extends TraceNodeBase {
+    kind: "subagent";
+    taskId: string;
+    agent: string;
+    runner: string;
+    background: boolean;
+    usage?: Usage;
+    costUsd?: number;
+    turns?: number;
+    /** ama 子会话（懒加载，深度 ≤ 1）。 */
+    child?: Trace;
+    /** 外部 Agent 骨架。 */
+    external?: TraceExternalTurnNode[];
+    childRef?: {
+        sessionFile?: string;
+        sessionId: string;
+    };
+    /** 子会话文件缺失或损坏。 */
+    childMissing?: boolean;
+}
+export interface TraceCompactionNode extends TraceNodeBase {
+    kind: "compaction";
+    trigger?: "threshold" | "overflow" | "manual";
+    tokensBefore?: number;
+    tokensAfter?: number;
+}
+export interface TraceRetryWaitNode extends TraceNodeBase {
+    kind: "retry_wait";
+    attempt: number;
+    delayMs: number;
+    reason?: string;
+}
+export interface TraceAuxNode extends TraceNodeBase {
+    kind: "aux";
+    purpose: string;
+    usage?: Usage;
+}
+export interface Trace {
+    version: 1;
+    sessionId: string;
+    sessionFile?: string;
+    cwd: string;
+    startedAt: number;
+    endedAt?: number;
+    totals: TraceTotals;
+    turns: TraceTurnNode[];
+    /** cache_warm / permission_classify。 */
+    aux: TraceAuxNode[];
+    /** 有进行中节点。 */
+    partial: boolean;
+}
+/** `buildTrace` / `session.trace()` / RPC `get_trace` 的选项（[W6-T1] / [W6-T2] 实现）。 */
+export interface TraceOptions {
+    branch?: "leaf" | "all";
+    /** 注入当前时刻（确定性）。 */
+    now?: number;
+    /** 尾部优先的回合数上限。 */
+    turnLimit?: number;
+    /** 子任务的子轨迹。 */
+    taskId?: string;
+}

package/dist/trace/types.js

@@ -0,0 +1,13 @@
+/**
+ * 轨迹（docs/wave6-plan.md §2.1、§2.2、D5、D6）。[W6-C0] 纯类型，经 `@armadra/agent` 导出。
+ *
+ * 两部分：
+ * - **持久化**：`custom{customType:"ama.trace"}` 条目的 `data`（`TraceEntryData`），由
+ *   `agent/session-trace-writer.ts` 在事件发生后追加；不进上下文、不改请求字节、不改已落条目。
+ *   只记 id、时间与计数——**不含正文**（提示、参数、结果、外部 Agent 的工具标题 / 命令行 / 路径）。
+ * - **轨迹树**：`Trace`，由 `trace/build.ts` 的 `buildTrace()`（[W6-T1]，纯函数）从会话条目构建，TUI `/trace`、
+ *   `ama sessions trace`、RPC `get_trace` 三方共用；老会话（无 `ama.trace`）回退推算并标 `approx`。
+ */
+export const TRACE_CUSTOM_TYPE = "ama.trace";
+/** `TraceEntryData.reason` 的最大长度（字符）。 */
+export const TRACE_REASON_MAX = 200;

package/dist/tui/components/editor-paste.d.ts

@@ -5,6 +5,8 @@
  * - 换行规范化：`\r\n` / 单独的 `\r` → `\n`（括号粘贴里终端常把换行发成 `\r`）。
  * - 未折叠的粘贴把制表符换成 4 个空格（编辑器按列宽渲染，`\t` 没有确定宽度）；折叠内容保留原文。
  * - 标记只在本编辑器记录过的编号上展开；用户手打的同形文本不会被替换成别的内容。
+ * - [W6-C0] 标记按界面语言渲染（zh `[粘贴 #N · M 行]`、en `[paste #N · M lines]`）；识别同时认两种写法，
+ *   换了语言后历史草稿里的旧标记照样是不可分割段、照样展开。
  */
 export declare const PASTE_LINE_THRESHOLD = 10;
 export declare const PASTE_CHAR_THRESHOLD = 1000;

package/dist/tui/components/editor-paste.js

@@ -5,10 +5,13 @@
  * - 换行规范化：`\r\n` / 单独的 `\r` → `\n`（括号粘贴里终端常把换行发成 `\r`）。
  * - 未折叠的粘贴把制表符换成 4 个空格（编辑器按列宽渲染，`\t` 没有确定宽度）；折叠内容保留原文。
  * - 标记只在本编辑器记录过的编号上展开；用户手打的同形文本不会被替换成别的内容。
+ * - [W6-C0] 标记按界面语言渲染（zh `[粘贴 #N · M 行]`、en `[paste #N · M lines]`）；识别同时认两种写法，
+ *   换了语言后历史草稿里的旧标记照样是不可分割段、照样展开。
  */
+import { msg } from "../../i18n/index.js";
 export const PASTE_LINE_THRESHOLD = 10;
 export const PASTE_CHAR_THRESHOLD = 1000;
-const MARKER_RE = /\[粘贴 #(\d+) · (\d+) 行\]/g;
+const MARKER_RE = /\[(?:粘贴|paste) #(\d+) · (\d+) (?:行|lines?)\]/g;
 export function normalizePastedText(text) {
     return text.replace(/\r\n?/g, "\n");
 }
@@ -20,7 +23,7 @@ export function shouldCollapse(text) {
     return countLines(text) > PASTE_LINE_THRESHOLD || text.length > PASTE_CHAR_THRESHOLD;
 }
 export function formatMarker(id, lines) {
-    return `[粘贴 #${id} · ${lines} 行]`;
+    return msg().interactive.paste.marker(id, lines);
 }
 export class PasteStore {
     next = 1;
@@ -48,7 +51,7 @@ export class PasteStore {
     }
     /** 一行内已登记标记的区间（编辑器的不可分割段）。 */
     ranges(line) {
-        if (this.entries.size === 0 || !line.includes("[粘贴 #"))
+        if (this.entries.size === 0 || !(line.includes("[粘贴 #") || line.includes("[paste #")))
             return [];
         const out = [];
         for (const m of line.matchAll(MARKER_RE)) {

package/dist/tui/components/editor.js

@@ -13,6 +13,7 @@
  *   弹层缩进 2 列，尾行 `(i/n) Tab 接受 · Esc 关闭`。
  * - 历史：会话内 + 可选历史文件（JSONL，每行一个 JSON 字符串，保留最近 500 条）。
  */
+import { msg } from "../../i18n/index.js";
 import { CURSOR_MARKER } from "../component.js";
 import { truncateToWidth, visibleWidth } from "../ansi.js";
 import { defaultKeybindings } from "../keybindings.js";
@@ -26,7 +27,6 @@ export { loadHistoryFile } from "./editor-history.js";
 const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 /** 提示符 `› ` / 续行缩进的宽度。 */
 const PROMPT_WIDTH = 2;
-const COMPLETION_FOOTER = "Tab 接受 · Esc 关闭";
 export class Editor {
     options;
     focused = false;
@@ -351,7 +351,7 @@ export class Editor {
                 maxVisible: 8,
                 theme: this.theme,
                 keybindings: this.keys,
-                footer: COMPLETION_FOOTER,
+                footer: msg().interactive.editor.completionFooter,
                 showCount: true,
             }),
             from: result.from,

package/dist/tui/components/loader.d.ts

@@ -56,6 +56,9 @@ export declare class Loader implements Component {
     /** 已用时从现在重新算（换到另一段工作时）。 */
     resetElapsed(): void;
     start(): void;
+    private schedule;
+    /** [W6-S] 运行中切换动画（`/config ui.animation`）：换定时器间隔，已用时不清零。 */
+    setAnimation(on: boolean): void;
     stop(): void;
     /** 推进一帧（定时器调用；测试可直接调用）。静止时只在已用时变化时重绘。 */
     tick(): void;

package/dist/tui/components/loader.js

@@ -87,12 +87,26 @@ export class Loader {
             return;
         this.startedAt = this.now();
         this.frameIndex = 0;
+        this.schedule();
+        this.requestRender();
+    }
+    schedule() {
         const glyphs = this.options.theme?.glyphs ?? UNICODE_GLYPHS;
         const interval = this.animated
             ? (this.options.intervalMs ?? (glyphs.ascii ? 250 : 80))
             : Math.max(this.options.intervalMs ?? 1000, 1000);
         this.timer = setInterval(() => this.tick(), interval);
         this.timer.unref?.();
+    }
+    /** [W6-S] 运行中切换动画（`/config ui.animation`）：换定时器间隔，已用时不清零。 */
+    setAnimation(on) {
+        if (this.animated === on)
+            return;
+        this.options.animation = on;
+        if (this.timer === null)
+            return;
+        clearInterval(this.timer);
+        this.schedule();
         this.requestRender();
     }
     stop() {

package/dist/tui/components/select-list.d.ts

@@ -60,6 +60,8 @@ export declare class SelectList implements Component, Focusable {
     private get maxVisible();
     setItems(items: readonly SelectItem[]): void;
     getItems(): readonly SelectItem[];
+    /** 换列表下的按键提示（选择器切视图时）。 */
+    setFooter(footer: string | undefined): void;
     getFilter(): string;
     setFilter(filter: string): void;
     getSelected(): SelectItem | undefined;

package/dist/tui/components/select-list.js

@@ -52,6 +52,13 @@ export class SelectList {
     getItems() {
         return this.filtered;
     }
+    /** 换列表下的按键提示（选择器切视图时）。 */
+    setFooter(footer) {
+        if (footer === undefined)
+            delete this.options.footer;
+        else
+            this.options.footer = footer;
+    }
     getFilter() {
         return this.filter;
     }

package/dist/tui/components/settings-list.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Grouped settings list (docs/wave6-plan.md §6.3). [W6-S]
+ *
+ * Rows `› label  value  tag  note` under muted group headers; the selected row uses the prompt glyph,
+ * accent + bold and the `selection` background (same look as ChoiceDialog). A query filters rows by id,
+ * label, value and extra search text (case-insensitive); groups left without rows disappear. Only
+ * `maxVisible` lines (headers included) are drawn, scrolled so the selected row stays visible.
+ * Narrow widths drop the note column (< 60) and then the tag column (< 48).
+ *
+ * Input handling stays with the owner (the `/config` panel decides what Enter / Space do); this
+ * component only moves the selection and renders.
+ */
+import type { Component, SemanticColor, Theme } from "../component.js";
+export interface SettingsRow {
+    id: string;
+    /** Group header text; consecutive rows with the same group share one header. */
+    group: string;
+    label: string;
+    /** Already formatted value. */
+    value: string;
+    valueColor?: SemanticColor;
+    /** Short right column (apply tier). */
+    tag?: string;
+    /** Trailing note (source, lock reason). */
+    note?: string;
+    noteColor?: SemanticColor;
+    /** Not editable in the current scope: drawn dim. */
+    dim?: boolean;
+    /** Extra text the query matches (enum values, description). */
+    search?: string;
+}
+export interface SettingsListOptions {
+    theme: Theme;
+    /** Lines to draw (headers included); default 16. */
+    maxVisible?: number;
+    emptyText?: string;
+}
+export declare class SettingsList implements Component {
+    private readonly options;
+    private rows;
+    private shown;
+    private selected;
+    private top;
+    private filter;
+    constructor(options: SettingsListOptions);
+    set maxVisible(lines: number);
+    get query(): string;
+    /** Replace the rows, keeping the selection on the same id when possible. */
+    setRows(rows: readonly SettingsRow[]): void;
+    setQuery(query: string): void;
+    get selectedRow(): SettingsRow | undefined;
+    get visibleRows(): readonly SettingsRow[];
+    selectId(id: string): boolean;
+    /** Move by `delta` rows (wraps around). */
+    move(delta: number): void;
+    private refilter;
+    private lines;
+    render(width: number): string[];
+    private rowLine;
+    invalidate(): void;
+}

package/dist/tui/components/settings-list.js

@@ -0,0 +1,135 @@
+/**
+ * Grouped settings list (docs/wave6-plan.md §6.3). [W6-S]
+ *
+ * Rows `› label  value  tag  note` under muted group headers; the selected row uses the prompt glyph,
+ * accent + bold and the `selection` background (same look as ChoiceDialog). A query filters rows by id,
+ * label, value and extra search text (case-insensitive); groups left without rows disappear. Only
+ * `maxVisible` lines (headers included) are drawn, scrolled so the selected row stays visible.
+ * Narrow widths drop the note column (< 60) and then the tag column (< 48).
+ *
+ * Input handling stays with the owner (the `/config` panel decides what Enter / Space do); this
+ * component only moves the selection and renders.
+ */
+import { padToWidth, truncateToWidth, visibleWidth } from "../ansi.js";
+const LABEL_MAX = 24;
+const VALUE_MAX = 16;
+export class SettingsList {
+    options;
+    rows = [];
+    shown = [];
+    selected = 0;
+    top = 0;
+    filter = "";
+    constructor(options) {
+        this.options = options;
+    }
+    set maxVisible(lines) {
+        this.options.maxVisible = Math.max(3, lines);
+    }
+    get query() {
+        return this.filter;
+    }
+    /** Replace the rows, keeping the selection on the same id when possible. */
+    setRows(rows) {
+        const id = this.selectedRow?.id;
+        this.rows = rows;
+        this.refilter();
+        if (id !== undefined)
+            this.selectId(id);
+    }
+    setQuery(query) {
+        if (query === this.filter)
+            return;
+        const id = this.selectedRow?.id;
+        this.filter = query;
+        this.refilter();
+        this.selected = 0;
+        if (id !== undefined)
+            this.selectId(id);
+    }
+    get selectedRow() {
+        return this.shown[this.selected];
+    }
+    get visibleRows() {
+        return this.shown;
+    }
+    selectId(id) {
+        const index = this.shown.findIndex((row) => row.id === id);
+        if (index === -1)
+            return false;
+        this.selected = index;
+        return true;
+    }
+    /** Move by `delta` rows (wraps around). */
+    move(delta) {
+        const n = this.shown.length;
+        if (n === 0)
+            return;
+        this.selected = (((this.selected + delta) % n) + n) % n;
+    }
+    refilter() {
+        const q = this.filter.trim().toLowerCase();
+        this.shown =
+            q === ""
+                ? [...this.rows]
+                : this.rows.filter((row) => [row.id, row.label, row.value, row.search ?? ""].some((t) => t.toLowerCase().includes(q)));
+        if (this.selected >= this.shown.length)
+            this.selected = Math.max(0, this.shown.length - 1);
+    }
+    lines() {
+        const out = [];
+        let group;
+        this.shown.forEach((row, index) => {
+            if (row.group !== group) {
+                group = row.group;
+                out.push({ kind: "group", text: row.group });
+            }
+            out.push({ kind: "row", row, index });
+        });
+        return out;
+    }
+    render(width) {
+        const { theme } = this.options;
+        if (this.shown.length === 0)
+            return [theme.fg("dim", truncateToWidth(this.options.emptyText ?? "", width))];
+        const all = this.lines();
+        const max = this.options.maxVisible ?? 16;
+        const at = all.findIndex((l) => l.kind === "row" && l.index === this.selected);
+        // keep the selected row (and its group header when it is the first row of the group) in view
+        const anchor = at > 0 && all[at - 1].kind === "group" ? at - 1 : at;
+        if (anchor < this.top)
+            this.top = anchor;
+        if (at >= this.top + max)
+            this.top = at - max + 1;
+        this.top = Math.max(0, Math.min(this.top, Math.max(0, all.length - max)));
+        const window = all.slice(this.top, this.top + max);
+        // column widths from all rows: filtering does not make columns jump
+        const rows = this.rows;
+        // narrow terminals: label gets at most half the width, value what is left of the first two columns
+        const labelCap = Math.min(LABEL_MAX, Math.max(8, Math.floor((width - 4) / 2)));
+        const labelW = Math.min(labelCap, Math.max(...rows.map((r) => visibleWidth(r.label))));
+        const valueCap = Math.min(VALUE_MAX, Math.max(4, width - 4 - labelW));
+        const valueW = Math.min(valueCap, Math.max(...rows.map((r) => visibleWidth(r.value))));
+        const tagW = Math.max(0, ...rows.map((r) => visibleWidth(r.tag ?? "")));
+        return window.map((line) => line.kind === "group"
+            ? truncateToWidth(theme.fg("muted", theme.bold(line.text)), width)
+            : this.rowLine(line.row, line.index === this.selected, width, labelW, valueW, tagW));
+    }
+    rowLine(row, selected, width, labelW, valueW, tagW) {
+        const { theme } = this.options;
+        const pointer = selected ? theme.glyphs.prompt : " ";
+        const label = padToWidth(truncateToWidth(row.label, labelW), labelW);
+        const valueText = padToWidth(truncateToWidth(row.value, valueW), valueW);
+        const value = row.valueColor !== undefined ? theme.fg(row.valueColor, valueText) : valueText;
+        let line = `${pointer} ${selected ? theme.fg("accent", theme.bold(label)) : label}  ${value}`;
+        if (width >= 48 && tagW > 0)
+            line += `  ${theme.fg("dim", padToWidth(row.tag ?? "", tagW))}`;
+        if (width >= 60 && row.note !== undefined && row.note !== "")
+            line += `  ${theme.fg(row.noteColor ?? "dim", row.note)}`;
+        let out = truncateToWidth(line, width);
+        if (row.dim === true && !selected)
+            out = theme.dim(out);
+        return selected ? theme.bg("selection", padToWidth(out, width)) : out;
+    }
+    invalidate() { }
+}

package/dist/tui/keybindings.d.ts

@@ -44,6 +44,11 @@ export declare const DEFAULT_KEYBINDINGS: {
     readonly "app.statusLine.toggle": readonly ["ctrl+g"];
     /** [W5-U] 粘贴剪贴板图片（写进数据目录，输入框插入 `@路径`）。 */
     readonly "app.paste.image": readonly ["ctrl+v"];
+    /**
+     * [W6-A] 进入 Agent 栏：只在输入为空时生效（有字时 `Ctrl+B` 仍是光标左移、`↓` 仍是下移 / 历史）；
+     * `↓` 另要求栏可见。tmux 缺省前缀吃掉 `Ctrl+B` 时用 `↓`。
+     */
+    readonly "app.agents.focus": readonly ["ctrl+b", "down"];
 };
 export type ActionId = keyof typeof DEFAULT_KEYBINDINGS;
 export type KeybindingOverrides = Partial<Record<ActionId, readonly string[]>>;

package/dist/tui/keybindings.js

@@ -5,6 +5,7 @@
  * - 覆盖时整组替换；空数组表示禁用该动作。未知动作 id 与非字符串键会被报告并忽略。
  * - 文件位置由调用方决定（配置目录归 B5），这里只负责解析与合并。
  */
+import { msg } from "../i18n/index.js";
 import { readFileSync } from "node:fs";
 import { normalizeKeyId, parseKey } from "./keys.js";
 export const DEFAULT_KEYBINDINGS = {
@@ -46,6 +47,11 @@ export const DEFAULT_KEYBINDINGS = {
     "app.statusLine.toggle": ["ctrl+g"],
     /** [W5-U] 粘贴剪贴板图片（写进数据目录，输入框插入 `@路径`）。 */
     "app.paste.image": ["ctrl+v"],
+    /**
+     * [W6-A] 进入 Agent 栏：只在输入为空时生效（有字时 `Ctrl+B` 仍是光标左移、`↓` 仍是下移 / 历史）；
+     * `↓` 另要求栏可见。tmux 缺省前缀吃掉 `Ctrl+B` 时用 `↓`。
+     */
+    "app.agents.focus": ["ctrl+b", "down"],
 };
 export function isActionId(id) {
     return Object.prototype.hasOwnProperty.call(DEFAULT_KEYBINDINGS, id);
@@ -55,16 +61,16 @@ export function parseKeybindings(value) {
     const overrides = {};
     const warnings = [];
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return { overrides: {}, warnings: ["keybindings 必须是对象"] };
+        return { overrides: {}, warnings: [msg().interactive.keybindings.notObject] };
     }
     for (const [action, keys] of Object.entries(value)) {
         if (!isActionId(action)) {
-            warnings.push(`未知动作：${action}`);
+            warnings.push(msg().interactive.keybindings.unknownAction(action));
             continue;
         }
         const list = typeof keys === "string" ? [keys] : keys;
         if (!Array.isArray(list) || !list.every((k) => typeof k === "string")) {
-            warnings.push(`${action}：键必须是字符串或字符串数组`);
+            warnings.push(msg().interactive.keybindings.badKeys(action));
             continue;
         }
         overrides[action] = list.map((k) => normalizeKeyId(k));
@@ -80,13 +86,19 @@ export function loadKeybindingsFile(path) {
     catch (error) {
         if (error.code === "ENOENT")
             return { overrides: {}, warnings: [] };
-        return { overrides: {}, warnings: [`读取 ${path} 失败：${error.message}`] };
+        return {
+            overrides: {},
+            warnings: [msg().interactive.keybindings.readFailed(path, error.message)],
+        };
     }
     try {
         return parseKeybindings(JSON.parse(text));
     }
     catch (error) {
-        return { overrides: {}, warnings: [`${path} 不是合法 JSON：${error.message}`] };
+        return {
+            overrides: {},
+            warnings: [msg().interactive.keybindings.badJson(path, error.message)],
+        };
     }
 }
 export class Keybindings {

package/dist/tui.d.ts

@@ -30,3 +30,4 @@ export { Loader, LOADER_FRAMES, formatElapsed, type LoaderOptions, type LoaderVe
 export { compositeOverlays, type OverlayAnchor, type OverlayOptions, type OverlayLayer, } from "./tui/components/overlay.js";
 export { KeyValue, type KeyValueRow, type KeyValueOptions } from "./tui/components/key-value.js";
 export { Meter, METER_FULL, METER_EMPTY, type MeterOptions } from "./tui/components/meter.js";
+export { SettingsList, type SettingsRow, type SettingsListOptions, } from "./tui/components/settings-list.js";

package/dist/tui.js

@@ -31,3 +31,5 @@ export { compositeOverlays, } from "./tui/components/overlay.js";
 // ---- W3-B9a-2 组件 ----
 export { KeyValue } from "./tui/components/key-value.js";
 export { Meter, METER_FULL, METER_EMPTY } from "./tui/components/meter.js";
+// ---- W6-S 组件 ----
+export { SettingsList, } from "./tui/components/settings-list.js";