@armadra/agent 0.5.0 → 0.6.0

package/dist/modes/interactive/agent-view.js

@@ -0,0 +1,281 @@
+/**
+ * 子 Agent 视图（docs/wave6-plan.md §1.1–§1.2、D2、D3）。[W6-A]
+ *
+ * 主屏约束下的「全屏」：底部覆盖层，高度 = 终端行数 − 1（不切备用屏；撤掉覆盖层后消息区与回滚历史不变）。
+ *
+ * ```
+ * t2 explore · 运行中 1m05s · 3 轮 · ↑12k ↓3.4k · Esc 返回 · /tasks stop t2 停止
+ * <正文：ama 子会话的消息与工具 / 外部 Agent 的实时输出，跟随尾部>
+ * <一行提示：发送结果、已暂停跟随>
+ * ────────
+ * › 发给 t2
+ * ────────
+ * ```
+ *
+ * 按键：Enter 发给子 Agent（`registry.message`，留在视图）；输入为空时 Esc 返回、`←` `→` 切兄弟任务、
+ * `↑` / PgUp 上翻（暂停跟随）、`↓` / PgDn 下翻、End（暂停时也可 `f`）回到跟随；输入非空时 Esc 清空。
+ * Esc 不中断父会话，停止子任务用 `/tasks stop <id>`（视图里只认这一条命令）。
+ * 所查看的任务在等审批时标题显示「等待审批」，审批框照常以覆盖层弹在视图上面。
+ */
+import { msg } from "../../i18n/index.js";
+import { Editor, isPrintableText, parseKey, truncateToWidth, visibleWidth, } from "../../tui.js";
+import { formatTokenCount } from "../session-report.js";
+import { agentLabel, rowFacts, statusColor, taskRow } from "./agent-bar.js";
+import { AmaTranscript, ExternalTranscript, readBranch, } from "./agent-transcript.js";
+export class AgentView {
+    taskId;
+    deps;
+    editor;
+    body;
+    off;
+    follow = true;
+    /** 不跟随时正文窗口的首行。 */
+    top = 0;
+    lastBody = { total: 0, height: 0 };
+    flash;
+    notice;
+    _focused = false;
+    constructor(taskId, deps) {
+        this.taskId = taskId;
+        this.deps = deps;
+        this.editor = new Editor({
+            theme: deps.theme,
+            keybindings: deps.keys,
+            maxVisibleLines: 4,
+            placeholder: msg().agents.view.placeholder(taskId),
+            requestRender: () => deps.render(),
+            onSubmit: (text) => void this.submit(text),
+        });
+        this.attach();
+    }
+    get task() {
+        return this.taskId;
+    }
+    get focused() {
+        return this._focused;
+    }
+    set focused(value) {
+        this._focused = value;
+        this.editor.focused = value;
+    }
+    /** 接上任务的数据（打开、切兄弟任务、任务重新开跑）；任务不存在返回 false。 */
+    attach() {
+        this.off?.();
+        this.off = undefined;
+        this.notice = undefined;
+        const registry = this.deps.registry();
+        const live = registry?.live(this.taskId);
+        if (registry === undefined || live === undefined) {
+            this.body = undefined;
+            return false;
+        }
+        const info = live.info;
+        if (info.runner !== "ama") {
+            const taskId = this.taskId;
+            const source = {
+                events: () => registry.live(taskId)?.recent ?? [],
+                running: () => registry.get(taskId)?.status === "running",
+                runner: info.runner,
+                ...(info.sessionRef?.sessionId !== undefined
+                    ? { sessionId: info.sessionRef.sessionId }
+                    : {}),
+            };
+            this.body = new ExternalTranscript(this.deps.theme, source);
+            return true;
+        }
+        const body = new AmaTranscript({
+            theme: this.deps.theme,
+            ...this.deps.messages,
+            now: this.deps.now,
+        });
+        this.body = body;
+        if (live.entries !== undefined) {
+            body.load(live.entries());
+            this.off = live.observe?.((event) => {
+                if (body.onEvent(event))
+                    this.deps.render();
+            });
+            return true;
+        }
+        const file = info.sessionRef?.sessionFile;
+        if (file === undefined) {
+            this.notice = msg().agents.view.noTranscript;
+            return true;
+        }
+        try {
+            body.load(readBranch(file));
+        }
+        catch (error) {
+            this.notice = msg().agents.view.loadFailed(error instanceof Error ? error.message : String(error));
+        }
+        return true;
+    }
+    dispose() {
+        this.off?.();
+        this.off = undefined;
+    }
+    /** 每秒：运行中的工具重画耗时。 */
+    tick() {
+        if (this.body instanceof AmaTranscript)
+            this.body.tick();
+    }
+    switchTo(delta) {
+        const list = this.deps.siblings();
+        const at = list.indexOf(this.taskId);
+        if (list.length < 2 || at < 0)
+            return;
+        const next = list[(at + delta + list.length) % list.length];
+        this.dispose();
+        this.taskId = next;
+        this.follow = true;
+        this.top = 0;
+        this.flash = undefined;
+        this.editor.clear();
+        this.attach();
+        this.deps.onSwitch?.(next);
+    }
+    async submit(text) {
+        const m = msg().agents.view;
+        const trimmed = text.trim();
+        if (trimmed === "")
+            return;
+        const taskId = this.taskId;
+        if (trimmed.startsWith("/")) {
+            const stop = /^\/tasks\s+stop(?:\s+(\S+))?\s*$/.exec(trimmed);
+            if (stop === null)
+                this.flash = m.commandsHere;
+            else {
+                const target = stop[1] ?? taskId;
+                try {
+                    await this.deps.stop(target);
+                    this.flash = m.stopped(target);
+                }
+                catch (error) {
+                    this.flash = error instanceof Error ? error.message : String(error);
+                }
+            }
+            this.deps.render();
+            return;
+        }
+        const registry = this.deps.registry();
+        try {
+            if (registry === undefined)
+                throw new Error(m.unknown(taskId));
+            const reply = await registry.message(taskId, text);
+            this.flash = m[reply](taskId);
+        }
+        catch (error) {
+            this.flash = m.sendFailed(error instanceof Error ? error.message : String(error));
+        }
+        this.follow = true;
+        this.deps.render();
+    }
+    handleInput(data) {
+        const keys = this.deps.keys;
+        const empty = this.editor.isEmpty();
+        const id = parseKey(data)?.id;
+        this.flash = undefined;
+        if (keys.matches(data, "tui.select.cancel") && !this.editor.isCompletionOpen) {
+            if (!empty)
+                this.editor.clear();
+            else
+                this.deps.close();
+            return;
+        }
+        if (empty) {
+            if (id === "left" || id === "right")
+                return this.switchTo(id === "left" ? -1 : 1);
+            const page = Math.max(1, this.lastBody.height - 1);
+            if (id === "up" || id === "pageup")
+                return this.scroll(id === "up" ? -1 : -page);
+            if (id === "down" || id === "pagedown")
+                return this.scroll(id === "down" ? 1 : page);
+            if (id === "end" || (id === "f" && !this.follow && isPrintableText(data))) {
+                this.follow = true;
+                return;
+            }
+        }
+        this.editor.handleInput(data);
+    }
+    scroll(delta) {
+        const { total, height } = this.lastBody;
+        const bottom = Math.max(0, total - height);
+        const from = this.follow ? bottom : this.top;
+        const next = Math.max(0, Math.min(bottom, from + delta));
+        if (delta > 0 && next >= bottom) {
+            this.follow = true;
+            return;
+        }
+        this.follow = false;
+        this.top = next;
+    }
+    title(width) {
+        const t = this.deps.theme;
+        const m = msg().agents.view;
+        const registry = this.deps.registry();
+        const info = registry?.get(this.taskId);
+        if (info === undefined)
+            return truncateToWidth(t.bold(this.taskId), width);
+        const row = taskRow(info, {
+            tracker: this.deps.tracker,
+            approvals: this.deps.approvals(),
+            queued: registry?.live(this.taskId)?.queued === true,
+            now: this.deps.now(),
+        });
+        const g = t.glyphs;
+        const usage = this.deps.tracker.get(this.taskId)?.usage ?? info.usage;
+        const tokens = usage !== undefined && usage.input + usage.output + usage.cacheRead > 0
+            ? `${g.arrowUp}${formatTokenCount(usage.input + usage.cacheRead + usage.cacheWrite)} ${g.arrowDown}${formatTokenCount(usage.output)}`
+            : undefined;
+        const stop = info.status === "running" ? m.stopHint(this.taskId) : undefined;
+        const compose = (withTokens, withStop) => {
+            const facts = [rowFacts(row, false), ...(withTokens && tokens ? [tokens] : [])];
+            const hints = [m.back, ...(withStop && stop ? [stop] : [])];
+            return (t.bold(`${this.taskId} ${agentLabel(row)}`) +
+                t.fg("dim", " · ") +
+                t.fg(statusColor(row.status), facts.join(" · ")) +
+                t.fg("dim", ` · ${hints.join(" · ")}`));
+        };
+        // 窄屏先丢用量、再丢停止提示，「Esc 返回」尽量留着
+        for (const [withTokens, withStop] of [
+            [true, true],
+            [false, true],
+            [false, false],
+        ]) {
+            const text = compose(withTokens, withStop);
+            if (visibleWidth(text) <= width)
+                return text;
+        }
+        return truncateToWidth(compose(false, false), width, g.ellipsis);
+    }
+    render(width) {
+        const t = this.deps.theme;
+        const height = Math.max(5, this.deps.rows() - 1);
+        const title = this.title(width);
+        const input = this.editor.render(width);
+        const footer = this.flash ?? (this.follow ? undefined : msg().agents.view.paused);
+        const bodyHeight = Math.max(1, height - 1 - input.length - (footer === undefined ? 0 : 1));
+        let lines = this.body?.render(width) ?? [];
+        if (this.notice !== undefined)
+            lines = [t.fg("warning", this.notice), "", ...lines];
+        const total = lines.length;
+        this.lastBody = { total, height: bodyHeight };
+        const bottom = Math.max(0, total - bodyHeight);
+        if (this.follow)
+            this.top = bottom;
+        else
+            this.top = Math.min(this.top, bottom);
+        const shown = lines.slice(this.top, this.top + bodyHeight);
+        while (shown.length < bodyHeight)
+            shown.push("");
+        const out = [title, ...shown];
+        if (footer !== undefined)
+            out.push(truncateToWidth(t.fg("dim", footer), width, t.glyphs.ellipsis));
+        out.push(...input);
+        return out.slice(0, height);
+    }
+    invalidate() {
+        this.body?.invalidate();
+        this.editor.invalidate();
+    }
+}

