@armadra/agent 0.7.2 → 0.7.3

package/CHANGELOG.md

@@ -5,6 +5,10 @@ English · [简体中文](CHANGELOG.zh-CN.md)
 > This file is in English starting with 0.6.0. Release notes for 0.1 through 0.5.1 are in Chinese in
 > [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md). New entries go into both files.
 
+## 0.7.3 (2026-10-09)
+
+- **`/context` before the first request**: it showed `0 / <window>` and left the system prompt and tool declarations out while the status bar already showed the baseline; it now estimates both from what the first request will send (shared with the status-bar baseline), and "Used" always matches the status bar and `getStats()`.
+
 ## 0.7.2 (2026-10-09)
 
 - **Prompt cache survives mid-session context changes**: when AGENTS.md, Skills or SessionStart hook output changed on

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,10 @@
 
 > 从 0.6.0 起 [CHANGELOG.md](CHANGELOG.md) 为英文，本文件保留中文记录（0.1–0.5.1 的完整历史在此）。新条目两份都要加。
 
+## 0.7.3（2026-10-09）
+
+- **首次请求前的 `/context`**：状态栏已显示启动基线时，它仍是 `0 / <窗口>`、不计系统提示与工具声明；现在按首次请求将要发送的内容估算这两类（与状态栏基线共用同一份装配），「已用」始终与状态栏和 `getStats()` 一致。
+
 ## 0.7.2（2026-10-09）
 
 - **会话中途上下文变化不再打断提示缓存**：resume 时 AGENTS.md、Skills 或 SessionStart Hook 输出变了、宿主 instructions 刷新、压缩后记忆节

package/dist/agent/session-compaction.d.ts

@@ -21,6 +21,7 @@
  */
 import { CompactionBreaker } from "../compaction/breaker.js";
 import { type ContextEstimate } from "../compaction/estimate.js";
+import type { SystemMessage } from "../ai/types.js";
 import { type PrunePolicy } from "../compaction/prune-tier.js";
 import type { BranchSummaryEntry } from "../session/types.js";
 import type { SessionCore } from "./session-core.js";
@@ -88,3 +89,8 @@ export declare class CompactionController {
     leaveBranch(targetId: string | null, instructions: string | undefined, signal: AbortSignal): Promise<BranchSummaryEntry | undefined>;
     private summarize;
 }
+/**
+ * 首次请求前将要发送的首条 `system` 消息（系统提示 + 工具声明，与真正发送时同样装配）。只用于统计：
+ * `getStats` 的启动基线与 `/context` 的分类明细共用它，口径一致；不写分支、不改请求体。
+ */
+export declare function pendingPrefixMessage(core: SessionCore): SystemMessage;

package/dist/agent/session-compaction.js

@@ -22,7 +22,7 @@
 import { AmaError } from "../errors.js";
 import { CompactionBreaker } from "../compaction/breaker.js";
 import { estimateMessageTokens, estimateProjectedTokens, } from "../compaction/estimate.js";
-import { estimatePrefixTokens, withPrefixBaseline } from "../compaction/prefix-estimate.js";
+import { prefixSystemMessage, withPrefixBaseline } from "../compaction/prefix-estimate.js";
 import { planPrune, prunePolicy } from "../compaction/prune-tier.js";
 import { createProtection, skillLocations } from "../compaction/protect.js";
 import { buildPostCompactBlock } from "../compaction/post-compact.js";
@@ -96,14 +96,7 @@ export class CompactionController {
     }
     /** 将要发送的系统提示 + 工具声明的估算（与首条 system 消息同样装配，不落盘）。 */
     prefixTokens() {
-        const core = this.core;
-        const tools = core
-            .activeToolNames()
-            .map((name) => core.activeTool(name))
-            .filter((tool) => tool !== undefined);
-        const system = core.childBase?.().system ?? core.options.system ?? {};
-        const sections = definedSections(assembleSections({ ...system, tools, cwd: core.cwd }));
-        return estimatePrefixTokens(sections, toolDecls(tools));
+        return estimateMessageTokens(pendingPrefixMessage(this.core));
     }
     budget() {
         const window = this.core.model().contextWindow;
@@ -411,3 +404,16 @@ export class CompactionController {
         }
     }
 }
