@armadra/agent 0.7.1 → 0.7.2

package/dist/modes/acp/acp-events.js

@@ -12,9 +12,13 @@
  * | permission_resolved（allow / allow_session）| tool_call_update（in_progress）                                |
  * | tool_execution_end                        | tool_call_update（completed / failed，`[diff?, text]`，locations[].line） |
  * | todo_updated                              | plan                                                             |
- * | turn_end                                  | usage_update（上下文用量、窗口、会话累计美元）                   |
+ * | message_end（助手）/ turn_end             | usage_update（上下文用量、窗口、会话累计美元；与上次同值不发）   |
  * | permission_mode_changed                   | current_mode_update + config_option_update                       |
- * | model_changed / thinking_level_changed    | config_option_update                                             |
+ * | model_changed                             | config_option_update + usage_update（窗口可能变了，不去重）      |
+ * | thinking_level_changed                    | config_option_update                                             |
+ *
+ * new / load（回放之后）/ resume 的答复发出后，{@link AcpEventMapper.announce} 另发一条 `usage_update`，
+ * 客户端不用等第一轮结束就能显示用量。模型窗口未知时不发：schema 里 `size` 必填，不编造窗口。
  *
  * 工具结果只回前 4 KB 文本（完整结果在 ama 会话里）；diff 只在实时事件里有（`fileChange` 不落盘）。
  * `session/load` 回放同一套映射（用户消息 → user_message_chunk，工具结果带文本、无 diff）。
@@ -54,6 +58,8 @@ export class AcpEventMapper {
     usedWireIds = new Set();
     /** 上次 `session_info_update` 带出的标题。 */
     lastTitle = null;
+    /** 上次 `usage_update` 的内容（同值不重发）。 */
+    lastUsage;
     constructor(cwd, emit, session, 
     /** 会话的配置项与命令表（{@link announce} 与配置变化时取；[ACP-D] 填实际内容）。 */
     extras = () => ({ configOptions: [], commands: [] })) {
@@ -62,11 +68,15 @@ export class AcpEventMapper {
         this.session = session;
         this.extras = extras;
     }
-    /** 会话 new / load / resume 的响应发出后由服务端调：`available_commands_update` 与 `config_option_update`。 */
+    /**
+     * 会话 new / load / resume 的响应发出后由服务端调：`available_commands_update`、`config_option_update`
+     * 与 `usage_update`（客户端可能刚重建线程，用量不去重，照发一次）。
+     */
     announce() {
         const { configOptions, commands } = this.extras();
         this.emit({ sessionUpdate: "available_commands_update", availableCommands: commands });
         this.emit({ sessionUpdate: "config_option_update", configOptions });
+        this.emitUsage(true);
     }
     /** 回合结束后由服务端调：`session_info_update`（标题与上次不同才带 title）。 */
     emitSessionInfo(title, updatedAt) {
@@ -188,6 +198,11 @@ export class AcpEventMapper {
                     })),
                 });
                 return;
+            case "message_end":
+                // 多工具轮里每条助手消息都更新一次用量，不等整轮结束
+                if ("role" in event.message && event.message.role === "assistant")
+                    this.emitUsage();
+                return;
             case "turn_end":
                 this.emitUsage();
                 return;
@@ -205,21 +220,32 @@ export class AcpEventMapper {
                     sessionUpdate: "config_option_update",
                     configOptions: this.extras().configOptions,
                 });
+                if (event.type === "model_changed")
+                    this.emitUsage(true); // 换模型照发（窗口可能变了）
                 return;
             default:
                 return;
         }
     }
