@diegopetrucci/pi-extensions 0.1.69 → 0.1.70

package/README.md

@@ -18,7 +18,7 @@ A collection of [pi](https://pi.dev) agent extensions I made. (Btw, [I am also b
 ### UI
 
 - [`git-footer`](./extensions/git-footer): Standalone extension that adds TLH-style git dirty counts, ahead/behind, and optional PR number to pi's built-in footer status area.
-- [`minimal-footer`](./extensions/minimal-footer): Replaces pi's built-in footer with a minimal configurable two-line layout: branch plus cached git dirty/ahead/PR status and repo on the first line, context/model on the second, optional `DUMB ZONE`, optional `xp` marker, plus OpenAI Codex 5-hour and 7-day usage when available.
+- [`minimal-footer`](./extensions/minimal-footer): Replaces pi's built-in footer with a minimal configurable two-line layout: branch plus cached git dirty/ahead/PR status and repo on the first line, context/model on the second, optional `DUMB ZONE`, optional `xp` marker, plus OpenAI Codex usage windows labeled from their reported durations.
 - [`quiet-tools`](./extensions/quiet-tools): Renders collapsed built-in tool rows as a one-line invocation plus an expand hint without changing model-visible tool results; toggle temporarily with `/quiet-tools`.
 
 ### / Slash commands

package/extensions/minimal-footer/README.md

@@ -12,7 +12,7 @@ It replaces pi's built-in footer with a cleaner two-line layout that focuses on
 - current context percentage
 - red `DUMB ZONE` indicator when context usage is above 200k tokens
 - current model and thinking level
-- OpenAI Codex 5-hour and 7-day usage when available
+- OpenAI Codex usage windows, labeled from the durations reported by OpenAI
 - `xp` marker when Pi experimental features are enabled
 
 ## Layout
@@ -45,12 +45,14 @@ When context usage is above 200k tokens, the bottom-left line includes a red war
 44.1% · DUMB ZONE
 ```
 
-When using `openai-codex`, the bottom-left line also includes subscription usage:
+When using `openai-codex`, the bottom-left line also includes subscription usage. A typical account with both windows looks like:
 
 ```text
 44.1% · 5h 12% · 7d 38%
 ```
 
+Window labels come from OpenAI's reported durations, so an account that reports only a weekly primary window is shown correctly (for example, `7d 38%`) instead of being assumed to have a 5-hour window.
+
 When `PI_EXPERIMENTAL=1`, the bottom-left line also includes an experimental marker:
 
 ```text
@@ -116,11 +118,11 @@ Example:
     "windows": {
       "primary": {
         "enabled": true,
-        "label": "5h"
+        "label": "auto"
       },
       "secondary": {
         "enabled": true,
-        "label": "7d"
+        "label": "auto"
       }
     }
   },
@@ -205,9 +207,9 @@ Disable git dirty/ahead/PR status:
 - `codexUsage.cacheTtlMs`: in-memory usage cache duration
 - `codexUsage.requestTimeoutMs`: usage request timeout
 - `codexUsage.windows.primary.enabled`: show the primary usage window
-- `codexUsage.windows.primary.label`: label for the primary usage window
+- `codexUsage.windows.primary.label`: `"auto"` derives the primary label from OpenAI's reported duration; any other value overrides it
 - `codexUsage.windows.secondary.enabled`: show the secondary usage window
-- `codexUsage.windows.secondary.label`: label for the secondary usage window
+- `codexUsage.windows.secondary.label`: `"auto"` derives the secondary label from OpenAI's reported duration; any other value overrides it
 - `experimentalMarker.enabled`: show the marker when `PI_EXPERIMENTAL=1`
 - `experimentalMarker.label`: marker text
 - `experimentalMarker.color`: theme color for the marker (`error`, `warning`, `accent`, `text`, or `dim`)
@@ -221,7 +223,7 @@ Disable git dirty/ahead/PR status:
 - **Top left:** current git branch plus dirty/ahead/PR status when available
 - **Top right:** current repo directory name
 - **Bottom left:** current context usage percentage, plus red `DUMB ZONE` above 200k context tokens
-- **Bottom left on `openai-codex`:** current context usage percentage plus 5-hour and 7-day Codex usage
+- **Bottom left on `openai-codex`:** current context usage percentage plus the Codex usage windows reported for the account
 - **Bottom left with `PI_EXPERIMENTAL=1`:** current context usage percentage plus `xp`
 - **Bottom right:** model id and thinking level
 
@@ -237,5 +239,5 @@ This extension also lives inside the broader [`pi-extensions`](../../README.md)
 - Shows `DUMB ZONE` only while context usage is above 200k tokens.
 - Shows the model id rather than a provider-specific display label.
 - Shows `xp` when `PI_EXPERIMENTAL=1`.
-- For `openai-codex`, reads pi's stored OAuth login and fetches usage from ChatGPT's backend usage endpoint.
+- For `openai-codex`, reads pi's stored OAuth login and fetches usage from ChatGPT's backend usage endpoint. Window labels are inferred from each window's reported duration; missing or unrecognized durations use neutral `usage` labels rather than guessing from window position.
 - Usage is cached briefly in memory and refreshed after turns.

package/extensions/minimal-footer/index.ts

@@ -33,11 +33,11 @@ const DEFAULT_CONFIG: MinimalFooterConfig = {
 		windows: {
 			primary: {
 				enabled: true,
-				label: "5h",
+				label: "auto",
 			},
 			secondary: {
 				enabled: true,
-				label: "7d",
+				label: "auto",
 			},
 		},
 	},

