@esso0428/pi-subagents 0.15.5 → 0.15.6

package/dist/ui/fleet-list.d.ts

@@ -4,14 +4,17 @@
  * Shows `main` + each running/queued subagent as a navigable list. Pressing ↓ (or
  * ←) at an empty prompt activates the list; ↑/↓ move the selection (filled ● marker),
  * Enter opens the selected agent's live conversation overlay, Esc returns to the prompt.
- * A viewer stays open when its agent finishes; finished agents linger briefly in the list.
+ * A viewer stays open when its agent finishes so the final output remains readable.
  *
  * Mechanics (see plan): the list is a `belowEditor` widget (render-only), and ALL key
  * handling goes through `onTerminalInput` — which fires before the focused editor and
  * can `consume` keys — gated on `getEditorText() === ""` so normal typing is untouched.
  */
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { AgentManager } from "../agent-manager.js";
 import { type AgentActivity, type Theme } from "./agent-widget.js";
+/** Maximum total rows contributed by FleetView, including hint and indicators. */
+export declare const FLEET_MAX_RENDER_ROWS = 6;
 /** Minimal UI surface the FleetView needs from `ctx.ui` (structural subset). */
 export type FleetUICtx = {
     setWidget(key: string, content: undefined | ((tui: any, theme: Theme) => {
@@ -41,14 +44,27 @@ export type FleetUICtx = {
 export declare function formatFleetElapsed(ms: number): string;
 /** `↓ 13.1k tokens` — down-arrow prefix, compact magnitude, plural "tokens". */
 export declare function formatFleetTokens(count: number): string;
+/**
+ * Calculate a bounded agent slice for the complete logical roster.
+ * `selectedRosterIndex` includes main at index 0; `end` is exclusive.
+ */
+export declare function calculateFleetAgentWindow(agentCount: number, selectedRosterIndex: number): {
+    start: number;
+    end: number;
+    hiddenAbove: number;
+    hiddenBelow: number;
+};
 export declare class FleetList {
     private manager;
     private agentActivity;
     private getCwd;
+    private pi?;
+    private getCtx;
     private ui;
     private tui;
     private inputUnsub;
     private widgetRegistered;
+    private lastRosterKey;
     private timer;
     private enabled;
     /** Whether arrow keys currently navigate the list (vs. flow to the editor). */
@@ -58,7 +74,7 @@ export declare class FleetList {
     /** Set while a conversation overlay is open; calling it closes the overlay. */
     private viewerClose;
     private viewingAgentId;
-    constructor(manager: AgentManager, agentActivity: Map<string, AgentActivity>, getCwd?: () => string | undefined);
+    constructor(manager: AgentManager, agentActivity: Map<string, AgentActivity>, getCwd?: () => string | undefined, pi?: ExtensionAPI | undefined, getCtx?: () => ExtensionContext | undefined);
     setEnabled(enabled: boolean): void;
     /** Capture the UI context and (re)register the global input handler. */
     setUICtx(ui: FleetUICtx): void;
@@ -66,21 +82,17 @@ export declare class FleetList {
     ensureTimer(): void;
     /**
      * Called when an agent finishes. The viewer (if open on it) stays open so the
-     * final output remains readable, and the row lingers in the list — just refresh.
+     * final output remains readable; refresh the active-only roster.
      */
     onAgentFinished(_id: string): void;
     dispose(): void;
     /** Re-register/refresh the below-editor widget; clears it when no agents remain. */
     update(): void;
     /**
-     * Agents shown in the list, ordered earliest-launched first so the ones you
-     * started sooner sit at the top. Live rows are openable through their session;
-     * terminal rows are included only when their durable transcript exists. This
-     * prevents Enter from dead-ending on stale rehydrated metadata.
-     * Included: running/queued, plus the agent currently being viewed, plus
-     * recently-finished ones (they linger briefly before dropping out).
-     * Pending agents with no session yet are hidden until they start.
-     * (`listAgents()` is newest-first, so we re-sort.)
+     * Active agents shown in the list, ordered earliest-launched first so the
+     * ones you started sooner sit at the top. Pending agents with no session yet
+     * are hidden until they start. (`listAgents()` is newest-first, so we
+     * re-sort.)
      */
     private agentRecords;
     private roster;

package/dist/ui/fleet-list.js

@@ -1,39 +1,34 @@
-"use strict";
 /**
  * fleet-list.ts — Claude Code-style "FleetView" list rendered below the editor.
  *
  * Shows `main` + each running/queued subagent as a navigable list. Pressing ↓ (or
  * ←) at an empty prompt activates the list; ↑/↓ move the selection (filled ● marker),
  * Enter opens the selected agent's live conversation overlay, Esc returns to the prompt.
- * A viewer stays open when its agent finishes; finished agents linger briefly in the list.
+ * A viewer stays open when its agent finishes so the final output remains readable.
  *
  * Mechanics (see plan): the list is a `belowEditor` widget (render-only), and ALL key
  * handling goes through `onTerminalInput` — which fires before the focused editor and
  * can `consume` keys — gated on `getEditorText() === ""` so normal typing is untouched.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FleetList = void 0;
-exports.formatFleetElapsed = formatFleetElapsed;
-exports.formatFleetTokens = formatFleetTokens;
-const pi_tui_1 = require("@earendil-works/pi-tui");
-const agent_history_js_1 = require("../agent-history.js");
-const usage_js_1 = require("../usage.js");
-const agent_widget_js_1 = require("./agent-widget.js");
-const conversation_viewer_js_1 = require("./conversation-viewer.js");
+import { Editor, isKeyRelease, Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { canOpenActiveAgent } from "../agent-history-list.js";
+import { getLifetimeTotal } from "../usage.js";
+import { getDisplayName } from "./agent-widget.js";
+import { ConversationViewer, VIEWPORT_HEIGHT_PCT } from "./conversation-viewer.js";
 /** Widget key for the below-editor fleet list. */
 const FLEET_KEY = "fleet";
-/** Max agent rows shown at once; extras collapse into a "↓ N more" indicator. */
-const MAX_AGENT_ROWS = 5;
+/** Maximum total rows contributed by FleetView, including hint and indicators. */
+export const FLEET_MAX_RENDER_ROWS = 6;
+const FLEET_BASE_ROWS = 2; // hint + main
+const FLEET_BODY_ROWS = FLEET_MAX_RENDER_ROWS - FLEET_BASE_ROWS;
 /** Re-render cadence so elapsed/token stats tick while agents run. */
 const TICK_MS = 200;
-/** How long a finished agent lingers in the list before it drops out. */
-const FINISHED_LINGER_MS = 4000;
 /** `11s` — integer seconds, no decimal/suffix (matches Claude Code, unlike formatMs). */
-function formatFleetElapsed(ms) {
+export function formatFleetElapsed(ms) {
     return `${Math.max(0, Math.round(ms / 1000))}s`;
 }
 /** `↓ 13.1k tokens` — down-arrow prefix, compact magnitude, plural "tokens". */
-function formatFleetTokens(count) {
+export function formatFleetTokens(count) {
     let compact;
     if (count >= 1_000_000)
         compact = `${(count / 1_000_000).toFixed(1)}M`;
@@ -43,26 +38,45 @@ function formatFleetTokens(count) {
         compact = `${count}`;
     return `↓ ${compact} tokens`;
 }
+/**
+ * Calculate a bounded agent slice for the complete logical roster.
+ * `selectedRosterIndex` includes main at index 0; `end` is exclusive.
+ */
+export function calculateFleetAgentWindow(agentCount, selectedRosterIndex) {
+    const count = Math.max(0, Math.floor(agentCount));
+    if (count === 0)
+        return { start: 0, end: 0, hiddenAbove: 0, hiddenBelow: 0 };
+    const selectedAgent = Math.min(count - 1, Math.max(0, Math.floor(selectedRosterIndex) - 1));
+    const reserveAbove = selectedAgent > 0 ? 1 : 0;
+    const reserveBelow = selectedAgent < count - 1 ? 1 : 0;
+    const visibleCount = Math.max(1, FLEET_BODY_ROWS - reserveAbove - reserveBelow);
+    const start = Math.min(Math.max(0, selectedAgent - visibleCount + 1), Math.max(0, count - visibleCount));
+    const end = Math.min(count, start + visibleCount);
+    return { start, end, hiddenAbove: start, hiddenBelow: count - end };
+}
 /**
  * Place `right` flush to `width`, truncating `left` first so the stats survive.
  * The final clamp guarantees the line never exceeds `width` (which would wrap and
  * desync pi's line-diff → flicker) even on a terminal too narrow for the stats.
  */
 function rightAlign(left, right, width) {
-    const rightW = (0, pi_tui_1.visibleWidth)(right);
+    const rightW = visibleWidth(right);
     const maxLeft = Math.max(0, width - rightW - 1);
-    const leftClamped = (0, pi_tui_1.truncateToWidth)(left, maxLeft);
-    const gap = Math.max(1, width - (0, pi_tui_1.visibleWidth)(leftClamped) - rightW);
-    return (0, pi_tui_1.truncateToWidth)(leftClamped + " ".repeat(gap) + right, width);
+    const leftClamped = truncateToWidth(left, maxLeft);
+    const gap = Math.max(1, width - visibleWidth(leftClamped) - rightW);
+    return truncateToWidth(leftClamped + " ".repeat(gap) + right, width);
 }
-class FleetList {
+export class FleetList {
     manager;
     agentActivity;
     getCwd;
+    pi;
+    getCtx;
     ui;
     tui;
     inputUnsub;
     widgetRegistered = false;
+    lastRosterKey;
     timer;
     enabled = true;
     /** Whether arrow keys currently navigate the list (vs. flow to the editor). */
@@ -72,10 +86,12 @@ class FleetList {
     /** Set while a conversation overlay is open; calling it closes the overlay. */
     viewerClose;
     viewingAgentId;
-    constructor(manager, agentActivity, getCwd = () => undefined) {
+    constructor(manager, agentActivity, getCwd = () => undefined, pi, getCtx = () => undefined) {
         this.manager = manager;
         this.agentActivity = agentActivity;
         this.getCwd = getCwd;
+        this.pi = pi;
+        this.getCtx = getCtx;
     }
     // ---- Lifecycle ----
     setEnabled(enabled) {
@@ -93,6 +109,7 @@ class FleetList {
         this.inputUnsub?.();
         this.ui = ui;
         this.widgetRegistered = false;
+        this.lastRosterKey = undefined;
         this.tui = undefined;
         this.inputUnsub = ui.onTerminalInput(data => this.handleKey(data));
     }
@@ -103,7 +120,7 @@ class FleetList {
     }
     /**
      * Called when an agent finishes. The viewer (if open on it) stays open so the
-     * final output remains readable, and the row lingers in the list — just refresh.
+     * final output remains readable; refresh the active-only roster.
      */
     onAgentFinished(_id) {
         this.update();
@@ -123,6 +140,7 @@ class FleetList {
         if (this.ui && this.widgetRegistered)
             this.ui.setWidget(FLEET_KEY, undefined);
         this.widgetRegistered = false;
+        this.lastRosterKey = undefined;
         this.tui = undefined;
         this.active = false;
         // Null last so a `viewerClose()` microtask above can't re-register the widget.
@@ -132,7 +150,11 @@ class FleetList {
     update() {
         if (!this.ui)
             return;
-        const hasAgents = this.enabled && this.agentRecords().length > 0;
+        const records = this.agentRecords();
+        const hasAgents = this.enabled && records.length > 0;
+        const rosterKey = records.map(record => record.id).join("\0");
+        const rosterChanged = rosterKey !== this.lastRosterKey;
+        this.lastRosterKey = rosterKey;
         if (!hasAgents) {
             if (this.widgetRegistered) {
                 this.ui.setWidget(FLEET_KEY, undefined);
@@ -145,6 +167,7 @@ class FleetList {
             }
             this.active = false;
             this.selectedIndex = 0;
+            this.lastRosterKey = undefined;
             return;
         }
         this.clampSelection();
@@ -160,31 +183,19 @@ class FleetList {
             this.widgetRegistered = true;
         }
         else {
-            this.tui?.requestRender();
+            this.tui?.requestRender(rosterChanged);
         }
     }
     // ---- Roster ----
     /**
-     * Agents shown in the list, ordered earliest-launched first so the ones you
-     * started sooner sit at the top. Live rows are openable through their session;
-     * terminal rows are included only when their durable transcript exists. This
-     * prevents Enter from dead-ending on stale rehydrated metadata.
-     * Included: running/queued, plus the agent currently being viewed, plus
-     * recently-finished ones (they linger briefly before dropping out).
-     * Pending agents with no session yet are hidden until they start.
-     * (`listAgents()` is newest-first, so we re-sort.)
+     * Active agents shown in the list, ordered earliest-launched first so the
+     * ones you started sooner sit at the top. Pending agents with no session yet
+     * are hidden until they start. (`listAgents()` is newest-first, so we
+     * re-sort.)
      */
     agentRecords() {
-        const now = Date.now();
         return this.manager.listAgents()
-            .filter(a => {
-            const live = a.session && (a.status === "running" || a.status === "queued"
-                || a.id === this.viewingAgentId
-                || (a.completedAt != null && now - a.completedAt < FINISHED_LINGER_MS));
-            const cwd = this.getCwd();
-            const history = cwd !== undefined && (0, agent_history_js_1.hasAgentHistory)(cwd, a.transcriptPath);
-            return !!live || history;
-        })
+            .filter(record => canOpenActiveAgent(record))
             .sort((a, b) => a.startedAt - b.startedAt);
     }
     roster() {
@@ -205,7 +216,7 @@ class FleetList {
         // Input listeners receive BOTH key-press and key-release (the kitty protocol
         // emits both, and matchesKey matches either) — act on press only, or every
         // tap would move/fire twice. Repeats still pass through for held-key nav.
-        if ((0, pi_tui_1.isKeyRelease)(data))
+        if (isKeyRelease(data))
             return undefined;
         // While an overlay is open, let it own all input.
         if (this.viewerClose)
@@ -221,7 +232,7 @@ class FleetList {
         }
         if (!this.active) {
             // Activate: ↓ or ← at an empty prompt moves focus into the list.
-            const isActivator = (0, pi_tui_1.matchesKey)(data, "down") || (0, pi_tui_1.matchesKey)(data, "left");
+            const isActivator = matchesKey(data, "down") || matchesKey(data, "left");
             if (isActivator && this.agentRecords().length > 0 && this.ui.getEditorText() === "") {
                 this.active = true;
                 this.selectedIndex = 0;
@@ -231,13 +242,13 @@ class FleetList {
             return undefined;
         }
         // Active — arrows navigate, Enter opens, Esc / Up-past-top exits.
-        if ((0, pi_tui_1.matchesKey)(data, "down")) {
+        if (matchesKey(data, "down")) {
             const max = this.roster().length - 1;
             this.selectedIndex = Math.min(max, this.selectedIndex + 1);
             this.update();
             return { consume: true };
         }
-        if ((0, pi_tui_1.matchesKey)(data, "up")) {
+        if (matchesKey(data, "up")) {
             if (this.selectedIndex === 0) {
                 this.deactivate();
                 return { consume: true };
@@ -246,11 +257,11 @@ class FleetList {
             this.update();
             return { consume: true };
         }
-        if ((0, pi_tui_1.matchesKey)(data, "escape")) {
+        if (matchesKey(data, "escape")) {
             this.deactivate();
             return { consume: true };
         }
-        if ((0, pi_tui_1.matchesKey)(data, pi_tui_1.Key.enter)) {
+        if (matchesKey(data, Key.enter)) {
             this.openSelected();
             return { consume: true };
         }
@@ -268,7 +279,7 @@ class FleetList {
      */
     editorHasFocus() {
         const focused = this.tui?.focusedComponent;
-        return focused == null || focused instanceof pi_tui_1.Editor;
+        return focused == null || focused instanceof Editor;
     }
     deactivate() {
         this.active = false;
@@ -285,28 +296,28 @@ class FleetList {
         const record = entry.record;
         if (!this.ui)
             return;
-        const session = record.session ?? (record.transcriptPath && this.getCwd()
-            ? (() => {
-                const messages = (0, agent_history_js_1.readAgentHistory)(this.getCwd(), record.transcriptPath);
-                return messages ? (0, conversation_viewer_js_1.createStaticConversationSource)(messages) : undefined;
-            })()
-            : undefined);
-        if (!session) {
-            this.ui.notify(`Agent is ${record.status} — no history available.`, "info");
+        if (!canOpenActiveAgent(record) || !record.session) {
+            this.ui.notify(`Agent is ${record.status} — no live session available.`, "info");
+            return;
+        }
+        const session = record.session;
+        const ctx = this.getCtx();
+        const pi = this.pi;
+        if (!ctx || !pi) {
+            this.ui.notify("Agent conversation is unavailable — no active session.", "info");
             return;
         }
         const activity = this.agentActivity.get(record.id);
-        const isLive = record.session !== undefined;
         this.viewingAgentId = record.id;
         void this.ui.custom((tui, theme, keybindings, done) => {
             this.viewerClose = () => done(undefined);
-            return new conversation_viewer_js_1.ConversationViewer(tui, session, record, activity, theme, done, isLive ? () => {
+            return new ConversationViewer(tui, session, record, activity, theme, done, () => {
                 if (this.manager.abort(record.id))
                     this.ui?.notify(`Stopped "${record.description}".`, "info");
-            } : undefined, keybindings, isLive ? (message) => this.manager.steer(record.id, message) : undefined);
+            }, keybindings, (message) => this.manager.steer(record.id, message), { pi, ctx, readOnly: false });
         }, {
             overlay: true,
-            overlayOptions: { anchor: "center", width: "90%", maxHeight: `${conversation_viewer_js_1.VIEWPORT_HEIGHT_PCT}%` },
+            overlayOptions: { anchor: "center", width: "90%", maxHeight: `${VIEWPORT_HEIGHT_PCT}%` },
         }).then(() => this.clearViewer(), () => this.clearViewer());
     }
     /** Reset overlay state and return to the list (on close, auto-close, or error). */
@@ -336,32 +347,28 @@ class FleetList {
             ? "↑↓ select · enter view · esc back"
             : "esc to interrupt · ← for agents · ↓ to manage";
         const lines = [];
-        lines.push((0, pi_tui_1.truncateToWidth)("  " + theme.fg("dim", hint), width));
-        lines.push("");
-        lines.push((0, pi_tui_1.truncateToWidth)(`  ${this.bullet(0, sel, theme)} main`, width));
-        // Window the agent rows so the selected one stays visible.
-        const visible = Math.min(MAX_AGENT_ROWS, agents.length);
-        const selAgent = Math.max(0, sel - 1);
-        const start = selAgent < visible ? 0 : selAgent - visible + 1;
-        const hiddenBelow = agents.length - (start + visible);
-        if (start > 0)
-            lines.push(rightAlign("", theme.fg("dim", `↑ ${start} more`), width));
-        for (let a = start; a < start + visible; a++) {
+        lines.push(truncateToWidth("  " + theme.fg("dim", hint), width));
+        lines.push(truncateToWidth(`  ${this.bullet(0, sel, theme)} main`, width));
+        const window = calculateFleetAgentWindow(agents.length, sel);
+        if (window.hiddenAbove > 0) {
+            lines.push(rightAlign("", theme.fg("dim", `↑ ${window.hiddenAbove} more`), width));
+        }
+        for (let a = window.start; a < window.end; a++) {
             lines.push(this.renderAgentRow(a + 1, sel, agents[a].record, width, theme));
         }
-        if (hiddenBelow > 0)
-            lines.push(rightAlign("", theme.fg("dim", `↓ ${hiddenBelow} more`), width));
+        if (window.hiddenBelow > 0) {
+            lines.push(rightAlign("", theme.fg("dim", `↓ ${window.hiddenBelow} more`), width));
+        }
         return lines;
     }
     bullet(rosterIndex, sel, theme) {
         return rosterIndex === sel ? theme.fg("accent", "●") : theme.fg("dim", "○");
     }
     renderAgentRow(rosterIndex, sel, record, width, theme) {
-        const left = `  ${this.bullet(rosterIndex, sel, theme)} ${theme.fg("muted", (0, agent_widget_js_1.getDisplayName)(record.type))}  ${record.description}`;
-        const tokens = (0, usage_js_1.getLifetimeTotal)(this.agentActivity.get(record.id)?.lifetimeUsage ?? record.lifetimeUsage);
+        const left = `  ${this.bullet(rosterIndex, sel, theme)} ${theme.fg("muted", getDisplayName(record.type))}  ${record.description}`;
+        const tokens = getLifetimeTotal(this.agentActivity.get(record.id)?.lifetimeUsage ?? record.lifetimeUsage);
         const elapsedMs = (record.completedAt ?? Date.now()) - record.startedAt; // freezes once finished
         const right = theme.fg("dim", `${formatFleetElapsed(elapsedMs)} · ${formatFleetTokens(tokens)}`);
         return rightAlign(left, right, width);
     }
 }
-exports.FleetList = FleetList;

package/dist/ui/schedule-menu.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * schedule-menu.ts — `/agents → Scheduled jobs` submenu.
  *
@@ -8,8 +7,6 @@
  * "I scheduled something dumb, get rid of it"). Add management surfaces here
  * if real demand emerges.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.showSchedulesMenu = showSchedulesMenu;
 /** Format an ISO timestamp as relative time ("in 4h", "2d ago", "—"). */
 function relTime(iso, now = Date.now()) {
     if (!iso)
@@ -72,7 +69,7 @@ function formatDetails(j, scheduler) {
  * List scheduled jobs; selecting one opens a cancel-confirm with details.
  * Returns when the user backs out or after a cancellation.
  */
-async function showSchedulesMenu(ctx, scheduler) {
+export async function showSchedulesMenu(ctx, scheduler) {
     if (!scheduler.isActive()) {
         ctx.ui.notify("Scheduler is not active in this session.", "warning");
         return;

package/dist/ui/viewer-keys.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * viewer-keys.ts — Scroll key matchers for the conversation viewer.
  *
@@ -6,15 +5,13 @@
  * manager, falling back to the previous hardcoded keys otherwise. The viewer's
  * k/j and shift+arrow aliases always work alongside whatever is bound.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createViewerKeys = createViewerKeys;
-const pi_tui_1 = require("@earendil-works/pi-tui");
-function createViewerKeys(keybindings) {
-    const matches = (data, id, fallback) => keybindings ? keybindings.matches(data, id) : (0, pi_tui_1.matchesKey)(data, fallback);
+import { matchesKey } from "@earendil-works/pi-tui";
+export function createViewerKeys(keybindings) {
+    const matches = (data, id, fallback) => keybindings ? keybindings.matches(data, id) : matchesKey(data, fallback);
     return {
-        scrollUp: (data) => matches(data, "tui.select.up", "up") || (0, pi_tui_1.matchesKey)(data, "k"),
-        scrollDown: (data) => matches(data, "tui.select.down", "down") || (0, pi_tui_1.matchesKey)(data, "j"),
-        pageUp: (data) => matches(data, "tui.select.pageUp", "pageUp") || (0, pi_tui_1.matchesKey)(data, "shift+up"),
-        pageDown: (data) => matches(data, "tui.select.pageDown", "pageDown") || (0, pi_tui_1.matchesKey)(data, "shift+down"),
+        scrollUp: (data) => matches(data, "tui.select.up", "up") || matchesKey(data, "k"),
+        scrollDown: (data) => matches(data, "tui.select.down", "down") || matchesKey(data, "j"),
+        pageUp: (data) => matches(data, "tui.select.pageUp", "pageUp") || matchesKey(data, "shift+up"),
+        pageDown: (data) => matches(data, "tui.select.pageDown", "pageDown") || matchesKey(data, "shift+down"),
     };
 }

package/dist/usage.js

@@ -1,16 +1,10 @@
-"use strict";
 /** usage.ts — Token usage: shapes, accumulator operators, session-stats readers. */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLifetimeTotal = getLifetimeTotal;
-exports.addUsage = addUsage;
-exports.getSessionTokens = getSessionTokens;
-exports.getSessionContextPercent = getSessionContextPercent;
 /** Sum of lifetime usage components, or 0 if undefined. */
-function getLifetimeTotal(u) {
+export function getLifetimeTotal(u) {
     return u ? u.input + u.output + u.cacheWrite : 0;
 }
 /** Add a usage delta into a target accumulator (mutates target). */
-function addUsage(into, delta) {
+export function addUsage(into, delta) {
     into.input += delta.input;
     into.output += delta.output;
     into.cacheWrite += delta.cacheWrite;
@@ -28,7 +22,7 @@ function addUsage(into, delta) {
  * and so counts the cumulative cached prefix N times across N turns
  * (issue #38).
  */
-function getSessionTokens(session) {
+export function getSessionTokens(session) {
     if (!session)
         return 0;
     try {
@@ -43,7 +37,7 @@ function getSessionTokens(session) {
  * Context-window utilization (0–100), or null when unavailable
  * (no model contextWindow, or post-compaction before the next response).
  */
-function getSessionContextPercent(session) {
+export function getSessionContextPercent(session) {
     if (!session)
         return null;
     try {