@slkiser/opencode-quota 3.4.0 → 3.6.0

package/README.md

@@ -19,7 +19,7 @@
 
 ---
 
-### Installation (automatic setup)
+### Quick start
 
 ```bash
 npx @slkiser/opencode-quota init
@@ -28,24 +28,28 @@ npx @slkiser/opencode-quota init
 > [!IMPORTANT]
 > OpenCode `>= 1.4.3` and Node.js `>= 18` are required.
 
-The installer is append-only and preserves existing config values. It asks where to install, which quota UI to enable, whether providers should be auto-detected, which quota display style to use, how percentages should be labeled, and whether session input/output tokens should appear in quota displays.
+The installer is append-only: it adds the plugin, asks a few display/provider questions, and leaves existing values alone.
 
 After install:
 
 1. Restart OpenCode.
-2. Run `/quota_status`.
-3. Run `/quota`.
-4. If you enabled the sidebar, open the session sidebar and confirm the `Quota` panel appears.
+2. Run `/quota`.
+3. If something looks wrong, run `/quota_status`.
+4. If you enabled the sidebar, open the session sidebar and look for the `Quota` panel.
 
-For a terminal-only quota glance:
+Terminal-only check:
+
+Use `npx` when you want to run the published package without installing the binary first:
 
 ```bash
 npx @slkiser/opencode-quota show
