@leo000001/opencode-quota-sidebar 1.13.1 → 1.13.3

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## Unreleased
+
+- Add Buzz API balance support for OpenAI-compatible providers that use a Buzz `baseURL`.
+- Document Buzz configuration, rendering, and outbound billing endpoints.
+
+## 1.13.2
+
+- Publish Anthropic quota fixes and cache invalidation updates.
+- Keep npm release aligned with the current `dist/` output.
+
+## 1.13.1
+
+- Invalidate legacy cached Anthropic `unsupported` snapshots so OAuth quota can refetch correctly.
+- Accept both `config.providers` and older `provider.list` runtime shapes when discovering provider options.
+
+## 1.13.0
+
+- Add Anthropic Claude OAuth quota support via `GET https://api.anthropic.com/api/oauth/usage`.
+- Show precise reset times for short quota windows (`5h`, `1d`, `Daily`) while keeping long windows date-only.
+- Expand rendering and quota tests for multi-window output and reset formatting.
+
+## 1.12.0
+
+- Add default configuration examples and rendering examples for sidebar/quota display.
+
 ## 1.0.0
 
 Initial release.

package/CONTRIBUTING.md

@@ -1,102 +1,138 @@
-# Contributing
-
-Thanks for contributing to opencode-quota-sidebar.
-
-The plugin now uses a provider adapter registry, so adding a new provider does not require editing core dispatch logic.
-
-## Architecture overview
-
-- Provider adapters live in `src/providers/`
-- Built-in adapters live in `src/providers/core/`
-- Third-party/community adapters live in `src/providers/third_party/`
-- `src/providers/registry.ts` resolves which adapter handles a provider
-- `src/quota.ts` provides `createQuotaRuntime()`; runtime methods delegate to resolved adapter and manage auth/cache glue
-- `src/format.ts` renders generic sidebar/report output from `QuotaSnapshot`
-
-## Add a new provider
-
-### 1) Create an adapter file
-
-Add `src/providers/third_party/<your-provider>.ts` and implement `QuotaProviderAdapter`.
-
-Minimal shape:
-
-```ts
-import type { QuotaProviderAdapter } from './types.js'
-
-export const myProviderAdapter: QuotaProviderAdapter = {
-  id: 'my-provider',
-  label: 'My Provider',
-  shortLabel: 'MyProv',
-  sortOrder: 40,
-  matchScore: ({ providerID, providerOptions }) => {
-    if (providerID === 'my-provider') return 80
-    if (providerOptions?.baseURL === 'https://api.example.com') return 100
-    return 0
-  },
-  isEnabled: (config) =>
-    config.quota.providers?.['my-provider']?.enabled ?? true,
-  fetch: async ({ providerID, auth, config }) => {
-    const checkedAt = Date.now()
-    // ... call endpoint, parse payload, return QuotaSnapshot
-    return {
-      providerID,
-      adapterID: 'my-provider',
-      label: 'My Provider',
-      shortLabel: 'MyProv',
-      sortOrder: 40,
-      status: 'ok',
-      checkedAt,
-      remainingPercent: 80,
-    }
-  },
-}
-```
-
-### 2) Register the adapter
-
-Edit `src/providers/index.ts` and add `registry.register(myProviderAdapter)`.
-
-If your provider has ID variants, implement `normalizeID` in the adapter.
-
-### 3) Optional config toggle
-
-Add to user config:
-
-```json
-{
-  "quota": {
-    "providers": {
-      "my-provider": { "enabled": true }
-    }
-  }
-}
-```
-
-### 4) Add tests
-
-At minimum:
-
-- adapter selection (`matchScore`)
-- successful response parsing
-- error/unavailable paths
-- format output if using special fields (e.g. `balance`)
-
-## QuotaSnapshot rules
-
-- Always fill `status` (`ok`, `error`, `unavailable`, `unsupported`)
-- Keep `providerID` as runtime provider identity
-- Set `adapterID`, `label`, `shortLabel`, `sortOrder`
-- Use `windows` for percent-based quota windows
-- Use `balance` for balance-based providers
-- Never throw in adapter `fetch`; return an error snapshot instead
-
-## Development workflow
-
-```bash
-npm install
-npm run build
-npm test
-```
-
-Both build and tests must pass before submitting a PR.
+# Contributing
+
+Thanks for contributing to opencode-quota-sidebar.
+
+The plugin now uses a provider adapter registry, so adding a new provider does not require editing core dispatch logic.
+
+## Architecture overview
+
+- Provider adapters live in `src/providers/`
+- Built-in adapters live in `src/providers/core/`
+- Third-party/community adapters live in `src/providers/third_party/`
+- `src/providers/registry.ts` resolves which adapter handles a provider
+- `src/quota.ts` provides `createQuotaRuntime()`; runtime methods delegate to resolved adapter and manage auth/cache glue
+- `src/format.ts` renders generic sidebar/report output from `QuotaSnapshot`
+
+## Common adapter patterns
+
+- Direct provider ID match: best for first-party providers with stable IDs
+- `baseURL` match: best for OpenAI-compatible relays such as RightCode or Buzz
+- Prefix/variant normalization: best when one provider has multiple runtime IDs
+- Balance-only providers should prefer `balance` over inventing fake percent windows
+
+## Add a new provider
+
+### 1) Create an adapter file
+
+Add `src/providers/third_party/<your-provider>.ts` and implement `QuotaProviderAdapter`.
+
+Minimal shape:
+
+```ts
+import type { QuotaProviderAdapter } from './types.js'
+
+export const myProviderAdapter: QuotaProviderAdapter = {
+  id: 'my-provider',
+  label: 'My Provider',
+  shortLabel: 'MyProv',
+  sortOrder: 40,
+  matchScore: ({ providerID, providerOptions }) => {
+    if (providerID === 'my-provider') return 80
+    if (providerOptions?.baseURL === 'https://api.example.com') return 100
+    return 0
+  },
+  isEnabled: (config) =>
+    config.quota.providers?.['my-provider']?.enabled ?? true,
+  fetch: async ({ providerID, auth, config }) => {
+    const checkedAt = Date.now()
+    // ... call endpoint, parse payload, return QuotaSnapshot
+    return {
+      providerID,
+      adapterID: 'my-provider',
+      label: 'My Provider',
+      shortLabel: 'MyProv',
+      sortOrder: 40,
+      status: 'ok',
+      checkedAt,
+      remainingPercent: 80,
+    }
+  },
+}
+```
+
+### 2) Register the adapter
+
+Edit `src/providers/index.ts` and add `registry.register(myProviderAdapter)`.
+
+If your provider has ID variants, implement `normalizeID` in the adapter.
+
+If your provider is an OpenAI-compatible relay, prefer matching on
+`providerOptions.baseURL` instead of the runtime `providerID`; that keeps custom
+aliases working without extra user config.
+
+If the new provider should appear in default `quota_summary` reports even when
+it has not yet been used in the current session, also update
+`listDefaultQuotaProviderIDs()` in `src/quota.ts`.
+
+### 3) Optional config toggle
+
+Add to user config:
+
+```json
+{
+  "quota": {
+    "providers": {
+      "my-provider": { "enabled": true }
+    }
+  }
+}
+```
+
+### 4) Add tests
+
+At minimum:
+
+- adapter selection (`matchScore`)
+- successful response parsing
+- error/unavailable paths
+- format output if using special fields (e.g. `balance`)
+- cache compatibility if the change replaces an older snapshot shape
+- mixed-provider rendering if the new provider will commonly appear next to
+  OpenAI/Copilot/RightCode in sidebar or toast output
+
+If the provider introduces new rendering rules or multi-window behavior, add
+coverage in both `src/__tests__/quota.test.ts` and `src/__tests__/format.test.ts`.
+
+## QuotaSnapshot rules
+
+- Always fill `status` (`ok`, `error`, `unavailable`, `unsupported`)
+- Keep `providerID` as runtime provider identity
+- Set `adapterID`, `label`, `shortLabel`, `sortOrder`
+- Use `windows` for percent-based quota windows
+- Use `balance` for balance-based providers
+- Never throw in adapter `fetch`; return an error snapshot instead
+
+## Development workflow
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+Both build and tests must pass before submitting a PR.
+
+If you change TypeScript types, config loading, or public behavior, also run:
+
+```bash
+npm run typecheck
+```
+
+## Documentation checklist
+
+When a change affects users, update the relevant docs in the same PR:
+
+- `README.md` for install, config, behavior, examples, or troubleshooting
+- `CONTRIBUTING.md` if the change affects adapter patterns or provider authoring guidance
+- `CHANGELOG.md` for released user-facing changes
+- `SECURITY.md` if the change affects auth handling, external requests, or data storage

