@armadra/agent 0.4.0 → 0.5.1

package/dist/modes/interactive/external-editor.js

@@ -0,0 +1,39 @@
+/**
+ * 外部编辑器（计划审批框的「编辑计划」与「继续修改」）：`$VISUAL` → `$EDITOR` → `vi`（Windows `notepad`）。
+ * [W5-U] 编辑期间 TUI 挂起（交还终端），回来后整屏重画。临时文件在系统临时目录，读完即删。
+ */
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+export function editorCommand(env, platform = process.platform) {
+    const configured = env["VISUAL"]?.trim() || env["EDITOR"]?.trim();
+    if (configured !== undefined && configured !== "")
+        return configured;
+    return platform === "win32" ? "notepad" : "vi";
+}
+function runEditor(command, file) {
+    // 编辑器变量常带参数（`code --wait`），交给 shell 拆；路径加引号
+    const result = spawnSync(`${command} "${file}"`, { stdio: "inherit", shell: true });
+    return result.status;
+}
+/** 在外部编辑器里改 `text`；编辑器非零退出或读不回来返回 undefined。 */
+export async function editExternally(text, name, deps) {
+    const dir = mkdtempSync(join(tmpdir(), "ama-edit-"));
+    const file = join(dir, name);
+    writeFileSync(file, text);
+    deps.suspend();
+    try {
+        const code = (deps.run ?? runEditor)(editorCommand(deps.env, deps.platform), file);
+        if (code !== 0)
+            return undefined;
+        return readFileSync(file, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        deps.resume();
+        rmSync(dir, { recursive: true, force: true });
+    }
+}

package/dist/modes/interactive/interactive-mode.d.ts

@@ -11,15 +11,23 @@
  * - 晚绑定：`runtime.approvals.setUiBroker`（审批对话框）与 `runtime.notifier.set`（宿主通知进消息区），
  *   退出时撤下。
  * - 键位：Enter 发送（运行中 = steer），其余应用级键位见 `key-dispatch.ts`。
+ * - 回滚（RW-C）：`/rewind` 与空闲双击 Esc 走 rewind-flow.ts；回填的原消息图片暂存，随下一条消息发送。
+ * - 底部（W5-A，status-area.ts）：`ui.statusLine` full 时状态栏上方多一行速率行；Ctrl+G / `/statusline`
+ *   切换（只影响本会话）。
+ * - 第五波（W5-U，agent-ui.ts）：计划审批框、子 Agent 折叠视图、`/tasks` `/agents` `/paste` 与 Ctrl+V、审批来源
+ *   标注与外部 Agent 首次运行的合并确认（approval-merge.ts）、harness 提示。
  * - 启动头按 `ui.quietStartup`（startup-header.ts）：normal 框 + 模型 / 目录 / 模式 / 资源清单（窄屏或
  *   `ui.compact` 去框），header 一行，silent 不输出。
  */
 import type { AgentSession } from "../../agent/types.js";
 import type { ModeContext } from "../../cli/deps.js";
 import type { Runtime } from "../../cli/runtime.js";
+import type { StatusLineMode } from "../../config/types.js";
+import type { ClipboardDeps } from "../../tools/clipboard-image.js";
 import { Editor, Keybindings, TUI, type Terminal, type Theme } from "../../tui.js";
 import { MessageView } from "./message-view.js";
-import { StatusBar } from "./status-bar.js";
+import { StatusArea } from "./status-area.js";
+import type { StatusBar } from "./status-bar.js";
 import { ToolTracker } from "./tool-view.js";
 export interface InteractiveModeOptions {
     /** 缺省 `ProcessTerminal`（测试注入 MemoryTerminal）。 */
@@ -32,8 +40,12 @@ export interface InteractiveModeOptions {
     spinnerIntervalMs?: number;
     /** 输入历史文件；false 不读写（缺省 `<dataDir>/history`）。 */
     historyFile?: string | false;
+    /** 底部布局（缺省按 `ui.statusLine`；测试固定）。 */
+    statusLine?: StatusLineMode;
     /** 界面就绪后回调（测试驱动用）。 */
     onReady?(handle: InteractiveHandle): void;
+    /** 剪贴板读取的注入（测试；缺省调系统命令）。 */
+    clipboard?: ClipboardDeps;
 }
 export interface InteractiveHandle {
     readonly tui: TUI;
@@ -41,6 +53,7 @@ export interface InteractiveHandle {
     readonly view: MessageView;
     readonly tools: ToolTracker;
     readonly status: StatusBar;
+    readonly area: StatusArea;
     session(): AgentSession;
     exit(code: number): void;
 }

package/dist/modes/interactive/interactive-mode.js

@@ -11,30 +11,40 @@
  * - 晚绑定：`runtime.approvals.setUiBroker`（审批对话框）与 `runtime.notifier.set`（宿主通知进消息区），
  *   退出时撤下。
  * - 键位：Enter 发送（运行中 = steer），其余应用级键位见 `key-dispatch.ts`。
+ * - 回滚（RW-C）：`/rewind` 与空闲双击 Esc 走 rewind-flow.ts；回填的原消息图片暂存，随下一条消息发送。
+ * - 底部（W5-A，status-area.ts）：`ui.statusLine` full 时状态栏上方多一行速率行；Ctrl+G / `/statusline`
+ *   切换（只影响本会话）。
+ * - 第五波（W5-U，agent-ui.ts）：计划审批框、子 Agent 折叠视图、`/tasks` `/agents` `/paste` 与 Ctrl+V、审批来源
+ *   标注与外部 Agent 首次运行的合并确认（approval-merge.ts）、harness 提示。
  * - 启动头按 `ui.quietStartup`（startup-header.ts）：normal 框 + 模型 / 目录 / 模式 / 资源清单（窄屏或
  *   `ui.compact` 去框），header 一行，silent 不输出。
  */
 import { promptImages, sessionModel } from "../image-input.js";
 import { join } from "node:path";
 import { AgentSessionImpl } from "../../agent/session.js";
+import { taskRegistryView } from "../../agent/subagent-registry.js";
 import { currentSession, switchSession } from "../../cli/compose-session.js";
-import { startupInfo, startupScreenLevel } from "../../cli/startup-screen.js";
+import { startupInfo, startupScreenLevel, tildePath } from "../../cli/startup-screen.js";
 import { KEYBINDINGS_FILE } from "../../config/paths.js";
 import { AmaError, isAmaError } from "../../errors.js";
-import { detectSandboxCapability } from "../../codemode/capability.js";
-import { effectiveCodemodeMode } from "../../tools/presets.js";
-import { Container, Editor, Keybindings, Loader, ProcessTerminal, Spacer, TUI, Text, createTheme, detectCapabilities, resolveAscii, resolveThemeName, loadKeybindingsFile, truncateToWidth, } from "../../tui.js";
-import { cacheEventNotice, cacheNoticesEnabled } from "../session-report.js";
+import { Container, Editor, Keybindings, Loader, ProcessTerminal, Spacer, TUI, Text, createTheme, detectCapabilities, resolveAscii, resolveThemeName, loadKeybindingsFile, } from "../../tui.js";
+import { BYPASS_MODE, createBypassGate } from "../../permissions/bypass.js";
 import { onTerminationSignals } from "../shared.js";
+import { AgentUi } from "./agent-ui.js";
 import { ApprovalDialogBroker, approvalOutcomeText } from "./approval-dialog.js";
+import { mergingBroker } from "./approval-merge.js";
 import { ALL_COMMANDS, runInteractiveCommand } from "./commands.js";
 import { InteractiveCompletion } from "./completion.js";
+import { confirmBypass } from "./confirm-dialog.js";
 import { createKeyDispatch } from "./key-dispatch.js";
 import { MessageView, exitSummaryLines } from "./message-view.js";
 import { openPicker } from "./pickers.js";
+import { createRewindFlow } from "./rewind-flow.js";
 import { StartupHeader } from "./startup-header.js";
 import { QueueView, RunIndicator } from "./run-indicator.js";
-import { StatusBar } from "./status-bar.js";
+import { StatusArea, statusLineSlash } from "./status-area.js";
+import { createSessionEventHandler } from "./session-events.js";
+import { SubagentTracker } from "./subagent-view.js";
 import { ToolTracker } from "./tool-view.js";
 const HINT_MS = 2500;
 const EDITOR_PLACEHOLDER = "输入消息，/ 命令，@ 文件，Shift+Enter 换行";
@@ -51,17 +61,6 @@ function loadKeys(runtime, warn) {
         warn(`keybindings.json：${w}`);
     return new Keybindings(parsed.overrides);
 }
-/** 一行提示；空时不占行。 */
-class HintLine {
-    text = "";
-    setText(text) {
-        this.text = text;
-    }
-    render(width) {
-        return this.text === "" ? [] : [truncateToWidth(this.text, width)];
-    }
-    invalidate() { }
-}
 export function runInteractiveMode(runtime, context, options = {}) {
     const terminal = options.terminal ?? processTerminal();
     const ui = runtime.config.ui ?? {};
@@ -83,12 +82,14 @@ export function runInteractiveMode(runtime, context, options = {}) {
         ...(ui.markdown !== undefined ? { markdown: ui.markdown } : {}),
         ...(ui.compact === true ? { compact: true } : {}),
     });
+    const subagents = new SubagentTracker(now);
     const tools = new ToolTracker({
         theme,
         cwd: session.state.cwd,
         getTool: (name) => session.getTools().find((tool) => tool.name === name),
         now,
         spinner: () => loader.frame,
+        subagent: (toolCallId) => subagents.forToolCall(toolCallId),
     });
     const queueView = new QueueView(theme);
     const loaderSlot = new Container();
@@ -100,19 +101,17 @@ export function runInteractiveMode(runtime, context, options = {}) {
         ...(options.spinnerIntervalMs !== undefined ? { intervalMs: options.spinnerIntervalMs } : {}),
     });
     loader.onFrame(() => tools.tick());
-    const hint = new HintLine();
-    let sandboxStrict;
-    const status = new StatusBar({
+    const area = new StatusArea({
+        runtime,
+        theme,
         session: () => session,
-        preset: () => runtime.config.tools?.preset ?? "default",
-        hostStatus: () => runtime.host?.status(),
-        codemode: () => {
-            const mode = effectiveCodemodeMode(runtime.config);
-            const active = session.getTools().some((tool) => tool.name === "codemode");
-            return mode === "off" || !active ? undefined : mode;
-        },
-        sandboxStrict: () => (sandboxStrict ??= detectSandboxCapability().strict),
-    }, theme);
+        now,
+        render: () => tui.requestRender(),
+        redraw: () => tui.forceFullRedraw(),
+        env,
+        ...(options.statusLine !== undefined ? { layout: options.statusLine } : {}),
+    });
+    const { hint, bar: status } = area;
     const historyFile = options.historyFile === false
         ? undefined
         : (options.historyFile ?? join(runtime.paths.dataDir, "history"));
@@ -139,6 +138,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
     tui.addChild(loaderSlot);
     tui.addChild(editor);
     tui.addChild(hint);
+    tui.addChild(area.rate);
     tui.addChild(status);
     // ---- 小工具 ---------------------------------------------------------------
     let finished = false;
@@ -149,7 +149,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
         view.addNotice(level, text);
         render();
     };
-    const showHint = (text) => {
+    const showHint = (text, ms = HINT_MS) => {
         hint.setText(text === "" ? "" : theme.fg("dim", text));
         if (hintTimer !== undefined)
             clearTimeout(hintTimer);
@@ -158,7 +158,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
             hintTimer = setTimeout(() => {
                 hint.setText("");
                 render();
-            }, HINT_MS);
+            }, ms);
             hintTimer.unref?.();
         }
         render();
