@mrclrchtr/supi-extras 1.12.1 → 1.13.0

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -44,6 +44,7 @@
     "./config": "./src/config.ts",
     "./context": "./src/context.ts",
     "./debug": "./src/debug-registry.ts",
+    "./footer-registry": "./src/footer-registry.ts",
     "./llm": "./src/llm.ts",
     "./package.json": "./package.json",
     "./path": "./src/path.ts",

package/node_modules/@mrclrchtr/supi-core/src/api.ts

@@ -13,6 +13,8 @@ export * from "./context.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./debug-registry.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./footer-registry.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./llm.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./path.ts";

package/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts

@@ -0,0 +1,57 @@
+// Shared footer contribution registry for SuPi extensions.
+//
+// Extensions register pre-styled text chunks with a placement hint
+// ("stats" for the metrics line, "status" for the extension status line).
+// The custom footer in supi-extras (or PI's built-in footer) reads these
+// contributions and renders them alongside the built-in metrics.
+
+import { createRegistry } from "./registry-utils.ts";
+
+/** Where the contribution should appear in the footer. */
+export type FooterPlacement = "stats" | "status";
+
+/** A single footer contribution registered by an extension. */
+export interface FooterContribution {
+  /** Unique key for this contribution. Re-registering with the same key replaces it. */
+  key: string;
+  /** Which footer line this belongs on. */
+  placement: FooterPlacement;
+  /**
+   * Sort order within the placement (lower values render further left). Default: 100.
+   * Priority 0 is reserved for the turn cache-hit part so it stays adjacent to CH.
+   */
+  priority?: number;
+  /** Return the pre-styled text for this contribution. Called on every render. */
+  render: () => string;
+}
+
+const registry = createRegistry<FooterContribution>("footer-contributions");
+
+function sortByPriority(a: FooterContribution, b: FooterContribution): number {
+  return (a.priority ?? 100) - (b.priority ?? 100);
+}
+
+export const footerContributions = {
+  /** Register or replace a footer contribution. */
+  register(contribution: FooterContribution): void {
+    registry.register(contribution.key, contribution);
+  },
+
+  /** Remove a contribution (e.g. on session_shutdown or when disabled). */
+  unregister(key: string): void {
+    registry.unregister(key);
+  },
+
+  /** Get contributions for a specific placement, sorted by priority. */
+  getByPlacement(placement: FooterPlacement): FooterContribution[] {
+    return registry
+      .getAll()
+      .filter((c) => c.placement === placement)
+      .sort(sortByPriority);
+  },
+
+  /** Remove all contributions (primarily for tests). */
+  clear(): void {
+    registry.clear();
+  },
+};

package/node_modules/@mrclrchtr/supi-core/src/index.ts

@@ -13,6 +13,8 @@ export * from "./context.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./debug-registry.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./footer-registry.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./path.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./project.ts";

package/node_modules/@mrclrchtr/supi-core/src/registry-utils.ts

