@pi-unipi/footer 3.0.0-alpha.3 → 3.0.0-alpha.5

package/README.md

@@ -37,7 +37,7 @@ Footer subscribes to events from every Unipi package:
 | Group | Events | Segments |
 |-------|--------|----------|
 | core | Pi SDK | model, thinking, path, git, context_pct, cost, tokens, session |
-| compactor | Pi session data + `COMPACTOR_COMPACTED` | session_events, compactions, tokens_saved, compression_ratio |
+| compactor | Pi session data | compactions — `cmp 4× 39k→13k · 3m` (count, tokens before → after, time since the last; hidden until the first) |
 | memory | `MEMORY_STORED`/`DELETED`/`CONSOLIDATED` | project_count, total_count, consolidations |
 | mcp | `MCP_SERVER_STARTED`/`STOPPED`/`ERROR` | servers_total, servers_active, tools_total |
 | ralph | `RALPH_LOOP_START`/`END`/`ITERATION_DONE` | active_loops, total_iterations, loop_status |
@@ -90,9 +90,7 @@ Settings in `~/.pi/agent/settings.json` under `unipi.footer`:
         "compactor": {
           "show": true,
           "segments": {
-            "session_events": true,
-            "compactions": true,
-            "tokens_saved": true
+            "compactions": true
           }
         }
       }
@@ -137,11 +135,11 @@ When `iconStyle` is not set, footer auto-detects Nerd Font support and defaults
 
 ```
 Wide terminal (>120 cols):
-  model | thinking | path | git | context | cost | compactions | tokens_saved | project_count
+  model | thinking | path | git | context | compactions | cost | project_count
 
 Narrow terminal (<120 cols):
   Row 1: model | thinking | path | git | context | cost
-  Row 2: compactions | tokens_saved | project_count | ralph | workflow
+  Row 2: compactions | project_count | ralph | workflow
 ```
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "3.0.0-alpha.3",
+  "version": "3.0.0-alpha.5",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.3",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.3"
+    "@pi-unipi/core": "3.0.0-alpha.5",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.5"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/src/help.ts

