website-api 1.1.2 → 1.1.4

package/dist/src/sites/claude.ai/index.js

@@ -0,0 +1,42 @@
+import { defineSite } from "../../core/define-site.js";
+import { fetchOrganizations, selectOrg } from "./claude-helpers.js";
+/**
+ * claude.ai exposes two related endpoints:
+ *   1. `GET /api/organizations`              → the orgs visible to the session
+ *   2. `GET /api/organizations/{id}/usage`   → usage percentages + reset times
+ *
+ * `claude-orgs` exposes the first directly; `claude-usage` chains it — it
+ * resolves the org id (the paid account by default) and then fetches usage.
+ */
+/** First endpoint: list the organizations available to the browser session. */
+const organizations = defineSite({
+    id: "claude-orgs",
+    name: "Claude Organizations",
+    domain: "claude.ai",
+    description: "Lists the Claude organizations available to the logged-in browser session.",
+    endpoints: [{ url: "https://claude.ai/api/organizations" }],
+});
+/** Second endpoint: usage for an org, defaulting to the paid account. */
+const usage = defineSite({
+    id: "claude-usage",
+    name: "Claude Usage",
+    domain: "claude.ai",
+    description: "Fetches Claude usage percentages and reset times for an organization (the paid account by default).",
+    parameters: [
+        {
+            name: "org",
+            type: "string",
+            description: "Organization UUID or name to query (defaults to the paid account, else the first org).",
+        },
+    ],
+    run: async (ctx) => {
+        const orgs = await fetchOrganizations(ctx);
+        const org = selectOrg(orgs, ctx.options.org);
+        const usage = await ctx.http.json(`https://claude.ai/api/organizations/${org.uuid}/usage`);
+        return {
+            organization: { uuid: org.uuid, name: org.name, billing_type: org.billing_type ?? null },
+            usage,
+        };
+    },
+});
+export default [organizations, usage];

package/dist/src/sites/claude.ai/openapi.yaml

@@ -0,0 +1,54 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: Claude Organizations
+  description: Lists the Claude organizations available to the logged-in browser session.
+  version: 1.1.3
+servers:
+  - url: https://claude.ai
+paths:
+  /api/organizations:
+    get:
+      summary: "Claude Organizations: GET /api/organizations"
+      description: Lists the Claude organizations available to the logged-in browser session.
+      operationId: claude_orgs_get__api_organizations
+      responses:
+        "200":
+          description: JSON response body (shape defined by the site, see its transform)
+      security:
+        - chromeSession: []
+components:
+  securitySchemes:
+    chromeSession:
+      type: apiKey
+      in: cookie
+      name: session
+      description: "Authenticated via the user's real Chrome session: website-api injects decrypted Chrome
+        cookies for claude.ai into every request."
+x-website-api:
+  - id: claude-orgs
+    domain: claude.ai
+    cookieDomain: claude.ai
+    transport: http
+    cookies: required
+    requiresLogin: true
+    imperative: false
+    cli:
+      command: website-api claude-orgs
+      positionals: []
+      parameters: []
+  - id: claude-usage
+    domain: claude.ai
+    cookieDomain: claude.ai
+    transport: http
+    cookies: required
+    requiresLogin: true
+    imperative: true
+    cli:
+      command: website-api claude-usage
+      positionals: []
+      parameters:
+        - flag: --org
+          type: string
+          description: Organization UUID or name to query (defaults to the paid account, else the first org).
+          required: false

package/dist/src/sites/cursor.com/index.js

@@ -1 +1,12 @@
-import{defineSite as r}from"../../core/define-site.js";export default r({id:"cursor-usage",name:"Cursor Usage",domain:"cursor.com",description:"Fetches the active Cursor usage summary from the private usage-summary API.",endpoints:[{url:"https://cursor.com/api/usage-summary"}]});
+import { defineSite } from "../../core/define-site.js";
+/**
+ * Cursor.com — active usage summary. Pure declarative single-endpoint site;
+ * the runtime injects cookies + User-Agent and parses JSON.
+ */
+export default defineSite({
+    id: "cursor-usage",
+    name: "Cursor Usage",
+    domain: "cursor.com",
+    description: "Fetches the active Cursor usage summary from the private usage-summary API.",
+    endpoints: [{ url: "https://cursor.com/api/usage-summary" }],
+});