package/dist/modes/interactive/approval-dialog.js

@@ -21,7 +21,8 @@
  *
  * broker 链本身串行化审批，所以同一时刻最多一个对话框。
  */
-import { AUTO_LAYER_TEXT, isPermissionMode, permissionModeLabel } from "../../permissions/modes.js";
+import { msg } from "../../i18n/index.js";
+import { autoLayerText, isPermissionMode, permissionModeLabel } from "../../permissions/modes.js";
 import { previewDisplayLines } from "../../permissions/preview.js";
 import { Box, defaultKeybindings, matchesKey, padToWidth, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "../../tui.js";
 import { displayPath, flat } from "./tool-summary.js";
@@ -47,7 +48,7 @@ export function sourceLabel(request, taskAgent) {
     const context = request.context;
     const origin = context?.origin;
     if (origin !== undefined)
-        return `[${origin.agent} · 会话 ${origin.sessionId.slice(0, 8)}]`;
+        return msg().approval.originLabel(origin.agent, origin.sessionId.slice(0, 8));
     if ((context?.depth ?? 0) <= 0)
         return undefined;
     const taskId = context?.taskId;
@@ -57,13 +58,14 @@ export function sourceLabel(request, taskAgent) {
 /** 原因 → 标题文字（带来源标注）。 */
 export function approvalTitle(request, taskAgent) {
     const label = sourceLabel(request, taskAgent);
+    const t = msg().approval.title;
     const reason = isFirstRunRequest(request)
-        ? "首次运行外部 Agent"
+        ? t.firstRun
         : request.reason === "dangerous"
-            ? "危险命令"
+            ? t.dangerous
             : request.reason === "hook"
-                ? "Hook 要求确认"
-                : "需要确认";
+                ? t.hook
+                : t.confirm;
     return label === undefined ? reason : `${label} ${reason}`;
 }
 /** 外部 Agent 请求的正文：标题 + 种类、涉及路径、输入摘要。 */
@@ -73,30 +75,31 @@ function originLines(origin, theme, cwd) {
         out.push(theme.fg("muted", displayPath(path, cwd)));
     const hidden = (origin.toolCall.locations?.length ?? 0) - 3;
     if (hidden > 0)
-        out.push(theme.fg("dim", `… 另 ${hidden} 个路径`));
+        out.push(theme.fg("dim", msg().approval.morePaths(hidden)));
     const summary = origin.toolCall.inputSummary;
     if (summary !== undefined && summary.trim() !== "") {
         const { shown, hidden: more } = lines(summary, COMMAND_LINES);
         out.push(...shown.map((l) => theme.fg("code", l)));
         if (more > 0)
-            out.push(theme.fg("dim", `… 另 ${more} 行`));
+            out.push(theme.fg("dim", msg().approval.moreLines(more)));
     }
     return out;
 }
 /** 对话框正文（不含选项与按键行）。 */
 export function describeRequest(request, theme, options = {}) {
+    const m = msg().approval;
     const out = [];
     const label = sourceLabel(request, options.taskAgent);
     const task = label === undefined ? "" : theme.fg("warning", `${label} `);
     const origin = request.context?.origin;
     const firstRun = isFirstRunRequest(request);
     const tag = request.reason === "dangerous"
-        ? theme.fg("error", "危险命令")
+        ? theme.fg("error", m.tag.dangerous)
         : request.reason === "hook"
-            ? theme.fg("warning", "Hook 要求确认")
+            ? theme.fg("warning", m.tag.hook)
             : origin !== undefined
                 ? theme.fg("dim", origin.toolCall.kind)
-                : theme.fg("dim", firstRun ? "首次运行" : "需要确认");
+                : theme.fg("dim", firstRun ? m.tag.firstRun : m.tag.confirm);
     const input = record(request.input);
     const name = origin !== undefined
         ? theme.bold(theme.fg("tool", flat(origin.toolCall.title)))
@@ -104,7 +107,7 @@ export function describeRequest(request, theme, options = {}) {
             ? theme.bold(theme.fg("tool", `task ${String(input["agent"] ?? "")}`.trim()))
             : theme.bold(theme.fg("tool", request.toolName));
     out.push(options.compact === true ? `${task}${name}` : `${task}${name}  ${tag}`);
-    const more = (n) => theme.fg("dim", `… 另 ${n} 行（v 查看）`);
+    const more = (n) => theme.fg("dim", m.moreLinesView(n));
     if (origin !== undefined && options.expanded !== true) {
         out.push(...originLines(origin, theme, options.cwd));
     }
@@ -112,14 +115,14 @@ export function describeRequest(request, theme, options = {}) {
         out.push(String(input["note"]));
         const mode = input["mode"];
         if (typeof mode === "string")
-            out.push(theme.fg("dim", `模式 ${isPermissionMode(mode) ? permissionModeLabel(mode) : mode}`));
+            out.push(theme.fg("dim", m.firstRunMode(isPermissionMode(mode) ? permissionModeLabel(mode) : mode)));
     }
     else if (options.expanded === true) {
         const json = JSON.stringify(request.input, null, 2) ?? String(request.input);
         const { shown, hidden } = lines(json, FULL_INPUT_LINES);
         out.push(...shown.map((l) => theme.fg("code", l)));
         if (hidden > 0)
-            out.push(theme.fg("dim", `… 另 ${hidden} 行`));
+            out.push(theme.fg("dim", m.moreLines(hidden)));
     }
     else if (request.toolName === "bash" && typeof input["command"] === "string") {
         const { shown, hidden } = lines(input["command"], COMMAND_LINES);
@@ -129,11 +132,11 @@ export function describeRequest(request, theme, options = {}) {
     }
     else if (request.toolName === "write" && typeof input["content"] === "string") {
         const count = lines(input["content"], Number.MAX_SAFE_INTEGER).shown.length;
-        out.push(`${toolSummary("write", input, options.cwd)}  ${theme.fg("dim", `写入 ${count} 行`)}`);
+        out.push(`${toolSummary("write", input, options.cwd)}  ${theme.fg("dim", m.writeLines(count))}`);
     }
     else if (request.toolName === "edit" && Array.isArray(input["edits"])) {
         const edits = input["edits"];
-        out.push(`${toolSummary("edit", input, options.cwd)}  ${theme.fg("dim", `${edits.length} 处修改`)}`);
+        out.push(`${toolSummary("edit", input, options.cwd)}  ${theme.fg("dim", m.editCount(edits.length))}`);
         for (const edit of edits.slice(0, 2)) {
             for (const [sign, text, color] of [
                 ["-", edit.oldText, "error"],
@@ -148,7 +151,7 @@ export function describeRequest(request, theme, options = {}) {
             }
         }
         if (edits.length > 2)
-            out.push(theme.fg("dim", `… 另 ${edits.length - 2} 处`));
+            out.push(theme.fg("dim", m.moreEdits(edits.length - 2)));
     }
     else {
         const summary = toolSummary(request.toolName, input, options.cwd);
@@ -160,7 +163,7 @@ export function describeRequest(request, theme, options = {}) {
             : undefined;
         // 与首次运行确认合并（approval-merge.ts）：允许即同意本会话以你的登录运行该 CLI
         if (runner !== undefined)
-            out.push(theme.fg("warning", `外部 Agent ${agent}：以你在 ${runner} CLI 的登录运行（含本会话首次运行确认）`));
+            out.push(theme.fg("warning", m.externalRunner(String(agent), runner)));
     }
     const severity = request.preview?.severity;
     const color = severity === "danger" ? "error" : severity === "warn" ? "warning" : "dim";
@@ -169,30 +172,40 @@ export function describeRequest(request, theme, options = {}) {
     if (origin !== undefined || firstRun) {
         // 外部 Agent 的请求由它自己的策略决定要问；首次运行确认的说明已在正文
         if (origin !== undefined)
-            out.push(theme.fg("dim", `${origin.agent} 请求确认`));
+            out.push(theme.fg("dim", m.originAsks(origin.agent)));
         else
-            out.push(theme.fg("dim", "本会话首次以你的登录运行该 CLI"));
+            out.push(theme.fg("dim", m.firstRunLogin));
     }
     else if (request.reason === "hook") {
-        out.push(theme.fg("warning", `Hook：${request.hookReason ?? "（无说明）"}`));
+        out.push(theme.fg("warning", m.hookReason(request.hookReason)));
     }
     else if (request.reason === "dangerous") {
-        out.push(theme.fg("error", "这条命令可能有破坏性，请确认"));
+        out.push(theme.fg("error", m.dangerousWarn));
     }
     else if (auto !== undefined) {
-        out.push(theme.fg("warning", `Auto ${AUTO_LAYER_TEXT[auto.layer]}：${auto.reason}`));
+        out.push(theme.fg("warning", m.autoReason(autoLayerText(auto.layer), auto.reason)));
     }
     else if (options.permissionMode !== undefined) {
         const mode = options.permissionMode;
         const label = isPermissionMode(mode) ? permissionModeLabel(mode) : mode;
-        out.push(theme.fg("dim", `权限模式 ${label} 下需要确认`));
+        out.push(theme.fg("dim", m.modeNeedsConfirm(label)));
     }
     return out;
 }
+/** 选项文字随界面语言（取用时求值）。 */
+function option(decision, key, keys) {
+    return {
+        decision,
+        keys,
+        get label() {
+            return msg().approval.option[key];
+        },
+    };
+}
 export const APPROVAL_OPTIONS = [
-    { decision: "allow", label: "允许", keys: "y" },
-    { decision: "allow_session", label: "本会话允许同类", keys: "a" },
-    { decision: "deny", label: "拒绝", keys: "n Esc" },
+    option("allow", "allow", "y"),
+    option("allow_session", "allowSession", "a"),
+    option("deny", "deny", "n Esc"),
 ];
 /** 宽度低于它（Box 外宽）时用紧凑布局。 */
 const COMPACT_WIDTH = 56;
@@ -266,9 +279,7 @@ class ApprovalDialog {
         if (!compact)
             lines.push("");
         const arrows = theme.glyphs.arrowUp + theme.glyphs.arrowDown;
-        const hint = compact
-            ? `${arrows} Enter · v 完整输入`
-            : `${arrows} 选择 · Enter 确认 · v 完整输入`;
+        const hint = compact ? msg().approval.hintCompact(arrows) : msg().approval.hint(arrows);
         lines.push(theme.fg("dim", hint));
         return lines.map((l) => truncateToWidth(l, width));
     }
@@ -346,14 +357,15 @@ export function approvalOutcomeText(request, outcome, taskAgent) {
     const origin = request.context?.origin;
     const tool = origin !== undefined ? flat(origin.toolCall.title, 60) : request.toolName;
     const what = `${label === undefined ? "" : `${label} `}${tool}`;
+    const m = msg().approval.outcome;
     switch (outcome) {
         case "allow":
-            return `已允许 ${what}`;
+            return m.allow(what);
         case "allow_session":
-            return `已允许 ${what}（本会话同类不再询问）`;
+            return m.allowSession(what);
         case "deny":
-            return `已拒绝 ${what}`;
+            return m.deny(what);
         case "cancelled":
-            return `审批已取消（超时或中断）：${what}`;
+            return m.cancelled(what);
     }
 }

package/dist/modes/interactive/clipboard-paste.d.ts

@@ -11,8 +11,8 @@ export type PasteOutcome = {
     ok: false;
     message: string;
 };
-export declare const NO_CLIPBOARD_TOOL = "\u8BFB\u4E0D\u4E86\u526A\u8D34\u677F\u56FE\u7247\uFF1A\u6CA1\u6709\u53EF\u7528\u7684\u7CFB\u7EDF\u547D\u4EE4\uFF08macOS osascript / pngpaste\uFF0CLinux wl-paste / xclip\uFF0CWindows PowerShell\uFF09";
-export declare const NO_CLIPBOARD_IMAGE = "\u526A\u8D34\u677F\u91CC\u6CA1\u6709\u56FE\u7247";
+export declare function noClipboardTool(): string;
+export declare function noClipboardImage(): string;
 /** `@路径`；路径带空白时加引号。 */
 export declare function imageRef(path: string): string;
 export declare function pasteImage(dataDir: string, deps?: ClipboardDeps): Promise<PasteOutcome>;

package/dist/modes/interactive/clipboard-paste.js

@@ -2,9 +2,14 @@
  * `Ctrl+V` 与 `/paste`：剪贴板图片写进 `<dataDir>/clipboard/`，输入框插入 `@<路径>`（发送时按 `@图片`
  * 附件读取）。[W5-U] 读取本身在 tools/clipboard-image.ts（W5-I）。
  */
+import { msg } from "../../i18n/index.js";
 import { readClipboardImage } from "../../tools/clipboard-image.js";
-export const NO_CLIPBOARD_TOOL = "读不了剪贴板图片：没有可用的系统命令（macOS osascript / pngpaste，Linux wl-paste / xclip，Windows PowerShell）";
-export const NO_CLIPBOARD_IMAGE = "剪贴板里没有图片";
+export function noClipboardTool() {
+    return msg().interactive.clipboard.noTool;
+}
+export function noClipboardImage() {
+    return msg().interactive.clipboard.noImage;
+}
 /** `@路径`；路径带空白时加引号。 */
 export function imageRef(path) {
     return /\s/.test(path) ? `@"${path}"` : `@${path}`;
@@ -16,13 +21,13 @@ export async function pasteImage(dataDir, deps) {
             return { ok: true, ref: imageRef(result.path), path: result.path };
         return {
             ok: false,
-            message: result.reason === "no_tool" ? NO_CLIPBOARD_TOOL : NO_CLIPBOARD_IMAGE,
+            message: result.reason === "no_tool" ? noClipboardTool() : noClipboardImage(),
         };
     }
     catch (error) {
         return {
             ok: false,
-            message: `读取剪贴板失败：${error instanceof Error ? error.message : String(error)}`,
+            message: msg().interactive.clipboard.failed(error instanceof Error ? error.message : String(error)),
         };
     }
 }

package/dist/modes/interactive/commands.d.ts

@@ -10,10 +10,14 @@
  * - `/rewind`（无参数）打开回滚列表与确认面板（rewind-flow.ts）；带参数走 commands-core，对话变了时
  *   重画消息区并回填原消息。
  * - 不是命令（含模板与 `/skill:`）返回 false，调用方把整行当提示发出。
+ * - [W6-C0] 面板钩子：`/config`（W6-S）、`/trace`（W6-T1）、`/memory`（W6-M）按 `PANEL_COMMANDS` 表分派到
+ *   `CommandUi` 的可选钩子；`/tasks` 无参在有 `agentBar` 时聚焦 Agent 栏、`/tasks <id>` 在有 `agentView` 时
+ *   直接进子 Agent 视图（W6-A）。钩子没装时回落 commands-core（line 模式同一套文本）。
  */
 import type { AgentSession, RewindDraftText } from "../../agent/types.js";
 import type { SwitchRequest } from "../../cli/compose-session.js";
 import type { Runtime } from "../../cli/runtime.js";
+import type { PermissionMode } from "../../permissions/types.js";
 import type { Component, SelectItem, Theme } from "../../tui.js";
 import { type CommandInfo } from "../commands-core.js";
 import { type NoticeLevel } from "./message-view.js";
@@ -21,7 +25,8 @@ import { type PickerSpec } from "./pickers.js";
 export declare const INTERACTIVE_COMMANDS: readonly CommandInfo[];
 /** 补全与 /help 用的完整命令表。 */
 export declare const ALL_COMMANDS: readonly CommandInfo[];
-export declare const KEY_HINTS: string;
+/** `/help` 末尾的按键说明（多行）。 */
+export declare function keyHints(): string;
 export interface CommandUi {
     readonly runtime: Runtime;
     session(): AgentSession;
@@ -48,9 +53,25 @@ export interface CommandUi {
     home?: string;
     /** 进程环境：给出时 /model 选择器按 fake-visibility 规则藏起测试供应商 fake。 */
     env?: Readonly<Record<string, string | undefined>>;
+    /** 切换权限模式前的确认（进入 Bypass 前弹确认框）；返回 false 保持原模式。 */
+    confirmMode?(mode: PermissionMode): boolean | Promise<boolean>;
     /** [W5-U] 界面自己处理的第五波命令（agent-ui.ts）；处理了返回 true。 */
     extra?(name: string, args: string): Promise<boolean>;
+    /** [W6-C0] 聚焦 Agent 栏（W6-A；`/tasks` 无参）。 */
+    agentBar?(): void | Promise<void>;
+    /** [W6-C0] 打开某任务的子 Agent 视图（W6-A；`/tasks <id>`）。 */
+    agentView?(taskId: string): void | Promise<void>;
+    /** [W6-C0] 轨迹覆盖层（W6-T1；`/trace [任务 id]`）。 */
+    traceView?(taskId?: string): void | Promise<void>;
+    /** [W6-C0] 记忆面板 / 子命令（W6-M；`/memory …`）。 */
+    memoryPanel?(args: string): void | Promise<void>;
+    /** [W6-C0] 设置面板（W6-S；`/config`，`/config key=value` 直接设一项）。 */
+    configPanel?(args: string): void | Promise<void>;
 }
+/**
+ * [W6-C0] 面板类命令 → `CommandUi` 钩子。钩子存在就调用并返回 true；不存在返回 false（回落 commands-core）。
+ */
+export declare const PANEL_COMMANDS: Readonly<Record<string, (ui: CommandUi, args: string) => Promise<boolean>>>;
 /** 当前分支上的条目 id（树选择器标 ●）。 */
 export declare function activeBranchIds(session: AgentSession): Set<string>;
 export declare function permissionsText(runtime: Runtime, session: AgentSession): string;