@armadra/agent 0.6.2 → 0.6.4

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,9 @@
  * - [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）。
+ * - 打断并发送：`prompt / steer` 的 `interrupt: true` → `session.prompt(message, { interrupt })`（中止当前回合、
+ *   立刻以「排队的 steer + 本条」开新回合），应答 `started`。
  */
 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,9 @@
  * - [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）。
+ * - 打断并发送：`prompt / steer` 的 `interrupt: true` → `session.prompt(message, { interrupt })`（中止当前回合、
+ *   立刻以「排队的 steer + 本条」开新回合），应答 `started`。
  */
 import { formatModelRef } from "../../ai/providers/channels.js";
 import { AgentSessionImpl } from "../../agent/session.js";
@@ -81,6 +84,12 @@ function applyPlanAttendance(ctx) {
     planController(ctx.session())?.setAttendance(ctx.capabilities.has("plans") ? "client" : "unattended");
 }
 /** 开始一次运行：开始 / 入队 / 被处理后即返回，不等运行结束。 */
+/** `prompt / steer` 的 `interrupt`：可选布尔。 */
+function interruptFlag(value) {
+    if (value !== undefined && typeof value !== "boolean")
+        throw new AmaError("invalid_arguments", "interrupt must be a boolean");
+    return value === true;
+}
 async function startRun(ctx, run) {
     const session = ctx.session();
     let settled = false;
@@ -154,8 +163,14 @@ export const handlers = {
     prompt: (p, ctx) => startRun(ctx, () => ctx.session().prompt(p.message, {
         ...(p.images !== undefined ? { images: p.images } : {}),
         ...(p.streamingBehavior !== undefined ? { streamingBehavior: p.streamingBehavior } : {}),
+        ...(interruptFlag(p.interrupt) ? { interrupt: true } : {}),
     })),
-    steer: (p, ctx) => startRun(ctx, () => ctx.session().steer(p.message)),
+    steer: (p, ctx) => startRun(ctx, () => interruptFlag(p.interrupt)
+        ? ctx.session().prompt(p.message, {
+            interrupt: true,
+            ...(p.images !== undefined ? { images: p.images } : {}),
+        })
+        : ctx.session().steer(p.message)),
     follow_up: (p, ctx) => startRun(ctx, () => ctx.session().followUp(p.message)),
     abort: async (_p, ctx) => {
         await ctx.session().abort();
@@ -312,5 +327,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";
@@ -42,14 +45,21 @@ export interface RpcHello {
 /** 无参数命令。 */
 export type NoParams = Record<never, never>;
 export interface RpcCommandMap {
+    /**
+     * `interrupt: true`：运行中中止当前回合（工具按 abort 收尾），立刻以「排队的 steer + 本条」开新回合
+     * （user 消息 origin `interrupt`），应答 `started`；空闲时等同不填。优先于 `streamingBehavior`。
+     */
     prompt: {
         message: string;
         images?: ImageBlock[];
         streamingBehavior?: "steer" | "followUp";
+        interrupt?: boolean;
     };
+    /** `interrupt: true` 同 `prompt`。 */
     steer: {
         message: string;
         images?: ImageBlock[];
+        interrupt?: boolean;
     };
     follow_up: {
         message: string;
@@ -139,6 +149,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/tools/types.d.ts

@@ -181,6 +181,12 @@ export interface RunnerHandle {
     send(text: string): Promise<void>;
     wait(): Promise<SubagentResult>;
     stop(): Promise<void>;
+    /**
+     * 打断当前回合并立即以 `text` 开下一回合（子 Agent 视图的「打断并发送」）；`wait()` 跟到这一回合结束。
+     * 驱动能中断回合（ACP `session/cancel`、Claude stream-json interrupt、Codex `turn/interrupt`）且正在
+     * 运行时返回 true；否则 false（调用方退回排队）。
+     */
+    interrupt?(text: string): Promise<boolean>;
 }
 /** `ama`（AmaRunner）| `claude` | `codex` | `acp:<program>`（ProcessRunner，W5-E）| 宿主 id。 */
 export interface SubagentRunner {

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

@@ -36,6 +36,13 @@ export declare const DEFAULT_KEYBINDINGS: {
     readonly "app.exit": readonly ["ctrl+d"];
     readonly "app.message.followUp": readonly ["alt+enter"];
     readonly "app.message.dequeue": readonly ["alt+up"];
+    /**
+     * 运行中打断当前回合并立即发送输入框的文字（连同排队的插话）；`ui.enterWhileRunning: "interrupt"` 时与
+     * Enter 互换（它变成排队）。缺省 `Ctrl+X`：各终端（macOS Terminal、iTerm2、tmux、Windows Terminal）都原样
+     * 送达 0x18，且没有别的绑定；`Ctrl+Enter` 不开 kitty 键盘协议时与 Enter 无法区分，`Ctrl+S` 可能被 XOFF
+     * 流控吃掉，`Alt+Enter` 已是 followUp，`Alt+<字母>` 在 macOS 缺省不送 Meta，`Ctrl+]` 在非美式键盘难按。
+     */
+    readonly "app.message.interrupt": readonly ["ctrl+x"];
     readonly "app.permission.cycle": readonly ["shift+tab", "tab"];
     readonly "app.tools.expand": readonly ["ctrl+o"];
     readonly "app.model.select": readonly ["ctrl+l"];
@@ -45,10 +52,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 ["down"];
+    /**
+     * [W7-C] 有阻塞中的前台子 Agent 任务（或 `task_ctl wait`）时全部转后台，不看输入框；没有时落回编辑器
+     * （`tui.editor.cursorLeft` 的 `ctrl+b`）。tmux 里按 `C-b C-b` 透传。
      */
-    readonly "app.agents.focus": readonly ["ctrl+b", "down"];
+    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

@@ -39,6 +39,13 @@ export const DEFAULT_KEYBINDINGS = {
     "app.exit": ["ctrl+d"],
     "app.message.followUp": ["alt+enter"],
     "app.message.dequeue": ["alt+up"],
+    /**
+     * 运行中打断当前回合并立即发送输入框的文字（连同排队的插话）；`ui.enterWhileRunning: "interrupt"` 时与
+     * Enter 互换（它变成排队）。缺省 `Ctrl+X`：各终端（macOS Terminal、iTerm2、tmux、Windows Terminal）都原样
+     * 送达 0x18，且没有别的绑定；`Ctrl+Enter` 不开 kitty 键盘协议时与 Enter 无法区分，`Ctrl+S` 可能被 XOFF
+     * 流控吃掉，`Alt+Enter` 已是 followUp，`Alt+<字母>` 在 macOS 缺省不送 Meta，`Ctrl+]` 在非美式键盘难按。
+     */
+    "app.message.interrupt": ["ctrl+x"],
     "app.permission.cycle": ["shift+tab", "tab"],
     "app.tools.expand": ["ctrl+o"],
     "app.model.select": ["ctrl+l"],
@@ -48,10 +55,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": ["down"],
+    /**
+     * [W7-C] 有阻塞中的前台子 Agent 任务（或 `task_ctl wait`）时全部转后台，不看输入框；没有时落回编辑器
+     * （`tui.editor.cursorLeft` 的 `ctrl+b`）。tmux 里按 `C-b C-b` 透传。
      */
-    "app.agents.focus": ["ctrl+b", "down"],
+    "app.tasks.background": ["ctrl+b"],
 };
 export function isActionId(id) {
     return Object.prototype.hasOwnProperty.call(DEFAULT_KEYBINDINGS, id);