package/dist/src/sites/cursor.com/openapi.yaml

@@ -0,0 +1,39 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: Cursor Usage
+  description: Fetches the active Cursor usage summary from the private usage-summary API.
+  version: 1.1.3
+servers:
+  - url: https://cursor.com
+paths:
+  /api/usage-summary:
+    get:
+      summary: "Cursor Usage: GET /api/usage-summary"
+      description: Fetches the active Cursor usage summary from the private usage-summary API.
+      operationId: cursor_usage_get__api_usage_summary
+      responses:
+        "200":
+          description: JSON response body (shape defined by the site, see its transform)
+      security:
+        - chromeSession: []
+components:
+  securitySchemes:
+    chromeSession:
+      type: apiKey
+      in: cookie
+      name: session
+      description: "Authenticated via the user's real Chrome session: website-api injects decrypted Chrome
+        cookies for cursor.com into every request."
+x-website-api:
+  id: cursor-usage
+  domain: cursor.com
+  cookieDomain: cursor.com
+  transport: http
+  cookies: required
+  requiresLogin: true
+  imperative: false
+  cli:
+    command: website-api cursor-usage
+    positionals: []
+    parameters: []

package/dist/src/sites/e-zpassny.com/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../../types.js").Site;
+export default _default;

package/dist/src/sites/e-zpassny.com/index.js