-# or, if installed/on PATH:
-opencode-quota show --provider copilot
 ```
 
-`show` is quota-only: no token/cost reports or `models.dev` refresh. Installer `None (commands and terminal only)` disables toast/sidebar but keeps `/quota`, `/tokens_*`, and terminal `show`.
+Use `opencode-quota` directly when the package binary is already installed or on your `PATH`. Add `--provider` to show only one provider:
+
+```bash
+opencode-quota show --provider copilot
+```
 
 ### Manual setup
 
@@ -67,9 +71,68 @@ If you also want the sidebar, add the same package to the `tui.json` or `tui.jso
 }
 ```
 
-All quota settings live in `opencode.json` or `opencode.jsonc`, not `tui.json`.
+Quota settings go in `opencode-quota/quota-toast.json` next to the OpenCode config file you chose during install. Existing `experimental.quotaToast` settings still work when no sidecar file exists. Quota settings do not live in `tui.json`.
+
+<details>
+<summary><em>Full configuration reference</em></summary>
+
+#### Core/shared settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `enabled` | `true` | Master switch for quota collection and handled slash commands. When `false`, `/quota`, `/quota_status`, `/pricing_refresh`, and `/tokens_*` are handled as no-ops. |
+| `enabledProviders` | `"auto"` | Auto-detect providers, or set an explicit provider list. Unknown provider ids are reported under `config_errors` in `/quota_status`; an explicit list with no valid providers resolves to none instead of falling back to auto-detect. |
+| `minIntervalMs` | `300000` | Minimum fetch interval between provider updates. |
+| `requestTimeoutMs` | `5000` | Remote provider request timeout in milliseconds. Providers with custom defaults, such as Gemini CLI and OpenCode Go, keep their provider default unless this is explicitly configured. |
+| `formatStyle` | `singleWindow` | Shared quota-row style for popup toasts and the TUI sidebar: `singleWindow` or `allWindows`. Legacy `classic`/`grouped` aliases still work, and legacy `toastStyle` is still accepted on read for backward compatibility. |
+| `percentDisplayMode` | `remaining` | Shared percent meaning for popup toasts and the TUI sidebar: `remaining` renders labels like `81% left`; `used` renders labels like `19% used` or `125% used` when over quota. |
+| `onlyCurrentModel` | `false` | Filter quota rows to the current model/provider when that session selection can be resolved. |
+| `showSessionTokens` | `true` | Show the `Session input/output tokens` section in quota displays when session token data is available. |
+| `pricingSnapshot.source` | `"auto"` | Token pricing snapshot selection for `/tokens_*`: `auto`, `bundled`, or `runtime`. |
+| `pricingSnapshot.autoRefresh` | `7` | Refresh stale local pricing data after this many days. |
+
+`percentDisplayMode` affects popup toasts and the TUI sidebar only. `/quota` keeps its existing remaining-oriented percentage output.
+
+#### Toast settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `enableToast` | `true` | Show popup toasts. Disabling this does not disable `/quota` or the TUI sidebar. |
+| `toastDurationMs` | `9000` | Toast duration in milliseconds. |
+| `showOnIdle` | `true` | Show a toast on the idle trigger. |
+| `showOnQuestion` | `true` | Show a toast after a question/assistant response. |
+| `showOnCompact` | `true` | Show a toast after session compaction. |
+| `showOnBothFail` | `true` | Show a fallback toast when providers attempted quota reads and all failed. |
+| `layout.maxWidth` | `50` | Toast formatting width target. Ignored by the TUI sidebar. |
+| `layout.narrowAt` | `42` | Toast compact-layout breakpoint. Ignored by the TUI sidebar. |
+| `layout.tinyAt` | `32` | Toast tiny-layout breakpoint. Ignored by the TUI sidebar. |
+| `debug` | `false` | Append toast debug context when troubleshooting. |
+
+#### TUI sidebar setup
+
+If you want the `Quota` sidebar panel, you need the plugin in both OpenCode config surfaces:
+
+| File | What goes there | Needed for sidebar? |
+| --- | --- | --- |
+| `tui.json` / `tui.jsonc` | `plugin: ["@slkiser/opencode-quota"]` | Yes |
+| `opencode.json` / `opencode.jsonc` | Server plugin entry | Yes |
+| `opencode-quota/quota-toast.json` | Quota settings | No, but controls quota behavior |
+
+#### Provider-specific settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `anthropicBinaryPath` | `"claude"` | Command/path used for local Claude CLI probing; override this for custom installs or shim locations. |
+| `googleModels` | `["CLAUDE"]` | Google model keys to query: `CLAUDE`, `G3PRO`, `G3FLASH`, `G3IMAGE`. |
+| `opencodeGoWindows` | `["rolling", "weekly", "monthly"]` | OpenCode Go usage windows to display. |
+| `alibabaCodingPlanTier` | `"lite"` | Fallback Alibaba Coding Plan tier when auth does not include `tier`. |
+| `cursorPlan` | `"none"` | Cursor included API budget preset: `none`, `pro`, `pro-plus`, `ultra`. |
+| `cursorIncludedApiUsd` | unset | Override Cursor monthly included API budget in USD. |
+| `cursorBillingCycleStartDay` | unset | Local billing-cycle anchor day `1..28`; when unset, Cursor usage resets on the local calendar month. |
+
+</details>
 
-### What plugin adds
+### What opencode-quota adds
 
 - TUI sidebar panel with quota rows
 - Popup quota toasts after assistant responses
@@ -99,7 +162,7 @@ All quota settings live in `opencode.json` or `opencode.jsonc`, not `tui.json`.
 | ----------------------- | ------------------ | --------------------------------------------------------- | ------------------------ |
 | Anthropic (Claude)      | [Needs quick setup](#anthropic-claude-quick-setup) | Install and authenticate Claude CLI                       | Local CLI or OAuth usage |
 | GitHub Copilot          | Usually automatic  | Existing OpenCode auth, or optional PAT config            | Remote API               |
-| OpenAI                  | Automatic          | Existing OpenCode auth                                    | Remote API               |
+| OpenAI                  | Automatic          | Existing OpenCode OAuth                                   | Remote API               |
 | Cursor                  | [Needs quick setup](#cursor-quick-setup) | `["@playwo/opencode-cursor-oauth", "@slkiser/opencode-quota"]` | Local estimation         |
 | Qwen Code               | [Needs quick setup](#qwen-code-quick-setup) | `["opencode-qwencode-auth", "@slkiser/opencode-quota"]`   | Local estimation         |
 | Alibaba Coding Plan     | Automatic          | Existing OpenCode auth, global config, or env             | Local estimation         |
@@ -113,70 +176,96 @@ All quota settings live in `opencode.json` or `opencode.jsonc`, not `tui.json`.
 | NanoGPT                 | Usually automatic  | Existing OpenCode auth, global config, or env             | Remote API               |
 | OpenCode Go             | [Needs quick setup](#opencode-go-quick-setup) | Set workspace ID and `auth` cookie                        | Dashboard scraping       |
 
-For companion auth providers, put the companion plugin first and `@slkiser/opencode-quota` second. The companion plugin handles login or token storage; OpenCode Quota reads that auth state and renders quota.
-
-Providers are auto-detected by default. To choose providers explicitly:
+Providers are auto-detected by default. To choose providers explicitly, set `enabledProviders` in `opencode-quota/quota-toast.json`:
 
 ```jsonc
 {
-  "experimental": {
-    "quotaToast": {
-      "enabledProviders": ["copilot", "openai", "google-gemini-cli"],
-    },
-  },
+  "enabledProviders": ["copilot", "openai", "google-gemini-cli"],
 }
 ```
 
-### Display options
+### Common Options
+
+Customize these settings in `opencode-quota/quota-toast.json`.
+
+<details>
+<summary><em>Show every quota window</em></summary>
 
-Show every quota window instead of the default most-constrained window:
+Instead of the default most-constrained window:
 
 ```jsonc
 {
-  "experimental": {
-    "quotaToast": {
-      "formatStyle": "allWindows",
-    },
-  },
+  "formatStyle": "allWindows",
 }
 ```
 
-Choose which OpenCode Go usage windows to display (default is all three; `rolling` displays as `5h`):
+</details>
+
+<details>
+<summary><em>Choose OpenCode Go windows</em></summary>
+
+Choose which OpenCode Go windows to display:
 
 ```jsonc
 {
-  "experimental": {
-    "quotaToast": {
-      "opencodeGoWindows": ["rolling", "weekly", "monthly"],
-    },
-  },
+  "opencodeGoWindows": ["rolling", "weekly", "monthly"],
 }
 ```
 
+</details>
+
+<details>
+<summary><em>Show used percentages</em></summary>
+
 Show percentages as used instead of remaining in toasts and the sidebar:
 
 ```jsonc
 {
-  "experimental": {
-    "quotaToast": {
-      "percentDisplayMode": "used",
-    },
-  },
+  "percentDisplayMode": "used",
 }
 ```
 
-Turn off popup toasts while keeping `/quota` and the sidebar:
+</details>
+
+<details>
+<summary><em>Turn off popup toasts</em></summary>
+
+Keep `/quota` and the sidebar enabled:
 
 ```jsonc
 {
-  "experimental": {
-    "quotaToast": {
-      "enableToast": false,
-    },
-  },
+  "enableToast": false,
 }
 ```
 
+</details>
+
+<details>
+<summary><em>Increase request timeout</em></summary>
+
+Increase the remote provider request timeout from the default 5000ms. Providers with custom defaults, such as Gemini CLI and OpenCode Go, keep their provider default unless you set this.
+
+```jsonc
+{
+  "requestTimeoutMs": 12000,
+}
+```
+
+</details>
+
+<details>
+<summary><em>Advanced: legacy config sync</em></summary>
+
+By default, the installer writes quota settings only to `opencode-quota/quota-toast.json`. If you also want it to write the legacy OpenCode block, run:
+
+```bash
+npx @slkiser/opencode-quota init --sync-legacy-config
+```
+
+This is only for users who intentionally want `experimental.quotaToast` mirrored into `opencode.json` / `opencode.jsonc`.
+
+</details>
+
 ### Commands
 
 | Command               | What it shows                                      |
@@ -198,18 +287,18 @@ Turn off popup toasts while keeping `/quota` and the sidebar:
 
 ### Anthropic quick setup
 
-Anthropic does not use a companion OpenCode plugin. Install Claude Code, authenticate it, and make sure `claude` is available on your `PATH`:
+Install Claude Code, authenticate it, and make sure `claude` is on your `PATH`:
 
 ```bash
 claude auth login
 claude auth status
 ```
 
-If Claude lives at a custom path, set `experimental.quotaToast.anthropicBinaryPath` in `opencode.json`.
+If Claude lives at a custom path, set `anthropicBinaryPath` in `opencode-quota/quota-toast.json`.
 
 ### Companion providers
 
-Some providers need an auth companion plugin installed separately. Add the companion plugin first and `@slkiser/opencode-quota` second in `opencode.json` or `opencode.jsonc`.
+Some providers need an auth companion plugin. Add the companion plugin first and `@slkiser/opencode-quota` second.
 
 <a id="cursor-quick-setup"></a>
 
@@ -273,17 +362,12 @@ Add both plugins to `opencode.json`, with the Antigravity auth plugin first:
 
 Companion plugin: [`opencode-gemini-auth`](https://github.com/jenslys/opencode-gemini-auth#readme)
 
-Add both plugins to `opencode.json`, with the Gemini auth plugin first. If you manually choose providers, include `google-gemini-cli`:
+Add both plugins to `opencode.json`, with the Gemini auth plugin first:
 
 ```jsonc
 {
   "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-gemini-auth", "@slkiser/opencode-quota"],
