@armadra/agent 0.6.1 → 0.6.3

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

@@ -13,12 +13,14 @@
  * - 显示条件：有排队 / 运行中 / 等审批的任务，或本会话里看着结束、还没查看过的任务（结束后最多 10 分钟）；
  *   `ui.agentBar: "off"`（嵌入宿主缺省）整个不显示。
  * - 聚焦（`Ctrl+B` / 空输入 `↓` / `/tasks`）：列出本会话全部任务，`›` 标当前项，窗口跟着选择滚动，
- *   末行是按键提示。按键处理在 agent-ui.ts。
+ *   末行是按键提示（`↑↓ 选择 · Enter 打开 · b 转后台 · x 停止 · Esc 返回`，放不下时丢 b / x 说明）。
+ *   按键处理在 agent-ui.ts。
+ * - [W7-C] 等审批的行（含停靠在栏里的后台任务审批）整行警告色。
  * - 状态来自任务注册表（`TaskInfo`、`live().queued`）、子 Agent 折叠视图的跟踪（轮数、最近工具、用时，界面时钟）
  *   与 `permission_request.context.taskId`（等审批）。
  */
 import { msg } from "../../i18n/index.js";
-import { formatElapsed, truncateToWidth } from "../../tui.js";
+import { formatElapsed, truncateToWidth, visibleWidth, } from "../../tui.js";
 export const BAR_ROWS = 3;
 /** 结束后未查看的任务在栏里保留多久。 */
 export const BAR_RETAIN_MS = 10 * 60_000;
