@ravshansbox/pi-quota 0.3.1 → 0.4.0

package/README.md

@@ -8,13 +8,14 @@ Anthropic and OpenAI Codex quota status extension for pi.
 pi install npm:@ravshansbox/pi-quota
 ```
 
+Add `-l` to install it in project settings.
+
 ## Usage
 
-Pi loads the extension from `./index.ts` and shows the remaining quota for the provider backing the active model in the footer status line.
+Pi loads the extension from `./index.ts` and shows the remaining quota for the provider backing the active model above the editor.
 
 - Polls Anthropic and OpenAI Codex usage endpoints at every 10-minute wall-clock mark (`HH:00`, `HH:10`, `HH:20`, `HH:30`, `HH:40`, `HH:50`); polls immediately on session start, then aligns to the next mark
-- Shows a footer status for the provider backing the **active model**, and only when quota data for that provider has been polled; switching models re-renders it immediately
-- The status shares the footer line with other extensions, so it uses no extra terminal row
+- Shows a widget above the editor for the provider backing the **active model**, and only when quota data for that provider has been polled; switching models re-renders it immediately
 - The text stays compact, e.g. `93% 1h29m · 67% 3d13h`, where the 5-hour window comes first and the 7-day window second, and each window shows its remaining percentage followed by time until reset
 - Available resets, when present, are appended as `· 2x 5h` (count, then time until the soonest expires)
 - Both providers are still polled whenever their credentials exist, so quota is already fresh when the active model changes
@@ -25,6 +26,16 @@ Pi loads the extension from `./index.ts` and shows the remaining quota for the p
 
 No configuration is required. OAuth credentials for Anthropic and OpenAI Codex are read from `~/.pi/agent/auth.json`.
 
+To redeem a saved OpenAI Codex reset automatically when the 7-day window is exhausted, add this to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "quota": {
+    "codexResets": { "autoRedeem": true }
+  }
+}
+```
+
 ## Development
 
 ```bash

package/index.ts

@@ -1,16 +1,11 @@
-/**
- * pi-quota — tracks Anthropic and OpenAI Codex subscription quota and renders a footer status.
- *
- * NOTE: This extension deliberately has no automated tests. It is a single-file extension whose
- * behaviour is dominated by external HTTP APIs (Anthropic, OpenAI Codex) and pi runtime events;
- * it is verified manually by running it in pi. Do not add a test suite here.
- */
-
 import { spawn } from 'node:child_process';
 import { readFile, writeFile, appendFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { homedir } from 'node:os';
-import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
+import {
+  getAgentDir,
+  type ExtensionAPI,
+  type ExtensionContext,
+} from '@earendil-works/pi-coding-agent';
 
 interface QuotaConfig {
   codexResets?: { autoRedeem?: boolean };
@@ -71,12 +66,12 @@ type CodexResetCreditList = {
 
 type CodexResetConsumeResponse = { code?: string };
 
-const MODEL_PROVIDER_NAMES: Record<QuotaState['provider'], string> = {
+const modelProviderNames: Record<QuotaState['provider'], string> = {
   anthropic: 'anthropic',
   'openai-codex': 'openai',
 };
 
-const REQUEST_TIMEOUT_MS = 30_000;
+const requestTimeoutMs = 30_000;
 
 function nextMarkAfter(time: Date): Date {
   const next = new Date(time.getTime());
@@ -119,7 +114,7 @@ function formatResetTime(reset: Date): string {
 
 async function loadConfig(): Promise<QuotaConfig | null> {
   try {
-    const settingsPath = join(homedir(), '.pi', 'agent', 'settings.json');
+    const settingsPath = join(getAgentDir(), 'settings.json');
     const settings = JSON.parse(await readFile(settingsPath, 'utf-8'));
     return settings.quota ?? null;
   } catch {
@@ -128,7 +123,7 @@ async function loadConfig(): Promise<QuotaConfig | null> {
 }
 
 function authPath() {
-  return join(homedir(), '.pi', 'agent', 'auth.json');
+  return join(getAgentDir(), 'auth.json');
 }
 
 async function loadAuth(): Promise<AuthFile | null> {
@@ -150,7 +145,7 @@ async function persistAuthRecord(provider: string, record: OAuthAuthRecord): Pro
 }
 
 function logPath() {
-  return join(homedir(), '.pi', 'agent', 'pi-quota.log');
+  return join(getAgentDir(), 'pi-quota.log');
 }
 
 async function logError(message: string, error?: unknown): Promise<void> {
@@ -183,11 +178,9 @@ export default function (pi: ExtensionAPI) {
   }
 
   function buildStatusText(): string | undefined {
-    // Only ever render the provider backing the active model; anything else
-    // would not apply to the next request.
     const activeProvider = ctxRef?.model?.provider;
     if (!activeProvider) return undefined;
-    const state = states.find((s) => MODEL_PROVIDER_NAMES[s.provider] === activeProvider);
+    const state = states.find((s) => modelProviderNames[s.provider] === activeProvider);
 
     if (!state) return undefined;
 
@@ -214,9 +207,10 @@ export default function (pi: ExtensionAPI) {
 
     const text = buildStatusText();
 
-    ctxRef.ui.setStatus(
+    ctxRef.ui.setWidget(
       'pi-quota',
-      text === undefined ? undefined : ctxRef.ui.theme.fg('muted', text),
+      text === undefined ? undefined : [ctxRef.ui.theme.fg('muted', text)],
+      { placement: 'aboveEditor' },
     );
   }
 
@@ -252,7 +246,7 @@ export default function (pi: ExtensionAPI) {
   function pingProviderOnReset(provider: QuotaState['provider']) {
     const ctx = ctxRef;
     if (!ctx?.model) return;
-    if (ctx.model.provider !== MODEL_PROVIDER_NAMES[provider]) return;
+    if (ctx.model.provider !== modelProviderNames[provider]) return;
 
     const child = spawn(
       'pi',
@@ -313,7 +307,7 @@ export default function (pi: ExtensionAPI) {
         refresh_token: record.refresh,
         client_id: '9d1c250a-e61b-44d9-88ed-5944d1962f5e',
       }),
-      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+      signal: AbortSignal.timeout(requestTimeoutMs),
     });
 
     if (!response.ok) {
@@ -347,7 +341,7 @@ export default function (pi: ExtensionAPI) {
         refresh_token: record.refresh,
         client_id: 'app_EMoamEEZ73f0CkXaXp7hrann',
       }),
-      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+      signal: AbortSignal.timeout(requestTimeoutMs),
     });
 
     if (!response.ok) {
@@ -378,7 +372,7 @@ export default function (pi: ExtensionAPI) {
             'User-Agent': 'pi-quota/1.0',
             accept: 'application/json',
           },
-          signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+          signal: AbortSignal.timeout(requestTimeoutMs),
         },
       );
 
@@ -428,7 +422,7 @@ export default function (pi: ExtensionAPI) {
             credit_id: creditId,
             redeem_request_id: redeemRequestId,
           }),
-          signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+          signal: AbortSignal.timeout(requestTimeoutMs),
         },
       );
 
@@ -457,7 +451,7 @@ export default function (pi: ExtensionAPI) {
             'anthropic-beta': 'claude-code-20250219,oauth-2025-04-20',
             accept: 'application/json',
           },
-          signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+          signal: AbortSignal.timeout(requestTimeoutMs),
         });
 
         if (response.ok) {
@@ -487,7 +481,7 @@ export default function (pi: ExtensionAPI) {
             'User-Agent': 'pi-quota/1.0',
             accept: 'application/json',
           },
-          signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+          signal: AbortSignal.timeout(requestTimeoutMs),
         });
 
         if (response.ok) {
@@ -495,8 +489,6 @@ export default function (pi: ExtensionAPI) {
           if (data.rate_limit) {
             const primary = data.rate_limit.primary_window;
             const secondary = data.rate_limit.secondary_window;
-            // During OpenAI's temporary 5h-quota removal, the only returned
-            // window is the weekly quota, still named `primary_window`.
             const fiveHour = secondary ? primary : undefined;
             const sevenDay = secondary ?? primary;
             const resetsAvailable = data.rate_limit_reset_credits?.available_count;
@@ -530,12 +522,10 @@ export default function (pi: ExtensionAPI) {
     const codexState = states.find((s) => s.provider === 'openai-codex');
     if (!codexState) return;
 
-    // Reset the flag when the weekly window recovers
     if (codexState.sevenDayRemaining !== null && codexState.sevenDayRemaining > 0) {
       codexRedeemAttempted = false;
     }
 
-    // Only redeem if weekly is exhausted and we haven't tried yet
     if (codexState.sevenDayRemaining !== 0) return;
     if (codexState.resetsAvailable === 0) return;
     if (codexRedeemAttempted) return;
@@ -611,13 +601,10 @@ export default function (pi: ExtensionAPI) {
     ctxRef = ctx;
     codexRedeemAttempted = false;
 
-    // Do not await: quota polling is network-bound and would block startup.
     void runCycle();
     scheduleCheck();
   });
 
-  // The status tracks the active model's provider, so re-render on switch
-  // rather than waiting for the next poll (up to 10 minutes away).
   pi.on('model_select', (_event, ctx) => {
     ctxRef = ctx;
     updateStatus();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ravshansbox/pi-quota",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Anthropic and OpenAI Codex quota status extension for pi",
   "license": "MIT",
   "type": "module",
@@ -24,23 +24,20 @@
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
+    "lint": "oxlint --deny-warnings",
+    "lint:fix": "oxlint --fix",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
     "check": "npm run typecheck && npm run lint && npm run format:check"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*"
   },
   "devDependencies": {
-    "@eslint/js": "^10.0.1",
     "@types/node": "^26.6.5",
-    "eslint": "^10.13.0",
-    "eslint-config-prettier": "^10.1.8",
-    "prettier": "^3.9.10",
-    "typescript": "^6.0.3",
-    "typescript-eslint": "^8.72.0"
+    "oxfmt": "^0.74.0",
+    "oxlint": "^1.89.0",
+    "typescript": "^7.0.2"
   },
   "files": [
     "index.ts"