-  "experimental": {
-    "quotaToast": {
-      "enabledProviders": ["google-gemini-cli"]
-    }
-  }
+  "plugin": ["opencode-gemini-auth", "@slkiser/opencode-quota"]
 }
 ```
 
@@ -293,6 +377,8 @@ Then authenticate Google once:
 opencode auth login --provider google
 ```
 
+If you use manual provider selection, include `google-gemini-cli` in `enabledProviders`.
+
 ### OpenCode Go
 
 <a id="opencode-go-quick-setup"></a>
@@ -304,9 +390,9 @@ export OPENCODE_GO_WORKSPACE_ID="your-workspace-id"
 export OPENCODE_GO_AUTH_COOKIE="your-auth-cookie"
 ```
 
-The provider can report three usage windows — **5h** rolling, **Weekly**, and **Monthly** — and emits whichever dashboard windows are available in that order. Filter displayed windows with `experimental.quotaToast.opencodeGoWindows` (`rolling`, `weekly`, `monthly`); non-default subsets report missing selected dashboard fields, while default/all-windows mode shows available windows and diagnostics indicate what was found.
+OpenCode Go can show **5h**, **Weekly**, and **Monthly** windows. Use `opencodeGoWindows` in `opencode-quota/quota-toast.json` to choose a subset.
 
-Environment variables take precedence over the optional `opencode-go.json` config file. Run `/quota_status` to see the exact paths checked on your machine.
+Environment variables take precedence over the optional `opencode-go.json` file. Run `/quota_status` to see the exact paths checked.
 
 ### Troubleshooting
 
@@ -320,15 +406,17 @@ If quota or token data looks wrong:
 
 ### Provider Troubleshooting
 
+For companion providers, confirm the auth plugin appears before `@slkiser/opencode-quota` in `opencode.json`.
+
 <details>
-<summary><strong>Anthropic (Claude)</strong></summary>
+<summary><em>Anthropic (Claude)</em></summary>
 
 Run `/quota_status` and check the Anthropic section.
 
 | Symptom | Fix |
 | --- | --- |
 | `claude` not found | Install Claude Code and make sure `claude` is on your `PATH`. |
-| Claude is installed at a custom path | Set `experimental.quotaToast.anthropicBinaryPath` in `opencode.json`. |
+| Claude is installed at a custom path | Set `anthropicBinaryPath` in `opencode-quota/quota-toast.json`. |
 | Not authenticated | Run `claude auth login`, then confirm `claude auth status` works. |
 | Auth works but no quota rows appear | Check `quota_source` and `message` in `/quota_status`; re-authenticate Claude if the OAuth credential fallback is missing or stale. |
 | Provider not detected | Confirm OpenCode is configured to use the `anthropic` provider. |
@@ -336,7 +424,7 @@ Run `/quota_status` and check the Anthropic section.
 </details>
 
 <details>
-<summary><strong>GitHub Copilot</strong></summary>
+<summary><em>GitHub Copilot</em></summary>
 
 Run `/quota_status` and check `copilot_quota_auth`, `billing_mode`, `billing_scope`, and `quota_api`.
 
@@ -350,20 +438,20 @@ Run `/quota_status` and check `copilot_quota_auth`, `billing_mode`, `billing_sco
 </details>
 
 <details>
