@armadra/agent 0.6.2 → 0.6.3

package/dist/modes/interactive/task-background.js

@@ -0,0 +1,68 @@
+/**
+ * 前台子 Agent 任务转后台与栏内停止的界面接线（docs/agents-concurrency-plan.md §2.4、§2.8）。[W7-C]
+ *
+ * - `Ctrl+B`（`app.tasks.background`）：有阻塞中的前台任务（`registry.blocking()`，含 `task_ctl wait`）时
+ *   全部转后台（`session.backgroundTask(undefined, "user")`），不看输入框；没有时落回编辑器。
+ * - 栏内 `b` / `Ctrl+B`：转后台选中的任务；`x`：1.5 s 内连按两次停止（`StopArm`）。
+ * - `/tasks bg [id]`（commands-core.ts，line 模式同）：同 Ctrl+B / 指定任务。
+ * - Esc 中断只连带前台任务：仍在运行的后台任务写进中断提示（`runningBackground`）。
+ */
+import { registryOf } from "../../agent/subagent-registry.js";
+import { msg } from "../../i18n/index.js";
+/** 栏内 `x` 两次之间的最长间隔。 */
+export const STOP_CONFIRM_MS = 1500;
+/** 正在阻塞父回合的任务（前台运行中、或有 `task_ctl wait` 在等）。 */
+export function blockingTasks(session) {
+    return registryOf(session.state.sessionId)?.blocking() ?? [];
+}
+/** 人工转后台：不给 taskId = 全部阻塞中的任务（没有时不调用，返回空）。 */
+export function backgroundTasks(session, taskId) {
+    if (taskId === undefined && blockingTasks(session).length === 0)
+        return [];
+    return session.backgroundTask(taskId, "user");
+}
+/** 仍在运行的后台任务（Esc 中断不影响它们）。 */
+export function runningBackground(session) {
+    const registry = registryOf(session.state.sessionId);
+    if (registry === undefined)
+        return [];
+    return registry
+        .list()
+        .filter((task) => task.status === "running" && task.background)
+        .map((task) => task.taskId);
+}
+/** 转后台后的一行提示；没有转任何任务时给「没有可转的」。 */
+export function backgroundedText(ids) {
+    const m = msg().agents.background;
+    return ids.length === 0 ? m.none : m.done(ids.join(", "));
+}
+/** `ctrl+b` → `Ctrl+B`（提示行用）；动作没有绑定时 undefined。 */
+export function keyLabel(keys, action) {
+    const id = keys.keys(action)[0];
+    if (id === undefined)
+        return undefined;
+    return id
+        .split("+")
+        .map((part) => part.length === 1 ? part.toUpperCase() : part[0].toUpperCase() + part.slice(1))
+        .join("+");
+}
+/** 栏内 `x` 的双击确认：第一次 `arm`（提示「再按 x 停止」），间隔内对同一任务再按为 `stop`。 */
+export class StopArm {
+    windowMs;
+    armed;
+    constructor(windowMs = STOP_CONFIRM_MS) {
+        this.windowMs = windowMs;
+    }
+    press(taskId, now) {
+        const armed = this.armed;
+        if (armed !== undefined && armed.taskId === taskId && now - armed.at < this.windowMs) {
+            this.armed = undefined;
+            return "stop";
+        }
+        this.armed = { taskId, at: now };
+        return "arm";
+    }
+    reset() {
+        this.armed = undefined;
+    }
+}

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

@@ -11,7 +11,8 @@
  * - 运行中摘要行 `⎿ ⠋ 运行中 · 4s`：spinner 与底部 Loader 同帧（ToolTracker.tick 由 Loader.onFrame 驱动），
  *   标题行不变；bash 流式显示尾部 8 行（muted）。task 显示 `子 Agent · 运行中 1m05s`；有 `subagent_*`
  *   事件时（W5-U，subagent-view.ts）改为 `explore · 运行中 1m05s · 3 轮 · 最近 3 个工具 · ↑↓`，后台任务
- *   在结果摘要下多一行跟随状态。
+ *   在结果摘要下多一行跟随状态。[W7-C] 工具已返回而任务仍在后台跑（`details.status: "running"`）：摘要行
+ *   `⎿ 已转后台 · 12s`（前台转后台）/ `⎿ 后台运行`（直接后台），给模型的说明文字折叠时不显示。
  * - 折叠（缺省）：结果前 3 行；edit 显示 `details.diff`（`@@` dim、`+` success、`-` error、上下文 muted，
  *   宽 ≥ 60 时带行号列），前 12 行；`Ctrl+O` 展开全部（上限 400 行，长行折行）。
  * - 嵌套：带 `parentToolCallId` 的调用（codemode 脚本里的 `tools.*`）挂在外层调用下、右移 4 列；折叠时只列
