@gajae-code/coding-agent 0.10.0 → 0.10.1

package/src/slash-commands/helpers/context-report.ts

@@ -83,6 +83,12 @@ function formatReserveText(runtime: SlashCommandRuntime, contextWindow: number,
 	return "unknown";
 }
 
+function contextUsageSourceLabel(source: "provider_anchor" | "heuristic" | "unknown"): string {
+	if (source === "provider_anchor") return "provider-reported";
+	if (source === "unknown") return "estimated; exact count unknown until next response";
+	return "estimated";
+}
+
 /**
  * Build the `/context` ACP-mode text. Tries the rich breakdown first
  * (categories + auto-compact buffer + free slack) and falls back to the
@@ -96,11 +102,21 @@ export function buildContextReportText(runtime: SlashCommandRuntime): string {
 			return "Context usage is unavailable: no model is selected for this session.";
 		}
 		const promptUsage = findLastAssistantUsage(history.activeMessages);
-		const usedPct = (breakdown.usedTokens / breakdown.contextWindow) * 100;
+		const activeContext =
+			breakdown.usedTokens === null
+				? `Active context: unknown / ${breakdown.contextWindow.toLocaleString()} tokens (exact count unknown until next response) (${contextUsageSourceLabel(breakdown.source)})`
+				: `Active context: ${breakdown.usedTokens.toLocaleString()} / ${breakdown.contextWindow.toLocaleString()} tokens (${((breakdown.usedTokens / breakdown.contextWindow) * 100).toFixed(1)}% used) (${contextUsageSourceLabel(breakdown.source)})`;
 		const lines = [
 			"Context usage",
 			`Model: ${breakdown.model?.provider ?? "unknown"}/${breakdown.model?.id ?? "unknown"}`,
-			`Active context: ${breakdown.usedTokens.toLocaleString()} / ${breakdown.contextWindow.toLocaleString()} tokens (${usedPct.toFixed(1)}% used)`,
+			activeContext,
+			...(breakdown.source !== "unknown" &&
+			breakdown.usedTokens !== null &&
+			breakdown.estimatedCategoryTotal !== breakdown.usedTokens
+				? [
+						`Estimated category total: ${breakdown.estimatedCategoryTotal.toLocaleString()} tokens (composition below is estimated)`,
+					]
+				: []),
 			`Reserve: ${formatReserveText(runtime, breakdown.contextWindow, breakdown.autoCompactBufferTokens)}`,
 			"",
 			"Active context breakdown (estimated)",
@@ -111,7 +127,13 @@ export function buildContextReportText(runtime: SlashCommandRuntime): string {
 		if (breakdown.autoCompactBufferTokens > 0) {
 			lines.push(formatTokenLine("Reserve", breakdown.autoCompactBufferTokens, breakdown.contextWindow));
 		}
-		lines.push(formatTokenLine("Free", breakdown.freeTokens, breakdown.contextWindow));
+		lines.push(
+			formatTokenLine(
+				breakdown.usedTokens === null ? "Free (estimated)" : "Free",
+				breakdown.freeTokens,
+				breakdown.contextWindow,
+			),
+		);
 		lines.push(
 			"",
 			"History",
@@ -141,7 +163,7 @@ export function buildContextReportText(runtime: SlashCommandRuntime): string {
 		if (!fallback) return "Context usage is unavailable.";
 		return [
 			"Context usage",
-			`Active context: ${fallback.tokens === null || fallback.tokens === undefined ? "unknown" : fallback.tokens.toLocaleString()}`,
+			`Active context: ${fallback.tokens === null ? "unknown" : fallback.tokens.toLocaleString()} (${contextUsageSourceLabel(fallback.source)})`,
 			`Context window: ${fallback.contextWindow.toLocaleString()}`,
 			"Breakdown: unknown",
 		].join("\n");