@armadra/agent 0.6.1 → 0.6.3

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

@@ -19,6 +19,11 @@
  * - 费用 = `stats.cost` + 外部 Agent 以美元计的用量（`stats.external`，W5-E；其它单位只在 /session 显示）。
  * - 着色：整行 dim；模式名正文色（Bypass permissions warning、Plan accent）；模型 accent；ctx 按阈值
  *   success / warning / error；rebill、queue warning；`net!` error。宽 ≥ 110 时 ctx 用余量表。
+ *   [W6] full 本行按用户参考配色：思考级别 `user`（浅蓝）、目录与分支 success、短提交 dim、`↑N` 领先 `code`（橙）/
+ *   `↓N` 落后 error、`(+a,-d)` 的 +a success / -d error、费用 warning、时长 `tool`（紫）；compact 着色不变。
+ * - [W6] git 段在短提交后显示领先 / 落后上游 `↑N ↓N`（只 full；为 0 不显示，没有上游不显示）。
+ * - [W6] compact 在行尾（宿主状态之后）追加订阅配额短项 `5h 10% wk 31%`（status-quota.ts），最先丢；
+ *   既有记号顺序不变。full 的配额在状态栏下方单独一行。
  * - [W5-U] bash 在操作系统沙箱里跑时（S2）用量类项多一个 `沙箱`（与 codemode 同一丢弃优先级）。
  * - [W5-U] 模型回退中（`model_fallback`）模型项显示 `主模型 → 回退模型`，切回主模型后恢复。
  * - 模型名缩写：宽 < 100 去掉供应商前缀，< 60 再去掉 `@渠道`，< 48 去掉版本后缀（第一个 `-数字` 起）。
@@ -29,6 +34,7 @@
 import type { AgentSession, SessionCacheStats, SessionStats } from "../../agent/types.js";
 import type { StatusLineMode } from "../../config/types.js";
 import type { GitInfo } from "../../git/info.js";
+import { type QuotaView } from "./status-quota.js";
 import { type Component, type Theme } from "../../tui.js";
 export interface StatusBarSource {
     session(): AgentSession;
@@ -58,6 +64,8 @@ export interface StatusBarSource {
         from: string;
         to: string;
     } | undefined;
+    /** [W6] 订阅配额（当前模型走 ChatGPT 订阅时）；compact 行尾短项用。 */
+    quota?(): QuotaView;
 }
 export declare function formatTokens(count: number): string;
 export declare function formatCost(cost: number): string;
