pi-editor-footer 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-08-24
+
+### Changed
+
+- Context usage colors now `12.5%`/`25%`/`50%` quotas — `dim` 0-12.5 → `accent` 12.5-25 → `warning` 25-50 → `error` 50-100 via `color-policy:contextUsageColor` (was `25%`/`50%`/`75%`), respects theme semantic tokens
+- Live `↑`/`↓` tokens now per agent run (option B) — cumulative across turns in this agent via `telemetry:peekAgentLive()` + `live-border` top `↑`/`↓` (was per-turn via `getLastTurnTelemetry`), `getLastTelemetry` stays agent sum
+- Stall relocated from bottom telemetry to top right of tool use with `dim |` pipe — `run-activity` now `tools | !2×3.3s` top, bottom `telemetry:formatTurnTelemetry` now `TPS · TTFT` only (suppressed `stalls:false`)
+
 ## [0.5.0] - 2026-08-22
 
 ### Changed

package/dist/color-policy.js

@@ -6,13 +6,21 @@ export function stressColor(value, warn = 70, danger = 90) {
     return "accent";
 }
 export function contextUsageColor(pct) {
-    // 25% 50% 75% thresholds — transit from dimmed (low) to highlight (high)
-    // for intuitive quota status: dim (<25) → accent (25-50) → warning (50-75) → error (≥75)
-    if (pct >= 75)
-        return "error";
+    // 12.5 / 25 / 50 quotas — four urgency tiers, increasingly aggressive as context fills.
+    // 0 – 12.5%  dim      — plenty of headroom, visually quiet.
+    // 12.5 – 25% accent   — first nudge, noticeable but calm.
+    // 25 – 50%   warning  — half consumed, needs attention.
+    // 50 – 100%  error     — critical, about to run out.
+    // Uses theme semantic tokens (dim/accent/warning/error) so the progression
+    // respects the active theme and remains legible on light/dark/custom palettes.
+    // A fixed hex palette (e.g. grey→sky→amber→red) would be more vivid but
+    // would ignore the user's theme and can clash with light backgrounds —
+    // semantic tokens keep the "aggressive" ordering while staying theme-coherent.
     if (pct >= 50)
-        return "warning";
+        return "error";
     if (pct >= 25)
+        return "warning";
+    if (pct >= 12.5)
         return "accent";
     return "dim";
 }

package/dist/live-border.js

@@ -13,7 +13,7 @@
 import { createChromeSnapshot, formatTopContextFromSnapshot, } from "./chrome-state.js";
 import { resolveGlyphs, resolveIconMode } from "./icons.js";
 import { formatRunActivityTopRight } from "./run-activity.js";