-<summary><strong>OpenAI</strong></summary>
+<summary><em>OpenAI</em></summary>
 
 Run `/quota_status` and check the OpenAI auth source and token status.
 
 | Symptom | Fix |
 | --- | --- |
-| OpenAI quota missing | Confirm OpenCode native OpenAI auth is present in `auth.json`. |
+| OpenAI quota missing | Confirm OpenCode native OpenAI OAuth is present in `auth.json`. |
 | Token expired | Re-run OpenCode's OpenAI auth flow. |
 | Provider not detected | Confirm your OpenCode config uses the `openai` provider or a compatible OpenAI auth entry. |
 
 </details>
 
 <details>
-<summary><strong>Cursor</strong></summary>
+<summary><em>Cursor</em></summary>
 
 Run `/quota_status` and check the Cursor section.
 
@@ -371,14 +459,14 @@ Run `/quota_status` and check the Cursor section.
 | --- | --- |
 | Cursor not detected | Put `@playwo/opencode-cursor-oauth` before `@slkiser/opencode-quota` in `opencode.json`. |
 | Cursor auth missing | Run `opencode auth login --provider cursor`. |
-| Quota appears but no remaining percentage | Set `experimental.quotaToast.cursorPlan` or `experimental.quotaToast.cursorIncludedApiUsd`. |
-| Billing cycle looks wrong | Set `experimental.quotaToast.cursorBillingCycleStartDay` to your local billing anchor day. |
+| Quota appears but no remaining percentage | Set `cursorPlan` or `cursorIncludedApiUsd` in `opencode-quota/quota-toast.json`. |
+| Billing cycle looks wrong | Set `cursorBillingCycleStartDay` in `opencode-quota/quota-toast.json` to your local billing anchor day. |
 | Unknown Cursor pricing | Run `/pricing_refresh`; if still unknown, check `/quota_status` for unknown model ids. |
 
 </details>
 
 <details>
