@arandevcode/opencode-quota-extended 0.2.1 → 0.2.3

package/README-es.md

@@ -129,21 +129,21 @@ Colores de semáforo: ≥50% `theme.success` (verde), 25-49% `theme.warning` (na
 
 Lee credenciales del archivo de autenticación de OpenCode (`~/.local/share/opencode/auth.json`). **No** almacena, solicita ni distribuye secretos.
 
-**OpenCode Go** requiere configuración adicional — es un poco tricky porque no hay API oficial todavía.
+**OpenCode Go** requiere configuración adicional — es un poco tricky porque todavía no hay API pública, así que el plugin reutiliza la cookie de sesión de tu navegador para consultar el mismo endpoint del console que usa el dashboard. La cookie caduca, por lo que puede que tengas que renovarla periódicamente.
 
 Crea `~/.config/opencode/opencode-quota/opencode-go.json`:
 
 ```json
 {
   "workspaceId": "wrk_abc123...",
-  "authCookie": "Fe26.2..."
+  "authCookie": "st_..."
 }
 ```
 
 | Campo | Descripción | Cómo obtenerlo |
 |---|---|---|
 | `workspaceId` | ID de tu workspace en OpenCode | Entra en [opencode.ai/go](https://opencode.ai/go). La URL es `https://opencode.ai/workspace/wrk_XXX/go` — copia la parte `wrk_XXX`. |
-| `authCookie` | Cookie de sesión para autenticación | Abre DevTools (F12) → Application → Cookies → `opencode.ai` → busca la cookie `auth` (empieza con `Fe26.2...`). O ejecuta en la consola: `document.cookie.match(/(?:^\|;\s*)auth=([^;]+)/)?.[1]` |
+| `authCookie` | Cookie de sesión del console | Abre DevTools (F12) → Application → Cookies → `https://opencode.ai` → busca `__Host-console_session` (el valor empieza por `st_...`). Es `HttpOnly`, así que solo se puede leer desde DevTools (no con `document.cookie`). |
 
 **Múltiples workspaces/cuentas:** cualquier archivo `opencode-go-<sufijo>.json` en el mismo directorio añade una sección extra `Opencode GO (<sufijo>)` (p. ej. `opencode-go-work.json` → **Opencode GO (work)**). El `opencode-go.json` base siempre se muestra como **OpenCode Go**.
 
@@ -158,7 +158,7 @@ cp ~/.config/opencode/opencode-quota/opencode-go.json \
 ```sh
 npm run setup
 ```
-Te solicita ambos valores y crea el archivo automáticamente. También muestra un bookmarklet que puedes arrastrar a la barra de favoritos y pinchar en opencode.ai para extraer la auth cookie con un clic.
+Te solicita ambos valores y crea el archivo automáticamente. También muestra instrucciones paso a paso con DevTools para copiar la cookie `__Host-console_session`.
 
 **Consejo:** mantén una pestaña del navegador con sesión iniciada en opencode.ai mientras usas este plugin — la auth cookie puede expirar.
 
@@ -170,7 +170,7 @@ Te solicita ambos valores y crea el archivo automáticamente. También muestra u
 
 - **El panel no aparece**: `grep '@arandevcode/opencode-quota-extended' ~/.local/share/opencode/log/*.log`
 - **OpenCode Go muestra "skipped"**: confirma que el archivo sidecar o vars de entorno están configurados
-- **Bug antiguo de pinning `@opentui/solid`**: actualiza a `^0.4.1` y reinstala limpio (`rm -rf node_modules && npm ci`)
+- **Bug antiguo de pinning `@opentui/solid`**: usa `^0.4.1 || ^0.5.0` y reinstala limpio (`rm -rf node_modules && npm ci`)
 
 ### Desarrollo
 

package/README.md

@@ -130,21 +130,21 @@ Traffic-light colors: ≥50% `theme.success` (green), 25-49% `theme.warning` (or
 
 Reads credentials from OpenCode's runtime auth file (`~/.local/share/opencode/auth.json`). Does **not** store, prompt for, or distribute secrets.
 
-**OpenCode Go** requires additional setup — it's a bit tricky because there's no official API yet.
+**OpenCode Go** requires additional setup — it's a bit tricky because there's no public API yet, so the plugin reuses your browser session cookie to query the same console endpoint the dashboard uses. The cookie expires, so you may need to refresh it periodically.
 
 Create `~/.config/opencode/opencode-quota/opencode-go.json`:
 
 ```json
 {
   "workspaceId": "wrk_abc123...",
-  "authCookie": "Fe26.2..."
+  "authCookie": "st_..."
 }
 ```
 
 | Field | Description | How to get it |
 |---|---|---|
 | `workspaceId` | Your OpenCode workspace ID | Log in at [opencode.ai/go](https://opencode.ai/go). The URL is `https://opencode.ai/workspace/wrk_XXX/go` — copy the `wrk_XXX` part. |
-| `authCookie` | Session cookie for auth | Open DevTools (F12) → Application → Cookies → `opencode.ai` → find the `auth` cookie (starts with `Fe26.2...`). Or run this in the console: `document.cookie.match(/(?:^\|;\s*)auth=([^;]+)/)?.[1]` |
+| `authCookie` | Console session cookie | Open DevTools (F12) → Application → Cookies → `https://opencode.ai` → find `__Host-console_session` (value starts with `st_...`). It is `HttpOnly`, so it can only be read from DevTools (not `document.cookie`). |
 
 **Multiple workspaces/accounts:** any `opencode-go-<suffix>.json` file in the same directory adds an extra `Opencode GO (<suffix>)` section (e.g. `opencode-go-work.json` → **Opencode GO (work)**). The base `opencode-go.json` always renders as **OpenCode Go**.
 
@@ -159,7 +159,7 @@ cp ~/.config/opencode/opencode-quota/opencode-go.json \
 ```sh
 npm run setup
 ```
-This prompts for both values and creates the file for you. It also prints a bookmarklet you can drag to your bookmarks bar and click while on opencode.ai to extract the auth cookie with one click.
+This prompts for both values and creates the file for you. It also prints step-by-step DevTools instructions to grab the `__Host-console_session` cookie.
 
 **Tip:** keep a browser tab logged into opencode.ai while using this plugin — the auth cookie may expire.
 
@@ -171,7 +171,7 @@ This prompts for both values and creates the file for you. It also prints a book
 
 - **Panel doesn't appear**: `grep '@arandevcode/opencode-quota-extended' ~/.local/share/opencode/log/*.log`
 - **OpenCode Go shows "skipped"**: confirm sidecar file or env vars are set
-- **Old `@opentui/solid` pinning bug**: update to `^0.4.1` and clean-install (`rm -rf node_modules && npm ci`)
+- **Old `@opentui/solid` pinning bug**: use `^0.4.1 || ^0.5.0` and clean-install (`rm -rf node_modules && npm ci`)
 
 ### Development
 

package/dist/lib/balance.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Prepaid credit balance formatting (OpenCode Go).
+ *
+ * The provider reports `availableMicroCents` as a decimal string because it can
+ * exceed the safe integer range; 1e8 microcents make one US dollar. Only the
+ * dollar amount and the auto-recharge flag are ever rendered — never the raw
+ * microcents, and never anything that came from the account credentials.
+ */
+import type { ProviderBalance } from "./types.js";
+/** Available credit in dollars (2 decimals), or null when unreadable. */
+export declare function balanceUsd(balance: ProviderBalance | undefined): number | null;
+/** "$9.18 credit", plus a note when credits are drawn or auto-recharge is on. */
+export declare function formatBalance(balance: ProviderBalance | undefined): string;
+//# sourceMappingURL=balance.d.ts.map

package/dist/lib/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/lib/balance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM9E;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAO1E"}

package/dist/lib/balance.js

@@ -0,0 +1,23 @@
+/** Available credit in dollars (2 decimals), or null when unreadable. */
+export function balanceUsd(balance) {
+    if (!balance)
+        return null;
+    const raw = balance.availableMicroCents;
+    const micro = typeof raw === "string" ? Number(raw.trim()) : raw;
+    if (typeof micro !== "number" || !Number.isFinite(micro))
+        return null;
+    return Math.round(micro / 1e6) / 100;
+}
+/** "$9.18 credit", plus a note when credits are drawn or auto-recharge is on. */
+export function formatBalance(balance) {
+    const usd = balanceUsd(balance);
+    if (usd === null || !balance)
+        return "";
+    const parts = [`$${usd.toFixed(2)} credit`];
+    if (balance.useBalance === true)
+        parts.push("draws on credits");
+    if (balance.autoRecharge?.enabled)
+        parts.push("auto-recharge");
+    return parts.join(" · ");
+}
+//# sourceMappingURL=balance.js.map

package/dist/lib/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../src/lib/balance.ts"],"names":[],"mappings":"AAUA,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,OAAoC;IAC7D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,mBAAmB,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACvC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,OAAoC;IAChE,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,YAAY,EAAE,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/lib/pace.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Quota pace — how usage compares to the passage of time in a window.
+ *
+ * Every window resets on a known schedule (5h, weekly, monthly). When a window
+ * carries its reset time we can say whether the remaining share is ahead of or
+ * behind the clock: spending slower than time passes is margin, faster is
+ * "ahead". This is the same reading Jarvis shows, but text-only — no overlay on
+ * the progress bar, so it works at any terminal width.
+ */
+import type { QuotaWindow } from "./types.js";
+export type QuotaPace = "buffer" | "on-pace" | "burn";
+export interface QuotaPaceReading {
+    pace: QuotaPace;
+    /** Percentage-point gap between remaining quota and time left (rounded). */
+    deltaPercent: number;
+    /** The same gap expressed as time, in ms. */
+    deltaMs: number;
+}
+/** Window length when the id/label names a known schedule, else null. */
+export declare function windowDurationMs(window: Pick<QuotaWindow, "id" | "label">): number | null;
+/**
+ * Compare remaining quota to the time left in the window. Returns null when the
+ * schedule or reset time is unknown, or there is no reading to compare.
+ */
+export declare function quotaPace(window: QuotaWindow, now?: number): QuotaPaceReading | null;
+/** One short line: "margin +6% · 3h 12m", "ahead -6% · 1d 2h" or "on pace". */
+export declare function formatPace(window: QuotaWindow, now?: number): string;
+//# sourceMappingURL=pace.d.ts.map

package/dist/lib/pace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pace.d.ts","sourceRoot":"","sources":["../../src/lib/pace.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAMzF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,gBAAgB,GAAG,IAAI,CAUhG;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAWhF"}

package/dist/lib/pace.js

@@ -0,0 +1,46 @@
+import { clampPercent, formatDuration } from "./reset-format.js";
+const HOUR_MS = 60 * 60 * 1000;
+const DAY_MS = 24 * HOUR_MS;
+/** Window length when the id/label names a known schedule, else null. */
+export function windowDurationMs(window) {
+    const key = `${window.id} ${window.label}`.toLowerCase();
+    if (/\b5h\b|five[_ -]?hour/.test(key))
+        return 5 * HOUR_MS;
+    if (/weekly|seven[_ -]?day|\bweek\b/.test(key))
+        return 7 * DAY_MS;
+    if (/monthly|\bmonth\b/.test(key))
+        return 30 * DAY_MS;
+    return null;
+}
+/**
+ * Compare remaining quota to the time left in the window. Returns null when the
+ * schedule or reset time is unknown, or there is no reading to compare.
+ */
+export function quotaPace(window, now = Date.now()) {
+    const duration = windowDurationMs(window);
+    const resetAt = window.resetTimeIso ? Date.parse(window.resetTimeIso) : Number.NaN;
+    const remaining = window.percentRemaining;
+    if (duration == null || !Number.isFinite(resetAt) || !Number.isFinite(remaining))
+        return null;
+    const exactTimeLeft = Math.min(100, Math.max(0, ((resetAt - now) / duration) * 100));
+    const deltaPercent = clampPercent(remaining) - clampPercent(exactTimeLeft);
+    const pace = deltaPercent > 1 ? "buffer" : deltaPercent < -1 ? "burn" : "on-pace";
+    const deltaMs = Math.round((Math.abs(Math.min(100, Math.max(0, remaining)) - exactTimeLeft) / 100) * duration);
+    return { pace, deltaPercent, deltaMs };
+}
+/** One short line: "margin +6% · 3h 12m", "ahead -6% · 1d 2h" or "on pace". */
+export function formatPace(window, now = Date.now()) {
+    const reading = quotaPace(window, now);
+    if (!reading)
+        return "";
+    const { pace, deltaPercent, deltaMs } = reading;
+    if (pace === "on-pace")
+        return "on pace";
+    const word = pace === "buffer" ? "margin" : "ahead";
+    const sign = deltaPercent > 0 ? "+" : "";
+    const gap = formatDuration(deltaMs);
+    return gap
+        ? `${word} ${sign}${deltaPercent}% · ${gap}`
+        : `${word} ${sign}${deltaPercent}%`;
+}
+//# sourceMappingURL=pace.js.map

package/dist/lib/pace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pace.js","sourceRoot":"","sources":["../../src/lib/pace.ts"],"names":[],"mappings":"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"}

package/dist/lib/refresh-scheduler.d.ts

@@ -0,0 +1,20 @@
+export type RefreshSchedulerOptions = {
+    refresh: () => void;
+    intervalMs: number;
+    activityDelayMs?: number;
+    minGapMs?: number;
+    now?: () => number;
+};
+export type RefreshScheduler = {
+    start: () => void;
+    schedule: (delay?: number, force?: boolean) => void;
+    dispose: () => void;
+};
+/**
+ * Coalesces bursts of usage events into a single refresh and enforces a
+ * minimum gap between attempts. A streaming message can emit many
+ * `message.updated` events per second; without this every one of them would
+ * fan out to the provider APIs.
+ */
+export declare function createRefreshScheduler(options: RefreshSchedulerOptions): RefreshScheduler;
+//# sourceMappingURL=refresh-scheduler.d.ts.map

package/dist/lib/refresh-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-scheduler.d.ts","sourceRoot":"","sources":["../../src/lib/refresh-scheduler.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAoDzF"}

package/dist/lib/refresh-scheduler.js

@@ -0,0 +1,57 @@
+/**
+ * Coalesces bursts of usage events into a single refresh and enforces a
+ * minimum gap between attempts. A streaming message can emit many
+ * `message.updated` events per second; without this every one of them would
+ * fan out to the provider APIs.
+ */
+export function createRefreshScheduler(options) {
+    const { refresh, intervalMs, activityDelayMs = 1_500, minGapMs = 20_000, now = Date.now, } = options;
+    let interval = null;
+    let timer = null;
+    let lastRefreshAt = 0;
+    let disposed = false;
+    const run = () => {
+        if (disposed)
+            return;
+        lastRefreshAt = now();
+        refresh();
+    };
+    const schedule = (delay = activityDelayMs, force = false) => {
+        if (disposed || timer !== null)
+            return;
+        const wait = force
+            ? delay
+            : Math.max(delay, minGapMs - (now() - lastRefreshAt));
+        timer = setTimeout(() => {
+            timer = null;
+            if (disposed)
+                return;
+            if (!force && now() - lastRefreshAt < minGapMs) {
+                schedule(0);
+                return;
+            }
+            run();
+        }, wait);
+    };
+    return {
+        start() {
+            if (disposed || interval !== null)
+                return;
+            interval = setInterval(() => {
+                if (now() - lastRefreshAt >= minGapMs)
+                    run();
+            }, intervalMs);
+        },
+        schedule,
+        dispose() {
+            disposed = true;
+            if (interval !== null)
+                clearInterval(interval);
+            if (timer !== null)
+                clearTimeout(timer);
+            interval = null;
+            timer = null;
+        },
+    };
+}
+//# sourceMappingURL=refresh-scheduler.js.map

package/dist/lib/refresh-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-scheduler.js","sourceRoot":"","sources":["../../src/lib/refresh-scheduler.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,MAAM,EACJ,OAAO,EACP,UAAU,EACV,eAAe,GAAG,KAAK,EACvB,QAAQ,GAAG,MAAM,EACjB,GAAG,GAAG,IAAI,CAAC,GAAG,GACf,GAAG,OAAO,CAAC;IAEZ,IAAI,QAAQ,GAA0C,IAAI,CAAC;IAC3D,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,IAAI,QAAQ;YAAE,OAAO;QACrB,aAAa,GAAG,GAAG,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,KAAK,GAAG,eAAe,EAAE,KAAK,GAAG,KAAK,EAAE,EAAE;QAC1D,IAAI,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QACvC,MAAM,IAAI,GAAG,KAAK;YAChB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;QACxD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,IAAI,CAAC;YACb,IAAI,QAAQ;gBAAE,OAAO;YACrB,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,GAAG,aAAa,GAAG,QAAQ,EAAE,CAAC;gBAC/C,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,GAAG,EAAE,CAAC;QACR,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;YACH,IAAI,QAAQ,IAAI,QAAQ,KAAK,IAAI;gBAAE,OAAO;YAC1C,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;gBAC1B,IAAI,GAAG,EAAE,GAAG,aAAa,IAAI,QAAQ;oBAAE,GAAG,EAAE,CAAC;YAC/C,CAAC,EAAE,UAAU,CAAC,CAAC;QACjB,CAAC;QACD,QAAQ;QACR,OAAO;YACL,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,QAAQ,KAAK,IAAI;gBAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACxC,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/types.d.ts

@@ -27,6 +27,19 @@ export interface QuotaWindow {
 }
 /** Status of a single provider fetch. */
 export type ProviderStatus = "ok" | "no-auth" | "error" | "skipped" | "loading";
+/** Prepaid credit balance of an account, when the provider exposes it (OpenCode Go). */
+export interface ProviderBalance {
+    /** Available credit in microcents (1e8 microcents = 1 USD), as a decimal string. */
+    availableMicroCents: string;
+    /** Whether usage may draw on credits once a plan limit is reached; null if unknown. */
+    useBalance: boolean | null;
+    /** Auto-recharge settings, when readable. */
+    autoRecharge?: {
+        enabled: boolean;
+        thresholdDollars?: number;
+        rechargeAmountDollars?: number;
+    };
+}
 /** A single provider's quota result. */
 export interface ProviderQuota {
     /** Stable provider id, e.g. "openai", "github-copilot", "opencode-go". */
@@ -41,6 +54,8 @@ export interface ProviderQuota {
     windows: QuotaWindow[];
     /** Timestamp the snapshot was taken. */
     fetchedAt: string;
+    /** Credit balance, when the provider exposes it and the lookup succeeded. */
+    balance?: ProviderBalance;
 }
 /** Aggregate snapshot used by the TUI sidebar and the server tool. */
 export interface CardsSnapshot {

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uEAAuE;AACvE,MAAM,MAAM,QAAQ,GAChB,IAAI,GACJ,QAAQ,GACR,SAAS,GACT,aAAa,GACb,SAAS,CAAC;AAEd,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,EAAE,EAAE,QAAQ,CAAC;IACb,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEd,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uEAAuE;AACvE,MAAM,MAAM,QAAQ,GAChB,IAAI,GACJ,QAAQ,GACR,SAAS,GACT,aAAa,GACb,SAAS,CAAC;AAEd,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,EAAE,EAAE,QAAQ,CAAC;IACb,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEd,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uFAAuF;IACvF,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,6CAA6C;IAC7C,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B"}

package/dist/providers/opencode-go.d.ts

@@ -1,10 +1,13 @@
 /**
  * OpenCode Go quota provider.
  *
- * Fetches usage data by scraping the opencode.ai workspace dashboard.
- * Requires a workspace ID and auth cookie (either via env vars
+ * Fetches usage data from the opencode.ai console API:
+ *   GET https://opencode.ai/console/api/go/status
+ * Requires a workspace ID and session cookie (either via env vars
  * OPENCODE_GO_WORKSPACE_ID / OPENCODE_GO_AUTH_COOKIE, or a sidecar file at
  * ~/.config/opencode/opencode-quota/opencode-go.json).
+ * The session cookie is the browser's `__Host-console_session` (value `st_...`)
+ * sent together with the `x-org-id` header (the `wrk_...` workspace id).
  * Additional instances can be configured via opencode-go-<suffix>.json files,
  * each rendered as its own "Opencode Go <suffix>" section.
  * Returns up to 3 windows: 5h (rolling), Weekly, Monthly.

package/dist/providers/opencode-go.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opencode-go.d.ts","sourceRoot":"","sources":["../../src/providers/opencode-go.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAyC5D,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,yBAAyB,GAAG,QAAQ,CAgFlF;AAED,eAAO,MAAM,kBAAkB,EAAE,QAG/B,CAAC"}
+{"version":3,"file":"opencode-go.d.ts","sourceRoot":"","sources":["../../src/providers/opencode-go.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAuK5D,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,yBAAyB,GAAG,QAAQ,CAkFlF;AAED,eAAO,MAAM,kBAAkB,EAAE,QAG/B,CAAC"}

package/dist/providers/opencode-go.js

@@ -1,27 +1,140 @@
 import { resolveOpenCodeGoInstanceCached } from "../lib/opencode-go-config.js";
 import { fetchWithTimeout } from "../lib/http.js";
 import { clampPercent } from "../lib/reset-format.js";
-const DASHBOARD_URL_PREFIX = "https://opencode.ai/workspace/";
-const DASHBOARD_URL_SUFFIX = "/go";
+const GO_STATUS_URL = "https://opencode.ai/console/api/go/status";
+const BILLING_STATUS_URL = "https://opencode.ai/console/api/billing/status";
+const AUTO_RECHARGE_URL = "https://opencode.ai/console/api/billing/auto-recharge";
 const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Gecko/20100101 Firefox/148.0";
-const WINDOWS = [
-    { field: "rollingUsage", id: "5h", label: "5h" },
-    { field: "weeklyUsage", id: "weekly", label: "Weekly" },
-    { field: "monthlyUsage", id: "monthly", label: "Monthly" },
-];
-const RE_FIELD_PCT_FIRST = (field) => new RegExp(`${field}[^=]*=\\s*\\{[^}]*?usagePercent\\s*:\\s*(\\d+)[^}]*?resetInSec\\s*:\\s*(\\d+)`);
-const RE_FIELD_RESET_FIRST = (field) => new RegExp(`${field}[^=]*=\\s*\\{[^}]*?resetInSec\\s*:\\s*(\\d+)[^}]*?usagePercent\\s*:\\s*(\\d+)`);
-function parseWindow(html, field) {
-    const m1 = html.match(RE_FIELD_PCT_FIRST(field));
-    if (m1 && m1[1] !== undefined && m1[2] !== undefined) {
-        return { usagePercent: Number(m1[1]), resetInSec: Number(m1[2]) };
+/** Parse a microCents value (string or number) into a bigint. */
+function toBigInt(value) {
+    if (typeof value === "bigint")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            return null;
+        return BigInt(Math.trunc(value));
     }
-    const m2 = html.match(RE_FIELD_RESET_FIRST(field));
-    if (m2 && m2[1] !== undefined && m2[2] !== undefined) {
-        return { usagePercent: Number(m2[2]), resetInSec: Number(m2[1]) };
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed === "")
+            return null;
+        try {
+            return BigInt(trimmed);
+        }
+        catch {
+            const n = Number(trimmed);
+            return Number.isFinite(n) ? BigInt(Math.trunc(n)) : null;
+        }
     }
     return null;
 }
+/** Percent used, computed exactly as the opencode.ai dashboard does. */
+function percentUsed(used, limit) {
+    if (limit <= 0n)
+        return 0;
+    return Number((used * 200n + limit) / (limit * 2n));
+}
+/**
+ * Build the Cookie header for the console API. The console authenticates with
+ * the `__Host-console_session` cookie (value `st_...`); older setups stored the
+ * site `auth` cookie (`Fe26....`), so pick the name by value shape.
+ */
+function sessionCookieHeader(value) {
+    const name = value.startsWith("st_") ? "__Host-console_session" : "auth";
+    return `${name}=${value}`;
+}
+/** GET a console JSON endpoint. Errors never carry the response body or headers. */
+async function getConsoleJson(url, headers, timeoutMs) {
+    const res = await fetchWithTimeout(url, { method: "GET", headers }, timeoutMs);
+    if (!res.ok)
+        throw new Error(`HTTP ${res.status}`);
+    return JSON.parse(await res.text());
+}
+/** Parse the `billing/status` body; null when the available credit is unreadable. */
+function parseAvailableMicroCents(data) {
+    if (!data || typeof data !== "object")
+        return null;
+    const value = toBigInt(data.availableMicroCents);
+    return value === null || value < 0n ? null : value.toString();
+}
+/** Parse the `billing/auto-recharge` body; null when it does not carry `enabled`. */
+function parseAutoRecharge(data) {
+    if (!data || typeof data !== "object")
+        return null;
+    const raw = data;
+    if (typeof raw.enabled !== "boolean")
+        return null;
+    const out = { enabled: raw.enabled };
+    if (typeof raw.thresholdDollars === "number" && Number.isFinite(raw.thresholdDollars)) {
+        out.thresholdDollars = raw.thresholdDollars;
+    }
+    if (typeof raw.rechargeAmountDollars === "number" && Number.isFinite(raw.rechargeAmountDollars)) {
+        out.rechargeAmountDollars = raw.rechargeAmountDollars;
+    }
+    return out;
+}
+/**
+ * Credit balance for the account. Both lookups are best-effort: when the
+ * balance itself is missing the result is undefined, and a failed auto-recharge
+ * lookup only drops that sub-field.
+ */
+async function fetchBalance(headers, timeoutMs, useBalance) {
+    const [billing, recharge] = await Promise.allSettled([
+        getConsoleJson(BILLING_STATUS_URL, headers, timeoutMs),
+        getConsoleJson(AUTO_RECHARGE_URL, headers, timeoutMs),
+    ]);
+    if (billing.status !== "fulfilled")
+        return undefined;
+    const availableMicroCents = parseAvailableMicroCents(billing.value);
+    if (availableMicroCents === null)
+        return undefined;
+    const balance = { availableMicroCents, useBalance };
+    if (recharge.status === "fulfilled") {
+        const autoRecharge = parseAutoRecharge(recharge.value);
+        if (autoRecharge)
+            balance.autoRecharge = autoRecharge;
+    }
+    return balance;
+}
+function toIso(value) {
+    if (typeof value !== "string" || value.trim() === "")
+        return undefined;
+    const d = new Date(value);
+    if (Number.isNaN(d.getTime()))
+        return undefined;
+    return d.toISOString();
+}
+function buildWindows(status) {
+    const access = status.access;
+    if (!access || typeof access !== "object")
+        return [];
+    const meters = access.meters ?? {};
+    const specs = [
+        { meter: meters.fiveHour, id: "5h", label: "5h", resetsAt: meters.fiveHour?.resetsAt },
+        { meter: meters.week, id: "weekly", label: "Weekly", resetsAt: meters.week?.resetsAt },
+        { meter: meters.month, id: "monthly", label: "Monthly", resetsAt: access.endsAt },
+    ];
+    const windows = [];
+    for (const spec of specs) {
+        const meter = spec.meter;
+        if (!meter)
+            continue;
+        const limit = toBigInt(meter.limitMicroCents);
+        const used = toBigInt(meter.usedMicroCents);
+        if (limit === null || used === null)
+            continue;
+        const window = {
+            id: spec.id,
+            label: spec.label,
+            percentRemaining: clampPercent(100 - percentUsed(used, limit)),
+        };
+        const resetTimeIso = toIso(spec.resetsAt);
+        if (resetTimeIso)
+            window.resetTimeIso = resetTimeIso;
+        windows.push(window);
+    }
+    return windows;
+}
 export function createOpenCodeGoProvider(opts) {
     const { id, label } = opts;
     return {
@@ -54,46 +167,47 @@ export function createOpenCodeGoProvider(opts) {
                 return { ...base, status: "error", error: `Invalid config: ${r.error}` };
             }
             const { workspaceId, authCookie } = r.config;
+            const headers = {
+                "User-Agent": USER_AGENT,
+                Accept: "application/json",
+                Cookie: sessionCookieHeader(authCookie),
+                "x-org-id": workspaceId,
+            };
             try {
-                const url = `${DASHBOARD_URL_PREFIX}${encodeURIComponent(workspaceId)}${DASHBOARD_URL_SUFFIX}`;
-                const res = await fetchWithTimeout(url, {
-                    method: "GET",
-                    headers: {
-                        "User-Agent": USER_AGENT,
-                        Accept: "text/html",
-                        Cookie: `auth=${authCookie}`,
-                    },
-                }, ctx.requestTimeoutMs);
+                const res = await fetchWithTimeout(GO_STATUS_URL, { method: "GET", headers }, ctx.requestTimeoutMs);
+                const bodyText = await res.text();
                 if (!res.ok) {
-                    const text = (await res.text()).slice(0, 120);
                     return {
                         ...base,
                         status: "error",
-                        error: `OpenCode Go dashboard error ${res.status}: ${text}`,
+                        error: `OpenCode Go API error ${res.status}: ${bodyText.slice(0, 120)}`,
                     };
                 }
-                const html = await res.text();
-                const now = Date.now();
-                const windows = [];
-                for (const spec of WINDOWS) {
-                    const parsed = parseWindow(html, spec.field);
-                    if (!parsed)
-                        continue;
-                    windows.push({
-                        id: spec.id,
-                        label: spec.label,
-                        percentRemaining: clampPercent(100 - parsed.usagePercent),
-                        resetTimeIso: new Date(now + parsed.resetInSec * 1000).toISOString(),
-                    });
+                let data;
+                try {
+                    data = JSON.parse(bodyText);
+                }
+                catch {
+                    return {
+                        ...base,
+                        status: "error",
+                        error: "OpenCode Go API returned invalid JSON",
+                    };
                 }
+                const status = (data ?? {});
+                const windows = buildWindows(status);
                 if (windows.length === 0) {
                     return {
                         ...base,
                         status: "error",
-                        error: "Could not parse any known OpenCode Go dashboard usage windows",
+                        error: status.access
+                            ? "Could not parse any known OpenCode Go usage windows"
+                            : "No active OpenCode Go subscription",
                     };
                 }
-                return { ...base, status: "ok", windows };
+                const useBalance = typeof status.useBalance === "boolean" ? status.useBalance : null;
+                const balance = await fetchBalance(headers, ctx.requestTimeoutMs, useBalance);
+                return { ...base, status: "ok", windows, ...(balance ? { balance } : {}) };
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);