@henryqw/pi-footer 0.5.4 → 0.5.6

package/README.md

@@ -1,11 +1,11 @@
 # `@henryqw/pi-footer`
 
-Henry's opinionated Pi footer style: concise checkout identity plus essential usage and extension status details.
+Henry's opinionated Pi footer style shows checkout identity, usage, and extension status.
 
 ## Why
 
-- **Created for**: Showing concise checkout identity plus usage and extension status in the Pi footer.
-- **Advantage**: Keeps repository, PR, usage, model, and extension state visible without separate status commands.
+- **Created for**: Show concise checkout identity, usage, and extension status in the Pi footer.
+- **Advantage**: Keep repository, PR, usage, model, and extension state visible without separate status commands.
 
 ## Install
 
@@ -17,14 +17,13 @@ pi install npm:@henryqw/pi-footer
 
 | Package | Why |
 | --- | --- |
-| `@henryqw/pi-multi-codex` | Adds active Codex subscription quota and reset status. |
-| `@henryqw/pi-open-in` | Adds `/open` and `/set-open-in` commands for editor configuration. |
+| `@henryqw/pi-multi-codex` | Improves. Adds active Codex subscription quota and reset status. |
+| `@henryqw/pi-open-in` | Improves. Adds `/open` and `/set-open-in` commands for editor configuration. |
+| `@henryqw/pi-pr` | Improves. Adds current-branch pull-request status. |
 
 ## Use
 
-| Surface | Type | Purpose |
-| --- | --- | --- |
-| Footer | UI | Show checkout, usage, model, thinking, and extension statuses. |
+The footer shows checkout, usage, model, thinking, and extension statuses.
 
 ```text
 pi-packages · clear-field-f8d2 · PR #123 · approved    Codex #1 · 50% · 7d 1d 1h 22m
@@ -32,19 +31,27 @@ pi-packages · clear-field-f8d2 · PR #123 · approved    Codex #1 · 50% · 7d
 ●  🐴 ponytail: ⚡ FULL                                                    ◷ 12m 34s
 ```
 
-First line shows repository, branch, and pull request status (`pi-pr`) after clickable checkout link. Linked-worktree branches drop generated `worktree/` prefix.
+- The first line shows the repository, branch, and `pi-pr` pull request status after the clickable checkout link. Linked-worktree branches drop the generated `worktree/` prefix.
+- The second line shows cumulative input tokens, output tokens, latest cache-hit rate, and tokens per second for the most recent assistant response. It also shows estimated cost and context usage. Totals include reported tool usage and finished `pi-subagent` background workflows. The active model and thinking level are right-aligned.
+- The third line shows other extension statuses on the left and cumulative agent-work time on the right, beneath the active model.
 
-Second line shows cumulative input tokens, output tokens, latest cache-hit rate, tokens per second of the most recent assistant response, estimated cost, and context usage. Unavailable values render as `—` without a misleading percent sign. Active model and thinking level are right-aligned.
+Unavailable values render as `—` without a misleading percent sign.
 
-`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.4 does not yet accept `ultra`, so that footer path remains unreachable until Pi adds it.
+`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.4 does not yet accept `ultra`, so that footer path remains unreachable until Pi adds it.
 
 Non-empty statuses from `@henryqw` extensions, currently Codex quota, occupy the right side of the first line.
 
-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 blocking user-prompt waits and 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. Statuses from all other extensions, including Ponytail and `pi-rewind`, share the left side, sorted by key with producer text, spacing, colors, links, and glyphs preserved.
+Agent-work time counts each run from `agent_start` through the final idle `agent_settled`. It includes automatic retries and auto-compaction inside that run. It excludes blocking user-prompt waits and 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 through a `pi-footer:agent-work` custom entry after each finalized run. It is restored on session resume.
+
+Statuses from all other extensions, including Ponytail and `pi-rewind`, share the left side. They are sorted by key with producer text, spacing, colors, links, and glyphs preserved.
 
 ## Clickable checkout
 
-When `pi-open-in.json` command is exactly `code` and Pi reports hyperlink support, the accent-colored checkout name is an OSC 8 `vscode://` link to the current path. Other configured commands and terminals with hyperlinks disabled render plain text.
+When the `pi-open-in.json` command is exactly `code` and Pi reports hyperlink support, the accent-colored checkout name is an OSC 8 `vscode://` link to the current path. Other configured commands and terminals with hyperlinks disabled render plain text.
 
 Use Pi fullscreen TUI so Pi handles the custom URI:
 