-<summary><strong>Qwen Code</strong></summary>
+<summary><em>Qwen Code</em></summary>
 
 Run `/quota_status` and check `qwen_oauth_source`, `qwen_local_plan`, and the `qwen_code` live probe section.
 
@@ -392,21 +480,21 @@ Run `/quota_status` and check `qwen_oauth_source`, `qwen_local_plan`, and the `q
 </details>
 
 <details>
-<summary><strong>Alibaba Coding Plan</strong></summary>
+<summary><em>Alibaba Coding Plan</em></summary>
 
 Run `/quota_status` and check the Alibaba auth, resolved tier, state-file path, and `alibaba_coding_plan` live probe section.
 
 | Symptom | Fix |
 | --- | --- |
 | API key not detected | Use `ALIBABA_CODING_PLAN_API_KEY`, `ALIBABA_API_KEY`, trusted user/global OpenCode config, or OpenCode auth. Repo-local provider secrets are ignored. |
-| Wrong tier | Set `experimental.quotaToast.alibabaCodingPlanTier` to `lite` or `pro`. |
+| Wrong tier | Set `alibabaCodingPlanTier` to `lite` or `pro` in `opencode-quota/quota-toast.json`. |
 | Counters do not move | Confirm the current model is `alibaba/*` or `alibaba-cn/*`. |
 | Quota seems stale | Check the state-file path shown in `/quota_status`. |
 
 </details>
 
 <details>
-<summary><strong>MiniMax, Kimi, Chutes AI, Synthetic, Z.ai, and NanoGPT</strong></summary>
+<summary><em>MiniMax, Kimi, Chutes AI, Synthetic, Z.ai, and NanoGPT</em></summary>
 
 These providers use trusted env vars, trusted user/global OpenCode config, or native OpenCode auth. Run `/quota_status` and check the provider-specific API-key diagnostics.
 
@@ -424,7 +512,7 @@ For security, repo-local `opencode.json` / `opencode.jsonc` is ignored for provi
 </details>
 
 <details>
-<summary><strong>Google Antigravity</strong></summary>
+<summary><em>Google Antigravity</em></summary>
 
 Run `/quota_status` and check the `google_antigravity` section.
 
@@ -438,21 +526,21 @@ Run `/quota_status` and check the `google_antigravity` section.
 </details>
 
 <details>
-<summary><strong>Gemini CLI</strong></summary>
+<summary><em>Gemini CLI</em></summary>
 
 Run `/quota_status` and check the Gemini CLI live probe rows.
 
 | Symptom | Fix |
 | --- | --- |
 | Companion missing | Put `opencode-gemini-auth` before `@slkiser/opencode-quota` in `opencode.json`. |
-| Provider not enabled in manual mode | Include `google-gemini-cli` in `experimental.quotaToast.enabledProviders`. |
+| Provider not enabled in manual mode | Include `google-gemini-cli` in `enabledProviders` in `opencode-quota/quota-toast.json`. |
 | Auth missing | Run `opencode auth login --provider google`. |
 | Project missing | Set `provider.google.options.projectId`, `OPENCODE_GEMINI_PROJECT_ID`, `GOOGLE_CLOUD_PROJECT`, or `GOOGLE_CLOUD_PROJECT_ID`. |
 
 </details>
 
 <details>
-<summary><strong>OpenCode Go</strong></summary>
+<summary><em>OpenCode Go</em></summary>
 
 Run `/quota_status` and check the `opencode_go` section.
 
@@ -461,13 +549,13 @@ Run `/quota_status` and check the `opencode_go` section.
 | Config not detected | Set both `OPENCODE_GO_WORKSPACE_ID` and `OPENCODE_GO_AUTH_COOKIE`, then rerun `/quota_status`. |
 | Incomplete config | `workspaceId` and `authCookie` must come from the same source. |
 | Scrape returns no data | Refresh the browser `auth` cookie from `opencode.ai`. |
-| Selected window missing | Check `/quota_status` for `selected_windows` and `live_fetch_error`; remove unavailable windows from `experimental.quotaToast.opencodeGoWindows` or refresh the dashboard cookie. |
+| Selected window missing | Check `/quota_status` for `selected_windows` and `live_fetch_error`; remove unavailable windows from `opencodeGoWindows` in `opencode-quota/quota-toast.json` or refresh the dashboard cookie. |
 | Dashboard format changed | This integration scrapes the dashboard, so it can break if the dashboard markup changes. |
 
 </details>
 
 <details>
-<summary><strong>Token Reports</strong></summary>
+<summary><em>Token Reports</em></summary>
 
 Run `/quota_status` and check pricing snapshot health plus OpenCode database paths.
 
@@ -475,11 +563,15 @@ Run `/quota_status` and check pricing snapshot health plus OpenCode database pat
 | --- | --- |
 | `/tokens_*` is empty | Start OpenCode once so it creates `opencode.db`, then run a session with model usage. |
 | Pricing looks stale | Run `/pricing_refresh`. |
-| Runtime pricing does not change output | Check `experimental.quotaToast.pricingSnapshot.source`; `bundled` keeps packaged pricing active. |
+| Runtime pricing does not change output | Check `pricingSnapshot.source` in `opencode-quota/quota-toast.json`; `bundled` keeps packaged pricing active. |
 | Cursor model has unknown pricing | Run `/pricing_refresh`; Cursor `auto` and `composer*` use bundled deterministic pricing. |
 
 </details>
 
+### Issues
+
+Please use the Bug report or Feature request templates when opening issues. Freeform issues, or bug/feature issues missing the required template sections, may be automatically commented on and closed.
+
 ### License
 
 MIT

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":";AA+BA,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,CAwBxE"}
+{"version":3,"file":"opencode-quota.d.ts","sourceRoot":"","sources":["../../src/bin/opencode-quota.ts"],"names":[],"mappings":";AAgCA,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"}

package/dist/bin/opencode-quota.js

@@ -5,12 +5,13 @@ import { fileURLToPath } from "node:url";
 import { runInitInstaller } from "../lib/init-installer.js";
 const USAGE = [
     "Usage:",
-    "  npx @slkiser/opencode-quota init",
+    "  npx @slkiser/opencode-quota init [--sync-legacy-config]",
     "  npx @slkiser/opencode-quota show [--provider <provider-id>]",
     "  npx @slkiser/opencode-quota --help",
     "",
     "Commands:",
     "  init    Run the interactive quota installer",
+    "          --sync-legacy-config also writes experimental.quotaToast",
     "  show    Print a quick quota glance",
 ].join("\n");
 function printUsage() {
@@ -40,8 +41,13 @@ export async function main(argv = process.argv.slice(2)) {
         printUsage();
         return 0;
     }
-    if (command === "init" && rest.length === 0) {
-        return await runInitInstaller();
+    if (command === "init") {
+        if (rest.length === 0) {
+            return await runInitInstaller();
+        }
+        if (rest.length === 1 && rest[0] === "--sync-legacy-config") {
+            return await runInitInstaller({ syncLegacyConfig: true });
+        }
     }
     if (command === "show") {
         const { runCliShowCommand } = await import("../lib/cli-show.js");

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,oCAAoC;IACpC,+DAA+D;IAC/D,sCAAsC;IACtC,EAAE;IACF,WAAW;IACX,+CAA+C;IAC/C,sCAAsC;CACvC,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,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,MAAM,gBAAgB,EAAE,CAAC;IAClC,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":";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,+DAA+D;IAC/D,sCAAsC;IACtC,EAAE;IACF,WAAW;IACX,+CAA+C;IAC/C,oEAAoE;IACpE,sCAAsC;CACvC,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"}

package/dist/lib/anthropic.d.ts

@@ -53,6 +53,7 @@ export interface AnthropicDiagnostics {
 }
 export interface AnthropicProbeOptions {
     binaryPath?: string;
+    requestTimeoutMs?: number;
 }
 export type ClaudeCommandInvocation = {
     file: string;

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

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/lib/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,oBAAoB,CAAC;IAChC,SAAS,EAAE,oBAAoB,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,SAAS,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,IAAI,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAClF,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB,8BAA8B,GAC9B,MAAM,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,mBAAmB,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,oBAAoB,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAWD,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAmEF,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtE;AAgBD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7D,uBAAuB,CAiBzB;AAsHD,iBAAS,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAiBtE;AAklBD,wBAAgB,sCAAsC,IAAI,IAAI,CAG7D;AAmDD,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAyF/B;AAED,wBAAsB,iCAAiC,CACrD,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/lib/anthropic.ts"],"names":[],"mappings":"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"}

package/dist/lib/anthropic.js

@@ -37,10 +37,18 @@ function quoteWindowsCmdArg(value) {
     const escaped = value.replace(/(\\*)"/g, "$1$1\\\"").replace(/(\\+)$/g, "$1$1");
     return `"${escaped}"`;
 }
+function shouldBridgeClaudeCommandThroughWindowsShell(binaryPath) {
+    const normalized = binaryPath.trim().toLowerCase();
+    if (!/[\\/]/u.test(normalized)) {
+        return true;
+    }
+    return /\.(?:cmd|bat)$/u.test(normalized);
+}
 export function buildClaudeCommandInvocation(binaryPath, args, runtime = {}) {
     const resolvedBinaryPath = resolveAnthropicBinaryPath(binaryPath);
     const display = formatCommandDisplay([resolvedBinaryPath, ...args]);
-    if ((runtime.platform ?? process.platform) === "win32") {
+    if ((runtime.platform ?? process.platform) === "win32" &&
+        shouldBridgeClaudeCommandThroughWindowsShell(resolvedBinaryPath)) {
         return {
             file: runtime.comspec?.trim() || process.env["ComSpec"]?.trim() || "cmd.exe",
             args: ["/d", "/s", "/c", [resolvedBinaryPath, ...args].map(quoteWindowsCmdArg).join(" ")],
@@ -353,7 +361,7 @@ async function readClaudeCredentialsAccessToken() {
         detail: unavailableDetails[0] ?? getClaudeCredentialsNotFoundDetail(locationsChecked),
     };
 }
-async function queryAnthropicQuotaFromOAuthAccessToken(accessToken) {
+async function queryAnthropicQuotaFromOAuthAccessToken(accessToken, requestTimeoutMs) {
     let response;
     try {
         response = await fetchWithTimeout(ANTHROPIC_USAGE_URL, {
@@ -361,7 +369,7 @@ async function queryAnthropicQuotaFromOAuthAccessToken(accessToken) {
                 Authorization: `Bearer ${accessToken}`,
                 "anthropic-beta": ANTHROPIC_BETA_HEADER,
             },
-        });
+        }, requestTimeoutMs);
     }
     catch (error) {
         return {
@@ -731,7 +739,7 @@ export async function getAnthropicDiagnostics(options = {}) {
             };
             return diagnostics;
         }
-        const fallbackQuota = await queryAnthropicQuotaFromOAuthAccessToken(credentials.accessToken);
+        const fallbackQuota = await queryAnthropicQuotaFromOAuthAccessToken(credentials.accessToken, options.requestTimeoutMs);
         if (fallbackQuota.state !== "success") {
             const diagnostics = {
                 installed: localDiagnostics.installed,