@henryqw/pi-footer 0.4.1 → 0.5.1

package/README.md

@@ -29,7 +29,7 @@ pi install npm:@henryqw/pi-footer
 ```text
 pi-packages · clear-field-f8d2 · PR #123 · approved
 ↑ 12.4k · ↓ 2.1k · ↺ 84.3% · ⚡ 87.4 t/s · $ 0.127 · ◔ 36.8%    gpt-5.6-luna • high
-Codex #1 · 50% · 7d 1d 1h 22m
+Codex #1 · 50% · 7d 1d 1h 22m                                             ◷ 12m 34s
 ●  🐴 ponytail: ⚡ FULL
 ```
 
@@ -39,7 +39,9 @@ Second line shows cumulative input tokens, output tokens, latest cache-hit rate,
 
 `off` uses the same dim grey as the model name. Active levels use an ANSI-256 gradient: green `minimal`, yellow-green `low`, lime `medium`, yellow `high`, orange `xhigh`, and red `max`. `ultra` renders as a rainbow when the runtime supplies it. Pi 0.84.2 does not yet accept `ultra`, so that footer path remains unreachable until Pi adds it.
 
-Third line is reserved for non-empty statuses from `@henryqw` extensions, currently Codex quota. Fourth line renders statuses from all other extensions, including Ponytail and `pi-rewind`. If only external statuses exist, third line stays blank so external output remains on line four. Statuses are sorted by key; producer text, spacing, colors, links, and glyphs are preserved.
+Third line shows cumulative agent-work time right-aligned beneath the model. It counts each run from `agent_start` through the final idle `agent_settled`, including automatic retries and auto-compaction inside that run, and excludes idle waits between runs. Standalone `/compact` is excluded because it runs outside the agent-run lifecycle and emits no `agent_start`. The cumulative total is persisted in the session via a `pi-footer:agent-work` custom entry after each finalized run and restored on session resume. Non-empty statuses from `@henryqw` extensions, currently Codex quota, share the left side.
+
+Fourth line renders statuses from all other extensions, including Ponytail and `pi-rewind`. Statuses are sorted by key; producer text, spacing, colors, links, and glyphs are preserved.
 
 ## Clickable checkout
 

package/extensions/footer.ts

@@ -12,7 +12,12 @@ const THINKING_COLORS = {
 	xhigh: 208,
 	max: 196,
 } as const;