package/README.md

@@ -13,13 +13,15 @@ Add the package name to `plugin` in your `opencode.json`. OpenCode uses Bun to i
 
 ```json
 {
-  "plugin": ["@leo000001/opencode-quota-sidebar"]
+  "plugin": ["@leo000001/opencode-quota-sidebar@1.13.2"]
 }
 ```
 
 Note for OpenCode `>=1.2.15`: TUI settings (`theme`/`keybinds`/`tui`) moved to `tui.json`, but plugin loading still stays in `opencode.json` (`plugin: []`).
 This plugin also accepts both `config.providers` and older `provider.list` runtime shapes when discovering provider options.
 
+If you prefer automatic upgrades, you can still use `@latest`, but pinning an exact version makes behavior easier to reproduce when debugging.
+
 ## Development (build from source)
 
 ```bash
@@ -44,6 +46,7 @@ On Windows, use forward slashes: `"file:///D:/Lab/opencode-quota-sidebar/dist/in
 | OpenAI Codex   | `chatgpt.com/backend-api/wham/usage`   | OAuth (ChatGPT) | Multi-window (short-term + weekly)      |
 | GitHub Copilot | `api.github.com/copilot_internal/user` | OAuth           | Monthly quota                           |
 | RightCode      | `www.right.codes/account/summary`      | API key         | Subscription or balance (by prefix)     |
