@armadra/agent 0.5.0 → 0.6.0

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

@@ -0,0 +1,191 @@
+/**
+ * 子 Agent 视图的正文（docs/wave6-plan.md §1.2、D2）。[W6-A]
+ *
+ * - `AmaTranscript`：ama 子会话的全量消息，复用消息区的 `MessageView` / `ToolTracker` 渲染；先按条目重放
+ *   （句柄在内存时读 `entries()`，被 LRU 释放或 resume 后只读加载子会话文件），运行中再跟随子会话事件。
+ *   视图里直接发的消息（`origin:"direct"`）按普通用户消息显示——在这里就是人发给它的。
+ * - `ExternalTranscript`：外部 Agent 的内存环形缓冲（文本、思考、工具起止、回合、notice）；重启后缓冲为空，
+ *   只给一行「用原 CLI resume」的说明。
+ */
+import { entryToMessage } from "../../session/projection.js";
+import { readSessionReadOnly } from "../../session/scan.js";
+import { indexEntries, pathToRoot } from "../../session/tree.js";
+import { wrapTextWithAnsi } from "../../tui.js";
+import { msg } from "../../i18n/index.js";
+import { MessageView } from "./message-view.js";
+import { ToolTracker } from "./tool-view.js";
+/** 视图里人发的消息按普通用户消息显示。 */
+function shown(message) {
+    if (message.role === "user" && message.origin === "direct") {
+        const { origin: _direct, ...rest } = message;
+        return rest;
+    }
+    return message;
+}
+/** 只读读子会话文件当前分支的条目。 */
+export function readBranch(file) {
+    const session = readSessionReadOnly(file);
+    return pathToRoot(indexEntries(session.entries), session.leaf);
+}
+export class AmaTranscript {
+    options;
+    view;
+    tools;
+    constructor(options) {
+        this.options = options;
+        this.view = new MessageView(options);
+        this.tools = new ToolTracker({
+            theme: options.theme,
+            now: options.now,
+            ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+        });
+    }
+    get isEmpty() {
+        return this.view.blockCount === 0;
+    }
+    /** 按条目重画（打开视图、重新接上句柄）。 */
+    load(entries) {
+        this.view.reset();
+        this.tools.clear();
+        const messages = [];
+        for (const entry of entries) {
+            const message = entryToMessage(entry);
+            if (message !== undefined)
+                messages.push(shown(message));
+        }
+        this.view.replay(messages, {
+            tool: (call, result) => {
+                if (result === undefined)
+                    return this.tools.start({
+                        toolCallId: call.id,
+                        toolName: call.name,
+                        args: call.arguments,
+                    }).view;
+                return this.tools.completed(call.id, call.name, call.arguments, {
+                    content: result.content,
+                    isError: result.isError,
+                    ...(result.details !== undefined ? { details: result.details } : {}),
+                }, result.isError);
+            },
+        });
+    }
+    /** 子会话事件；返回 true 表示内容变了。 */
+    onEvent(event) {
+        switch (event.type) {
+            case "message_start": {
+                const message = event.message;
+                if (message.role === "user")
+                    this.view.addUser(shown(message));
+                else if (message.role === "assistant")
+                    this.view.startAssistant(message);
+                else
+                    return false;
+                return true;
+            }
+            case "message_update":
+                this.view.updateAssistant(event.message);
+                return true;
+            case "message_end":
+                if (event.message.role !== "assistant")
+                    return false;
+                this.view.endAssistant(event.message);
+                return true;
+            case "tool_execution_start": {
+                const started = this.tools.start(event);
+                if (started.topLevel)
+                    this.view.addTool(started.view);
+                return true;
+            }
+            case "tool_execution_update":
+                this.tools.update(event.toolCallId, event.partial);
+                return true;
+            case "tool_execution_end":
+                this.tools.end(event.toolCallId, event.result, event.isError);
+                return true;
+            default:
+                return false;
+        }
+    }
+    tick() {
+        this.tools.tick();
+    }
+    render(width) {
+        return this.view.render(width);
+    }
+    invalidate() {
+        this.view.invalidate();
+    }
+}
+export class ExternalTranscript {
+    theme;
+    source;
+    constructor(theme, source) {
+        this.theme = theme;
+        this.source = source;
+    }
+    get isEmpty() {
+        return this.source.events().length === 0;
+    }
+    render(width) {
+        const t = this.theme;
+        const g = t.glyphs;
+        const m = msg().agents.view;
+        const events = this.source.events();
+        if (events.length === 0) {
+            const text = this.source.running()
+                ? m.waiting
+                : this.source.sessionId !== undefined
+                    ? m.externalGone(this.source.runner, this.source.sessionId)
+                    : m.externalNoSession(this.source.runner);
+            return wrapTextWithAnsi(t.fg("dim", text), width);
+        }
+        // 工具：started 与随后同 id 的结束合成一行
+        const ended = new Map();
+        for (const e of events)
+            if (e.kind === "tool" && e.toolId !== undefined && e.status !== "started")
+                ended.set(e.toolId, e.status);
+        const out = [];
+        let last;
+        const block = (lines) => {
+            if (out.length > 0)
+                out.push("");
+            out.push(...lines);
+        };
+        for (const e of events) {
+            if (e.kind === "tool" && e.status !== "started" && e.toolId !== undefined)
+                continue;
+            switch (e.kind) {
+                case "text":
+                    block(wrapTextWithAnsi((e.text ?? "").trim(), width));
+                    break;
+                case "thought":
+                    block(wrapTextWithAnsi(t.fg("dim", `${g.thinking} ${(e.text ?? "").trim()}`), width));
+                    break;
+                case "tool": {
+                    const status = e.toolId !== undefined ? ended.get(e.toolId) : e.status;
+                    const mark = status === "completed"
+                        ? t.fg("success", g.ok)
+                        : status === "failed"
+                            ? t.fg("error", g.fail)
+                            : t.fg("dim", g.spinnerStatic);
+                    const line = `${t.fg("tool", g.tool)} ${e.toolName ?? ""} ${mark}`;
+                    // 相邻的工具行不空行
+                    if (last === "tool")
+                        out.push(line);
+                    else
+                        block([line]);
+                    break;
+                }
+                case "turn":
+                    block([t.fg("dim", `${g.rule.repeat(2)} ${m.turn(e.turn ?? 0)}`)]);
+                    break;
+                case "notice":
+                    block(wrapTextWithAnsi(t.fg(e.level === "warn" ? "warning" : "dim", e.text ?? ""), width));
+                    break;
+            }
+            last = e.kind;
+        }
+        return out;
+    }
+    invalidate() { }
+}

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