@@ -224,8 +226,11 @@ export class AgentBar {
         const tail = [];
         if (hidden > 0)
             tail.push(m.bar.more(hidden));
-        if (focused)
-            tail.push(m.bar.keys(t.glyphs.arrowUp, t.glyphs.arrowDown));
+        if (focused) {
+            const [up, down] = [t.glyphs.arrowUp, t.glyphs.arrowDown];
+            const full = [...tail, m.bar.keysFull(up, down)].join(" · ");
+            tail.push(visibleWidth(full) <= width ? m.bar.keysFull(up, down) : m.bar.keys(up, down));
+        }
         if (tail.length > 0)
             out.push(truncateToWidth(t.fg("dim", tail.join(" · ")), width, t.glyphs.ellipsis));
         return out;
@@ -236,7 +241,9 @@ export class AgentBar {
         const agent = agentLabel(row);
         const lead = focused ? (selected ? t.fg("accent", g.prompt) : " ") + " " : "";
         const marker = t.fg(statusColor(row.status), g.tool);
-        const id = selected ? t.bold(row.taskId) : row.taskId;
+        const approval = row.status === "approval";
+        const plainId = selected || approval ? t.bold(row.taskId) : row.taskId;
+        const id = approval ? t.fg("warning", plainId) : plainId;
         const description = row.description.replace(/\s+/g, " ").trim();
         const text = `${lead}${marker} ${id} ${t.fg("tool", agent)}` +
             t.fg("dim", " · ") +

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

@@ -13,10 +13,14 @@
  * 事件；这里在会话的 `options.log` 外面套一层，只把这类行转到消息区，其余照原样写日志。
  *
  * [W6-A] Agent 栏（agent-bar.ts，提示行之下、状态行之上）与子 Agent 视图（agent-view.ts，底部覆盖层）：
- * - 键位：空输入时 `Ctrl+B`（有任务即可）或 `↓`（栏可见时）进栏（`app.agents.focus`，key-dispatch.ts 先问这里）；
- *   栏内 ↑↓ 选、Enter 打开视图、Esc / Ctrl+B 返回，可打印字符回到输入框；
+ * - 键位：空输入时 `↓`（有任务即可，不要求栏可见；`app.agents.focus`，key-dispatch.ts 先问这里）进栏；
+ *   有字 / 栏关闭 / 没有任务时返回落空原因，由 key-dispatch 给提示 [W7-A]；
+ *   栏内 ↑↓ 选、Enter 打开视图、Esc 返回，可打印字符回到输入框；
  * - `/tasks` 无参 = 聚焦栏（`ui.agentBar: "off"` 时仍是原来的选择器），`/tasks <id>` = 直接进视图；
  * - 等审批的任务按 `permission_request.context.taskId` 记下（栏与视图标题显示「等待审批」）。
+ * [W7-C] 栏内 `b` / `Ctrl+B` 转后台选中的任务、`x` 连按两次停止（task-background.ts）；`subagent_background`
+ * 刷新工具行（后台样式）并对超时 / 宿主转的给一行提示；后台任务的审批停靠（approval-dock.ts）：打开该任务
+ * 的视图即弹出，`permission_request` / `permission_resolved` 交给停靠判断。
  */
 import type { AgentSession, SessionEvent } from "../../agent/types.js";
 import type { SwitchRequest } from "../../cli/compose-session.js";
@@ -27,6 +31,7 @@ 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 { ApprovalDock } from "./approval-dock.js";
 import type { NoticeLevel } from "./message-view.js";
 import type { PickerSpec } from "./pickers.js";
 import { PlanFlow } from "./plan-flow.js";
@@ -76,6 +81,10 @@ export declare class AgentUi {
     private restoreLog;
     /** 后台子 Agent 运行中：每秒重画跟随行的耗时（主会话空闲时 Loader 不转）。 */
     private ticker;
+    /** [W7-C] 后台任务的审批停靠（approval-ui.ts 建好后接上）。 */
+    dock: ApprovalDock | undefined;
+    /** [W7-C] 栏内 `x` 的双击确认。 */
+    private readonly stopArm;
     constructor(deps: AgentUiDeps);
     private keybindings;
     private barEnabled;
@@ -93,10 +102,19 @@ export declare class AgentUi {
     private showPlan;
     /** `/tasks`（无参）：聚焦 Agent 栏；栏关闭（嵌入宿主缺省）时仍是选择器。 */
     focusBar(): Promise<void>;
-    /** `app.agents.focus`（输入为空）：`↓` 只在栏可见时进入，其它键（`Ctrl+B`）有任务即可。 */
+    /**
+     * `app.agents.focus`：输入为空且有任务即进栏（与 `/tasks` 一致，不要求栏可见）[W7-A]；
+     * 否则返回落空原因——有字（有任务时）、栏关闭（有任务时）、没有任务（栏开着时）。
+     */
     private focusFromKey;
+    /** [W7-A] 运行提示行要不要带「↓ Agent 栏」：栏开着、有该显示的任务、没在栏里或视图里。 */
+    get reachable(): boolean;
     /** 栏聚焦时的按键；不在栏里返回 false。 */
     private barKey;
+    /** [W7-C] 栏内 `b` / `Ctrl+B`：转后台选中的任务（只对前台运行中的有效）。 */
+    private backgroundSelected;
+    /** [W7-C] 栏内 `x`：第一次提示「再按 x 停止」，1.5 s 内再按停止。 */
+    private stopSelected;
     /** `/tasks <id>` 与栏里 Enter：打开子 Agent 视图。 */
     openView(taskId: string): void;
     get viewing(): string | undefined;

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

@@ -13,24 +13,29 @@
  * 事件；这里在会话的 `options.log` 外面套一层，只把这类行转到消息区，其余照原样写日志。
  *
  * [W6-A] Agent 栏（agent-bar.ts，提示行之下、状态行之上）与子 Agent 视图（agent-view.ts，底部覆盖层）：
- * - 键位：空输入时 `Ctrl+B`（有任务即可）或 `↓`（栏可见时）进栏（`app.agents.focus`，key-dispatch.ts 先问这里）；
- *   栏内 ↑↓ 选、Enter 打开视图、Esc / Ctrl+B 返回，可打印字符回到输入框；
+ * - 键位：空输入时 `↓`（有任务即可，不要求栏可见；`app.agents.focus`，key-dispatch.ts 先问这里）进栏；
+ *   有字 / 栏关闭 / 没有任务时返回落空原因，由 key-dispatch 给提示 [W7-A]；
+ *   栏内 ↑↓ 选、Enter 打开视图、Esc 返回，可打印字符回到输入框；
  * - `/tasks` 无参 = 聚焦栏（`ui.agentBar: "off"` 时仍是原来的选择器），`/tasks <id>` = 直接进视图；
  * - 等审批的任务按 `permission_request.context.taskId` 记下（栏与视图标题显示「等待审批」）。
+ * [W7-C] 栏内 `b` / `Ctrl+B` 转后台选中的任务、`x` 连按两次停止（task-background.ts）；`subagent_background`
+ * 刷新工具行（后台样式）并对超时 / 宿主转的给一行提示；后台任务的审批停靠（approval-dock.ts）：打开该任务
+ * 的视图即弹出，`permission_request` / `permission_resolved` 交给停靠判断。
  */
 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 { defaultKeybindings, isPrintableText, } 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";
-import { backgroundJobText, limitReachedText, modelFallbackText } from "./event-notices.js";
+import { backgroundJobText, limitReachedText, modelFallbackText, subagentBackgroundText, } from "./event-notices.js";
 import { editExternally } from "./external-editor.js";
 import { PlanFlow } from "./plan-flow.js";
 import { backgroundEndText, SubagentTracker } from "./subagent-view.js";
+import { backgroundedText, StopArm } from "./task-background.js";
 import { listTasks, stopTask, taskLine, taskOutput } from "./tasks-report.js";
 /** [W6-A] `CommandUi` 的 Agent 栏 / 视图钩子（`/tasks`、`/tasks <id>`）；晚绑定，装配时 agentUi 还没建。 */
 export function agentCommandHooks(get) {
@@ -49,7 +54,7 @@ export class AgentUi {
     /** [W6-A] key-dispatch.ts 的 Agent 栏入口。 */
     keys = {
         handleKey: (data) => this.barKey(data),
-        focus: (data) => this.focusFromKey(data),
+        focus: () => this.focusFromKey(),
     };
     view;
     /** 等审批的请求 → 任务。 */
@@ -57,6 +62,10 @@ export class AgentUi {
     restoreLog;
     /** 后台子 Agent 运行中：每秒重画跟随行的耗时（主会话空闲时 Loader 不转）。 */
     ticker;
+    /** [W7-C] 后台任务的审批停靠（approval-ui.ts 建好后接上）。 */
+    dock;
+    /** [W7-C] 栏内 `x` 的双击确认。 */
+    stopArm = new StopArm();
     constructor(deps) {
         this.deps = deps;
         this.merge = new FirstRunMerge({ sessionId: () => deps.session().state.sessionId });
@@ -107,6 +116,7 @@ export class AgentUi {
             this.deps.notice("info", msg().agents.view.removed(viewing));
         this.bar.reset();
         this.approvals.clear();
+        this.dock?.reset();
         this.deps.subagents.clear();
         this.stopTicker();
         this.plan.attach(session);
@@ -171,10 +181,14 @@ export class AgentUi {
         switch (event.type) {
             case "subagent_start":
             case "subagent_update":
+            case "subagent_background":
             case "subagent_end": {
                 const state = this.deps.subagents.onEvent(event);
                 if (state === undefined)
                     return true;
+                // [W7-C] 人按的已有底部提示；超时 / 宿主转的留一行
+                if (event.type === "subagent_background" && event.reason !== "user")
+                    this.deps.notice("info", subagentBackgroundText(event, state.agent));
                 this.deps.tools().get(state.parentToolCallId)?.refresh();
                 // 视图里看的任务又开跑（续聊、被释放后重开）：重新接上它的子会话
                 if (event.type === "subagent_start" && this.view?.component.task === event.taskId)
@@ -198,11 +212,20 @@ export class AgentUi {
                 const taskId = event.context?.taskId;
                 if (taskId !== undefined)
                     this.approvals.set(event.requestId, taskId);
+                this.dock?.observe(event);
                 return false;
             }
             case "permission_resolved":
                 this.approvals.delete(event.requestId);
+                this.dock?.observe(event);
                 return false;
+            case "agent_settled": {
+                // 主会话空闲了：停靠的审批看能不能弹（运行指示要等这个事件分派完才变空闲）
+                const dock = this.dock;
+                if (dock !== undefined && dock.size > 0)
+                    setTimeout(() => dock.poke(), 0);
+                return false;
+            }
             default:
                 return false;
         }
@@ -250,23 +273,39 @@ export class AgentUi {
         }
         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)
+    /**
+     * `app.agents.focus`：输入为空且有任务即进栏（与 `/tasks` 一致，不要求栏可见）[W7-A]；
+     * 否则返回落空原因——有字（有任务时）、栏关闭（有任务时）、没有任务（栏开着时）。
+     */
+    focusFromKey() {
+        if (this.view !== undefined)
             return false;
+        const hasTasks = this.bar.all().length > 0;
+        if (!this.barEnabled())
+            return hasTasks && this.deps.editor.isEmpty() ? "disabled" : false;
+        if (!this.deps.editor.isEmpty())
+            return hasTasks ? "busy-input" : false;
         if (!this.bar.focus())
-            return false;
+            return "empty";
         this.deps.render();
         return true;
     }
+    /** [W7-A] 运行提示行要不要带「↓ Agent 栏」：栏开着、有该显示的任务、没在栏里或视图里。 */
+    get reachable() {
+        return this.view === undefined && !this.bar.focused && this.bar.visible;
+    }
     /** 栏聚焦时的按键；不在栏里返回 false。 */
     barKey(data) {
         if (!this.bar.focused)
             return false;
         const keys = this.keybindings();
-        if (keys.matches(data, "tui.select.up")) {
+        if (data !== "x")
+            this.stopArm.reset();
+        if (data === "b" || keys.matches(data, "app.tasks.background"))
+            this.backgroundSelected();
+        else if (data === "x")
+            void this.stopSelected();
+        else if (keys.matches(data, "tui.select.up")) {
             if (!this.bar.move(-1))
                 this.bar.blur();
         }
@@ -288,6 +327,33 @@ export class AgentUi {
         this.deps.render();
         return true;
     }
+    /** [W7-C] 栏内 `b` / `Ctrl+B`：转后台选中的任务（只对前台运行中的有效）。 */
+    backgroundSelected() {
+        const taskId = this.bar.selected();
+        if (taskId === undefined)
+            return;
+        const moved = this.deps.session().backgroundTask(taskId, "user");
+        this.deps.hint(moved.length > 0 ? backgroundedText(moved) : msg().agents.background.notForeground(taskId));
+    }
+    /** [W7-C] 栏内 `x`：第一次提示「再按 x 停止」，1.5 s 内再按停止。 */
+    async stopSelected() {
+        const taskId = this.bar.selected();
+        if (taskId === undefined)
+            return;
+        const sessionId = this.deps.session().state.sessionId;
+        if (taskRegistryView(sessionId)?.get(taskId)?.status !== "running") {
+            this.stopArm.reset();
+            this.deps.hint(msg().agents.stop.ended(taskId));
+            return;
+        }
+        if (this.stopArm.press(taskId, this.deps.now()) === "arm") {
+            this.deps.hint(msg().agents.stop.confirm(taskId));
+            return;
+        }
+        this.deps.hint(msg().agents.view.stopped(taskId));
+        await stopTask(sessionId, taskId);
+        this.deps.render();
+    }
     /** `/tasks <id>` 与栏里 Enter：打开子 Agent 视图。 */
     openView(taskId) {
         const sessionId = this.deps.session().state.sessionId;
@@ -309,6 +375,7 @@ export class AgentUi {
             siblings: () => this.bar.all().map((row) => row.taskId),
             close: () => this.closeView(),
             stop: (id) => stopTask(this.deps.session().state.sessionId, id),
+            background: (id) => this.deps.session().backgroundTask(id, "user"),
             messages: {
                 ...(ui.showThinking !== undefined ? { showThinking: ui.showThinking } : {}),
                 ...(ui.markdown !== undefined ? { markdown: ui.markdown } : {}),
@@ -319,6 +386,8 @@ export class AgentUi {
         this.bar.blur();
         const handle = this.deps.tui.showOverlay(component, { anchor: "bottom" });
         this.view = { component, handle };
+        // [W7-C] 正在看的任务有停靠的审批：立即弹出（盖在视图上）
+        this.dock?.poke();
         this.deps.render();
     }
     get viewing() {

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

@@ -16,6 +16,8 @@
  * `↑` / PgUp 上翻（暂停跟随）、`↓` / PgDn 下翻、End（暂停时也可 `f`）回到跟随；输入非空时 Esc 清空。
  * Esc 不中断父会话，停止子任务用 `/tasks stop <id>`（视图里只认这一条命令）。
  * 所查看的任务在等审批时标题显示「等待审批」，审批框照常以覆盖层弹在视图上面。
+ * [W7-C] `Ctrl+B`（`app.tasks.background`）转后台正在看的任务（只对前台任务有效，否则落回编辑器）；
+ * 视图里另认 `/tasks bg [id]`。
  */
 import { type Component, type Focusable, type Keybindings, type Theme } from "../../tui.js";
 import { type TaskSource } from "./agent-bar.js";
@@ -37,6 +39,8 @@ export interface AgentViewDeps {
     onSwitch?(taskId: string): void;
     close(): void;
     stop(taskId: string): Promise<void>;
+    /** [W7-C] 人工转后台；返回转了的 taskId。 */
+    background?(taskId: string): string[];
     /** 消息区的显示选项（思考块、Markdown、紧凑）。 */
     messages?: Omit<MessageViewOptions, "theme">;
 }

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

@@ -16,12 +16,15 @@
  * `↑` / PgUp 上翻（暂停跟随）、`↓` / PgDn 下翻、End（暂停时也可 `f`）回到跟随；输入非空时 Esc 清空。
  * Esc 不中断父会话，停止子任务用 `/tasks stop <id>`（视图里只认这一条命令）。
  * 所查看的任务在等审批时标题显示「等待审批」，审批框照常以覆盖层弹在视图上面。
+ * [W7-C] `Ctrl+B`（`app.tasks.background`）转后台正在看的任务（只对前台任务有效，否则落回编辑器）；
+ * 视图里另认 `/tasks bg [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";
+import { backgroundedText } from "./task-background.js";
 export class AgentView {
     taskId;
     deps;
@@ -142,7 +145,10 @@ export class AgentView {
         const taskId = this.taskId;
         if (trimmed.startsWith("/")) {
             const stop = /^\/tasks\s+stop(?:\s+(\S+))?\s*$/.exec(trimmed);
-            if (stop === null)
+            const bg = /^\/tasks\s+bg(?:\s+(\S+))?\s*$/.exec(trimmed);
+            if (bg !== null && this.deps.background !== undefined)
+                this.flash = backgroundedText(this.deps.background(bg[1] ?? taskId));
+            else if (stop === null)
                 this.flash = m.commandsHere;
             else {
                 const target = stop[1] ?? taskId;
@@ -175,6 +181,13 @@ export class AgentView {
         const empty = this.editor.isEmpty();
         const id = parseKey(data)?.id;
         this.flash = undefined;
+        if (keys.matches(data, "app.tasks.background") && this.deps.background !== undefined) {
+            const moved = this.deps.background(this.taskId);
+            if (moved.length > 0) {
+                this.flash = backgroundedText(moved);
+                return;
+            }
+        }
         if (keys.matches(data, "tui.select.cancel") && !this.editor.isCompletionOpen) {
             if (!empty)
                 this.editor.clear();

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

@@ -0,0 +1,51 @@
+/**
+ * 后台任务的审批停靠（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，行为不变。
+ */
+import type { SessionEvent } from "../../agent/types.js";
+import type { ApprovalBroker, ApprovalDecision, ApprovalRequest } from "../../permissions/types.js";
+export declare const DOCK_POLL_MS = 250;
+export interface DockHost {
+    /** 任务在后台运行（停靠候选）。 */
+    dockable(taskId: string): boolean;
+    /** 现在可以弹出这个任务的审批（主会话空闲且空输入且无覆盖层，或正在看它的视图）。 */
+    ready(taskId: string): boolean;
+    /** 停靠集合变了（栏与运行提示行重画）。 */
+    changed(): void;
+    pollMs?: number;
+}
+export declare class ApprovalDock implements ApprovalBroker {
+    private readonly inner;
+    private readonly host;
+    private readonly docked;
+    /** 已发出、还没答复的不可停靠请求（主会话 / 前台任务）。 */
+    private readonly others;
+    private timer;
+    constructor(inner: ApprovalBroker, host: DockHost);
+    ask(request: ApprovalRequest, signal: AbortSignal): Promise<ApprovalDecision | undefined>;
+    /** 停靠中的任务。 */
+    tasks(): ReadonlySet<string>;
+    get size(): number;
+    /** 会话事件：记下不可停靠的请求；停靠期间来了这种请求就放出停靠的（见文件头）。 */
+    observe(event: SessionEvent): void;
+    /** 对一次弹出条件（定时器、视图打开、回合结束）。 */
+    poke(): void;
+    /** 换会话：旧会话的未答复请求不再有 `permission_resolved` 到这里。 */
+    reset(): void;
+    /** 退出：停靠的请求按 undefined 交回链（链按拒绝处理）。 */
+    dispose(): void;
+    private release;
+    private remove;
+    private startPolling;
+    private stopPolling;
+}

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;