@metyatech/ai-quota 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 metyatech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,221 @@
+# @metyatech/ai-quota
+
+AI agent quota/rate-limit fetching library for Claude, Gemini, Copilot, Amazon Q, and Codex.
+
+This package extracts the **quota fetching** layer from agent-runner so it can be reused
+independently. Gate/ramp evaluation logic (e.g. `evaluateUsageGate`) is intentionally kept
+out of this package — it remains in the calling application.
+
+## CLI
+
+After installing the package globally or via `npx`, run `ai-quota` to check quota for all agents at once.
+
+```bash
+# Install globally
+npm install -g @metyatech/ai-quota
+
+# Or use with npx (no install required)
+npx @metyatech/ai-quota
+```
+
+### Commands
+
+```
+ai-quota [agent]    Show quota for all agents, or a single named agent
+ai-quota --json     Machine-readable JSON output
+ai-quota --quiet    Suppress non-error output (useful in scripts)
+ai-quota --verbose  Print debug info to stderr
+ai-quota --help     Show usage information
+ai-quota --version  Show version
+```
+
+Supported agent names: `claude`, `gemini`, `copilot`, `amazon-q`, `codex`
+
+### Human-readable output example
+
+```
+claude:    72% used  (resets in 3h 12m)
+gemini:    45% used  (resets in 18h)
+copilot:   28% used  (resets in 9d)
+amazon-q:  12/50 requests used
+codex:     38% used  (resets in 6h)
+```
+
+### JSON output example
+
+```bash
+ai-quota --json
+```
+
+```json
+{
+  "claude": { "usedPercent": 72, "resetsAt": "2026-02-19T18:00:00+09:00" },
+  "gemini": { "usedPercent": 45, "resetsAt": "2026-02-20T00:00:00Z" },
+  "copilot": { "usedPercent": 28, "resetsAt": "2026-03-01T00:00:00Z" },
+  "amazon-q": { "used": 12, "limit": 50, "percentRemaining": 76, "resetsAt": "2026-03-01T00:00:00Z" },
+  "codex": { "usedPercent": 38, "resetsAt": "2026-02-19T22:00:00Z" }
+}
+```
+
+### Credential lookup
+
+| Agent     | Source                                                                 |
+|-----------|------------------------------------------------------------------------|
+| Claude    | `~/.claude/.credentials.json`                                          |
+| Gemini    | `~/.gemini/oauth_creds.json`                                           |
+| Copilot   | `GITHUB_TOKEN` env var, or `~/.config/gh/hosts.yml` (gh CLI token)    |
+| Amazon Q  | `AMAZON_Q_STATE_PATH` env var (defaults to `~/agent-runner/state/`)   |
+| Codex     | `~/.codex/sessions/` JSONL files, or `~/.codex/auth.json`             |
+
+Exit code is `0` on success. Exit code `1` if any agent fetch fails.
+
+## Supported agents
+
+| Agent     | Source                                      | API type              |
+|-----------|---------------------------------------------|-----------------------|
+| Claude    | `~/.claude/.credentials.json`               | REST (Anthropic OAuth)|
+| Gemini    | `~/.gemini/oauth_creds.json`                | REST (Google OAuth)   |
+| Copilot   | GitHub token (caller-provided)              | REST (GitHub API)     |
+| Amazon Q  | Local JSON counter file                     | Local state (see note)|
+| Codex     | JSONL session files / ChatGPT backend API   | Local files + REST    |
+
+> **Amazon Q limitation:** Amazon Q Developer (free tier) does not provide a public API for
+> querying usage or quota programmatically as of February 2026. There is no official AWS SDK
+> method, REST endpoint, or CLI command that returns the number of agentic requests consumed
+> against the monthly free-tier limit for Builder ID users. This library uses a local JSON
+> counter file as the best available approach. Call `recordAmazonQUsage` after each Amazon Q
+> invocation to keep the counter accurate.
+
+## Requirements
+
+- Node.js >= 18
+- TypeScript (peer — types are included in the package)
+
+## Installation
+
+```bash
+npm install @metyatech/ai-quota
+```
+
+## Usage
+
+### Claude
+
+```typescript
+import { fetchClaudeRateLimits } from "@metyatech/ai-quota";
+
+const usage = await fetchClaudeRateLimits();
+if (usage) {
+  console.log("5h utilization:", usage.five_hour?.utilization);
+  console.log("7-day utilization:", usage.seven_day?.utilization);
+}
+```
+
+### Gemini
+
+```typescript
+import { fetchGeminiRateLimits } from "@metyatech/ai-quota";
+
+const usage = await fetchGeminiRateLimits();
+if (usage) {
+  const pro = usage["gemini-3-pro-preview"];
+  console.log("Pro used %:", pro?.usage, "/ limit:", pro?.limit);
+}
+```
+
+Set `AGENT_RUNNER_GEMINI_OAUTH_CLIENT_ID` and `AGENT_RUNNER_GEMINI_OAUTH_CLIENT_SECRET` when
+the Gemini CLI is not installed, or extract them from the Gemini CLI source.
+
+### Copilot
+
+```typescript
+import { fetchCopilotRateLimits } from "@metyatech/ai-quota";
+
+const usage = await fetchCopilotRateLimits({ token: process.env.GITHUB_TOKEN! });
+if (usage) {
+  console.log("Percent remaining:", usage.percentRemaining);
+  console.log("Resets at:", usage.resetAt);
+}
+```
+
+Options:
+
+| Option           | Type     | Default                    | Description                              |
+|------------------|----------|----------------------------|------------------------------------------|
+| `token`          | `string` | required                   | GitHub personal access token             |
+| `timeoutSeconds` | `number` | `20`                       | Request timeout in seconds               |
+| `apiBaseUrl`     | `string` | `https://api.github.com`   | Override GitHub API base URL             |
+| `apiVersion`     | `string` | `2025-05-01`               | GitHub API version header                |
+
+### Amazon Q
+
+```typescript
+import {
+  fetchAmazonQRateLimits,
+  recordAmazonQUsage,
+  resolveAmazonQUsageStatePath
+} from "@metyatech/ai-quota";
+
+const statePath = resolveAmazonQUsageStatePath("/path/to/workdir");
+
+// After each Amazon Q invocation:
+recordAmazonQUsage(statePath);
+
+// Check current quota:
+const snapshot = fetchAmazonQRateLimits(statePath, 50 /* monthly limit */);
+console.log("Used:", snapshot.used, "/", snapshot.limit);
+console.log("Remaining:", snapshot.percentRemaining, "%");
+```
+
+### Codex
+
+```typescript
+import { fetchCodexRateLimits, rateLimitSnapshotToStatus } from "@metyatech/ai-quota";
+
+const snapshot = await fetchCodexRateLimits({ codexHome: "~/.codex" });
+if (snapshot) {
+  const status = rateLimitSnapshotToStatus(snapshot);
+  const weekly = status?.windows.find((w) => w.key === "weekly");
+  console.log("Weekly % left:", weekly?.percentLeft);
+}
+```
+
+Options for `fetchCodexRateLimits`:
+
+| Option           | Type       | Default        | Description                              |
+|------------------|------------|----------------|------------------------------------------|
+| `codexHome`      | `string`   | `~/.codex`     | Path to the Codex home directory         |
+| `timeoutSeconds` | `number`   | `20`           | HTTP API fallback timeout in seconds     |
+| `timingSink`     | `function` | none           | Callback for per-phase timing (ms)       |
+
+## Dev commands
+
+```bash
+npm install       # install dependencies
+npm run build     # compile TypeScript to dist/
+npm test          # run tests with vitest
+npm run lint      # ESLint + tsc typecheck
+npm run format    # Prettier format
+npm run verify    # lint + test + build (full CI suite)
+```
+
+## Environment variables
+
+| Variable                              | Used by | Purpose                                         |
+|---------------------------------------|---------|-------------------------------------------------|
+| `AGENT_RUNNER_GEMINI_OAUTH_CLIENT_ID` | Gemini  | Override OAuth client ID when Gemini CLI absent |
+| `AGENT_RUNNER_GEMINI_OAUTH_CLIENT_SECRET` | Gemini | Override OAuth client secret                |
+
+## SemVer policy
+
+Breaking changes (removed/renamed exports, changed function signatures) bump the major version.
+New exports and backward-compatible changes bump the minor version.
+Bug fixes bump the patch version.
+
+## Links
+
+- [CHANGELOG.md](./CHANGELOG.md)
+- [SECURITY.md](./SECURITY.md)
+- [CONTRIBUTING.md](./CONTRIBUTING.md)
+- [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
+- [LICENSE](./LICENSE)

package/dist/amazon-q.d.ts

@@ -0,0 +1,54 @@
+import type { AmazonQUsageSnapshot } from "./types.js";
+export type { AmazonQUsageSnapshot } from "./types.js";
+/**
+ * NOTE: Amazon Q Developer (free tier) does not provide a public API for
+ * querying usage or quota programmatically (as of February 2026). There is
+ * no official AWS SDK method, REST endpoint, or CLI command that returns
+ * the number of agentic requests consumed against the 50-requests/month
+ * free-tier limit for Builder ID users.
+ *
+ * The approach used here — a local JSON counter file — is therefore the
+ * best available strategy. Callers must record each Amazon Q invocation
+ * with `recordAmazonQUsage` to keep the counter accurate.
+ *
+ * If AWS publishes an official API in the future, this file should be
+ * updated to call it (with the local counter as a fallback).
+ */
+type AmazonQUsageState = {
+    periodKey: string;
+    used: number;
+    updatedAt: string;
+};
+/**
+ * Resolves the default state file path for the Amazon Q usage counter.
+ *
+ * @param workdirRoot - The root directory of the agent-runner working directory.
+ */
+export declare function resolveAmazonQUsageStatePath(workdirRoot: string): string;
+/**
+ * Loads the Amazon Q usage state from disk.
+ *
+ * Returns a fresh zeroed state when the file does not exist or when the
+ * stored period key does not match the current month (auto-reset).
+ */
+export declare function loadAmazonQUsageState(statePath: string, now?: Date): AmazonQUsageState;
+/**
+ * Persists Amazon Q usage state to disk.
+ */
+export declare function saveAmazonQUsageState(statePath: string, state: AmazonQUsageState): void;
+/**
+ * Increments the local Amazon Q usage counter by `count` (default 1) and
+ * persists the updated state.
+ *
+ * Call this once per Amazon Q invocation to keep the counter accurate.
+ */
+export declare function recordAmazonQUsage(statePath: string, count?: number, now?: Date): AmazonQUsageState;
+/**
+ * Reads the local counter and returns a quota snapshot.
+ *
+ * The `monthlyLimit` parameter is the configured monthly request limit
+ * (e.g. 50 for the free tier). The snapshot's `percentRemaining` is
+ * computed from `(limit - used) / limit * 100`.
+ */
+export declare function fetchAmazonQRateLimits(statePath: string, monthlyLimit: number, now?: Date): AmazonQUsageSnapshot;
+//# sourceMappingURL=amazon-q.d.ts.map

package/dist/amazon-q.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amazon-q.d.ts","sourceRoot":"","sources":["../src/amazon-q.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AAEH,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAiBF;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,IAAiB,GACrB,iBAAiB,CAkCnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAGvF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAU,EACjB,GAAG,GAAE,IAAiB,GACrB,iBAAiB,CAUnB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,IAAiB,GACrB,oBAAoB,CAatB"}

package/dist/amazon-q.js

@@ -0,0 +1,103 @@
+import fs from "node:fs";
+import path from "node:path";
+function resolveMonthlyPeriodKey(now) {
+    const year = now.getUTCFullYear();
+    const month = now.getUTCMonth() + 1;
+    return `${year}-${String(month).padStart(2, "0")}`;
+}
+function resolveNextMonthlyResetAt(now) {
+    return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1, 0, 0, 0, 0));
+}
+function normalizeUsed(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    return Math.max(0, Math.floor(value));
+}
+/**
+ * Resolves the default state file path for the Amazon Q usage counter.
+ *
+ * @param workdirRoot - The root directory of the agent-runner working directory.
+ */
+export function resolveAmazonQUsageStatePath(workdirRoot) {
+    return path.resolve(workdirRoot, "agent-runner", "state", "amazon-q-usage.json");
+}
+/**
+ * Loads the Amazon Q usage state from disk.
+ *
+ * Returns a fresh zeroed state when the file does not exist or when the
+ * stored period key does not match the current month (auto-reset).
+ */
+export function loadAmazonQUsageState(statePath, now = new Date()) {
+    const currentPeriodKey = resolveMonthlyPeriodKey(now);
+    if (!fs.existsSync(statePath)) {
+        return {
+            periodKey: currentPeriodKey,
+            used: 0,
+            updatedAt: now.toISOString()
+        };
+    }
+    const raw = fs.readFileSync(statePath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") {
+        throw new Error(`Invalid Amazon Q usage state at ${statePath}`);
+    }
+    const record = parsed;
+    const periodKey = typeof record.periodKey === "string" ? record.periodKey : null;
+    const used = normalizeUsed(record.used);
+    const updatedAt = typeof record.updatedAt === "string" ? record.updatedAt : null;
+    if (!periodKey || used === null || !updatedAt) {
+        throw new Error(`Invalid Amazon Q usage state at ${statePath}`);
+    }
+    if (periodKey !== currentPeriodKey) {
+        return {
+            periodKey: currentPeriodKey,
+            used: 0,
+            updatedAt: now.toISOString()
+        };
+    }
+    return { periodKey, used, updatedAt };
+}
+/**
+ * Persists Amazon Q usage state to disk.
+ */
+export function saveAmazonQUsageState(statePath, state) {
+    fs.mkdirSync(path.dirname(statePath), { recursive: true });
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2));
+}
+/**
+ * Increments the local Amazon Q usage counter by `count` (default 1) and
+ * persists the updated state.
+ *
+ * Call this once per Amazon Q invocation to keep the counter accurate.
+ */
+export function recordAmazonQUsage(statePath, count = 1, now = new Date()) {
+    const normalizedCount = Math.max(0, Math.floor(count));
+    const state = loadAmazonQUsageState(statePath, now);
+    const updated = {
+        periodKey: state.periodKey,
+        used: state.used + normalizedCount,
+        updatedAt: now.toISOString()
+    };
+    saveAmazonQUsageState(statePath, updated);
+    return updated;
+}
+/**
+ * Reads the local counter and returns a quota snapshot.
+ *
+ * The `monthlyLimit` parameter is the configured monthly request limit
+ * (e.g. 50 for the free tier). The snapshot's `percentRemaining` is
+ * computed from `(limit - used) / limit * 100`.
+ */
+export function fetchAmazonQRateLimits(statePath, monthlyLimit, now = new Date()) {
+    const state = loadAmazonQUsageState(statePath, now);
+    const used = Math.max(0, state.used);
+    const percentRemaining = monthlyLimit <= 0 ? 0 : Math.min(100, Math.max(0, ((monthlyLimit - used) / monthlyLimit) * 100));
+    return {
+        used,
+        limit: monthlyLimit,
+        percentRemaining,
+        resetAt: resolveNextMonthlyResetAt(now),
+        periodKey: state.periodKey
+    };
+}
+//# sourceMappingURL=amazon-q.js.map