+| Buzz           | `buzzai.cc/v1/dashboard/billing/*`     | API key         | Balance only (computed from total-used) |
 | Anthropic      | `api.anthropic.com/api/oauth/usage`    | OAuth           | Multi-window (5h + weekly / plan-based) |
 
 Want to add support for another provider (Google Antigravity, Zhipu AI, Firmware AI, etc.)? See [CONTRIBUTING.md](CONTRIBUTING.md).
@@ -68,6 +71,7 @@ Want to add support for another provider (Google Antigravity, Zhipu AI, Firmware
   - OpenAI Codex OAuth (`/backend-api/wham/usage`)
   - GitHub Copilot OAuth (`/copilot_internal/user`)
   - RightCode API key (`/account/summary`)
+  - Buzz API key (`/v1/dashboard/billing/subscription` + `/v1/dashboard/billing/usage`)
   - Anthropic Claude OAuth (`/api/oauth/usage`, with beta header)
 - OpenAI OAuth quota checks auto-refresh expired access token (using refresh token)
 - API key providers still show usage aggregation (quota only applies to subscription providers)
@@ -110,6 +114,37 @@ memory on startup. Chunk files remain on disk for historical range scans.
 - OpenCode: plugin SDK `@opencode-ai/plugin` ^1.2.10
 - OpenCode config split: if you are on `>=1.2.15`, keep this plugin in `opencode.json` and keep TUI-only keys in `tui.json`.
 
+## Force refresh after npm update
+
+If `npm view @leo000001/opencode-quota-sidebar version` shows a newer version but OpenCode still behaves like an older release, OpenCode/Bun is usually reusing an older installed copy.
+
+Recommended recovery steps:
+
+1. Pin the target plugin version in `opencode.json`.
+2. Fully exit OpenCode.
+3. Delete any cached installed copies of the plugin.
+4. Start OpenCode again so it reinstalls the package.
+5. Verify the actual installed `package.json` version under the plugin directory.
+
+Common install/cache locations:
+
+- `~/.cache/opencode/node_modules/@leo000001/opencode-quota-sidebar`
+- `~/node_modules/@leo000001/opencode-quota-sidebar`
+
+Windows PowerShell example:
+
+```powershell
+Remove-Item -Recurse -Force "$HOME\.cache\opencode\node_modules\@leo000001\opencode-quota-sidebar" -ErrorAction SilentlyContinue
+Remove-Item -Recurse -Force "$HOME\node_modules\@leo000001\opencode-quota-sidebar" -ErrorAction SilentlyContinue
+```
+
+macOS / Linux example:
+
+```bash
+rm -rf ~/.cache/opencode/node_modules/@leo000001/opencode-quota-sidebar
+rm -rf ~/node_modules/@leo000001/opencode-quota-sidebar
+```
+
 ## Optional commands
 
 You can add these command templates in `opencode.json` so you can run `/qday`, `/qweek`, `/qmonth`, `/qtoggle`:
@@ -169,10 +204,12 @@ Resolution order (low -> high):
 
 Values are layered; later sources override earlier ones.
 
-## Defaults
+## Configuration
 
 If you do not provide any config file, the plugin uses the built-in defaults below.
 
+### Built-in defaults
+
 Sidebar defaults:
 
 - `sidebar.enabled`: `true`
@@ -192,7 +229,7 @@ Quota defaults:
 - `quota.includeOpenAI`: `true`
 - `quota.includeCopilot`: `true`
 - `quota.includeAnthropic`: `true`
-- `quota.providers`: `{}` (per-adapter switches, for example `rightcode.enabled`)
+- `quota.providers`: `{}` (per-adapter switches, for example `rightcode.enabled` or `buzz.enabled`)
 - `quota.refreshAccessToken`: `false`
 - `quota.requestTimeoutMs`: `8000` (clamped to `>=1000`)
 
@@ -201,7 +238,7 @@ Other defaults:
 - `toast.durationMs`: `12000` (clamped to `>=1000`)
 - `retentionDays`: `730`
 
-Example config:
+### Full example config
 
 ```json
 {
@@ -223,6 +260,9 @@ Example config:
     "includeCopilot": true,
     "includeAnthropic": true,
     "providers": {
+      "buzz": {
+        "enabled": true
+      },
       "rightcode": {
         "enabled": true
       }
@@ -237,7 +277,7 @@ Example config:
 }
 ```
 
-Notes:
+### Notes
 
 - `sidebar.showCost` controls API-cost visibility in sidebar title, `quota_summary` markdown report, and toast message.
 - `quota_summary` follows the same reset compaction rules for short windows in its subscription section (`5h` / `1d` / `Daily` show time, long windows show date, RightCode `Exp` stays date-only).
@@ -253,6 +293,30 @@ Notes:
 - `quota.providers` is the extensible per-adapter switch map.
 - If API Cost is `$0.00`, it usually means the model/provider has no pricing mapping in OpenCode at the moment, so equivalent API cost cannot be estimated.
 
+### Buzz provider example
+
+Buzz matching is based on the provider `baseURL`, similar to RightCode. Any OpenAI-compatible provider that points at `https://buzzai.cc` will be recognized by the Buzz adapter and rendered as a balance-only quota source.
+
+Provider options example:
+
+```json
+{
+  "id": "openai",
+  "options": {
+    "baseURL": "https://buzzai.cc",
+    "apiKey": "sk-..."
+  }
+}
+```
+
+The adapter also tolerates `https://buzzai.cc/v1`, but `https://buzzai.cc` is the recommended example.
+
+With that setup, the sidebar/toast quota line will look like:
+
+```text
+Buzz Balance CNY 10.17
+```
+
 ## Rendering examples
 
 These examples show the quota block portion of the sidebar title.
@@ -306,12 +370,28 @@ Copilot
   Monthly 78% Rst 04-01
 ```
 
+2+ providers mixed (window providers + Buzz balance):
+
+```text
+OpenAI
+  5h 78% Rst 05:05
+Copilot
+  Monthly 78% Rst 04-01
+Buzz Balance CNY 10.2
+```
+
 Balance-style quota:
 
 ```text
 RC Balance $260
 ```
 
+Buzz balance quota:
+
+```text
+Buzz Balance CNY 10.17
+```
+
 Multi-detail quota (window + balance):
 
 ```text
@@ -336,6 +416,12 @@ Quota is rendered inline as part of a single-line title:
 <base> | Input ... | Output ... | OpenAI 5h 78%+ | Copilot Monthly 78% | ...
 ```
 
+Mixed with Buzz balance:
+
+```text
+<base> | Input ... | Output ... | OpenAI 5h 78%+ | Copilot Monthly 78% | Buzz Balance CNY 10.2
+```
+
 `quota_summary` also supports an optional `includeChildren` flag (only effective for `period=session`) to override the config per call. For `day`/`week`/`month` periods, children are never merged — each session is counted independently.
 
 ## Debug logging
@@ -354,6 +440,8 @@ Set `OPENCODE_QUOTA_DEBUG=1` to enable debug logging to stderr. This logs:
   - OpenAI Codex: `https://chatgpt.com/backend-api/wham/usage`
   - GitHub Copilot: `https://api.github.com/copilot_internal/user`
   - RightCode: `https://www.right.codes/account/summary`
+  - Buzz: `https://buzzai.cc/v1/dashboard/billing/subscription` and `https://buzzai.cc/v1/dashboard/billing/usage`
+  - Anthropic: `https://api.anthropic.com/api/oauth/usage`
 - **Screen-sharing warning**: Session titles and toasts surface usage/quota
   information. If you are screen-sharing or recording, consider toggling the
   sidebar display off (`/qtoggle` or `quota_show` tool) to avoid leaking
@@ -363,6 +451,8 @@ Set `OPENCODE_QUOTA_DEBUG=1` to enable debug logging to stderr. This logs:
 - OpenAI OAuth token refresh is disabled by default; set
   `quota.refreshAccessToken=true` if you want the plugin to refresh access
   tokens when expired.
+- Anthropic quota currently uses a beta/internal-style OAuth usage endpoint and
+  request header; response fields may change without notice.
 - State/chunk file writes refuse to write through symlinked targets (best-effort defense-in-depth).
 - The `OPENCODE_QUOTA_DATA_HOME` env var overrides the OpenCode data directory
   path (for testing); do not set this in production.

package/SECURITY.md

@@ -24,3 +24,8 @@ We will acknowledge reports as quickly as possible and provide a remediation tim
 - This plugin reads credentials from OpenCode local auth storage; treat all auth data as sensitive.
 - Keep debug logs free of secrets.
 - Prefer fail-closed behavior for writes (already enforced via symlink checks and atomic writes).
+- Quota fetching may contact provider-operated endpoints such as OpenAI, GitHub,
+  RightCode, Buzz, and Anthropic; review any new provider integration for
+  outbound data exposure and header/token handling.
+- Some quota integrations rely on beta or internal-style endpoints; document
+  instability risks clearly and avoid assuming long-term API compatibility.

package/dist/format.js

@@ -181,7 +181,7 @@ function compactQuotaInline(quota) {
         return `${label}${summary ? ` ${summary}` : ''}${hasMore ? '+' : ''}`;
     }
     if (quota.balance) {
-        return `${label} ${formatCurrency(quota.balance.amount, quota.balance.currency)}`;
+        return `${label} Balance ${formatCurrency(quota.balance.amount, quota.balance.currency)}`;
     }
     if (quota.remainingPercent !== undefined) {
         return `${label} ${Math.round(quota.remainingPercent)}%`;

package/dist/providers/index.d.ts

@@ -1,8 +1,9 @@
 import { anthropicAdapter } from './core/anthropic.js';
+import { buzzAdapter } from './third_party/buzz.js';
 import { copilotAdapter } from './core/copilot.js';
 import { openaiAdapter } from './core/openai.js';
 import { QuotaProviderRegistry } from './registry.js';
 import { rightCodeAdapter } from './third_party/rightcode.js';
 export declare function createDefaultProviderRegistry(): QuotaProviderRegistry;
-export { anthropicAdapter, copilotAdapter, openaiAdapter, rightCodeAdapter, QuotaProviderRegistry, };
+export { anthropicAdapter, buzzAdapter, copilotAdapter, openaiAdapter, rightCodeAdapter, QuotaProviderRegistry, };
 export type { AuthUpdate, AuthValue, ProviderResolveContext, QuotaFetchContext, QuotaProviderAdapter, RefreshedOAuthAuth, } from './types.js';

package/dist/providers/index.js

@@ -1,4 +1,5 @@
 import { anthropicAdapter } from './core/anthropic.js';
+import { buzzAdapter } from './third_party/buzz.js';
 import { copilotAdapter } from './core/copilot.js';
 import { openaiAdapter } from './core/openai.js';
 import { QuotaProviderRegistry } from './registry.js';
@@ -6,9 +7,10 @@ import { rightCodeAdapter } from './third_party/rightcode.js';
 export function createDefaultProviderRegistry() {
     const registry = new QuotaProviderRegistry();
     registry.register(rightCodeAdapter);
+    registry.register(buzzAdapter);
     registry.register(openaiAdapter);
     registry.register(copilotAdapter);
     registry.register(anthropicAdapter);
     return registry;
 }
-export { anthropicAdapter, copilotAdapter, openaiAdapter, rightCodeAdapter, QuotaProviderRegistry, };
+export { anthropicAdapter, buzzAdapter, copilotAdapter, openaiAdapter, rightCodeAdapter, QuotaProviderRegistry, };

package/dist/providers/third_party/buzz.d.ts

@@ -0,0 +1,2 @@
+import type { QuotaProviderAdapter } from '../types.js';
+export declare const buzzAdapter: QuotaProviderAdapter;

package/dist/providers/third_party/buzz.js

@@ -0,0 +1,156 @@
+import { isRecord, swallow } from '../../helpers.js';
+import { asNumber, configuredProviderEnabled, fetchWithTimeout, sanitizeBaseURL, toIso, } from '../common.js';
+function isBuzzBaseURL(value) {
+    const normalized = sanitizeBaseURL(value);
+    if (!normalized)
+        return false;
+    try {
+        const parsed = new URL(normalized);
+        if (parsed.protocol !== 'https:')
+            return false;
+        return parsed.host === 'buzzai.cc' || parsed.host === 'www.buzzai.cc';
+    }
+    catch {
+        return false;
+    }
+}
+function resolveApiKey(auth, providerOptions) {
+    const optionKey = providerOptions?.apiKey;
+    if (typeof optionKey === 'string' && optionKey)
+        return optionKey;
+    if (!auth)
+        return undefined;
+    if (auth.type === 'api' && typeof auth.key === 'string' && auth.key) {
+        return auth.key;
+    }
+    if (auth.type === 'wellknown') {
+        if (typeof auth.key === 'string' && auth.key)
+            return auth.key;
+        if (typeof auth.token === 'string' && auth.token)
+            return auth.token;
+    }
+    if (auth.type === 'oauth' && typeof auth.access === 'string' && auth.access) {
+        return auth.access;
+    }
+    return undefined;
+}
+function dashboardUrl(baseURL, pathname) {
+    const normalized = sanitizeBaseURL(baseURL);
+    if (normalized) {
+        try {
+            return new URL(pathname, normalized).toString();
+        }
+        catch {
+            // Fall through to the stable default host below.
+        }
+    }
+    return `https://buzzai.cc${pathname}`;
+}
+async function fetchBuzzQuota({ sourceProviderID, providerID, providerOptions, auth, config, }) {
+    const checkedAt = Date.now();
+    const runtimeProviderID = typeof sourceProviderID === 'string' && sourceProviderID
+        ? sourceProviderID
+        : providerID;
+    const base = {
+        providerID: runtimeProviderID,
+        adapterID: 'buzz',
+        label: 'Buzz',
+        shortLabel: 'Buzz',
+        sortOrder: 6,
+    };
+    const apiKey = resolveApiKey(auth, providerOptions);
+    if (!apiKey) {
+        return {
+            ...base,
+            status: 'unavailable',
+            checkedAt,
+            note: 'missing api key',
+        };
+    }
+    const subscriptionEndpoint = dashboardUrl(providerOptions?.baseURL, '/v1/dashboard/billing/subscription');
+    const usageEndpoint = dashboardUrl(providerOptions?.baseURL, '/v1/dashboard/billing/usage');
+    const requestInit = {
+        headers: {
+            Accept: 'application/json',
+            Authorization: `Bearer ${apiKey}`,
+            'User-Agent': 'opencode-quota-sidebar',
+        },
+    };
+    const [subscriptionResponse, usageResponse] = await Promise.all([
+        fetchWithTimeout(subscriptionEndpoint, requestInit, config.quota.requestTimeoutMs).catch(swallow('fetchBuzzQuota:subscription')),
+        fetchWithTimeout(usageEndpoint, requestInit, config.quota.requestTimeoutMs).catch(swallow('fetchBuzzQuota:usage')),
+    ]);
+    if (!subscriptionResponse || !usageResponse) {
+        return {
+            ...base,
+            status: 'error',
+            checkedAt,
+            note: 'network request failed',
+        };
+    }
+    if (!subscriptionResponse.ok || !usageResponse.ok) {
+        const note = [
+            !subscriptionResponse.ok
+                ? `subscription http ${subscriptionResponse.status}`
+                : undefined,
+            !usageResponse.ok ? `usage http ${usageResponse.status}` : undefined,
+        ]
+            .filter((value) => Boolean(value))
+            .join(', ');
+        return {
+            ...base,
+            status: 'error',
+            checkedAt,
+            note,
+        };
+    }
+    const [subscriptionPayload, usagePayload] = await Promise.all([
+        subscriptionResponse
+            .json()
+            .catch(swallow('fetchBuzzQuota:subscriptionJson')),
+        usageResponse.json().catch(swallow('fetchBuzzQuota:usageJson')),
+    ]);
+    if (!isRecord(subscriptionPayload) || !isRecord(usagePayload)) {
+        return {
+            ...base,
+            status: 'error',
+            checkedAt,
+            note: 'invalid response',
+        };
+    }
+    const totalQuota = asNumber(subscriptionPayload.soft_limit_usd);
+    const totalUsage = asNumber(usagePayload.total_usage);
+    if (totalQuota === undefined || totalUsage === undefined) {
+        return {
+            ...base,
+            status: 'error',
+            checkedAt,
+            note: 'missing billing fields',
+        };
+    }
+    const accessUntil = asNumber(subscriptionPayload.access_until);
+    const resetAt = accessUntil !== undefined && accessUntil > 0
+        ? toIso(accessUntil)
+        : undefined;
+    const balance = totalQuota - totalUsage / 100;
+    return {
+        ...base,
+        status: 'ok',
+        checkedAt,
+        resetAt,
+        balance: {
+            amount: balance,
+            currency: 'CNY ',
+        },
+        note: 'remaining balance = soft_limit_usd - total_usage / 100',
+    };
+}
+export const buzzAdapter = {
+    id: 'buzz',
+    label: 'Buzz',
+    shortLabel: 'Buzz',
+    sortOrder: 6,
+    matchScore: ({ providerOptions }) => isBuzzBaseURL(providerOptions?.baseURL) ? 100 : 0,
+    isEnabled: (config) => configuredProviderEnabled(config.quota, 'buzz', true),
+    fetch: fetchBuzzQuota,
+};

package/dist/quota_service.js

@@ -2,6 +2,11 @@ import { TtlValueCache } from './cache.js';
 import { isRecord, swallow } from './helpers.js';
 import { listDefaultQuotaProviderIDs, loadAuthMap, quotaSort } from './quota.js';
 export function createQuotaService(deps) {
+    const ERROR_CACHE_TTL_MS = 30_000;
+    const ZERO_QUOTA_CACHE_TTL_MS = 15_000;
+    const LOW_QUOTA_CACHE_TTL_MS = 30_000;
+    const SOON_RESET_CACHE_TTL_MS = 15_000;
+    const SOON_RESET_WINDOW_MS = 2 * 60 * 1000;
     const authCache = new TtlValueCache();
     const providerOptionsCache = new TtlValueCache();
     const inFlight = new Map();
@@ -75,6 +80,62 @@ export function createQuotaService(deps) {
             return false;
         return true;
     };
+    const parseResetAtMs = (value) => {
+        if (!value)
+            return undefined;
+        const parsed = Date.parse(value);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    };
+    const snapshotRemainingPercents = (snapshot) => {
+        const values = [];
+        if (typeof snapshot.remainingPercent === 'number' &&
+            Number.isFinite(snapshot.remainingPercent)) {
+            values.push(snapshot.remainingPercent);
+        }
+        if (snapshot.windows && snapshot.windows.length > 0) {
+            for (const window of snapshot.windows) {
+                if (typeof window.remainingPercent === 'number' &&
+                    Number.isFinite(window.remainingPercent)) {
+                    values.push(window.remainingPercent);
+                }
+            }
+        }
+        return values;
+    };
+    const snapshotResetTimes = (snapshot) => {
+        const values = [];
+        const topLevel = parseResetAtMs(snapshot.resetAt);
+        if (topLevel !== undefined)
+            values.push(topLevel);
+        if (snapshot.windows && snapshot.windows.length > 0) {
+            for (const window of snapshot.windows) {
+                const parsed = parseResetAtMs(window.resetAt);
+                if (parsed !== undefined)
+                    values.push(parsed);
+            }
+        }
+        return values;
+    };
+    const effectiveQuotaCacheTtl = (snapshot, now = Date.now()) => {
+        let ttlMs = deps.config.quota.refreshMs;
+        if (snapshot.status !== 'ok') {
+            ttlMs = Math.min(ttlMs, ERROR_CACHE_TTL_MS);
+        }
+        const remainingPercents = snapshotRemainingPercents(snapshot);
+        if (remainingPercents.some((value) => value <= 0)) {
+            ttlMs = Math.min(ttlMs, ZERO_QUOTA_CACHE_TTL_MS);
+        }
+        else if (remainingPercents.some((value) => value <= 1)) {
+            ttlMs = Math.min(ttlMs, LOW_QUOTA_CACHE_TTL_MS);
+        }
+        const resetTimes = snapshotResetTimes(snapshot);
+        if (resetTimes.some((resetAt) => resetAt <= now))
+            return 0;
+        if (resetTimes.some((resetAt) => resetAt - now <= SOON_RESET_WINDOW_MS)) {
+            ttlMs = Math.min(ttlMs, SOON_RESET_CACHE_TTL_MS);
+        }
+        return Math.max(0, ttlMs);
+    };
     const getQuotaSnapshots = async (providerIDs, options) => {
         const allowDefault = options?.allowDefault === true;
         const [authMap, providerOptionsMap] = await Promise.all([
@@ -148,8 +209,9 @@ export function createQuotaService(deps) {
             const baseKey = deps.quotaRuntime.quotaCacheKey(providerID, providerOptions);
             const cacheKey = `${baseKey}#${authScopeFor(providerID, providerOptions)}`;
             const cached = deps.state.quotaCache[cacheKey];
-            if (cached &&
-                Date.now() - cached.checkedAt <= deps.config.quota.refreshMs) {
+            const now = Date.now();
+            const cacheTtl = cached ? effectiveQuotaCacheTtl(cached, now) : 0;
+            if (cached && cacheTtl > 0 && now - cached.checkedAt <= cacheTtl) {
                 if (isValidQuotaCache(cached))
                     return Promise.resolve(cached);
                 delete deps.state.quotaCache[cacheKey];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leo000001/opencode-quota-sidebar",
-  "version": "1.13.1",
+  "version": "1.13.3",
   "description": "OpenCode plugin that shows quota and token usage in session titles",
   "type": "module",
   "main": "dist/index.js",