@@ -75,7 +75,7 @@ function buildHelpLines(
 export function getGroupForSegment(segId: string): string {
   const coreIds = ["model", "api_state", "tool_count", "git", "context_pct", "cost", "tokens_total", "tokens_in", "tokens_out", "session", "hostname", "time", "tps", "clock", "duration", "thinking_level", "uni", "directory"];
   if (coreIds.includes(segId)) return "core";
-  const compactorIds = ["session_events", "compactions", "tokens_saved", "compression_ratio", "sandbox_runs", "search_queries"];
+  const compactorIds = ["compactions"];
   if (compactorIds.includes(segId)) return "compactor";
   if (["project_count", "total_count", "consolidations"].includes(segId)) return "memory";
   if (["servers_total", "servers_active", "tools_total", "servers_failed"].includes(segId)) return "mcp";

package/src/index.ts

@@ -18,7 +18,7 @@ import { GlanceEditor } from "./glance-editor.js";
 
 // Import segment groups
 import { CORE_SEGMENTS } from "./segments/core.js";
-import { COMPACTOR_SEGMENTS } from "./segments/compactor.js";
+import { COMPACTOR_SEGMENTS, compactionSummary } from "./segments/compactor.js";
 import { MEMORY_SEGMENTS } from "./segments/memory.js";
 import { MCP_SEGMENTS } from "./segments/mcp.js";
 import { RALPH_SEGMENTS } from "./segments/ralph.js";
@@ -546,14 +546,30 @@ const STRIP_COLOR = {
 	psMid: "\x1b[97m", // white — in between
 	cacheHit: "\x1b[92m", // green — high hit
 	cacheWarn: "\x1b[93m", // amber — lowish hit
+	compact: "\x1b[94m", // blue — compactions
 	reset: "\x1b[39m",
 } as const;
 
 const c = (code: string, text: string) => `${code}${text}${STRIP_COLOR.reset}`;
 
+function fmtTokensShort(n: number): string {
+  if (n < 1000) return String(n);
+  if (n < 10000) return `${(n / 1000).toFixed(1)}k`;
+  if (n < 1000000) return `${Math.round(n / 1000)}k`;
+  return `${(n / 1000000).toFixed(1)}M`;
+}
+
+function agoShort(ms: number): string {
+  const sec = Math.max(0, Math.round(ms / 1000));
+  if (sec < 60) return "just now";
+  if (sec < 3600) return `${Math.round(sec / 60)}m ago`;
+  if (sec < 86400) return `${Math.round(sec / 3600)}h ago`;
+  return `${Math.round(sec / 86400)}d ago`;
+}
+
 /**
  * Glance-style centered stats strip under the input:
- *   n Turn · n Steps | wall · tool wall | avg TTFT · n tok/s | cache n%
+ *   n Turn · n Steps | wall · tool wall | avg TTFT · n tok/s | n compactions · 39k→13k · 3m ago | cache n%
  */
 function renderSessionStrip(piContext: unknown): string | null {
   const parts: string[] = [];
@@ -588,6 +604,21 @@ function renderSessionStrip(piContext: unknown): string | null {
     if (seg) parts.push(seg);
   }
 
+  // Compactions: hidden until the first one.
+  const branch = (() => {
+    try {
+      return ((piContext as any)?.sessionManager?.getBranch?.() ?? []) as unknown[];
+    } catch {
+      return [];
+    }
+  })();
+  const cmp = compactionSummary(branch);
+  if (cmp.count > 0) {
+    const sizes = cmp.before > 0 ? ` \u00b7 ${c(STRIP_COLOR.compact, `${fmtTokensShort(cmp.before)}\u2192${fmtTokensShort(cmp.after)}`)}` : "";
+    const age = cmp.lastAt != null ? ` \u00b7 ${agoShort(Date.now() - cmp.lastAt)}` : "";
+    parts.push(`${c(STRIP_COLOR.compact, String(cmp.count))} compaction${cmp.count === 1 ? "" : "s"}${sizes}${age}`);
+  }
+
   const hit = cacheHitPct(piContext);
   if (hit !== null) {
     const hitColor = hit >= 70 ? STRIP_COLOR.cacheHit : STRIP_COLOR.cacheWarn;

package/src/presets.ts

@@ -18,7 +18,7 @@ const DEFAULT_PRESET: PresetDef = {
     "uni", "lh_mode", "model", "thinking_level", "directory", "git",
   ],
   rightSegments: [
-    "context_pct", "tokens_total",
+    "context_pct", "compactions", "tokens_total",
     "tps", "cost",
     "clock", "duration",
   ],
@@ -33,7 +33,7 @@ const CLASSIC_PRESET: PresetDef = {
   ],
   rightSegments: [
     "tps", "context_pct", "cost",
-    "compactions", "tokens_saved", "project_count",
+    "compactions", "project_count",
     "current_command", "loop_status", "extension_statuses",
     "clock", "duration",
   ],
@@ -76,7 +76,7 @@ const FULL_PRESET: PresetDef = {
   ],
   rightSegments: [
     "tps", "context_pct", "cost", "tokens_total",
-    "session_events", "compactions", "tokens_saved",
+    "compactions",
     "project_count", "total_count",
     "servers_total", "servers_active", "tools_total",
     "active_loops", "loop_status",
@@ -87,7 +87,6 @@ const FULL_PRESET: PresetDef = {
   secondarySegments: [
     "hostname",
     "tokens_in", "tokens_out",
-    "compression_ratio",
     "platforms_enabled", "last_sent",
     "thinking_level",
   ],

package/src/rendering/icons.ts

@@ -35,13 +35,8 @@ export interface IconSet {
   directory: string;
 
   // Compactor segments
-  sessionEvents: string;
-  compactions: string;
-  tokensSaved: string;
-  compressionRatio: string;
   indexedDocs: string;
   sandboxRuns: string;
-  searchQueries: string;
 
   // Memory segments
   projectCount: string;
@@ -106,13 +101,8 @@ export const NERD_ICONS: IconSet = {
   thinkingLevel:   "\uF400", // 
 
   // Compactor
-  sessionEvents:   "\uEA86", // 
-  compactions:     "\u{F0C8F}", // 󰲏
-  tokensSaved:     "\uF155", //  (kept — missing from customization)
-  compressionRatio:"\u{F0C8F}", // 󰲏
   indexedDocs:     "\u{F0219}", // 󰈙
   sandboxRuns:     "\uF233", // 
-  searchQueries:   "\uF002", // 
 
   // Memory
   projectCount:    "\uEE9C", // 
@@ -177,13 +167,8 @@ export const EMOJI_ICONS: IconSet = {
   directory:       "📁",
 
   // Compactor
-  sessionEvents:   "📈",
-  compactions:     "🗜️",
-  tokensSaved:     "💲",
-  compressionRatio:"📐",
   indexedDocs:     "📑",
   sandboxRuns:     "▶️",
-  searchQueries:   "🔍",
 
   // Memory
   projectCount:    "🧠",
@@ -248,13 +233,8 @@ export const TEXT_ICONS: IconSet = {
   directory:       "DIR",
 
   // Compactor
-  sessionEvents:   "EVT",
-  compactions:     "CMP",
-  tokensSaved:     "SVD",
-  compressionRatio:"RAT",
   indexedDocs:     "IDX",
   sandboxRuns:     "SBX",
-  searchQueries:   "QRY",
 
   // Memory
   projectCount:    "MEM",

package/src/segments/compactor.ts

@@ -1,23 +1,16 @@
 /**
- * @pi-unipi/footer — Compactor segments
+ * @pi-unipi/footer — Compactor segment
  *
- * Segment renderers for the compactor group: session_events, compactions,
- * tokens_saved, compression_ratio, sandbox_runs, search_queries.
+ * One dense, icon-free segment, shown once the session has compacted:
  *
- * Data sourced from piContext.sessionManager (live session data).
- * Segments without a reliable data source are hidden (visible: false)
- * rather than showing a placeholder like "—".
+ *   cmp 4× 39k→13k · 3m
+ *
+ * count, tokens before → after across all compactions, time since the last.
+ * Read from the session branch (Pi's compaction entries).
  */
 
 import type { FooterSegment, FooterSegmentContext, RenderedSegment } from "../types.js";
-import { applyColor, mutedPlaceholder } from "../rendering/theme.js";
-import { getIcon } from "../rendering/icons.js";
-import { isSegmentEnabled } from "../config.js";
-
-function withIcon(segmentId: string, text: string): string {
-  const icon = getIcon(segmentId);
-  return icon ? `${icon} ${text}` : text;
-}
+import { applyColor } from "../rendering/theme.js";
 
 function formatTokens(n: number): string {
   if (n < 1000) return n.toString();
@@ -26,149 +19,66 @@ function formatTokens(n: number): string {
   return `${(n / 1000000).toFixed(1)}M`;
 }
 
-/** Hidden segment — no reliable data source available */
-function hidden(): RenderedSegment {
-  return { content: "", visible: false };
+function ago(ms: number): string {
+  const s = Math.max(0, Math.round(ms / 1000));
+  if (s < 60) return "now";
+  if (s < 3600) return `${Math.round(s / 60)}m`;
+  if (s < 86400) return `${Math.round(s / 3600)}h`;
+  return `${Math.round(s / 86400)}d`;
 }
 
-/** Safely extract sessionManager from piContext */
-function getSessionManager(ctx: FooterSegmentContext): any {
-  const piCtx = ctx.piContext as Record<string, unknown> | undefined;
-  return piCtx?.sessionManager as any | undefined;
+/** Tokens left after a compaction: our recorded estimate, else the summary size. */
+function tokensAfterOf(entry: any, before: number): number {
+  const recorded = Number(entry?.details?.tokensAfter ?? 0);
+  if (recorded > 0) return Math.min(recorded, before);
+  const summaryChars = typeof entry?.summary === "string" ? entry.summary.length : 0;
+  return Math.min(before, Math.ceil(summaryChars / 4));
 }
 
-/** Get all session events from sessionManager branch */
-function getSessionEvents(ctx: FooterSegmentContext): any[] {
-  const sm = getSessionManager(ctx);
-  if (!sm || typeof sm.getBranch !== "function") return [];
+function branchOf(ctx: FooterSegmentContext): any[] {
+  const sm = (ctx.piContext as Record<string, unknown> | undefined)?.sessionManager as any;
   try {
-    return sm.getBranch() ?? [];
+    return typeof sm?.getBranch === "function" ? (sm.getBranch() ?? []) : [];
   } catch {
     return [];
   }
 }
 
-function renderSessionEventsSegment(ctx: FooterSegmentContext): RenderedSegment {
-  const events = getSessionEvents(ctx);
-  const count = events.length;
-  if (count === 0) {
-    if (isSegmentEnabled("compactor", "session_events")) {
-      return { content: mutedPlaceholder(withIcon("sessionEvents", "0")), visible: true };
-    }
-    return hidden();
+export function compactionSummary(branch: readonly any[], now = Date.now()): { count: number; before: number; after: number; lastAt?: number } {
+  let count = 0;
+  let before = 0;
+  let after = 0;
+  let lastAt: number | undefined;
+  for (const e of branch) {
+    if (e?.type !== "compaction") continue;
+    count++;
+    const b = Number(e.tokensBefore ?? 0);
+    before += b;
+    after += tokensAfterOf(e, b);
+    const at = Date.parse(e.timestamp ?? "");
+    if (Number.isFinite(at) && at <= now) lastAt = at;
   }
-
-  const content = withIcon("sessionEvents", `${count}`);
-  return { content: applyColor("compactor", content, ctx.theme, ctx.colors), visible: true };
+  return { count, before, after, ...(lastAt != null ? { lastAt } : {}) };
 }
 
 function renderCompactionsSegment(ctx: FooterSegmentContext): RenderedSegment {
-  // Count compaction entries in the session events
-  const events = getSessionEvents(ctx);
-  let compactionCount = 0;
-  for (const e of events) {
-    if (!e || typeof e !== "object") continue;
-    if (e.type === "compaction" || e.type === "compacted") {
-      compactionCount++;
-    }
-  }
-  if (compactionCount === 0) {
-    if (isSegmentEnabled("compactor", "compactions")) {
-      return { content: mutedPlaceholder(withIcon("compactions", "0")), visible: true };
-    }
-    return hidden();
-  }
-
-  const content = withIcon("compactions", `${compactionCount}`);
-  return { content: applyColor("compactor", content, ctx.theme, ctx.colors), visible: true };
-}
-
-function renderTokensSavedSegment(ctx: FooterSegmentContext): RenderedSegment {
-  // Sum tokens saved from compaction entries.
-  // Pi's CompactionEntry has tokensBefore (total tokens before compaction).
-  // Compaction keeps ~10-15% of context, so tokens saved ≈ tokensBefore × 0.85.
-  const events = getSessionEvents(ctx);
-  let tokensSaved = 0;
-  let hasCompaction = false;
-  for (const e of events) {
-    if (!e || typeof e !== "object") continue;
-    if (e.type === "compaction") {
-      hasCompaction = true;
-      const tokensBefore = Number(e.tokensBefore ?? 0);
-      // Estimate tokens kept at ~12% (compaction summary + recent messages)
-      const tokensAfter = Math.round(tokensBefore * 0.12);
-      tokensSaved += Math.max(0, tokensBefore - tokensAfter);
-    }
-  }
-  if (!hasCompaction || tokensSaved === 0) return hidden();
-
-  const content = withIcon("tokensSaved", formatTokens(tokensSaved));
-  return { content: applyColor("compactor", content, ctx.theme, ctx.colors), visible: true };
-}
-
-function renderCompressionRatioSegment(ctx: FooterSegmentContext): RenderedSegment {
-  // Calculate compression ratio from Pi's CompactionEntry.tokensBefore.
-  // Compaction keeps ~12% of context, giving ~8:1 compression.
-  const events = getSessionEvents(ctx);
-  let totalBefore = 0;
-  let totalAfter = 0;
-  for (const e of events) {
-    if (!e || typeof e !== "object") continue;
-    if (e.type === "compaction") {
-      const before = Number(e.tokensBefore ?? 0);
-      if (before > 0) {
-        totalBefore += before;
-        totalAfter += Math.round(before * 0.12);
-      }
-    }
-  }
-  if (totalBefore === 0 || totalAfter === 0) return hidden();
-
-  const ratio = totalBefore / totalAfter;
-  const content = withIcon("compressionRatio", `${ratio.toFixed(1)}x`);
-  return { content: applyColor("compactor", content, ctx.theme, ctx.colors), visible: true };
-}
-
-function renderSandboxRunsSegment(ctx: FooterSegmentContext): RenderedSegment {
-  // Count sandbox events from session manager branch
-  const events = getSessionEvents(ctx);
-  let sandboxCount = 0;
-  for (const e of events) {
-    if (!e || typeof e !== "object") continue;
-    // Count tool calls that are sandbox/execute tools
-    const name = String((e as any).name ?? "").toLowerCase();
-    if (name.includes("sandbox") || name.includes("ctx_execute") || name === "execute") {
-      sandboxCount++;
-    }
-  }
-  if (sandboxCount === 0) return hidden();
-
-  const content = withIcon("sandboxRuns", `${sandboxCount}`);
-  return { content: applyColor("compactor", content, ctx.theme, ctx.colors), visible: true };
-}
-
-function renderSearchQueriesSegment(ctx: FooterSegmentContext): RenderedSegment {
-  // Count search events from session manager branch
-  const events = getSessionEvents(ctx);
-  let searchCount = 0;
-  for (const e of events) {
-    if (!e || typeof e !== "object") continue;
-    const name = String((e as any).name ?? "").toLowerCase();
-    if (name.includes("search") || name.includes("ctx_search")) {
-      searchCount++;
-    }
-  }
-  if (searchCount === 0) return hidden();
-
-  const content = withIcon("searchQueries", `${searchCount}`);
-  return { content: applyColor("compactor", content, ctx.theme, ctx.colors), visible: true };
+  const s = compactionSummary(branchOf(ctx));
+  if (s.count === 0) return { content: "", visible: false };
+  const dim = (t: string) => `\x1b[2m${t}\x1b[22m`;
+  const sizes = s.before > 0 ? ` ${formatTokens(s.before)}→${formatTokens(s.after)}` : "";
+  const age = s.lastAt != null ? dim(` · ${ago(Date.now() - s.lastAt)}`) : "";
+  const content = `${dim("cmp")} ${applyColor("compactor", `${s.count}×${sizes}`, ctx.theme, ctx.colors)}${age}`;
+  return { content, visible: true };
 }
 
 export const COMPACTOR_SEGMENTS: FooterSegment[] = [
-  { id: "session_events", label: "Session Events", shortLabel: "EVT", description: "Number of session events", zone: "center", render: renderSessionEventsSegment, defaultShow: true },
-  { id: "compactions", label: "Compactions", shortLabel: "CMP", description: "Number of context compactions", zone: "center", render: renderCompactionsSegment, defaultShow: true },
-  { id: "tokens_saved", label: "Tokens Saved", shortLabel: "SVD", description: "Tokens saved by compaction", zone: "center", render: renderTokensSavedSegment, defaultShow: true },
-  { id: "compression_ratio", label: "Compression Ratio", shortLabel: "RAT", description: "Last compaction compression ratio", zone: "center", render: renderCompressionRatioSegment, defaultShow: false },
-  { id: "sandbox_runs", label: "Sandbox Runs", shortLabel: "SBX", description: "Number of sandbox code runs", zone: "center", render: renderSandboxRunsSegment, defaultShow: false },
-  { id: "search_queries", label: "Search Queries", shortLabel: "QRY", description: "Number of search queries", zone: "center", render: renderSearchQueriesSegment, defaultShow: false },
+  {
+    id: "compactions",
+    label: "Compactions",
+    shortLabel: "CMP",
+    description: "Compactions this session: count, tokens before → after, time since the last (hidden until the first)",
+    zone: "center",
+    render: renderCompactionsSegment,
+    defaultShow: true,
+  },
 ];

package/src/segments/status-ext.ts

@@ -23,7 +23,6 @@ const STATUS_DISPLAY: Record<string, { short: string; segmentId: string }> = {
   workflow: { short: "WF", segmentId: "currentCommand" },
   ralph: { short: "RL", segmentId: "activeLoops" },
   memory: { short: "MEM", segmentId: "projectCount" },
-  compactor: { short: "CMP", segmentId: "compactions" },
   mcp: { short: "MCP", segmentId: "serversTotal" },
   notify: { short: "NTF", segmentId: "platformsEnabled" },
   kanboard: { short: "KB", segmentId: "docsCount" },