@armadra/agent 0.6.2 → 0.6.3

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

@@ -0,0 +1,112 @@
+/**
+ * 后台任务的审批停靠（docs/agents-concurrency-plan.md §2.7、D6）。[W7-C]
+ *
+ * 套在审批对话框 broker 外面：请求带 `context.taskId` 且该任务在后台运行（含转后台）时，主会话忙、输入框有
+ * 草稿或已有覆盖层就不弹框，先「停靠」——Agent 栏该任务行显示「等待审批」（agent-ui.ts 按
+ * `permission_request` 记下），运行提示行附「↓ 处理审批」；满足下列任一条件立即弹出：
+ * - 主会话空闲、输入为空、没有覆盖层（`ready`，每 250 ms 与相关事件后各对一次）；
+ * - 正在子 Agent 视图里看这个任务（栏里 Enter 打开视图即弹出）；
+ * - 停靠期间又来了不能停靠的请求（主会话自己的、前台任务的）：审批链是串行的，它排在停靠的请求后面，
+ *   不放出来就会一直等，所以先弹停靠的那个——主会话与前台任务的审批照旧立即弹出。
+ *
+ * 停靠期间子任务阻塞在权限等待；超时 / 取消（链的 signal）照旧，停靠项随之撤掉、按 undefined 交回链。
+ * 前台任务与主会话的请求直接交给内层 broker，行为不变。
+ */
+export const DOCK_POLL_MS = 250;
+export class ApprovalDock {
+    inner;
+    host;
+    docked = [];
+    /** 已发出、还没答复的不可停靠请求（主会话 / 前台任务）。 */
+    others = new Set();
+    timer;
+    constructor(inner, host) {
+        this.inner = inner;
+        this.host = host;
+    }
+    ask(request, signal) {
+        const taskId = request.context?.taskId;
+        if (taskId === undefined ||
+            signal.aborted ||
+            !this.host.dockable(taskId) ||
+            this.others.size > 0 ||
+            this.host.ready(taskId))
+            return this.inner.ask(request, signal);
+        return new Promise((resolve) => {
+            const entry = {
+                taskId,
+                request,
+                signal,
+                resolve,
+                onAbort: () => {
+                    this.remove(entry);
+                    resolve(undefined);
+                },
+            };
+            signal.addEventListener("abort", entry.onAbort, { once: true });
+            this.docked.push(entry);
+            this.startPolling();
+            this.host.changed();
+        });
+    }
+    /** 停靠中的任务。 */
+    tasks() {
+        return new Set(this.docked.map((entry) => entry.taskId));
+    }
+    get size() {
+        return this.docked.length;
+    }
+    /** 会话事件：记下不可停靠的请求；停靠期间来了这种请求就放出停靠的（见文件头）。 */
+    observe(event) {
+        if (event.type === "permission_request") {
+            const taskId = event.context?.taskId;
+            if (taskId !== undefined && this.host.dockable(taskId))
+                return;
+            this.others.add(event.requestId);
+            this.poke();
+        }
+        else if (event.type === "permission_resolved")
+            this.others.delete(event.requestId);
+    }
+    /** 对一次弹出条件（定时器、视图打开、回合结束）。 */
+    poke() {
+        for (const entry of [...this.docked])
+            if (this.others.size > 0 || this.host.ready(entry.taskId))
+                this.release(entry);
+    }
+    /** 换会话：旧会话的未答复请求不再有 `permission_resolved` 到这里。 */
+    reset() {
+        this.others.clear();
+    }
+    /** 退出：停靠的请求按 undefined 交回链（链按拒绝处理）。 */
+    dispose() {
+        for (const entry of [...this.docked])
+            entry.onAbort();
+        this.others.clear();
+    }
+    release(entry) {
+        this.remove(entry);
+        entry.resolve(this.inner.ask(entry.request, entry.signal));
+    }
+    remove(entry) {
+        const at = this.docked.indexOf(entry);
+        if (at < 0)
+            return;
+        this.docked.splice(at, 1);
+        entry.signal.removeEventListener("abort", entry.onAbort);
+        if (this.docked.length === 0)
+            this.stopPolling();
+        this.host.changed();
+    }
+    startPolling() {
+        if (this.timer !== undefined)
+            return;
+        this.timer = setInterval(() => this.poke(), this.host.pollMs ?? DOCK_POLL_MS);
+        this.timer.unref?.();
+    }
+    stopPolling() {
+        if (this.timer !== undefined)
+            clearInterval(this.timer);
+        this.timer = undefined;
+    }
+}

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