@@ -85,6 +86,11 @@ export declare class ToolView implements Component {
     header(width: number): string;
     /** `  ⎿ 摘要`：运行中带 spinner 与秒数，完成后是结果摘要。 */
     summaryLine(width: number): string | undefined;
+    /**
+     * [W7-C] task 已返回、任务仍在后台跑：true = 前台转后台（固定英文结果文本），false = 直接后台；
+     * 其它情况 undefined。
+     */
+    private backgrounded;
     /** 后台子 Agent：结果摘要下一行跟随状态 `    ↳ t2 explore · 完成 2m · 7 轮 …`。 */
     private followLine;
     private custom;

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

@@ -11,7 +11,8 @@
  * - 运行中摘要行 `⎿ ⠋ 运行中 · 4s`：spinner 与底部 Loader 同帧（ToolTracker.tick 由 Loader.onFrame 驱动），
  *   标题行不变；bash 流式显示尾部 8 行（muted）。task 显示 `子 Agent · 运行中 1m05s`；有 `subagent_*`
  *   事件时（W5-U，subagent-view.ts）改为 `explore · 运行中 1m05s · 3 轮 · 最近 3 个工具 · ↑↓`，后台任务
- *   在结果摘要下多一行跟随状态。
+ *   在结果摘要下多一行跟随状态。[W7-C] 工具已返回而任务仍在后台跑（`details.status: "running"`）：摘要行
+ *   `⎿ 已转后台 · 12s`（前台转后台）/ `⎿ 后台运行`（直接后台），给模型的说明文字折叠时不显示。
  * - 折叠（缺省）：结果前 3 行；edit 显示 `details.diff`（`@@` dim、`+` success、`-` error、上下文 muted，
  *   宽 ≥ 60 时带行号列），前 12 行；`Ctrl+O` 展开全部（上限 400 行，长行折行）。
  * - 嵌套：带 `parentToolCallId` 的调用（codemode 脚本里的 `tools.*`）挂在外层调用下、右移 4 列；折叠时只列
@@ -176,6 +177,12 @@ export class ToolView {
             return truncateToWidth(lead + theme.fg("accent", frame) + " " + theme.fg("muted", what), width);
         }
         const result = this.result;
+        const moved = this.backgrounded();
+        if (moved !== undefined) {
+            const m = msg().agents.background;
+            const text = moved ? m.moved(formatElapsed(this.elapsedMs)) : m.started;
+            return truncateToWidth(lead + theme.fg("muted", text), width);
+        }
         const text = resultSummary({
             name: this.toolName,
             args: this.args,
@@ -187,6 +194,19 @@ export class ToolView {
         }, theme);
         return truncateToWidth(lead + text, width);
     }
+    /**
+     * [W7-C] task 已返回、任务仍在后台跑：true = 前台转后台（固定英文结果文本），false = 直接后台；
+     * 其它情况 undefined。
+     */
+    backgrounded() {
+        const result = this.result;
+        if (this.toolName !== "task" || this.state !== "done" || result === undefined)
+            return undefined;
+        const details = result.details;
+        if (details?.status !== "running")
+            return undefined;
+        return /moved to the background/i.test(contentText(result.content));
+    }
     /** 后台子 Agent：结果摘要下一行跟随状态 `    ↳ t2 explore · 完成 2m · 7 轮 …`。 */
     followLine(width) {
         const sub = this.subagentState();
@@ -292,6 +312,9 @@ export class ToolView {
             }
             return out;
         }
+        // [W7-C] 后台运行中的 task：结果是给模型的说明，折叠时不显示（跟随行已有状态）
+        if (!this.expanded && this.backgrounded() !== undefined)
+            return out;
         const custom = this.customResult(width);
         if (custom !== undefined)
             return [...out, ...custom];

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

@@ -21,12 +21,17 @@
  * - [W5-H2] plan 模式产出计划、`plan.unattended: stop`（缺省）没人审批：stderr 一行（计划文件与审批办法）、
  *   json 带 `planPending{planId, version, filePath}`、退出码 9。
  * - [W5-H2] `--image` / `@图片` 超限时按 config `images.resize` 缩放（缺省 auto）。
+ * - [W7-B2] 后台子 Agent（显式 `background:true` 或 `subagents.background: always`）：主回合结束后若还有任务
+ *   在跑或通知待投递，stderr 一行提示并等它们结束、跑完通知回合再输出（最终文本 = 最后一条助手回复）；
+ *   受 `--max-turns` / `--max-cost` / `limits.*` 约束（到限即停止等待，退出码 8），SIGINT / SIGTERM 照常中止
+ *   （未结束的任务随会话关闭被停止）；json 结果带 `tasks`（同 `getStats().tasks`）。
  * - 退出码：最终助手消息 `error / aborted` 或提示被拒 → 1；有工具调用被拒 → 7；到达预算 → 8；
  *   计划待审批 → 9；SIGINT 130、SIGTERM 143（先 abort）。
  */
 import type { CliIo, ModeContext } from "../../cli/deps.js";
 import type { Runtime } from "../../cli/runtime.js";
 import type { LimitReachedEvent, PlanProposedEvent } from "../../agent/types.js";
+import type { AgentSession } from "../../agent/types.js";
 export declare function joinPrompt(argument: string | undefined, piped: string): string;
 /** 等 stdin 多久后提示一次「正在等待」。 */
 export declare const STDIN_WAIT_HINT_MS = 3000;
@@ -39,6 +44,12 @@ export declare function stdinWaitMs(env: Readonly<Record<string, string | undefi
  */
 export declare function readPromptStdin(io: CliIo, prompt: string | undefined, mode: "auto" | "explicit" | "off", hintMs?: number): Promise<string>;
 export declare function runPrintMode(runtime: Runtime, context: ModeContext): Promise<number>;
+/**
+ * [W7-B2] 主回合结束后等后台任务与它们的通知回合（docs/agents-concurrency-plan.md §2.6、§6 Q5）。
+ * `settled()`（subagent-background.ts）等到没有运行中任务且通知投递链（含通知回合）结束；`stopped`：SIGINT /
+ * SIGTERM、stdout 关闭或预算到限时 resolve，立即停止等待。没有子 Agent 注册表时直接返回。
+ */
+export declare function waitBackgroundTasks(session: AgentSession, stopped: Promise<void>, io: Pick<CliIo, "stderr">): Promise<void>;
 /** stderr 一行：计划已落盘待审批（-p 不替人批准）。 */
 export declare function describePlanPending(plan: PlanProposedEvent): string;
 /** stderr 一行：哪个预算到限。 */

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

@@ -21,6 +21,10 @@
  * - [W5-H2] plan 模式产出计划、`plan.unattended: stop`（缺省）没人审批：stderr 一行（计划文件与审批办法）、
  *   json 带 `planPending{planId, version, filePath}`、退出码 9。
  * - [W5-H2] `--image` / `@图片` 超限时按 config `images.resize` 缩放（缺省 auto）。
+ * - [W7-B2] 后台子 Agent（显式 `background:true` 或 `subagents.background: always`）：主回合结束后若还有任务
+ *   在跑或通知待投递，stderr 一行提示并等它们结束、跑完通知回合再输出（最终文本 = 最后一条助手回复）；
+ *   受 `--max-turns` / `--max-cost` / `limits.*` 约束（到限即停止等待，退出码 8），SIGINT / SIGTERM 照常中止
+ *   （未结束的任务随会话关闭被停止）；json 结果带 `tasks`（同 `getStats().tasks`）。
  * - 退出码：最终助手消息 `error / aborted` 或提示被拒 → 1；有工具调用被拒 → 7；到达预算 → 8；
  *   计划待审批 → 9；SIGINT 130、SIGTERM 143（先 abort）。
  */
@@ -29,6 +33,7 @@ import { ExitCode } from "../../cli/exit-codes.js";
 import { errorText, lastAssistant, onStdoutClosed, onTerminationSignals } from "../shared.js";
 import { toJsonLine, toWireEvent } from "./json-event.js";
 import { formatUsd } from "../../agent/limits.js";
+import { registryOf } from "../../agent/subagent-registry.js";
 import { promptImages, sessionModel } from "../image-input.js";
 import { msg } from "../../i18n/index.js";
 export function joinPrompt(argument, piped) {
@@ -118,9 +123,15 @@ export async function runPrintMode(runtime, context) {
     const denied = [];
     let limit;
     let plan;
+    let stopWaiting = () => undefined;
+    const stopped = new Promise((resolve) => {
+        stopWaiting = resolve;
+    });
     const unsubscribe = session.subscribe((event) => {
-        if (event.type === "limit_reached")
+        if (event.type === "limit_reached") {
             limit ??= event;
+            stopWaiting();
+        }
         else if (event.type === "plan_proposed")
             plan = event;
         else if (event.type === "plan_resolved" && event.planId === plan?.planId)
@@ -139,16 +150,25 @@ export async function runPrintMode(runtime, context) {
     let signalled;
     const offSignals = onTerminationSignals((code) => {
         signalled ??= code;
+        stopWaiting();
         void session.abort();
     });
     let stdoutClosed = false;
     const offEpipe = onStdoutClosed(() => {
         stdoutClosed = true;
+        stopWaiting();
         void session.abort();
     });
     let failure;
     try {
         await session.prompt(prompt, images.length > 0 ? { images } : {});
+        const ended = lastAssistant(session)?.stopReason;
+        if (signalled === undefined &&
+            !stdoutClosed &&
+            limit === undefined &&
+            ended !== "error" &&
+            ended !== "aborted")
+            await waitBackgroundTasks(session, stopped, io);
     }
     catch (error) {
         failure = errorText(error);
@@ -183,6 +203,7 @@ export async function runPrintMode(runtime, context) {
             cost: stats.cost,
             cacheHitRate: stats.cacheHitRate,
             ...(stats.cache !== undefined ? { cache: stats.cache } : {}),
+            ...(stats.tasks !== undefined ? { tasks: stats.tasks } : {}),
             ...(denied.length > 0 ? { deniedTools: denied } : {}),
             ...(plan !== undefined
                 ? {
@@ -230,6 +251,20 @@ export async function runPrintMode(runtime, context) {
         return ExitCode.ToolDenied;
     return ExitCode.Ok;
 }
+/**
+ * [W7-B2] 主回合结束后等后台任务与它们的通知回合（docs/agents-concurrency-plan.md §2.6、§6 Q5）。
+ * `settled()`（subagent-background.ts）等到没有运行中任务且通知投递链（含通知回合）结束；`stopped`：SIGINT /
+ * SIGTERM、stdout 关闭或预算到限时 resolve，立即停止等待。没有子 Agent 注册表时直接返回。
+ */
+export async function waitBackgroundTasks(session, stopped, io) {
+    const registry = registryOf(session.state.sessionId);
+    if (registry === undefined)
+        return;
+    const running = registry.list().filter((task) => task.status === "running").length;
+    if (running > 0)
+        io.stderr(msg().print.print.waitingTasks(running));
+    await Promise.race([registry.settled(), stopped]);
+}
 /** stderr 一行：计划已落盘待审批（-p 不替人批准）。 */
 export function describePlanPending(plan) {
     const where = plan.filePath ?? plan.planId;

package/dist/modes/rpc/commands.d.ts

@@ -1,5 +1,5 @@
 /**
- * RPC 命令分派表（设计 §13.2、src/rpc.ts 的 33 条命令）。[B6]
+ * RPC 命令分派表（设计 §13.2、src/rpc.ts 的命令表，现 44 条）。[B6]
  *
  * - 提示类（prompt / steer / follow_up）不等运行结束：会话开始运行（`before_agent_start` /
  *   `agent_start`）、入队或被处理后立刻应答 `{ disposition }`；运行中的进展走事件。
@@ -11,6 +11,7 @@
  * - [W5-F] 计划：声明 `plans` 能力后计划审批交客户端（`plan_proposed` → `plan_response`），未声明按
  *   `plan.unattended`；`approve_fresh` 在这里新建会话并以计划全文开新回合。`get_tasks / get_agents`
  *   读 `RpcContext.tasks / agents`（W5-G 的注册表与发现结果；未装配时回空表）。
+ * - [W7-B2] `background_task { taskId? }` → `{ backgrounded }`（`session.backgroundTask`，B1）。
  */
 import type { AgentInfo } from "../../agents/types.js";
 import type { TaskRegistryView } from "../../tools/types.js";

package/dist/modes/rpc/commands.js

@@ -1,5 +1,5 @@
 /**
- * RPC 命令分派表（设计 §13.2、src/rpc.ts 的 33 条命令）。[B6]
+ * RPC 命令分派表（设计 §13.2、src/rpc.ts 的命令表，现 44 条）。[B6]
  *
  * - 提示类（prompt / steer / follow_up）不等运行结束：会话开始运行（`before_agent_start` /
  *   `agent_start`）、入队或被处理后立刻应答 `{ disposition }`；运行中的进展走事件。
@@ -11,6 +11,7 @@
  * - [W5-F] 计划：声明 `plans` 能力后计划审批交客户端（`plan_proposed` → `plan_response`），未声明按
  *   `plan.unattended`；`approve_fresh` 在这里新建会话并以计划全文开新回合。`get_tasks / get_agents`
  *   读 `RpcContext.tasks / agents`（W5-G 的注册表与发现结果；未装配时回空表）。
+ * - [W7-B2] `background_task { taskId? }` → `{ backgrounded }`（`session.backgroundTask`，B1）。
  */
 import { formatModelRef } from "../../ai/providers/channels.js";
 import { AgentSessionImpl } from "../../agent/session.js";
@@ -312,5 +313,12 @@ export const handlers = {
     get_agents: async (_p, ctx) => ({ agents: [...(ctx.agents?.() ?? [])] }),
     // [W6-T2] 轨迹（docs/wave6-plan.md §2.6；分页 / 增量 / 脱敏见 trace/query.ts）
     get_trace: async (p, ctx) => sessionTrace(ctx.session(), p ?? {}),
+    // [W7-B2] 前台任务转后台：工具调用立即返回、任务继续，完成后照常通知
+    background_task: async (p, ctx) => {
+        const taskId = p?.taskId;
+        if (taskId !== undefined && typeof taskId !== "string")
+            throw new AmaError("invalid_arguments", msg().print.rpc.badTaskId);
+        return { backgrounded: ctx.session().backgroundTask(taskId) };
+    },
 };
 export const RPC_COMMAND_TYPES = Object.keys(handlers);

package/dist/rpc.d.ts

@@ -19,6 +19,9 @@
  * - [W6-C0] 第六波（docs/wave6-plan.md §2.6、§4.4）：命令 `get_trace`（参数 `RpcGetTraceParams`、返回
  *   `RpcW6Results`，W6-T2 实现，之前回 `not_implemented`）；事件 `quota_update`；`permission_request.context`
  *   可带 `toolCallId`；`keySource` 可为 `oauth`。`RPC_PROTOCOL_VERSION` 不变。
+ * - [W7-B2] 后台子 Agent（docs/agents-concurrency-plan.md §2.5）：命令 `background_task { taskId? }` →
+ *   `RpcW7Results`（无 taskId = 全部前台运行中任务；对已结束 / 已在后台的任务回空表）；事件
+ *   `subagent_background` 由 `SessionEvent` 派生。`RPC_PROTOCOL_VERSION` 不变。
  */
 import type { AssistantEvent, ImageBlock, ModelThinkingLevel, Usage } from "./ai/types.js";
 import type { PlanData, PlanDecisionKind, QueueMode, SessionEvent, TodoItemView } from "./agent/types.js";
@@ -139,6 +142,16 @@ export interface RpcCommandMap {
     get_tasks: NoParams;
     get_agents: NoParams;
     get_trace: RpcGetTraceParams;
+    background_task: {
+        taskId?: string;
+    };
+}
+/** [W7-B2] 第七波命令成功时的 `data` 形状。 */
+export interface RpcW7Results {
+    /** 实际转了后台的 taskId（含被打断的 `task_ctl wait`）；没有可转的为空表。 */
+    background_task: {
+        backgrounded: string[];
+    };
 }
 /** [W6-C0] `get_trace` 的参数。 */
 export interface RpcGetTraceParams {

package/dist/rpc.js

@@ -19,5 +19,8 @@
  * - [W6-C0] 第六波（docs/wave6-plan.md §2.6、§4.4）：命令 `get_trace`（参数 `RpcGetTraceParams`、返回
  *   `RpcW6Results`，W6-T2 实现，之前回 `not_implemented`）；事件 `quota_update`；`permission_request.context`
  *   可带 `toolCallId`；`keySource` 可为 `oauth`。`RPC_PROTOCOL_VERSION` 不变。
+ * - [W7-B2] 后台子 Agent（docs/agents-concurrency-plan.md §2.5）：命令 `background_task { taskId? }` →
+ *   `RpcW7Results`（无 taskId = 全部前台运行中任务；对已结束 / 已在后台的任务回空表）；事件
+ *   `subagent_background` 由 `SessionEvent` 派生。`RPC_PROTOCOL_VERSION` 不变。
  */
 export const RPC_PROTOCOL_VERSION = 1;

package/dist/tools/task-ctl.d.ts

@@ -7,6 +7,8 @@
  *   与父一致，运行时拒绝；
  * - `wait` / `output` 是轮询类调用（`annotations.pollable`，重复调用检测豁免）；
  * - `send` = 续聊放后台：等价于 `task{taskId, prompt, background:true}`，完成后同样收到通知。
+ * - [W7-B1] `wait` 被转后台（`background()`，TUI `Ctrl+B` / RPC `background_task`）打断时立即返回固定
+ *   文案，要求模型不要再等。
  */
 import type { ToolDefinition } from "./types.js";
 export declare const TASK_CTL_TOOL = "task_ctl";

package/dist/tools/task-ctl.js

@@ -7,8 +7,10 @@
  *   与父一致，运行时拒绝；
  * - `wait` / `output` 是轮询类调用（`annotations.pollable`，重复调用检测豁免）；
  * - `send` = 续聊放后台：等价于 `task{taskId, prompt, background:true}`，完成后同样收到通知。
+ * - [W7-B1] `wait` 被转后台（`background()`，TUI `Ctrl+B` / RPC `background_task`）打断时立即返回固定
+ *   文案，要求模型不要再等。
  */
-import { capTaskText, formatTokens } from "../agents/result.js";
+import { capTaskText, formatTokens, waitDetachedText } from "../agents/result.js";
 import { taskControl } from "../agents/task-control.js";
 export const TASK_CTL_TOOL = "task_ctl";
 export const DEFAULT_WAIT_MS = 30_000;
@@ -96,7 +98,10 @@ export function createTaskCtlTool() {
                 }
                 case "wait": {
                     const timeout = Math.min(Math.max(input.timeoutMs ?? DEFAULT_WAIT_MS, 0), MAX_WAIT_MS);
-                    const result = await control.wait(taskId, timeout);
+                    const signal = control.detachSignal(taskId);
+                    const result = await control.wait(taskId, timeout, { signal });
+                    if (result === undefined && signal.aborted)
+                        return { content: waitDetachedText(taskId) };
                     if (result === undefined) {
                         const turns = control.get(taskId)?.turns ?? 0;
                         return {

package/dist/tools/task.d.ts

@@ -5,6 +5,8 @@
  * - `agent`：子 Agent 类型（内置 general / explore / plan、`.ama/agents/*.md`）或外部 Agent；缺省
  *   general。描述里列出可用类型（catalog 由 compose-agents.ts 经 `bindTaskAgents` 绑定；没绑定时
  *   只列内置类型）。
+ * - [W7-B1] 缺省前台 / 后台由 `subagents.background` 决定（交互 / RPC / ACP 后台，`-p` 前台），描述随之
+ *   二选一（`bindTaskBackground`）；前台任务可被 `background()` 转后台，工具立即以固定文案返回。
  * - `background`：立即返回 taskId，完成后父会话收到 `<task-notification>`；`taskId`：向已有子会话
  *   追加消息（续聊，忽略 agent / tools / model）；`isolation: "worktree"`：在独立 git worktree 里跑。
  * - **parallel**：同一回复里的多个 task 真并行（会话注册表的池限流，缺省 4）；与 sequential 工具
@@ -33,9 +35,18 @@ export interface TaskInput {
 /** 预留（并发上限在会话的任务注册表，见 agent/subagent-registry.ts）。 */
 export interface TaskToolOptions {
 }
+/** 缺省前台（`-p`、`subagents.background: never`）时的描述。 */
+export declare const FOREGROUND_DESCRIPTION: string;
+/** [W7-B1] 缺省后台（交互 / RPC / ACP，docs/agents-concurrency-plan.md §2.6）时的描述。 */
+export declare const BACKGROUND_DESCRIPTION: string;
 /** 描述里类型清单的标题（清单本身另有 400 token 预算，见 agents/catalog.ts）。 */
 export declare const TASK_AGENTS_HEADING = "\nAgents:\n";
 /** 组装根把会话的类型目录绑到 task 工具上（描述里的类型清单）。 */
 export declare function bindTaskAgents(tool: ToolDefinition | undefined, catalog: AgentCatalog): void;
+/**
+ * [W7-B1] 组装根把本进程的缺省前台 / 后台（`subagents.background` 按运行模式解析后）绑到 task 工具：
+ * 决定描述用哪一版。会话内不变（缓存前缀稳定）；没绑定按缺省前台。
+ */
+export declare function bindTaskBackground(tool: ToolDefinition | undefined, background: boolean): void;
 export declare function buildSubagentRequest(input: TaskInput, ctx: ToolContext): SubagentRequest | string;
 export declare function createTaskTool(_options?: TaskToolOptions): ToolDefinition<TaskInput>;

package/dist/tools/task.js

@@ -5,6 +5,8 @@
  * - `agent`：子 Agent 类型（内置 general / explore / plan、`.ama/agents/*.md`）或外部 Agent；缺省
  *   general。描述里列出可用类型（catalog 由 compose-agents.ts 经 `bindTaskAgents` 绑定；没绑定时
  *   只列内置类型）。
+ * - [W7-B1] 缺省前台 / 后台由 `subagents.background` 决定（交互 / RPC / ACP 后台，`-p` 前台），描述随之
+ *   二选一（`bindTaskBackground`）；前台任务可被 `background()` 转后台，工具立即以固定文案返回。
  * - `background`：立即返回 taskId，完成后父会话收到 `<task-notification>`；`taskId`：向已有子会话
  *   追加消息（续聊，忽略 agent / tools / model）；`isolation: "worktree"`：在独立 git worktree 里跑。
  * - **parallel**：同一回复里的多个 task 真并行（会话注册表的池限流，缺省 4）；与 sequential 工具
@@ -24,17 +26,32 @@ const THINKING = [
     "high",
     "xhigh",
 ];
-const BASE_DESCRIPTION = "Delegate to a sub-agent (fresh context; give full instructions). Returns its final report. " +
+/** 缺省前台（`-p`、`subagents.background: never`）时的描述。 */
+export const FOREGROUND_DESCRIPTION = "Delegate to a sub-agent (fresh context; give full instructions). Returns its final report. " +
     "Tasks in one reply run in parallel; writers should use isolation worktree. background: " +
     "returns a taskId now (see task_ctl); taskId: continue that task.";
+/** [W7-B1] 缺省后台（交互 / RPC / ACP，docs/agents-concurrency-plan.md §2.6）时的描述。 */
+export const BACKGROUND_DESCRIPTION = "Delegate to a sub-agent (fresh context; give full instructions). Runs in the background by " +
+    "default: returns a taskId; a <task-notification> follows when done, so keep working. " +
+    "background:false if your next step needs the result. taskId: continue a task. Tasks in one " +
+    "reply run in parallel; writers use isolation worktree.";
 /** 描述里类型清单的标题（清单本身另有 400 token 预算，见 agents/catalog.ts）。 */
 export const TASK_AGENTS_HEADING = "\nAgents:\n";
 const catalogs = new WeakMap();
+const backgrounds = new WeakMap();
 /** 组装根把会话的类型目录绑到 task 工具上（描述里的类型清单）。 */
 export function bindTaskAgents(tool, catalog) {
     if (tool !== undefined)
         catalogs.set(tool, catalog);
 }
+/**
+ * [W7-B1] 组装根把本进程的缺省前台 / 后台（`subagents.background` 按运行模式解析后）绑到 task 工具：
+ * 决定描述用哪一版。会话内不变（缓存前缀稳定）；没绑定按缺省前台。
+ */
+export function bindTaskBackground(tool, background) {
+    if (tool !== undefined)
+        backgrounds.set(tool, background);
+}
 function fail(message) {
     return { content: message, isError: true };
 }
@@ -87,7 +104,8 @@ export function createTaskTool(_options = {}) {
         label: "Task",
         get description() {
             const catalog = catalogs.get(tool) ?? new AgentCatalog();
-            return `${BASE_DESCRIPTION}${TASK_AGENTS_HEADING}${catalog.describe()}`;
+            const base = backgrounds.get(tool) === true ? BACKGROUND_DESCRIPTION : FOREGROUND_DESCRIPTION;
+            return `${base}${TASK_AGENTS_HEADING}${catalog.describe()}`;
         },
         parameters: {
             type: "object",

package/dist/tui/components/editor.d.ts

@@ -88,6 +88,8 @@ export declare class Editor implements Component, Focusable {
         col: number;
     };
     get isCompletionOpen(): boolean;
+    /** 正在用 ↑↓ 浏览输入历史（编辑后即退出）。 */
+    get isBrowsingHistory(): boolean;
     getHistory(): readonly string[];
     setHistory(entries: readonly string[]): void;
     addToHistory(text: string): void;

package/dist/tui/components/editor.js

@@ -88,6 +88,10 @@ export class Editor {
     get isCompletionOpen() {
         return this.completion !== null;
     }
+    /** 正在用 ↑↓ 浏览输入历史（编辑后即退出）。 */
+    get isBrowsingHistory() {
+        return this.historyIndex !== -1;
+    }
     getHistory() {
         return this.history;
     }

package/dist/tui/components/loader.d.ts

@@ -2,7 +2,8 @@
  * 运行指示（设计 §12.1、§12.6；终端界面视觉设计 v1 §3.7）。[B4]
  *
  * 一行 `⠋ 动词 · 已用时 · 附加项…`：spinner `accent`、动词正文色、其余 `dim`，以 ` · ` 连接。
- * - `setVerb(verb, extras, { elapsed })` 换动词（思考中 / 回复中 / 运行 bash / 等待确认……）；
+ * - `setVerb(verb, extras, { elapsed, optional })` 换动词（思考中 / 回复中 / 运行 bash / 等待确认……）；
+ *   `optional` 是排在附加项之后的可丢弃项（按键提示），整行放不下时从后往前丢，而不是被截断；
  *   `setMessage(text)` 是只换动词的旧接口。
  * - 帧取 `theme.glyphs.spinner`（Unicode 10 帧 80 ms、ASCII 4 帧 250 ms）；`frame` 暴露当前帧字形，
  *   `onFrame` 让别的组件（运行中的工具摘要行）与 Loader 同帧换字，保证一帧只多改一行。
@@ -27,6 +28,8 @@ export interface LoaderOptions {
 export interface LoaderVerbOptions {
     /** 本动词是否显示已用时（缺省跟随 `showElapsed`）。 */
     elapsed?: boolean;
+    /** 可丢弃的附加项：宽度不够时从后往前整项丢掉（缺省没有）。 */
+    optional?: readonly string[];
 }
 export declare function formatElapsed(ms: number): string;
 export declare class Loader implements Component {
@@ -37,6 +40,7 @@ export declare class Loader implements Component {
     private startedAt;
     private verb;
     private extras;
+    private optional;
     private verbElapsed;
     private lastElapsed;
     private readonly listeners;

package/dist/tui/components/loader.js

@@ -2,17 +2,21 @@
  * 运行指示（设计 §12.1、§12.6；终端界面视觉设计 v1 §3.7）。[B4]
  *
  * 一行 `⠋ 动词 · 已用时 · 附加项…`：spinner `accent`、动词正文色、其余 `dim`，以 ` · ` 连接。
- * - `setVerb(verb, extras, { elapsed })` 换动词（思考中 / 回复中 / 运行 bash / 等待确认……）；
+ * - `setVerb(verb, extras, { elapsed, optional })` 换动词（思考中 / 回复中 / 运行 bash / 等待确认……）；
+ *   `optional` 是排在附加项之后的可丢弃项（按键提示），整行放不下时从后往前丢，而不是被截断；
  *   `setMessage(text)` 是只换动词的旧接口。
  * - 帧取 `theme.glyphs.spinner`（Unicode 10 帧 80 ms、ASCII 4 帧 250 ms）；`frame` 暴露当前帧字形，
  *   `onFrame` 让别的组件（运行中的工具摘要行）与 Loader 同帧换字，保证一帧只多改一行。
  * - `animation: false`：spinner 固定为 `glyphs.spinnerStatic`，定时器每秒一次，已用时变了才请求重绘。
  * - `stop()` 后不再触发渲染。时钟可注入便于测试。
  */
-import { truncateToWidth } from "../ansi.js";
+import { truncateToWidth, visibleWidth } from "../ansi.js";
 import { UNICODE_GLYPHS } from "../glyphs.js";
 /** Unicode 帧表（兼容旧导出；实际帧取 `theme.glyphs.spinner`）。 */
 export const LOADER_FRAMES = UNICODE_GLYPHS.spinner;
+function sameList(a, b) {
+    return a.length === b.length && a.every((e, i) => e === b[i]);
+}
 export function formatElapsed(ms) {
     const total = Math.max(0, Math.floor(ms / 1000));
     if (total < 60)
@@ -29,6 +33,7 @@ export class Loader {
     startedAt;
     verb;
     extras = [];
+    optional = [];
     verbElapsed;
     lastElapsed = "";
     listeners = new Set();
@@ -65,12 +70,13 @@ export class Loader {
     setVerb(verb, extras = [], options = {}) {
         const same = verb === this.verb &&
             options.elapsed === this.verbElapsed &&
-            extras.length === this.extras.length &&
-            extras.every((e, i) => e === this.extras[i]);
+            sameList(extras, this.extras) &&
+            sameList(options.optional ?? [], this.optional);
         if (same)
             return;
         this.verb = verb;
         this.extras = [...extras];
+        this.optional = [...(options.optional ?? [])];
         this.verbElapsed = options.elapsed;
         this.requestRender();
     }
@@ -142,7 +148,14 @@ export class Loader {
         for (const extra of this.extras)
             parts.push(dim(extra));
         const spinner = theme ? theme.fg("accent", this.frame) : this.frame;
-        return [truncateToWidth(`${spinner} ${parts.join(dim(" · "))}`, width)];
+        const line = (items) => `${spinner} ${items.join(dim(" · "))}`;
+        for (const extra of this.optional) {
+            const next = [...parts, dim(extra)];
+            if (visibleWidth(line(next)) > width)
+                break;
+            parts.push(dim(extra));
+        }
+        return [truncateToWidth(line(parts), width)];
     }
     invalidate() { }
 }

package/dist/tui/keybindings.d.ts

@@ -45,10 +45,15 @@ export declare const DEFAULT_KEYBINDINGS: {
     /** [W5-U] 粘贴剪贴板图片（写进数据目录，输入框插入 `@路径`）。 */
     readonly "app.paste.image": readonly ["ctrl+v"];
     /**
-     * [W6-A] 进入 Agent 栏：只在输入为空时生效（有字时 `Ctrl+B` 仍是光标左移、`↓` 仍是下移 / 历史）；
-     * `↓` 另要求栏可见。tmux 缺省前缀吃掉 `Ctrl+B` 时用 `↓`。
+     * [W6-A / W7-A] 进入 Agent 栏：输入为空、补全未开、有子 Agent 任务即可（不要求栏可见）；有字时 `↓` 仍是
+     * 下移 / 历史，并给一次提示。`Ctrl+B` 不再进栏（tmux 缺省前缀会吃掉它），留给 `app.tasks.background`。
      */
-    readonly "app.agents.focus": readonly ["ctrl+b", "down"];
+    readonly "app.agents.focus": readonly ["down"];
+    /**
+     * [W7-C] 有阻塞中的前台子 Agent 任务（或 `task_ctl wait`）时全部转后台，不看输入框；没有时落回编辑器
+     * （`tui.editor.cursorLeft` 的 `ctrl+b`）。tmux 里按 `C-b C-b` 透传。
+     */
+    readonly "app.tasks.background": readonly ["ctrl+b"];
 };
 export type ActionId = keyof typeof DEFAULT_KEYBINDINGS;
 export type KeybindingOverrides = Partial<Record<ActionId, readonly string[]>>;

package/dist/tui/keybindings.js

@@ -48,10 +48,15 @@ export const DEFAULT_KEYBINDINGS = {
     /** [W5-U] 粘贴剪贴板图片（写进数据目录，输入框插入 `@路径`）。 */
     "app.paste.image": ["ctrl+v"],
     /**
-     * [W6-A] 进入 Agent 栏：只在输入为空时生效（有字时 `Ctrl+B` 仍是光标左移、`↓` 仍是下移 / 历史）；
-     * `↓` 另要求栏可见。tmux 缺省前缀吃掉 `Ctrl+B` 时用 `↓`。
+     * [W6-A / W7-A] 进入 Agent 栏：输入为空、补全未开、有子 Agent 任务即可（不要求栏可见）；有字时 `↓` 仍是
+     * 下移 / 历史，并给一次提示。`Ctrl+B` 不再进栏（tmux 缺省前缀会吃掉它），留给 `app.tasks.background`。
      */
-    "app.agents.focus": ["ctrl+b", "down"],
+    "app.agents.focus": ["down"],
+    /**
+     * [W7-C] 有阻塞中的前台子 Agent 任务（或 `task_ctl wait`）时全部转后台，不看输入框；没有时落回编辑器
+     * （`tui.editor.cursorLeft` 的 `ctrl+b`）。tmux 里按 `C-b C-b` 透传。
+     */
+    "app.tasks.background": ["ctrl+b"],
 };
 export function isActionId(id) {
     return Object.prototype.hasOwnProperty.call(DEFAULT_KEYBINDINGS, id);