+/**
+ * 首次请求前将要发送的首条 `system` 消息（系统提示 + 工具声明，与真正发送时同样装配）。只用于统计：
+ * `getStats` 的启动基线与 `/context` 的分类明细共用它，口径一致；不写分支、不改请求体。
+ */
+export function pendingPrefixMessage(core) {
+    const tools = core
+        .activeToolNames()
+        .map((name) => core.activeTool(name))
+        .filter((tool) => tool !== undefined);
+    const system = core.childBase?.().system ?? core.options.system ?? {};
+    const sections = definedSections(assembleSections({ ...system, tools, cwd: core.cwd }));
+    return prefixSystemMessage(sections, toolDecls(tools));
+}

package/dist/bundle/ama.cjs

@@ -41,7 +41,7 @@ var AMA_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    AMA_VERSION = true ? "0.7.2" : readPackageVersion();
+    AMA_VERSION = true ? "0.7.3" : readPackageVersion();
   }
 });
 
@@ -2992,6 +2992,7 @@ var init_report_context = __esm({
       keySource: "Source",
       sourceUsage: (usage, estimate) => `reported usage ${usage} + estimated ${estimate}`,
       sourceEstimate: "estimated in full (no usable usage yet)",
+      sourcePrefix: "system prompt and tools only, estimated before the first request",
       keyAutoCompact: "Auto-compact",
       autoCompact: (at, distance2) => `at ${at}, ≈ ${distance2} to go`,
       autoCompactReached: (at) => `at ${at}, reached`,
@@ -3002,6 +3003,7 @@ var init_report_context = __esm({
       breakdown: (total) => `By category (estimated, ${total})`,
       prefixCounted: "System prompt and tool declarations are counted from the stored system messages; the full estimate can differ from reported usage.",
       prefixPending: "System prompt and tool declarations are not counted until the first request.",
+      prefixEstimated: "System prompt and tool declarations are estimated from what the first request will send.",
       categories: {
         system: "System prompt",
         tools: "Tool declarations",
@@ -3036,6 +3038,7 @@ var init_report_context = __esm({
       keySource: "来源",
       sourceUsage: (usage, estimate) => `usage 实测 ${usage} + 估算 ${estimate}`,
       sourceEstimate: "全量估算（还没有可用的 usage）",
+      sourcePrefix: "首次请求前，只有系统提示与工具声明的估算",
       keyAutoCompact: "自动压缩",
       autoCompact: (at, distance2) => `${at} 触发，还差 ≈ ${distance2}`,
       autoCompactReached: (at) => `${at} 触发，已达到`,
@@ -3046,6 +3049,7 @@ var init_report_context = __esm({
       breakdown: (total) => `按类别（估算，${total}）`,
       prefixCounted: "系统提示与工具声明按会话里存的 system 消息计入；全量估算可能与 usage 实测不同。",
       prefixPending: "系统提示与工具声明在首次请求后才计入。",
+      prefixEstimated: "系统提示与工具声明按首次请求将要发送的内容估算。",
       categories: {
         system: "系统提示",
         tools: "工具声明",
@@ -22051,10 +22055,10 @@ var init_breaker = __esm({
 });
 
 // src/compaction/prefix-estimate.ts
-function estimatePrefixTokens(sections, tools) {
+function prefixSystemMessage(sections, tools) {
   const message = { role: "system", sections: { ...sections }, timestamp: 0 };
   if (tools.length > 0) message.toolsAdded = [...tools];
-  return estimateMessageTokens(message);
+  return message;
 }
 function withPrefixBaseline(estimate, hasSystemMessage, prefix) {
   if (estimate.usageTokens > 0) return { ...estimate, source: "usage" };
@@ -22070,7 +22074,6 @@ function withPrefixBaseline(estimate, hasSystemMessage, prefix) {
 var init_prefix_estimate = __esm({
   "src/compaction/prefix-estimate.ts"() {
     "use strict";
-    init_estimate();
   }
 });
 
@@ -22403,6 +22406,12 @@ var init_system_prompt = __esm({
 });
 
 // src/agent/session-compaction.ts
+function pendingPrefixMessage(core) {
+  const tools = core.activeToolNames().map((name) => core.activeTool(name)).filter((tool) => tool !== void 0);
+  const system = core.childBase?.().system ?? core.options.system ?? {};
+  const sections = definedSections(assembleSections({ ...system, tools, cwd: core.cwd }));
+  return prefixSystemMessage(sections, toolDecls(tools));
+}
 var DEFAULT_COMPACTION_SETTINGS, KEEP_RECENT_MAX_RATIO, HOOK_CONTEXT_CUSTOM_TYPE, CompactionController;
 var init_session_compaction = __esm({
   "src/agent/session-compaction.ts"() {
@@ -22484,11 +22493,7 @@ var init_session_compaction = __esm({
       }
       /** 将要发送的系统提示 + 工具声明的估算（与首条 system 消息同样装配，不落盘）。 */
       prefixTokens() {
-        const core = this.core;
-        const tools = core.activeToolNames().map((name) => core.activeTool(name)).filter((tool) => tool !== void 0);
-        const system = core.childBase?.().system ?? core.options.system ?? {};
-        const sections = definedSections(assembleSections({ ...system, tools, cwd: core.cwd }));
-        return estimatePrefixTokens(sections, toolDecls(tools));
+        return estimateMessageTokens(pendingPrefixMessage(this.core));
       }
       budget() {
         const window2 = this.core.model().contextWindow;
@@ -52549,20 +52554,28 @@ function contextSnapshot(session) {
   let messages = session.messages;
   let estimate;
   let compaction = {};
+  let prefixPending = false;
   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 ?? {};
+    if (!messages.some((message) => "role" in message && message.role === "system")) {
+      prefixPending = true;
+      messages = [pendingPrefixMessage(session), ...messages];
+    }
   } else estimate = estimateContextTokens(messages);
-  const window2 = session.getStats().contextWindow;
+  const stats = session.getStats();
+  if (stats.contextTokens !== void 0) estimate = { ...estimate, tokens: stats.contextTokens };
+  const window2 = stats.contextWindow;
   const reserve = compaction.reserveTokens ?? DEFAULT_COMPACTION_SETTINGS.reserveTokens;
   const budget = window2 === void 0 ? void 0 : Math.max(0, window2 - reserve);
   const percent3 = window2 === void 0 || window2 <= 0 ? void 0 : Math.min(100, Math.round(estimate.tokens / window2 * 1e3) / 10);
   return {
     breakdown: breakdownMessages(messages),
     estimate,
+    prefixPending,
     window: window2,
     percent: percent3,
     autoCompaction: session.state.autoCompaction,
@@ -52590,7 +52603,7 @@ function headerRows(snap) {
     });
   rows.push({
     key: m.keySource,
-    value: estimate.lastUsageIndex === null ? m.sourceEstimate : m.sourceUsage(
+    value: snap.prefixPending ? m.sourcePrefix : estimate.lastUsageIndex === null ? m.sourceEstimate : m.sourceUsage(
       formatTokenCount(estimate.usageTokens),
       formatTokenCount(estimate.trailingTokens)
     )
@@ -52648,7 +52661,9 @@ function describeContext(session) {
   const { breakdown } = snap;
   const lines2 = [m.title, ...renderRows(headerRows(snap), "  "), ""];
   lines2.push(m.breakdown(formatTokenCount(breakdown.total)));
-  lines2.push(`  ${breakdown.hasSystem ? m.prefixCounted : m.prefixPending}`);
+  lines2.push(
+    `  ${snap.prefixPending ? m.prefixEstimated : breakdown.hasSystem ? m.prefixCounted : m.prefixPending}`
+  );
   if (breakdown.total === 0) lines2.push(`  ${m.empty}`);
   else lines2.push(...renderRows(categoryRows(breakdown, void 0), "  "));
   lines2.push("", m.largest(CONTEXT_TOP_RESULTS));
@@ -52669,7 +52684,12 @@ function contextPanel(session, theme) {
     theme.bold(m.breakdown(formatTokenCount(breakdown.total))),
     new Indent(
       new Stack([
-        new Text(theme.fg("dim", breakdown.hasSystem ? m.prefixCounted : m.prefixPending)),
+        new Text(
+          theme.fg(
+            "dim",
+            snap.prefixPending ? m.prefixEstimated : breakdown.hasSystem ? m.prefixCounted : m.prefixPending
+          )
+        ),
         breakdown.total === 0 ? theme.fg("dim", m.empty) : table2(categoryRows(breakdown, theme), true)
       ]),
       2

package/dist/compaction/prefix-estimate.d.ts

@@ -7,8 +7,10 @@
  *
  * 只用于统计：不写分支、不改请求体，前缀缓存不受影响；压缩阈值也不看它（摘要压不掉这部分）。
  */
-import type { ToolDecl } from "../ai/types.js";
+import type { SystemMessage, ToolDecl } from "../ai/types.js";
 import type { ContextEstimate } from "./estimate.js";
+/** 将要作为首条 `system` 消息发送的内容（只用于统计，不落盘）。 */
+export declare function prefixSystemMessage(sections: Readonly<Record<string, string>>, tools: readonly ToolDecl[]): SystemMessage;
 /** 系统提示（已装配的命名节）+ 工具声明的估算。 */
 export declare function estimatePrefixTokens(sections: Readonly<Record<string, string>>, tools: readonly ToolDecl[]): number;
 /** 上下文估算的来源（`SessionStats.context.source`）。 */

package/dist/compaction/prefix-estimate.js

@@ -8,12 +8,16 @@
  * 只用于统计：不写分支、不改请求体，前缀缓存不受影响；压缩阈值也不看它（摘要压不掉这部分）。
  */
 import { estimateMessageTokens } from "./estimate.js";
-/** 系统提示（已装配的命名节）+ 工具声明的估算。 */
-export function estimatePrefixTokens(sections, tools) {
+/** 将要作为首条 `system` 消息发送的内容（只用于统计，不落盘）。 */
+export function prefixSystemMessage(sections, tools) {
     const message = { role: "system", sections: { ...sections }, timestamp: 0 };
     if (tools.length > 0)
         message.toolsAdded = [...tools];
-    return estimateMessageTokens(message);
+    return message;
+}
+/** 系统提示（已装配的命名节）+ 工具声明的估算。 */
+export function estimatePrefixTokens(sections, tools) {
+    return estimateMessageTokens(prefixSystemMessage(sections, tools));
 }
 /**
  * 给投影估算标来源；投影里还没有系统消息时把前缀基线加进去（`prefix` 懒算，只在需要时调用）。

package/dist/i18n/catalog.d.ts

@@ -1152,6 +1152,7 @@ declare const en: {
             keySource: string;
             sourceUsage: (usage: string, estimate: string) => string;
             sourceEstimate: string;
+            sourcePrefix: string;
             keyAutoCompact: string;
             autoCompact: (at: string, distance: string) => string;
             autoCompactReached: (at: string) => string;
@@ -1162,6 +1163,7 @@ declare const en: {
             breakdown: (total: string) => string;
             prefixCounted: string;
             prefixPending: string;
+            prefixEstimated: string;
             categories: {
                 system: string;
                 tools: string;

package/dist/i18n/messages/report-context.d.ts

@@ -13,6 +13,7 @@ export declare const en: {
     keySource: string;
     sourceUsage: (usage: string, estimate: string) => string;
     sourceEstimate: string;
+    sourcePrefix: string;
     keyAutoCompact: string;
     autoCompact: (at: string, distance: string) => string;
     autoCompactReached: (at: string) => string;
@@ -23,6 +24,7 @@ export declare const en: {
     breakdown: (total: string) => string;
     prefixCounted: string;
     prefixPending: string;
+    prefixEstimated: string;
     categories: {
         system: string;
         tools: string;
@@ -57,6 +59,7 @@ export declare const zh: {
     keySource: string;
     sourceUsage: (usage: string, estimate: string) => string;
     sourceEstimate: string;
+    sourcePrefix: string;
     keyAutoCompact: string;
     autoCompact: (at: string, distance: string) => string;
     autoCompactReached: (at: string) => string;
@@ -67,6 +70,7 @@ export declare const zh: {
     breakdown: (total: string) => string;
     prefixCounted: string;
     prefixPending: string;
+    prefixEstimated: string;
     categories: {
         system: string;
         tools: string;

package/dist/i18n/messages/report-context.js

@@ -14,6 +14,7 @@ export const en = {
     keySource: "Source",
     sourceUsage: (usage, estimate) => `reported usage ${usage} + estimated ${estimate}`,
     sourceEstimate: "estimated in full (no usable usage yet)",
+    sourcePrefix: "system prompt and tools only, estimated before the first request",
     keyAutoCompact: "Auto-compact",
     autoCompact: (at, distance) => `at ${at}, ≈ ${distance} to go`,
     autoCompactReached: (at) => `at ${at}, reached`,
@@ -24,6 +25,7 @@ export const en = {
     breakdown: (total) => `By category (estimated, ${total})`,
     prefixCounted: "System prompt and tool declarations are counted from the stored system messages; the full estimate can differ from reported usage.",
     prefixPending: "System prompt and tool declarations are not counted until the first request.",
+    prefixEstimated: "System prompt and tool declarations are estimated from what the first request will send.",
     categories: {
         system: "System prompt",
         tools: "Tool declarations",
@@ -58,6 +60,7 @@ export const zh = {
     keySource: "来源",
     sourceUsage: (usage, estimate) => `usage 实测 ${usage} + 估算 ${estimate}`,
     sourceEstimate: "全量估算（还没有可用的 usage）",
+    sourcePrefix: "首次请求前，只有系统提示与工具声明的估算",
     keyAutoCompact: "自动压缩",
     autoCompact: (at, distance) => `${at} 触发，还差 ≈ ${distance}`,
     autoCompactReached: (at) => `${at} 触发，已达到`,
@@ -68,6 +71,7 @@ export const zh = {
     breakdown: (total) => `按类别（估算，${total}）`,
     prefixCounted: "系统提示与工具声明按会话里存的 system 消息计入；全量估算可能与 usage 实测不同。",
     prefixPending: "系统提示与工具声明在首次请求后才计入。",
+    prefixEstimated: "系统提示与工具声明按首次请求将要发送的内容估算。",
     categories: {
         system: "系统提示",
         tools: "工具声明",

package/dist/i18n/messages/report.d.ts

@@ -97,6 +97,7 @@ export declare const en: {
         keySource: string;
         sourceUsage: (usage: string, estimate: string) => string;
         sourceEstimate: string;
+        sourcePrefix: string;
         keyAutoCompact: string;
         autoCompact: (at: string, distance: string) => string;
         autoCompactReached: (at: string) => string;
@@ -107,6 +108,7 @@ export declare const en: {
         breakdown: (total: string) => string;
         prefixCounted: string;
         prefixPending: string;
+        prefixEstimated: string;
         categories: {
             system: string;
             tools: string;
@@ -339,6 +341,7 @@ export declare const zh: {
         keySource: string;
         sourceUsage: (usage: string, estimate: string) => string;
         sourceEstimate: string;
+        sourcePrefix: string;
         keyAutoCompact: string;
         autoCompact: (at: string, distance: string) => string;
         autoCompactReached: (at: string) => string;
@@ -349,6 +352,7 @@ export declare const zh: {
         breakdown: (total: string) => string;
         prefixCounted: string;
         prefixPending: string;
+        prefixEstimated: string;
         categories: {
             system: string;
             tools: string;

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

@@ -18,6 +18,8 @@ export declare const CONTEXT_TOP_RESULTS = 5;
 export interface ContextSnapshot {
     breakdown: ContextBreakdown;
     estimate: ContextEstimate;
+    /** 首次请求前：系统提示与工具声明按将要发送的那一份估算（与状态栏的启动基线同一口径）。 */
+    prefixPending: boolean;
     window: number | undefined;
     /** 0–100（一位小数，封顶 100）；无窗口时 undefined。 */
     percent: number | undefined;

package/dist/modes/context-report.js

@@ -10,7 +10,7 @@
  * 统计只读：取活动分支的投影（与 `getStats().contextTokens` 同一口径），不改请求体、不写条目。
  */
 import { AgentSessionImpl } from "../agent/session.js";
-import { DEFAULT_COMPACTION_SETTINGS } from "../agent/session-compaction.js";
+import { DEFAULT_COMPACTION_SETTINGS, pendingPrefixMessage } 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";
@@ -28,16 +28,25 @@ export function contextSnapshot(session) {
     let messages = session.messages;
     let estimate;
     let compaction = {};
+    let prefixPending = false;
     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 ?? {});
+        if (!messages.some((message) => "role" in message && message.role === "system")) {
+            prefixPending = true;
+            messages = [pendingPrefixMessage(session), ...messages];
+        }
     }
     else
         estimate = estimateContextTokens(messages);
-    const window = session.getStats().contextWindow;
+    const stats = session.getStats();
+    // 「已用」与状态栏、getStats 同一口径（含启动基线）
+    if (stats.contextTokens !== undefined)
+        estimate = { ...estimate, tokens: stats.contextTokens };
+    const window = stats.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
@@ -46,6 +55,7 @@ export function contextSnapshot(session) {
     return {
         breakdown: breakdownMessages(messages),
         estimate,
+        prefixPending,
         window,
         percent,
         autoCompaction: session.state.autoCompaction,
@@ -69,9 +79,11 @@ function headerRows(snap) {
         });
     rows.push({
         key: m.keySource,
-        value: estimate.lastUsageIndex === null
-            ? m.sourceEstimate
-            : m.sourceUsage(formatTokenCount(estimate.usageTokens), formatTokenCount(estimate.trailingTokens)),
+        value: snap.prefixPending
+            ? m.sourcePrefix
+            : estimate.lastUsageIndex === null
+                ? m.sourceEstimate
+                : m.sourceUsage(formatTokenCount(estimate.usageTokens), formatTokenCount(estimate.trailingTokens)),
     });
     let auto;
     if (!snap.autoCompaction)
@@ -132,7 +144,7 @@ export function describeContext(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}`);
+    lines.push(`  ${snap.prefixPending ? m.prefixEstimated : breakdown.hasSystem ? m.prefixCounted : m.prefixPending}`);
     if (breakdown.total === 0)
         lines.push(`  ${m.empty}`);
     else
@@ -157,7 +169,11 @@ export function contextPanel(session, theme) {
         "",
         theme.bold(m.breakdown(formatTokenCount(breakdown.total))),
         new Indent(new Stack([
-            new Text(theme.fg("dim", breakdown.hasSystem ? m.prefixCounted : m.prefixPending)),
+            new Text(theme.fg("dim", snap.prefixPending
+                ? m.prefixEstimated
+                : breakdown.hasSystem
+                    ? m.prefixCounted
+                    : m.prefixPending)),
             breakdown.total === 0
                 ? theme.fg("dim", m.empty)
                 : table(categoryRows(breakdown, theme), true),

package/docs/en/tui.md

@@ -249,7 +249,7 @@ Design in [rewind-plan.md](../rewind-plan.md) (Chinese). Every user message that
 
 - **Top**: used / window and percentage (the same measure as `/session`: the latest usable usage plus an estimate of the messages after it), tokens left, the source ("reported usage X + estimated Y"; "estimated in full" when there is no usable usage yet, or a compaction / context edit happened after it), the auto-compact trigger (window − `compaction.reserveTokens`; "off" when disabled, "window unknown" without a window) and where tier-one pruning starts.
 - **By category**: system prompt (per section), tool declarations (per tool), user messages, assistant text, reasoning, tool-call arguments (per tool), tool results (summed per tool name), images (1,600 each), summaries (compaction / branch) and custom messages, each with an estimated token count, share and bar. The categories add up to the character-based estimate of the whole projection (one token per CJK character, other characters / 4), so the total in the heading can differ from "Used" at the top, which prefers the usage reported by the model.
-- **System prompt and tool declarations** come from the system messages stored in the session (the first full one and later patches, matching the estimate); before the first request the branch has no system message yet, both categories are 0 and the panel says they are counted after the first request.
+- **System prompt and tool declarations** come from the system messages stored in the session (the first full one and later patches, matching the estimate); before the first request the branch has no system message yet, so both categories are estimated from what the first request will send (the same baseline as the status bar); "Used" matches the status bar and the source reads "system prompt and tools only, estimated before the first request".
 - **Bottom**: only the ordinal (which tool result in the projection), tool name and size of the 5 largest tool results — **never their content**.
 - Read-only: no session entries are written and the request body is untouched, so the prompt-cache prefix is unaffected.
 

package/docs/tui.md

@@ -243,7 +243,7 @@ line 模式（`--no-tui`）运行中输入 `/interrupt <文本>` 效果相同（
 
 - **顶部**：已用 / 窗口与百分比（与 `/session` 同一口径：最后一条可用 usage + 其后消息的估算）、剩余、来源（「usage 实测 X + 估算 Y」；还没有可用 usage，或 usage 之后发生过压缩 / 上下文编辑时为「全量估算」）、自动压缩触发点（窗口 − `compaction.reserveTokens`，关闭时显示「关闭」，没有窗口时「窗口未知」）与档一裁剪的起点。
 - **按类别**：系统提示（按节）、工具声明（按工具）、用户消息、助手文本、推理、工具调用参数（按工具）、工具结果（按工具名汇总）、附件图片（每张按 1 600 计）、摘要（压缩 / 分支）、自定义消息；每类给 token 估算、占比与条形。各类之和等于整个投影的字符估算（CJK 每字 1，其余 / 4），所以标题里的合计可能与顶部的「已用」不同——后者优先采信模型回报的 usage。
-- **系统提示与工具声明**来自会话里存的 system 消息（首条全量、之后的补丁也计入，与估算口径一致）；首次请求前分支上还没有 system 消息，这两类为 0，面板注明「首次请求后才计入」。
+- **系统提示与工具声明**来自会话里存的 system 消息（首条全量、之后的补丁也计入，与估算口径一致）；首次请求前分支上还没有 system 消息，这两类按首次请求将要发送的内容估算（与状态栏的启动基线同一口径），「已用」与状态栏一致，来源标为「首次请求前，只有系统提示与工具声明的估算」。
 - **底部**只列最大的 5 个工具结果的序号（投影里第几个工具结果）、工具名与大小，**不显示正文**。
 - 统计只读：不写会话条目、不改请求体，提示词缓存前缀不受影响。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armadra/agent",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "A coding and coordination agent that runs standalone or embedded in Armadra",
   "type": "module",
   "keywords": [