@diegopetrucci/pi-extensions 0.1.69 → 0.1.71

package/README.md

@@ -13,12 +13,12 @@ A collection of [pi](https://pi.dev) agent extensions I made. (Btw, [I am also b
 
 ### Providers
 
-- [`fast`](./extensions/fast): Adds one `/fast` toggle that enables the provider-specific Fast mode for the currently selected supported OpenAI Codex or Anthropic Claude model.
+- [`fast`](./extensions/fast): Adds one `/fast` toggle that enables the provider-specific Fast mode for the currently selected supported direct OpenAI API, OpenAI Codex, or Anthropic Claude model.
 
 ### 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/fast/README.md

@@ -1,8 +1,16 @@
 # fast
 
-A pi extension that provides one `/fast` toggle for supported OpenAI Codex and Anthropic Claude models. It selects the provider-specific Fast-mode request shape from the currently selected model.
+A pi extension that provides one `/fast` toggle for supported direct OpenAI API, OpenAI Codex, and Anthropic Claude models. It selects the provider-specific Fast-mode request shape from the currently selected model.
 
-For eligible OpenAI Codex models it injects:
+For eligible direct OpenAI API models it injects:
+
+```json
+{
+  "service_tier": "fast"
+}
+```
+
+For eligible OpenAI Codex OAuth models it injects:
 
 ```json
 {
@@ -26,7 +34,14 @@ anthropic-beta: fast-mode-2026-02-01
 
 ## Eligibility
 
-OpenAI Fast mode requires all of the following:
+Direct OpenAI API Fast mode requires all of the following:
+
+- Provider `openai`.
+- API `openai-responses` or `openai-completions`.
+- Model `gpt-6-astra`, `gpt-6-sol`, or `gpt-6-luna`.
+- No existing `service_tier` field in the request payload.
+
+OpenAI Codex Fast mode requires all of the following:
 
 - Provider `openai-codex`.
 - API `openai-codex-responses`.
@@ -114,6 +129,7 @@ The collection package loads this unified extension instead of `openai-fast` and
 ## Notes
 
 - Anthropic Fast mode has separate rate limits, costs more than standard speed, and does not share prompt-cache prefixes with standard-speed requests.
-- OpenAI Fast mode intentionally does not affect API-key models.
+- Direct OpenAI Fast mode is limited to the confirmed, officially priced GPT-6 API models above; Fast pricing, availability, and rate limits remain provider- and account-dependent.
+- OpenAI Codex Fast mode intentionally does not affect API-key models.
 - Existing `speed` and `service_tier` fields are never overwritten.
-- Cost accounting still depends on the provider reporting the effective tier in its streamed response.
+- Pi's model catalog may not include a Fast-mode premium. Cost accounting depends on the provider reporting the effective tier in its streamed response, and this extension does not patch usage totals.

package/extensions/fast/index.ts

@@ -26,6 +26,10 @@ const OPENAI_SUPPORTED_MODELS = new Set([
 	"gpt-5.6-terra",
 	"gpt-5.6-luna",
 ]);
+const OPENAI_API_PROVIDER_ID = "openai";
+const OPENAI_API_IDS = new Set(["openai-responses", "openai-completions"]);
+const OPENAI_API_FAST_SERVICE_TIER = "fast";
+const OPENAI_API_SUPPORTED_MODELS = new Set(["gpt-6-astra", "gpt-6-sol", "gpt-6-luna"]);
 
 const DEFAULT_CONFIG: FastConfig = {
 	enabled: false,
@@ -69,6 +73,7 @@ type Eligibility = {
 	eligible: boolean;
 	modelKey: string;
 	provider?: FastProvider;
+	serviceTier?: string;
 	reason?: string;
 };
 
@@ -190,7 +195,37 @@ function getEligibility(ctx: ExtensionContext): Eligibility {
 			};
 		}
 
-		return { eligible: true, modelKey: key, provider: "openai" };
+		return {
+			eligible: true,
+			modelKey: key,
+			provider: "openai",
+			serviceTier: OPENAI_FAST_SERVICE_TIER,
+		};
+	}
+
+	if (model.provider === OPENAI_API_PROVIDER_ID) {
+		if (!OPENAI_API_IDS.has(model.api)) {
+			return {
+				eligible: false,
+				modelKey: key,
+				reason: `current API is ${model.api}, not openai-responses or openai-completions`,
+			};
+		}
+
+		if (!OPENAI_API_SUPPORTED_MODELS.has(model.id)) {
+			return {
+				eligible: false,
+				modelKey: key,
+				reason: "Fast mode is only enabled for GPT-6 Astra, GPT-6 Sol, and GPT-6 Luna on direct OpenAI APIs",
+			};
+		}
+
+		return {
+			eligible: true,
+			modelKey: key,
+			provider: "openai",
+			serviceTier: OPENAI_API_FAST_SERVICE_TIER,
+		};
 	}
 
 	return {
@@ -226,7 +261,7 @@ function getStatusMessage(ctx: ExtensionContext, state: SessionState): string {
 		const wireSetting =
 			eligibility.provider === "anthropic"
 				? `speed=${ANTHROPIC_FAST_SPEED}`
-				: `service_tier=${OPENAI_FAST_SERVICE_TIER}`;
+				: `service_tier=${eligibility.serviceTier}`;
 		return `Fast mode is ${describeMode(state)} and active for ${eligibility.modelKey}; requests will use ${wireSetting}.${injected}`;
 	}
 
@@ -317,9 +352,10 @@ function injectFastPayload(
 	}
 
 	if ("service_tier" in payload) return undefined;
+	if (!eligibility.serviceTier) return undefined;
 	state.lastInjectedAt = Date.now();
 	state.lastInjectedModel = eligibility.modelKey;
-	return { ...payload, service_tier: OPENAI_FAST_SERVICE_TIER };
+	return { ...payload, service_tier: eligibility.serviceTier };
 }
 
 export default function fastExtension(pi: ExtensionAPI) {
@@ -363,7 +399,7 @@ export default function fastExtension(pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("fast", {
-		description: "Toggle Fast mode for supported OpenAI Codex and Anthropic Claude models",
+		description: "Toggle Fast mode for supported direct OpenAI, OpenAI Codex, and Anthropic Claude models",
 		getArgumentCompletions: () => null,
 		handler: async (args, ctx) => {
 			const state = getState(ctx);

package/extensions/fast/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@diegopetrucci/pi-fast",
-  "version": "0.1.2",
-  "description": "A pi extension that enables Fast mode for supported OpenAI Codex and Anthropic Claude models based on the currently selected model.",
+  "version": "0.1.3",
+  "description": "A pi extension that enables Fast mode for supported direct OpenAI API, OpenAI Codex, and Anthropic Claude models based on the currently selected model.",
   "keywords": [
     "pi-package",
     "pi",

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.71",
   "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",