@armadra/agent 0.7.1 → 0.7.2

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

@@ -0,0 +1,125 @@
+/**
+ * 状态栏的上下文项（status-bar.ts 的一部分，单独成文件控制行数）。
+ *
+ * - full：`Ctx 3.0% 8.2k/272k auto`——百分比一位小数；已用量 / 窗口是绝对量；`auto` = 自动压缩开着
+ *   （关闭、熔断或窗口未知时不显示）。成员各自按优先级丢弃：先丢 `auto`、`/窗口`，再丢已用量，百分比最后丢；
+ *   会变的数字按最宽形状占位（不抖动）。
+ * - compact：`ctx 34%`，≥ 110 列换余量表；0 < 占用 < 1% 时保留一位小数（不显示成 0%）。
+ * - 上下文量不是来自 usage（压缩后新 usage 之前、启动前缀基线）时数字前加 `≈`（ASCII `~`）。
+ * - 着色：warning 与档一裁剪阈值对齐（`pruneAt / 窗口`，缺省 0.7），≥ 0.9 error。
+ * - 流式中：助手消息的 usage 已经给出在途请求的上下文量时，按 ≤ 2 Hz 采样显示它，消息结束后回到统计值。
+ */
+import { calculateContextTokens } from "../../compaction/estimate.js";
+import { msg } from "../../i18n/index.js";
+import { Meter, levelColor } from "../../tui.js";
+import { contextEstimated } from "../session-report.js";
+import { formatTokens } from "./status-bar.js";
+/** 流式 usage 的采样间隔（与 telemetry_tick 同节奏，≤ 2 Hz）。 */
+export const LIVE_CTX_INTERVAL_MS = 500;
+/** ctx 改用余量表的最小宽度（compact）。 */
+const METER_WIDTH = 110;
+/** 上下文百分比：full 一位小数；compact 取整，但 0 < p < 1 时保留一位。 */
+export function ctxPercentText(percent, decimal) {
+    return decimal || (percent > 0 && percent < 1)
+        ? `${percent.toFixed(1)}%`
+        : `${Math.round(percent)}%`;
+}
+/** 上下文着色的 warning 阈值：与档一裁剪阈值对齐（`pruneAt / 窗口`），缺省 0.7。 */
+export function ctxWarnAt(stats) {
+    const at = stats.context?.pruneAt;
+    const window = stats.contextWindow;
+    return at === undefined || window === undefined || window <= 0 ? 0.7 : Math.min(0.9, at / window);
+}
+/** 上下文量不是来自 usage（全量估算 / 启动前缀基线）：`≈`（ASCII `~`），否则空串。 */
+export function ctxApprox(stats, ascii = false) {
+    return contextEstimated(stats) ? (ascii ? "~" : "≈") : "";
+}
+/** 在途请求的上下文量（message_update 的 usage）。 */
+export class LiveContext {
+    now;
+    tokens;
+    at = Number.NEGATIVE_INFINITY;
+    constructor(now) {
+        this.now = now;
+    }
+    /** 记下 usage 给出的上下文量；距上次采样 < 500 ms 时不更新。返回是否更新了。 */
+    note(usage) {
+        if (usage === undefined)
+            return false;
+        const tokens = calculateContextTokens(usage);
+        if (tokens <= 0)
+            return false;
+        const now = this.now();
+        if (this.tokens !== undefined && now - this.at < LIVE_CTX_INTERVAL_MS)
+            return false;
+        this.tokens = tokens;
+        this.at = now;
+        return true;
+    }
+    clear() {
+        this.tokens = undefined;
+        this.at = Number.NEGATIVE_INFINITY;
+    }
+    /** 统计值 → 显示值（有在途值时以它为准，不再是估算）。 */
+    view(stats, ascii) {
+        const view = {
+            tokens: stats.contextTokens,
+            window: stats.contextWindow,
+            percent: stats.contextPercent,
+            approx: ctxApprox(stats, ascii),
+            warnAt: ctxWarnAt(stats),
+            auto: stats.context?.autoCompactAt !== undefined,
+        };
+        const window = stats.contextWindow;
+        if (this.tokens !== undefined) {
+            view.tokens = this.tokens;
+            view.approx = "";
+            if (window !== undefined && window > 0)
+                view.percent = Math.min(100, Math.round((this.tokens / window) * 1000) / 10);
+        }
+        return view;
+    }
+}
+/** compact：`ctx 34%`，宽屏换余量表。 */
+export function compactCtxText(ctx, width, theme) {
+    const { percent } = ctx;
+    if (percent === undefined)
+        return theme.fg("dim", "ctx ?");
+    if (width >= METER_WIDTH) {
+        const meter = new Meter(percent / 100, {
+            label: theme.fg("dim", "ctx"),
+            theme,
+            warnAt: ctx.warnAt,
+            percent: (ratio) => ctx.approx + ctxPercentText(ratio * 100, false),
+        });
+        return meter.render(80)[0] ?? "";
+    }
+    const color = levelColor(percent / 100, { warnAt: ctx.warnAt });
+    return theme.fg("dim", "ctx ") + theme.fg(color, ctx.approx + ctxPercentText(percent, false));
+}
+/** full：`Ctx 3.0%` + ` 8.2k` + `/272k` + ` auto`（同组 `ctx`，组内不加连接符）。 */
+export function fullCtxParts(ctx, theme, p) {
+    const dim = (text) => theme.fg("dim", text);
+    const out = [];
+    const add = (text, priority, reserve) => void out.push({
+        text,
+        priority,
+        zone: "right",
+        group: "ctx",
+        ...(reserve === undefined ? {} : { reserve }),
+    });
+    const { percent } = ctx;
+    if (percent === undefined)
+        add(dim("Ctx ?"), p.ctx, 10);
+    else {
+        const color = levelColor(percent / 100, { warnAt: ctx.warnAt });
+        add(dim("Ctx ") + theme.fg(color, ctx.approx + ctxPercentText(percent, true)), p.ctx, 10);
+    }
+    if (ctx.tokens !== undefined)
+        add(dim(` ${formatTokens(ctx.tokens)}`), p.ctxUsed, 5);
+    if (ctx.tokens !== undefined && ctx.window !== undefined)
+        add(dim(`/${formatTokens(ctx.window)}`), p.ctxWindow, 5);
+    if (ctx.auto)
+        add(dim(` ${msg().interactive.statusLine.autoCompact}`), p.ctxAuto);
+    return out;
+}

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