@@ -54,4 +61,6 @@ Use Pi fullscreen TUI so Pi handles the custom URI:
 }
 ```
 
-Set this through `/settings`, or launch with `--tui-mode fullscreen`. Then use normal primary click. Regular TUI delegates OSC 8 activation to the terminal; Ghostty uses `Cmd+click` but may not open custom URI schemes.
+Set this through `/settings`, or launch with `--tui-mode fullscreen`. Then use normal primary click. Regular TUI delegates OSC 8 activation to the terminal.
+
+Ghostty uses `Cmd+click` but may not open custom URI schemes.

package/extensions/footer.ts

@@ -1,5 +1,4 @@
 import { basename, dirname } from "node:path";
-import type { Usage } from "@earendil-works/pi-ai";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { getCapabilities, hyperlink, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { configuredOpenUri } from "@henryqw/pi-open-in/open-uri";
@@ -14,11 +13,26 @@ const THINKING_COLORS = {
 } as const;
 const HENRY_STATUS_KEY = "pi-multi-codex";
 const AGENT_TIME_ENTRY = "pi-footer:agent-work";
+const SUBAGENT_BACKGROUND_RESULT = "subagent-background-result";
 
-function isValidMilliseconds(value: unknown): value is number {
+type CountedUsage = { input: number; output: number; cost: { total: number } };
+
+function isNonNegativeNumber(value: unknown): value is number {
 	return typeof value === "number" && Number.isFinite(value) && value >= 0;
 }
 
+function subagentBackgroundUsage(details: unknown): CountedUsage | undefined {
+	if (!details || typeof details !== "object" || Array.isArray(details)) return;
+	const usage = (details as Record<string, unknown>).usage;
+	if (!usage || typeof usage !== "object" || Array.isArray(usage)) return;
+	const record = usage as Record<string, unknown>;
+	const cost = record.cost;
+	if (!cost || typeof cost !== "object" || Array.isArray(cost)) return;
+	const total = (cost as Record<string, unknown>).total;
+	if (!isNonNegativeNumber(record.input) || !isNonNegativeNumber(record.output) || !isNonNegativeNumber(total)) return;
+	return { input: record.input, output: record.output, cost: { total } };
+}
+
 function formatTokens(count: number): string {
 	if (count < 1_000) return `${count}`;
 	if (count < 1_000_000) return `${(count / 1_000).toFixed(1)}k`;
@@ -129,7 +143,7 @@ export default function footerExtension(pi: ExtensionAPI): void {
 		// 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)) {
+			if (entry.type === "custom" && entry.customType === AGENT_TIME_ENTRY && isNonNegativeNumber(entry.data)) {
 				activeMilliseconds = entry.data;
 			}
 		}
@@ -169,7 +183,7 @@ export default function footerExtension(pi: ExtensionAPI): void {
 			output = 0;
 			cost = 0;
 			cacheRate = undefined;
-			const add = (usage: Usage | undefined) => {
+			const add = (usage: CountedUsage | undefined) => {
 				if (!usage) return;
 				input += usage.input;
 				output += usage.output;
@@ -184,6 +198,8 @@ export default function footerExtension(pi: ExtensionAPI): void {
 					add(usage);
 				} else if (entry.type === "message" && entry.message.role === "toolResult") {
 					add(entry.message.usage);
+				} else if (entry.type === "custom_message" && entry.customType === SUBAGENT_BACKGROUND_RESULT) {
+					add(subagentBackgroundUsage(entry.details));
 				} else if (entry.type === "branch_summary" || entry.type === "compaction") {
 					add(entry.usage);
 				}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-footer",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "Show concise repository, branch, and usage details in the Pi footer.",
   "keywords": [
     "pi-package",
@@ -14,9 +14,9 @@
   },
   "license": "MIT",
   "files": [
+    "LICENSE",
     "extensions",
-    "README.md",
-    "LICENSE"
+    "README.md"
   ],
   "scripts": {
     "test": "node --test test/*.test.ts",