-const HENRY_STATUS_KEYS = new Set(["pi-multi-codex"]);
+const HENRY_STATUS_KEY = "pi-multi-codex";
+const AGENT_TIME_ENTRY = "pi-footer:agent-work";
+
+function isValidMilliseconds(value: unknown): value is number {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
 
 function formatTokens(count: number): string {
 	if (count < 1_000) return `${count}`;
@@ -20,6 +25,14 @@ function formatTokens(count: number): string {
 	return `${(count / 1_000_000).toFixed(1)}M`;
 }
 
+function formatDuration(milliseconds: number): string {
+	const totalSeconds = Math.floor(milliseconds / 1_000);
+	const hours = Math.floor(totalSeconds / 3_600);
+	const minutes = Math.floor(totalSeconds % 3_600 / 60);
+	const seconds = totalSeconds % 60;
+	return hours ? `${hours}h ${minutes}m ${seconds}s` : minutes ? `${minutes}m ${seconds}s` : `${seconds}s`;
+}
+
 function sanitizeStatus(text: string): string {
 	return text.replace(/[\r\n]+/g, " ").trim();
 }
@@ -31,6 +44,13 @@ function align(left: string, right: string, width: number, ellipsis: string): st
 	return left + " ".repeat(width - visibleWidth(left) - visibleWidth(clippedRight)) + clippedRight;
 }
 
+// Mirrors align but reserves the right side (runtime) and truncates the left status first.
+function alignRightReserved(left: string, right: string, width: number, ellipsis: string): string {
+	const available = Math.max(width - visibleWidth(right) - 2, 0);
+	const clippedLeft = truncateToWidth(left, available, ellipsis);
+	return clippedLeft + " ".repeat(Math.max(width - visibleWidth(clippedLeft) - visibleWidth(right), 0)) + truncateToWidth(right, width, "");
+}
+
 function color(text: string, ansi256: number): string {
 	return `\x1b[38;5;${ansi256}m${text}\x1b[39m`;
 }
@@ -41,7 +61,50 @@ function rainbow(text: string): string {
 }
 
 export default function footerExtension(pi: ExtensionAPI): void {
+	let activeMilliseconds = 0;
+	let activeStartedAt: number | undefined;
+	let runtimeTimer: ReturnType<typeof setInterval> | undefined;
+	let requestRuntimeRender: (() => void) | undefined;
+	const stopRuntimeTimer = () => {
+		if (runtimeTimer === undefined) return;
+		clearInterval(runtimeTimer);
+		runtimeTimer = undefined;
+	};
+
+	const startActive = () => {
+		if (activeStartedAt !== undefined) return;
+		activeStartedAt = performance.now();
+		if (requestRuntimeRender) runtimeTimer = setInterval(requestRuntimeRender, 1_000);
+		requestRuntimeRender?.();
+	};
+	const finalizeActive = (): boolean => {
+		if (activeStartedAt === undefined) return false;
+		activeMilliseconds += performance.now() - activeStartedAt;
+		activeStartedAt = undefined;
+		stopRuntimeTimer();
+		requestRuntimeRender?.();
+		return true;
+	};
+
+	pi.on("agent_start", (_event) => {
+		startActive();
+	});
+	pi.on("agent_settled", (_event, ctx) => {
+		if (ctx.isIdle() && finalizeActive()) pi.appendEntry(AGENT_TIME_ENTRY, activeMilliseconds);
+	});
+	pi.on("session_shutdown", () => stopRuntimeTimer());
+
 	pi.on("session_start", async (_event, ctx) => {
+		stopRuntimeTimer();
+		activeStartedAt = undefined;
+		requestRuntimeRender = undefined;
+		// Latest valid entry wins; stored data is untrusted.
+		activeMilliseconds = 0;
+		for (const entry of ctx.sessionManager.getEntries()) {
+			if (entry.type === "custom" && entry.customType === AGENT_TIME_ENTRY && isValidMilliseconds(entry.data)) {
+				activeMilliseconds = entry.data;
+			}
+		}
 		if (ctx.mode !== "tui") return;
 
 		const git = await pi.exec(
@@ -100,9 +163,14 @@ export default function footerExtension(pi: ExtensionAPI): void {
 		};
 
 		ctx.ui.setFooter((tui, theme, data) => {
-			const unsubscribe = data.onBranchChange(() => tui.requestRender());
+			requestRuntimeRender = () => tui.requestRender();
+			const unsubscribe = data.onBranchChange(requestRuntimeRender);
 			return {
-				dispose: unsubscribe,
+				dispose() {
+					unsubscribe();
+					requestRuntimeRender = undefined;
+					stopRuntimeTimer();
+				},
 				invalidate() { },
 				render(width: number): string[] {
 					const entries = ctx.sessionManager.getEntries();
@@ -123,10 +191,10 @@ export default function footerExtension(pi: ExtensionAPI): void {
 						.map(([key, text]) => [key, sanitizeStatus(text)] as const)
 						.filter(([, text]) => Boolean(text));
 					const henryStatuses = statuses
-						.filter(([key]) => HENRY_STATUS_KEYS.has(key))
+						.filter(([key]) => key === HENRY_STATUS_KEY)
 						.map(([, text]) => text);
 					const externalStatuses = statuses
-						.filter(([key]) => !HENRY_STATUS_KEYS.has(key))
+						.filter(([key]) => key !== HENRY_STATUS_KEY)
 						.map(([, text]) => text);
 					const thinking = String(ctx.thinkingLevel ?? "off");
 					const thinkingColor = THINKING_COLORS[thinking as keyof typeof THINKING_COLORS];
@@ -143,6 +211,8 @@ export default function footerExtension(pi: ExtensionAPI): void {
 						? rainbow(thinking)
 						: thinkingColor === undefined ? theme.fg("dim", thinking) : color(thinking, thinkingColor);
 					const model = theme.fg("dim", `${ctx.model?.id ?? "no-model"} • `) + thinkingText;
+					const elapsed = activeMilliseconds + (activeStartedAt === undefined ? 0 : performance.now() - activeStartedAt);
+					const runtime = theme.fg("dim", `◷ ${formatDuration(elapsed)}`);
 					const identity = branch ? theme.fg("dim", `${repo} · `) : "";
 					const checkout = branch ?? repo;
 					const checkoutLink = openUri ? hyperlink(theme.fg("accent", checkout), openUri) : theme.fg("dim", checkout);
@@ -150,8 +220,8 @@ export default function footerExtension(pi: ExtensionAPI): void {
 					const lines = [
 						firstLine,
 						align(usage, model, width, ellipsis),
+						alignRightReserved(henryStatuses.join(" "), runtime, width, ellipsis),
 					];
-					if (henryStatuses.length || externalStatuses.length) lines.push(henryStatuses.join(" "));
 					if (externalStatuses.length) lines.push(externalStatuses.join(" "));
 					return lines.map((line) => truncateToWidth(line, width, ellipsis));
 				},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-footer",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Show concise repository, branch, and usage details in the Pi footer.",
   "keywords": [
     "pi-package",