@@ -0,0 +1,43 @@
+/**
+ * 交互界面的审批接线，从 interactive-mode.ts 拆出（保持装配文件 ≤ 600 行）。[W7-C]
+ *
+ * broker 由外到内：首次运行合并（approval-merge.ts）→ 后台任务停靠（approval-dock.ts）→ 底部对话框
+ * （approval-dialog.ts）。对话框打开 / 关闭时禁用编辑器提交、标记运行中的工具「等待确认」、运行提示行换
+ * 「等待确认」。
+ */
+import type { AgentSession } from "../../agent/types.js";
+import type { ApprovalBroker } from "../../permissions/types.js";
+import type { Component, Editor, Keybindings, OverlayHandle, TUI, Theme } from "../../tui.js";
+import type { AgentUi } from "./agent-ui.js";
+import { ApprovalDock } from "./approval-dock.js";
+import type { NoticeLevel } from "./message-view.js";
+import type { RunIndicator } from "./run-indicator.js";
+import type { ToolTracker } from "./tool-view.js";
+export interface OverlayHooks {
+    showOverlay(component: Component): OverlayHandle;
+    onOpen(): void;
+    onClose(): void;
+}
+export declare function approvalOverlayHooks(deps: {
+    tui: TUI;
+    editor: Editor;
+    tools(): ToolTracker;
+    indicator: RunIndicator;
+}): OverlayHooks;
+export interface ApprovalUiDeps {
+    theme: Theme;
+    keys: Keybindings;
+    tui: TUI;
+    editor: Editor;
+    indicator: RunIndicator;
+    agentUi: AgentUi;
+    hooks: OverlayHooks;
+    session(): AgentSession;
+    notice(level: NoticeLevel, text: string): void;
+    render(): void;
+}
+/** 组装界面 broker，并把停靠接到 Agent 栏与运行提示行。 */
+export declare function createApprovalUi(deps: ApprovalUiDeps): {
+    broker: ApprovalBroker;
+    dock: ApprovalDock;
+};

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

@@ -0,0 +1,64 @@
+/**
+ * 交互界面的审批接线，从 interactive-mode.ts 拆出（保持装配文件 ≤ 600 行）。[W7-C]
+ *
+ * broker 由外到内：首次运行合并（approval-merge.ts）→ 后台任务停靠（approval-dock.ts）→ 底部对话框
+ * （approval-dialog.ts）。对话框打开 / 关闭时禁用编辑器提交、标记运行中的工具「等待确认」、运行提示行换
+ * 「等待确认」。
+ */
+import { taskRegistryView } from "../../agent/subagent-registry.js";
+import { msg } from "../../i18n/index.js";
+import { ApprovalDialogBroker, approvalOutcomeText } from "./approval-dialog.js";
+import { ApprovalDock } from "./approval-dock.js";
+import { mergingBroker } from "./approval-merge.js";
+export function approvalOverlayHooks(deps) {
+    const { tui, editor, indicator } = deps;
+    return {
+        showOverlay: (component) => tui.showOverlay(component, { anchor: "bottom" }),
+        onOpen: () => {
+            editor.disableSubmit = true;
+            deps.tools().setAwaiting(true);
+            indicator.setApproval(true);
+        },
+        onClose: () => {
+            editor.disableSubmit = false;
+            deps.tools().setAwaiting(false);
+            indicator.setApproval(false);
+        },
+    };
+}
+/** 组装界面 broker，并把停靠接到 Agent 栏与运行提示行。 */
+export function createApprovalUi(deps) {
+    const { theme, keys, tui, editor, indicator, agentUi, hooks, notice } = deps;
+    const taskInfo = (taskId) => taskRegistryView(deps.session().state.sessionId)?.get(taskId);
+    const taskAgent = (taskId) => taskInfo(taskId)?.agent;
+    const dialog = new ApprovalDialogBroker({
+        theme,
+        keybindings: keys,
+        cwd: deps.session().state.cwd,
+        permissionMode: () => deps.session().state.permissionMode,
+        taskAgent,
+        externalRunner: (agent) => agentUi.merge.externalRunner(agent),
+        ...hooks,
+        report: (request, outcome) => {
+            if (outcome === "deny" || outcome === "cancelled") {
+                const text = approvalOutcomeText(request, outcome, taskAgent);
+                notice(outcome === "deny" ? "info" : "warn", text);
+            }
+        },
+    });
+    const dock = new ApprovalDock(dialog, {
+        dockable: (taskId) => {
+            const info = taskInfo(taskId);
+            return info?.status === "running" && info.background === true;
+        },
+        ready: (taskId) => agentUi.viewing === taskId || (!tui.hasOverlay && !indicator.busy && editor.isEmpty()),
+        changed: () => {
+            indicator.sync();
+            deps.render();
+        },
+    });
+    agentUi.dock = dock;
+    indicator.docked = () => dock.size > 0;
+    const broker = mergingBroker(dock, agentUi.merge, (request) => notice("info", msg().interactive.app.followed(approvalOutcomeText(request, "allow", taskAgent))));
+    return { broker, dock };
+}