@@ -131,7 +139,7 @@ export declare class StatusBar implements Component {
     queued(): number;
     layout(): StatusLineMode;
     private parts;
-    /** `目录 ⎇ 分支 短提交 +a −b`：三项同组、各自按优先级丢弃。 */
+    /** `目录 ⎇ 分支 短提交 +a −b`：三项同组、各自按优先级丢弃；full 另带 `↑N ↓N` 并按参考配色。 */
     private gitParts;
     private ctxText;
     render(width: number): string[];

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

@@ -19,6 +19,11 @@
  * - 费用 = `stats.cost` + 外部 Agent 以美元计的用量（`stats.external`，W5-E；其它单位只在 /session 显示）。
  * - 着色：整行 dim；模式名正文色（Bypass permissions warning、Plan accent）；模型 accent；ctx 按阈值
  *   success / warning / error；rebill、queue warning；`net!` error。宽 ≥ 110 时 ctx 用余量表。
+ *   [W6] full 本行按用户参考配色：思考级别 `user`（浅蓝）、目录与分支 success、短提交 dim、`↑N` 领先 `code`（橙）/
+ *   `↓N` 落后 error、`(+a,-d)` 的 +a success / -d error、费用 warning、时长 `tool`（紫）；compact 着色不变。
+ * - [W6] git 段在短提交后显示领先 / 落后上游 `↑N ↓N`（只 full；为 0 不显示，没有上游不显示）。
+ * - [W6] compact 在行尾（宿主状态之后）追加订阅配额短项 `5h 10% wk 31%`（status-quota.ts），最先丢；
+ *   既有记号顺序不变。full 的配额在状态栏下方单独一行。
  * - [W5-U] bash 在操作系统沙箱里跑时（S2）用量类项多一个 `沙箱`（与 codemode 同一丢弃优先级）。
  * - [W5-U] 模型回退中（`model_fallback`）模型项显示 `主模型 → 回退模型`，切回主模型后恢复。
  * - 模型名缩写：宽 < 100 去掉供应商前缀，< 60 再去掉 `@渠道`，< 48 去掉版本后缀（第一个 `-数字` 起）。
@@ -29,6 +34,7 @@
 import { msg } from "../../i18n/index.js";
 import { permissionModeLabel } from "../../permissions/modes.js";
 import { formatModelRef } from "../../ai/providers/channels.js";
+import { compactQuotaItem } from "./status-quota.js";
 import { Meter, levelColor, truncateToWidth, visibleWidth, } from "../../tui.js";
 export function formatTokens(count) {
     if (count < 1000)
@@ -209,6 +215,7 @@ const COMPACT = {
     preset: 14,
     host: 15,
     hint: 16,
+    quota: 17,
 };
 /** full 布局本行的优先级（§1.2 下行表）。 */
 const FULL = { model: 0, ctx: 1, cost: 2, duration: 3, branch: 4, dir: 5, diff: 6, thinking: 7 };
@@ -279,7 +286,8 @@ export class StatusBar {
                 theme.fg("warning", abbreviateModel(fallback.to, width));
         right(modelText, p.model, full ? { group: "model" } : {});
         if (state.thinkingLevel !== "off") {
-            right(dim(state.thinkingLevel), p.thinking, full ? { group: "model" } : {});
+            const level = full ? theme.fg("user", state.thinkingLevel) : dim(state.thinkingLevel);
+            right(level, p.thinking, full ? { group: "model" } : {});
         }
         const usage = full ? {} : usageItems(stats, this.queue, this.source, theme);
         if (usage.tokens !== undefined)
@@ -297,13 +305,15 @@ export class StatusBar {
             const used = stats.tokens.input + stats.tokens.output + stats.tokens.cacheRead > 0;
             if (cost === undefined && used)
                 right(dim("$?"), FULL.cost);
-            else if (cost !== undefined && cost > 0)
-                right(dim(formatCost(cost)), FULL.cost);
+            else if (cost !== undefined && cost > 0) {
+                right(theme.fg("warning", formatCost(cost)), FULL.cost);
+            }
         }
         const started = this.source.sessionStartedAt?.() ?? stats.telemetry?.sessionStartedAt;
         if (started !== undefined) {
             const now = this.source.now?.() ?? Date.now();
-            right(dim(formatDuration(now - started)), p.duration, { reserve: 6 });
+            const text = formatDuration(now - started);
+            right(full ? theme.fg("tool", text) : dim(text), p.duration, { reserve: 6 });
         }
         if (usage.queue !== undefined)
             right(usage.queue, COMPACT.queue);
@@ -315,9 +325,13 @@ export class StatusBar {
             right(usage.preset, COMPACT.preset);
         if (usage.host !== undefined)
             right(usage.host, COMPACT.host);
+        const quota = full ? undefined : this.source.quota?.();
+        const quotaItem = typeof quota === "object" ? compactQuotaItem(quota.quota, theme) : undefined;
+        if (quotaItem !== undefined)
+            right(quotaItem, COMPACT.quota);
         return parts;
     }
-    /** `目录 ⎇ 分支 短提交 +a −b`：三项同组、各自按优先级丢弃。 */
+    /** `目录 ⎇ 分支 短提交 +a −b`：三项同组、各自按优先级丢弃；full 另带 `↑N ↓N` 并按参考配色。 */
     gitParts(p, full) {
         const git = this.source.git?.();
         if (git === undefined)
@@ -325,19 +339,37 @@ export class StatusBar {
         const theme = this.theme;
         const g = theme.glyphs;
         const dim = (text) => theme.fg("dim", text);
+        const ok = (text) => (full ? theme.fg("success", text) : dim(text));
         const out = [];
-        const add = (text, priority) => void out.push({ text: dim(text), priority, zone: "right", group: "git" });
+        const add = (text, priority) => void out.push({ text, priority, zone: "right", group: "git" });
         if (git.dir !== "")
-            add(git.dir, p.dir);
+            add(ok(git.dir), p.dir);
         const info = git.info;
         if (info === undefined)
             return out;
-        const head = [info.branch, info.shortHead].filter((s) => s !== undefined).join(" ");
-        if (head !== "")
-            add(`${g.branch} ${head}`, p.branch);
+        const head = [];
+        if (info.branch !== undefined)
+            head.push(ok(info.branch));
+        if (info.shortHead !== undefined)
+            head.push(dim(info.shortHead));
+        if (full && info.ahead !== undefined && info.ahead > 0) {
+            head.push(theme.fg("code", `${g.arrowUp}${info.ahead}`));
+        }
+        if (full && info.behind !== undefined && info.behind > 0) {
+            head.push(theme.fg("error", `${g.arrowDown}${info.behind}`));
+        }
+        if (!full) {
+            const text = [info.branch, info.shortHead].filter((s) => s !== undefined).join(" ");
+            if (text !== "")
+                add(dim(`${g.branch} ${text}`), p.branch);
+        }
+        else if (head.length > 0)
+            add(`${dim(g.branch)} ${head.join(" ")}`, p.branch);
         if (info.insertions !== undefined && info.deletions !== undefined) {
             const { insertions: a, deletions: d } = info;
-            add(full ? `(+${a},-${d})` : `+${a} ${g.ascii ? "-" : "−"}${d}`, p.diff);
+            add(full
+                ? `${dim("(")}${theme.fg("success", `+${a}`)}${dim(",")}${theme.fg("error", `-${d}`)}${dim(")")}`
+                : dim(`+${a} ${g.ascii ? "-" : "−"}${d}`), p.diff);
         }
         return out;
     }

package/dist/modes/interactive/status-line.d.ts

@@ -14,6 +14,8 @@
  * - 丢弃顺序（§1.2，数字大先丢；`tps` 与 `[-]` 永不丢）：tok/耗时 10 → codemode 9 → queue 8 → token 7 →
  *   cache 6 → rebill 5 → 预设 4 → 宿主 3 → avg 2 → ttft 1；数字按最宽形状占位，不随数值抖动；
  * - `compact` 时不占行（render 返回空）。
+ * - [W6] 配色（用户参考）：标签、单位、`•`、括号 dim；速率数字 `tool`（紫）；输出量与耗时、avg 数字 accent（蓝）；
+ *   ttft 数字 `tool`；右区用量项不变。
  */
 import { type Component, type Theme } from "../../tui.js";
 import { type StatusBar, type StatusBarSource } from "./status-bar.js";

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

@@ -14,6 +14,8 @@
  * - 丢弃顺序（§1.2，数字大先丢；`tps` 与 `[-]` 永不丢）：tok/耗时 10 → codemode 9 → queue 8 → token 7 →
  *   cache 6 → rebill 5 → 预设 4 → 宿主 3 → avg 2 → ttft 1；数字按最宽形状占位，不随数值抖动；
  * - `compact` 时不占行（render 返回空）。
+ * - [W6] 配色（用户参考）：标签、单位、`•`、括号 dim；速率数字 `tool`（紫）；输出量与耗时、avg 数字 accent（蓝）；
+ *   ttft 数字 `tool`；右区用量项不变。
  */
 import { truncateToWidth } from "../../tui.js";
 import { formatTokens, layoutRow, usageItems, } from "./status-bar.js";
@@ -68,29 +70,32 @@ export class StatusLine {
             if (text !== undefined)
                 parts.push({ text, priority, zone: "right" });
         };
+        const blue = (text) => theme.fg("accent", text);
+        const purple = (text) => theme.fg("tool", text);
+        const amountText = (tokens, ms) => `${blue(formatTokens(tokens))}${dim(" tok / ")}${blue(formatSeconds(ms))}`;
         let tps;
         let amount;
         if (live !== undefined) {
             tps = live.tps;
-            amount = `${formatTokens(live.outputTokens)} tok / ${formatSeconds(live.elapsedMs)}`;
+            amount = amountText(live.outputTokens, live.elapsedMs);
         }
         else if (last?.doneAt !== undefined) {
             tps = last.tps;
             if (last.outputTokens !== undefined && last.firstTokenAt !== undefined) {
-                amount = `${formatTokens(last.outputTokens)} tok / ${formatSeconds(last.doneAt - last.firstTokenAt)}`;
+                amount = amountText(last.outputTokens, last.doneAt - last.firstTokenAt);
             }
         }
         const label = live !== undefined ? theme.fg("accent", "tps:") : dim("tps:");
-        left(`${label} ${dim(tps === undefined ? "—" : `${formatRate(tps)} tok/s`)}`, undefined, RESERVE.tps);
+        left(`${label} ${tps === undefined ? dim("—") : `${purple(formatRate(tps))}${dim(" tok/s")}`}`, undefined, RESERVE.tps);
         if (amount !== undefined) {
-            left(dim(amount), PRIORITY.amount, RESERVE.amount, { lead: ` ${theme.glyphs.dot} ` });
+            left(amount, PRIORITY.amount, RESERVE.amount, { lead: ` ${theme.glyphs.dot} ` });
         }
         const stat = { group: "stats", lead: " " };
         if (telemetry?.avgTps !== undefined) {
-            left(dim(`avg ${formatRate(telemetry.avgTps)}`), PRIORITY.avg, RESERVE.avg, stat);
+            left(`${dim("avg ")}${blue(formatRate(telemetry.avgTps))}`, PRIORITY.avg, RESERVE.avg, stat);
         }
         if (last?.ttftMs !== undefined) {
-            left(dim(`ttft ${formatSeconds(last.ttftMs)}`), PRIORITY.ttft, RESERVE.ttft, stat);
+            left(`${dim("ttft ")}${purple(formatSeconds(last.ttftMs))}`, PRIORITY.ttft, RESERVE.ttft, stat);
         }
         const usage = usageItems(stats, this.bar.queued(), this.source, theme);
         right(usage.tokens, PRIORITY.tokens);

package/dist/modes/interactive/status-quota.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 订阅配额行（full 布局第三行，状态栏下方；compact 只在行尾追加一个短项）。[W6]
+ *
+ * ```text
+ * Session: 10.0% | Reset: 2h 18m | Weekly: 31.0% | Weekly Reset: 6d 5h      ≥ 80 列
+ * 5h 10% ↻2h18m · wk 31% ↻6d5h                                              < 80 列
+ * ```
+ *
+ * - 数据：会话的 `quota_update`（codex flavor 的 `x-codex-primary/secondary-*` 头、`codex.rate_limits` 事件；
+ *   SIWC 只有 429）。primary = 5 小时窗口、secondary = 周窗口；窗口长度不是 5 h / 7 d 时标签换成实际时长。
+ * - 只在当前模型走 ChatGPT 订阅（compat `chatgptBackend`）时出现；codex flavor 还没有数据时显示
+ *   「配额：首次请求后显示」（第一次请求就会带回配额，先占住行免得行数跳动），SIWC 没有数据时不占行
+ *   （只有超限才有配额，占位会一直挂着误导）。
+ * - 着色：标签与分隔 dim；百分比按阈值（≥ 70% warning、≥ 90% error，否则 success）；重置时间 `tool`（紫）。
+ * - 重置时间是相对时长（`2h 18m`、`6d 5h`），按渲染时刻算；StatusArea 每分钟重画一次。
+ */
+import type { QuotaUpdateEvent } from "../../agent/types-w6.js";
+import type { StatusLineMode } from "../../config/types.js";
+import { type Component, type Theme } from "../../tui.js";
+import { type Part } from "./status-bar.js";
+/** 配额行的数据：有数据 / 等首次请求 / 不显示（undefined）。 */
+export type QuotaView = {
+    quota: QuotaUpdateEvent;
+} | "pending" | undefined;
+/** 第三行改用短格式的宽度。 */
+export declare const QUOTA_NARROW_WIDTH = 80;
+/** 距重置：`6d 5h` / `2h 18m` / `18m`（已过或不足一分钟 `0m`）；`tight` 去掉空格。 */
+export declare function formatRemaining(ms: number, tight?: boolean): string;
+/** compact 行尾的短项 `5h 10% wk 31%`（项内只用空格，不含 ` · `，宿主解析不受影响）。 */
+export declare function compactQuotaItem(quota: QuotaUpdateEvent, theme: Theme): string | undefined;
+/** 配额行各项（宽 / 窄两种格式）；重置时间先丢，主窗口百分比永不丢。 */
+export declare function quotaParts(quota: QuotaUpdateEvent, width: number, now: number, theme: Theme): Part[];
+export interface QuotaLineSource {
+    layout(): StatusLineMode;
+    quota(): QuotaView;
+    now(): number;
+}
+export declare class QuotaLine implements Component {
+    private readonly source;
+    private readonly theme;
+    constructor(source: QuotaLineSource, theme: Theme);
+    render(width: number): string[];
+    invalidate(): void;
+}

package/dist/modes/interactive/status-quota.js

@@ -0,0 +1,135 @@
+/**
+ * 订阅配额行（full 布局第三行，状态栏下方；compact 只在行尾追加一个短项）。[W6]
+ *
+ * ```text
+ * Session: 10.0% | Reset: 2h 18m | Weekly: 31.0% | Weekly Reset: 6d 5h      ≥ 80 列
+ * 5h 10% ↻2h18m · wk 31% ↻6d5h                                              < 80 列
+ * ```
+ *
+ * - 数据：会话的 `quota_update`（codex flavor 的 `x-codex-primary/secondary-*` 头、`codex.rate_limits` 事件；
+ *   SIWC 只有 429）。primary = 5 小时窗口、secondary = 周窗口；窗口长度不是 5 h / 7 d 时标签换成实际时长。
+ * - 只在当前模型走 ChatGPT 订阅（compat `chatgptBackend`）时出现；codex flavor 还没有数据时显示
+ *   「配额：首次请求后显示」（第一次请求就会带回配额，先占住行免得行数跳动），SIWC 没有数据时不占行
+ *   （只有超限才有配额，占位会一直挂着误导）。
+ * - 着色：标签与分隔 dim；百分比按阈值（≥ 70% warning、≥ 90% error，否则 success）；重置时间 `tool`（紫）。
+ * - 重置时间是相对时长（`2h 18m`、`6d 5h`），按渲染时刻算；StatusArea 每分钟重画一次。
+ */
+import { msg } from "../../i18n/index.js";
+import { levelColor, truncateToWidth, visibleWidth, } from "../../tui.js";
+import { layoutRow } from "./status-bar.js";
+/** 第三行改用短格式的宽度。 */
+export const QUOTA_NARROW_WIDTH = 80;
+const FIVE_HOURS = 300;
+const WEEK = 10_080;
+/** 距重置：`6d 5h` / `2h 18m` / `18m`（已过或不足一分钟 `0m`）；`tight` 去掉空格。 */
+export function formatRemaining(ms, tight = false) {
+    const minutes = Math.max(0, Math.floor(ms / 60_000));
+    const days = Math.floor(minutes / 1440);
+    const hours = Math.floor((minutes % 1440) / 60);
+    const sep = tight ? "" : " ";
+    if (days > 0)
+        return `${days}d${sep}${hours}h`;
+    if (hours > 0)
+        return `${hours}h${sep}${minutes % 60}m`;
+    return `${minutes}m`;
+}
+/** 窗口长度的紧凑写法（标签用）：`5h`、`7d`、`90m`。 */
+function windowSpan(minutes) {
+    if (minutes % 1440 === 0)
+        return `${minutes / 1440}d`;
+    if (minutes % 60 === 0)
+        return `${minutes / 60}h`;
+    return `${Math.round(minutes)}m`;
+}
+function labels(w, which) {
+    const m = msg().interactive.statusLine.quota;
+    const minutes = w.windowMinutes;
+    const standard = minutes === undefined || minutes === (which === "primary" ? FIVE_HOURS : WEEK);
+    if (!standard)
+        return { pct: m.window(windowSpan(minutes)), reset: m.windowReset(windowSpan(minutes)) };
+    return which === "primary"
+        ? { pct: m.session, reset: m.reset }
+        : { pct: m.weekly, reset: m.weeklyReset };
+}
+function shortLabel(w, which) {
+    const m = msg().interactive.statusLine.quota;
+    const minutes = w.windowMinutes;
+    if (minutes === FIVE_HOURS || (minutes === undefined && which === "primary"))
+        return m.short5h;
+    if (minutes === WEEK || (minutes === undefined && which === "secondary"))
+        return m.shortWeek;
+    return windowSpan(minutes);
+}
+function percent(theme, used, decimal) {
+    return theme.fg(levelColor(used / 100), decimal ? `${used.toFixed(1)}%` : `${Math.round(used)}%`);
+}
+function windows(quota) {
+    const out = [];
+    if (quota.primary !== undefined)
+        out.push(["primary", quota.primary]);
+    if (quota.secondary !== undefined)
+        out.push(["secondary", quota.secondary]);
+    return out;
+}
+/** compact 行尾的短项 `5h 10% wk 31%`（项内只用空格，不含 ` · `，宿主解析不受影响）。 */
+export function compactQuotaItem(quota, theme) {
+    const dim = (text) => theme.fg("dim", text);
+    const items = windows(quota).map(([which, w]) => `${dim(shortLabel(w, which))} ${percent(theme, w.usedPercent, false)}`);
+    return items.length === 0 ? undefined : items.join(" ");
+}
+/** 配额行各项（宽 / 窄两种格式）；重置时间先丢，主窗口百分比永不丢。 */
+export function quotaParts(quota, width, now, theme) {
+    const dim = (text) => theme.fg("dim", text);
+    const narrow = width < QUOTA_NARROW_WIDTH;
+    const parts = [];
+    windows(quota).forEach(([which, w], i) => {
+        const first = i === 0;
+        const group = narrow ? which : undefined;
+        const name = narrow ? `${shortLabel(w, which)} ` : labels(w, which).pct;
+        parts.push({
+            text: dim(name) + percent(theme, w.usedPercent, !narrow),
+            priority: first ? undefined : 2,
+            zone: "left",
+            ...(group !== undefined ? { group } : {}),
+        });
+        if (w.resetsAt === undefined)
+            return;
+        const left = formatRemaining(w.resetsAt - now, narrow);
+        parts.push({
+            text: narrow
+                ? theme.fg("tool", `${theme.glyphs.retry}${left}`)
+                : dim(labels(w, which).reset) + theme.fg("tool", left),
+            priority: first ? 3 : 1,
+            zone: "left",
+            // 宽格式按最宽形状占位（`23h 59m`），数值变化不让某项时有时无
+            reserve: narrow ? 0 : visibleWidth(labels(w, which).reset) + 7,
+            ...(group !== undefined ? { group } : {}),
+        });
+    });
+    return parts;
+}
+export class QuotaLine {
+    source;
+    theme;
+    constructor(source, theme) {
+        this.source = source;
+        this.theme = theme;
+    }
+    render(width) {
+        if (this.source.layout() !== "full")
+            return [];
+        const view = this.source.quota();
+        if (view === undefined)
+            return [];
+        const theme = this.theme;
+        if (view === "pending") {
+            return [truncateToWidth(theme.fg("dim", msg().interactive.statusLine.quota.pending), width)];
+        }
+        const parts = quotaParts(view.quota, width, this.source.now(), theme);
+        if (parts.length === 0)
+            return [];
+        const sep = width < QUOTA_NARROW_WIDTH ? " · " : " | ";
+        return [layoutRow(parts, width, theme, { sep })];
+    }
+    invalidate() { }
+}

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

@@ -12,6 +12,7 @@
  * 后台任务的工具调用立即返回，工具行下面多一行跟随状态（`↳ t2 explore · 完成 · 7 轮 …`，运行中每秒刷新）；
  * 完成后父会话收到的 `<task-notification>` 只显示一行（`notificationSummary`），失败 / 停止另有一行提示。
  * 外部 runner（claude / codex）同一组事件，用量可能缺。
+ * [W7-C] `subagent_background`（前台转后台）：置 `background`，工具行出跟随行。
  */
 import type { SessionEvent, SubagentStatus } from "../../agent/types.js";
 import type { Usage } from "../../ai/types.js";

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

@@ -12,6 +12,7 @@
  * 后台任务的工具调用立即返回，工具行下面多一行跟随状态（`↳ t2 explore · 完成 · 7 轮 …`，运行中每秒刷新）；
  * 完成后父会话收到的 `<task-notification>` 只显示一行（`notificationSummary`），失败 / 停止另有一行提示。
  * 外部 runner（claude / codex）同一组事件，用量可能缺。
+ * [W7-C] `subagent_background`（前台转后台）：置 `background`，工具行出跟随行。
  */
 import { msg } from "../../i18n/index.js";
 import { formatElapsed } from "../../tui.js";
@@ -61,6 +62,13 @@ export class SubagentTracker {
                 }
                 return state;
             }
+            case "subagent_background": {
+                const state = this.tasks.get(event.taskId);
+                if (state === undefined)
+                    return undefined;
+                state.background = true;
+                return state;
+            }
             case "subagent_end": {
                 const state = this.tasks.get(event.taskId);
                 if (state === undefined)

package/dist/modes/interactive/task-background.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 前台子 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 type { AgentSession } from "../../agent/types.js";
+import type { Keybindings } from "../../tui.js";
+/** 栏内 `x` 两次之间的最长间隔。 */
+export declare const STOP_CONFIRM_MS = 1500;
+/** 正在阻塞父回合的任务（前台运行中、或有 `task_ctl wait` 在等）。 */
+export declare function blockingTasks(session: AgentSession): string[];
+/** 人工转后台：不给 taskId = 全部阻塞中的任务（没有时不调用，返回空）。 */
+export declare function backgroundTasks(session: AgentSession, taskId?: string): string[];
+/** 仍在运行的后台任务（Esc 中断不影响它们）。 */
+export declare function runningBackground(session: AgentSession): string[];
+/** 转后台后的一行提示；没有转任何任务时给「没有可转的」。 */
+export declare function backgroundedText(ids: readonly string[]): string;
+/** `ctrl+b` → `Ctrl+B`（提示行用）；动作没有绑定时 undefined。 */
+export declare function keyLabel(keys: Keybindings, action: "app.tasks.background"): string | undefined;
+/** 栏内 `x` 的双击确认：第一次 `arm`（提示「再按 x 停止」），间隔内对同一任务再按为 `stop`。 */
+export declare class StopArm {
+    private readonly windowMs;
+    private armed;
+    constructor(windowMs?: number);
+    press(taskId: string, now: number): "arm" | "stop";
+    reset(): void;
+}

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 一行：哪个预算到限。 */