package/dist/amazon-q.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amazon-q.js","sourceRoot":"","sources":["../src/amazon-q.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AA0B7B,SAAS,uBAAuB,CAAC,GAAS;IACxC,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,yBAAyB,CAAC,GAAS;IAC1C,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,WAAmB;IAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,SAAS,EAAE,gBAAgB;YAC3B,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;SAC7B,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,MAAM,GAAG,MAAiC,CAAC;IAEjD,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAEjF,IAAI,CAAC,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,SAAS,KAAK,gBAAgB,EAAE,CAAC;QACnC,OAAO;YACL,SAAS,EAAE,gBAAgB;YAC3B,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;SAC7B,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,KAAwB;IAC/E,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,QAAgB,CAAC,EACjB,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,qBAAqB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,OAAO,GAAsB;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,eAAe;QAClC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;KAC7B,CAAC;IACF,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,YAAoB,EACpB,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,KAAK,GAAG,qBAAqB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,gBAAgB,GACpB,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAEnG,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,YAAY;QACnB,gBAAgB;QAChB,OAAO,EAAE,yBAAyB,CAAC,GAAG,CAAC;QACvC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC"}

package/dist/claude.d.ts

@@ -0,0 +1,10 @@
+import type { ClaudeUsageData } from "./types.js";
+export type { ClaudeUsageData, ClaudeUsageBucket } from "./types.js";
+/**
+ * Fetches Claude usage data from the Anthropic OAuth usage API.
+ *
+ * Returns null when credentials are unavailable, expired, or the request fails.
+ * Credentials are read from `~/.claude/.credentials.json` (Claude desktop app format).
+ */
+export declare function fetchClaudeRateLimits(timeoutMs?: number): Promise<ClaudeUsageData | null>;
+//# sourceMappingURL=claude.d.ts.map