@@ -8,7 +8,8 @@
  * - [W7] 左右分区：左 = 状态 / 开关（`codemode on|only`〔网络未隔离追加 `net!`〕· `沙箱` · `preset 名` ·
  *   `→ 回退模型` · `queue N` · [宿主]），没有开关时左区为空、右区右对齐；右 = 度量：
  *   `tps: <速率>`（流式中是最近 2 s 窗口的瞬时值、前缀 accent；结束后是该请求的平均值；还没有请求时 `tps: —`）
- *   • `<输出 token> tok / <耗时>`（首 token 起算）`(avg <会话均速> · ttft <首 token 延迟>)` · `↑ ↓` · cache ·
+ *   • `<输出 token> tok / <耗时>`（首 token 起算）`(avg <会话均速> · ttft <首 token 延迟>)` · `Σ↑ ↓ R W`（会话累计
+ *   计费量，不是上下文；R / W 为缓存读写，为 0 不显示） · cache ·
  *   rebill，行尾 `[-]`（折叠提示：Ctrl+G 或 `/statusline compact`）；`•` 走字形表（ASCII `*`）；
  * - 数据：`StatusBar.current()` 的 `telemetry` 与用量（同一次 getStats）；流式中 `telemetry_tick` 时刷新；
  * - 丢弃顺序（数字大先丢；`tps` 与 `[-]` 永不丢）：右区度量先丢——tok/耗时 12 → token 11 → cache 10 →

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

@@ -8,7 +8,8 @@
  * - [W7] 左右分区：左 = 状态 / 开关（`codemode on|only`〔网络未隔离追加 `net!`〕· `沙箱` · `preset 名` ·
  *   `→ 回退模型` · `queue N` · [宿主]），没有开关时左区为空、右区右对齐；右 = 度量：
  *   `tps: <速率>`（流式中是最近 2 s 窗口的瞬时值、前缀 accent；结束后是该请求的平均值；还没有请求时 `tps: —`）