@@ -11,11 +11,21 @@
  *
  * 外部 Agent 的 notice（W5-E runner 的 `{type:"notice"}`）由任务注册表写进会话日志（`[task tN] …`），没有
  * 事件；这里在会话的 `options.log` 外面套一层，只把这类行转到消息区，其余照原样写日志。
+ *
+ * [W6-A] Agent 栏（agent-bar.ts，提示行之下、状态行之上）与子 Agent 视图（agent-view.ts，底部覆盖层）：
+ * - 键位：空输入时 `Ctrl+B`（有任务即可）或 `↓`（栏可见时）进栏（`app.agents.focus`，key-dispatch.ts 先问这里）；
+ *   栏内 ↑↓ 选、Enter 打开视图、Esc / Ctrl+B 返回，可打印字符回到输入框；
+ * - `/tasks` 无参 = 聚焦栏（`ui.agentBar: "off"` 时仍是原来的选择器），`/tasks <id>` = 直接进视图；
+ * - 等审批的任务按 `permission_request.context.taskId` 记下（栏与视图标题显示「等待审批」）。
  */
 import type { AgentSession, SessionEvent } from "../../agent/types.js";
 import type { SwitchRequest } from "../../cli/compose-session.js";
 import type { ClipboardDeps } from "../../tools/clipboard-image.js";
-import type { Component, Editor, TUI, Theme } from "../../tui.js";
+import { type Component, type Editor, type TUI, type Theme } from "../../tui.js";
+import { AgentBar } from "./agent-bar.js";
+import type { CommandUi } from "./commands.js";
+import type { AgentKeys } from "./key-dispatch.js";
+import type { StatusArea } from "./status-area.js";
 import { FirstRunMerge } from "./approval-merge.js";
 import type { NoticeLevel } from "./message-view.js";
 import type { PickerSpec } from "./pickers.js";
@@ -47,15 +57,29 @@ export interface AgentUiDeps {
     displayPath(path: string): string;
     /** 剪贴板读取的注入（测试）。 */
     clipboard?: ClipboardDeps;
+    /** [W6-A] 底部区域：Agent 栏插在速率行 / 状态栏之上；`ui.*` 配置。 */
+    area?: Pick<StatusArea, "rate" | "ui">;
 }
