@openlines/opl-pi-sht 0.2.5 → 0.2.6

package/README.md

@@ -17,7 +17,7 @@ A portable collection of various Pi coding agent extensions. Repository director
 <div align="center">
 
 >
-> ### v0.2.5 (24 Sept 2026) - **Dev dependency floor**: `@earendil-works/pi-coding-agent` is now `^0.87.0` <br/>see [CHANGELOG.md](CHANGELOG.md) for more details.
+> ### v0.2.6 (24 Sept 2026) - **Post-compaction context estimate**: `opl-footer` keeps the context bar visible with explicitly approximate values until Pi reports fresh usage. <br/>see [CHANGELOG.md](CHANGELOG.md) for more details.
 >
 
 </div>

package/extensions/opl-footer/README.md

@@ -75,7 +75,7 @@ See the tracked [`configs/opl-footer.json.sample`](../../configs/opl-footer.json
 | `model` | Model name in pink + `(provider)` in dim | No icon; provider omitted if unavailable |
 | `path` | Current working directory | `segmentOptions.path.mode`: `"full"` (default) · `"abbreviated"` · `"basename"` |
 | `git` | Git branch and dirty indicators | `showBranch`, `showStaged`, `showUnstaged`, `showUntracked` (all bool) |
-| `context_pct` | Gradient bar + `X.X%` + max tokens | Bar fully configurable via `segmentOptions.contextBar` (see below). % and max tokens use `contextLabel` colour. Max tokens formatted with K/M suffix (e.g. `128k`, `2M`). Usage comes from `ctx.getContextUsage()`; when Pi reports it as unknown (right after compaction or a context edit) the segment renders an explicit `(--%)` instead of a stale value. Set `DEBUG_PCT` in `context.ts` to a number (0–100) to pin the bar at a fixed value for visual testing. |
+| `context_pct` | Gradient bar + `X.X%` + max tokens | Bar fully configurable via `segmentOptions.contextBar` (see below). % and max tokens use `contextLabel` colour. Max tokens formatted with K/M suffix (e.g. `128k`, `2M`). Usage comes from `ctx.getContextUsage()`; when Pi reports it as unknown right after compaction, the segment estimates the rebuilt projection with Pi’s `estimateTokens()` and marks the bar and values with `≈` until a fresh assistant response provides exact usage. If no projection is available, it renders `(--%)` rather than a stale value. Set `DEBUG_PCT` in `context.ts` to a number (0–100) to pin the bar at a fixed value for visual testing. |
 | `cost` | `$<amount>` (4 decimals, e.g. `$0.0123`) | `$` dim, amount in `cost` colour (`muted` by default). Four decimals keep cheap local or short sessions distinguishable instead of pinning at `$0.00`. Shows dim `(no pricing)` when the session total is zero on a non-local model (provider has no pricing configured), and `(local model)` for local models |
 | `thinking` | `Thinking: <LEVEL>` | Dim label, CAPS level with per-level colour; always visible |
 | `mode_switcher` | Unified active mode label | Reads state published by `opl-modes`; `appearance.modeColor` controls the mode value, with hardcoded `muted` fallback |

package/extensions/opl-footer/index.ts

@@ -5,6 +5,7 @@ import type { TUI } from "@earendil-works/pi-tui";
 
 import type { SegmentContext, StatusLineSegmentId, UsageStats, SessionStats, SessionEvent, ThinkingLevelEvent, AssistantMessageEvent, ToolResultEvent, UserBashEvent } from "./types.js";
 import { renderSegment } from "./segments/index.js";
+import { estimateContextUsage } from "./segments/context.js";
 import { createAgentStatusTracker } from "./segments/status.js";
 import { getGitStatus, invalidateGitStatus, invalidateGitBranch } from "./git-status.js";
 import { getEffectiveConfig } from "./config.js";
@@ -278,12 +279,16 @@ export default function footer(pi: ExtensionAPI) {
       ? thinkingEvents.reduce((_, e) => e.thinkingLevel ?? "off", "off")
       : null;
 
-    // Prefer Pi's canonical context usage (0.87), which is null when usage is unknown
-    // (e.g. right after compaction, before the next assistant reply) or after a context
-    // edit. Fall back to the model's window when unavailable.
+    // Prefer Pi's canonical context usage (0.87). Immediately after compaction it is
+    // null until the next assistant reply, so estimate the rebuilt projection instead.
     const usage = typeof ctx.getContextUsage === "function" ? ctx.getContextUsage() : undefined;
     const contextWindow = usage?.contextWindow ?? ctx.model?.contextWindow ?? 0;
-    const contextPercent = usage?.percent ?? null;
+    const projectedMessages = ctx.sessionManager?.buildSessionProjection?.().messages;
+    const estimatedContextUsage = usage?.percent === null && contextWindow > 0 && projectedMessages
+      ? estimateContextUsage(projectedMessages, contextWindow)
+      : null;
+    const contextPercent = usage?.percent ?? estimatedContextUsage?.percent ?? null;
+    const contextEstimated = estimatedContextUsage !== null;
 
     // Get git status (cached). Skip the probes entirely when no visible row renders the
     // git segment — otherwise an unused cell keeps spawning git once per second.
@@ -322,6 +327,7 @@ export default function footer(pi: ExtensionAPI) {
       sessionId: ctx.sessionManager?.getSessionId?.(),
       usageStats,
       contextPercent,
+      contextEstimated,
       contextWindow,
       usingSubscription,
       sessionStartTime,

package/extensions/opl-footer/segments/context.ts

@@ -1,3 +1,5 @@
+import { estimateTokens } from "@earendil-works/pi-coding-agent";
+
 import type { RenderedSegment, SegmentContext } from "../types.js";
 import { applyColor, resolveColorToRgb } from "../theme.js";
 import { color } from "./helpers.js";
@@ -19,6 +21,14 @@ export function lerp(a: number, b: number, t: number): number {
   return Math.round(a + (b - a) * t);
 }
 
+export function estimateContextUsage(
+  messages: Parameters<typeof estimateTokens>[0][],
+  contextWindow: number,
+): { tokens: number; percent: number } {
+  const tokens = messages.reduce((total, message) => total + estimateTokens(message), 0);
+  return { tokens, percent: (tokens / contextWindow) * 100 };
+}
+
 function positionColor(
   pos: number,
   barWidth: number,
@@ -75,7 +85,9 @@ export const contextPctSegment = {
 
     // Show: (00.00%) 99999 / 99999
     const used = Math.round((pct / 100) * ctx.contextWindow);
-    const pctLabel = `(${pct.toFixed(2)}%) ${formatTokens(used)} / ${formatTokens(ctx.contextWindow)}`;
+    const pctLabel = ctx.contextEstimated
+      ? `≈${pct.toFixed(2)}%  ≈${formatTokens(used)} / ${formatTokens(ctx.contextWindow)}`
+      : `(${pct.toFixed(2)}%) ${formatTokens(used)} / ${formatTokens(ctx.contextWindow)}`;
     const pctStr = color(ctx, "contextLabel", pctLabel);
 
     return { content: `${bar} ${pctStr}`, visible: true };

package/extensions/opl-footer/types.ts

@@ -119,6 +119,7 @@ export interface SegmentContext {
   sessionId: string | undefined;
   usageStats: UsageStats;
   contextPercent: number | null;
+  contextEstimated: boolean;
   contextWindow: number;
   usingSubscription: boolean;
   sessionStartTime: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlines/opl-pi-sht",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "opl-pi-sht (shouldHaveThat) Pi coding-agent extension kit: token-efficient context, safe modes, fingerprinted /init, model benchmarking, web access, and browser automation.",
   "repository": {
     "type": "git",