@@ -0,0 +1,344 @@
+import { defineSite } from "../../core/define-site.js";
+const ORIGIN = "https://www.e-zpassny.com";
+const TRANSACTIONS_URL = `${ORIGIN}/ezpass/dashboard/transactions`;
+const SIGN_IN_URL = `${ORIGIN}/ezpass/sign-in`;
+const TRANSACTION_API = "https://api.e-zpassny.com/api/account/transaction";
+const STATUS_API = "https://api.e-zpassny.com/api/account/statusCall";
+const STATEMENT_API = "https://api.e-zpassny.com/api/account/statement";
+const VIEW_STATEMENT_API = "https://api.e-zpassny.com/api/accounts/viewStatement";
+/**
+ * E-ZPass NY is a Next.js SPA behind Imperva (Incapsula). Auth is NextAuth: a
+ * short-lived (~5h) encrypted session cookie that the front end exchanges for a
+ * Bearer `accessToken` via `/api/auth/session`. The session expires quickly, so
+ * we never reuse cookies — every run logs in fresh through the real browser
+ * (which keeps Imperva happy) and pulls a fresh token.
+ *
+ * Both toll history and payment history come from the SAME endpoint,
+ * `POST /api/account/transaction`. Rows are tagged `isTollorPayment`
+ * ("TOLL" | "PAYMENT"). The endpoint rejects any window longer than 3 calendar
+ * months, so a longer history is stitched together from consecutive windows
+ * (the account allows up to ~730 days / 24 months of lookback).
+ */
+const MS_PER_DAY = 86_400_000;
+const MAX_MONTHS = 24;
+function fmt(d) {
+    const mm = String(d.getMonth() + 1).padStart(2, "0");
+    const dd = String(d.getDate()).padStart(2, "0");
+    return `${mm}/${dd}/${d.getFullYear()}`;
+}
+function addDays(d, days) {
+    return new Date(d.getTime() + days * MS_PER_DAY);
+}
+/** Subtract whole calendar months, clamping the day to the target month length. */
+function subMonths(d, months) {
+    const r = new Date(d.getTime());
+    const targetMonth = r.getMonth() - months;
+    r.setDate(1);
+    r.setMonth(targetMonth);
+    const lastDay = new Date(r.getFullYear(), r.getMonth() + 1, 0).getDate();
+    r.setDate(Math.min(d.getDate(), lastDay));
+    return r;
+}
+/**
+ * Splits `[today - months, today]` into windows the API will accept: each at
+ * most 3 calendar months wide (its hard limit), newest first.
+ */
+function buildWindows(months) {
+    const today = new Date();
+    const bound = subMonths(today, months);
+    const windows = [];
+    let end = today;
+    // Safety stop well above the 24-month cap (8 windows of 3 months = 24 months).
+    for (let i = 0; i < 16 && end.getTime() > bound.getTime(); i++) {
+        // Maximal safe span: 3 calendar months back, then +1 day so we stay strictly
+        // under the "more than 3 months prior" limit.
+        let start = addDays(subMonths(end, 3), 1);
+        if (start.getTime() < bound.getTime())
+            start = bound;
+        windows.push({ start: fmt(start), end: fmt(end) });
+        end = addDays(start, -1);
+    }
+    return windows;
+}
+/** Reads the NextAuth Bearer token from the authenticated page session. */
+async function getAccessToken(page) {
+    const token = await page.evaluate(async () => {
+        const res = await fetch("/api/auth/session", { headers: { accept: "application/json" } });
+        const json = (await res.json());
+        return json?.accessToken ?? "";
+    });
+    if (!token) {
+        throw new Error("No E-ZPass access token — the session is not authenticated. Ensure a saved Chrome password for e-zpassny.com, or complete login in the attached browser.");
+    }
+    return token;
+}
+/** Fetches every transaction (tolls + payments) across the requested windows. */
+async function fetchTransactions(page, token, windows, filter) {
+    return page.evaluate(async ({ apiUrl, token, windows, filter }) => {
+        const all = [];
+        let address = null;
+        for (const w of windows) {
+            const body = {
+                agency: "",
+                startIndex: "1",
+                count: 1000,
+                startDate: w.start,
+                endDate: w.end,
+                searchDate: "Transaction date",
+                type: "",
+                transponderOrPlateNumber: filter.tag ?? "",
+                transactionType: "ALL",
+            };
+            const res = await fetch(apiUrl, {
+                method: "POST",
+                headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+                body: JSON.stringify(body),
+            });
+            const json = (await res.json());
+            if (!res.ok || json.message !== "SUCCESS") {
+                throw new Error(`Transaction API failed for ${w.start}–${w.end}: ${res.status} ${json.message ?? ""}`.trim());
+            }
+            const list = json.transactionList;
+            if (list?.address && !address)
+                address = list.address;
+            for (const t of list?.transaction ?? [])
+                all.push(t);
+        }
+        return { rows: all, address };
+    }, { apiUrl: TRANSACTION_API, token, windows, filter });
+}
+/** Fetches the account summary (balance, plan, contact) — best effort. */
+async function fetchStatus(page, token) {
+    return page.evaluate(async ({ apiUrl, token }) => {
+        try {
+            const res = await fetch(apiUrl, { headers: { authorization: `Bearer ${token}` } });
+            if (!res.ok)
+                return null;
+            return (await res.json());
+        }
+        catch {
+            return null;
+        }
+    }, { apiUrl: STATUS_API, token });
+}
+/**
+ * Lists account statements (monthly PDFs) in a date range. Unlike the
+ * transaction endpoint this accepts the full lookback in a single call.
+ */
+async function fetchStatements(page, token, range) {
+    return page.evaluate(async ({ apiUrl, token, range }) => {
+        const res = await fetch(apiUrl, {
+            method: "POST",
+            headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+            body: JSON.stringify({
+                count: "200",
+                startIndex: "1",
+                startDate: range.start,
+                endDate: range.end,
+            }),
+        });
+        const json = (await res.json());
+        if (!res.ok || json.message !== "SUCCESS") {
+            throw new Error(`Statement API failed: ${res.status} ${json.message ?? ""}`.trim());
+        }
+        return json.statementResponse?.statementList ?? [];
+    }, { apiUrl: STATEMENT_API, token, range });
+}
+/** Downloads one statement PDF and returns its bytes as a base64 string. */
+async function downloadStatementB64(page, token, fileName) {
+    return page.evaluate(async ({ apiUrl, token, fileName }) => {
+        const url = `${apiUrl}?fileId=${encodeURIComponent(fileName)}`;
+        const res = await fetch(url, { headers: { authorization: `Bearer ${token}` } });
+        if (!res.ok)
+            throw new Error(`Statement download failed for ${fileName}: ${res.status}`);
+        const bytes = new Uint8Array(await res.arrayBuffer());
+        let binary = "";
+        const chunk = 0x8000;
+        for (let i = 0; i < bytes.length; i += chunk) {
+            binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+        }
+        return btoa(binary);
+    }, { apiUrl: VIEW_STATEMENT_API, token, fileName });
+}
+/** Resolves a `--download` target into the statements to fetch. */
+function resolveDownloadTargets(statements, target) {
+    const clean = target.trim();
+    if (clean.toLowerCase() === "all")
+        return statements;
+    // A bare number is an index (matching the UI's 1-based displayIndex), NOT a
+    // filename substring — every filename contains digits.
+    if (/^\d+$/.test(clean)) {
+        const byDisplay = statements.find((s) => s.displayIndex === clean);
+        if (byDisplay)
+            return [byDisplay];
+        const idx = Number(clean);
+        if (idx >= 1 && idx <= statements.length)
+            return [statements[idx - 1]];
+        return [];
+    }
+    // Otherwise treat it as an exact / partial filename match.
+    return statements.filter((s) => s.fileName.toLowerCase().includes(clean.toLowerCase()));
+}
+/** De-dupes by stable id and sorts newest first. */
+function dedupeAndSort(rows) {
+    const seen = new Map();
+    for (const r of rows) {
+        const key = String(r.compositeId || r.transactionNumber || JSON.stringify(r));
+        if (!seen.has(key))
+            seen.set(key, r);
+    }
+    const parse = (s) => {
+        // "MM/DD/YYYY HH:mm:ss.SSS" → comparable timestamp.
+        const [date, time = "00:00:00.000"] = String(s).split(" ");
+        const [mm, dd, yyyy] = date.split("/").map(Number);
+        const t = Date.parse(`${yyyy}-${mm}-${dd}T${time}`);
+        return Number.isNaN(t) ? 0 : t;
+    };
+    return [...seen.values()].sort((a, b) => parse(b.transactionDate) - parse(a.transactionDate));
+}
+export default defineSite({
+    id: "ezpassny",
+    name: "E-ZPass New York",
+    domain: "e-zpassny.com",
+    description: "Fetches E-ZPass NY toll/payment history, lists account statements, and downloads statement PDFs (browser transport, logs in fresh each run via your saved Chrome password).",
+    transport: "browser",
+    cookies: "optional",
+    // Keep the authenticated tab open so the short-lived session stays warm.
+    keepBrowserOpen: true,
+    // Declarative single-page login form (captured from /ezpass/sign-in).
+    auth: {
+        intendedUrl: TRANSACTIONS_URL,
+        loginUrl: SIGN_IN_URL,
+        emailSelector: "#login",
+        passwordSelector: "#password",
+        submitButtonSelector: 'button[type="submit"]',
+        expectedRedirectUrlPattern: "**/ezpass/dashboard**",
+        delayMs: 1000,
+    },
+    parameters: [
+        {
+            name: "months",
+            type: "number",
+            description: `Months of history to fetch, 1-${MAX_MONTHS} (default 3)`,
+            default: 3,
+            short: "m",
+        },
+        {
+            name: "payments",
+            type: "boolean",
+            description: "Only payment-history rows (exclude tolls)",
+            short: "p",
+        },
+        {
+            name: "tolls",
+            type: "boolean",
+            description: "Only toll-history rows (exclude payments)",
+            short: "t",
+        },
+        {
+            name: "tag",
+            type: "string",
+            description: "Filter by transponder or license-plate number",
+        },
+        {
+            name: "limit",
+            type: "number",
+            description: "Cap the number of rows returned",
+            short: "l",
+        },
+        {
+            name: "summary",
+            type: "boolean",
+            description: "Include the account summary (balance, plan, contact)",
+            short: "s",
+        },
+        {
+            name: "statements",
+            type: "boolean",
+            description: "List account statements (monthly PDFs) instead of transactions",
+            short: "S",
+        },
+        {
+            name: "download",
+            type: "string",
+            description: 'Download statement PDF(s): a filename, a 1-based index, or "all". Saved to --out-dir or cwd',
+            short: "d",
+        },
+        {
+            name: "out-dir",
+            type: "string",
+            description: "Directory to save downloaded statement PDFs (default: current directory)",
+        },
+    ],
+    run: async (ctx) => {
+        // Triggers CDP connect + fingerprint + auto-login (via the auth config).
+        const page = await ctx.browser();
+        // Make sure we're on an e-zpassny.com origin so the API calls share cookies.
+        if (!page.url().startsWith(ORIGIN)) {
+            await page.goto(TRANSACTIONS_URL, { waitUntil: "domcontentloaded" });
+        }
+        const months = Math.min(Math.max(Number(ctx.options.months) || 3, 1), MAX_MONTHS);
+        const tag = ctx.options.tag ? String(ctx.options.tag).trim() : undefined;
+        const token = await getAccessToken(page);
+        // ── Statements: list, or download PDF(s) ──
+        const wantsStatements = ctx.options.statements || ctx.options.download !== undefined;
+        if (wantsStatements) {
+            const today = new Date();
+            const range = { start: fmt(subMonths(today, months)), end: fmt(today) };
+            const statements = await fetchStatements(page, token, range);
+            if (ctx.options.download === undefined) {
+                return {
+                    range: { months, ...range },
+                    count: statements.length,
+                    statements,
+                };
+            }
+            const targets = resolveDownloadTargets(statements, String(ctx.options.download));
+            if (!targets.length) {
+                const avail = statements.map((s, i) => `${i + 1}) ${s.fileName} (${s.statementPeriod})`).join("\n");
+                throw new Error(`No statement matched "${ctx.options.download}". Available in the last ${months} month(s):\n${avail || "(none)"}`);
+            }
+            const downloaded = [];
+            for (const s of targets) {
+                if (ctx.debug)
+                    console.log(`Downloading ${s.fileName} (${s.statementPeriod})...`);
+                const b64 = await downloadStatementB64(page, token, s.fileName);
+                const buf = Buffer.from(b64, "base64");
+                const path = await ctx.save(s.fileName, buf);
+                downloaded.push({
+                    fileName: s.fileName,
+                    statementPeriod: s.statementPeriod,
+                    bytes: buf.length,
+                    path,
+                });
+            }
+            return { downloaded: downloaded.length, files: downloaded };
+        }
+        // ── Transactions (tolls + payments) ──
+        const windows = buildWindows(months);
+        if (ctx.debug)
+            console.log(`Fetching ${months} month(s) across ${windows.length} window(s)...`);
+        const { rows, address } = await fetchTransactions(page, token, windows, { tag });
+        let transactions = dedupeAndSort(rows);
+        if (ctx.options.payments && !ctx.options.tolls) {
+            transactions = transactions.filter((t) => t.isTollorPayment === "PAYMENT");
+        }
+        else if (ctx.options.tolls && !ctx.options.payments) {
+            transactions = transactions.filter((t) => t.isTollorPayment === "TOLL");
+        }
+        if (ctx.options.limit)
+            transactions = transactions.slice(0, Number(ctx.options.limit));
+        const tollCount = transactions.filter((t) => t.isTollorPayment === "TOLL").length;
+        const paymentCount = transactions.filter((t) => t.isTollorPayment === "PAYMENT").length;
+        const result = {
+            account: address,
+            range: { months, from: windows.at(-1)?.start, to: windows[0]?.end },
+            counts: { total: transactions.length, tolls: tollCount, payments: paymentCount },
+            transactions,
+        };
+        if (ctx.options.summary) {
+            result.summary = await fetchStatus(page, token);
+        }
+        return result;
+    },
+});

