@slkiser/opencode-quota 3.11.1 → 4.0.0

package/README.md

@@ -7,7 +7,7 @@
     </picture>
   </a>
 </p>
-<p align="center">Quota, usage, and token visibility for OpenCode and CLI.</p>
+<p align="center">Quota, usage, and token visibility in OpenCode and your terminal.</p>
 <p align="center">
   <a href="https://www.npmjs.com/package/@slkiser/opencode-quota"><img alt="npm" src="https://img.shields.io/npm/v/%40slkiser%2Fopencode-quota?style=flat-square" /></a>
   <a href="https://www.npmjs.com/package/@slkiser/opencode-quota"><img alt="npm downloads" src="https://img.shields.io/npm/dm/%40slkiser%2Fopencode-quota?style=flat-square" /></a>
@@ -26,14 +26,32 @@ npx @slkiser/opencode-quota init
 ```
 
 > [!IMPORTANT]
-> OpenCode `>= 1.4.3` and Node.js `>= 20` are required.
+> Node.js `>= 22` is required.
+
+Upgrading from v3? Read the [v4 migration guide](docs/readme/v4-migration.md).
+
+After installation:
 
 1. Restart OpenCode.
-2. Run `/quota` in OpenCode, or use `opencode-quota show` from your terminal.
-3. If you enabled the Sidebar panel, open the session sidebar and look for `Quota`.
-4. If you enabled Compact status line, look for the home-bottom quota line and the chat/session prompt quota line.
+2. Run a slash command in OpenCode, or use `opencode-quota show` from your terminal.
+3. If you enabled the sidebar, open the session sidebar and look for `Quota`.
+4. If you enabled the compact status line, look at the bottom of Home or below the message input.
 5. If something looks wrong, run `/quota_status` in OpenCode or see [Troubleshooting](docs/readme/troubleshooting.md).
 
+## Updating
+
+1. Close OpenCode.
+2. Run:
+
+   ```bash
+   npx @slkiser/opencode-quota@latest update
+   ```
+
+3. Review the exact config edits and cache directories, then confirm.
+4. Restart OpenCode.
+
+Use `--dry-run` to preview without changing anything. Otherwise, `update` shows the OpenCode Quota config and cache changes and asks before applying them. It leaves your other plugins and settings alone. Use `--yes` only when you intentionally need a noninteractive run.
+
 ## What you get
 
 <table>
@@ -47,7 +65,7 @@ npx @slkiser/opencode-quota init
   </tr>
   <tr>
     <td width="50%" align="center"><strong>Sidebar panel</strong><br />A full quota view in OpenCode's session sidebar.</td>
-    <td width="50%" align="center"><strong>Toast</strong><br />Popup quota checks after idle, question, or compact events.</td>
+    <td width="50%" align="center"><strong>TUI toast</strong><br />Quota checks can appear automatically while you work.</td>
   </tr>
   <tr>
     <td width="50%">
@@ -58,17 +76,17 @@ npx @slkiser/opencode-quota init
     </td>
   </tr>
   <tr>
-    <td width="50%" align="center"><strong>Compact status line</strong><br />Short quota text on home and chat/session prompt surfaces.</td>
+    <td width="50%" align="center"><strong>Compact status line</strong><br />Short quota text on Home and below the message input.</td>
     <td width="50%" align="center"><strong>Token reports</strong><br /><code>/tokens_today</code>, <code>/tokens_weekly</code>, session reports, and more.</td>
   </tr>
 </table>
 
 More ways to use it:
 
-- Terminal checks with `opencode-quota show` before or without opening OpenCode
-- JSON output for scripts, status bars, CI checks, and external tools
-- Local TUI dialogs for slash commands when the TUI plugin is installed
-- Provider diagnostics for auth, quota sources, pricing, and bundled maintainer announcements
+- Check quota from a terminal with `opencode-quota show`
+- Use JSON output in scripts, status bars, CI checks, and other tools
+- Run the same slash commands in the TUI, Web, and Desktop
+- Diagnose authentication, quota sources, pricing, and maintainer notices
 
 See [Configuration](docs/readme/configuration.md) for UI options and [Manual install](docs/readme/manual-install.md) for setup details.
 
@@ -76,62 +94,79 @@ See [Configuration](docs/readme/configuration.md) for UI options and [Manual ins
 
 ### Core slash commands
 
-| Command | Use when |
-| --- | --- |
-| `/quota` | Show your quota and usage details |
-| `/quota_status` | Diagnose setup, auth, provider detection, pricing, and announcements |
-| `/quota_announcements` | Read active bundled maintainer notices |
-| `/pricing_refresh` | Refresh local runtime pricing from `models.dev` |
-| `/tokens_today` | Show tokens used today |
-| `/tokens_daily` | Show tokens used in the last 24 hours |
-| `/tokens_weekly` | Show tokens used in the last 7 days |
-| `/tokens_monthly` | Show tokens used in the last 30 days, including pricing |
-| `/tokens_all` | Show tokens used across all local history |
-| `/tokens_session` | Show tokens used in the current session |
-| `/tokens_session_all` | Show current session plus descendant sessions |
-| `/tokens_between YYYY-MM-DD YYYY-MM-DD` | Show tokens used between two dates |
+| Command                                 | Use when                                                        |
+| --------------------------------------- | --------------------------------------------------------------- |
+| `/quota`                                | Show current quota                                              |
+| `/quota_status`                         | Diagnose setup, authentication, providers, pricing, and notices |
+| `/quota_announcements`                  | Read active bundled maintainer notices                          |
+| `/pricing_refresh`                      | Refresh local runtime pricing from `models.dev`                 |
+| `/tokens_today`                         | Show tokens used today                                          |
+| `/tokens_daily`                         | Show tokens used in the last 24 hours                           |
+| `/tokens_weekly`                        | Show tokens used in the last 7 days                             |
+| `/tokens_monthly`                       | Show tokens used in the last 30 days, including pricing         |
+| `/tokens_all`                           | Show tokens used across all local history                       |
+| `/tokens_session`                       | Show tokens used in the current session                         |
+| `/tokens_session_all`                   | Show current session plus descendant sessions                   |
+| `/tokens_between YYYY-MM-DD YYYY-MM-DD` | Show tokens used between two dates                              |
 
 ### CLI commands
 
-| Command | Use when |
-| --- | --- |
-| `opencode-quota show` | Check quota from your terminal |
-| `opencode-quota show --provider <id>` | Check one provider only, such as `copilot` or `openai` |
-| `opencode-quota show --json` | Print JSON for scripts, status bars, and other tools |
-| `opencode-quota show --json --threshold <pct>` | Fail the command when cached quota drops below your chosen percentage |
+Use the CLI for scripts, CI, or a quick terminal check outside OpenCode.
+
+| Command                                        | Use when                                                     |
+| ---------------------------------------------- | ------------------------------------------------------------ |
+| `opencode-quota init --dry-run`                | Validate and preview installer changes without writing files |
+| `opencode-quota update`                        | Preview, confirm, and apply a scoped OpenCode Quota update   |
+| `opencode-quota update --dry-run`              | Preview exact config and cache targets without changing them |
+| `opencode-quota show`                          | Check quota from your terminal                               |
+| `opencode-quota show --provider <id>`          | Check one provider only, such as `copilot` or `openai`       |
+| `opencode-quota show --json`                   | Print JSON for scripts, status bars, and other tools         |
+| `opencode-quota show --json --threshold <pct>` | Fail when quota is low; return exit 2 for incomplete results |
 
 ## Providers
 
+### Pre-configured providers
+
 Most providers work automatically. If a provider has a “Needs setup” link, open that setup note only if you use that provider.
 
-| Provider | Auth/setup | Source | Reports |
-| --- | --- | --- | --- |
-| Anthropic (Claude) | [Needs setup](docs/readme/providers.md#anthropic-claude) | Local CLI/OAuth | Usage/quota |
-| GitHub Copilot | OpenCode OAuth or PAT | Remote API | Quota/usage |
-| OpenAI | Automatic | Remote API | Usage/quota |
-| Cursor | [Needs setup](docs/readme/providers.md#cursor) | Local estimate | Estimated quota |
-| Qwen Code | [Needs setup](docs/readme/providers.md#qwen-code) | Local estimate | Estimated quota |
-| Alibaba Coding Plan | OpenCode config | Local estimate | Estimated quota |
-| MiniMax Coding Plan | OpenCode config | Remote API | Usage/quota |
-| MiniMax Coding Plan (CN) | OpenCode config | Remote API | Usage/quota |
-| Kimi Code | OpenCode config | Remote API | Usage/quota |
-| Chutes AI | API key/config | Remote API | Usage/quota |
-| Synthetic | Automatic | Remote API | Quota |
-| Google Antigravity | [Needs setup](docs/readme/providers.md#google-antigravity) | Remote API | Usage/quota |
-| Google AGY | [Needs setup](docs/readme/providers.md#google-agy-quick-setup) | Remote API | Usage/quota |
-| Gemini CLI | [Needs setup](docs/readme/providers.md#gemini-cli) | Remote API | Usage/quota |
-| Z.ai Coding Plan | OpenCode config | Remote API | Usage/quota |
-| Zhipu Coding Plan | OpenCode config | Remote API | Usage/quota |
-| NanoGPT | API key/config | Remote API | Usage + balance |
-| DeepSeek | API key/config | Remote API | Balance/status |
-| Ollama Cloud | [Needs setup](docs/readme/providers.md#ollama-cloud) | Dashboard scraping | Dashboard usage |
-| OpenCode Go | [Needs setup](docs/readme/providers.md#opencode-go) | Dashboard scraping | Dashboard usage |
-
-Setup details live in the [Provider setup guide](docs/readme/providers.md).
+| Provider                 | Auth/setup                                                     | Data from          | Reports            |
+| ------------------------ | -------------------------------------------------------------- | ------------------ | ------------------ |
+| Anthropic (Claude)       | [Needs setup](docs/readme/providers.md#anthropic-claude)       | Local CLI/OAuth    | Quota              |
+| GitHub Copilot           | [Needs setup](docs/readme/providers.md#github-copilot)         | Remote API         | Usage and budget   |
+| OpenAI                   | Automatic                                                      | Remote API         | Quota              |
+| Cursor                   | [Needs setup](docs/readme/providers.md#cursor)                 | Local estimate     | Budget and spend   |
+| Qwen Code                | [Needs setup](docs/readme/providers.md#qwen-code)              | Local estimate     | Quota              |
+| Alibaba Coding Plan      | OpenCode config                                                | Local estimate     | Quota              |
+| MiniMax Coding Plan      | OpenCode config                                                | Remote API         | Quota              |
+| MiniMax Coding Plan (CN) | OpenCode config                                                | Remote API         | Quota              |
+| Kimi Code                | OpenCode config                                                | Remote API         | Quota              |
+| Chutes AI                | API key/config                                                 | Remote API         | Quota              |
+| Synthetic                | Automatic                                                      | Remote API         | Quota              |
+| Google Antigravity       | [Needs setup](docs/readme/providers.md#google-antigravity)     | Remote API         | Quota              |
+| Google AGY               | [Needs setup](docs/readme/providers.md#google-agy-quick-setup) | Remote API         | Quota              |
+| Gemini CLI               | [Needs setup](docs/readme/providers.md#gemini-cli)             | Remote API         | Quota              |
+| Z.ai Coding Plan         | OpenCode config                                                | Remote API         | Quota              |
+| Zhipu Coding Plan        | OpenCode config                                                | Remote API         | Quota              |
+| NanoGPT                  | API key/config                                                 | Remote API         | Quota and balance  |
+| DeepSeek                 | API key/config                                                 | Remote API         | Balance and status |
+| Ollama Cloud             | [Needs setup](docs/readme/providers.md#ollama-cloud)           | Dashboard scraping | Quota              |
+| OpenCode Go              | [Needs setup](docs/readme/providers.md#opencode-go)            | Dashboard scraping | Quota              |
+
+The quota view uses short labels such as `Day quota`, `5h quota`, `Day budget`, and `Balance`. Bar width varies by surface. JSON keeps the precise accounting type for scripts.
+
+### Custom providers
+
+A quota provider definition tells OpenCode Quota how to obtain accounting data for an OpenCode provider. Run the guided command. It asks only structural questions, previews the exact global OpenCode config change, and asks before writing:
+
+```bash
+npx @slkiser/opencode-quota@latest provider add
+```
+
+Setup details live in the [Provider setup guide](docs/readme/providers.md#custom-providers).
 
 ## Troubleshooting
 
-Start here when quota or token data looks wrong:
+If quota or token data looks wrong:
 
 1. Run `/quota_status`, or start with `opencode-quota show` for a terminal quota summary.
 2. Confirm the expected provider appears in the detected provider list.
@@ -141,12 +176,23 @@ Start here when quota or token data looks wrong:
 
 ## Reference
 
+Project guides:
+
 - [Manual install](docs/readme/manual-install.md)
 - [Configuration](docs/readme/configuration.md)
 - [Providers](docs/readme/providers.md)
 - [Troubleshooting](docs/readme/troubleshooting.md)
 - [External integration](docs/readme/external-integration.md)
 
+External references:
+
+- [OpenCode docs](https://opencode.ai/docs/)
+- [OpenCode config](https://opencode.ai/docs/config/)
+- [OpenCode plugins](https://opencode.ai/docs/plugins/)
+- [OpenCode TUI](https://opencode.ai/docs/tui/)
+- [models.dev pricing data](https://models.dev/)
+- [Node.js downloads](https://nodejs.org/en/download)
+
 ## Contributors
 
 Thanks to everyone who has contributed to OpenCode Quota.
@@ -165,4 +211,4 @@ OpenCode Quota is not built by the OpenCode team and is not affiliated with Open
 
 ## Star history
 
-[![Star History Chart](https://api.star-history.com/chart?repos=slkiser/opencode-quota&type=date&legend=bottom-right)](https://www.star-history.com/?repos=slkiser%2Fopencode-quota&type=date&legend=bottom-right)
+![Star History Chart](https://shawnkiser.com/opencode-quota/star-history-2026710.webp)

package/dist/bin/opencode-quota.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opencode-quota.d.ts","sourceRoot":"","sources":["../../src/bin/opencode-quota.ts"],"names":[],"mappings":";AAmCA,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,MAAM,GAAG,SAA2B,EAC3C,UAAU,GAAE,MAAuC,EACnD,WAAW,GAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAuB,GACzD,OAAO,CAMT;AAED,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BxE"}
+{"version":3,"file":"opencode-quota.d.ts","sourceRoot":"","sources":["../../src/bin/opencode-quota.ts"],"names":[],"mappings":";AA2CA,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,MAAM,GAAG,SAA2B,EAC3C,UAAU,GAAE,MAAuC,EACnD,WAAW,GAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAuB,GACzD,OAAO,CAMT;AAED,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCxE"}

package/dist/bin/opencode-quota.js

@@ -5,17 +5,25 @@ import { fileURLToPath } from "node:url";
 import { runInitInstaller } from "../lib/init-installer.js";
 const USAGE = [
     "Usage:",
-    "  npx @slkiser/opencode-quota init [--sync-legacy-config]",
+    "  npx @slkiser/opencode-quota init [--dry-run] [--sync-legacy-config]",
     "  npx @slkiser/opencode-quota show [--provider <provider-id>] [--json] [--threshold <pct>]",
+    "  npx @slkiser/opencode-quota update [--dry-run] [--yes]",
+    "  npx @slkiser/opencode-quota provider add [--dry-run]",
     "  npx @slkiser/opencode-quota --help",
     "",
     "Commands:",
     "  init    Run the interactive quota installer",
+    "          --dry-run            Preview validated changes without writing files",
     "          --sync-legacy-config also writes experimental.quotaToast",
     "  show    Print a quick quota glance",
     "          --json               Machine-readable JSON output (reads from cache)",
-    "          --threshold <pct>    With --json, exit 1 if below <pct>%, 2 if no cached quota",
+    "          --threshold <pct>    With --json, exit 1 if below <pct>%, 2 if incomplete/not comparable",
     "          --provider <id>      Filter to one provider",
+    "  update  Safely refresh only OpenCode Quota config and verified cache entries",
+    "          --dry-run            Preview without changing config or cache",
+    "          --yes                Apply noninteractively after printing the preview",
+    "  provider add  Add or update one global quotaProviders definition",
+    "          --dry-run            Preview the exact global OpenCode config without writing",
 ].join("\n");
 function printUsage() {
     console.log(USAGE);
@@ -45,17 +53,26 @@ export async function main(argv = process.argv.slice(2)) {
         return 0;
     }
     if (command === "init") {
-        if (rest.length === 0) {
-            return await runInitInstaller();
-        }
-        if (rest.length === 1 && rest[0] === "--sync-legacy-config") {
-            return await runInitInstaller({ syncLegacyConfig: true });
+        const allowed = new Set(["--dry-run", "--sync-legacy-config"]);
+        if (rest.every((arg) => allowed.has(arg)) && new Set(rest).size === rest.length) {
+            return await runInitInstaller({
+                ...(rest.includes("--dry-run") ? { dryRun: true } : {}),
+                ...(rest.includes("--sync-legacy-config") ? { syncLegacyConfig: true } : {}),
+            });
         }
     }
     if (command === "show") {
         const { runCliShowCommand } = await import("../lib/cli-show.js");
         return await runCliShowCommand({ argv: rest });
     }
+    if (command === "update") {
+        const { runScopedUpdateCommand } = await import("../lib/scoped-update.js");
+        return await runScopedUpdateCommand({ argv: rest });
+    }
+    if (command === "provider" && rest[0] === "add") {
+        const { runProviderAddCommand } = await import("../lib/provider-add-command.js");
+        return await runProviderAddCommand({ argv: rest.slice(1) });
+    }
     printUsage();
     return 1;
 }

package/dist/bin/opencode-quota.js.map

@@ -1 +1 @@
-{"version":3,"file":"opencode-quota.js","sourceRoot":"","sources":["../../src/bin/opencode-quota.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,KAAK,GAAG;IACZ,QAAQ;IACR,2DAA2D;IAC3D,4FAA4F;IAC5F,sCAAsC;IACtC,EAAE;IACF,WAAW;IACX,+CAA+C;IAC/C,oEAAoE;IACpE,sCAAsC;IACtC,gFAAgF;IAChF,0FAA0F;IAC1F,uDAAuD;CACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAA4B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAC3C,aAAqB,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EACnD,cAA4C,cAAc;IAE1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,WAAW,CAAC,UAAU,CAAC,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACnE,UAAU,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,MAAM,gBAAgB,EAAE,CAAC;QAClC,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,sBAAsB,EAAE,CAAC;YAC5D,OAAO,MAAM,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACjE,OAAO,MAAM,iBAAiB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,gBAAgB,EAAE,EAAE,CAAC;IACvB,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"opencode-quota.js","sourceRoot":"","sources":["../../src/bin/opencode-quota.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,5 +11,7 @@ declare const pluginModule: {
 };
 export default pluginModule;
 export { QuotaToastPlugin } from "./plugin.js";
+export { QUOTA_PROVIDER_MODES, QUOTA_PROVIDER_REMOTE_FORMATS, QUOTA_PROVIDER_WINDOW_TYPES, validateQuotaProviders, } from "./lib/quota-providers.js";
+export type { QuotaProviderDefinition, RemoteApiQuotaProviderDefinition, LocalEstimateQuotaProviderDefinition, LocalEstimateWindow, } from "./lib/quota-providers.js";
 export type { QuotaToastConfig, MaintainerAnnouncementsConfig, GoogleModelId, PricingSnapshotSource, CopilotEnterpriseUsageResult, CopilotOrganizationUsageResult, CopilotQuotaResult, GoogleQuotaResult, GoogleModelQuota, MiniMaxResult, MiniMaxResultEntry, } from "./lib/types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,QAAA,MAAM,YAAY;;;CAGQ,CAAC;AAE3B,eAAe,YAAY,CAAC;AAI5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,YAAY,EACV,gBAAgB,EAChB,6BAA6B,EAC7B,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,8BAA8B,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,QAAA,MAAM,YAAY;;;CAGQ,CAAC;AAE3B,eAAe,YAAY,CAAC;AAI5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,uBAAuB,EACvB,gCAAgC,EAChC,oCAAoC,EACpC,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,gBAAgB,EAChB,6BAA6B,EAC7B,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,8BAA8B,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -18,4 +18,6 @@ export default pluginModule;
 // Keep the named export for backward compatibility with consumers that import
 // { QuotaToastPlugin } directly.
 export { QuotaToastPlugin } from "./plugin.js";
+// Re-export types for consumers (types are erased at runtime, so safe to export)
+export { QUOTA_PROVIDER_MODES, QUOTA_PROVIDER_REMOTE_FORMATS, QUOTA_PROVIDER_WINDOW_TYPES, validateQuotaProviders, } from "./lib/quota-providers.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAO/C,qDAAqD;AACrD,6EAA6E;AAC7E,wEAAwE;AACxE,yCAAyC;AACzC,MAAM,YAAY,GAAG;IACnB,EAAE,EAAE,yBAAyB;IAC7B,MAAM,EAAE,gBAAgB;CACA,CAAC;AAE3B,eAAe,YAAY,CAAC;AAE5B,8EAA8E;AAC9E,iCAAiC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAO/C,qDAAqD;AACrD,6EAA6E;AAC7E,wEAAwE;AACxE,yCAAyC;AACzC,MAAM,YAAY,GAAG;IACnB,EAAE,EAAE,yBAAyB;IAC7B,MAAM,EAAE,gBAAgB;CACA,CAAC;AAE3B,eAAe,YAAY,CAAC;AAE5B,8EAA8E;AAC9E,iCAAiC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,iFAAiF;AACjF,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}

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

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

package/dist/lib/anthropic.js

@@ -7,6 +7,7 @@
  * file) and Anthropic's OAuth usage endpoint.
  */
 import { execFile } from "child_process";
+import { createHash } from "crypto";
 import { readFile } from "fs/promises";
 import { homedir } from "os";
 import { join } from "path";
@@ -15,6 +16,8 @@ import { fetchWithTimeout } from "./http.js";
 const DEFAULT_CLAUDE_BINARY = "claude";
 const CLAUDE_COMMAND_TIMEOUT_MS = 3_000;
 const ANTHROPIC_DIAGNOSTICS_TTL_MS = 5_000;
+const ANTHROPIC_OAUTH_BACKOFF_BASE_MS = 30_000;
+const ANTHROPIC_OAUTH_COOLDOWN_MAX_MS = 15 * 60_000;
 const ANTHROPIC_USAGE_URL = "https://api.anthropic.com/api/oauth/usage";
 const ANTHROPIC_BETA_HEADER = "oauth-2025-04-20";
 const CLAUDE_CODE_CREDENTIALS_SERVICE = "Claude Code-credentials";
@@ -22,6 +25,8 @@ const CLAUDE_NO_LOCAL_QUOTA_MESSAGE = "Claude CLI auth detected, but local quota
 const ANTHROPIC_NO_QUOTA_MESSAGE = "Claude CLI auth detected, but quota was unavailable from both the local CLI and Claude OAuth fallback.";
 const diagnosticsCache = new Map();
 const localDiagnosticsCache = new Map();
+const anthropicOAuthCooldowns = new Map();
+const anthropicOAuthInFlight = new Map();
 export function resolveAnthropicBinaryPath(binaryPath) {
     const trimmed = binaryPath?.trim();
     return trimmed ? trimmed : DEFAULT_CLAUDE_BINARY;
@@ -361,7 +366,53 @@ async function readClaudeCredentialsAccessToken() {
         detail: unavailableDetails[0] ?? getClaudeCredentialsNotFoundDetail(locationsChecked),
     };
 }
-async function queryAnthropicQuotaFromOAuthAccessToken(accessToken, requestTimeoutMs) {
+function fingerprintAccessToken(accessToken) {
+    return createHash("sha256").update(accessToken).digest("hex");
+}
+function parseRetryAfterMs(value, nowMs) {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/u.test(trimmed)) {
+        const seconds = Number(trimmed);
+        return Number.isFinite(seconds) && seconds > 0 ? seconds * 1_000 : undefined;
+    }
+    const retryAtMs = Date.parse(trimmed);
+    const durationMs = retryAtMs - nowMs;
+    return Number.isFinite(durationMs) && durationMs > 0 ? durationMs : undefined;
+}
+function getAnthropicOAuthCooldownDurationMs(failureCount, retryAfter, nowMs) {
+    const exponentialMs = Math.min(ANTHROPIC_OAUTH_COOLDOWN_MAX_MS, ANTHROPIC_OAUTH_BACKOFF_BASE_MS * 2 ** Math.min(failureCount, 30));
+    const retryAfterMs = Math.min(ANTHROPIC_OAUTH_COOLDOWN_MAX_MS, parseRetryAfterMs(retryAfter, nowMs) ?? 0);
+    return Math.max(exponentialMs, retryAfterMs);
+}
+function getAnthropicOAuthCooldownMessage(remainingMs) {
+    const boundedRemainingMs = Math.min(ANTHROPIC_OAUTH_COOLDOWN_MAX_MS, Math.max(0, remainingMs));
+    return `Anthropic OAuth usage probe paused after HTTP 429; retry in ${Math.ceil(boundedRemainingMs / 1_000)}s.`;
+}
+function retainAnthropicOAuthCooldownForToken(tokenFingerprint) {
+    for (const fingerprint of anthropicOAuthCooldowns.keys()) {
+        if (fingerprint !== tokenFingerprint) {
+            anthropicOAuthCooldowns.delete(fingerprint);
+        }
+    }
+}
+function redactAccessTokenFromSanitizedDetail(detail, accessToken) {
+    const sanitizedDetail = sanitizeDisplayText(detail);
+    const sanitizedAccessToken = sanitizeDisplayText(accessToken);
+    const redactedDetail = sanitizedDetail.split(accessToken).join("[redacted]");
+    return sanitizedAccessToken
+        ? redactedDetail.split(sanitizedAccessToken).join("[redacted]")
+        : redactedDetail;
+}
+function sanitizeAnthropicApiDetail(detail, accessToken) {
+    return redactAccessTokenFromSanitizedDetail(detail, accessToken).slice(0, 120);
+}
+function sanitizeAnthropicRequestError(detail, accessToken) {
+    return redactAccessTokenFromSanitizedDetail(detail, accessToken);
+}
+async function performAnthropicOAuthUsageRequest(accessToken, tokenFingerprint, requestTimeoutMs) {
     let response;
     try {
         response = await fetchWithTimeout(ANTHROPIC_USAGE_URL, {
@@ -374,13 +425,37 @@ async function queryAnthropicQuotaFromOAuthAccessToken(accessToken, requestTimeo
     catch (error) {
         return {
             state: "unavailable",
-            detail: sanitizeDisplayText(error instanceof Error ? error.message : String(error)),
+            detail: sanitizeAnthropicRequestError(error instanceof Error ? error.message : String(error), accessToken),
         };
     }
+    if (response.status === 429) {
+        let detail = "";
+        try {
+            detail = sanitizeAnthropicApiDetail(await response.text(), accessToken);
+        }
+        catch {
+            detail = "";
+        }
+        const nowMs = Date.now();
+        const previousFailureCount = anthropicOAuthCooldowns.get(tokenFingerprint)?.failureCount ?? 0;
+        const durationMs = getAnthropicOAuthCooldownDurationMs(previousFailureCount, response.headers?.get?.("Retry-After") ?? null, nowMs);
+        anthropicOAuthCooldowns.set(tokenFingerprint, {
+            failureCount: previousFailureCount + 1,
+            blockedUntilMs: nowMs + durationMs,
+        });
+        const errorDetail = detail
+            ? `Anthropic API error ${response.status}: ${detail}`
+            : `Anthropic API returned ${response.status}`;
+        return {
+            state: "unavailable",
+            detail: `${errorDetail} ${getAnthropicOAuthCooldownMessage(durationMs)}`,
+        };
+    }
+    anthropicOAuthCooldowns.delete(tokenFingerprint);
     if (!response.ok) {
         let detail = "";
         try {
-            detail = sanitizeDisplaySnippet(await response.text(), 120);
+            detail = sanitizeAnthropicApiDetail(await response.text(), accessToken);
         }
         catch {
             detail = "";
@@ -414,6 +489,32 @@ async function queryAnthropicQuotaFromOAuthAccessToken(accessToken, requestTimeo
         quota,
     };
 }
+async function queryAnthropicQuotaFromOAuthAccessToken(accessToken, requestTimeoutMs) {
+    const tokenFingerprint = fingerprintAccessToken(accessToken);
+    retainAnthropicOAuthCooldownForToken(tokenFingerprint);
+    const nowMs = Date.now();
+    const cooldown = anthropicOAuthCooldowns.get(tokenFingerprint);
+    if (cooldown && cooldown.blockedUntilMs > nowMs) {
+        return {
+            state: "unavailable",
+            detail: getAnthropicOAuthCooldownMessage(cooldown.blockedUntilMs - nowMs),
+        };
+    }
+    const existingInFlight = anthropicOAuthInFlight.get(tokenFingerprint);
+    if (existingInFlight) {
+        return await existingInFlight;
+    }
+    const inFlight = performAnthropicOAuthUsageRequest(accessToken, tokenFingerprint, requestTimeoutMs);
+    anthropicOAuthInFlight.set(tokenFingerprint, inFlight);
+    try {
+        return await inFlight;
+    }
+    finally {
+        if (anthropicOAuthInFlight.get(tokenFingerprint) === inFlight) {
+            anthropicOAuthInFlight.delete(tokenFingerprint);
+        }
+    }
+}
 function extractAuthBoolean(data) {
     const record = asRecord(data);
     if (!record) {
@@ -665,6 +766,8 @@ async function probeAnthropicLocalDiagnostics(options = {}) {
 export function clearAnthropicDiagnosticsCacheForTests() {
     diagnosticsCache.clear();
     localDiagnosticsCache.clear();
+    anthropicOAuthCooldowns.clear();
+    anthropicOAuthInFlight.clear();
 }
 async function getCachedAnthropicLocalDiagnostics(options = {}) {
     const binaryPath = resolveAnthropicBinaryPath(options.binaryPath);