@armadra/agent 0.6.2 → 0.6.3

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

@@ -8,6 +8,9 @@
  *   session_rewound、/tree 之后；结果变化时重画。
  * - [W5-U] `model_fallback` 之后状态栏模型项显示 `主模型 → 回退模型`，切回主模型（`model_changed`）后消失。
  * - `telemetry_tick`（流式中 ≤ 2 Hz）只重取统计并重画（速率行），状态栏的内容这时不变。
+ * - [W6] 订阅配额（status-quota.ts）：记住最近一次 `quota_update`（账户级，换会话不清；换到别的供应商不显示），
+ *   full 时在状态栏下方占第三行、compact 时在行尾追加短项；第三行显示中每分钟重画一次（重置倒计时），
+ *   不显示时不挂计时器。Ctrl+G 折叠时第三行与速率行一起收起。
  */
 import type { AgentSession, SessionEvent } from "../../agent/types.js";
 import type { Runtime } from "../../cli/runtime.js";
@@ -15,6 +18,9 @@ import type { StatusLineMode } from "../../config/types.js";
 import { type Component, type Theme } from "../../tui.js";
 import { StatusBar } from "./status-bar.js";
 import { StatusLine } from "./status-line.js";
+import { QuotaLine, type QuotaView } from "./status-quota.js";
+/** 配额行重画间隔（倒计时只到分钟）。 */
+export declare const QUOTA_TICK_MS = 60000;
 /** 一行提示；空时不占行。 */
 export declare class HintLine implements Component {
     private text;
@@ -42,6 +48,10 @@ export declare class StatusArea {
     readonly hint: HintLine;
     readonly bar: StatusBar;
     readonly rate: StatusLine;
+    /** [W6] 订阅配额行（full 第三行）。 */
+    readonly quota: QuotaLine;
+    private lastQuota;
+    private ticker;
     private mode;
     private startedAt;
     private git;
@@ -52,6 +62,13 @@ export declare class StatusArea {
     private fallback;
     private bashSandbox;
     constructor(deps: StatusAreaDeps);
+    /** [W6] 当前模型走 ChatGPT 订阅时的配额；codex 还没数据为 pending，SIWC 没数据或非订阅模型不显示。 */
+    quotaView(): QuotaView;
+    private backendMemo;
+    /** 模型的 ChatGPT 订阅后端（渠道 compat `chatgptBackend`）；按引用记住上次结果。 */
+    private backendOf;
+    /** 第三行显示且有重置时间时每分钟重画；否则不挂计时器。 */
+    private syncTicker;
     layout(): StatusLineMode;
     /** [W6-A] 界面配置（Agent 栏开关、子 Agent 视图的消息显示选项）。 */
     ui(): NonNullable<Runtime["config"]["ui"]>;
@@ -64,6 +81,7 @@ export declare class StatusArea {
     /** 返回 true：事件已处理完（只需重画），调用方不再分派。 */
     onEvent(event: SessionEvent): boolean;
     dispose(): void;
+    private disposeGit;
     private gitView;
     private watchGit;
 }

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

@@ -8,6 +8,9 @@
  *   session_rewound、/tree 之后；结果变化时重画。
  * - [W5-U] `model_fallback` 之后状态栏模型项显示 `主模型 → 回退模型`，切回主模型（`model_changed`）后消失。
  * - `telemetry_tick`（流式中 ≤ 2 Hz）只重取统计并重画（速率行），状态栏的内容这时不变。
+ * - [W6] 订阅配额（status-quota.ts）：记住最近一次 `quota_update`（账户级，换会话不清；换到别的供应商不显示），
+ *   full 时在状态栏下方占第三行、compact 时在行尾追加短项；第三行显示中每分钟重画一次（重置倒计时），
+ *   不显示时不挂计时器。Ctrl+G 折叠时第三行与速率行一起收起。
  */
 import { msg } from "../../i18n/index.js";
 import { basename } from "node:path";
@@ -20,8 +23,11 @@ import { effectiveCodemodeMode } from "../../tools/presets.js";
 import { truncateToWidth } from "../../tui.js";
 import { StatusBar } from "./status-bar.js";
 import { StatusLine } from "./status-line.js";
+import { QuotaLine } from "./status-quota.js";
 /** 结束后可能改了工作区的工具。 */
 const WRITE_TOOLS = new Set(["write", "edit", "bash", "task"]);
+/** 配额行重画间隔（倒计时只到分钟）。 */
+export const QUOTA_TICK_MS = 60_000;
 /** 一行提示；空时不占行。 */
 export class HintLine {
     text = "";
@@ -38,6 +44,10 @@ export class StatusArea {
     hint = new HintLine();
     bar;
     rate;
+    /** [W6] 订阅配额行（full 第三行）。 */
+    quota;
+    lastQuota;
+    ticker;
     mode;
     startedAt;
     git;
@@ -79,10 +89,53 @@ export class StatusArea {
                     .session()
                     .getTools()
                     .some((tool) => tool.name === "bash"),
+            quota: () => this.quotaView(),
         };
         this.bar = new StatusBar(source, deps.theme);
         this.rate = new StatusLine(this.bar, source, deps.theme);
+        this.quota = new QuotaLine({ layout: () => this.mode, quota: () => this.quotaView(), now: () => deps.now() }, deps.theme);
         this.watchGit();
+        this.syncTicker();
+    }
+    /** [W6] 当前模型走 ChatGPT 订阅时的配额；codex 还没数据为 pending，SIWC 没数据或非订阅模型不显示。 */
+    quotaView() {
+        const model = this.deps.session().state.model;
+        if (model === undefined)
+            return undefined;
+        const backend = this.backendOf(formatModelRef(model));
+        if (backend === undefined)
+            return undefined;
+        const quota = this.lastQuota ?? this.deps.session().getStats().subscription?.quota;
+        if (quota !== undefined && quota.provider === model.provider)
+            return { quota };
+        return backend === "codex" ? "pending" : undefined;
+    }
+    backendMemo;
+    /** 模型的 ChatGPT 订阅后端（渠道 compat `chatgptBackend`）；按引用记住上次结果。 */
+    backendOf(ref) {
+        if (this.backendMemo?.ref === ref)
+            return this.backendMemo.backend;
+        const found = this.deps.runtime.providers.findModel(ref);
+        const value = found.ok
+            ? found.model.compat?.chatgptBackend
+            : undefined;
+        const backend = value === "codex" || value === "siwc" ? value : undefined;
+        this.backendMemo = { ref, backend };
+        return backend;
+    }
+    /** 第三行显示且有重置时间时每分钟重画；否则不挂计时器。 */
+    syncTicker() {
+        const view = this.mode === "full" ? this.quotaView() : undefined;
+        const ticking = typeof view === "object" &&
+            (view.quota.primary?.resetsAt !== undefined || view.quota.secondary?.resetsAt !== undefined);
+        if (ticking && this.ticker === undefined) {
+            this.ticker = setInterval(() => this.deps.render(), QUOTA_TICK_MS);
+            this.ticker.unref?.();
+        }
+        else if (!ticking && this.ticker !== undefined) {
+            clearInterval(this.ticker);
+            this.ticker = undefined;
+        }
     }
     layout() {
         return this.mode;
@@ -95,6 +148,7 @@ export class StatusArea {
         if (mode === this.mode)
             return;
         this.mode = mode;
+        this.syncTicker();
         (this.deps.redraw ?? this.deps.render)();
     }
     toggle() {
@@ -110,6 +164,7 @@ export class StatusArea {
         this.fallback = undefined;
         this.watchGit();
         this.bar.refresh();
+        this.syncTicker();
     }
     refreshGit() {
         void this.git?.refresh();
@@ -120,6 +175,10 @@ export class StatusArea {
             case "telemetry_tick":
                 this.bar.refresh();
                 return true;
+            case "quota_update":
+                this.lastQuota = event;
+                this.syncTicker();
+                return true;
             case "agent_settled":
             case "session_rewound":
                 this.refreshGit();
@@ -141,6 +200,7 @@ export class StatusArea {
                     if (formatModelRef(model) === this.fallback.from)
                         this.fallback = undefined;
                 }
+                this.syncTicker();
                 return false;
             }
             default:
@@ -148,6 +208,12 @@ export class StatusArea {
         }
     }
     dispose() {
+        this.disposeGit();
+        if (this.ticker !== undefined)
+            clearInterval(this.ticker);
+        this.ticker = undefined;
+    }
+    disposeGit() {
         this.offGit();
         this.git?.dispose();
         this.git = undefined;
@@ -162,7 +228,7 @@ export class StatusArea {
         const cwd = this.deps.session().state.cwd;
         if (cwd === this.gitCwd && this.git !== undefined)
             return;
-        this.dispose();
+        this.disposeGit();
         this.gitCwd = cwd;
         const git = new GitInfoWatcher(cwd, this.deps.env !== undefined ? { env: this.deps.env } : {});
         this.git = git;

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