package/dist/src/sites/e-zpassny.com/openapi.yaml

@@ -0,0 +1,68 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: E-ZPass New York
+  description: Fetches E-ZPass NY toll/payment history, lists account statements, and downloads
+    statement PDFs (browser transport, logs in fresh each run via your saved Chrome password).
+  version: 1.1.3
+servers:
+  - url: https://e-zpassny.com
+paths: {}
+components:
+  securitySchemes:
+    chromeSession:
+      type: apiKey
+      in: cookie
+      name: session
+      description: "Authenticated via the user's real Chrome session: website-api injects decrypted Chrome
+        cookies for e-zpassny.com into every request."
+x-website-api:
+  id: ezpassny
+  domain: e-zpassny.com
+  cookieDomain: e-zpassny.com
+  transport: browser
+  cookies: optional
+  requiresLogin: true
+  imperative: true
+  cli:
+    command: website-api ezpassny
+    positionals: []
+    parameters:
+      - flag: --months
+        type: number
+        description: Months of history to fetch, 1-24 (default 3)
+        default: 3
+        required: false
+      - flag: --payments
+        type: boolean
+        description: Only payment-history rows (exclude tolls)
+        required: false
+      - flag: --tolls
+        type: boolean
+        description: Only toll-history rows (exclude payments)
+        required: false
+      - flag: --tag
+        type: string
+        description: Filter by transponder or license-plate number
+        required: false
+      - flag: --limit
+        type: number
+        description: Cap the number of rows returned
+        required: false
+      - flag: --summary
+        type: boolean
+        description: Include the account summary (balance, plan, contact)
+        required: false
+      - flag: --statements
+        type: boolean
+        description: List account statements (monthly PDFs) instead of transactions
+        required: false
+      - flag: --download
+        type: string
+        description: 'Download statement PDF(s): a filename, a 1-based index, or "all". Saved to --out-dir
+          or cwd'
+        required: false
+      - flag: --out-dir
+        type: string
+        description: "Directory to save downloaded statement PDFs (default: current directory)"
+        required: false