package/dist/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../src/claude.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAiCrE;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAkErG"}

package/dist/claude.js

@@ -0,0 +1,105 @@
+import fs from "node:fs";
+import path from "node:path";
+function getClaudeConfigDir() {
+    const home = process.env.USERPROFILE ?? process.env.HOME ?? "";
+    return path.join(home, ".claude");
+}
+function readClaudeCredentials() {
+    const credsPath = path.join(getClaudeConfigDir(), ".credentials.json");
+    try {
+        if (!fs.existsSync(credsPath))
+            return null;
+        const raw = fs.readFileSync(credsPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        const record = parsed;
+        const oauth = record.claudeAiOauth;
+        if (!oauth || typeof oauth !== "object")
+            return null;
+        const oauthRecord = oauth;
+        const accessToken = typeof oauthRecord.accessToken === "string" && oauthRecord.accessToken.length > 0
+            ? oauthRecord.accessToken
+            : null;
+        const expiresAt = typeof oauthRecord.expiresAt === "number" && Number.isFinite(oauthRecord.expiresAt)
+            ? oauthRecord.expiresAt
+            : null;
+        if (!accessToken || expiresAt === null)
+            return null;
+        return { accessToken, expiresAt };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetches Claude usage data from the Anthropic OAuth usage API.
+ *
+ * Returns null when credentials are unavailable, expired, or the request fails.
+ * Credentials are read from `~/.claude/.credentials.json` (Claude desktop app format).
+ */
+export async function fetchClaudeRateLimits(timeoutMs = 5000) {
+    try {
+        const creds = readClaudeCredentials();
+        if (!creds)
+            return null;
+        // Check token expiry with 5-minute buffer
+        if (Date.now() + 300_000 >= creds.expiresAt)
+            return null;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let res;
+        try {
+            res = await fetch("https://api.anthropic.com/api/oauth/usage", {
+                method: "GET",
+                headers: {
+                    Authorization: `Bearer ${creds.accessToken}`,
+                    "Content-Type": "application/json",
+                    "anthropic-beta": "oauth-2025-04-20"
+                },
+                signal: controller.signal
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        if (!data || typeof data !== "object")
+            return null;
+        const record = data;
+        const parseBucket = (val) => {
+            if (!val || typeof val !== "object")
+                return null;
+            const b = val;
+            const utilization = typeof b.utilization === "number" && Number.isFinite(b.utilization) ? b.utilization : null;
+            const resets_at = typeof b.resets_at === "string" ? b.resets_at : null;
+            if (utilization === null || !resets_at)
+                return null;
+            return { utilization, resets_at };
+        };
+        const parseExtraUsage = (val) => {
+            if (!val || typeof val !== "object")
+                return null;
+            const e = val;
+            const is_enabled = typeof e.is_enabled === "boolean" ? e.is_enabled : false;
+            const monthly_limit = typeof e.monthly_limit === "number" && Number.isFinite(e.monthly_limit)
+                ? e.monthly_limit
+                : null;
+            const used_credits = typeof e.used_credits === "number" && Number.isFinite(e.used_credits) ? e.used_credits : 0;
+            const utilization = typeof e.utilization === "number" && Number.isFinite(e.utilization) ? e.utilization : 0;
+            return { is_enabled, monthly_limit, used_credits, utilization };
+        };
+        return {
+            five_hour: parseBucket(record.five_hour),
+            seven_day: parseBucket(record.seven_day),
+            seven_day_sonnet: parseBucket(record.seven_day_sonnet),
+            extra_usage: parseExtraUsage(record.extra_usage)
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/claude.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+#!/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
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}