-    emitUsage() {
+    /**
+     * 发一条 `usage_update`：上下文用量、窗口与会话累计美元。窗口未知时不发（`size` 必填）；
+     * 与上次内容相同时不发，`force` 时照发。
+     */
+    emitUsage(force = false) {
         const stats = this.session().getStats();
         if (stats.contextWindow === undefined)
             return;
-        this.emit({
+        const update = {
             sessionUpdate: "usage_update",
             used: stats.contextTokens ?? 0,
             size: stats.contextWindow,
             ...(stats.cost !== undefined ? { cost: { amount: stats.cost, currency: "USD" } } : {}),
-        });
+        };
+        const key = JSON.stringify(update);
+        if (!force && key === this.lastUsage)
+            return;
+        this.lastUsage = key;
+        this.emit(update);
     }
     /** `session/load`：按消息回放历史（工具结果带前 4 KB 文本；diff 不落盘，回放没有）。 */
     replay(messages) {

package/dist/modes/commands-core.js

@@ -24,6 +24,7 @@ import { rewindCommand } from "./interactive/rewind-command.js";
 import { describeAgents, describeTaskOutput, describeTasks, stopTask, } from "./interactive/tasks-report.js";
 import { backgroundTasks, backgroundedText } from "./interactive/task-background.js";
 import { describeCache, describeFingerprint, describeSession } from "./session-report.js";
+import { describeContext } from "./context-report.js";
 import { msg } from "../i18n/index.js";
 export { describeSession } from "./session-report.js";
 /** [W6-C0] 各功能批次实现的第六波命令（没有处理器时回「尚未提供」）。 */
@@ -61,6 +62,7 @@ export const BUILTIN_COMMANDS = [
     command("tools", "tools", { key: "toolsArgs" }),
     command("hooks", "hooks"),
     command("session", "session"),
+    command("context", "context"),
     command("cache", "cache", "[warm off|streaming|idle | fingerprint]"),
     command("statusline", "statusline", "[full|compact]"),
     command("plan", "plan", { key: "planArgs" }),
@@ -239,6 +241,8 @@ export async function runSlashCommand(line, ctx) {
         }
         case "session":
             return { kind: "handled", message: describeSession(session) };
+        case "context":
+            return { kind: "handled", message: describeContext(session) };
         case "cache":
             return { kind: "handled", message: cacheCommand(session, args) };
         case "rewind":

package/dist/modes/context-report.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `/context`：上下文分类明细的报告（line 模式文本与交互模式面板共用）。
+ *
+ * - 顶部：已用 / 窗口（百分比）、剩余、来源（「usage 实测 X + 估算 Y」或「全量估算」）、自动压缩阈值
+ *   （窗口 − 预留，读会话的压缩设置与 `state.autoCompaction`）与档一裁剪起点；
+ * - 按类别：系统提示（按节）、工具声明（按工具）、用户消息、助手文本、推理、工具调用参数、工具结果
+ *   （按工具名）、附件图片、摘要（压缩 / 分支）、自定义消息；每类 token 估算、占比与条形；
+ * - 底部：最大的 N 个工具结果，只有序号、工具名与大小，**绝不显示正文**。
+ *
+ * 统计只读：取活动分支的投影（与 `getStats().contextTokens` 同一口径），不改请求体、不写条目。
+ */
+import type { AgentSession } from "../agent/types.js";
+import { type ContextBreakdown } from "../compaction/breakdown.js";
+import { type ContextEstimate } from "../compaction/estimate.js";
+import { type Component, type Theme } from "../tui.js";
+/** 底部列出的工具结果个数。 */
+export declare const CONTEXT_TOP_RESULTS = 5;
+export interface ContextSnapshot {
+    breakdown: ContextBreakdown;
+    estimate: ContextEstimate;
+    window: number | undefined;
+    /** 0–100（一位小数，封顶 100）；无窗口时 undefined。 */
+    percent: number | undefined;
+    autoCompaction: boolean;
+    /** 档二自动压缩的触发点（窗口 − 预留）；无窗口时 undefined。 */
+    compactAt: number | undefined;
+    /** 档一裁剪的触发点；无窗口时 undefined。 */
+    pruneAt: number | undefined;
+}
+/** 读会话的当前上下文（只读）。 */
+export declare function contextSnapshot(session: AgentSession): ContextSnapshot;
+/** 纯文本（line 模式、无面板时的通知）。 */
+export declare function describeContext(session: AgentSession): string;
+/** 交互模式的消息区面板（左竖条卡片）。 */
+export declare function contextPanel(session: AgentSession, theme: Theme): Component;

package/dist/modes/context-report.js

@@ -0,0 +1,172 @@
+/**
+ * `/context`：上下文分类明细的报告（line 模式文本与交互模式面板共用）。
+ *
+ * - 顶部：已用 / 窗口（百分比）、剩余、来源（「usage 实测 X + 估算 Y」或「全量估算」）、自动压缩阈值
+ *   （窗口 − 预留，读会话的压缩设置与 `state.autoCompaction`）与档一裁剪起点；
+ * - 按类别：系统提示（按节）、工具声明（按工具）、用户消息、助手文本、推理、工具调用参数、工具结果
+ *   （按工具名）、附件图片、摘要（压缩 / 分支）、自定义消息；每类 token 估算、占比与条形；
+ * - 底部：最大的 N 个工具结果，只有序号、工具名与大小，**绝不显示正文**。
+ *
+ * 统计只读：取活动分支的投影（与 `getStats().contextTokens` 同一口径），不改请求体、不写条目。
+ */
+import { AgentSessionImpl } from "../agent/session.js";
+import { DEFAULT_COMPACTION_SETTINGS } from "../agent/session-compaction.js";
+import { breakdownMessages, largestToolResults, } from "../compaction/breakdown.js";
+import { estimateContextTokens, estimateProjectedTokens, } from "../compaction/estimate.js";
+import { prunePolicy } from "../compaction/prune-tier.js";
+import { msg } from "../i18n/index.js";
+import { buildProjection } from "../session/projection.js";
+import { Card, KeyValue, Meter, Text, } from "../tui.js";
+import { Indent, Stack } from "./interactive/panels.js";
+import { formatTokenCount, renderRows } from "./session-report.js";
+/** 底部列出的工具结果个数。 */
+export const CONTEXT_TOP_RESULTS = 5;
+/** 每类最多列出的名字（节、工具…）。 */
+const MAX_PARTS = 6;
+/** 读会话的当前上下文（只读）。 */
+export function contextSnapshot(session) {
+    let messages = session.messages;
+    let estimate;
+    let compaction = {};
+    if (session instanceof AgentSessionImpl) {
+        const branch = session.manager.branch();
+        const items = buildProjection(branch).items;
+        messages = items.map((item) => item.message);
+        estimate = estimateProjectedTokens(items, branch);
+        compaction = (session.options.compaction ?? {});
+    }
+    else
+        estimate = estimateContextTokens(messages);
+    const window = session.getStats().contextWindow;
+    const reserve = compaction.reserveTokens ?? DEFAULT_COMPACTION_SETTINGS.reserveTokens;
+    const budget = window === undefined ? undefined : Math.max(0, window - reserve);
+    const percent = window === undefined || window <= 0
+        ? undefined
+        : Math.min(100, Math.round((estimate.tokens / window) * 1000) / 10);
+    return {
+        breakdown: breakdownMessages(messages),
+        estimate,
+        window,
+        percent,
+        autoCompaction: session.state.autoCompaction,
+        compactAt: budget,
+        pruneAt: budget === undefined ? undefined : prunePolicy(budget, compaction.prune).triggerTokens,
+    };
+}
+function headerRows(snap) {
+    const m = msg().report.contextReport;
+    const { estimate, window } = snap;
+    const rows = [
+        {
+            key: m.keyUsed,
+            value: m.used(formatTokenCount(estimate.tokens), window === undefined ? "?" : formatTokenCount(window), snap.percent === undefined ? undefined : `${snap.percent.toFixed(1)}%`),
+        },
+    ];
+    if (window !== undefined)
+        rows.push({
+            key: m.keyLeft,
+            value: m.left(formatTokenCount(Math.max(0, window - estimate.tokens))),
+        });
+    rows.push({
+        key: m.keySource,
+        value: estimate.lastUsageIndex === null
+            ? m.sourceEstimate
+            : m.sourceUsage(formatTokenCount(estimate.usageTokens), formatTokenCount(estimate.trailingTokens)),
+    });
+    let auto;
+    if (!snap.autoCompaction)
+        auto = m.autoCompactOff;
+    else if (snap.compactAt === undefined)
+        auto = m.windowUnknown;
+    else if (estimate.tokens >= snap.compactAt)
+        auto = m.autoCompactReached(formatTokenCount(snap.compactAt));
+    else
+        auto = m.autoCompact(formatTokenCount(snap.compactAt), formatTokenCount(snap.compactAt - estimate.tokens));
+    rows.push({ key: m.keyAutoCompact, value: auto });
+    if (snap.autoCompaction && snap.pruneAt !== undefined)
+        rows.push({ key: m.keyPrune, value: m.prune(formatTokenCount(Math.floor(snap.pruneAt))) });
+    return rows;
+}
+function partName(entry, name) {
+    const names = msg().report.contextReport.partNames;
+    if (entry.category === "summaries" || entry.category === "images")
+        return names[name] ?? name;
+    return name;
+}
+function partsText(entry) {
+    const m = msg().report.contextReport;
+    const shown = entry.parts
+        .slice(0, MAX_PARTS)
+        .map((part) => `${partName(entry, part.name)} ${formatTokenCount(part.tokens)}`);
+    if (entry.parts.length > MAX_PARTS)
+        shown.push(m.more(entry.parts.length - MAX_PARTS));
+    if (entry.category === "images" && entry.count > 0)
+        shown.unshift(m.images(entry.count));
+    return shown.join(" · ");
+}
+function categoryRows(breakdown, theme) {
+    const m = msg().report.contextReport;
+    const dim = (text) => (theme === undefined ? text : theme.fg("dim", text));
+    return breakdown.entries.map((entry) => {
+        const ratio = breakdown.total > 0 ? entry.tokens / breakdown.total : undefined;
+        // 占比条只表示份额，不按阈值变色
+        const meter = new Meter(ratio, { warnAt: 2, dangerAt: 2, ...(theme ? { theme } : {}) });
+        const parts = partsText(entry);
+        return {
+            key: m.categories[entry.category],
+            value: `${formatTokenCount(entry.tokens).padStart(6)}  ${meter.render(40)[0] ?? ""}` +
+                (parts === "" ? "" : `  ${dim(parts)}`),
+        };
+    });
+}
+function largestRows(breakdown) {
+    return largestToolResults(breakdown, CONTEXT_TOP_RESULTS).map((result) => ({
+        key: `#${result.ordinal}`,
+        value: `${formatTokenCount(result.tokens).padStart(6)}  ${result.toolName}`,
+    }));
+}
+/** 纯文本（line 模式、无面板时的通知）。 */
+export function describeContext(session) {
+    const m = msg().report.contextReport;
+    const snap = contextSnapshot(session);
+    const { breakdown } = snap;
+    const lines = [m.title, ...renderRows(headerRows(snap), "  "), ""];
+    lines.push(m.breakdown(formatTokenCount(breakdown.total)));
+    lines.push(`  ${breakdown.hasSystem ? m.prefixCounted : m.prefixPending}`);
+    if (breakdown.total === 0)
+        lines.push(`  ${m.empty}`);
+    else
+        lines.push(...renderRows(categoryRows(breakdown, undefined), "  "));
+    lines.push("", m.largest(CONTEXT_TOP_RESULTS));
+    const largest = largestRows(breakdown);
+    if (largest.length === 0)
+        lines.push(`  ${m.noToolResults}`);
+    else
+        lines.push(...renderRows(largest, "  "));
+    return lines.join("\n");
+}
+/** 交互模式的消息区面板（左竖条卡片）。 */
+export function contextPanel(session, theme) {
+    const m = msg().report.contextReport;
+    const snap = contextSnapshot(session);
+    const { breakdown } = snap;
+    const table = (rows, wrap = false) => new KeyValue(rows, { theme, maxKeyRatio: 0.3, ...(wrap ? { wrap: true } : {}) });
+    const largest = largestRows(breakdown);
+    const parts = [
+        table(headerRows(snap)),
+        "",
+        theme.bold(m.breakdown(formatTokenCount(breakdown.total))),
+        new Indent(new Stack([
+            new Text(theme.fg("dim", breakdown.hasSystem ? m.prefixCounted : m.prefixPending)),
+            breakdown.total === 0
+                ? theme.fg("dim", m.empty)
+                : table(categoryRows(breakdown, theme), true),
+        ]), 2),
+        "",
+        theme.bold(m.largest(CONTEXT_TOP_RESULTS)),
+        largest.length === 0
+            ? new Indent(new Stack([theme.fg("dim", m.noToolResults)]), 2)
+            : new Indent(table(largest), 2),
+    ];
+    return new Card(new Stack(parts), { theme, title: m.title });
+}

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

@@ -37,6 +37,8 @@ export interface BarRow {
     turns: number;
     tool?: string;
     elapsedMs?: number;
+    /** 外部 Agent 报告的上下文占用（已格式化，如 `34%`）。 */
+    context?: string;
 }
 /** 栏与视图读的任务注册表（当前会话的 `registryOf(sessionId)`；测试给假的）。 */
 export type TaskSource = Pick<SubagentRegistry, "list" | "get" | "live" | "message">;

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

@@ -19,6 +19,7 @@
  * - 状态来自任务注册表（`TaskInfo`、`live().queued`）、子 Agent 折叠视图的跟踪（轮数、最近工具、用时，界面时钟）
  *   与 `permission_request.context.taskId`（等审批）。
  */
+import { formatTaskContext } from "../../agents/task-record.js";
 import { msg } from "../../i18n/index.js";
 import { formatElapsed, truncateToWidth, visibleWidth, } from "../../tui.js";
 export const BAR_ROWS = 3;
@@ -71,6 +72,9 @@ export function taskRow(info, ctx) {
         status,
         turns: Math.max(state?.turns ?? 0, info.turns ?? 0),
     };
+    const context = formatTaskContext(info);
+    if (context !== undefined)
+        row.context = context;
     const tool = state?.tools.at(-1);
     if (tool !== undefined && status !== "queued")
         row.tool = tool;
@@ -95,6 +99,8 @@ export function rowFacts(row, withTool = true) {
         facts[0] += ` ${formatElapsed(row.elapsedMs)}`;
     if (row.turns > 0)
         facts.push(msg().agents.turns(row.turns));
+    if (row.context !== undefined)
+        facts.push(msg().agents.context(row.context));
     if (withTool && row.tool !== undefined && row.status === "running")
         facts.push(row.tool);
     return facts.join(" · ");

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

@@ -6,7 +6,8 @@
  *   之前分叉，消息文本回填编辑器）、权限模式、思考级别；
  * - 交互模式自有命令：`/tree`（同一文件内换叶子到选中消息之前，文本回填编辑器，可改后重发形成新分支）、
  *   `/permissions`（当前模式、判定顺序与已加载规则）；`/help` 追加这两条与按键说明。
- * - `/session`、`/cache`（无参数）与 `/permissions` 在消息区画左竖条面板（panels.ts），不再拍成文本。
+ * - `/session`、`/cache`（无参数）与 `/permissions` 在消息区画左竖条面板（panels.ts），不再拍成文本；
+ *   `/context` 同样画面板（context-report.ts，`PANEL_COMMANDS`），没有面板时回落文本。
  * - `/rewind`（无参数）打开回滚列表与确认面板（rewind-flow.ts）；带参数走 commands-core，对话变了时
  *   重画消息区并回填原消息。
  * - 不是命令（含模板与 `/skill:`）返回 false，调用方把整行当提示发出。

package/dist/modes/interactive/commands.js

@@ -6,7 +6,8 @@
  *   之前分叉，消息文本回填编辑器）、权限模式、思考级别；
  * - 交互模式自有命令：`/tree`（同一文件内换叶子到选中消息之前，文本回填编辑器，可改后重发形成新分支）、
  *   `/permissions`（当前模式、判定顺序与已加载规则）；`/help` 追加这两条与按键说明。
- * - `/session`、`/cache`（无参数）与 `/permissions` 在消息区画左竖条面板（panels.ts），不再拍成文本。
+ * - `/session`、`/cache`（无参数）与 `/permissions` 在消息区画左竖条面板（panels.ts），不再拍成文本；
+ *   `/context` 同样画面板（context-report.ts，`PANEL_COMMANDS`），没有面板时回落文本。
  * - `/rewind`（无参数）打开回滚列表与确认面板（rewind-flow.ts）；带参数走 commands-core，对话变了时
  *   重画消息区并回填原消息。
  * - 不是命令（含模板与 `/skill:`）返回 false，调用方把整行当提示发出。
@@ -22,6 +23,7 @@ import { listSessions } from "../../cli/compose-store.js";
 import { hideFakeProvider } from "../../cli/fake-visibility.js";
 import { autoLayerText, permissionModeLabel } from "../../permissions/modes.js";
 import { BUILTIN_COMMANDS, parseSlash, runSlashCommand, } from "../commands-core.js";
+import { contextPanel } from "../context-report.js";
 import { contentText } from "./message-view.js";
 import { cachePanel, permissionsPanel, sessionPanel } from "./panels.js";
 import { modelItems, permissionPickerSpec, sessionItems, thinkingItems, treeItems, } from "./pickers.js";
@@ -60,6 +62,13 @@ export const PANEL_COMMANDS = {
         await ui.traceView(args === "" ? undefined : args);
         return true;
     },
+    context: async (ui) => {
+        const theme = ui.theme?.();
+        if (ui.panel === undefined || theme === undefined)
+            return false;
+        ui.panel(contextPanel(ui.session(), theme));
+        return true;
+    },
     memory: async (ui, args) => {
         if (ui.memoryPanel === undefined)
             return false;

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

@@ -30,6 +30,7 @@ import { Editor, TUI, type Keybindings, type Terminal, type Theme } from "../../
 import { MessageView } from "./message-view.js";
 import { StatusArea } from "./status-area.js";
 import type { StatusBar } from "./status-bar.js";
+import { type ProgramStatusOptions } from "./program-status-ui.js";
 import { ToolTracker } from "./tool-view.js";
 export interface InteractiveModeOptions {
     /** 缺省 `ProcessTerminal`（测试注入 MemoryTerminal）。 */
@@ -48,6 +49,8 @@ export interface InteractiveModeOptions {
     onReady?(handle: InteractiveHandle): void;
     /** 剪贴板读取的注入（测试；缺省调系统命令）。 */
     clipboard?: ClipboardDeps;
+    /** 终端程序状态 OSC 7501（缺省只在真实终端启用；测试注入终端时给了才启用）。 */
+    programStatus?: ProgramStatusOptions;
 }
 export interface InteractiveHandle {
     readonly tui: TUI;

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

@@ -50,6 +50,7 @@ import { playStartupAnimation } from "./startup-logo.js";
 import { QueueView, RunIndicator } from "./run-indicator.js";
 import { StatusArea, statusLineSlash } from "./status-area.js";
 import { createSessionEventHandler } from "./session-events.js";
+import { programStatusUi } from "./program-status-ui.js";
 import { SubagentTracker } from "./subagent-view.js";
 import { loadKeys, processTerminal } from "./terminal-setup.js";
 import { ToolTracker } from "./tool-view.js";
@@ -70,6 +71,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
     const keys = options.keybindings ?? loadKeys(runtime, (m) => startupWarnings.push(m));
     let session = currentSession(runtime);
     const tui = new TUI(terminal);
+    const osc7501 = programStatusUi({ tui, runtime, env, options, cwd: () => session.state.cwd });
     const view = new MessageView({
         theme,
         ...(ui.showThinking !== undefined ? { showThinking: ui.showThinking } : {}),
@@ -174,7 +176,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
         render();
     };
     // ---- 会话事件 -------------------------------------------------------------
-    const onEvent = createSessionEventHandler({
+    const handleEvent = createSessionEventHandler({
         view,
         tools,
         status,
@@ -186,6 +188,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
         notice,
         render,
     });
+    const onEvent = osc7501.wrap(handleEvent);
     let unsubscribe = session.subscribe(onEvent);
     const startupLevel = startupScreenLevel(runtime);
     const home = env["HOME"] ?? env["USERPROFILE"];
@@ -423,6 +426,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
             clearTimeout(hintTimer);
         loader.stop();
         area.dispose();
+        osc7501.exit();
         // 退出摘要留在回滚里；输入框、状态栏等底部区域撤掉，屏幕停在摘要下面
         view.addExitSummary(exitSummaryLines(session.getStats(), now() - startedAt, theme));
         tui.clear();
@@ -460,6 +464,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
             reject(new AmaError("terminal_init_failed", msg().interactive.app.terminalInitFailed(error instanceof Error ? error.message : String(error)), { cause: error }));
             return;
         }
+        osc7501.start();
         runtime.approvals.setUiBroker(broker);
         runtime.notifier.set((message, level) => notice(level, message));
         agentUi.attach(session);

package/dist/modes/interactive/panels.d.ts

@@ -2,7 +2,8 @@
  * 消息区面板（终端界面视觉设计 v1 §3.13）：`/session`、`/cache`、`/permissions` 用左竖条卡片 + 键值表
  * 渲染，而不是把纯文本拍进通知。line 模式与 RPC 仍用 session-report 的文本版。
  *
- * - `/session`：标题 `会话 <id 前 8 位> · <文件>`；模型 / 消息 / 用量 / 上下文（余量表，阈值着色），
+ * - `/session`：标题 `会话 <id 前 8 位> · <文件>`；模型 / 消息 / 累计用量 / 上下文（余量表，阈值着色与档一
+ *   裁剪阈值对齐；估算值带 `≈`；末尾是距自动压缩的余量或「自动压缩关闭」），
  *   空一行后「缓存」段（与 `/cache` 共用 `cacheRows`）；
  * - [W5-U] `/session` 多「子 Agent」行（任务汇总）与「外部 Agent」段（按 Agent 的运行次数与用量，单位不换算）；
  * - `/permissions`：权限模式、判定顺序（折行对齐值列）、规则（allow success、deny error、来源 dim）、

package/dist/modes/interactive/panels.js

@@ -2,7 +2,8 @@
  * 消息区面板（终端界面视觉设计 v1 §3.13）：`/session`、`/cache`、`/permissions` 用左竖条卡片 + 键值表
  * 渲染，而不是把纯文本拍进通知。line 模式与 RPC 仍用 session-report 的文本版。
  *
- * - `/session`：标题 `会话 <id 前 8 位> · <文件>`；模型 / 消息 / 用量 / 上下文（余量表，阈值着色），
+ * - `/session`：标题 `会话 <id 前 8 位> · <文件>`；模型 / 消息 / 累计用量 / 上下文（余量表，阈值着色与档一
+ *   裁剪阈值对齐；估算值带 `≈`；末尾是距自动压缩的余量或「自动压缩关闭」），
  *   空一行后「缓存」段（与 `/cache` 共用 `cacheRows`）；
  * - [W5-U] `/session` 多「子 Agent」行（任务汇总）与「外部 Agent」段（按 Agent 的运行次数与用量，单位不换算）；
  * - `/permissions`：权限模式、判定顺序（折行对齐值列）、规则（allow success、deny error、来源 dim）、
@@ -11,7 +12,8 @@
 import { msg } from "../../i18n/index.js";
 import { autoLayerText, permissionModeLabel } from "../../permissions/modes.js";
 import { Card, KeyValue, Meter, } from "../../tui.js";
-import { cacheRows, externalRows, formatTokenCount, formatUsd, taskStatsText, } from "../session-report.js";
+import { ctxPercentText, ctxWarnAt } from "./status-ctx.js";
+import { autoCompactText, cacheRows, contextEstimated, externalRows, formatTokenCount, formatUsd, taskStatsText, } from "../session-report.js";
 import { tildePath } from "../../cli/startup-screen.js";
 /** 多段内容按顺序拼起来（段之间不加空行，由调用方放空串）。 */
 export class Stack {
@@ -64,12 +66,18 @@ export function sessionPanel(session, theme, options = {}) {
     const sep = theme.fg("dim", " · ");
     const model = state.model === undefined ? "?" : `${state.model.provider}/${state.model.id}`;
     const ratio = stats.contextPercent === undefined ? undefined : stats.contextPercent / 100;
-    const meter = new Meter(ratio, { theme }).render(40)[0] ?? "";
+    const approx = contextEstimated(stats) ? "≈" : "";
+    const meter = new Meter(ratio, {
+        theme,
+        warnAt: ctxWarnAt(stats),
+        percent: (r) => approx + ctxPercentText(r * 100, false),
+    }).render(40)[0] ?? "";
     const window = stats.contextTokens === undefined && stats.contextWindow === undefined
         ? ""
         : sep +
-            `${stats.contextTokens === undefined ? "?" : formatTokenCount(stats.contextTokens)} / ` +
+            `${stats.contextTokens === undefined ? "?" : approx + formatTokenCount(stats.contextTokens)} / ` +
             `${stats.contextWindow === undefined ? "?" : formatTokenCount(stats.contextWindow)}`;
+    const auto = autoCompactText(stats);
     const rows = [
         {
             key: m.model,
@@ -97,7 +105,7 @@ export function sessionPanel(session, theme, options = {}) {
                 formatUsd(stats.cost),
             ].join(sep),
         },
-        { key: m.context, value: meter + window },
+        { key: m.context, value: meter + window + (auto === undefined ? "" : sep + auto) },
     ];
     const tasks = taskStatsText(session);
     if (tasks !== undefined)

package/dist/modes/interactive/program-status-ui.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 交互界面的终端程序状态（OSC 7501，src/tui/program-status.ts）：会话事件 → 根记录与子任务记录。
+ *
+ * 根记录（优先级自上而下）：
+ *   有待人处理的审批 → blocked:permission（msg = 工具 · 目标）
+ *   有待审批的计划 → blocked:question
+ *   上一回合因登录失效失败（`auth_expired`）→ blocked:auth（下一回合开始或换模型时解除）
+ *   回合进行中 → working（msg = 思考中 / 回复中 / 运行 bash / 压缩上下文，节流 + 同值去重）
+ *   回合结束 → done；出错 → error（msg = 错误首行）；用户中断 → idle；之后用户再按键 → idle
+ *   启动 / 切换会话 → idle
+ * 子记录：子 Agent 任务 `id=task/<短 id>`、title = 任务描述，working / blocked / done / error（中断为 idle）；
+ * 下一个主回合开始时清掉已结束的任务记录。退出交互模式前发不带 id 的 `state=clear`（用户主动退出，
+ * 不留记录）。
+ *
+ * 只在交互 TUI 里启用；print / rpc / acp 的 stdout 是数据或协议，不发。
+ */
+import type { SessionEvent } from "../../agent/types.js";
+import type { Runtime } from "../../cli/runtime.js";
+import { ProgramStatusEmitter, type ProgramStatusReport } from "../../tui/program-status.js";
+import type { TUI } from "../../tui.js";
+export interface ProgramStatusOptions {
+    /** 检测超时（ms），缺省 300。 */
+    timeoutMs?: number;
+    /** 同一状态下 msg 更新的最小间隔（ms），缺省 500。 */
+    throttleMs?: number;
+}
+/** 会话事件 → 状态记录（只读事件，不改会话）。 */
+export declare class ProgramStatusTracker {
+    private readonly emitter;
+    private readonly cwd;
+    private running;
+    private activity;
+    private readonly approvals;
+    private plan;
+    private auth;
+    private outcome;
+    private lastError;
+    private readonly tasks;
+    constructor(emitter: Pick<ProgramStatusEmitter, "report">, cwd?: () => string | undefined);
+    onEvent(event: SessionEvent): void;
+    /** 用户按键：已看到的 done / error 回到 idle。 */
+    acknowledge(): void;
+    /** 当前根记录（测试也用）。 */
+    root(): ProgramStatusReport;
+    /** 写出全部记录（发射器同值去重）。 */
+    sync(): void;
+    private outcomeOf;
+    private dropTask;
+    private reset;
+}
+export interface ProgramStatusUi {
+    /** 包一层会话事件处理：先更新状态记录，再交给原处理。 */
+    wrap(handler: (event: SessionEvent) => void): (event: SessionEvent) => void;
+    /** 终端进入 raw 模式之后：检测（auto）并写初始 idle。 */
+    start(): void;
+    /** 退出交互模式前：清掉全部记录、停计时器。 */
+    exit(): void;
+}
+/**
+ * 交互模式装配。缺省只在真实终端（没有注入 `terminal`）启用；测试注入终端时给了 `programStatus` 才启用，
+ * 其余情况与 `ui.programStatus: "off"` 一样全部空操作。
+ */
+export declare function programStatusUi(deps: {
+    tui: TUI;
+    runtime: Runtime;
+    env: NodeJS.ProcessEnv;
+    options: {
+        terminal?: unknown;
+        programStatus?: ProgramStatusOptions;
+    };
+    cwd(): string | undefined;
+}): ProgramStatusUi;