package/dist/src/sites/gemini.google.com/index.d.ts

@@ -1,5 +1,16 @@
 import { type UniversalGoogleSchema } from "../../util/google-json.js";
 /** Schema mapping Gemini's batchexecute response indices to a usage summary. */
 export declare const GEMINI_USAGE_SCHEMA: UniversalGoogleSchema;
+/**
+ * Pulls the per-session params Gemini embeds in its app HTML (`WIZ_global_data`):
+ *   SNlM0e → `at` anti-forgery token (required for the POST)
+ *   cfb2h  → `bl` backend release id
+ *   FdrFJe → `f.sid` session id
+ */
+export declare function extractWizParams(html: string): {
+    at: string | null;
+    bl: string | null;
+    fsid: string | null;
+};
 declare const _default: import("../../types.js").Site;
 export default _default;

package/dist/src/sites/gemini.google.com/index.js

@@ -1 +1,80 @@
-import{defineSite as e}from"../../core/define-site.js";import{decodeGoogleJsonWithSchema as t}from"../../util/google-json.js";export const GEMINI_USAGE_SCHEMA={planCode:{path:[0]},planName:{path:[0],transform:e=>2===e?"Gemini Pro":1===e?"Gemini Free":`Unknown (${e})`},limits:{path:[1],items:{rawLimit:{path:[0]},percentageUsed:{path:[1],transform:e=>parseFloat((100*e).toFixed(2))},tierName:{path:[2],transform:e=>1===e?"Hourly Usage Limit":2===e?"Weekly Usage Limit":`Unknown Tier (${e})`},resetTime:{path:[3,0,0],transform:e=>e?new Date(1e3*e).toISOString():null}}}};export default e({id:"gemini-usage",name:"Gemini Usage",domain:"gemini.google.com",description:"Fetches Gemini account usage/quota details via browser-attached Playwright.",transport:"browser",cookies:"optional",endpoints:[{url:"https://gemini.google.com/usage"}],run:async e=>{const o=await e.browser(),i=new Promise((e,t)=>{const i=setTimeout(()=>t(new Error("Timeout waiting for Gemini usage RPC payload. Make sure you are logged into gemini.google.com in Chrome.")),15e3);o.on("response",async t=>{if(t.url().includes("jSf9Qc"))try{const o=await t.text();clearTimeout(i),e(o)}catch{}})});e.debug&&console.log("Reloading to capture Gemini usage network request..."),await o.reload({waitUntil:"domcontentloaded"});const a=await i;return t(a,"jSf9Qc",GEMINI_USAGE_SCHEMA)}});
+import { defineSite } from "../../core/define-site.js";
+import { decodeGoogleJsonWithSchema } from "../../util/google-json.js";
+/** Schema mapping Gemini's batchexecute response indices to a usage summary. */
+export const GEMINI_USAGE_SCHEMA = {
+    planCode: { path: [0] },
+    planName: {
+        path: [0],
+        transform: (val) => (val === 2 ? "Gemini Pro" : val === 1 ? "Gemini Free" : `Unknown (${val})`),
+    },
+    limits: {
+        path: [1],
+        items: {
+            rawLimit: { path: [0] },
+            percentageUsed: { path: [1], transform: (val) => parseFloat((val * 100).toFixed(2)) },
+            tierName: {
+                path: [2],
+                transform: (val) => val === 1 ? "Hourly Usage Limit" : val === 2 ? "Weekly Usage Limit" : `Unknown Tier (${val})`,
+            },
+            resetTime: {
+                path: [3, 0, 0],
+                transform: (val) => (val ? new Date(val * 1000).toISOString() : null),
+            },
+        },
+    },
+};
+/** The batchexecute RPC the `/usage` page issues for quota data. */
+const RPC_ID = "jSf9Qc";
+/**
+ * Pulls the per-session params Gemini embeds in its app HTML (`WIZ_global_data`):
+ *   SNlM0e → `at` anti-forgery token (required for the POST)
+ *   cfb2h  → `bl` backend release id
+ *   FdrFJe → `f.sid` session id
+ */
+export function extractWizParams(html) {
+    const grab = (key) => {
+        const match = html.match(new RegExp(`"${key}":"(.*?)"`));
+        return match ? match[1] : null;
+    };
+    return { at: grab("SNlM0e"), bl: grab("cfb2h"), fsid: grab("FdrFJe") };
+}
+export default defineSite({
+    id: "gemini-usage",
+    name: "Gemini Usage",
+    domain: "gemini.google.com",
+    // Auth cookies are scoped to google.com, not the gemini subdomain.
+    cookieDomain: "google.com",
+    description: "Fetches Gemini account usage/quota details directly over HTTP (no browser).",
+    cookies: "required",
+    endpoints: [{ url: "https://gemini.google.com/usage" }],
+    run: async (ctx) => {
+        // 1. Fetch the app shell to read this session's anti-forgery token + backend params.
+        const html = await ctx.http.text("https://gemini.google.com/app");
+        const { at, bl, fsid } = extractWizParams(html);
+        if (!at) {
+            throw new Error("Could not find Gemini session token (SNlM0e). Make sure you are logged into gemini.google.com in Chrome.");
+        }
+        // 2. Replay the batchexecute RPC the /usage page makes for quota data.
+        const query = new URLSearchParams({ rpcids: RPC_ID, "source-path": "/usage", hl: "en", rt: "c" });
+        if (bl)
+            query.set("bl", bl);
+        if (fsid)
+            query.set("f.sid", fsid);
+        const body = new URLSearchParams({
+            "f.req": JSON.stringify([[[RPC_ID, "[]", null, "generic"]]]),
+            at,
+        });
+        if (ctx.debug)
+            console.log("Posting Gemini usage batchexecute request...");
+        const raw = await ctx.http.text(`https://gemini.google.com/_/BardChatUi/data/batchexecute?${query.toString()}`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/x-www-form-urlencoded;charset=UTF-8",
+                "x-same-domain": "1",
+                referer: "https://gemini.google.com/",
+            },
+            body: body.toString(),
+        });
+        return decodeGoogleJsonWithSchema(raw, RPC_ID, GEMINI_USAGE_SCHEMA);
+    },
+});