@@ -170,88 +170,18 @@ export function runInteractiveMode(runtime, context, options = {}) {
         render();
     };
     // ---- 会话事件 -------------------------------------------------------------
-    const onEvent = (event) => {
-        switch (event.type) {
-            case "agent_settled":
-                if (event.warning !== undefined)
-                    view.addNotice("warn", event.warning);
-                status.refresh();
-                break;
-            case "message_start": {
-                const message = event.message;
-                if (message.role === "user")
-                    view.addUser(message);
-                else if (message.role === "assistant")
-                    view.startAssistant(message);
-                else if (message.role === "custom" && message.display) {
-                    view.addNotice("info", typeof message.content === "string" ? message.content : "");
-                }
-                break;
-            }
-            case "message_update":
-                view.updateAssistant(event.message);
-                break;
-            case "message_end":
-                if (event.message.role === "assistant") {
-                    view.endAssistant(event.message);
-                    status.refresh();
-                }
-                break;
-            case "tool_execution_start": {
-                const started = tools.start(event);
-                if (started.topLevel)
-                    view.addTool(started.view);
-                break;
-            }
-            case "tool_execution_update":
-                tools.update(event.toolCallId, event.partial);
-                render();
-                return;
-            case "tool_execution_end":
-                tools.end(event.toolCallId, event.result, event.isError);
-                break;
-            case "queue_update":
-                setQueue(event.steering, event.followUp);
-                return;
-            case "compaction_end":
-                if (event.result !== undefined)
-                    view.addCompaction(event.result);
-                else if (event.error !== undefined)
-                    view.addNotice("error", `压缩失败：${event.error}`);
-                else if (event.aborted)
-                    view.addNotice("info", "压缩已取消");
-                status.refresh();
-                break;
-            case "auto_retry_start":
-                view.addRetry(event.attempt, event.maxAttempts, event.delayMs, event.errorMessage);
-                break;
-            case "auto_retry_end":
-                if (!event.success)
-                    view.addRetryFailed(event.finalError);
-                break;
-            case "cache_miss":
-            case "context_pressure": {
-                const shown = cacheEventNotice(event, cacheNoticesEnabled(session));
-                if (shown !== undefined)
-                    view.addNotice(shown.level, shown.text);
-                status.refresh();
-                render();
-                return;
-            }
-            case "cache_warm":
-            case "permission_mode_changed":
-            case "model_changed":
-            case "thinking_level_changed":
-            case "session_changed":
-                status.refresh();
-                render();
-                return;
-            default:
-                break;
-        }
-        indicator.onEvent(event);
-        render();
-    };
+    const onEvent = createSessionEventHandler({
+        view,
+        tools,
+        status,
+        area,
+        agentUi: () => agentUi,
+        indicator,
+        session: () => session,
+        setQueue,
+        notice,
+        render,
+    });
     let unsubscribe = session.subscribe(onEvent);
     const startupLevel = startupScreenLevel(runtime);
     const home = env["HOME"] ?? env["USERPROFILE"];
