@latentminds/pi-quotas 0.2.1 → 0.2.3

package/README.md

@@ -1,6 +1,6 @@
 # @latentminds/pi-quotas
 
-Quota monitoring for the [Pi coding agent](https://github.com/mariozechner/pi). Shows remaining usage and rate limits for Anthropic, OpenAI Codex, GitHub Copilot, and OpenRouter — directly in your Pi session.
+Quota monitoring for the [Pi coding agent](https://github.com/mariozechner/pi). Shows remaining usage and rate limits for Anthropic, OpenAI Codex, GitHub Copilot, OpenRouter, and Synthetic — directly in your Pi session.
 
 ## Screenshots
 
@@ -38,6 +38,7 @@ pi -e npm:@latentminds/pi-quotas
 | `/codex:quotas` | OpenAI Codex quotas only |
 | `/github:quotas` | GitHub Copilot quotas only |
 | `/openrouter:quotas` | OpenRouter quotas only |
+| `/synthetic:quotas` | Synthetic quotas only |
 | `/quotas:settings` | Toggle individual features on or off |
 
 ## Features
@@ -58,7 +59,7 @@ Automatic notifications when projected usage is on track to exceed limits before
 
 Use `/quotas:settings` to enable or disable:
 - Combined `/quotas` command
-- Per-provider commands (`/anthropic:quotas`, `/codex:quotas`, `/github:quotas`, `/openrouter:quotas`)
+- Per-provider commands (`/anthropic:quotas`, `/codex:quotas`, `/github:quotas`, `/openrouter:quotas`, `/synthetic:quotas`)
 - Footer status widget
 - Quota warning notifications
 
@@ -72,6 +73,7 @@ Settings can be saved globally (`~/.pi/agent/extensions/quotas.json`) or per-pro
 | OpenAI Codex | 5h, 7d, credits, spend cap | Rate-limit percentages; credit balance; spend-cap reached/OK |
 | GitHub Copilot | Premium/chat/completions per month | Remaining/entitlement counts with overage indicators |
 | OpenRouter | Monthly budget, daily/weekly/monthly usage | USD spending tracking with cents precision; optional per-key budget limits; UTC-based period resets |
+| Synthetic | Subscription, search/hour, free tools, weekly tokens, 5h limit | Request counts and token budgets; rolling five-hour rate limit; weekly token regen |
 
 ## Credentials
 
@@ -81,8 +83,9 @@ pi-quotas reads existing Pi auth entries from `~/.pi/agent/auth.json`:
 - `openai-codex` — Codex access token (also reads `~/.codex/auth.json` for the account ID)
 - `github-copilot` — GitHub Copilot OAuth token (falls back to `gh auth token` if needed)
 - `openrouter` — OpenRouter API key (Bearer token)
+- `synthetic` — Synthetic API key (set the `SYNTHETIC_API_KEY` environment variable)
 
-No additional setup is required - if Pi can use the provider, pi-quotas can check its quotas.
+No additional setup is required - if Pi can use the provider, pi-quotas can check its quotas. For Synthetic, export `SYNTHETIC_API_KEY` in your shell or Pi environment.
 
 ## Requirements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@latentminds/pi-quotas",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "license": "MIT",
   "type": "module",
   "private": false,

package/src/extensions/usage-status/format-status.test.ts

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { formatWindowStatus, type WindowStatus } from "./format-status.js";
 import type { SupportedQuotaProvider } from "../../types/quotas.js";
-import { formatStatus, toWindowStatus } from "./index.js";
+import { formatStatus, formatStatusForFooter, toStatusWindows, toWindowStatus } from "./index.js";
 
 // Minimal fake theme that just returns text with markers for color assertions
 function fakeTheme() {
@@ -183,6 +183,46 @@ describe("formatWindowStatus", () => {
     }
   });
 
+  it("clears the footer status when filtering removes all windows", () => {
+    expect(formatStatusForFooter({ ui: { theme } } as any, [])).toBeUndefined();
+  });
+
+  it("filters Anthropic subscription windows from footer status while keeping extra usage", () => {
+    const windows = toStatusWindows([
+      {
+        provider: "anthropic",
+        label: "5h",
+        usedPercent: 10,
+        resetsAt: new Date("2026-05-06T07:47:37Z"),
+        windowSeconds: 5 * 60 * 60,
+        usedValue: 10,
+        limitValue: 100,
+      },
+      {
+        provider: "anthropic",
+        label: "7d Sonnet",
+        usedPercent: 20,
+        resetsAt: new Date("2026-05-06T07:47:37Z"),
+        windowSeconds: 7 * 24 * 60 * 60,
+        usedValue: 20,
+        limitValue: 100,
+      },
+      {
+        provider: "anthropic",
+        label: "Extra (USD)",
+        usedPercent: 30,
+        resetsAt: new Date("2026-06-01T00:00:00Z"),
+        windowSeconds: 30 * 24 * 60 * 60,
+        usedValue: 30,
+        limitValue: 100,
+        isCurrency: true,
+      },
+    ]);
+
+    expect(windows).toHaveLength(1);
+    expect(windows[0]).toMatchObject({ label: "Extra (USD)" });
+  });
+
   it("does not prefix elapsed reset times with in", () => {
     vi.useFakeTimers();
     vi.setSystemTime(new Date("2026-05-06T05:28:37Z"));

package/src/extensions/usage-status/index.ts

@@ -39,6 +39,21 @@ export function formatStatus(ctx: Pick<ExtensionContext, "ui">, windows: WindowS
     .join(" ");
 }
 
+const ANTHROPIC_SUBSCRIPTION_WINDOW_LABELS = new Set([
+  "5h",
+  "7d",
+  "7d Sonnet",
+  "7d Opus",
+  "7d Opus (legacy)",
+]);
+
+function shouldShowInStatus(window: QuotaWindow): boolean {
+  return !(
+    window.provider === "anthropic" &&
+    ANTHROPIC_SUBSCRIPTION_WINDOW_LABELS.has(window.label)
+  );
+}
+
 export function toWindowStatus(window: QuotaWindow): WindowStatus {
   return {
     label: window.label,
@@ -52,6 +67,18 @@ export function toWindowStatus(window: QuotaWindow): WindowStatus {
   };
 }
 
+export function toStatusWindows(windows: QuotaWindow[]): WindowStatus[] {
+  return windows.filter(shouldShowInStatus).map(toWindowStatus);
+}
+
+export function formatStatusForFooter(
+  ctx: Pick<ExtensionContext, "ui">,
+  windows: WindowStatus[],
+): string | undefined {
+  if (windows.length === 0) return undefined;
+  return formatStatus(ctx, windows);
+}
+
 function createStatusRefresher() {
   let refreshTimer: ReturnType<typeof setInterval> | undefined;
   let activeContext: ExtensionContext | undefined;
@@ -73,9 +100,10 @@ function createStatusRefresher() {
         ctx.ui.setStatus(EXTENSION_ID, ctx.ui.theme.fg("warning", "usage unavailable"));
         return;
       }
-      const windows: WindowStatus[] = result.data.windows.map(toWindowStatus);
-      lastStatus = windows;
-      ctx.ui.setStatus(EXTENSION_ID, formatStatus(ctx, windows));
+      const windows: WindowStatus[] = toStatusWindows(result.data.windows);
+      const status = formatStatusForFooter(ctx, windows);
+      lastStatus = status === undefined ? undefined : windows;
+      ctx.ui.setStatus(EXTENSION_ID, status);
     } catch {
       ctx.ui.setStatus(EXTENSION_ID, ctx.ui.theme.fg("warning", "usage unavailable"));
     } finally {
@@ -114,7 +142,7 @@ function createStatusRefresher() {
     },
     renderLast(ctx: ExtensionContext): boolean {
       if (!lastStatus || !ctx.hasUI) return false;
-      ctx.ui.setStatus(EXTENSION_ID, formatStatus(ctx, lastStatus));
+      ctx.ui.setStatus(EXTENSION_ID, formatStatusForFooter(ctx, lastStatus));
       return true;
     },
   };

package/src/providers/parse.test.ts

@@ -48,6 +48,8 @@ describe("parseAnthropicUsage", () => {
     const extra = windows.find((w) => w.label === "Extra (AUD)");
     expect(extra).toBeDefined();
     expect(extra).toMatchObject({
+      provider: "anthropic",
+      label: "Extra (AUD)",
       isCurrency: true,
       usedPercent: 71.83,
       usedValue: 215.48,