@@ -27,7 +27,7 @@ function getGlobalRegistryMap<T>(name: string): Map<string, T> {
  *
  * @typeParam T - The value type stored in the registry.
  * @param name - Unique registry name (used to construct the `Symbol.for` key).
- * @returns An object with `register`, `getAll`, and `clear` functions.
+ * @returns An object with `register`, `unregister`, `getAll`, and `clear` functions.
  */
 export function createRegistry<T>(name: string) {
   const getMap = (): Map<string, T> => getGlobalRegistryMap<T>(name);
@@ -40,6 +40,13 @@ export function createRegistry<T>(name: string) {
       getMap().set(id, value);
     },
 
+    /**
+     * Remove a registration by id. No-op if not registered.
+     */
+    unregister: (id: string): void => {
+      getMap().delete(id);
+    },
+
     /**
      * Get all registered values in registration order.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-extras",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "SuPi extras — command aliases, skill shorthand, tab spinner, /supi-stash prompt stash with TUI overlay, and other small utilities",
   "license": "MIT",
   "repository": {
@@ -21,7 +21,7 @@
   ],
   "dependencies": {
     "clipboardy": "^5.3.1",
-    "@mrclrchtr/supi-core": "1.12.1"
+    "@mrclrchtr/supi-core": "1.13.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

package/src/model-effort-colors-helpers.ts

@@ -129,35 +129,74 @@ export function gatherUsage(entries: ReadonlyArray<UsageEntry>): UsageTotals {
 
 // ---- stats builder ----
 
-/** Build the left-side stats string. */
-export function buildStatsLeft(params: {
-  contextWindow: number;
-  percent: number | null;
-  usage: UsageTotals;
-  useSubscription: boolean;
-}): { text: string; contextPercentValue: number } {
-  const { contextWindow, percent, usage, useSubscription } = params;
-  const { totalInput, totalOutput, totalCacheRead, totalCacheWrite, totalCost } = usage;
+/** Push token-metric parts (↑ ↓ R W) onto the array. */
+function pushTokenParts(parts: string[], usage: UsageTotals): void {
+  if (usage.totalInput) parts.push(`↑${formatTokens(usage.totalInput)}`);
+  if (usage.totalOutput) parts.push(`↓${formatTokens(usage.totalOutput)}`);
+  if (usage.totalCacheRead) parts.push(`R${formatTokens(usage.totalCacheRead)}`);
+  if (usage.totalCacheWrite) parts.push(`W${formatTokens(usage.totalCacheWrite)}`);
+}
+
+/**
+ * Push CH (cumulative session cache hit rate) onto the array.
+ * Denominator includes cacheRead + cacheWrite + input (matches PI's built-in footer).
+ * Contrast with TCH which is per-turn and excludes cacheWrite.
+ */
+function pushCHPart(parts: string[], usage: UsageTotals): void {
+  const { totalCacheRead, totalCacheWrite, totalInput } = usage;
+  const denom = totalCacheRead + totalCacheWrite + totalInput;
+  if ((totalCacheRead > 0 || totalCacheWrite > 0) && denom > 0) {
+    parts.push(`CH${((totalCacheRead / denom) * 100).toFixed(1)}%`);
+  }
+}
 
-  const contextPercentValue = percent ?? 0;
+/** Build the core stats parts array (↑↓RW CH extra cost context). */
+function buildStatsParts(
+  usage: UsageTotals,
+  params: {
+    contextWindow: number;
+    percent: number | null;
+    useSubscription: boolean;
+    extraParts?: string[];
+  },
+): string[] {
+  const { totalCost } = usage;
+  const { contextWindow, percent, useSubscription, extraParts } = params;
   const contextPercent = percent != null ? percent.toFixed(1) : "?";
 
   const parts: string[] = [];
-  if (totalInput) parts.push(`↑${formatTokens(totalInput)}`);
-  if (totalOutput) parts.push(`↓${formatTokens(totalOutput)}`);
-  if (totalCacheRead) parts.push(`R${formatTokens(totalCacheRead)}`);
-  if (totalCacheWrite) parts.push(`W${formatTokens(totalCacheWrite)}`);
+  pushTokenParts(parts, usage);
+  pushCHPart(parts, usage);
+
+  for (const part of extraParts ?? []) {
+    if (part) parts.push(part);
+  }
 
   if (totalCost || useSubscription) {
     parts.push(`$${totalCost.toFixed(3)}${useSubscription ? " (sub)" : ""}`);
   }
 
-  const ctxDisplay =
+  parts.push(
     contextPercent === "?"
       ? `?/${formatTokens(contextWindow)}`
-      : `${contextPercent}%/${formatTokens(contextWindow)}`;
-  parts.push(ctxDisplay);
+      : `${contextPercent}%/${formatTokens(contextWindow)}`,
+  );
 
+  return parts;
+}
+
+/** Build the left-side stats string. */
+export function buildStatsLeft(params: {
+  contextWindow: number;
+  percent: number | null;
+  usage: UsageTotals;
+  useSubscription: boolean;
+  /** Extra parts inserted after CH, before cost and context. */
+  extraParts?: string[];
+}): { text: string; contextPercentValue: number } {
+  const { usage } = params;
+  const contextPercentValue = params.percent ?? 0;
+  const parts = buildStatsParts(usage, params);
   return { text: parts.join(" "), contextPercentValue };
 }
 

package/src/model-effort-colors.ts

@@ -8,6 +8,7 @@
  */
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { footerContributions } from "@mrclrchtr/supi-core/footer-registry";
 import {
   buildPwdLine,
   buildStatsLeft,
@@ -91,11 +92,17 @@ export default function modelEffortColors(pi: ExtensionAPI) {
               : false;
 
             // Stats
+            const statContribs = footerContributions
+              .getByPlacement("stats")
+              .map((c) => c.render())
+              .filter(Boolean);
+
             const rawStats = buildStatsLeft({
               contextWindow,
               percent: contextUsage?.percent ?? null,
               usage,
               useSubscription,
+              extraParts: statContribs,
             });
 
             let statsLeft = rawStats.text;
@@ -167,12 +174,21 @@ function buildStatusLine(
   theme: FooterTheme,
 ): void {
   const statuses = footerData.getExtensionStatuses();
-  if (statuses.size === 0) return;
-
-  const entries = Array.from(statuses.entries()) as Array<[string, string]>;
-  const statusLine = entries
-    .sort((a, b) => a[0].localeCompare(b[0]))
-    .map(([, text]) => sanitizeStatusText(text))
-    .join(" ");
+  const legacyEntries =
+    statuses.size > 0
+      ? (Array.from(statuses.entries()) as Array<[string, string]>)
+          .sort((a, b) => a[0].localeCompare(b[0]))
+          .map(([, text]) => sanitizeStatusText(text))
+      : [];
+
+  const contribEntries = footerContributions
+    .getByPlacement("status")
+    .map((c) => c.render())
+    .filter(Boolean);
+
+  const allEntries = [...legacyEntries, ...contribEntries];
+  if (allEntries.length === 0) return;
+
+  const statusLine = allEntries.join(" ");
   lines.push(truncateToWidth(statusLine, width, theme.fg("dim", "...")));
 }