package/dist/modes/interactive/commands.js

@@ -72,7 +72,10 @@ export const PANEL_COMMANDS = {
             await ui.agentBar();
             return true;
         }
-        if (parts.length === 1 && parts[0] !== "stop" && ui.agentView !== undefined) {
+        if (parts.length === 1 &&
+            parts[0] !== "stop" &&
+            parts[0] !== "bg" &&
+            ui.agentView !== undefined) {
             await ui.agentView(parts[0]);
             return true;
         }

package/dist/modes/interactive/event-notices.d.ts

@@ -3,7 +3,8 @@
  *
  * - W5-I：`entry_appended` 里 `reason: "image_budget"` 的 `context_edit`（一次降级会连写多条，每条一个消息）
  *   合并成一条「已省略 N 张早期图片以符合请求上限」，N 按占位文本数；
- * - W5-H1：`compaction_end.error` 的「compaction did not shrink」换成中文说明（其余错误原样）。
+ * - W5-H1：`compaction_end.error` 的「compaction did not shrink」换成中文说明（其余错误原样）；
+ * - W7-C：`subagent_background`（超时自动 / 宿主转后台）一行提示。
  */
 import type { SessionEvent } from "../../agent/types.js";
 /** `compaction_end.error` 的显示文本。 */
@@ -30,3 +31,7 @@ export declare function modelFallbackText(event: Extract<SessionEvent, {
 export declare function backgroundJobText(event: Extract<SessionEvent, {
     type: "background_job";
 }>): string;
+/** [W7-C] `subagent_background`：超时自动 / 宿主转后台的一行提示（人按 Ctrl+B 的已有底部提示）。 */
+export declare function subagentBackgroundText(event: Extract<SessionEvent, {
+    type: "subagent_background";
+}>, agent: string): string;

package/dist/modes/interactive/event-notices.js

@@ -3,7 +3,8 @@
  *
  * - W5-I：`entry_appended` 里 `reason: "image_budget"` 的 `context_edit`（一次降级会连写多条，每条一个消息）
  *   合并成一条「已省略 N 张早期图片以符合请求上限」，N 按占位文本数；
- * - W5-H1：`compaction_end.error` 的「compaction did not shrink」换成中文说明（其余错误原样）。
+ * - W5-H1：`compaction_end.error` 的「compaction did not shrink」换成中文说明（其余错误原样）；
+ * - W7-C：`subagent_background`（超时自动 / 宿主转后台）一行提示。
  */
 import { msg } from "../../i18n/index.js";
 import { IMAGE_OMITTED_FOR_BUDGET, IMAGE_OMITTED_TOO_LARGE, } from "../../compaction/image-budget.js";
@@ -79,3 +80,8 @@ export function backgroundJobText(event) {
             return m.backgroundStopped(event.jobId, short);
     }
 }
+/** [W7-C] `subagent_background`：超时自动 / 宿主转后台的一行提示（人按 Ctrl+B 的已有底部提示）。 */
+export function subagentBackgroundText(event, agent) {
+    const m = msg().agents.background;
+    return event.reason === "timeout" ? m.timeout(event.taskId, agent) : m.host(event.taskId, agent);
+}

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

@@ -16,8 +16,10 @@
  *   切换（只影响本会话）。
  * - 第五波（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 不输出。
+ * - [W7-C] 审批接线拆到 approval-ui.ts（合并 → 后台任务停靠 → 对话框）；`Ctrl+B` 转后台与 Esc 提示的数据来自
+ *   task-background.ts。
+ * - 启动头按 `ui.quietStartup`（startup-header.ts）：normal「AMA」字符画 + 信息列（启动时点亮扫描一次，
+ *   startup-logo.ts；窄屏 / `ui.logo: off` / `ui.compact` 不画字符画），header 一行，silent 不输出。
  */
 import type { AgentSession } from "../../agent/types.js";
 import type { ModeContext } from "../../cli/deps.js";

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

@@ -16,13 +16,14 @@
  *   切换（只影响本会话）。
  * - 第五波（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 不输出。
+ * - [W7-C] 审批接线拆到 approval-ui.ts（合并 → 后台任务停靠 → 对话框）；`Ctrl+B` 转后台与 Esc 提示的数据来自
+ *   task-background.ts。
+ * - 启动头按 `ui.quietStartup`（startup-header.ts）：normal「AMA」字符画 + 信息列（启动时点亮扫描一次，
+ *   startup-logo.ts；窄屏 / `ui.logo: off` / `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, tildePath } from "../../cli/startup-screen.js";
 import { AmaError, isAmaError } from "../../errors.js";
@@ -31,8 +32,7 @@ import { Container, Editor, Loader, Spacer, TUI, Text, createTheme, detectCapabi
 import { BYPASS_MODE, createBypassGate } from "../../permissions/bypass.js";
 import { onTerminationSignals } from "../shared.js";
 import { AgentUi, agentCommandHooks } from "./agent-ui.js";
-import { ApprovalDialogBroker, approvalOutcomeText } from "./approval-dialog.js";
-import { mergingBroker } from "./approval-merge.js";
+import { approvalOverlayHooks, createApprovalUi } from "./approval-ui.js";
 import { ALL_COMMANDS, runInteractiveCommand } from "./commands.js";
 import { memoryPanelFor } from "./memory-panel.js";
 import { InteractiveCompletion } from "./completion.js";
@@ -45,12 +45,14 @@ import { modelPickerFor } from "./model-picker.js";
 import { createRewindFlow } from "./rewind-flow.js";
 import { openTraceView } from "./trace-view.js";
 import { StartupHeader } from "./startup-header.js";
+import { playStartupAnimation } from "./startup-logo.js";
 import { QueueView, RunIndicator } from "./run-indicator.js";
 import { StatusArea, statusLineSlash } from "./status-area.js";
 import { createSessionEventHandler } from "./session-events.js";
 import { SubagentTracker } from "./subagent-view.js";
 import { loadKeys, processTerminal } from "./terminal-setup.js";
 import { ToolTracker } from "./tool-view.js";
+import { backgroundTasks, blockingTasks, keyLabel, runningBackground } from "./task-background.js";
 const HINT_MS = 2500;
 export function runInteractiveMode(runtime, context, options = {}) {
     const terminal = options.terminal ?? processTerminal();
@@ -131,6 +133,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
     tui.addChild(hint);
     tui.addChild(area.rate);
     tui.addChild(status);
+    tui.addChild(area.quota);
     // ---- 小工具 ---------------------------------------------------------------
     let finished = false;
     let hintTimer;
@@ -154,7 +157,11 @@ export function runInteractiveMode(runtime, context, options = {}) {
         }
         render();
     };
-    const indicator = new RunIndicator({ theme, loader, slot: loaderSlot, tools, render });
+    const backgroundKey = keyLabel(keys, "app.tasks.background");
+    const indicator = new RunIndicator({
+        ...{ theme, loader, slot: loaderSlot, tools, render },
+        ...(backgroundKey !== undefined ? { backgroundKey } : {}),
+    });
     const setQueue = (steering, followUp) => {
         status.setQueue(steering.length, followUp.length);
         queueView.setQueue(steering, followUp);
@@ -177,7 +184,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
     const startupLevel = startupScreenLevel(runtime);
     const home = env["HOME"] ?? env["USERPROFILE"];
     const info = startupInfo(runtime, home);
-    const header = (level) => new StartupHeader(info, { theme, level, ...(ui.compact === true ? { compact: true } : {}) });
+    const header = (level) => new StartupHeader(info, { theme, level, logo: ui.logo, compact: ui.compact });
     /** 清空消息区（切换会话、/tree）：只留一行头。 */
     const resetView = () => {
         view.reset();
@@ -358,21 +365,12 @@ export function runInteractiveMode(runtime, context, options = {}) {
         exit: (code) => exit(code),
         onInterrupted: (empty) => void rewind.afterInterrupt(empty),
         agents: () => agentUi.keys,
+        downGlyph: theme.glyphs.arrowDown,
+        backgroundTasks: () => backgroundTasks(session),
+        runningBackground: () => runningBackground(session),
     }));
     // ---- 晚绑定 ---------------------------------------------------------------
-    const overlayHooks = {
-        showOverlay: (component) => tui.showOverlay(component, { anchor: "bottom" }),
-        onOpen: () => {
-            editor.disableSubmit = true;
-            tools.setAwaiting(true);
-            indicator.setApproval(true);
-        },
-        onClose: () => {
-            editor.disableSubmit = false;
-            tools.setAwaiting(false);
-            indicator.setApproval(false);
-        },
-    };
+    const overlayHooks = approvalOverlayHooks({ tui, editor, tools: () => tools, indicator });
     const agentUi = new AgentUi({
         theme,
         tui,
@@ -395,28 +393,20 @@ export function runInteractiveMode(runtime, context, options = {}) {
         ...(options.clipboard !== undefined ? { clipboard: options.clipboard } : {}),
         area,
     });
-    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") {
-                const text = approvalOutcomeText(request, outcome, taskAgent);
-                notice(outcome === "deny" ? "info" : "warn", text);
-            }
-        },
-    }), agentUi.merge, (request) => notice("info", msg().interactive.app.followed(approvalOutcomeText(request, "allow", taskAgent))));
+    indicator.agents = () => agentUi.reachable;
+    const { broker, dock } = createApprovalUi({
+        ...{ theme, keys, tui, editor, indicator, agentUi, notice, render },
+        hooks: overlayHooks,
+        session: () => session,
+    });
+    indicator.background = () => blockingTasks(session).length > 0;
     // ---- 启动与退出 -----------------------------------------------------------
     let offSignals = () => undefined;
     function exit(code) {
         if (finished)
             return;
         finished = true;
+        logoAnimation?.finish();
         if (hintTimer !== undefined)
             clearTimeout(hintTimer);
         loader.stop();
@@ -427,6 +417,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
         tui.addChild(view);
         offSignals();
         agentUi.detach();
+        dock.dispose();
         runtime.approvals.setUiBroker(undefined);
         runtime.notifier.set(undefined);
         tui.stop();
@@ -439,8 +430,10 @@ export function runInteractiveMode(runtime, context, options = {}) {
             resolveExit(code);
         });
     }
-    if (startupLevel !== "silent")
-        view.add(header(startupLevel));
+    const startHeader = startupLevel === "silent" ? undefined : header(startupLevel);
+    let logoAnimation;
+    if (startHeader !== undefined)
+        view.add(startHeader);
     for (const warning of startupWarnings)
         view.addNotice("warn", warning);
     replay();
@@ -460,6 +453,8 @@ export function runInteractiveMode(runtime, context, options = {}) {
         agentUi.attach(session);
         offSignals = onTerminationSignals((code) => exit(code));
         tui.setFocus(editor);
+        const gate = { animation: ui.animation, host: info.host !== undefined, env, ...context };
+        logoAnimation = playStartupAnimation(tui, startHeader, theme, gate);
         options.onReady?.({
             tui,
             editor,

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

@@ -10,20 +10,31 @@
  * [RW-C] 空闲时双击 Esc（`app.rewind`，double-esc.ts）：输入框为空打开回滚列表，有字则清空并存进
  * 输入历史；运行中 Esc 仍为中断，中断后交给 `onInterrupted`（中断即撤回）。
  *
- * [W6-A] Agent 栏（agent-ui.ts）：栏聚焦时它先收键（Esc 是「返回」，不中断、不回滚）；输入为空、补全没开时
- * `app.agents.focus`（缺省 `Ctrl+B` / `↓`）先问它要不要进栏，不要就照常交给编辑器（光标左移、历史下一条）。
+ * [W6-A] Agent 栏（agent-ui.ts）：栏聚焦时它先收键（Esc 是「返回」，不中断、不回滚）；补全没开、没在浏览
+ * 历史时 `app.agents.focus`（缺省 `↓`）先问它要不要进栏，不要就照常交给编辑器（下移、历史下一条）。
+ * [W7-A] 落空给一行提示：输入有字（每段草稿一次，光标在末行时）、栏关闭、没有任务。
+ * [W7-C] `app.tasks.background`（缺省 `Ctrl+B`）：有阻塞中的前台任务时全部转后台（不看输入框），底部提示
+ * 「已转后台：t2 …」；没有时落回编辑器（光标左移），不吞键。Esc 中断只连带前台任务，仍在运行的后台任务
+ * 写进中断提示。
  */
 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";
+/** [W7-A] 进栏落空提示的停留时间。 */
+export declare const FOCUS_HINT_MS = 3000;
+/**
+ * [W7-A] 进栏键的结果：true 已进栏；false 不管（交给编辑器，不提示）；其余是落空原因——
+ * `busy-input` 输入框有字、`disabled` `ui.agentBar: "off"`（有任务时）、`empty` 没有任务。
+ */
+export type AgentFocusResult = boolean | "busy-input" | "disabled" | "empty";
 /** [W6-A] Agent 栏的按键入口。 */
 export interface AgentKeys {
     /** 栏聚焦时先消费按键；返回 true 已处理。 */
     handleKey(data: string): boolean;
-    /** `app.agents.focus`（输入为空）：进栏返回 true，否则交给编辑器。 */
-    focus(data: string): boolean;
+    /** `app.agents.focus`：输入为空且有任务时进栏返回 true，否则返回落空原因（按键仍交给编辑器）。 */
+    focus(data: string): AgentFocusResult;
 }
 export interface KeyDispatchDeps {
     keys: Keybindings;
@@ -58,6 +69,12 @@ export interface KeyDispatchDeps {
     doubleEscMs?: number;
     /** [W6-A] Agent 栏（晚绑定）。 */
     agents?(): AgentKeys | undefined;
+    /** [W7-A] 提示里的 `↓` 字形（ASCII 主题 `v`；缺省 `↓`）。 */
+    downGlyph?: string;
+    /** [W7-C] 有阻塞中的前台任务时全部转后台，返回转了的 taskId；没有返回空（按键交给编辑器）。 */
+    backgroundTasks?(): string[];
+    /** [W7-C] 仍在运行的后台任务（Esc 中断的提示里写明不受影响）。 */
+    runningBackground?(): string[];
 }
 /** 返回输入监听器：已处理返回 true，交给编辑器返回 false。 */
 export declare function createKeyDispatch(deps: KeyDispatchDeps): (data: string) => boolean;

package/dist/modes/interactive/key-dispatch.js

@@ -10,20 +10,31 @@
  * [RW-C] 空闲时双击 Esc（`app.rewind`，double-esc.ts）：输入框为空打开回滚列表，有字则清空并存进
  * 输入历史；运行中 Esc 仍为中断，中断后交给 `onInterrupted`（中断即撤回）。
  *
- * [W6-A] Agent 栏（agent-ui.ts）：栏聚焦时它先收键（Esc 是「返回」，不中断、不回滚）；输入为空、补全没开时
- * `app.agents.focus`（缺省 `Ctrl+B` / `↓`）先问它要不要进栏，不要就照常交给编辑器（光标左移、历史下一条）。
+ * [W6-A] Agent 栏（agent-ui.ts）：栏聚焦时它先收键（Esc 是「返回」，不中断、不回滚）；补全没开、没在浏览
+ * 历史时 `app.agents.focus`（缺省 `↓`）先问它要不要进栏，不要就照常交给编辑器（下移、历史下一条）。
+ * [W7-A] 落空给一行提示：输入有字（每段草稿一次，光标在末行时）、栏关闭、没有任务。
+ * [W7-C] `app.tasks.background`（缺省 `Ctrl+B`）：有阻塞中的前台任务时全部转后台（不看输入框），底部提示
+ * 「已转后台：t2 …」；没有时落回编辑器（光标左移），不吞键。Esc 中断只连带前台任务，仍在运行的后台任务
+ * 写进中断提示。
  */
 import { msg } from "../../i18n/index.js";
 import { ExitCode } from "../../cli/exit-codes.js";
 import { nextCycleMode, permissionModeLabel } from "../../permissions/modes.js";
 import { DOUBLE_ESC_HINT_MS, DoubleEscape } from "./double-esc.js";
+import { backgroundedText } from "./task-background.js";
 import { statusLineText } from "./status-area.js";
 const DOUBLE_CTRL_C_MS = 1500;
+/** [W7-A] 进栏落空提示的停留时间。 */
+export const FOCUS_HINT_MS = 3000;
 /** 返回输入监听器：已处理返回 true，交给编辑器返回 false。 */
 export function createKeyDispatch(deps) {
     const { keys, editor, tools, status } = deps;
     let ctrlCArmedAt = Number.NEGATIVE_INFINITY;
     const esc = new DoubleEscape(deps.doubleEscMs);
+    /** 本段草稿已给过「输入框有字」提示（输入清空后重置）。 */
+    let busyInputHinted = false;
+    /** 底部正显示着进栏落空提示（进栏后撤掉）。 */
+    let focusHintShown = false;
     const doubleEscape = () => {
         switch (esc.press(deps.now(), editor.isEmpty())) {
             case "arm-rewind":
@@ -88,9 +99,43 @@ export function createKeyDispatch(deps) {
         else
             void answer.then(settle);
     };
+    /** 光标在最后一行（`↓` 不再下移，只会到行尾）。 */
+    const atLastLine = () => editor.cursor.line >= editor.getText().split("\n").length - 1;
+    /** `app.agents.focus`：进栏返回 true；落空给提示后返回 false（按键照常交给编辑器）。 */
+    const focusAgents = (agents, data) => {
+        if (editor.isCompletionOpen || editor.isBrowsingHistory)
+            return false;
+        const result = agents.focus(data);
+        if (result === true) {
+            // 进栏了：撤掉之前的落空提示
+            if (focusHintShown)
+                deps.showHint("");
+            focusHintShown = false;
+            return true;
+        }
+        const m = msg().agents;
+        let text;
+        if (result === "busy-input") {
+            if (busyInputHinted || !atLastLine())
+                return false;
+            busyInputHinted = true;
+            text = m.focus.busyInput(deps.downGlyph ?? "↓");
+        }
+        else if (result === "disabled")
+            text = m.focus.disabled;
+        else if (result === "empty")
+            text = m.bar.empty;
+        if (text !== undefined) {
+            deps.showHint(text, FOCUS_HINT_MS);
+            focusHintShown = true;
+        }
+        return false;
+    };
     return (data) => {
         if (deps.inactive())
             return false;
+        if (editor.isEmpty())
+            busyInputHinted = false;
         const is = (action) => keys.matches(data, action);
         if (!is("app.rewind"))
             esc.reset();
@@ -99,12 +144,16 @@ export function createKeyDispatch(deps) {
             esc.reset();
             return true;
         }
-        if (agents !== undefined &&
-            is("app.agents.focus") &&
-            editor.isEmpty() &&
-            !editor.isCompletionOpen &&
-            agents.focus(data))
+        if (agents !== undefined && is("app.agents.focus") && focusAgents(agents, data))
             return true;
+        if (is("app.tasks.background") && deps.backgroundTasks !== undefined) {
+            const moved = deps.backgroundTasks();
+            if (moved.length > 0) {
+                esc.reset();
+                deps.showHint(backgroundedText(moved), FOCUS_HINT_MS);
+                return true;
+            }
+        }
         if (is("app.clear")) {
             if (!editor.isEmpty()) {
                 editor.clear();
@@ -124,7 +173,10 @@ export function createKeyDispatch(deps) {
         if (is("app.interrupt") && !editor.isCompletionOpen && deps.busy()) {
             esc.reset();
             interrupt();
-            deps.showHint(msg().interactive.keys.interrupted);
+            const left = deps.runningBackground?.() ?? [];
+            deps.showHint(left.length > 0
+                ? msg().agents.background.interrupted(left.join(", "))
+                : msg().interactive.keys.interrupted);
             deps.onInterrupted?.(editor.isEmpty());
             return true;
         }

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

@@ -194,6 +194,11 @@ export async function runLineMode(runtime, context, options = {}) {
                     continue;
                 }
                 if (busy) {
+                    // [W7-C] 运行中 `/tasks bg [id]` 照样是命令（转后台阻塞中的前台任务），不当插话
+                    if (/^\/tasks\s+bg(\s+\S+)?\s*$/.test(action.text.trim())) {
+                        void handle(action.text.trim());
+                        continue;
+                    }
                     if (action.text.trim() !== "") {
                         void session.steer(action.text).catch(() => undefined);
                         out(`${msg().interactive.line.steer(action.text)}\n`);

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

@@ -9,6 +9,10 @@
  *   助手在流式输出 → 末块是思考 `思考中`，否则 `回复中 · ↓≈1.2k`（本条输出的估算 token，4 字符 ≈ 1）
  *   其余（等首个 token）→ `思考中`
  * 运行或压缩时 Loader 才挂进槽位；附加项 `Esc 中断`。
+ * [W7-A] 有该显示的子 Agent 任务时再带可丢弃的 `↓ Agent 栏`（窄屏先丢它）；任务随时出现 / 结束，
+ * 每帧对一次，变了才换动词。
+ * [W7-C] 有阻塞中的前台任务时可丢弃项前面加 `Ctrl+B 转后台`；有停靠的审批时 `↓ Agent 栏` 换成
+ * `↓ 处理审批`。顺序 `Esc 中断 · Ctrl+B 转后台 · ↓ Agent 栏`，窄屏从后往前丢。
  *
  * 排队消息：缩进 2 列（挂在当前回合下），`↳ 插话 / 之后  文本` 整体 muted、标签 dim；超过 3 条首行
  * `… 另 N 条`；末行 `Alt+↑ 取回 · Esc 回填并中断`。
@@ -24,6 +28,8 @@ export interface RunIndicatorDeps {
     slot: Container;
     tools: ToolTracker;
     render(): void;
+    /** [W7-C] `app.tasks.background` 的按键标签（`Ctrl+B`）；没有绑定时不提示。 */
+    backgroundKey?: string;
 }
 export declare class RunIndicator {
     private readonly deps;
@@ -32,7 +38,16 @@ export declare class RunIndicator {
     private approval;
     private retry;
     private stream;
+    /** [W7-A] 有该显示的子 Agent 任务（interactive-mode 在 AgentUi 建好后接上）。 */
+    agents: () => boolean;
+    /** [W7-C] 有阻塞中的前台任务（Ctrl+B 可转后台）。 */
+    background: () => boolean;
+    /** [W7-C] 有停靠在 Agent 栏的审批。 */
+    docked: () => boolean;
+    private hintKey;
     constructor(deps: RunIndicatorDeps);
+    /** 可丢弃的按键提示（按丢弃的逆序排列）。 */
+    private optionalHints;
     get busy(): boolean;
     setApproval(open: boolean): void;
     /** 会话切换后清零。 */