+/** [W6-A] `CommandUi` 的 Agent 栏 / 视图钩子（`/tasks`、`/tasks <id>`）；晚绑定，装配时 agentUi 还没建。 */
+export declare function agentCommandHooks(get: () => AgentUi): Pick<CommandUi, "agentBar" | "agentView">;
 export declare class AgentUi {
     private readonly deps;
     readonly plan: PlanFlow;
     readonly merge: FirstRunMerge;
+    /** [W6-A] Agent 栏。 */
+    readonly bar: AgentBar;
+    /** [W6-A] key-dispatch.ts 的 Agent 栏入口。 */
+    readonly keys: AgentKeys;
+    private view;
+    /** 等审批的请求 → 任务。 */
+    private readonly approvals;
     private restoreLog;
     /** 后台子 Agent 运行中：每秒重画跟随行的耗时（主会话空闲时 Loader 不转）。 */
     private ticker;
     constructor(deps: AgentUiDeps);
+    private keybindings;
+    private barEnabled;
+    private waiting;
     /** 新会话（启动、/new /resume /fork）：接管计划审批，转发外部 Agent notice。 */
     attach(session: AgentSession): void;
     detach(): void;
@@ -67,6 +91,17 @@ export declare class AgentUi {
     /** 交互界面自己处理的第五波命令；不是返回 false。 */
     command(name: string, args: string): Promise<boolean>;
     private showPlan;
+    /** `/tasks`（无参）：聚焦 Agent 栏；栏关闭（嵌入宿主缺省）时仍是选择器。 */
+    focusBar(): Promise<void>;
+    /** `app.agents.focus`（输入为空）：`↓` 只在栏可见时进入，其它键（`Ctrl+B`）有任务即可。 */
+    private focusFromKey;
+    /** 栏聚焦时的按键；不在栏里返回 false。 */
+    private barKey;
+    /** `/tasks <id>` 与栏里 Enter：打开子 Agent 视图。 */
+    openView(taskId: string): void;
+    get viewing(): string | undefined;
+    /** 撤掉视图（Esc、换会话、退出）；看到了结束后的状态就算查看过。 */
+    closeView(): void;
     private tasks;
     /** `Ctrl+V` / `/paste`：光标处插入 `@<路径>`。 */
     paste(): Promise<void>;

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

@@ -11,9 +11,19 @@
  *
  * 外部 Agent 的 notice（W5-E runner 的 `{type:"notice"}`）由任务注册表写进会话日志（`[task tN] …`），没有
  * 事件；这里在会话的 `options.log` 外面套一层，只把这类行转到消息区，其余照原样写日志。
+ *
+ * [W6-A] Agent 栏（agent-bar.ts，提示行之下、状态行之上）与子 Agent 视图（agent-view.ts，底部覆盖层）：
+ * - 键位：空输入时 `Ctrl+B`（有任务即可）或 `↓`（栏可见时）进栏（`app.agents.focus`，key-dispatch.ts 先问这里）；
+ *   栏内 ↑↓ 选、Enter 打开视图、Esc / Ctrl+B 返回，可打印字符回到输入框；
+ * - `/tasks` 无参 = 聚焦栏（`ui.agentBar: "off"` 时仍是原来的选择器），`/tasks <id>` = 直接进视图；
+ * - 等审批的任务按 `permission_request.context.taskId` 记下（栏与视图标题显示「等待审批」）。
  */
-import { taskRegistryView } from "../../agent/subagent-registry.js";
+import { registryOf, taskRegistryView } from "../../agent/subagent-registry.js";
 import { planController } from "../../plan/controller.js";
+import { msg } from "../../i18n/index.js";
+import { defaultKeybindings, isPrintableText, parseKey, } from "../../tui.js";
+import { AgentBar } from "./agent-bar.js";
+import { AgentView } from "./agent-view.js";
 import { agentsPanel, planPanel, taskOutputPanel } from "./agent-panels.js";
 import { FirstRunMerge } from "./approval-merge.js";
 import { pasteImage } from "./clipboard-paste.js";
@@ -22,11 +32,28 @@ import { editExternally } from "./external-editor.js";
 import { PlanFlow } from "./plan-flow.js";
 import { backgroundEndText, SubagentTracker } from "./subagent-view.js";
 import { listTasks, stopTask, taskLine, taskOutput } from "./tasks-report.js";
+/** [W6-A] `CommandUi` 的 Agent 栏 / 视图钩子（`/tasks`、`/tasks <id>`）；晚绑定，装配时 agentUi 还没建。 */
+export function agentCommandHooks(get) {
+    return {
+        agentBar: () => get().focusBar(),
+        agentView: (taskId) => get().openView(taskId),
+    };
+}
 const TASK_NOTICE = /^\[task (t\d+)\] ([\s\S]*)$/;
 export class AgentUi {
     deps;
     plan;
     merge;
+    /** [W6-A] Agent 栏。 */
+    bar;
+    /** [W6-A] key-dispatch.ts 的 Agent 栏入口。 */
+    keys = {
+        handleKey: (data) => this.barKey(data),
+        focus: (data) => this.focusFromKey(data),
+    };
+    view;
+    /** 等审批的请求 → 任务。 */
+    approvals = new Map();
     restoreLog;
     /** 后台子 Agent 运行中：每秒重画跟随行的耗时（主会话空闲时 Loader 不转）。 */
     ticker;
@@ -51,15 +78,42 @@ export class AgentUi {
             notice: (level, text) => deps.notice(level, text),
             prompt: (text) => deps.prompt(text),
         });
+        this.bar = new AgentBar({
+            theme: deps.theme,
+            registry: () => registryOf(deps.session().state.sessionId),
+            tracker: deps.subagents,
+            now: () => deps.now(),
+            approvals: () => this.waiting(),
+            enabled: () => this.barEnabled(),
+        });
+        if (deps.area !== undefined)
+            deps.tui.insertBefore(this.bar, deps.area.rate);
+    }
+    keybindings() {
+        return this.deps.dialog.keybindings ?? defaultKeybindings;
+    }
+    barEnabled() {
+        return this.deps.area !== undefined && this.deps.area.ui().agentBar !== "off";
+    }
+    waiting() {
+        return new Set(this.approvals.values());
     }
     /** 新会话（启动、/new /resume /fork）：接管计划审批，转发外部 Agent notice。 */
     attach(session) {
+        const viewing = this.viewing;
+        this.closeView();
+        // 换了会话：原来在看的任务不在新会话里
+        if (viewing !== undefined)
+            this.deps.notice("info", msg().agents.view.removed(viewing));
+        this.bar.reset();
+        this.approvals.clear();
         this.deps.subagents.clear();
         this.stopTicker();
         this.plan.attach(session);
         this.routeNotices(session);
     }
     detach() {
+        this.closeView();
         this.restoreLog?.();
         this.restoreLog = undefined;
         this.stopTicker();
@@ -76,6 +130,7 @@ export class AgentUi {
                 return this.stopTicker();
             for (const state of live)
                 this.deps.tools().get(state.parentToolCallId)?.refresh();
+            this.view?.component.tick();
             this.deps.render();
         }, 1000);
         this.ticker.unref?.();
@@ -121,6 +176,9 @@ export class AgentUi {
                 if (state === undefined)
                     return true;
                 this.deps.tools().get(state.parentToolCallId)?.refresh();
+                // 视图里看的任务又开跑（续聊、被释放后重开）：重新接上它的子会话
+                if (event.type === "subagent_start" && this.view?.component.task === event.taskId)
+                    this.view.component.attach();
                 // 后台任务：完成时 <task-notification> 那一行就是提示；失败 / 停止另给一行
                 if (event.type === "subagent_end" && state.background && state.status !== "completed")
                     this.deps.notice("warn", backgroundEndText(state));
@@ -136,6 +194,15 @@ export class AgentUi {
             case "background_job":
                 this.deps.notice("info", backgroundJobText(event));
                 return true;
+            case "permission_request": {
+                const taskId = event.context?.taskId;
+                if (taskId !== undefined)
+                    this.approvals.set(event.requestId, taskId);
+                return false;
+            }
+            case "permission_resolved":
+                this.approvals.delete(event.requestId);
+                return false;
             default:
                 return false;
         }
@@ -148,9 +215,6 @@ export class AgentUi {
             case "plan":
                 await this.showPlan();
                 return true;
-            case "tasks":
-                await this.tasks();
-                return true;
             case "agents":
                 this.deps.panel(agentsPanel(this.deps.session().state.sessionId, this.deps.theme));
                 return true;
@@ -165,7 +229,7 @@ export class AgentUi {
         const session = this.deps.session();
         const controller = planController(session);
         if (controller === undefined) {
-            this.deps.notice("info", "当前会话没有 Plan 能力");
+            this.deps.notice("info", msg().plan.command.unavailable);
             return;
         }
         this.deps.panel(planPanel(controller, session, this.deps.theme, this.deps.displayPath));
@@ -173,20 +237,122 @@ export class AgentUi {
         if (pending !== undefined && !session.state.isStreaming)
             await this.plan.ask(session, pending);
     }
+    // -------------------------------------------------------------------------
+    // [W6-A] Agent 栏与子 Agent 视图
+    // -------------------------------------------------------------------------
+    /** `/tasks`（无参）：聚焦 Agent 栏；栏关闭（嵌入宿主缺省）时仍是选择器。 */
+    async focusBar() {
+        if (!this.barEnabled())
+            return this.tasks();
+        if (!this.bar.focus()) {
+            this.deps.notice("info", msg().agents.bar.empty);
+            return;
+        }
+        this.deps.render();
+    }
+    /** `app.agents.focus`（输入为空）：`↓` 只在栏可见时进入，其它键（`Ctrl+B`）有任务即可。 */
+    focusFromKey(data) {
+        if (this.view !== undefined || !this.barEnabled())
+            return false;
+        if (parseKey(data)?.id === "down" && !this.bar.visible)
+            return false;
+        if (!this.bar.focus())
+            return false;
+        this.deps.render();
+        return true;
+    }
+    /** 栏聚焦时的按键；不在栏里返回 false。 */
+    barKey(data) {
+        if (!this.bar.focused)
+            return false;
+        const keys = this.keybindings();
+        if (keys.matches(data, "tui.select.up")) {
+            if (!this.bar.move(-1))
+                this.bar.blur();
+        }
+        else if (keys.matches(data, "tui.select.down"))
+            this.bar.move(1);
+        else if (keys.matches(data, "tui.editor.submit")) {
+            const taskId = this.bar.selected();
+            if (taskId !== undefined)
+                this.openView(taskId);
+        }
+        else if (keys.matches(data, "tui.select.cancel") || keys.matches(data, "app.agents.focus"))
+            this.bar.blur();
+        else {
+            // 可打印字符与其它键：退出栏，交给输入框
+            this.bar.blur();
+            this.deps.render();
+            return !isPrintableText(data) && keys.actionsFor(data).length === 0;
+        }
+        this.deps.render();
+        return true;
+    }
+    /** `/tasks <id>` 与栏里 Enter：打开子 Agent 视图。 */
+    openView(taskId) {
+        const sessionId = this.deps.session().state.sessionId;
+        if (taskRegistryView(sessionId)?.get(taskId) === undefined) {
+            this.deps.notice("info", msg().agents.view.unknown(taskId));
+            return;
+        }
+        this.closeView();
+        const ui = this.deps.area?.ui() ?? {};
+        const component = new AgentView(taskId, {
+            theme: this.deps.theme,
+            keys: this.keybindings(),
+            registry: () => registryOf(this.deps.session().state.sessionId),
+            tracker: this.deps.subagents,
+            approvals: () => this.waiting(),
+            now: () => this.deps.now(),
+            rows: () => this.deps.tui.terminal.rows,
+            render: () => this.deps.render(),
+            siblings: () => this.bar.all().map((row) => row.taskId),
+            close: () => this.closeView(),
+            stop: (id) => stopTask(this.deps.session().state.sessionId, id),
+            messages: {
+                ...(ui.showThinking !== undefined ? { showThinking: ui.showThinking } : {}),
+                ...(ui.markdown !== undefined ? { markdown: ui.markdown } : {}),
+                ...(ui.compact === true ? { compact: true } : {}),
+            },
+        });
+        // 视图盖住主区时主区不变（栏收起）；Esc 回到主界面
+        this.bar.blur();
+        const handle = this.deps.tui.showOverlay(component, { anchor: "bottom" });
+        this.view = { component, handle };
+        this.deps.render();
+    }
+    get viewing() {
+        return this.view?.component.task;
+    }
+    /** 撤掉视图（Esc、换会话、退出）；看到了结束后的状态就算查看过。 */
+    closeView() {
+        const view = this.view;
+        if (view === undefined)
+            return;
+        this.view = undefined;
+        view.component.dispose();
+        view.handle.hide();
+        const taskId = view.component.task;
+        const info = taskRegistryView(this.deps.session().state.sessionId)?.get(taskId);
+        if (info !== undefined && info.status !== "running")
+            this.bar.markViewed(taskId);
+        this.bar.blur();
+        this.deps.render();
+    }
     async tasks() {
         const sessionId = this.deps.session().state.sessionId;
         const tasks = listTasks(sessionId);
         if (tasks.length === 0) {
-            this.deps.notice("info", "还没有子 Agent 任务");
+            this.deps.notice("info", msg().panels.tasks.none);
             return;
         }
         const now = this.deps.now();
         const picked = await this.deps.pick({
-            title: "子 Agent 任务",
+            title: msg().interactive.agentUi.tasksTitle,
             items: [...tasks]
                 .reverse()
                 .map((task) => ({ value: task.taskId, label: taskLine(task, now) })),
-            footer: "↑↓ 选择 · Enter 查看 · Esc 取消",
+            footer: msg().interactive.agentUi.tasksFooter("↑↓"),
         });
         if (picked === undefined)
             return;
@@ -195,10 +361,10 @@ export class AgentUi {
             return;
         if (task.status === "running") {
             const action = await this.deps.pick({
-                title: `任务 ${task.taskId}`,
+                title: msg().panels.tasks.title(task.taskId),
                 items: [
-                    { value: "output", label: "查看已有输出" },
-                    { value: "stop", label: "停止任务" },
+                    { value: "output", label: msg().interactive.agentUi.viewOutput },
+                    { value: "stop", label: msg().interactive.agentUi.stop },
                 ],
                 numberKeys: true,
             });
@@ -206,7 +372,7 @@ export class AgentUi {
                 return;
             if (action.value === "stop") {
                 await stopTask(sessionId, task.taskId);
-                this.deps.notice("info", `已停止 ${task.taskId}`);
+                this.deps.notice("info", msg().interactive.agentUi.stopped(task.taskId));
                 return;
             }
         }
@@ -217,7 +383,7 @@ export class AgentUi {
     }
     /** `Ctrl+V` / `/paste`：光标处插入 `@<路径>`。 */
     async paste() {
-        this.deps.hint("读取剪贴板…");
+        this.deps.hint(msg().interactive.clipboard.reading);
         const pasted = await pasteImage(this.deps.dataDir, this.deps.clipboard);
         if (!pasted.ok) {
             this.deps.hint("");
@@ -228,7 +394,7 @@ export class AgentUi {
         const before = editor.getText();
         const lead = before === "" || /\s$/.test(before) ? "" : " ";
         editor.insertText(`${lead}${pasted.ref} `);
-        this.deps.hint("已插入剪贴板图片");
+        this.deps.hint(msg().interactive.clipboard.inserted);
         this.deps.render();
     }
 }

package/dist/modes/interactive/agent-view.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 子 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 { type Component, type Focusable, type Keybindings, type Theme } from "../../tui.js";
+import { type TaskSource } from "./agent-bar.js";
+import type { MessageViewOptions } from "./message-view.js";
+import type { SubagentTracker } from "./subagent-view.js";
+export interface AgentViewDeps {
+    theme: Theme;
+    keys: Keybindings;
+    registry(): TaskSource | undefined;
+    tracker: SubagentTracker;
+    approvals(): ReadonlySet<string>;
+    now(): number;
+    /** 终端行数（视图高度 = 行数 − 1）。 */
+    rows(): number;
+    render(): void;
+    /** 兄弟任务的顺序（←/→）。 */
+    siblings(): string[];
+    /** 换了查看的任务（栏的选择跟着走）。 */
+    onSwitch?(taskId: string): void;
+    close(): void;
+    stop(taskId: string): Promise<void>;
+    /** 消息区的显示选项（思考块、Markdown、紧凑）。 */
+    messages?: Omit<MessageViewOptions, "theme">;
+}
+export declare class AgentView implements Component, Focusable {
+    private taskId;
+    private readonly deps;
+    private readonly editor;
+    private body;
+    private off;
+    private follow;
+    /** 不跟随时正文窗口的首行。 */
+    private top;
+    private lastBody;
+    private flash;
+    private notice;
+    private _focused;
+    constructor(taskId: string, deps: AgentViewDeps);
+    get task(): string;
+    get focused(): boolean;
+    set focused(value: boolean);
+    /** 接上任务的数据（打开、切兄弟任务、任务重新开跑）；任务不存在返回 false。 */
+    attach(): boolean;
+    dispose(): void;
+    /** 每秒：运行中的工具重画耗时。 */
+    tick(): void;
+    private switchTo;
+    private submit;
+    handleInput(data: string): void;
+    private scroll;
+    private title;
+    render(width: number): string[];
+    invalidate(): void;
+}