- *   • `<输出 token> tok / <耗时>`（首 token 起算）`(avg <会话均速> · ttft <首 token 延迟>)` · `↑ ↓` · cache ·
+ *   • `<输出 token> tok / <耗时>`（首 token 起算）`(avg <会话均速> · ttft <首 token 延迟>)` · `Σ↑ ↓ R W`（会话累计
+ *   计费量，不是上下文；R / W 为缓存读写，为 0 不显示） · cache ·
  *   rebill，行尾 `[-]`（折叠提示：Ctrl+G 或 `/statusline compact`）；`•` 走字形表（ASCII `*`）；
  * - 数据：`StatusBar.current()` 的 `telemetry` 与用量（同一次 getStats）；流式中 `telemetry_tick` 时刷新；
  * - 丢弃顺序（数字大先丢；`tps` 与 `[-]` 永不丢）：右区度量先丢——tok/耗时 12 → token 11 → cache 10 →
@@ -100,7 +101,7 @@ export class StatusLine {
         if (last?.ttftMs !== undefined) {
             metric(`${dim("ttft ")}${purple(formatSeconds(last.ttftMs))}`, PRIORITY.ttft, RESERVE.ttft, stat);
         }
-        const usage = usageItems(stats, this.bar.queued(), this.source, theme);
+        const usage = usageItems(stats, this.bar.queued(), this.source, theme, true);
         add("right", usage.tokens, PRIORITY.tokens);
         add("right", usage.cache, PRIORITY.cache);
         add("right", usage.rebill, PRIORITY.rebill);

package/dist/modes/interactive/tasks-report.js

@@ -6,6 +6,7 @@
  * - 类型：`cachedAgentInfos(sessionId) ?? sessionAgents(sessionId)`（外部 Agent 带安装状态与版本，W5-EG）。
  */
 import { cachedAgentInfos } from "../../agents/external.js";
+import { formatTaskContext } from "../../agents/task-record.js";
 import { registryOf, sessionAgents, taskRegistryView } from "../../agent/subagent-registry.js";
 import { msg } from "../../i18n/index.js";
 import { formatTokenCount, formatUsd } from "../session-report.js";
@@ -38,6 +39,9 @@ export function taskFacts(task, now) {
     const usage = task.usage;
     if (usage !== undefined && usage.input + usage.output + usage.cacheRead > 0)
         facts.push(`↑${formatTokenCount(usage.input + usage.cacheRead + usage.cacheWrite)} ↓${formatTokenCount(usage.output)}`);
+    const context = formatTaskContext(task);
+    if (context !== undefined)
+        facts.push(msg().panels.tasks.context(context));
     if (task.costUsd !== undefined && task.costUsd > 0)
         facts.push(formatUsd(task.costUsd));
     return facts;

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

@@ -215,6 +215,7 @@ export async function runPrintMode(runtime, context) {
             usage: stats.tokens,
             cost: stats.cost,
             cacheHitRate: stats.cacheHitRate,
+            ...contextOf(stats),
             ...(stats.cache !== undefined ? { cache: stats.cache } : {}),
             ...(stats.tasks !== undefined ? { tasks: stats.tasks } : {}),
             ...(denied.length > 0 ? { deniedTools: denied } : {}),
@@ -309,3 +310,14 @@ export function describeDenied(denied) {
     const tools = [...counts].map(([name, n]) => `${name} ×${n}`);
     return msg().print.print.denied(denied.length, tools, denied[0]?.reason ?? "");
 }
+/** json 结果的 `context`：上下文用量、窗口与占用（0–100）；各项未知时省略，全都未知时不带 `context`。 */
+function contextOf(stats) {
+    const context = {};
+    if (stats.contextTokens !== undefined)
+        context["tokens"] = stats.contextTokens;
+    if (stats.contextWindow !== undefined)
+        context["window"] = stats.contextWindow;
+    if (stats.contextPercent !== undefined)
+        context["percent"] = stats.contextPercent;
+    return Object.keys(context).length > 0 ? { context } : {};
+}

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

@@ -2,18 +2,26 @@
  * 会话报告与缓存提示文本（第三波 §1.10）。[W3-C2]
  *
  * line 模式、交互模式与 RPC 共用的纯文本层，不含渲染：
- * - `/session`：会话、模型、消息、用量、上下文 + 「缓存」段（`describeSession`）；
+ * - `/session`：会话、模型、消息、累计用量、上下文（估算值带 `≈`，末尾是距自动压缩的余量）+ 「缓存」段
+ *   （`describeSession`）；
  * - `/cache`：只有缓存段（`describeCache`）；`/cache fingerprint`：最近一次真实请求的前缀指纹；
  * - 消息区 / stderr 的一行提示：缓存未命中（只提示 ≥ 20k token 或 ≥ $0.10 的那次）、
  *   上下文跨越 70% / 90%（`cache.missNotices` 为 false 时都不提示，统计不受影响）。
  *
  * 两列对齐用 B9a-2 的 `KeyValue`（按足够宽的宽度渲染再去行尾空白，结果是纯文本）。
  */
-import type { AgentSession, SessionEvent } from "../agent/types.js";
+import type { AgentSession, SessionEvent, SessionStats } from "../agent/types.js";
 import type { CacheMiss, CacheReporting, WarmerStatus } from "../ai/cache/types.js";
 import { type KeyValueRow } from "../tui/components/key-value.js";
 /** `950`、`38.2k`、`150k`、`1.05M`（比状态栏多一位精度，面板与提示用）。 */
 export declare function formatTokenCount(count: number): string;
+/** 上下文量不是来自 usage（压缩后新 usage 之前的全量估算、第一次请求前的前缀基线）。 */
+export declare function contextEstimated(stats: Pick<SessionStats, "context">): boolean;
+/**
+ * 上下文行末尾的自动压缩说明：`距自动压缩 ≈ N`（到档二阈值还差多少）；自动压缩关闭或熔断时
+ * `自动压缩关闭`；窗口未知或统计没有 `context` 明细时 undefined。
+ */
+export declare function autoCompactText(stats: Pick<SessionStats, "context" | "contextTokens" | "contextWindow">): string | undefined;
 export declare function formatUsd(cost: number | undefined): string;
 export declare function formatPercent(rate: number | undefined): string;
 /** `45s`、`2m 10s`、`7 分钟`（≥ 10 分钟只到分钟）。 */

package/dist/modes/session-report.js

@@ -2,7 +2,8 @@
  * 会话报告与缓存提示文本（第三波 §1.10）。[W3-C2]
  *
  * line 模式、交互模式与 RPC 共用的纯文本层，不含渲染：
- * - `/session`：会话、模型、消息、用量、上下文 + 「缓存」段（`describeSession`）；
+ * - `/session`：会话、模型、消息、累计用量、上下文（估算值带 `≈`，末尾是距自动压缩的余量）+ 「缓存」段
+ *   （`describeSession`）；
  * - `/cache`：只有缓存段（`describeCache`）；`/cache fingerprint`：最近一次真实请求的前缀指纹；
  * - 消息区 / stderr 的一行提示：缓存未命中（只提示 ≥ 20k token 或 ≥ $0.10 的那次）、
  *   上下文跨越 70% / 90%（`cache.missNotices` 为 false 时都不提示，统计不受影响）。
@@ -26,6 +27,24 @@ export function formatTokenCount(count) {
         return `${Math.round(count / 1000)}k`;
     return `${trim((count / 1_000_000).toFixed(2))}M`;
 }
+/** 上下文量不是来自 usage（压缩后新 usage 之前的全量估算、第一次请求前的前缀基线）。 */
+export function contextEstimated(stats) {
+    const source = stats.context?.source;
+    return source !== undefined && source !== "usage";
+}
+/**
+ * 上下文行末尾的自动压缩说明：`距自动压缩 ≈ N`（到档二阈值还差多少）；自动压缩关闭或熔断时
+ * `自动压缩关闭`；窗口未知或统计没有 `context` 明细时 undefined。
+ */
+export function autoCompactText(stats) {
+    const m = msg().report.session;
+    if (stats.context === undefined || stats.contextWindow === undefined)
+        return undefined;
+    const at = stats.context.autoCompactAt;
+    if (at === undefined)
+        return m.autoCompactOff;
+    return m.toAutoCompact(formatTokenCount(Math.max(0, at - (stats.contextTokens ?? 0))));
+}
 export function formatUsd(cost) {
     if (cost === undefined)
         return "$?";
@@ -284,7 +303,12 @@ export function describeSession(session, now = Date.now()) {
         },
         {
             key: m.keyContext,
-            value: m.context(String(stats.contextTokens ?? "?"), String(stats.contextWindow ?? "?"), percent),
+            value: [
+                m.context(`${contextEstimated(stats) ? "≈" : ""}${stats.contextTokens ?? "?"}`, String(stats.contextWindow ?? "?"), percent),
+                autoCompactText(stats),
+            ]
+                .filter((part) => part !== undefined)
+                .join(" · "),
         },
     ];
     const tasks = taskStatsText(session);

package/dist/sdk.d.ts

@@ -33,7 +33,7 @@ import type { ApprovalDecision, ApprovalRequest, PermissionMode } from "./permis
 import { SessionManager } from "./session/manager.js";
 import type { ToolDefinition } from "./tools/types.js";
 /** [W3-C2] 统计类型：`session.getStats()`、RPC `get_session_stats`、`-p --output-format json` 的 `cache`。 */
-export type { SessionCacheStats, SessionStats } from "./agent/types.js";
+export type { SessionCacheStats, SessionContextStats, SessionStats } from "./agent/types.js";
 /** [RW-B] 回滚：`session.rewindPoints()`、`session.rewind()`、`summarizeFrom / summarizeUpTo`。 */
 export type { CodeRestoreResult, RewindMode, RewindPoint, RewindRequest, RewindResult, } from "./checkpoints/types.js";
 export type { CacheMiss, CacheMissReason, CacheReporting, WarmerStatus, WarmingMode, } from "./ai/cache/types.js";

package/dist/tools/types.d.ts

@@ -166,6 +166,9 @@ export type SubagentEvent = {
     /** 无美元单位的外部 Agent 按各自单位记（不换算）。 */
     unit?: "usd" | "tokens" | "requests";
     amount?: number;
+    /** 外部 Agent 报告的上下文占用与窗口（回合中途也会单独发一条只带它们的 usage）。 */
+    contextTokens?: number;
+    contextWindow?: number;
 } | {
     type: "notice";
     level: "info" | "warn";
@@ -217,6 +220,9 @@ export interface TaskInfo {
     turns?: number;
     usage?: Usage;
     costUsd?: number;
+    /** 外部 Agent 最近报告的上下文占用与窗口（token，只记数字）；驱动不报时缺省。 */
+    contextTokens?: number;
+    contextWindow?: number;
     outputFile?: string;
     sessionRef?: SubagentSessionRef;
 }

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

@@ -14,6 +14,8 @@ export interface MeterOptions {
     warnAt?: number;
     dangerAt?: number;
     theme?: Theme;
+    /** 百分比文本（缺省四舍五入到整数，`72%`）；value 为 undefined 时不调用。 */
+    percent?: (ratio: number) => string;
 }
 export declare const METER_FULL: string;
 export declare const METER_EMPTY: string;

package/dist/tui/components/meter.js

@@ -32,7 +32,7 @@ export class Meter {
     render(width) {
         const { theme, label, cells = 10 } = this.options;
         const ratio = this.value === undefined ? undefined : Math.min(1, Math.max(0, this.value));
-        const percent = ratio === undefined ? "—" : `${Math.round(ratio * 100)}%`;
+        const percent = ratio === undefined ? "—" : (this.options.percent?.(ratio) ?? `${Math.round(ratio * 100)}%`);
         const color = (c, text) => (theme ? theme.fg(c, text) : text);
         const head = label === undefined || label === "" ? "" : `${label} `;
         const filled = ratio === undefined ? 0 : Math.round(ratio * cells);

package/dist/tui/program-status.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 终端程序状态协议 OSC 7501（Program Status Protocol rev 0.3，2026-10-07）：
+ * https://www.superlogical.com/rex/docs/build/program-status
+ *
+ * - 编码（纯函数）：`ESC ] 7501 ; key=value:… ESC \`。state 必填；id 每段 `[A-Za-z0-9_.+-]{1,32}`、
+ *   ≤ 8 层、≤ 128 字节；kind 只随 blocked、progress（0–100 整数）只随 working / blocked；app 同 id 段；
+ *   title / msg 去控制字符、压成一行后按 UTF-8 字节截断（192 / 2048，不切坏字符），再 base64。
+ *   字段不合法就丢掉该字段（state / id 不合法整条不发），不发终端会整条丢弃的坏报告；整条 ≤ 4096 字节。
+ * - 检测：发 `OSC 7501 ; ?` 紧跟 `CSI c`（DA1）；先收到 `?` 回复 = 支持，DA1 回复先到或超时 = 不支持。
+ *   两种回复都在输入解析里吞掉（`handleInput`），不会当成按键进输入框；迟到的回复同样吞掉。
+ * - tmux：缺省丢弃未知 OSC，`on` 时用 DCS passthrough（`ESC P tmux; … ESC \`，内容里 ESC 翻倍）包裹，
+ *   需要 `set -g allow-passthrough on`；tmux 不把外层终端对透传查询的回复转给窗格，所以 tmux 里 `auto`
+ *   不检测、等同 `off`。
+ * - 发射器：每个 id 记最后一次写出的报告，同值不重写；同一 state 下只换 msg / title 的更新按节流合并。
+ */
+export type ProgramState = "idle" | "working" | "done" | "blocked" | "error" | "clear";
+export type BlockedKind = "permission" | "question" | "auth";
+export type ProgramStatusMode = "auto" | "on" | "off";
+export interface ProgramStatusReport {
+    state: ProgramState;
+    /** 层级 id（`task/abc`）；缺省是根记录。 */
+    id?: string;
+    kind?: BlockedKind;
+    progress?: number;
+    app?: string;
+    title?: string;
+    msg?: string;
+}
+export declare const PROGRAM_STATUS_QUERY = "\u001B]7501;?\u001B\\";
+export declare const DA1_QUERY = "\u001B[c";
+export declare const MAX_SEQUENCE_BYTES = 4096;
+export declare const MAX_TITLE_BYTES = 192;
+export declare const MAX_MSG_BYTES = 2048;
+/** 控制字符（C0、DEL、C1）换成空格，空白压成一个，去首尾。 */
+export declare function sanitizeLine(text: string): string;
+/** 按 UTF-8 字节截断到 maxBytes（按码点切，不出半个字符）；截断时末尾带 `…`。 */
+export declare function truncateUtf8(text: string, maxBytes: number): string;
+/** id 是否合法（空串不合法；根记录不带 id）。 */
+export declare function validId(id: string): boolean;
+/** 任意字符串 → 合法的单段 id（非法字符换 `_`，截到 n 个字符）；空串给 `x`。 */
+export declare function idSegment(raw: string, n?: number): string;
+/** 报告 → pairs（不含 OSC 包裹）；state / id 不合法返回 undefined。 */
+export declare function encodePairs(report: ProgramStatusReport): string | undefined;
+/** 完整的 OSC 7501 序列；报告不合法返回 undefined（不发坏报告）。 */
+export declare function encodeProgramStatus(report: ProgramStatusReport): string | undefined;
+/** tmux DCS passthrough：`ESC P tmux; <内容，ESC 翻倍> ESC \`。 */
+export declare function tmuxPassthrough(sequence: string): string;
+/** 终端对 `OSC 7501 ; ?` 的回复（`?` 之后的内容忽略）。 */
+export declare function isProgramStatusReply(sequence: string): boolean;
+/** DA1 回复 `CSI ? … c`。 */
+export declare function isDa1Reply(sequence: string): boolean;
+export interface ProgramStatusEmitterOptions {
+    write(data: string): void;
+    mode: ProgramStatusMode;
+    /** 用来判断 tmux（`TMUX`）。 */
+    env?: NodeJS.ProcessEnv;
+    /** 检测超时，缺省 300 ms。 */
+    timeoutMs?: number;
+    /** 同一 state 下只改 msg / title 的最小间隔，缺省 500 ms。 */
+    throttleMs?: number;
+    now?: () => number;
+    /** 固定加的 app 键（缺省不加）。 */
+    app?: string;
+}
+/** 发射器：检测、同值去重、节流；只在 `supported` 后写。 */
+export declare class ProgramStatusEmitter {
+    private readonly options;
+    private support;
+    private readonly tmux;
+    private readonly desired;
+    private readonly sent;
+    private readonly timers;
+    private probeTimer;
+    private readonly now;
+    constructor(options: ProgramStatusEmitterOptions);
+    /** 当前是否会写出报告。 */
+    get supported(): boolean;
+    /** 按模式开始：on 直接启用，auto 发检测查询（tmux 里不检测，等同 off），off 什么都不做。 */
+    start(): void;
+    /** 输入解析里调用：吞掉检测回复（返回 true），其余返回 false。 */
+    handleInput(sequence: string): boolean;
+    /** 设定某个 id（缺省根记录）的状态；`clear` 同时忘掉该 id 及其下层的记录。 */
+    report(report: ProgramStatusReport): void;
+    /** 停止计时器（不再写任何东西）。 */
+    dispose(): void;
+    private settleProbe;
+    private enable;
+    private forget;
+    private flush;
+}