pi-editor-footer 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-08-22
+
+### Changed
+
+- Remove duration section positioned to the right of `TTFT` in bottom telemetry (`telemetry:formatTurnTelemetry` now `TPS · TTFT` only, `duration` config ignored)
+- Use `<number> turns` to replace `T<number>` in top run-activity (`run-activity:formatRunActivityTopRight` now `1 turns` / `N turns` instead of `T1`/`T N`)
+- Exchange positions of cache rate section (`c %`) and context bar section (`pct · tokens/window` + bar) in top border — now `c % | pct · tokens/window` instead of `pct · tokens/window | c %` (`chrome-state:formatContextBar`)
+
+### Fixed
+
+- Clamp live TPS window and throttle `LiveBorder` for multi-turn runs
+- Add inline `SAFETY` for live-border casts (pi-lens)
+
 ## [0.4.0] - 2026-08-22
 
 ### Added

package/dist/chrome-state.js

@@ -49,7 +49,7 @@ export function formatContextBar(contextUsage, theme, glyphs, isAscii, barWidth
         ? cacheHitRate
         : 0;
     const cacheText = `${glyphs.cacheHit} ${rate.toFixed(1)}%`;
-    return `${base} ${theme.fg("dim", "|")} ${theme.fg(cacheHitColor(rate), cacheText)}`;
+    return `${theme.fg(cacheHitColor(rate), cacheText)} ${theme.fg("dim", "|")} ${base}`;
 }
 /** Border adapter helper — one call from snapshot + theme/glyphs. */
 export function formatTopContextFromSnapshot(snapshot, theme, glyphs, isAscii, showIconBar = false) {
@@ -65,7 +65,7 @@ export function formatTopContextFromSnapshot(snapshot, theme, glyphs, isAscii, s
  */
 export function createChromeSnapshot(ctx, footerState) {
     const cwd = ctx?.sessionManager?.getCwd?.() ??
-        // SAFETY: pi seam
+        // SAFETY: pi seam — intentional unsafe cast, validated at runtime
         ctx?.cwd ?? // SAFETY: pi seam — intentional unsafe cast, validated at runtime
         process.cwd();
     const sessionName = ctx?.sessionManager?.getSessionName?.();

package/dist/live-border.js

@@ -18,11 +18,33 @@ export const REFRESH_MS = 1000;
 export class LiveBorder {
     deps;
     timer = null;
+    lastRenderMs = 0;
+    pendingRender = null;
     constructor(deps) {
         this.deps = deps;
     }
     /** Coalesced render: top (run-activity) + bottom (telemetry) + context bar → editor. */
     render() {
+        const now = Date.now();
+        if (now - this.lastRenderMs < REFRESH_MS) {
+            if (this.pendingRender === null) {
+                const delay = REFRESH_MS - (now - this.lastRenderMs);
+                this.pendingRender = setTimeout(() => {
+                    this.pendingRender = null;
+                    this.lastRenderMs = Date.now();
+                    this.doRender();
+                }, delay);
+                // SAFETY: pi TUI seam - timer unref is optional NodeJS API
+                const t = this.pendingRender; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
+                if (typeof t.unref === "function")
+                    t.unref();
+            }
+            return;
+        }
+        this.lastRenderMs = now;
+        this.doRender();
+    }
+    doRender() {
         this.refreshTopBorder();
         this.refreshLiveTelemetry();
         this.refreshContextBar();
@@ -37,9 +59,7 @@ export class LiveBorder {
         this.timer = setInterval(() => {
             try {
                 if (this.deps.runActivityTracker.isRunning()) {
-                    this.refreshTopBorder();
-                    this.refreshLiveTelemetry();
-                    this.refreshContextBar();
+                    this.render();
                 }
                 else {
                     this.refreshContextBar();
@@ -51,11 +71,15 @@ export class LiveBorder {
         }, REFRESH_MS);
         // don't block process exit
         // SAFETY: pi TUI seam - timer unref is optional NodeJS API
-        const t = this.timer;
+        const t = this.timer; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
         if (typeof t.unref === "function")
             t.unref();
     }
     stopTick() {
+        if (this.pendingRender !== null) {
+            clearTimeout(this.pendingRender);
+            this.pendingRender = null;
+        }
         if (this.timer !== null) {
             clearInterval(this.timer);
             this.timer = null;
@@ -72,7 +96,7 @@ export class LiveBorder {
             return;
         try {
             // SAFETY: theme is live pi TUI theme read at render time
-            const theme = ctx.ui.theme; // SAFETY: pi seam
+            const theme = ctx.ui.theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime // SAFETY: pi seam
             const snap = this.deps.runActivityTracker.getSnapshot();
             const text = formatRunActivityTopRight(snap, theme);
             editor.setTopRightText(text);
@@ -104,7 +128,7 @@ export class LiveBorder {
             if (!live)
                 return;
             // SAFETY: pi TUI seam read-only - theme from extension context
-            const theme = ctx?.ui?.theme;
+            const theme = ctx?.ui?.theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
             const glyphs = resolveGlyphs(cfg.icons.mode);
             const right = formatTurnTelemetry(live, theme, cfg.telemetry, glyphs);
             if (live.totalMs > 0) {
@@ -126,10 +150,11 @@ export class LiveBorder {
             // Deepened via ChromeState: snapshot owns contextUsage + totals derivation behind one seam.
             // Two adapters (footer + border) now share the same snapshot — proves the seam.
             // SAFETY: pi seam - snapshot derivation from extension context
-            const snapshot = createChromeSnapshot(ctx, undefined);
+            const snapshot = createChromeSnapshot(ctx, // SAFETY: pi seam — intentional unsafe cast, validated at runtime
+            undefined);
             // SAFETY: pi seam - theme from extension context
-            const theme = ctx.ui
-                .theme;
+            const theme = ctx.ui // SAFETY: pi seam — intentional unsafe cast, validated at runtime
+                .theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
             const glyphs = resolveGlyphs(cfg.icons.mode);
             const isAscii = resolveIconMode(cfg.icons.mode) === "ascii";
             let contextText = "";
@@ -138,7 +163,7 @@ export class LiveBorder {
                 snapshot.contextUsage.contextWindow) {
                 contextText = formatTopContextFromSnapshot(snapshot, theme, glyphs, isAscii, 
                 // SAFETY: intentional unsafe cast — validated at runtime
-                cfg.contextIconBar ??
+                cfg.contextIconBar ?? // SAFETY: pi seam — intentional unsafe cast, validated at runtime
                     false);
             }
             // Tokens line above model info — left aligned, no border; hidden at startup per user request

package/dist/run-activity.js

@@ -142,10 +142,10 @@ export function formatRunActivityTopRight(snap, theme, now) {
     const parts = [];
     // turn
     if (snap.turnNumber !== undefined) {
-        parts.push(theme.fg("accent", `T${snap.turnNumber}`));
+        parts.push(theme.fg("accent", `${snap.turnNumber} turns`));
     }
     else if (snap.phase === "running") {
-        parts.push(theme.fg("accent", `T1`));
+        parts.push(theme.fg("accent", `1 turns`));
     }
     // duration
     const dur = snap.durationMs ??

package/dist/telemetry.js

@@ -125,7 +125,8 @@ export class TurnTelemetryTracker {
             outputTokens = turn.liveEstimatedTokens;
             totalTokens = Math.max(totalTokens, inputTokens + outputTokens);
         }
-        const measurementMs = genMs > 0 && outputTokens > 0 ? genMs : null;
+        // Require minimum window to avoid spike on tiny genMs (multi-turn fast second turn)
+        const measurementMs = genMs >= 500 && outputTokens > 0 ? genMs : null;
         const tps = measurementMs === null
             ? null
             : round(outputTokens / (measurementMs / 1000), 1);
@@ -382,12 +383,6 @@ export function formatTurnTelemetry(telemetry, theme, config, glyphs) {
         const padded = sec.padStart(4, " ");
         parts.push(theme.fg("text", `${padded}s TTFT`));
     }
-    if (config.duration) {
-        // duration fixed width 7 (e.g. " 15m 31s" / " 24h 21m" / "   5.0s")
-        const raw = formatTurnDuration(telemetry.totalMs);
-        const padded = raw.padStart(7, " ");
-        parts.push(theme.fg("success", `${padded}`));
-    }
     if (config.stalls && telemetry.stallMs > 0) {
         parts.push(theme.fg("warning", `${g.stall}${telemetry.stallCount}×${formatTurnDuration(telemetry.stallMs).trim()}`));
     }

package/package.json

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

package/src/chrome-state.ts

@@ -91,7 +91,7 @@ export function formatContextBar(
       ? cacheHitRate
       : 0;
   const cacheText = `${glyphs.cacheHit} ${rate.toFixed(1)}%`;
-  return `${base} ${theme.fg("dim", "|")} ${theme.fg(cacheHitColor(rate), cacheText)}`;
+  return `${theme.fg(cacheHitColor(rate), cacheText)} ${theme.fg("dim", "|")} ${base}`;
 }
 
 /** Border adapter helper — one call from snapshot + theme/glyphs. */
@@ -139,7 +139,7 @@ export function createChromeSnapshot(
 ): ChromeSnapshot {
   const cwd =
     ctx?.sessionManager?.getCwd?.() ??
-    // SAFETY: pi seam
+    // SAFETY: pi seam — intentional unsafe cast, validated at runtime
     (ctx as unknown as { cwd?: string })?.cwd ?? // SAFETY: pi seam — intentional unsafe cast, validated at runtime
     process.cwd();
   const sessionName = ctx?.sessionManager?.getSessionName?.();

package/src/live-border.ts

@@ -37,11 +37,33 @@ export interface LiveBorderDeps {
 
 export class LiveBorder {
   private timer: ReturnType<typeof setInterval> | null = null;
+  private lastRenderMs = 0;
+  private pendingRender: ReturnType<typeof setTimeout> | null = null;
 
   constructor(private readonly deps: LiveBorderDeps) {}
 
   /** Coalesced render: top (run-activity) + bottom (telemetry) + context bar → editor. */
   render(): void {
+    const now = Date.now();
+    if (now - this.lastRenderMs < REFRESH_MS) {
+      if (this.pendingRender === null) {
+        const delay = REFRESH_MS - (now - this.lastRenderMs);
+        this.pendingRender = setTimeout(() => {
+          this.pendingRender = null;
+          this.lastRenderMs = Date.now();
+          this.doRender();
+        }, delay);
+        // SAFETY: pi TUI seam - timer unref is optional NodeJS API
+        const t = this.pendingRender as unknown as { unref?: () => void }; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
+        if (typeof t.unref === "function") t.unref();
+      }
+      return;
+    }
+    this.lastRenderMs = now;
+    this.doRender();
+  }
+
+  private doRender(): void {
     this.refreshTopBorder();
     this.refreshLiveTelemetry();
     this.refreshContextBar();
@@ -57,9 +79,7 @@ export class LiveBorder {
     this.timer = setInterval(() => {
       try {
         if (this.deps.runActivityTracker.isRunning()) {
-          this.refreshTopBorder();
-          this.refreshLiveTelemetry();
-          this.refreshContextBar();
+          this.render();
         } else {
           this.refreshContextBar();
         }
@@ -69,11 +89,15 @@ export class LiveBorder {
     }, REFRESH_MS);
     // don't block process exit
     // SAFETY: pi TUI seam - timer unref is optional NodeJS API
-    const t = this.timer as unknown as { unref?: () => void };
+    const t = this.timer as unknown as { unref?: () => void }; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
     if (typeof t.unref === "function") t.unref();
   }
 
   stopTick(): void {
+    if (this.pendingRender !== null) {
+      clearTimeout(this.pendingRender);
+      this.pendingRender = null;
+    }
     if (this.timer !== null) {
       clearInterval(this.timer);
       this.timer = null;
@@ -94,7 +118,7 @@ export class LiveBorder {
       // SAFETY: theme is live pi TUI theme read at render time
       const theme = (
         ctx.ui as unknown as { theme: { fg(s: string, t: string): string } }
-      ).theme; // SAFETY: pi seam
+      ).theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime // SAFETY: pi seam
       const snap = this.deps.runActivityTracker.getSnapshot();
       const text = formatRunActivityTopRight(snap, theme as never);
       editor.setTopRightText(text);
@@ -124,7 +148,7 @@ export class LiveBorder {
         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;
+      const theme = (ctx as unknown as { ui?: { theme?: unknown } })?.ui?.theme; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
       const glyphs = resolveGlyphs(cfg.icons.mode);
       const right = formatTurnTelemetry(
         live,
@@ -151,12 +175,12 @@ export class LiveBorder {
       // Two adapters (footer + border) now share the same snapshot — proves the seam.
       // SAFETY: pi seam - snapshot derivation from extension context
       const snapshot = createChromeSnapshot(
-        ctx as unknown as Parameters<typeof createChromeSnapshot>[0],
+        ctx as unknown as Parameters<typeof createChromeSnapshot>[0], // SAFETY: pi seam — intentional unsafe cast, validated at runtime
         undefined,
       );
       // SAFETY: pi seam - theme from extension context
-      const theme = (ctx as unknown as { ui: { theme: unknown } }).ui
-        .theme as unknown as never;
+      const theme = (ctx as unknown as { ui: { theme: unknown } }).ui // SAFETY: pi seam — intentional unsafe cast, validated at runtime
+        .theme as unknown as never; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
       const glyphs = resolveGlyphs(cfg.icons.mode);
       const isAscii = resolveIconMode(cfg.icons.mode) === "ascii";
       let contextText = "";
@@ -171,7 +195,7 @@ export class LiveBorder {
           glyphs,
           isAscii,
           // SAFETY: intentional unsafe cast — validated at runtime
-          (cfg as unknown as { contextIconBar?: boolean }).contextIconBar ??
+          (cfg as unknown as { contextIconBar?: boolean }).contextIconBar ?? // SAFETY: pi seam — intentional unsafe cast, validated at runtime
             false,
         );
       }

package/src/run-activity.ts

@@ -186,9 +186,9 @@ export function formatRunActivityTopRight(
 
   // turn
   if (snap.turnNumber !== undefined) {
-    parts.push(theme.fg("accent", `T${snap.turnNumber}`));
+    parts.push(theme.fg("accent", `${snap.turnNumber} turns`));
   } else if (snap.phase === "running") {
-    parts.push(theme.fg("accent", `T1`));
+    parts.push(theme.fg("accent", `1 turns`));
   }
 
   // duration

package/src/telemetry.ts

@@ -176,7 +176,8 @@ export class TurnTelemetryTracker {
           decayedTps = null;
         } else {
           // exponential decay, half-life ~5s (exp(-elapsed/7200) => half at ~5s ln2*7200≈5000)
-          const decayed = this.decayBaseTps * Math.exp(-elapsedSinceDecay / 7200);
+          const decayed =
+            this.decayBaseTps * Math.exp(-elapsedSinceDecay / 7200);
           if (decayed >= 0.05) decayedTps = round(decayed, 1);
         }
       }
@@ -225,7 +226,8 @@ export class TurnTelemetryTracker {
       outputTokens = turn.liveEstimatedTokens;
       totalTokens = Math.max(totalTokens, inputTokens + outputTokens);
     }
-    const measurementMs = genMs > 0 && outputTokens > 0 ? genMs : null;
+    // Require minimum window to avoid spike on tiny genMs (multi-turn fast second turn)
+    const measurementMs = genMs >= 500 && outputTokens > 0 ? genMs : null;
     const tps =
       measurementMs === null
         ? null
@@ -533,12 +535,6 @@ export function formatTurnTelemetry(
     const padded = sec.padStart(4, " ");
     parts.push(theme.fg("text", `${padded}s TTFT`));
   }
-  if (config.duration) {
-    // duration fixed width 7 (e.g. " 15m 31s" / " 24h 21m" / "   5.0s")
-    const raw = formatTurnDuration(telemetry.totalMs);
-    const padded = raw.padStart(7, " ");
-    parts.push(theme.fg("success", `${padded}`));
-  }
   if (config.stalls && telemetry.stallMs > 0) {
     parts.push(
       theme.fg(