@armadra/agent 0.6.2 → 0.6.3

package/dist/i18n/messages/settings.js

@@ -25,6 +25,7 @@ export const en = {
         "ui.showThinking": "Thinking display",
         "ui.compact": "Compact layout",
         "ui.animation": "Spinner animation",
+        "ui.logo": "Startup logo",
         "ui.statusLine": "Status line",
         "ui.restoreOnCancel": "Restore on cancel",
         "ui.quietStartup": "Startup screen",
@@ -84,6 +85,8 @@ export const en = {
         "agents.sessionBudgetUsd": "External agent budget",
         "subagents.maxConcurrent": "Subagents in parallel",
         "subagents.maxPending": "Subagent queue limit",
+        "subagents.background": "Subagents in background",
+        "subagents.autoBackgroundAfterMs": "Auto-background after (ms)",
         "memory.enabled": "Memory",
         "memory.subagents": "Memory in subagents",
     },
@@ -193,6 +196,7 @@ export const zh = {
         "ui.showThinking": "思考内容",
         "ui.compact": "紧凑布局",
         "ui.animation": "spinner 动画",
+        "ui.logo": "启动字符画",
         "ui.statusLine": "底部信息行",
         "ui.restoreOnCancel": "中断后放回原消息",
         "ui.quietStartup": "启动画面",
@@ -252,6 +256,8 @@ export const zh = {
         "agents.sessionBudgetUsd": "外部 Agent 预算",
         "subagents.maxConcurrent": "子 Agent 并发",
         "subagents.maxPending": "子 Agent 排队上限",
+        "subagents.background": "子 Agent 缺省后台",
+        "subagents.autoBackgroundAfterMs": "自动转后台（毫秒）",
         "memory.enabled": "记忆",
         "memory.subagents": "子 Agent 的记忆",
     },

package/dist/i18n/messages/subcommands-config.d.ts

@@ -48,6 +48,8 @@ export declare const en: {
         listFailed: (provider: string, error: string) => string;
         found: (provider: string, count: number, url: string) => string;
         unmatched: string;
+        fromBackend: string;
+        noBackendWindow: (ids: string) => string;
         image: string;
         reasoning: string;
         noTools: string;
@@ -101,6 +103,8 @@ export declare const zh: {
         listFailed: (provider: string, error: string) => string;
         found: (provider: string, count: number, url: string) => string;
         unmatched: string;
+        fromBackend: string;
+        noBackendWindow: (ids: string) => string;
         image: string;
         reasoning: string;
         noTools: string;

package/dist/i18n/messages/subcommands-config.js

@@ -56,6 +56,8 @@ export const en = {
         listFailed: (provider, error) => `ama: failed to fetch the model list of ${provider}: ${error}\n`,
         found: (provider, count, url) => `${provider}: found ${plural(count, "model")} (${url})\n`,
         unmatched: "  models.dev: no match",
+        fromBackend: " (backend)",
+        noBackendWindow: (ids) => `The backend did not report a context window for ${ids}; using models.dev (128k when unmatched)\n`,
         image: " · image",
         reasoning: " · reasoning",
         noTools: " · no tool calling",
@@ -116,6 +118,8 @@ export const zh = {
         listFailed: (provider, error) => `ama: ${provider} 模型列表获取失败：${error}\n`,
         found: (provider, count, url) => `${provider}：发现 ${count} 个模型（${url}）\n`,
         unmatched: "  models.dev 未匹配",
+        fromBackend: "（后端）",
+        noBackendWindow: (ids) => `后端没有给出 ${ids} 的上下文窗口，改用 models.dev 的值（未匹配时按 128k）\n`,
         image: " · 图片",
         reasoning: " · 思考",
         noTools: " · 不支持工具调用",

package/dist/i18n/messages/subcommands.d.ts

@@ -280,6 +280,8 @@ export declare const en: {
         listFailed: (provider: string, error: string) => string;
         found: (provider: string, count: number, url: string) => string;
         unmatched: string;
+        fromBackend: string;
+        noBackendWindow: (ids: string) => string;
         image: string;
         reasoning: string;
         noTools: string;
@@ -564,6 +566,8 @@ export declare const zh: {
         listFailed: (provider: string, error: string) => string;
         found: (provider: string, count: number, url: string) => string;
         unmatched: string;
+        fromBackend: string;
+        noBackendWindow: (ids: string) => string;
         image: string;
         reasoning: string;
         noTools: string;

package/dist/index.d.ts

@@ -38,6 +38,7 @@ export { createAgentSession, createRuntime } from "./sdk.js";
 export type { CreateSessionOptions, RuntimeOptions, SessionAuth } from "./sdk.js";
 export type { PlanDecision, PlanResponse, PlanResponseResult, SdkAgentSession, SessionPlanApi, SessionPlanOptions, } from "./sdk.js";
 export { AgentSessionImpl } from "./agent/session.js";
+export type { BackgroundReason } from "./agent/subagent-background.js";
 export { SessionManager } from "./session/manager.js";
 export { ProviderRegistry } from "./ai/providers/registry.js";
 export { FakeProvider } from "./ai/fake/fake-provider.js";

package/dist/modes/commands-core.js

@@ -22,6 +22,7 @@ import { pasteImage } from "./interactive/clipboard-paste.js";
 import { planCommand } from "./interactive/plan-command.js";
 import { rewindCommand } from "./interactive/rewind-command.js";
 import { describeAgents, describeTaskOutput, describeTasks, stopTask, } from "./interactive/tasks-report.js";
+import { backgroundTasks, backgroundedText } from "./interactive/task-background.js";
 import { describeCache, describeFingerprint, describeSession } from "./session-report.js";
 import { msg } from "../i18n/index.js";
 export { describeSession } from "./session-report.js";
@@ -63,7 +64,7 @@ export const BUILTIN_COMMANDS = [
     command("cache", "cache", "[warm off|streaming|idle | fingerprint]"),
     command("statusline", "statusline", "[full|compact]"),
     command("plan", "plan", { key: "planArgs" }),
-    command("tasks", "tasks", "[id] | stop <id>"),
+    command("tasks", "tasks", "[id] | stop <id> | bg [id]"),
     command("agents", "agents"),
     command("paste", "paste"),
     command("exit", "exit"),
@@ -110,12 +111,15 @@ function cacheCommand(session, args) {
     }
     throw new AmaError("invalid_arguments", msg().report.command.cacheUsage);
 }
-/** `/tasks`、`/tasks <id>`、`/tasks stop <id>`。 */
-async function tasksCommand(sessionId, args) {
+/** `/tasks`、`/tasks <id>`、`/tasks stop <id>`、`/tasks bg [id]`（[W7-C] 无 id = 全部前台任务）。 */
+async function tasksCommand(session, args) {
+    const sessionId = session.state.sessionId;
     const [first, second, extra] = args.split(/\s+/).filter((s) => s !== "");
     const now = Date.now();
     if (first === undefined)
         return describeTasks(sessionId, now);
+    if (first === "bg" && extra === undefined)
+        return backgroundedText(backgroundTasks(session, second));
     if (first === "stop" && second !== undefined && extra === undefined) {
         await stopTask(sessionId, second);
         return msg().report.command.taskStopped(second);
@@ -241,7 +245,7 @@ export async function runSlashCommand(line, ctx) {
         case "plan":
             return planCommand(session, args, ctx);
         case "tasks":
-            return { kind: "handled", message: await tasksCommand(session.state.sessionId, args) };
+            return { kind: "handled", message: await tasksCommand(session, args) };
         case "agents":
             return { kind: "handled", message: describeAgents(session.state.sessionId) };
         case "paste": {

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

@@ -13,7 +13,9 @@
  * - 显示条件：有排队 / 运行中 / 等审批的任务，或本会话里看着结束、还没查看过的任务（结束后最多 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`（等审批）。
  */

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;
+}