-import { formatTelemetryTokens, formatTurnTelemetry } from "./telemetry.js";
+import { formatTelemetryTokens, formatTurnDuration, formatTurnTelemetry, } from "./telemetry.js";
 export const REFRESH_MS = 1000;
 export class LiveBorder {
     deps;
@@ -92,13 +92,33 @@ export class LiveBorder {
     refreshTopBorder() {
         const editor = this.deps.getEditor();
         const ctx = this.deps.getCtx();
+        const cfg = this.deps.getConfig();
         if (!editor || !ctx)
             return;
         try {
-            // SAFETY: theme is live pi TUI theme read at render time
-            const theme = ctx.ui.theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime // SAFETY: pi seam
+            // SAFETY: theme is live pi TUI theme read at render time — intentional unsafe cast, validated at runtime
+            const theme = ctx.ui.theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
             const snap = this.deps.runActivityTracker.getSnapshot();
-            const text = formatRunActivityTopRight(snap, theme);
+            let text = formatRunActivityTopRight(snap, theme);
+            // Relocate stall to the right of tool use with pipe separator — agent-run live (option B), not bottom telemetry
+            if (cfg.telemetry.enabled && cfg.telemetry.stalls) {
+                // SAFETY: pi seam — intentional unsafe cast, validated at runtime — telemetry tracker for stall (agent run, option B)
+                const tracker = this.deps.telemetryTracker;
+                const tel = tracker.peekAgentLive() ?? tracker.getLastTelemetry();
+                if (tel && tel.stallMs > 0) {
+                    const glyphs = resolveGlyphs(cfg.icons.mode);
+                    // SAFETY: pi seam — intentional unsafe cast, validated at runtime — theme fg
+                    const stallText = theme.fg("warning", `${glyphs.stall}${tel.stallCount}×${formatTurnDuration(tel.stallMs).trim()}`);
+                    if (text) {
+                        // SAFETY: pi seam — intentional unsafe cast, validated at runtime — theme fg for pipe
+                        const pipe = theme.fg("dim", " | ");
+                        text = `${text}${pipe}${stallText}`;
+                    }
+                    else {
+                        text = stallText;
+                    }
+                }
+            }
             editor.setTopRightText(text);
         }
         catch {
@@ -122,15 +142,17 @@ export class LiveBorder {
             return;
         }
         try {
-            // SAFETY: peekLive ?? getLastTelemetry preserves cost after toggle (AGENTS.md gotcha)
+            // SAFETY: peekLive ?? getLastTelemetry preserves cost after toggle (AGENTS.md gotcha) — intentional unsafe cast, validated at runtime
             const live = this.deps.telemetryTracker.peekLive() ??
                 this.deps.telemetryTracker.getLastTelemetry();
             if (!live)
                 return;
-            // SAFETY: pi TUI seam read-only - theme from extension context
-            const theme = ctx?.ui?.theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
+            // SAFETY: pi seam — intentional unsafe cast, validated at runtime — theme from extension context
+            const theme = ctx?.ui?.theme;
             const glyphs = resolveGlyphs(cfg.icons.mode);
-            const right = formatTurnTelemetry(live, theme, cfg.telemetry, glyphs);
+            // Stall relocated to top right of tool use with pipe — suppress in bottom telemetry
+            const bottomCfg = { ...cfg.telemetry, stalls: false };
+            const right = formatTurnTelemetry(live, theme, bottomCfg, glyphs);
             if (live.totalMs > 0) {
                 editor.setTelemetryText(right);
                 editor.setBottomLeftText("");
@@ -169,9 +191,10 @@ export class LiveBorder {
             // Tokens line above model info — left aligned, no border; hidden at startup per user request
             let tokensText = "";
             if (cfg.telemetry.enabled && cfg.telemetry.tokens) {
-                // SAFETY: pi TUI seam - telemetry tokens for top tokens line
-                const live = this.deps.telemetryTracker.peekLive() ??
-                    this.deps.telemetryTracker.getLastTelemetry();
+                // Live input/output per agent run (option B) — cumulative across turns in this agent, like live output
+                // SAFETY: pi seam — intentional unsafe cast, validated at runtime — telemetry tracker for top tokens line (agent run)
+                const tracker = this.deps.telemetryTracker;
+                const live = tracker.peekAgentLive() ?? tracker.getLastTelemetry();
                 if (live) {
                     tokensText = formatTelemetryTokens(live, theme, cfg.telemetry, glyphs);
                 }

package/dist/telemetry.js

@@ -50,6 +50,7 @@ export class TurnTelemetryTracker {
     agentStartMs = null;
     agentTurns = [];
     lastTelemetry = null;
+    lastTurnTelemetry = null;
     decayBaseTps = null;
     decayStartMs = null;
     constructor(now = () => performance.now()) {
@@ -58,6 +59,78 @@ export class TurnTelemetryTracker {
     getLastTelemetry() {
         return this.lastTelemetry;
     }
+    getLastTurnTelemetry() {
+        return this.lastTurnTelemetry;
+    }
+    /** Agent-run live: cumulative across turns in current agent, including current live turn. Option B. */
+    peekAgentLive() {
+        // No agent active -> show last agent sum (option B) or current live turn if any
+        if (this.agentStartMs === null) {
+            const live = this.peekLive();
+            if (live)
+                return live;
+            return this.lastTelemetry ?? this.lastTurnTelemetry;
+        }
+        const live = this.peekLive();
+        const hasCompleted = this.agentTurns.length > 0;
+        if (!hasCompleted && !live)
+            return null;
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let totalTokens = 0;
+        let costUsd = 0;
+        let stallMs = 0;
+        let stallCount = 0;
+        let generationMs = 0;
+        let ttftMs = 0;
+        // sum completed turns
+        for (const t of this.agentTurns) {
+            inputTokens += t.inputTokens;
+            outputTokens += t.outputTokens;
+            totalTokens += t.totalTokens;
+            costUsd += t.costUsd;
+            stallMs += t.stallMs;
+            stallCount += t.stallCount;
+            generationMs += t.generationMs;
+        }
+        if (this.agentTurns.length > 0)
+            ttftMs = this.agentTurns[0].ttftMs;
+        if (live) {
+            inputTokens += live.inputTokens;
+            outputTokens += live.outputTokens;
+            totalTokens += live.totalTokens;
+            costUsd += live.costUsd;
+            stallMs += live.stallMs;
+            stallCount += live.stallCount;
+            generationMs += live.generationMs;
+            if (ttftMs === 0)
+                ttftMs = live.ttftMs;
+        }
+        const now = this.now();
+        const totalMs = Math.max(0, now - this.agentStartMs);
+        const measurementMs = outputTokens > 0 && generationMs > 0 ? generationMs : null;
+        const tps = measurementMs === null
+            ? null
+            : round(outputTokens / (measurementMs / 1000), 1);
+        const validCost = Number.isFinite(costUsd) && costUsd > 0;
+        const validTokens = Number.isFinite(totalTokens) && totalTokens > 0;
+        return {
+            tps,
+            ttftMs,
+            totalMs,
+            inputTokens,
+            outputTokens,
+            stallMs,
+            stallCount,
+            rateUsdPerMTokens: validCost && validTokens
+                ? round(costUsd / (totalTokens / 1_000_000), 2)
+                : null,
+            generationMs,
+            totalTokens,
+            costUsd: validCost ? costUsd : 0,
+            measurementMs,
+        };
+    }
     /** Live snapshot while a turn is running — for real-time border refresh. Returns null when idle. */
     peekLive() {
         const turn = this.turn;
@@ -269,8 +342,10 @@ export class TurnTelemetryTracker {
         const telemetry = this.endTurn();
         if (telemetry && this.agentStartMs !== null)
             this.agentTurns.push(telemetry);
-        if (telemetry)
+        if (telemetry) {
+            this.lastTurnTelemetry = telemetry;
             this.lastTelemetry = telemetry;
+        }
         return telemetry;
     }
     endTurn() {
@@ -351,10 +426,11 @@ export class TurnTelemetryTracker {
             measurementMs,
         };
         this.lastTelemetry = result;
+        // keep lastTurnTelemetry as last turn's per-turn telemetry (live input stays per-turn, not agent total)
         return result;
     }
 }
-function formatTurnDuration(ms) {
+export function formatTurnDuration(ms) {
     if (ms < 60_000) {
         // TTFT fixed width: 2-digit integer + one decimal -> padded 4 + "s" =5, then overall duration field padded to 7 for telemetry totalMs
         // For TTFT we want 5, for duration we want 7 — caller will pad accordingly, so here return 5 for <60s case

package/package.json

@@ -18,7 +18,7 @@
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*"
   },
-  "version": "0.5.0",
+  "version": "0.6.0",
   "main": "./dist/index.js",
   "files": [
     "dist",

package/src/color-policy.ts

@@ -8,11 +8,19 @@ export function stressColor(value: number, warn = 70, danger = 90): ThemeColor {
 }
 
 export function contextUsageColor(pct: number): ThemeColor {
-  // 25% 50% 75% thresholds — transit from dimmed (low) to highlight (high)
-  // for intuitive quota status: dim (<25) → accent (25-50) → warning (50-75) → error (≥75)
-  if (pct >= 75) return "error";
-  if (pct >= 50) return "warning";
-  if (pct >= 25) return "accent";
+  // 12.5 / 25 / 50 quotas — four urgency tiers, increasingly aggressive as context fills.
+  // 0 – 12.5%  dim      — plenty of headroom, visually quiet.
+  // 12.5 – 25% accent   — first nudge, noticeable but calm.
+  // 25 – 50%   warning  — half consumed, needs attention.
+  // 50 – 100%  error     — critical, about to run out.
+  // Uses theme semantic tokens (dim/accent/warning/error) so the progression
+  // respects the active theme and remains legible on light/dark/custom palettes.
+  // A fixed hex palette (e.g. grey→sky→amber→red) would be more vivid but
+  // would ignore the user's theme and can clash with light backgrounds —
+  // semantic tokens keep the "aggressive" ordering while staying theme-coherent.
+  if (pct >= 50) return "error";
+  if (pct >= 25) return "warning";
+  if (pct >= 12.5) return "accent";
   return "dim";
 }
 

package/src/live-border.ts

@@ -18,7 +18,11 @@ import {
 import { resolveGlyphs, resolveIconMode } from "./icons.js";
 import { formatRunActivityTopRight } from "./run-activity.js";
 import type { RunActivityTracker } from "./run-activity.js";
-import { formatTelemetryTokens, formatTurnTelemetry } from "./telemetry.js";
+import {
+  formatTelemetryTokens,
+  formatTurnDuration,
+  formatTurnTelemetry,
+} from "./telemetry.js";
 import type { TurnTelemetry } from "./telemetry.js";
 import type { TurnTelemetryTracker } from "./telemetry.js";
 import type { ThemeConfig } from "./config.js";
@@ -113,14 +117,43 @@ export class LiveBorder {
   private refreshTopBorder(): void {
     const editor = this.deps.getEditor();
     const ctx = this.deps.getCtx();
+    const cfg = this.deps.getConfig();
     if (!editor || !ctx) return;
     try {
-      // SAFETY: theme is live pi TUI theme read at render time
+      // SAFETY: theme is live pi TUI theme read at render time — intentional unsafe cast, validated at runtime
       const theme = (
         ctx.ui as unknown as { theme: { fg(s: string, t: string): string } }
-      ).theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime // SAFETY: pi seam
+      ).theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
       const snap = this.deps.runActivityTracker.getSnapshot();
-      const text = formatRunActivityTopRight(snap, theme as never);
+      let text = formatRunActivityTopRight(snap, theme as never);
+      // Relocate stall to the right of tool use with pipe separator — agent-run live (option B), not bottom telemetry
+      if (cfg.telemetry.enabled && cfg.telemetry.stalls) {
+        // SAFETY: pi seam — intentional unsafe cast, validated at runtime — telemetry tracker for stall (agent run, option B)
+        const tracker = this.deps.telemetryTracker as unknown as {
+          peekAgentLive(): import("./telemetry.js").TurnTelemetry | null;
+          getLastTelemetry(): import("./telemetry.js").TurnTelemetry | null;
+        };
+        const tel = tracker.peekAgentLive() ?? tracker.getLastTelemetry();
+        if (tel && tel.stallMs > 0) {
+          const glyphs = resolveGlyphs(cfg.icons.mode);
+          // SAFETY: pi seam — intentional unsafe cast, validated at runtime — theme fg
+          const stallText = (
+            theme as unknown as { fg: (s: string, t: string) => string }
+          ).fg(
+            "warning",
+            `${glyphs.stall}${tel.stallCount}×${formatTurnDuration(tel.stallMs).trim()}`,
+          );
+          if (text) {
+            // SAFETY: pi seam — intentional unsafe cast, validated at runtime — theme fg for pipe
+            const pipe = (
+              theme as unknown as { fg: (s: string, t: string) => string }
+            ).fg("dim", " | ");
+            text = `${text}${pipe}${stallText}`;
+          } else {
+            text = stallText;
+          }
+        }
+      }
       editor.setTopRightText(text);
     } catch {
       // SAFETY: best-effort UI, ignore recoverable error
@@ -142,18 +175,20 @@ export class LiveBorder {
       return;
     }
     try {
-      // SAFETY: peekLive ?? getLastTelemetry preserves cost after toggle (AGENTS.md gotcha)
+      // SAFETY: peekLive ?? getLastTelemetry preserves cost after toggle (AGENTS.md gotcha) — intentional unsafe cast, validated at runtime
       const live =
         this.deps.telemetryTracker.peekLive() ??
         this.deps.telemetryTracker.getLastTelemetry();
       if (!live) return;
-      // SAFETY: pi TUI seam read-only - theme from extension context
-      const theme = (ctx as unknown as { ui?: { theme?: unknown } })?.ui?.theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
+      // SAFETY: pi seam — intentional unsafe cast, validated at runtime — theme from extension context
+      const theme = (ctx as unknown as { ui?: { theme?: unknown } })?.ui?.theme;
       const glyphs = resolveGlyphs(cfg.icons.mode);
+      // Stall relocated to top right of tool use with pipe — suppress in bottom telemetry
+      const bottomCfg = { ...cfg.telemetry, stalls: false };
       const right = formatTurnTelemetry(
         live,
         theme as never,
-        cfg.telemetry,
+        bottomCfg as never,
         glyphs as never,
       );
       if (live.totalMs > 0) {
@@ -202,10 +237,14 @@ export class LiveBorder {
       // Tokens line above model info — left aligned, no border; hidden at startup per user request
       let tokensText = "";
       if (cfg.telemetry.enabled && cfg.telemetry.tokens) {
-        // SAFETY: pi TUI seam - telemetry tokens for top tokens line
-        const live =
-          this.deps.telemetryTracker.peekLive() ??
-          this.deps.telemetryTracker.getLastTelemetry();
+        // Live input/output per agent run (option B) — cumulative across turns in this agent, like live output
+        // SAFETY: pi seam — intentional unsafe cast, validated at runtime — telemetry tracker for top tokens line (agent run)
+        const tracker = this.deps.telemetryTracker as unknown as {
+          // SAFETY: pi seam — intentional unsafe cast, validated at runtime
+          peekAgentLive(): import("./telemetry.js").TurnTelemetry | null;
+          getLastTelemetry(): import("./telemetry.js").TurnTelemetry | null;
+        };
+        const live = tracker.peekAgentLive() ?? tracker.getLastTelemetry();
         if (live) {
           tokensText = formatTelemetryTokens(
             live,

package/src/telemetry.ts

@@ -150,9 +150,9 @@ export class TurnTelemetryTracker {
   private agentStartMs: number | null = null;
   private agentTurns: TurnTelemetry[] = [];
   private lastTelemetry: TurnTelemetry | null = null;
+  private lastTurnTelemetry: TurnTelemetry | null = null;
   private decayBaseTps: number | null = null;
   private decayStartMs: number | null = null;
-
   constructor(now: () => number = () => performance.now()) {
     this.now = now;
   }
@@ -160,6 +160,79 @@ export class TurnTelemetryTracker {
   getLastTelemetry(): TurnTelemetry | null {
     return this.lastTelemetry;
   }
+
+  getLastTurnTelemetry(): TurnTelemetry | null {
+    return this.lastTurnTelemetry;
+  }
+
+  /** Agent-run live: cumulative across turns in current agent, including current live turn. Option B. */
+  peekAgentLive(): TurnTelemetry | null {
+    // No agent active -> show last agent sum (option B) or current live turn if any
+    if (this.agentStartMs === null) {
+      const live = this.peekLive();
+      if (live) return live;
+      return this.lastTelemetry ?? this.lastTurnTelemetry;
+    }
+    const live = this.peekLive();
+    const hasCompleted = this.agentTurns.length > 0;
+    if (!hasCompleted && !live) return null;
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let totalTokens = 0;
+    let costUsd = 0;
+    let stallMs = 0;
+    let stallCount = 0;
+    let generationMs = 0;
+    let ttftMs = 0;
+    // sum completed turns
+    for (const t of this.agentTurns) {
+      inputTokens += t.inputTokens;
+      outputTokens += t.outputTokens;
+      totalTokens += t.totalTokens;
+      costUsd += t.costUsd;
+      stallMs += t.stallMs;
+      stallCount += t.stallCount;
+      generationMs += t.generationMs;
+    }
+    if (this.agentTurns.length > 0) ttftMs = this.agentTurns[0]!.ttftMs;
+    if (live) {
+      inputTokens += live.inputTokens;
+      outputTokens += live.outputTokens;
+      totalTokens += live.totalTokens;
+      costUsd += live.costUsd;
+      stallMs += live.stallMs;
+      stallCount += live.stallCount;
+      generationMs += live.generationMs;
+      if (ttftMs === 0) ttftMs = live.ttftMs;
+    }
+    const now = this.now();
+    const totalMs = Math.max(0, now - this.agentStartMs);
+    const measurementMs =
+      outputTokens > 0 && generationMs > 0 ? generationMs : null;
+    const tps =
+      measurementMs === null
+        ? null
+        : round(outputTokens / (measurementMs / 1000), 1);
+    const validCost = Number.isFinite(costUsd) && costUsd > 0;
+    const validTokens = Number.isFinite(totalTokens) && totalTokens > 0;
+    return {
+      tps,
+      ttftMs,
+      totalMs,
+      inputTokens,
+      outputTokens,
+      stallMs,
+      stallCount,
+      rateUsdPerMTokens:
+        validCost && validTokens
+          ? round(costUsd / (totalTokens / 1_000_000), 2)
+          : null,
+      generationMs,
+      totalTokens,
+      costUsd: validCost ? costUsd : 0,
+      measurementMs,
+    };
+  }
   /** Live snapshot while a turn is running — for real-time border refresh. Returns null when idle. */
   peekLive(): TurnTelemetry | null {
     const turn = this.turn;
@@ -386,7 +459,10 @@ export class TurnTelemetryTracker {
     const telemetry = this.endTurn();
     if (telemetry && this.agentStartMs !== null)
       this.agentTurns.push(telemetry);
-    if (telemetry) this.lastTelemetry = telemetry;
+    if (telemetry) {
+      this.lastTurnTelemetry = telemetry;
+      this.lastTelemetry = telemetry;
+    }
     return telemetry;
   }
 
@@ -478,11 +554,12 @@ export class TurnTelemetryTracker {
       measurementMs,
     };
     this.lastTelemetry = result;
+    // keep lastTurnTelemetry as last turn's per-turn telemetry (live input stays per-turn, not agent total)
     return result;
   }
 }
 
-function formatTurnDuration(ms: number): string {
+export function formatTurnDuration(ms: number): string {
   if (ms < 60_000) {
     // TTFT fixed width: 2-digit integer + one decimal -> padded 4 + "s" =5, then overall duration field padded to 7 for telemetry totalMs
     // For TTFT we want 5, for duration we want 7 — caller will pad accordingly, so here return 5 for <60s case