@@ -282,7 +212,8 @@ export function runInteractiveMode(runtime, context, options = {}) {
         tools.clear();
         replay();
         setQueue([], []);
-        status.refresh();
+        area.rebind();
+        agentUi.attach(next);
         indicator.reset();
         if (next instanceof AgentSessionImpl)
             next.announceStart(reason);
@@ -292,12 +223,20 @@ export function runInteractiveMode(runtime, context, options = {}) {
      * 空闲时发提示。agent_settled 之后会话周期还要一个微任务才结束，所以先 waitForIdle；
      * 仍然撞上运行中（极少）就排到本轮之后。
      */
+    let draftImages = [];
+    const resize = runtime.config.images?.resize;
+    const imageResize = resize !== undefined ? { resize } : {};
     const startPrompt = (text) => {
         const target = session;
+        const carried = draftImages;
+        draftImages = [];
         void target
             .waitForIdle()
             .then(async () => {
-            const images = await promptImages(text, [], target.state.cwd, sessionModel(runtime.providers, target));
+            const images = [
+                ...carried,
+                ...(await promptImages(text, [], target.state.cwd, sessionModel(runtime.providers, target), imageResize)),
+            ];
             return target.prompt(text, images.length > 0 ? { images } : {});
         })
             .catch((error) => {
@@ -312,6 +251,40 @@ export function runInteractiveMode(runtime, context, options = {}) {
             render();
         });
     };
+    /** 对话换了路径（/tree、回滚）：重画消息区。内容可能缩到视口顶以上，差分画不对，整屏重画。 */
+    const reloadView = () => {
+        resetView();
+        tools.clear();
+        replay();
+        status.refresh();
+        area.refreshGit();
+        tui.forceFullRedraw();
+    };
+    const setDraft = (draft) => {
+        editor.setText(draft.text);
+        draftImages = [...(draft.images ?? [])];
+        render();
+    };
+    const pickerHost = {
+        theme,
+        keybindings: keys,
+        showOverlay: (c, o) => tui.showOverlay(c, o),
+        columns: () => terminal.columns,
+        rows: () => terminal.rows,
+    };
+    // 进入 Bypass 前确认一次；启动时已是 Bypass（命令行 / 配置指定）视为已确认
+    const confirmMode = createBypassGate(() => confirmBypass(pickerHost), session.state.permissionMode === BYPASS_MODE);
+    const rewind = createRewindFlow({
+        ...pickerHost,
+        session: () => session,
+        now,
+        render,
+        notice,
+        hint: (text) => showHint(text),
+        reload: reloadView,
+        setDraft,
+        editorEmpty: () => editor.isEmpty(),
+    });
     const commandUi = {
         runtime,
         session: () => session,
@@ -320,12 +293,10 @@ export function runInteractiveMode(runtime, context, options = {}) {
             rebind(next, request.kind === "new" ? "new" : request.kind === "fork" ? "fork" : "resume");
             return next;
         },
-        pick: (spec) => openPicker({
-            theme,
-            keybindings: keys,
-            showOverlay: (c, o) => tui.showOverlay(c, o),
-            columns: () => terminal.columns,
-        }, spec),
+        pick: (spec) => openPicker(pickerHost, spec),
+        confirmMode,
+        rewind: () => rewind.open(),
+        setDraft,
         notice,
         panel: (component) => {
             view.add(component);
@@ -339,17 +310,14 @@ export function runInteractiveMode(runtime, context, options = {}) {
             render();
         },
         prompt: (text) => startPrompt(text),
-        reload: () => {
-            resetView();
-            tools.clear();
-            replay();
-            status.refresh();
-            render();
-        },
+        reload: reloadView,
         exit: (code) => exit(code),
         now,
+        extra: (name, args) => agentUi.command(name, args),
     };
-    const runCommand = (line) => runInteractiveCommand(line, commandUi).finally(() => {
+    const runCommand = (line) => (statusLineSlash(area, line, notice)
+        ? Promise.resolve(true)
+        : runInteractiveCommand(line, commandUi)).finally(() => {
         status.refresh();
         render();
     });
@@ -385,16 +353,16 @@ export function runInteractiveMode(runtime, context, options = {}) {
         now,
         showHint,
         onExpandToggle: (expanded) => view.setThinkingExpanded(expanded),
+        onStatusLineToggle: () => area.toggle(),
+        onPasteImage: () => void agentUi.paste(),
+        confirmMode,
         submit: (text, via) => submit(text, via),
         runCommand: (line) => void runCommand(line),
         exit: (code) => exit(code),
+        onInterrupted: (empty) => void rewind.afterInterrupt(empty),
     }));
     // ---- 晚绑定 ---------------------------------------------------------------
-    const broker = new ApprovalDialogBroker({
-        theme,
-        keybindings: keys,
-        cwd: session.state.cwd,
-        permissionMode: () => session.state.permissionMode,
+    const overlayHooks = {
         showOverlay: (component) => tui.showOverlay(component, { anchor: "bottom" }),
         onOpen: () => {
             editor.disableSubmit = true;
@@ -406,12 +374,44 @@ export function runInteractiveMode(runtime, context, options = {}) {
             tools.setAwaiting(false);
             indicator.setApproval(false);
         },
+    };
+    const agentUi = new AgentUi({
+        theme,
+        tui,
+        editor,
+        tools: () => tools,
+        subagents,
+        session: () => session,
+        dataDir: runtime.paths.dataDir,
+        env,
+        now,
+        notice,
+        panel: (component) => commandUi.panel?.(component),
+        pick: (spec) => openPicker(pickerHost, spec),
+        hint: (text) => showHint(text),
+        render,
+        switchSession: (request) => commandUi.switchSession(request),
+        prompt: (text) => startPrompt(text),
+        dialog: { theme, keybindings: keys, ...overlayHooks },
+        displayPath: (path) => tildePath(path, home),
+        ...(options.clipboard !== undefined ? { clipboard: options.clipboard } : {}),
+    });
+    const taskAgent = (taskId) => taskRegistryView(session.state.sessionId)?.get(taskId)?.agent;
+    const broker = mergingBroker(new ApprovalDialogBroker({
+        theme,
+        keybindings: keys,
+        cwd: session.state.cwd,
+        permissionMode: () => session.state.permissionMode,
+        taskAgent,
+        externalRunner: (agent) => agentUi.merge.externalRunner(agent),
+        ...overlayHooks,
         report: (request, outcome) => {
             if (outcome === "deny" || outcome === "cancelled") {
-                notice(outcome === "deny" ? "info" : "warn", approvalOutcomeText(request, outcome));
+                const text = approvalOutcomeText(request, outcome, taskAgent);
+                notice(outcome === "deny" ? "info" : "warn", text);
             }
         },
-    });
+    }), agentUi.merge, (request) => notice("info", `${approvalOutcomeText(request, "allow", taskAgent)}（随上一次确认）`));
     // ---- 启动与退出 -----------------------------------------------------------
     let offSignals = () => undefined;
     function exit(code) {
@@ -421,11 +421,13 @@ export function runInteractiveMode(runtime, context, options = {}) {
         if (hintTimer !== undefined)
             clearTimeout(hintTimer);
         loader.stop();
+        area.dispose();
         // 退出摘要留在回滚里；输入框、状态栏等底部区域撤掉，屏幕停在摘要下面
         view.addExitSummary(exitSummaryLines(session.getStats(), now() - startedAt, theme));
         tui.clear();
         tui.addChild(view);
         offSignals();
+        agentUi.detach();
         runtime.approvals.setUiBroker(undefined);
         runtime.notifier.set(undefined);
         tui.stop();
@@ -456,6 +458,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
         }
         runtime.approvals.setUiBroker(broker);
         runtime.notifier.set((message, level) => notice(level, message));
+        agentUi.attach(session);
         offSignals = onTerminationSignals((code) => exit(code));
         tui.setFocus(editor);
         options.onReady?.({
@@ -464,6 +467,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
             view,
             tools,
             status,
+            area,
             session: () => session,
             exit,
         });

package/dist/modes/interactive/key-dispatch.d.ts

@@ -3,9 +3,15 @@
  *
  * 编辑器之前的输入监听：Ctrl+C 清空输入 / 再按退出、Esc 中断（clearQueue 回填编辑器后 abort）、
  * Ctrl+D 空输入退出、Alt+Enter followUp、Alt+↑ 取回最后一条排队消息、Shift+Tab 循环权限模式、
- * Ctrl+O 展开工具输出与思考块、Ctrl+L 模型、Ctrl+T 思考级别。键位由 `keybindings.json` 覆盖。
+ * Ctrl+O 展开工具输出与思考块、Ctrl+L 模型、Ctrl+T 思考级别、Ctrl+G 底部信息行 full ↔ compact（W5-A）、
+ * Ctrl+V 粘贴剪贴板图片（`app.paste.image`，W5-U）。
+ * 键位由 `keybindings.json` 覆盖。
+ *
+ * [RW-C] 空闲时双击 Esc（`app.rewind`，double-esc.ts）：输入框为空打开回滚列表，有字则清空并存进
+ * 输入历史；运行中 Esc 仍为中断，中断后交给 `onInterrupted`（中断即撤回）。
  */
 import type { AgentSession } from "../../agent/types.js";
+import type { PermissionMode } from "../../permissions/types.js";
 import type { Editor, Keybindings } from "../../tui.js";
 import type { StatusBar } from "./status-bar.js";
 import type { ToolTracker } from "./tool-view.js";
@@ -20,12 +26,26 @@ export interface KeyDispatchDeps {
     /** 运行或压缩中（Esc 才中断）。 */
     busy(): boolean;
     now(): number;
-    showHint(text: string): void;
+    /** 底部提示；`ms` 是停留时间（缺省由调用方决定）。 */
+    showHint(text: string, ms?: number): void;
     /** Ctrl+O 之后（消息区思考块跟着展开 / 折叠）。 */
     onExpandToggle?(expanded: boolean): void;
+    /** Ctrl+G：切换底部信息行，返回切换后的布局。 */
+    onStatusLineToggle?(): "full" | "compact";
+    /**
+     * 循环到某模式前的确认（进入 Bypass 前弹确认框，permissions/bypass.ts）；返回 false 时跳过该模式，
+     * 落到循环里的下一个。没有时直接切换。
+     */
+    confirmMode?(mode: PermissionMode): boolean | Promise<boolean>;
+    /** Ctrl+V：粘贴剪贴板图片（W5-U）。 */
+    onPasteImage?(): void;
     submit(text: string, via: "followUp"): void;
     runCommand(line: string): void;
     exit(code: number): void;
+    /** Esc 中断之后（参数：中断后输入框是否为空）。 */
+    onInterrupted?(editorWasEmpty: boolean): void;
+    /** 双击 Esc 的间隔（测试注入）。 */
+    doubleEscMs?: number;
 }
 /** 返回输入监听器：已处理返回 true，交给编辑器返回 false。 */
 export declare function createKeyDispatch(deps: KeyDispatchDeps): (data: string) => boolean;