@metyatech/ai-quota 0.2.0

package/dist/cli.js

@@ -0,0 +1,378 @@
+#!/usr/bin/env node
+/**
+ * ai-quota CLI
+ *
+ * Usage:
+ *   ai-quota [agent]   Show quota for all agents, or a specific agent
+ *   ai-quota --json    Output machine-readable JSON
+ *   ai-quota --help    Show help
+ *   ai-quota --version Show version
+ *
+ * Agents: claude, gemini, copilot, amazon-q, codex
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { fetchClaudeRateLimits } from "./claude.js";
+import { fetchGeminiRateLimits } from "./gemini.js";
+import { fetchCopilotRateLimits } from "./copilot.js";
+import { fetchAmazonQRateLimits, resolveAmazonQUsageStatePath } from "./amazon-q.js";
+import { fetchCodexRateLimits, rateLimitSnapshotToStatus } from "./codex.js";
+// ---------------------------------------------------------------------------
+// Version
+// ---------------------------------------------------------------------------
+function getVersion() {
+    try {
+        const require = createRequire(import.meta.url);
+        const dir = path.dirname(fileURLToPath(import.meta.url));
+        const pkgPath = path.resolve(dir, "..", "package.json");
+        const pkg = require(pkgPath);
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+// ---------------------------------------------------------------------------
+// Time formatting helpers
+// ---------------------------------------------------------------------------
+function formatResetIn(resetAt) {
+    const diffMs = resetAt.getTime() - Date.now();
+    if (diffMs <= 0)
+        return "already reset";
+    const totalMinutes = Math.floor(diffMs / 60000);
+    const hours = Math.floor(totalMinutes / 60);
+    const minutes = totalMinutes % 60;
+    if (hours === 0)
+        return `${minutes}m`;
+    if (minutes === 0)
+        return `${hours}h`;
+    return `${hours}h ${minutes}m`;
+}
+// ---------------------------------------------------------------------------
+// Copilot: resolve token from env or gh CLI hosts.yml
+// ---------------------------------------------------------------------------
+function getCopilotToken() {
+    if (process.env.GITHUB_TOKEN)
+        return process.env.GITHUB_TOKEN;
+    const candidates = [
+        path.join(os.homedir(), ".config", "gh", "hosts.yml"),
+        path.join(os.homedir(), "AppData", "Roaming", "GitHub CLI", "hosts.yml")
+    ];
+    for (const p of candidates) {
+        try {
+            if (!fs.existsSync(p))
+                continue;
+            const content = fs.readFileSync(p, "utf8");
+            // Simple line-by-line search for oauth_token under github.com
+            const match = content.match(/oauth_token:\s*(\S+)/);
+            if (match?.[1])
+                return match[1];
+        }
+        catch {
+            // ignore
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Per-agent fetchers
+// ---------------------------------------------------------------------------
+async function fetchClaude(verbose) {
+    try {
+        const data = await fetchClaudeRateLimits(10000);
+        if (!data) {
+            return {
+                status: "no-data",
+                display: "no data",
+                json: { error: null, data: null }
+            };
+        }
+        // Use the five_hour bucket as primary display metric
+        const bucket = data.five_hour ?? data.seven_day;
+        if (!bucket) {
+            return {
+                status: "no-data",
+                display: "no data",
+                json: { data }
+            };
+        }
+        const usedPercent = Math.round(bucket.utilization);
+        const resetAt = new Date(bucket.resets_at);
+        const resetIn = formatResetIn(resetAt);
+        const display = `${usedPercent}% used  (resets in ${resetIn})`;
+        if (verbose) {
+            process.stderr.write(`[verbose] claude: five_hour=${JSON.stringify(data.five_hour)} seven_day=${JSON.stringify(data.seven_day)}\n`);
+        }
+        return {
+            status: "ok",
+            display,
+            json: {
+                usedPercent,
+                resetsAt: resetAt.toISOString(),
+                five_hour: data.five_hour,
+                seven_day: data.seven_day,
+                seven_day_sonnet: data.seven_day_sonnet,
+                extra_usage: data.extra_usage
+            }
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { status: "error", display: `error: ${msg}`, json: { error: msg } };
+    }
+}
+async function fetchGemini(verbose) {
+    try {
+        const data = await fetchGeminiRateLimits();
+        if (!data) {
+            return { status: "no-data", display: "no data", json: { error: null, data: null } };
+        }
+        const pro = data["gemini-3-pro-preview"];
+        const flash = data["gemini-3-flash-preview"];
+        const primary = pro ?? flash;
+        if (!primary) {
+            return { status: "no-data", display: "no data", json: { data } };
+        }
+        const usedPercent = Math.round(primary.usage);
+        const resetAt = primary.resetAt;
+        const resetIn = formatResetIn(resetAt);
+        const display = `${usedPercent}% used  (resets in ${resetIn})`;
+        if (verbose) {
+            process.stderr.write(`[verbose] gemini: pro=${JSON.stringify(pro)} flash=${JSON.stringify(flash)}\n`);
+        }
+        const jsonData = { usedPercent, resetsAt: resetAt.toISOString() };
+        if (pro) {
+            jsonData["gemini-3-pro-preview"] = {
+                usedPercent: Math.round(pro.usage),
+                resetsAt: pro.resetAt.toISOString()
+            };
+        }
+        if (flash) {
+            jsonData["gemini-3-flash-preview"] = {
+                usedPercent: Math.round(flash.usage),
+                resetsAt: flash.resetAt.toISOString()
+            };
+        }
+        return { status: "ok", display, json: jsonData };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { status: "error", display: `error: ${msg}`, json: { error: msg } };
+    }
+}
+async function fetchCopilot(verbose) {
+    try {
+        const token = getCopilotToken();
+        if (!token) {
+            return {
+                status: "no-data",
+                display: "no data  (set GITHUB_TOKEN or sign in with gh CLI)",
+                json: { error: null, data: null }
+            };
+        }
+        const data = await fetchCopilotRateLimits({ token, timeoutSeconds: 10 });
+        if (!data) {
+            return { status: "no-data", display: "no data", json: { error: null, data: null } };
+        }
+        const usedPercent = Math.round(100 - data.percentRemaining);
+        const resetIn = formatResetIn(data.resetAt);
+        const display = `${usedPercent}% used  (resets in ${resetIn})`;
+        if (verbose) {
+            process.stderr.write(`[verbose] copilot: percentRemaining=${data.percentRemaining} entitlement=${data.entitlement} resetAt=${data.resetAt.toISOString()}\n`);
+        }
+        return {
+            status: "ok",
+            display,
+            json: {
+                usedPercent,
+                resetsAt: data.resetAt.toISOString(),
+                percentRemaining: data.percentRemaining,
+                entitlement: data.entitlement,
+                overageUsed: data.overageUsed,
+                overageEnabled: data.overageEnabled
+            }
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { status: "error", display: `error: ${msg}`, json: { error: msg } };
+    }
+}
+async function fetchAmazonQ(verbose) {
+    try {
+        const statePathEnv = process.env.AMAZON_Q_STATE_PATH;
+        const statePath = statePathEnv
+            ? statePathEnv
+            : resolveAmazonQUsageStatePath(os.homedir());
+        const monthlyLimit = 50;
+        const snapshot = fetchAmazonQRateLimits(statePath, monthlyLimit);
+        const display = `${snapshot.used}/${snapshot.limit} requests used`;
+        if (verbose) {
+            process.stderr.write(`[verbose] amazon-q: statePath=${statePath} used=${snapshot.used} limit=${snapshot.limit} period=${snapshot.periodKey}\n`);
+        }
+        return {
+            status: "ok",
+            display,
+            json: {
+                used: snapshot.used,
+                limit: snapshot.limit,
+                percentRemaining: snapshot.percentRemaining,
+                resetsAt: snapshot.resetAt.toISOString(),
+                periodKey: snapshot.periodKey
+            }
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { status: "error", display: `error: ${msg}`, json: { error: msg } };
+    }
+}
+async function fetchCodex(verbose) {
+    try {
+        const snapshot = await fetchCodexRateLimits({ timeoutSeconds: 10 });
+        if (!snapshot) {
+            return { status: "no-data", display: "no data", json: { error: null, data: null } };
+        }
+        const status = rateLimitSnapshotToStatus(snapshot);
+        if (!status || status.windows.length === 0) {
+            return { status: "no-data", display: "no data", json: { error: null, data: null } };
+        }
+        // Use the shortest window (five-hour) as primary display metric
+        const win = status.windows.find((w) => w.key === "fiveHour") ?? status.windows[0];
+        if (!win) {
+            return { status: "no-data", display: "no data", json: { error: null, data: null } };
+        }
+        const usedPercent = Math.round(100 - win.percentLeft);
+        const resetIn = formatResetIn(win.resetAt);
+        const display = `${usedPercent}% used  (resets in ${resetIn})`;
+        if (verbose) {
+            process.stderr.write(`[verbose] codex: windows=${JSON.stringify(status.windows)}\n`);
+        }
+        const jsonData = {
+            usedPercent,
+            resetsAt: win.resetAt.toISOString()
+        };
+        for (const w of status.windows) {
+            jsonData[w.key] = {
+                usedPercent: Math.round(100 - w.percentLeft),
+                resetsAt: w.resetAt.toISOString()
+            };
+        }
+        return { status: "ok", display, json: jsonData };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { status: "error", display: `error: ${msg}`, json: { error: msg } };
+    }
+}
+// ---------------------------------------------------------------------------
+// All agents registry
+// ---------------------------------------------------------------------------
+const ALL_AGENTS = ["claude", "gemini", "copilot", "amazon-q", "codex"];
+async function runAgent(name, verbose) {
+    switch (name) {
+        case "claude":
+            return fetchClaude(verbose);
+        case "gemini":
+            return fetchGemini(verbose);
+        case "copilot":
+            return fetchCopilot(verbose);
+        case "amazon-q":
+            return fetchAmazonQ(verbose);
+        case "codex":
+            return fetchCodex(verbose);
+    }
+}
+// ---------------------------------------------------------------------------
+// Output helpers
+// ---------------------------------------------------------------------------
+function padName(name) {
+    // Align to the longest agent name ("amazon-q") + colon = 9 chars, then 2 spaces
+    return (name + ":").padEnd(11);
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+async function main() {
+    const args = process.argv.slice(2);
+    // --help / -h
+    if (args.includes("--help") || args.includes("-h")) {
+        const version = getVersion();
+        process.stdout.write(`ai-quota v${version}\n\n` +
+            "Usage:\n" +
+            "  ai-quota [agent]   Show quota for all agents, or a specific agent\n" +
+            "  ai-quota --json    Output machine-readable JSON\n" +
+            "  ai-quota --quiet   Suppress non-error output\n" +
+            "  ai-quota --verbose Show extra debug info on stderr\n" +
+            "  ai-quota --help    Show this help message\n" +
+            "  ai-quota --version Show version\n\n" +
+            "Agents: claude, gemini, copilot, amazon-q, codex\n\n" +
+            "Credentials:\n" +
+            "  Claude:    ~/.claude/.credentials.json\n" +
+            "  Gemini:    ~/.gemini/oauth_creds.json\n" +
+            "  Copilot:   GITHUB_TOKEN env var or gh CLI (~/.config/gh/hosts.yml)\n" +
+            "  Amazon Q:  AMAZON_Q_STATE_PATH env var (defaults to ~/agent-runner/state/)\n" +
+            "  Codex:     ~/.codex/sessions/ or ~/.codex/auth.json\n\n" +
+            "Examples:\n" +
+            "  ai-quota\n" +
+            "  ai-quota claude\n" +
+            "  ai-quota --json\n" +
+            "  ai-quota copilot --json\n");
+        process.exit(0);
+    }
+    // --version / -V
+    if (args.includes("--version") || args.includes("-V")) {
+        process.stdout.write(`${getVersion()}\n`);
+        process.exit(0);
+    }
+    const jsonMode = args.includes("--json");
+    const quiet = args.includes("--quiet");
+    const verbose = args.includes("--verbose");
+    // Collect positional agent names (everything not a flag)
+    const positional = args.filter((a) => !a.startsWith("--") && a !== "-h" && a !== "-V");
+    // Validate agent names
+    const requested = [];
+    for (const a of positional) {
+        if (!ALL_AGENTS.includes(a)) {
+            process.stderr.write(`ai-quota: unknown agent '${a}'. Valid agents: ${ALL_AGENTS.join(", ")}\n`);
+            process.exit(1);
+        }
+        requested.push(a);
+    }
+    const agentsToRun = requested.length > 0 ? requested : [...ALL_AGENTS];
+    // Run all fetchers in parallel
+    const results = await Promise.all(agentsToRun.map(async (name) => ({
+        name,
+        result: await runAgent(name, verbose)
+    })));
+    let anyError = false;
+    if (jsonMode) {
+        const out = {};
+        for (const { name, result } of results) {
+            out[name] = result.json;
+            if (result.status === "error")
+                anyError = true;
+        }
+        if (!quiet) {
+            process.stdout.write(JSON.stringify(out, null, 2) + "\n");
+        }
+    }
+    else {
+        for (const { name, result } of results) {
+            if (result.status === "error")
+                anyError = true;
+            if (!quiet) {
+                process.stdout.write(`${padName(name)} ${result.display}\n`);
+            }
+        }
+    }
+    process.exit(anyError ? 1 : 0);
+}
+main().catch((err) => {
+    process.stderr.write(`ai-quota: fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/codex.d.ts

@@ -0,0 +1,38 @@
+import type { RateLimitSnapshot } from "./types.js";
+export type { RateLimitSnapshot, RateLimitWindow } from "./types.js";
+export type UsageWindowKey = "fiveHour" | "weekly";
+export type UsageWindow = {
+    key: UsageWindowKey;
+    label: string;
+    percentLeft: number;
+    resetAt: Date;
+    resetText: string;
+};
+export type CodexStatus = {
+    windows: UsageWindow[];
+    credits: number | null;
+    raw: string;
+};
+export type FetchCodexRateLimitsOptions = {
+    codexHome?: string;
+    timeoutSeconds?: number;
+    timingSink?: (phase: string, durationMs: number) => void;
+};
+/**
+ * Converts a raw `RateLimitSnapshot` (from JSONL session files or the HTTP
+ * API) into a structured `CodexStatus` with labelled usage windows.
+ */
+export declare function rateLimitSnapshotToStatus(snapshot: RateLimitSnapshot, now?: Date): CodexStatus | null;
+/**
+ * Fetches Codex (ChatGPT) rate limit data.
+ *
+ * Strategy (in order):
+ * 1. Read rate_limits from the most recent JSONL session file in
+ *    `~/.codex/sessions/YYYY/MM/DD/*.jsonl` (last 7 days).
+ * 2. If no session data is found, call the ChatGPT backend API using the
+ *    access token from `~/.codex/auth.json`.
+ *
+ * Returns null when no data source is available or all requests fail.
+ */
+export declare function fetchCodexRateLimits(options?: FetchCodexRateLimitsOptions): Promise<RateLimitSnapshot | null>;
+//# sourceMappingURL=codex.d.ts.map

package/dist/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../src/codex.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AAErE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D,CAAC;AA4DF;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,GAAE,IAAiB,GACrB,WAAW,GAAG,IAAI,CAwEpB;AAwND;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA6BnC"}