opencode-usage-report 0.6.2 → 0.6.4

package/README.md

@@ -4,329 +4,145 @@
 [![CI](https://github.com/kaanchinar/opencode-usage-report/actions/workflows/ci.yml/badge.svg)](https://github.com/kaanchinar/opencode-usage-report/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/npm/l/opencode-usage-report)](./LICENSE)
 
-An [opencode](https://opencode.ai) plugin that shows how much of your inference
-subscriptions you have left. It adds a `/usage` command and a `usage_report`
-tool covering both the **context window** of the current session and the
-**quota windows** (5-hour, weekly, monthly) of your provider plans —
-**Kimi Code** (`kimi-code-plan-global` on kimi.ai and `kimi-code-plan-cn` on
-kimi.com), **OpenCode Go** (`opencode-go`), **GitHub Copilot**
-(`github-copilot`) and **ChatGPT** (`openai`). Results are cached on disk, fall
-back to a local estimate when an API is unreachable, and raise background
-low-quota toasts in the TUI.
+See how much of your AI subscriptions you have left, right inside [opencode](https://opencode.ai).
+
+Adds a `/usage` dialog, a sidebar panel and a `usage_report` tool that show your plan's quota windows and how full the current session's context is.
+
+```text
+Context
+Kimi K2 (High) · 42,318 / 200,000 tokens (21.2%)
+Auto-compacts at 180,000 · 137,682 headroom        $0.42 spent
+
+Kimi Code (kimi.ai)
+5h limit      █████████░░░░░ 62% resets in 2h 14m
+Weekly limit  ████░░░░░░░░░░ 31% resets in 4d 6h
+
+GitHub Copilot
+Monthly limit ██░░░░░░░░░░░░ 12% resets in 18d 3h
+```
 
 ## Features
 
-- `/usage` command and `usage_report` tool for on-demand quota reports, with
-  JSON output and single-provider filtering.
-- **Context usage panel** (new in 0.4.0) — the exact prompt-token total against
-  the model's context window, a cell grid that fills by category, the
-  auto-compaction point with live headroom, and session cost.
-- TUI sidebar panel with live progress bars, `NN%` usage and reset countdowns
-  for every quota window.
-- On-disk caching with a configurable TTL, plus an explicit refresh that
-  bypasses it.
-- Local fallback estimate when a provider API is unreachable and no cache
-  exists.
-- Low-quota warnings on startup and on `session.idle`.
-- Privacy-first: API keys are never logged, cached, or rendered.
-
-## Install
-
-The plugin exposes **two entrypoints** and opencode loads them from two
-different config files. Install both for the full experience:
-
-| Config          | Entrypoint    | Provides                                                |
-| --------------- | ------------- | ------------------------------------------------------- |
-| `opencode.json` | server plugin | `usage_report` tool, low-quota warnings, prompt capture |
-| `tui.json`      | TUI plugin    | `/usage` command, sidebar panel                         |
-
-The quickest path is opencode's own installer, which detects both entrypoints
-and writes both configs for you:
+- Quota windows with progress bars and reset countdowns
+- Context breakdown by category, with auto-compaction headroom and session cost
+- `/usage` runs locally and costs no model tokens
+- Low-quota toasts in the TUI
+- Disk cache, with a local estimate when a provider API is unreachable
+
+## Supported providers
+
+| Provider             | ID                      | Usage API        |
+| -------------------- | ----------------------- | ---------------- |
+| Kimi Code (kimi.ai)  | `kimi-code-plan-global` | `api.kimi.ai`    |
+| Kimi Code (kimi.com) | `kimi-code-plan-cn`     | `api.kimi.com`   |
+| OpenCode Go          | `opencode-go`           | `opencode.ai`    |
+| GitHub Copilot       | `github-copilot`        | `api.github.com` |
+| ChatGPT              | `openai`                | `chatgpt.com`    |
+
+## Installation
+
+Requires opencode 1.18.29 or later, including 2.x.
 
 ```sh
-opencode plugin opencode-usage-report          # project scope (./.opencode)
-opencode plugin -g opencode-usage-report       # global scope
+opencode plugin -g opencode-usage-report
 ```
 
-Or add the plugin manually to each file and restart opencode:
+Omit `-g` to install for the current project only. Restart opencode afterwards.
+
+<details>
+<summary>Manual installation</summary>
+
+The plugin has two entrypoints, so add it to both config files:
 
 ```jsonc
-// opencode.json — server plugin
-{
-  "plugin": ["opencode-usage-report"],
-}
+// opencode.json: usage_report tool, low-quota warnings
+{ "plugin": ["opencode-usage-report"] }
 ```
 
 ```jsonc
-// tui.json — TUI plugin
-{
-  "plugin": ["opencode-usage-report"],
-}
+// tui.json: /usage dialog, sidebar panel
+{ "plugin": ["opencode-usage-report"] }
 ```
 
-> **Use the bare package name in both files.** opencode reads the package
-> `exports` map itself and resolves `exports["./tui"]` for the TUI and
-> `exports["./server"]` (or `main`) for the server. A subpath spec such as
-> `opencode-usage-report/tui` is **not** valid and will silently load nothing.
-> `opencode plugin opencode-usage-report` prints `Detected server + tui targets`
-> when the resolution works.
+Use the bare package name in both files. A subpath such as `opencode-usage-report/tui` silently loads nothing.
 
-> **OpenCode 2.x (0.6.0).** Both entrypoints now default-export a dual
-> definition. The server entrypoint exports `{ id, setup, server }` — V2 calls
-> `setup`, V1 calls `server`. The TUI entrypoint exports `{ id, setup, tui }` —
-> V2 calls `setup` (its `keymap.layer` runs from a headless `app`-slot
-> component), V1 calls `tui`. OpenCode 2's TUI loader rejects a default export
-> without a `setup` function (`Invalid V2 TUI plugin module`); before 0.6.0 the
-> TUI module exported only the V1 `tui` shape and failed to load on 2.x.
-> OpenCode 1.18.29+ and 2.x both load either entrypoint.
-
-Options can be passed in the tuple form, independently per entrypoint:
-
-```jsonc
-{
-  "plugin": [["opencode-usage-report", { "thresholdPercent": 75 }]],
-}
-```
+</details>
 
-### Local development
+## Usage
 
-Point the configs at the source instead of the published package. Config is read
-once at startup and is not hot-reloaded, so restart opencode after every edit:
+### `/usage`
 
-```jsonc
-// opencode.json
-{ "plugin": ["file:///abs/path/to/opencode-usage-report/src/index.ts"] }
-// tui.json
-{ "plugin": ["file:///abs/path/to/opencode-usage-report/src/tui.tsx"] }
-```
+Opens the report dialog. Providers without a credential are skipped.
 
-## Commands
+| Key   | Action                   |
+| ----- | ------------------------ |
+| `r`   | Refresh now              |
+| `tab` | Cycle provider scope     |
+| `j`   | Toggle the raw JSON view |
+| `esc` | Close                    |
 
-- `/usage` — open the report dialog: the context panel for the current session
-  on top, and every configured provider's quota windows below. This is a local
-  TUI command, so it costs no model tokens. Requires the TUI plugin. Providers
-  whose credential cannot be resolved are skipped in this view.
-- `/usage` dialog keys — `esc` close, `r` refresh now, `tab` cycle provider
-  scope (all → each provider), `j` toggle the raw JSON view.
-- `usage_report` tool — the same report for agents and headless runs. Takes
-  `provider` (exact id: `kimi-code-plan-global`, `kimi-code-plan-cn`,
-  `opencode-go`, `github-copilot` or `openai`; an unknown id returns an error
-  listing the known ids), `json` (raw `ProviderReport[]`) and `refresh` (bypass
-  the on-disk cache).
+Press `ctrl+shift+u` to refresh the sidebar panel.
 
-> **Changed in 0.4.0.** `/usage` used to be an LLM-mediated prompt template that
-> routed through the model, and it accepted `--json` / `--refresh` / a provider
-> id as slash arguments. The TUI command now owns the name, so `/usage` reaches
-> no model and those capabilities moved to the dialog keys and the
-> `usage_report` tool arguments. Running `/usage --json` is no longer supported.
+### `usage_report` tool
 
-## Context usage panel
+The same report for agents and headless runs.
 
-The top of the `/usage` dialog reports how full the model's context window is
-for the current session:
+| Argument   | Type      | Description                        |
+| ---------- | --------- | ---------------------------------- |
+| `provider` | `string`  | Report one provider, by exact ID   |
+| `json`     | `boolean` | Return raw `ProviderReport[]` JSON |
+| `refresh`  | `boolean` | Bypass the disk cache              |
 
-```
-  Context
-  Kimi K2 (High) · 42,318 / 200,000 tokens (21.2%)
-
-  ████████████████████████████  ████████████████████████████████  ████████████  ░░░░░░░░░░░░░░
-  ████████████████████████████  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░
-  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░
-  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░
-  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░
-  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░  ░░░░░░░░░░░░░░
-
-  ● User messages      8,204   4.1%      ● System & tools    8,144   4.1%
-  ● Agent responses   11,650   5.8%      ● Free space     157,682  78.8%
-  ● Reasoning          2,140   1.1%
-  ● Tool calls        12,180   6.1%
-
-  Auto-compacts at 180,000 · 137,682 headroom        $0.42 spent
-```
+### Context accuracy
 
-**What is exact.** The headline total, the percentage, free space, the
-compaction point, the cost and the number of pruned tool outputs all come from
-numbers the provider and opencode report. The total is the prompt size —
-`input + cache.read + cache.write` — which is what actually occupies the context
-window. opencode's own sidebar Context block sums five fields including the
-completion, so it reads slightly higher than this panel by design.
-
-**What is estimated.** The per-category rows. opencode records no token count
-per message or part, so each category is estimated with the same `characters / 4`
-heuristic opencode itself uses, then normalized so the rows agree with the exact
-total.
-
-**System & tools.** opencode assembles the system prompt and tool definitions on
-every request and never persists them. The server plugin measures the real
-system string through the `experimental.chat.system.transform` hook and stores
-only its size, so the row can be split into `system prompt` and
-`tools & framing`. That hook is undocumented, so it is treated as best-effort:
-if it stops firing, the sidecar goes stale, or anything fails to validate, the
-panel falls back to the derived residual and labels the row `(derived)`. The
-plugin never breaks a request over it.
-
-**Compaction headroom.** `Auto-compacts at N` mirrors opencode's own overflow
-check, including the configured `compaction.reserved` buffer. This is the point
-at which opencode automatically summarizes the session — a number opencode
-exposes nowhere else.
-
-## Options
-
-Shared by both entrypoints:
-
-| Option             | Type               | Default | Meaning                                                      |
-| ------------------ | ------------------ | ------- | ------------------------------------------------------------ |
-| `thresholdPercent` | `number`           | `80`    | Warn when a window is at/above this percent used.            |
-| `cacheTtlSeconds`  | `number`           | `120`   | How long a cached API result is considered fresh.            |
-| `providers`        | `string[] \| null` | `null`  | Providers to report; `null` = every registered adapter.      |
-| `fallback`         | `boolean`          | `true`  | Use a local estimate when the API fails and no cache exists. |
-
-TUI only:
-
-| Option                   | Type     | Default | Meaning                                            |
-| ------------------------ | -------- | ------- | -------------------------------------------------- |
-| `refreshIntervalSeconds` | `number` | `60`    | Sidebar/dialog refresh cadence, clamped to 5–3600. |
-| `barWidth`               | `number` | `14`    | Progress-bar width in cells, clamped to 4–40.      |
-
-`fallback` is fixed at `true` for the TUI entrypoint. Malformed option values
-are ignored and the defaults are kept.
-
-## Warnings
-
-On startup and again on `session.idle` (both throttled to at most once every
-10 minutes, sharing one timer), the plugin checks the cached reports. Any window
-at or above `thresholdPercent`, or whose status is `rate-limited` / `frozen`,
-produces a TUI toast. A warning fires once per window until that window resets;
-it re-arms after usage drops below `thresholdPercent - 10`. Toast failures
-(headless/server mode) are swallowed.
-
-## Data sources & privacy
-
-- **Credential resolution order.** First `OPENCODE_USAGE_<ID>_KEY` (optionally
-  paired with `OPENCODE_USAGE_<ID>_ACCOUNT_ID`, e.g.
-  `OPENCODE_USAGE_OPENAI_ACCOUNT_ID`, to supply the ChatGPT account id), then
-  `~/.local/share/opencode/auth.json`: a `type: "api"` entry's `.key`, or a
-  `type: "oauth"` entry's `.access` (falling back to `.refresh` for GitHub
-  Copilot, which stores its token there). For ChatGPT the oauth entry's
-  `.accountId` is read automatically. `$OPENCODE_DATA_HOME` overrides the data
-  directory.
-- **APIs.** `https://api.kimi.ai/coding/v1/usages` (global plan),
-  `https://api.kimi.com/coding/v1/usages` (China plan),
-  `https://opencode.ai/zen/go/v1/usage` (requires a custom `User-Agent`),
-  `https://api.github.com/copilot_internal/user` (GitHub Copilot) and
-  `https://chatgpt.com/backend-api/wham/usage` (ChatGPT).
-- **Auth.** Run `opencode auth login` and pick **GitHub Copilot** or **OpenAI
-  ChatGPT**. ChatGPT additionally needs the account id that login writes to
-  `auth.json`; the plugin reads it automatically.
-- **Cache and state** live in `<data-home>/usage-report/`: the TTL cache, the
-  session id, the warn state, and `context/<sessionID>.json` — the system-prompt
-  size sidecar, which holds counts only and never prompt text.
-- **Local fallback** reads `opencode.db` read-only.
-- **API keys are never logged, cached, or rendered.** Adapter errors are
-  sanitized (key substrings replaced with `<redacted>`) before they reach any
-  output, and the live smoke script never prints credentials.
+- **Exact:** the total, percentage, free space, compaction point and cost. The total is the prompt size (`input + cache.read + cache.write`), so it reads slightly lower than opencode's own sidebar, which also counts the completion.
+- **Estimated:** the per-category rows, because opencode records no per-message token counts. They use `characters / 4`, then scale to match the exact total.
+- **`(derived)`:** the system prompt size could not be measured, so the row is the remainder of the total.
 
-## Troubleshooting
+## Configuration
 
-**`/usage` does not appear in the command list.**
-Both configs are required — the command comes from the TUI plugin, not the
-server plugin. Check that `tui.json` lists `"opencode-usage-report"` (bare name)
-and restart opencode; config is not hot-reloaded. To confirm the package exposes
-what opencode expects, run `opencode plugin opencode-usage-report` — it should
-print `Detected server + tui targets`.
+Pass options with the tuple form. Each entrypoint reads its own options, so set them in `opencode.json`, `tui.json`, or both.
 
-**The sidebar is empty and no providers are reported.**
-Every window belongs to a provider whose credential could not be resolved, so it
-is skipped. Run `opencode auth login`, or set
-`OPENCODE_USAGE_<ID>_KEY` for the provider in question.
+```jsonc
+{
+  "plugin": [["opencode-usage-report", { "thresholdPercent": 75 }]],
+}
+```
 
-**An old version keeps loading after you upgrade.**
-opencode caches installed plugin packages under
-`~/.cache/opencode/packages/<name>@latest/` and re-resolves versions on install,
-not on every start. Re-run `opencode plugin opencode-usage-report`, or delete
-that cache directory, to force a refresh. This is the usual cause of "I
-published a new version but opencode still runs the old one".
+| Option                   | Type               | Default | Entrypoint | Description                                                 |
+| ------------------------ | ------------------ | ------- | ---------- | ----------------------------------------------------------- |
+| `thresholdPercent`       | `number`           | `80`    | both       | Warn when a window reaches this percentage                  |
+| `cacheTtlSeconds`        | `number`           | `120`   | both       | How long a cached API result stays fresh                    |
+| `providers`              | `string[] \| null` | `null`  | both       | Providers to report; `null` means all                       |
+| `fallback`               | `boolean`          | `true`  | server     | Use a local estimate when the API fails and no cache exists |
+| `refreshIntervalSeconds` | `number`           | `60`    | TUI        | Refresh cadence, clamped to 5–3600                          |
+| `barWidth`               | `number`           | `14`    | TUI        | Progress bar width in cells, clamped to 4–40                |
 
-**Quota numbers look stale or marked `(stale)` / `(est)`.**
-`(stale)` means a cached result was served past its TTL without a successful
-refresh; `(est)` means the API was unreachable and a local estimate was used.
-Press `r` in the dialog (or `ctrl+shift+u` in the sidebar) to force a refetch.
+Invalid values are ignored and the default is kept.
 
-## Extending
+## Credentials and privacy
 
-New providers are trivial:
+Run `opencode auth login` to sign in. The plugin reads credentials in this order:
 
-1. Implement `ProviderAdapter` (`src/types.ts`) — an `id`, `displayName`, and
-   `fetch(cred, opts)` returning `{ windows, extras? }`.
-2. Register it in `src/providers/index.ts` (`adapters` array).
-3. Add fixture-driven tests under `test/`.
+1. `OPENCODE_USAGE_<ID>_KEY`, where `<ID>` is the provider ID in uppercase with non-alphanumeric characters replaced by `_`, for example `OPENCODE_USAGE_KIMI_CODE_PLAN_GLOBAL_KEY`. For ChatGPT, also set `OPENCODE_USAGE_OPENAI_ACCOUNT_ID`.
+2. `~/.local/share/opencode/auth.json`. Set `$OPENCODE_DATA_HOME` to use another data directory.
 
-Reference endpoints for future adapters (not built in v1):
+Keys are never logged, cached or rendered, and adapter errors are redacted before output. The plugin contacts only the usage APIs listed above. Cached reports and plugin state live in `<data-home>/usage-report/`, and the local estimate reads `opencode.db` read-only. The plugin stores the size of your system prompt, never its text.
 
-- **Gemini**: `cloudcode-pa.googleapis.com/v1internal:retrieveUserQuota`
-  (requires Google OAuth).
-- **Claude**: `api.anthropic.com/api/oauth/usage` (requires
-  `anthropic-beta: oauth-2025-04-20`, the claude-code User-Agent, and
-  `~/.claude/.credentials.json`).
+## Troubleshooting
 
-## Development
+**`/usage` is missing.** The command comes from the TUI entrypoint. Check that `tui.json` lists the bare package name, then restart opencode. Running `opencode plugin opencode-usage-report` should print `Detected server + tui targets`.
 
-```sh
-npm run lint                      # oxlint
-npm run lint:fix                  # oxlint --fix
-npm run format                    # oxfmt (write in place)
-npm run format:check              # oxfmt --check
-npm test                          # vitest, no network
-npm run typecheck                 # tsc --noEmit
-npm run check                     # lint + format:check + typecheck + test
-npm run smoke -- --yes-live       # manual live check (real keys; opt-in)
-```
+**No providers are reported.** No credential could be resolved. Run `opencode auth login` or set `OPENCODE_USAGE_<ID>_KEY`.
 
-## Releasing
+**An old version keeps loading.** opencode caches packages in `~/.cache/opencode/packages/<name>@latest/`. Re-run `opencode plugin opencode-usage-report` or delete that directory.
 
-Releases are **staged**, not published directly. Pushing a `v*` tag triggers
-`.github/workflows/publish.yml`, which verifies that the tag matches
-`package.json`, runs `npm ci`, and uploads the tarball with
-`npm stage publish --provenance --access public` using npm Trusted Publishing
-(OIDC — no `NPM_TOKEN` secret). Nothing goes live until a maintainer approves
-the staged release with 2FA:
+**Numbers show `(stale)` or `(est)`.** `(stale)` is a cached result past its TTL. `(est)` is a local estimate used because the API was unreachable. Press `r` in the dialog to refetch.
 
-```sh
-git tag v0.4.1 && git push origin main v0.4.1
-npm stage list                    # find the stage id
-npm stage approve <stage-id>      # 2FA prompt; or approve in the npm UI
-```
+## Contributing
 
-`prepublishOnly` runs lint, format check, typecheck and tests before the upload,
-so a failing check blocks the stage.
-
-## Changelog
-
-- **0.6.2** — OpenCode 2 context panel fixes: the V2 adapter now reads the
-  model id from the store's `model.id`, so the model lookup succeeds and the
-  cell grid, per-category percentages and compaction-headroom line render
-  again instead of `—`; the translated messages also carry the session id, and
-  the system-prompt capture anchors its freshness check to the turn's user
-  message — OpenCode 2 fires the capture hook just before the assistant
-  message is stamped, which previously marked every capture `(derived)`.
-- **0.6.1** — Kimi Code adapter tracks the 2026-09 quota-model API change:
-  usage windows now come from the `usages.limit_5h` / `limit_7d` /
-  `limit_month_total` ratios (with a `limit_month_code` breakdown), and Extra
-  Usage is read from the camelCase `boosterWallet` (fixed-point `BOOSTER`
-  balance). The pre-2026-09 `usage` / `limits[]` / `totalQuota` /
-  `booster_wallet` shapes remain as fallbacks.
-- **0.4.1** — internal: shared provider HTTP plumbing (`src/providers/http.ts`)
-  replaces the copy-pasted fetch/retry/error code; context estimates simplified;
-  reset times render as `Wed, Sep 16`.
-- **0.4.0** — context usage panel (`/usage` now shows context breakdown, grid,
-  compaction headroom and cost); `/usage` became a local TUI command that costs
-  no model tokens; sidebar rendering extracted to `src/quota-lines.ts`.
-- **0.3.0** — GitHub Copilot and ChatGPT (OpenAI) adapters.
-- **0.2.0** — Kimi Code split into the kimi.ai (`kimi-code-plan-global`) and
-  kimi.com (`kimi-code-plan-cn`) plans.
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and adding a provider, and [CHANGELOG.md](./CHANGELOG.md) for release history. Report vulnerabilities as described in [SECURITY.md](./SECURITY.md).
 
 ## License
 
-MIT © [Kaan Chinar](https://github.com/kaanchinar)
-
-Security policy: [SECURITY.md](./SECURITY.md)
+[MIT](./LICENSE) © [Kaan Chinar](https://github.com/kaanchinar)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-usage-report",
-  "version": "0.6.2",
-  "description": "opencode plugin: /usage command showing subscription quota windows for configured providers",
+  "version": "0.6.4",
+  "description": "opencode plugin: /usage dialog, sidebar panel and usage_report tool for subscription quota and context usage",
   "keywords": [
     "kimi",
     "opencode",
@@ -48,10 +48,10 @@
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.0.0",
-    "@opentui/core": "^0.5.11",
+    "@opentui/core": "^0.6.2",
     "@opentui/solid": "^0.5.11",
     "@types/node": "^26.6.2",
-    "oxfmt": "^0.70.0",
+    "oxfmt": "^0.72.0",
     "oxlint": "^1.85.0",
     "solid-js": "1.9.12",
     "tsx": "^4.19.0",
@@ -63,5 +63,11 @@
     "@opentui/core": ">=0.5.11",
     "@opentui/solid": ">=0.5.11",
     "solid-js": ">=1.9.0"
+  },
+  "overrides": {
+    "seroval": "1.6.9",
+    "seroval-plugins": "1.6.9",
+    "toml": "5.0.1",
+    "zod": "4.6.7"
   }
 }

package/src/context/dialog.tsx

@@ -1,7 +1,7 @@
 /** @jsxImportSource @opentui/solid */
 import type { TuiPluginApi } from "@opencode-ai/plugin/tui";
 import type { AssistantMessage, Model } from "@opencode-ai/sdk/v2";
-import { For, Show, createMemo } from "solid-js";
+import { For, Show, createMemo, onCleanup } from "solid-js";
 import { buildContextLines, type ContextTone } from "./format";
 import { collectContext } from "./collect";
 import { captureIsFresh, captureSince } from "./system";
@@ -24,6 +24,10 @@ export interface UsageDialogProps {
   system: () => SystemCapture | null;
   scope: () => number;
   showJson: () => boolean;
+  /** Fires on any panel change the dialog must re-read. */
+  subscribe: (listener: () => void) => () => void;
+  /** Re-renders the whole dialog; OpenCode loads this module on a separate Solid runtime. */
+  rerender: () => void;
   barWidth: number;
 }
 
@@ -73,6 +77,11 @@ function jsonLines(value: unknown): RenderedLine[] {
 export function UsageDialog(props: UsageDialogProps) {
   const theme = () => props.api.theme.current;
 
+  // OpenCode loads this module against a different Solid runtime than the
+  // plugin entry, so signals never track across the two. Ask the host to
+  // re-render the dialog instead.
+  onCleanup(props.subscribe(props.rerender));
+
   const messages = createMemo(() =>
     props.sessionID === null ? [] : props.api.state.session.messages(props.sessionID),
   );

package/src/providers/kimi.ts

@@ -161,13 +161,18 @@ function parse(body: Record<string, unknown>, cred: Credential): AdapterResult {
 
   // Count-based windows are authoritative when present; the `usages.limit_*`
   // ratios are the primary wire on the post-2026-09 quota model, where the
-  // absolute `usage`/`limits[]` rows were removed.
+  // absolute `usage`/`limits[]` rows were removed. Some regional responses
+  // send a limits[] 5h row with no counts, so fall back to its ratio instead
+  // of rendering an empty bar.
   const detail5h = findLimitDetail(limits, 300);
-  if (detail5h !== undefined) {
-    windows.push(detailWindow("5h", "5-hour", detail5h));
-  } else {
-    const limit5h = pick(usages, "limit_5h");
-    if (limit5h !== undefined) windows.push(ratioWindow("5h", "5-hour", limit5h));
+  const limit5h = pick(usages, "limit_5h");
+  const fiveHour = detail5h === undefined ? undefined : detailWindow("5h", "5-hour", detail5h);
+  if (fiveHour !== undefined && fiveHour.usedPercent !== null) {
+    windows.push(fiveHour);
+  } else if (limit5h !== undefined) {
+    windows.push(ratioWindow("5h", "5-hour", limit5h));
+  } else if (fiveHour !== undefined) {
+    windows.push(fiveHour);
   }
 
   if (usage !== undefined) {
@@ -179,12 +184,16 @@ function parse(body: Record<string, unknown>, cred: Credential): AdapterResult {
 
   // The monthly total joined the quota model; `totalQuota` is the legacy shape.
   // `limit_month_code` is the code-typed share the official client shows as a
-  // breakdown under the monthly row.
+  // breakdown under the monthly row. Some regional responses carry the monthly
+  // window as a counted 30-day entry in `limits[]` instead.
   const monthTotal = pick(usages, "limit_month_total");
+  const detailMonth = findLimitDetail(limits, 43200);
   if (monthTotal !== undefined) {
     windows.push(ratioWindow("monthly", "Monthly", monthTotal));
     const codePercent = ratioPercent(pick(usages, "limit_month_code"));
     if (codePercent !== null) extras["Monthly code"] = `${codePercent}%`;
+  } else if (detailMonth !== undefined) {
+    windows.push(detailWindow("monthly", "Monthly", detailMonth));
   } else {
     const totalQuota = pick(body, "totalQuota", "total_quota");
     const quotaUsed = toNumber(pick(totalQuota, "used"));

package/src/tui.tsx

@@ -30,10 +30,33 @@ function createUsagePanel(getSessionID: () => string | null, options: ResolvedTu
   const [error, setError] = createSignal<string | null>(null);
   const [tick, setTick] = createSignal(Date.now());
   const [capture, setCapture] = createSignal<SystemCapture | null>(null);
-  const [scope, setScope] = createSignal(0);
-  const [showJson, setShowJson] = createSignal(false);
+  const [scope, setScopeSignal] = createSignal(0);
+  const [showJson, setShowJsonSignal] = createSignal(false);
   let disposed = false;
 
+  // The dialog lives in another module, which OpenCode can load against a
+  // second Solid runtime; its memos then never track these signals. Plain
+  // subscribers let it bump a signal it owns instead.
+  const listeners = new Set<() => void>();
+  const notify = (): void => {
+    // Snapshot: a listener may re-render the dialog, which resubscribes.
+    for (const listener of Array.from(listeners)) listener();
+  };
+  const subscribe = (listener: () => void): (() => void) => {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  };
+  const setScope = (value: number | ((n: number) => number)): void => {
+    setScopeSignal(value);
+    notify();
+  };
+  const setShowJson = (value: boolean | ((v: boolean) => boolean)): void => {
+    setShowJsonSignal(value);
+    notify();
+  };
+
   const load = async (refresh = false): Promise<void> => {
     if (disposed) return;
     setInFlight((n) => n + 1);
@@ -55,6 +78,7 @@ function createUsagePanel(getSessionID: () => string | null, options: ResolvedTu
       setError(err instanceof Error ? err.message : String(err));
     } finally {
       setInFlight((n) => Math.max(0, n - 1));
+      notify();
     }
   };
 
@@ -63,13 +87,16 @@ function createUsagePanel(getSessionID: () => string | null, options: ResolvedTu
     const sessionID = getSessionID();
     if (sessionID === null) {
       setCapture(null);
+      notify();
       return;
     }
     setCapture(await readCapture(sessionID));
+    notify();
   };
 
   const refresh = (): void => {
     setTick(Date.now());
+    notify();
     void load();
     void refreshCapture();
   };
@@ -88,6 +115,7 @@ function createUsagePanel(getSessionID: () => string | null, options: ResolvedTu
     showJson,
     setScope,
     setShowJson,
+    subscribe,
     load,
     refreshCapture,
     refresh,
@@ -96,6 +124,7 @@ function createUsagePanel(getSessionID: () => string | null, options: ResolvedTu
     dispose: (): void => {
       disposed = true;
       clearInterval(timer);
+      listeners.clear();
     },
   };
 }
@@ -153,28 +182,37 @@ export const tui: TuiPlugin = async (api, rawOptions) => {
   api.lifecycle.onDispose(panel.dispose);
   api.lifecycle.onDispose(api.event.on("session.idle", panel.refresh));
 
+  // V1's replace re-invokes this, so the dialog reads the current panel state.
+  const showDialog = (sessionID: string | null): void => {
+    api.ui.dialog.replace(() => (
+      <UsageDialog
+        api={api}
+        sessionID={sessionID}
+        reports={panel.reports}
+        busy={panel.busy}
+        error={panel.error}
+        now={() => new Date(panel.tick())}
+        system={panel.capture}
+        scope={panel.scope}
+        showJson={panel.showJson}
+        subscribe={panel.subscribe}
+        rerender={() => {
+          if (!panel.isDisposed()) showDialog(sessionID);
+        }}
+        barWidth={options.barWidth}
+      />
+    ));
+    // Must follow replace(): the stack resets the size to "medium".
+    api.ui.dialog.setSize("xlarge");
+  };
+
   const openDialog = (): void => {
     const sessionID = activeSessionID(api);
     void panel.refreshCapture().finally(() => {
       if (panel.isDisposed()) return;
       panel.setScope(0);
       panel.setShowJson(false);
-      api.ui.dialog.replace(() => (
-        <UsageDialog
-          api={api}
-          sessionID={sessionID}
-          reports={panel.reports}
-          busy={panel.busy}
-          error={panel.error}
-          now={() => new Date(panel.tick())}
-          system={panel.capture}
-          scope={panel.scope}
-          showJson={panel.showJson}
-          barWidth={options.barWidth}
-        />
-      ));
-      // Must follow replace(): the stack resets the size to "medium".
-      api.ui.dialog.setSize("xlarge");
+      showDialog(sessionID);
     });
   };
 
@@ -316,27 +354,35 @@ function setup(ctx: V2Context): () => void {
 
   const offIdle = ctx.data.on("session.idle", () => panel.refresh());
 
+  const showDialog = (sessionID: string | null): void => {
+    ctx.ui.dialog.show(() => (
+      <UsageDialog
+        api={api}
+        sessionID={sessionID}
+        reports={panel.reports}
+        busy={panel.busy}
+        error={panel.error}
+        now={() => new Date(panel.tick())}
+        system={panel.capture}
+        scope={panel.scope}
+        showJson={panel.showJson}
+        subscribe={panel.subscribe}
+        rerender={() => {
+          if (!panel.isDisposed()) showDialog(sessionID);
+        }}
+        barWidth={options.barWidth}
+      />
+    ));
+    ctx.ui.dialog.set({ size: "xlarge" });
+  };
+
   const openDialog = (): void => {
     const sessionID = activeSessionID(api);
     void panel.refreshCapture().finally(() => {
       if (panel.isDisposed()) return;
       panel.setScope(0);
       panel.setShowJson(false);
-      ctx.ui.dialog.show(() => (
-        <UsageDialog
-          api={api}
-          sessionID={sessionID}
-          reports={panel.reports}
-          busy={panel.busy}
-          error={panel.error}
-          now={() => new Date(panel.tick())}
-          system={panel.capture}
-          scope={panel.scope}
-          showJson={panel.showJson}
-          barWidth={options.barWidth}
-        />
-      ));
-      ctx.ui.dialog.set({ size: "xlarge" });
+      showDialog(sessionID);
     });
   };