package/extensions/minimal-footer/minimal-footer.example.json

@@ -15,11 +15,11 @@
     "windows": {
       "primary": {
         "enabled": true,
-        "label": "5h"
+        "label": "auto"
       },
       "secondary": {
         "enabled": true,
-        "label": "7d"
+        "label": "auto"
       }
     }
   },

package/extensions/minimal-footer/openai-usage.ts

@@ -5,6 +5,7 @@ import { getAgentDir } from "@earendil-works/pi-coding-agent";
 const PROVIDER_ID = "openai-codex";
 
 interface WhamUsageWindow {
+	limit_window_seconds?: number;
 	reset_at?: number;
 	used_percent?: number;
 }
@@ -18,6 +19,7 @@ interface WhamUsageResponse {
 
 export interface UsageWindow {
 	usedPercent?: number;
+	windowSeconds?: number;
 	resetAt?: number;
 }
 
@@ -43,6 +45,11 @@ function normalizeUsedPercent(value?: number): number | undefined {
 	return Math.min(100, Math.max(0, value));
 }
 
+function normalizeWindowSeconds(value?: number): number | undefined {
+	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return undefined;
+	return value;
+}
+
 function normalizeResetAt(value?: number): number | undefined {
 	if (typeof value !== "number" || !Number.isFinite(value)) return undefined;
 	return value * 1000;
@@ -51,9 +58,10 @@ function normalizeResetAt(value?: number): number | undefined {
 function parseUsageWindow(window?: WhamUsageWindow): UsageWindow | undefined {
 	if (!window) return undefined;
 	const usedPercent = normalizeUsedPercent(window.used_percent);
+	const windowSeconds = normalizeWindowSeconds(window.limit_window_seconds);
 	const resetAt = normalizeResetAt(window.reset_at);
-	if (usedPercent === undefined && resetAt === undefined) return undefined;
-	return { usedPercent, resetAt };
+	if (usedPercent === undefined && windowSeconds === undefined && resetAt === undefined) return undefined;
+	return { usedPercent, windowSeconds, resetAt };
 }
 
 function parseUsageSnapshot(data: WhamUsageResponse): Omit<UsageSnapshot, "fetchedAt"> {
@@ -125,6 +133,36 @@ function formatUsagePercent(value?: number): string | undefined {
 	return `${Math.round(value)}%`;
 }
 
+// Primary/secondary describe positions, not fixed periods. Match each reported
+// duration the same way Codex does, allowing small backend rounding differences.
+const KNOWN_WINDOW_LABELS: ReadonlyArray<{ seconds: number; label: string }> = [
+	{ seconds: 5 * 60 * 60, label: "5h" },
+	{ seconds: 24 * 60 * 60, label: "1d" },
+	{ seconds: 7 * 24 * 60 * 60, label: "7d" },
+	{ seconds: 30 * 24 * 60 * 60, label: "30d" },
+	{ seconds: 365 * 24 * 60 * 60, label: "365d" },
+];
+
+function isApproximateWindow(actualSeconds: number, expectedSeconds: number): boolean {
+	return Math.abs(actualSeconds - expectedSeconds) <= expectedSeconds * 0.05;
+}
+
+function formatUsageWindowLabel(
+	window: UsageWindow | undefined,
+	configuredLabel: string,
+	fallbackLabel: string,
+): string {
+	if (configuredLabel.toLowerCase() !== "auto") return configuredLabel;
+	const windowSeconds = window?.windowSeconds;
+	if (windowSeconds !== undefined) {
+		const knownWindow = KNOWN_WINDOW_LABELS.find(({ seconds }) =>
+			isApproximateWindow(windowSeconds, seconds)
+		);
+		if (knownWindow) return knownWindow.label;
+	}
+	return fallbackLabel;
+}
+
 export function isOpenAICodexProvider(provider?: string): boolean {
 	return provider === PROVIDER_ID;
 }
@@ -139,8 +177,18 @@ export function formatUsageSummary(
 	const secondary = formatUsagePercent(snapshot.secondary?.usedPercent);
 	const parts: string[] = [];
 
-	if (windows.primary.enabled && primary) parts.push(`${windows.primary.label} ${primary}`);
-	if (windows.secondary.enabled && secondary) parts.push(`${windows.secondary.label} ${secondary}`);
+	if (windows.primary.enabled && primary) {
+		const label = formatUsageWindowLabel(snapshot.primary, windows.primary.label, "usage");
+		parts.push(`${label} ${primary}`);
+	}
+	if (windows.secondary.enabled && secondary) {
+		const label = formatUsageWindowLabel(
+			snapshot.secondary,
+			windows.secondary.label,
+			"secondary usage",
+		);
+		parts.push(`${label} ${secondary}`);
+	}
 
 	return parts.length > 0 ? parts.join(" · ") : undefined;
 }

package/extensions/minimal-footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-minimal-footer",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "A minimal custom footer for pi.",
   "keywords": [
     "pi-package",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-extensions",
-  "version": "0.1.69",
+  "version": "0.1.70",
   "description": "A collection of pi extensions and skills for annotation UIs, context management, workflow audits, contrarian review, review-comment triage, notifications, brrr push alerts, safety guards, GitHub research, repo-local knowledge, todos, tool rendering, model/provider helpers, and Xiaohei-style article illustrations.",
   "keywords": [
     "pi-package",