@leo000001/opencode-quota-sidebar 2.0.23 → 3.0.0

package/README.md

@@ -3,21 +3,35 @@
 [![npm version](https://img.shields.io/npm/v/@leo000001/opencode-quota-sidebar.svg)](https://www.npmjs.com/package/@leo000001/opencode-quota-sidebar)
 [![license](https://img.shields.io/npm/l/@leo000001/opencode-quota-sidebar.svg)](https://github.com/xihuai18/opencode-quota-sidebar/blob/main/LICENSE)
 
-OpenCode plugin: show token usage and subscription quota in the session sidebar title.
+OpenCode plugin: show token usage and subscription quota in TUI sidebar panels and compact shared session titles.
 
 ![Example sidebar title with usage and quota](./assets/OpenCode-Quota-Sidebar.png)
 
 ## Install
 
-Add the package name to `plugin` in your `opencode.json`. OpenCode uses Bun to install it automatically on startup:
+The package manifest advertises both `server` and `tui` targets, but OpenCode loads those targets from different config files at runtime.
+
+If you configure the plugin manually, you must add the server entry to `opencode.json` and the TUI entry to `tui.json`:
+
+`opencode.json`
+
+```json
+{
+  "plugin": ["@leo000001/opencode-quota-sidebar@2.0.26"]
+}
+```
+
+`tui.json`
 
 ```json
 {
-  "plugin": ["@leo000001/opencode-quota-sidebar@2.0.1"]
+  "plugin": ["@leo000001/opencode-quota-sidebar@2.0.26"]
 }
 ```
 
-Note for OpenCode `>=1.2.15`: TUI settings (`theme`/`keybinds`/`tui`) moved to `tui.json`, but plugin loading still stays in `opencode.json` (`plugin: []`).
+Note for OpenCode `>=1.2.15`: TUI settings and TUI plugins live in `tui.json`, while server plugins stay in `opencode.json`.
+
+If you use an installer flow that reads `oc-plugin` targets and patches config for you, it can populate both files automatically. Simply having the package installed in `node_modules` or listed only in `opencode.json` is not enough for the TUI runtime to load `./tui`.
 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.
@@ -29,7 +43,9 @@ npm install
 npm run build
 ```
 
-Add the built file to your `opencode.json`:
+Add the built server file to your `opencode.json` and the TUI file to your `tui.json`:
+
+`opencode.json`
 
 ```json
 {
@@ -37,7 +53,18 @@ Add the built file to your `opencode.json`:
 }
 ```
 
-On Windows, use forward slashes: `"file:///D:/Lab/opencode-quota-sidebar/dist/index.js"`
+`tui.json`
+
+```json
+{
+  "plugin": ["file:///ABSOLUTE/PATH/opencode-quota-sidebar/dist/tui.tsx"]
+}
+```
+
+On Windows, use forward slashes, for example:
+
+- `file:///D:/Lab/opencode-quota-sidebar/dist/index.js`
+- `file:///D:/Lab/opencode-quota-sidebar/dist/tui.tsx`
 
 ## Supported quota providers
 
@@ -55,21 +82,16 @@ Want to add support for another provider (Google Antigravity, Zhipu AI, Firmware
 
 ## Features
 
-- TUI session title uses a compact multiline sidebar layout:
-  - line 1: original session title
-  - line 2: blank separator
-  - line 3: compact usage tokens such as `R3 I16.3k O916`
-  - line 4+: compact cache tokens such as `CW300 CR31.4k Cd66%`
-  - optional cost line: `Est$0.12`
-  - quota lines also use compact tokens, for example `XYAI D$31.3/$90 R22:39` or `OAI 5h80 R22:18 W70 R04-03`
-  - short windows (`5h`, `1d`, `Daily`) still show same-day resets as `HH:MM` and cross-day resets as `MM-DD HH:MM`; longer windows continue to show `MM-DD`
-  - long quota content wraps across extra compact lines instead of dropping fields from the sidebar, and continuation lines align to the quota content column
-- Desktop automatically switches to a compact monitoring-style single-line title. It keeps recently used providers from the last `50` requests or last `60` minutes, expands all windows/balance for those selected providers in short form such as `OAI 5h80 R16:20 W70 R04-03` or `RC D88.9/60 B260`, and keeps only summary usage signals such as `Cd66%` and `Est$0.12`
-- Auto mode now prefers compact single-line titles everywhere except the actively selected TUI session. That means Desktop stays compact, Web UI / `serve` clients also use compact single-line titles, and the current TUI session keeps the compact multiline layout.
+- TUI sidebar can render a dedicated block layout instead of stuffing telemetry into the shared title:
+  - `TITLE`: clean base session title
+  - `USAGE`: compact request/input/output/cache lines such as `R184 I189k O53.2k`, `CR31.4k CW3.2k Cd66%`, `Est $12.8`
+  - `QUOTA`: one compact provider group per provider, with indented continuation lines for multi-window quotas or balances
+  - while active, the TUI plugin temporarily deactivates the built-in `internal:sidebar-context` block so the custom panel does not duplicate it
+- Shared `session.title` now stays compact in `auto` mode. Desktop, Web UI / `serve`, and TUI all keep the shared title on a compact single line such as `<base> | OAI 5h80 R16:20 W70 R04-03 | RC D88.9/60 B260 | Cd66% | Est$0.12`.
+- TUI panel data is read from persisted day-chunk session state (`usage` + `sidebarPanel`) so entering or resuming a session can render from persistence first; compact-title parsing remains only a defensive fallback.
+- `sidebar.titleMode=multiline` is still available as a legacy fallback when you explicitly want the old multiline title decoration path.
 - `sidebar.titleMode` can force `auto`, `multiline`, or `compact` if the heuristic does not match your workflow.
-- Auto-mode signals are intentionally minimal: Desktop is detected only from `OPENCODE_CLIENT=desktop`; TUI ownership comes from `tui.session.select`; `tui.command.execute` and `tui.prompt.append` only keep that last selected TUI session fresh.
-- Auto-mode freshness lasts `15` minutes. If no new TUI activity arrives in that window, the tracked TUI session is refreshed back to compact; the next TUI activity re-enables multiline for the last selected TUI session.
-- Multi-client caveat: the plugin tracks one global TUI-selected session and writes one shared `session.title`. In mixed TUI/Web or multi-TUI setups, the latest TUI selection wins for that session title. Use `sidebar.titleMode="compact"` or `"multiline"` if you need a stable forced policy.
+- Multi-client caveat: the shared title is still one `session.title` for every client. The new TUI sidebar blocks avoid polluting that shared title, but Desktop/Web still see the compact shared title rather than a sidebar panel.
 - Session-scoped usage/quota can include descendant subagent sessions (enabled by default via `sidebar.includeChildren=true`). Traversal is bounded by `childrenMaxDepth` (default 6), `childrenMaxSessions` (default 128), and `childrenConcurrency` (default 5); truncation is logged when `OPENCODE_QUOTA_DEBUG=1`. Day/week/month ranges never merge children — only session scope does.
 - Toast message can include four sections: `Token Usage`, `Cost as API` (per provider), `Provider Cache` (when provider-level cached ratios are available), and `Quota`
 - Expiry reminders are shown in a separate `Expiry Soon` toast section only for providers with real subscription expiry timestamps, and each session shows that auto-reminder at most once
@@ -77,7 +99,7 @@ Want to add support for another provider (Google Antigravity, Zhipu AI, Firmware
 - Quota snapshots are de-duplicated before rendering to avoid repeated provider lines
 - Custom tools:
   - `quota_summary` — generate usage report for session/day/week/month (full markdown report + toast). The markdown report and toast keep the full human-readable wording; they do not switch to compact sidebar tokens.
-- `quota_show` — toggle sidebar title display on/off (state persists across sessions)
+- `quota_show` — toggle shared title decoration on/off (state persists across sessions)
 - After startup, titles are restored immediately when persisted display mode is OFF; when persisted display mode is ON, touched titles refresh on startup and the rest update on the next relevant session/message event or when `quota_show` is toggled
 - Quota connectors:
   - OpenAI Codex OAuth (`/backend-api/wham/usage`)
@@ -122,6 +144,7 @@ The plugin stores lightweight global state and date-partitioned session chunks.
   - `parentID` (when the session is a subagent child session)
   - `expiryToastShown` (session-level dedupe for automatic expiry reminders)
   - cached usage summary used by `quota_summary`, including session-level and provider-level `cacheBuckets` for cached-ratio reporting and legacy cache classification
+  - `sidebarPanel` cache used by the TUI sidebar plugin (`version`, cached usage, compact quota snapshots`) so `TITLE / USAGE / QUOTA` can render from persisted structure on session open/resume
   - incremental aggregation cursor
 
 Notes on cache bucket persistence:
@@ -147,7 +170,7 @@ memory on startup. Chunk files remain on disk for historical range scans.
 ## Compatibility
 
 - Node.js: >= 18 (for `fetch` + `AbortController`)
-- OpenCode: plugin SDK `@opencode-ai/plugin` ^1.2.10
+- OpenCode: plugin SDK `@opencode-ai/plugin` ^1.3.5
 - 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
@@ -156,7 +179,7 @@ If `npm view @leo000001/opencode-quota-sidebar version` shows a newer version bu
 
 Recommended recovery steps:
 
-1. Pin the target plugin version in `opencode.json`.
+1. Pin the target plugin version in every config file that loads it (`opencode.json` and, if used manually, `tui.json`).
 2. Fully exit OpenCode.
 3. Delete any cached installed copies of the plugin.
 4. Start OpenCode again so it reinstalls the package.
@@ -323,15 +346,48 @@ Other defaults:
 }
 ```
 
+### Common minimal configs
+
+Keep the shared title compact and let TUI render the structured panel:
+
+```json
+{
+  "sidebar": {
+    "enabled": true,
+    "titleMode": "auto",
+    "showCost": true,
+    "showQuota": true,
+    "includeChildren": true
+  }
+}
+```
+
+Enable XYAI Vibe quota with account login:
+
+```json
+{
+  "quota": {
+    "providers": {
+      "xyai-vibe": {
+        "enabled": true,
+        "login": {
+          "username": "your-account",
+          "password": "your-password"
+        }
+      }
+    }
+  }
+}
+```
+
 ### Notes
 
-- `sidebar.showCost` controls API-cost visibility in sidebar title, `quota_summary` markdown report, and toast message.
+- `sidebar.showCost` controls API-cost visibility in the TUI `USAGE` block, the compact shared 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).
 - `sidebar.width` is measured in terminal cells. CJK/emoji truncation is best-effort to avoid sidebar overflow.
-- `sidebar.titleMode` defaults to `auto`: Desktop is compact, the actively selected TUI session stays multiline, and everything else (including Web UI / `serve` clients) uses the compact single-line layout. Use `multiline` or `compact` to force one style.
-- `auto` relies on positive TUI signals: `tui.session.select` chooses the tracked TUI session, and recent `tui.command.execute` / `tui.prompt.append` activity only refreshes that tracked session. If no `tui.session.select` has been seen, command/prompt activity alone will not promote a session to multiline.
-- The TUI freshness window is `15` minutes. After that timeout, the tracked TUI session is refreshed back to compact; the next TUI activity re-promotes only the last selected TUI session.
-- The plugin tracks one global `tuiSessionID` and one shared session title per plugin process, not one title per window/tab/client. In multi-client or shared-server setups, different TUI/Web viewers can influence each other. If you need predictable rendering, force `sidebar.titleMode`.
+- `sidebar.titleMode` defaults to `auto`: the shared `session.title` stays compact for Desktop, Web UI / `serve`, and TUI alike. The rich TUI layout comes from the dedicated TUI plugin slots instead of a multiline shared title. Use `multiline` only if you explicitly want the legacy decorated-title path, or `compact` to force compact titles everywhere.
+- The TUI plugin renders `TITLE`, `USAGE`, and `QUOTA` blocks in the sidebar and temporarily disables the built-in `internal:sidebar-context` block while it is active.
+- The shared `session.title` is still one string per session for all clients. TUI sidebar blocks avoid polluting that title, but Desktop/Web still see the compact shared title rather than a TUI panel.
 - `sidebar.multilineTitle` is kept for backward compatibility, but `sidebar.titleMode` now controls the active policy.
 - `sidebar.wrapQuotaLines` controls quota line wrapping and continuation indentation (default: `true`).
 - `sidebar.includeChildren` controls whether session-scoped usage/quota includes descendant subagent sessions (default: `true`).
@@ -339,7 +395,7 @@ Other defaults:
 - `sidebar.childrenMaxSessions` caps the total number of descendant sessions aggregated (default: `128`, clamped 0–2000).
 - `sidebar.childrenConcurrency` controls parallel fetches for descendant session messages (default: `5`, clamped 1–10).
 - `sidebar.desktopCompact.recentRequests` and `sidebar.desktopCompact.recentMinutes` control which recently used providers remain visible in compact single-line titles.
-- `sidebar.desktopCompact.recentRequests` and `sidebar.desktopCompact.recentMinutes` only control provider filtering inside compact titles; they do not change TUI detection or the 15-minute freshness timeout.
+- `sidebar.desktopCompact.recentRequests` and `sidebar.desktopCompact.recentMinutes` only control provider filtering inside compact titles; they do not affect the dedicated TUI sidebar panel.
 - `output` includes reasoning tokens (`output = tokens.output + tokens.reasoning`). Reasoning is not rendered as a separate line.
 - API cost bills reasoning tokens at the output rate (same as completion tokens).
 - API cost is computed from OpenCode model pricing metadata, not from `message.cost`. This keeps subscription-backed providers such as OpenAI OAuth usable for API-equivalent cost estimation even when OpenCode's measured cost is `0`.
@@ -378,7 +434,24 @@ These examples show the quota block portion of the sidebar title.
 
 ### TUI layout
 
-This section describes the multiline TUI layout. Desktop and Web UI / `serve` clients use the compact single-line format unless you force `sidebar.titleMode = "multiline"`.
+The default TUI layout is a real sidebar panel, not a multiline shared title. Desktop and Web UI / `serve` clients keep the compact shared title unless you force `sidebar.titleMode = "multiline"`.
+
+Typical layout:
+
+```text
+TITLE
+  Fix quota adapter matching
+USAGE
+  R184 I189k O53.2k
+  CR31.4k CW3.2k Cd66%
+  Est $12.8
+QUOTA
+  OAI 5h80 R16:20
+      W70 R04-03
+  Cop M78 R04-01
+  RC D$88.9/$60 E02-27
+     B260
+```
 
 ### Force modes
 
@@ -479,9 +552,9 @@ Cop unavailable
 OAI ?
 ```
 
-### Desktop compact mode
+### Compact shared title mode
 
-Desktop always uses a compact monitoring-style single-line title. Recently used providers are selected from the last `50` assistant requests or last `60` minutes, and each selected provider expands all of its windows and balances in shorthand. To survive upstream Desktop truncation better, quota segments are emitted before usage summary signals:
+Desktop and Web UI / `serve` use a compact monitoring-style single-line shared title in `auto` mode. Recently used providers are selected from the last `50` assistant requests or last `60` minutes, and each selected provider expands all of its windows and balances in shorthand. To survive upstream truncation better, quota segments are emitted before usage summary signals:
 
 ```text
 <base> | OAI 5h80 R16:20 W70 R04-03 | Cop M78 R04-01 | RC D88.9/60 B260 | Buzz B￥10.2 | Cd66% | Est$0.12
@@ -496,8 +569,8 @@ Shorthand rules:
 - `B260` / `B￥10.2` = balance
 - `Cd66%` = cached ratio (`cache.read / (input + cache.read)`)
 - `Est$0.12` = equivalent API cost estimate
-- Desktop omits `R/I/O/CR/CW`; TUI keeps the full compact multiline breakdown.
-- Order is `base | quota... | usage-summary`, while TUI keeps its multiline usage-first layout.
+- Compact shared titles omit `R/I/O/CR/CW`; the dedicated TUI sidebar keeps the richer `TITLE / USAGE / QUOTA` breakdown.
+- Order is `base | quota... | usage-summary` for compact shared titles.
 
 `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.
 

package/dist/format.d.ts

@@ -1,14 +1,13 @@
 import type { QuotaSidebarConfig, QuotaSnapshot } from './types.js';
 import { type UsageSummary } from './usage.js';
 export type TitleView = 'multiline' | 'compact';
-export declare const TUI_ACTIVE_MS: number;
-export declare function isDesktopClient(): boolean;
+/**
+ * Truncate `value` to at most `width` terminal cells.
+ * Keep plain text only (no ANSI) to avoid renderer corruption.
+ */
+export declare function fitLine(value: string, width: number): string;
 export declare function resolveTitleView(opts: {
     config: QuotaSidebarConfig;
-    sessionID?: string;
-    tuiSessionID?: string;
-    tuiActiveAt?: number;
-    now?: number;
 }): TitleView;
 export declare function selectDesktopCompactProviderIDs(usage: UsageSummary, config: QuotaSidebarConfig, now?: number): string[];
 /**
@@ -23,6 +22,11 @@ export declare function selectDesktopCompactProviderIDs(usage: UsageSummary, con
  *   OpenAI Remaining 78%      (only if quota available)
  */
 export declare function renderSidebarTitle(baseTitle: string, usage: UsageSummary, quotas: QuotaSnapshot[], config: QuotaSidebarConfig, view?: TitleView): string;
+export declare function renderSidebarContextLine(tokens: number, percent: number | undefined, width: number): string;
+export declare function renderSidebarUsageLines(usage: UsageSummary, config: QuotaSidebarConfig, options?: {
+    showCost?: boolean;
+}): string[];
+export declare function renderSidebarQuotaLines(quotas: QuotaSnapshot[], config: QuotaSidebarConfig): string[];
 export declare function renderMarkdownReport(period: string, usage: UsageSummary, quotas: QuotaSnapshot[], options?: {
     showCost?: boolean;
 }): string;

package/dist/format.js

@@ -1,7 +1,6 @@
 import { getCacheCoverageMetrics, getProviderCacheCoverageMetrics, } from './usage.js';
 import { canonicalProviderID, collapseQuotaSnapshots, displayShortLabel, quotaDisplayLabel, } from './quota_render.js';
 import { stripAnsi } from './title.js';
-export const TUI_ACTIVE_MS = 15 * 60_000;
 /** M6 fix: handle negative, NaN, Infinity gracefully. */
 function shortNumber(value, decimals = 1) {
     if (!Number.isFinite(value) || value < 0)
@@ -114,7 +113,7 @@ function truncateToCellWidth(value, width) {
  * Truncate `value` to at most `width` terminal cells.
  * Keep plain text only (no ANSI) to avoid renderer corruption.
  */
-function fitLine(value, width) {
+export function fitLine(value, width) {
     if (width <= 0)
         return '';
     const safe = sanitizeLine(value);
@@ -157,25 +156,24 @@ function formatApiCostValue(value) {
 function formatApiCostLine(value) {
     return `${formatApiCostValue(value)} as API cost`;
 }
+function trimTrailingZeroUnit(value) {
+    return value
+        .replace(/(\d+)\.0(?=[km]\b)/i, '$1')
+        .replace(/(\d+)\.0(?=$)/, '$1');
+}
+function panelNumber(value) {
+    return trimTrailingZeroUnit(shortNumber(value, 1));
+}
 function formatRequestsLabel(value, short = false) {
     const count = shortNumber(value, 1);
     return short ? `Req ${count}` : `Requests ${count}`;
 }
-export function isDesktopClient() {
-    return process.env.OPENCODE_CLIENT === 'desktop';
-}
 export function resolveTitleView(opts) {
+    void opts;
     if (opts.config.sidebar.titleMode === 'compact')
         return 'compact';
     if (opts.config.sidebar.titleMode === 'multiline')
         return 'multiline';
-    if (isDesktopClient())
-        return 'compact';
-    if (opts.sessionID &&
-        opts.sessionID === opts.tuiSessionID &&
-        (opts.now ?? Date.now()) - (opts.tuiActiveAt ?? 0) <= TUI_ACTIVE_MS) {
-        return 'multiline';
-    }
     return 'compact';
 }
 function desktopCompactSettings(config) {
@@ -378,6 +376,63 @@ function formatPercent(value, decimals = 1) {
     const pct = (safe * 100).toFixed(decimals);
     return `${pct.replace(/\.0+$/, '').replace(/(\.\d*[1-9])0+$/, '$1')}%`;
 }
+function fitsLine(value, width) {
+    return stringCellWidth(sanitizeLine(value)) <= width;
+}
+function usageDetailLines(usage, cacheMetrics, options) {
+    const width = options.width;
+    const numberToken = options.numberToken || sidebarNumber;
+    const costToken = options.costToken || ((value) => `Est${formatApiCostValue(value)}`);
+    const groups = [];
+    groups.push([
+        `R${shortNumber(usage.assistantMessages, 1)}`,
+        `I${numberToken(usage.input)}`,
+        `O${numberToken(usage.output)}`,
+    ]);
+    const secondary = [];
+    const pushCacheRead = () => {
+        if (usage.cacheRead > 0) {
+            secondary.push(`CR${numberToken(usage.cacheRead)}`);
+        }
+    };
+    const pushCacheWrite = () => {
+        if (usage.cacheWrite > 0) {
+            secondary.push(`CW${numberToken(usage.cacheWrite)}`);
+        }
+    };
+    if (options.cacheReadFirst) {
+        pushCacheRead();
+        pushCacheWrite();
+    }
+    else {
+        pushCacheWrite();
+        pushCacheRead();
+    }
+    if (cacheMetrics.cachedRatio !== undefined) {
+        secondary.push(`Cd${formatPercent(cacheMetrics.cachedRatio, 0)}`);
+    }
+    if (secondary.length > 0)
+        groups.push(secondary);
+    if (options.showCost && usage.apiCost > 0) {
+        groups.push([costToken(usage.apiCost)]);
+    }
+    const packed = [];
+    for (const group of groups) {
+        let current = '';
+        for (const token of group) {
+            const candidate = current ? `${current} ${token}` : token;
+            if (!current || fitsLine(candidate, width)) {
+                current = candidate;
+                continue;
+            }
+            packed.push(current);
+            current = token;
+        }
+        if (current)
+            packed.push(current);
+    }
+    return packed;
+}
 function formatQuotaPercent(value, options) {
     const missing = options?.missing ?? '-';
     if (value === undefined)
@@ -523,51 +578,43 @@ export function renderSidebarTitle(baseTitle, usage, quotas, config, view) {
             lines.push(fitLine(line, width));
         }
     }
-    function fitsLine(value, width) {
-        return stringCellWidth(sanitizeLine(value)) <= width;
-    }
-    function usageDetailLines(usage, cacheMetrics, options) {
-        const width = options.width;
-        const groups = [];
-        groups.push([
-            `R${shortNumber(usage.assistantMessages, 1)}`,
-            `I${sidebarNumber(usage.input)}`,
-            `O${sidebarNumber(usage.output)}`,
-        ]);
-        const secondary = [];
-        if (usage.cacheWrite > 0) {
-            secondary.push(`CW${sidebarNumber(usage.cacheWrite)}`);
-        }
-        if (usage.cacheRead > 0) {
-            secondary.push(`CR${sidebarNumber(usage.cacheRead)}`);
-        }
-        if (cacheMetrics.cachedRatio !== undefined) {
-            secondary.push(`Cd${formatPercent(cacheMetrics.cachedRatio, 0)}`);
-        }
-        if (secondary.length > 0)
-            groups.push(secondary);
-        if (options.showCost && usage.apiCost > 0) {
-            groups.push([`Est${formatApiCostValue(usage.apiCost)}`]);
-        }
-        const packed = [];
-        for (const group of groups) {
-            let current = '';
-            for (const token of group) {
-                const candidate = current ? `${current} ${token}` : token;
-                if (!current || fitsLine(candidate, width)) {
-                    current = candidate;
-                    continue;
-                }
-                packed.push(current);
-                current = token;
-            }
-            if (current)
-                packed.push(current);
-        }
-        return packed;
-    }
     return lines.join('\n');
 }
+export function renderSidebarContextLine(tokens, percent, width) {
+    const parts = [`${panelNumber(tokens)} tok`];
+    if (percent !== undefined && Number.isFinite(percent) && percent >= 0) {
+        parts.push(`${Math.round(percent)}% ctx`);
+    }
+    return fitLine(parts.join(' '), width);
+}
+export function renderSidebarUsageLines(usage, config, options) {
+    const width = Math.max(8, Math.floor(config.sidebar.width || 36));
+    const cacheMetrics = getCacheCoverageMetrics(usage);
+    return usageDetailLines(usage, cacheMetrics, {
+        width,
+        showCost: options?.showCost ?? config.sidebar.showCost,
+        numberToken: panelNumber,
+        costToken: (value) => `Est ${formatApiCostValue(value)}`,
+        cacheReadFirst: true,
+    }).map((line) => fitLine(line, width));
+}
+export function renderSidebarQuotaLines(quotas, config) {
+    const width = Math.max(8, Math.floor(config.sidebar.width || 36));
+    const visibleQuotas = collapseQuotaSnapshots(quotas).filter((q) => ['ok', 'error', 'unsupported', 'unavailable'].includes(q.status));
+    const labelWidth = visibleQuotas.reduce((max, item) => {
+        const label = compactProviderLabel(item);
+        return Math.max(max, stringCellWidth(label));
+    }, 0);
+    return visibleQuotas
+        .flatMap((item) => compactQuotaWide(item, labelWidth, {
+        width,
+        wrapLines: config.sidebar.wrapQuotaLines,
+        forceWrapped: false,
+        compactDetails: true,
+    }))
+        .filter((line) => Boolean(line))
+        .map((line) => fitLine(line, width));
+}
 /**
  * Multi-window quota format for sidebar.
  *

package/dist/index.js

@@ -1,7 +1,6 @@
-import path from 'node:path';
-import { renderMarkdownReport, resolveTitleView, renderSidebarTitle, renderToastMessage, TUI_ACTIVE_MS, } from './format.js';
+import { renderMarkdownReport, resolveTitleView, renderSidebarTitle, renderToastMessage, } from './format.js';
 import { createQuotaRuntime } from './quota.js';
-import { authFilePath, dateKeyFromTimestamp, deleteSessionFromDayChunk, evictOldSessions, loadConfig, loadState, normalizeTimestampMs, resolveOpencodeConfigDir, resolveOpencodeDataDir, saveState, stateFilePath, } from './storage.js';
+import { authFilePath, dateKeyFromTimestamp, deleteSessionFromDayChunk, evictOldSessions, loadConfig, loadState, normalizeTimestampMs, quotaConfigPaths, resolveOpencodeDataDir, saveState, stateFilePath, } from './storage.js';
 import { debug, swallow } from './helpers.js';
 import { normalizeBaseTitle } from './title.js';
 import { createDescendantsResolver } from './descendants.js';
@@ -16,16 +15,7 @@ const SHUTDOWN_HOOK_KEY = Symbol.for('opencode-quota-sidebar.shutdown-hook');
 const SHUTDOWN_CALLBACKS_KEY = Symbol.for('opencode-quota-sidebar.shutdown-callbacks');
 export async function QuotaSidebarPlugin(input) {
     const quotaRuntime = createQuotaRuntime();
-    const configDir = resolveOpencodeConfigDir();
-    const configOverride = process.env.OPENCODE_QUOTA_CONFIG?.trim();
-    const config = await loadConfig([
-        path.join(configDir, 'quota-sidebar.config.json'),
-        path.join(input.worktree, 'quota-sidebar.config.json'),
-        path.join(input.directory, 'quota-sidebar.config.json'),
-        path.join(input.worktree, '.opencode', 'quota-sidebar.config.json'),
-        path.join(input.directory, '.opencode', 'quota-sidebar.config.json'),
-        ...(configOverride ? [path.resolve(configOverride)] : []),
-    ]);
+    const config = await loadConfig(quotaConfigPaths(input.worktree, input.directory));
     const dataDir = resolveOpencodeDataDir();
     const statePath = stateFilePath(dataDir);
     const authPath = authFilePath(dataDir);
@@ -126,23 +116,6 @@ export async function QuotaSidebarPlugin(input) {
     });
     const summarizeSessionUsageForDisplay = usageService.summarizeSessionUsageForDisplay;
     const summarizeForTool = usageService.summarizeForTool;
-    let tuiSessionID;
-    let tuiActiveAt = 0;
-    let tuiTimer;
-    const armTuiTimer = () => {
-        if (tuiTimer)
-            clearTimeout(tuiTimer);
-        if (!tuiSessionID)
-            return;
-        tuiTimer = setTimeout(() => {
-            const id = tuiSessionID;
-            tuiActiveAt = 0;
-            tuiTimer = undefined;
-            if (id)
-                scheduleTitleRefresh(id, 0);
-        }, TUI_ACTIVE_MS);
-        tuiTimer.unref?.();
-    };
     // title apply / refresh lifecycle
     let scheduleTitleRefresh = (sessionID, delay = 250) => {
         void sessionID;
@@ -178,7 +151,7 @@ export async function QuotaSidebarPlugin(input) {
         markDirty,
         scheduleSave,
         renderSidebarTitle,
-        getTitleView: (sessionID) => resolveTitleView({ config, sessionID, tuiSessionID, tuiActiveAt }),
+        getTitleView: () => resolveTitleView({ config }),
         getQuotaSnapshots,
         summarizeSessionUsageForDisplay,
         scheduleParentRefreshIfSafe,
@@ -218,17 +191,18 @@ export async function QuotaSidebarPlugin(input) {
             .catch(swallow('startup:refreshAllTouchedTitles'));
     }
     const shutdown = async () => {
-        if (tuiTimer)
-            clearTimeout(tuiTimer);
         await Promise.race([
             startupTitleWork,
             new Promise((resolve) => setTimeout(resolve, 5_000)),
         ]).catch(swallow('shutdown:startupTitleWork'));
-        await titleRefresh.waitForQuiescence().catch(swallow('shutdown:titleQuiescence'));
+        await titleRefresh
+            .waitForQuiescence()
+            .catch(swallow('shutdown:titleQuiescence'));
         await flushSave().catch(swallow('shutdown:flushSave'));
     };
     const processWithHook = process;
-    const shutdownCallbacks = (processWithHook[SHUTDOWN_CALLBACKS_KEY] ||= new Set());
+    const shutdownCallbacks = (processWithHook[SHUTDOWN_CALLBACKS_KEY] ||=
+        new Set());
     shutdownCallbacks.add(shutdown);
     if (!processWithHook[SHUTDOWN_HOOK_KEY]) {
         processWithHook[SHUTDOWN_HOOK_KEY] = true;
@@ -300,7 +274,8 @@ export async function QuotaSidebarPlugin(input) {
             if (expiryLines.length === 0)
                 return;
             sessionState.expiryToastShown = true;
-            const dateKey = state.sessionDateMap[sessionID] || dateKeyFromTimestamp(sessionState.createdAt);
+            const dateKey = state.sessionDateMap[sessionID] ||
+                dateKeyFromTimestamp(sessionState.createdAt);
             state.sessionDateMap[sessionID] = dateKey;
             markDirty(dateKey);
             scheduleSave();
@@ -347,14 +322,6 @@ export async function QuotaSidebarPlugin(input) {
         },
         onSessionDeleted: async (session) => {
             await flushSave().catch(swallow('onSessionDeleted:flushSave'));
-            if (tuiSessionID === session.id) {
-                tuiSessionID = undefined;
-                tuiActiveAt = 0;
-                if (tuiTimer) {
-                    clearTimeout(tuiTimer);
-                    tuiTimer = undefined;
-                }
-            }
             descendantsResolver.invalidateForAncestors(session.parentID);
             descendantsResolver.invalidateForAncestors(session.id);
             usageService.forgetSession(session.id);
@@ -377,20 +344,9 @@ export async function QuotaSidebarPlugin(input) {
             }
         },
         onTuiActivity: async () => {
-            const stale = Boolean(tuiSessionID) && Date.now() - tuiActiveAt > TUI_ACTIVE_MS;
-            tuiActiveAt = Date.now();
-            armTuiTimer();
-            if (stale && tuiSessionID) {
-                titleRefresh.schedule(tuiSessionID, 0);
-            }
+            return;
         },
         onTuiSessionSelect: async (sessionID) => {
-            const prev = tuiSessionID;
-            tuiSessionID = sessionID;
-            armTuiTimer();
-            if (prev && prev !== sessionID) {
-                titleRefresh.schedule(prev, 0);
-            }
             titleRefresh.schedule(sessionID, 0);
         },
         onMessageRemoved: async (info) => {

package/dist/storage.d.ts

@@ -2,6 +2,7 @@ import { dateKeyFromTimestamp, normalizeTimestampMs } from './storage_dates.js';
 import { authFilePath, resolveOpencodeConfigDir, resolveOpencodeDataDir, stateFilePath } from './storage_paths.js';
 import type { CachedSessionUsage, IncrementalCursor, QuotaSidebarConfig, QuotaSidebarState, SessionState } from './types.js';
 export { authFilePath, dateKeyFromTimestamp, normalizeTimestampMs, resolveOpencodeConfigDir, resolveOpencodeDataDir, stateFilePath, };
+export declare function quotaConfigPaths(worktree: string, directory: string): string[];
 export declare const defaultConfig: QuotaSidebarConfig;
 export declare function defaultState(): QuotaSidebarState;
 export declare function loadConfig(paths: string[]): Promise<QuotaSidebarConfig>;

package/dist/storage.js

@@ -6,6 +6,18 @@ import { dateKeyFromTimestamp, dateKeysInRange, dateStartFromKey, isDateKey, nor
 import { parseQuotaCache } from './storage_parse.js';
 import { authFilePath, chunkRootPathFromStateFile, resolveOpencodeConfigDir, resolveOpencodeDataDir, stateFilePath, } from './storage_paths.js';
 export { authFilePath, dateKeyFromTimestamp, normalizeTimestampMs, resolveOpencodeConfigDir, resolveOpencodeDataDir, stateFilePath, };
+export function quotaConfigPaths(worktree, directory) {
+    const configDir = resolveOpencodeConfigDir();
+    const configOverride = process.env.OPENCODE_QUOTA_CONFIG?.trim();
+    return [
+        path.join(configDir, 'quota-sidebar.config.json'),
+        path.join(worktree, 'quota-sidebar.config.json'),
+        path.join(directory, 'quota-sidebar.config.json'),
+        path.join(worktree, '.opencode', 'quota-sidebar.config.json'),
+        path.join(directory, '.opencode', 'quota-sidebar.config.json'),
+        ...(configOverride ? [path.resolve(configOverride)] : []),
+    ];
+}
 // ─── Default config ──────────────────────────────────────────────────────────
 export const defaultConfig = {
     sidebar: {