@leo000001/opencode-quota-sidebar 2.0.11 → 2.0.14

package/README.md

@@ -55,28 +55,25 @@ Want to add support for another provider (Google Antigravity, Zhipu AI, Firmware
 
 ## Features
 
-- TUI session title becomes multiline in sidebar:
+- TUI session title uses a compact multiline sidebar layout:
   - line 1: original session title
   - line 2: blank separator
-  - line 3: Requests
-  - line 4: Input/Output tokens
-  - line 5: Cache Read tokens (only if non-zero)
-  - line 6: Cache Write tokens (only if non-zero)
-  - next lines: `Cache Coverage` (read/write cache models) and `Cache Read Coverage` (read-only cache models) when enough cache telemetry is available; mixed sessions can show both
-  - next line: `$X.XX as API cost` (equivalent API billing for subscription-auth providers)
-  - quota lines: quota text like `OpenAI 5h 80% Rst 16:20`; short windows (`5h`, `1d`, `Daily`) show `HH:MM` on same-day resets and `MM-DD HH:MM` when crossing days, while longer windows continue to show `MM-DD`
-  - RightCode daily quota shows `$remaining/$dailyTotal` without trailing percent, and shows balance on the next indented line when available
-  - XYAI daily quota follows the same balance-style layout and prefers the real reset time (for example `XYAI Daily $70.2/$90 Rst 22:18`)
-- Desktop automatically switches to a compact single-line title. It keeps recently used providers from the last `50` requests or last `60` minutes ahead of `Requests/Input/Output`, and expands all windows/balance for those selected providers in short form such as `OAI 5h80 W70` or `RC D88.9/60 B260`
-- TUI is always rendered as multiline; Desktop is always rendered as compact single-line. This behavior no longer depends on `sidebar.multilineTitle`
+  - 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`
+- TUI is always rendered as compact multiline; Desktop is always rendered as compact monitoring-style single-line. This behavior no longer depends on `sidebar.multilineTitle`
 - Web UI currently cannot be reliably detected by the plugin, so it follows the non-desktop multiline path
 - 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 cache coverage is available), and `Quota`
+- 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
-- `quota_summary` markdown / toast also include `Cache Coverage` and `Cache Read Coverage` summary lines when available
+- `quota_summary` markdown / toast also include `Cached` summary lines when cache activity is available
 - Quota snapshots are de-duplicated before rendering to avoid repeated provider lines
 - Custom tools:
-  - `quota_summary` — generate usage report for session/day/week/month (markdown + toast)
+  - `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)
 - 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:
@@ -121,10 +118,10 @@ The plugin stores lightweight global state and date-partitioned session chunks.
   - `createdAt`
   - `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 cache coverage reporting
+  - cached usage summary used by `quota_summary`, including session-level and provider-level `cacheBuckets` for cached-ratio reporting and legacy cache classification
   - incremental aggregation cursor
 
-Notes on cache coverage persistence:
+Notes on cache bucket persistence:
 
 - Older cached usage written before `cacheBuckets` existed can only be approximated from top-level `cache_read` / `cache_write` totals.
 - In those legacy cases, mixed read-only + read-write cache traffic may be attributed to a single fallback bucket until the session is recomputed from messages.
@@ -208,6 +205,8 @@ You can add these command templates in `opencode.json` so you can run `/qday`, `
 }
 ```
 
+When calling `quota_summary`, make sure the client shows the returned markdown report directly to the user. The tool already returns the full report body; do not replace it with a compact summary.
+
 ## Configuration files
 
 Recommended global config:
@@ -324,7 +323,7 @@ Other defaults:
 - `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).
 - `sidebar.width` is measured in terminal cells. CJK/emoji truncation is best-effort to avoid sidebar overflow.
-- `sidebar.multilineTitle` is kept for backward compatibility, but current rendering is fixed by client type: TUI uses multiline titles and Desktop uses compact single-line titles.
+- `sidebar.multilineTitle` is kept for backward compatibility, but current rendering is fixed by client type: TUI uses multiline titles and Desktop uses compact monitoring-style single-line titles.
 - `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`).
 - `sidebar.childrenMaxDepth` limits how many levels of nested subagents are traversed (default: `6`, clamped 1–32).
@@ -360,7 +359,7 @@ The adapter also tolerates `https://buzzai.cc/v1`, but `https://buzzai.cc` is th
 With that setup, the sidebar/toast quota line will look like:
 
 ```text
-Buzz Balance ￥10.17
+Buzz B￥10.17
 ```
 
 ## Rendering examples
@@ -369,7 +368,7 @@ These examples show the quota block portion of the sidebar title.
 
 ### TUI layout
 
-This section describes the TUI layout. Desktop uses its own compact single-line format and Web UI currently follows the multiline path.
+This section describes the TUI layout. Desktop uses its own compact monitoring-style single-line format and Web UI currently follows the multiline path.
 
 0 providers (no quota data):
 
@@ -380,113 +379,95 @@ This section describes the TUI layout. Desktop uses its own compact single-line
 1 provider, 1 window (fits):
 
 ```text
-Copilot Monthly 78% Rst 04-01
+Cop M78 R04-01
 ```
 
 1 provider, multi-window (for example OpenAI 5h + Weekly):
 
 ```text
-OpenAI
-  5h 78% Rst 05:05
-  Weekly 73% Rst 03-12
+OAI 5h78 R05:05 W73 R03-12
+```
+
+1 provider, multi-window on narrow width:
+
+```text
+OAI 5h78 R05:05
+    W73 R03-12
 ```
 
 1 provider, short window crossing into the next day:
 
 ```text
-Anthropic
-  5h 0% Rst 03-10 01:00
-  Weekly 46% Rst 03-15
+Ant 5h0 R03-10 01:00 W46 R03-15
 ```
 
 2+ providers (even if each provider is single-window):
 
 ```text
-OpenAI
-  5h 78% Rst 05:05
-Copilot
-  Monthly 78% Rst 04-01
+OAI 5h78 R05:05
+Cop M78 R04-01
 ```
 
 2+ providers mixed (multi-window + single-window):
 
 ```text
-OpenAI
-  5h 78% Rst 05:05
-  Weekly 73% Rst 03-12
-Copilot
-  Monthly 78% Rst 04-01
+OAI 5h78 R05:05 W73 R03-12
+Cop M78 R04-01
 ```
 
 2+ providers mixed (window providers + Buzz balance):
 
 ```text
-OpenAI
-  5h 78% Rst 05:05
-Copilot
-  Monthly 78% Rst 04-01
-Buzz Balance ￥10.2
+OAI 5h78 R05:05
+Cop M78 R04-01
+Buzz B￥10.2
 ```
 
 Balance-style quota:
 
 ```text
-RC Balance $260
+RC B260
 ```
 
 Buzz balance quota:
 
 ```text
-Buzz Balance ￥10.17
+Buzz B￥10.17
 ```
 
 Multi-detail quota (window + balance):
 
 ```text
-RC
-  Daily $88.9/$60 Exp 02-27
-  Balance $260
+RC D$88.9/$60 E02-27 B260
 ```
 
 Provider status / quota (examples):
 
 ```text
-Anthropic 5h 80%+
-Copilot unavailable
-OpenAI Remaining ?
-```
-
-### Legacy compact single-line layout
-
-For historical reference, the old non-desktop compact layout looked like this:
-
-```text
-<base> | Req ... | Input ... | Output ... | OpenAI 5h 78%+ | Copilot Monthly 78% | ...
-```
-
-Mixed with Buzz balance:
-
-```text
-<base> | Req ... | Input ... | Output ... | OpenAI 5h 78%+ | Copilot Monthly 78% | Buzz Balance ￥10.2
+Ant 5h80
+Cop unavailable
+OAI ?
 ```
 
 ### Desktop compact mode
 
-Desktop always uses a compact 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 stats:
+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:
 
 ```text
-<base> | OAI 5h80 W70 | Cop M78 | RC D88.9/60 B260 | Buzz B￥10.2 | R12 I18.9k O53
+<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
 ```
 
 Shorthand rules:
 
-- `R12` = 12 requests
-- `I18.9k` / `O53` = input / output tokens
 - `5h80` = `5h 80%`
 - `W70` / `M78` / `D46` = weekly / monthly / daily window remaining percent
+- `R16:20` / `R04-03` = reset time/date for that quota window
 - `D88.9/60` = daily remaining / daily total
 - `B260` / `B￥10.2` = balance
-- Order is `base | quota... | usage`, while TUI keeps its multiline usage-first layout.
+- `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.
 
 `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/cost.js

@@ -8,6 +8,54 @@ const MODEL_COST_RATE_ALIASES = {
     'kimi-for-coding:k2p5': ['moonshotai-cn:kimi-k2.5'],
     'kimi-for-coding:kimi-k2-thinking': ['moonshotai-cn:kimi-k2-thinking'],
 };
+function anthropicModelAliases(modelID) {
+    const aliases = [];
+    const queue = [];
+    const push = (value) => {
+        if (!value)
+            return;
+        if (!aliases.includes(value)) {
+            aliases.push(value);
+            queue.push(value);
+        }
+    };
+    push(modelID);
+    for (let index = 0; index < queue.length; index++) {
+        const stem = queue[index];
+        const withoutProviderPrefix = stem
+            .replace(/^(?:[a-z]+\.)*anthropic\./, '')
+            .replace(/^anthropic[/.]/, '');
+        push(withoutProviderPrefix);
+        push(`anthropic/${withoutProviderPrefix}`);
+        const withoutVersionSuffix = withoutProviderPrefix.replace(/-v\d+(?::\d+)?$/, '');
+        push(withoutVersionSuffix);
+        push(`anthropic/${withoutVersionSuffix}`);
+        const atDate = withoutVersionSuffix.replace(/@(\d{8})$/, '-$1');
+        push(atDate);
+        push(`anthropic/${atDate}`);
+        const withAtDate = withoutVersionSuffix.replace(/-(\d{8})$/, '@$1');
+        push(withAtDate);
+        push(`anthropic/${withAtDate}`);
+        const withoutThinkingSuffix = withoutVersionSuffix.replace(/-thinking$/, '');
+        push(withoutThinkingSuffix);
+        push(`anthropic/${withoutThinkingSuffix}`);
+        const withoutLatestSuffix = withoutThinkingSuffix.replace(/-latest$/, '');
+        push(withoutLatestSuffix);
+        push(`anthropic/${withoutLatestSuffix}`);
+        const withoutDateSuffix = withoutLatestSuffix
+            .replace(/-\d{8}$/, '')
+            .replace(/@\d{8}$/, '');
+        push(withoutDateSuffix);
+        push(`anthropic/${withoutDateSuffix}`);
+        const dotted = withoutDateSuffix.replace(/(\d)-(\d)(?=-|$)/g, '$1.$2');
+        push(dotted);
+        push(`anthropic/${dotted}`);
+        const hyphenated = withoutDateSuffix.replace(/(\d)\.(\d)(?=-|$)/g, '$1-$2');
+        push(hyphenated);
+        push(`anthropic/${hyphenated}`);
+    }
+    return aliases;
+}
 function normalizeKnownProviderID(providerID) {
     if (providerID.startsWith('github-copilot'))
         return 'github-copilot';
@@ -37,9 +85,14 @@ export function modelCostLookupKeys(providerID, modelID) {
         if (!keys.includes(key))
             keys.push(key);
     };
-    push(modelCostKey(providerID, modelID));
-    if (canonicalProviderID !== providerID) {
-        push(modelCostKey(canonicalProviderID, modelID));
+    const modelIDs = canonicalProviderID === 'anthropic'
+        ? anthropicModelAliases(modelID)
+        : [modelID];
+    for (const candidateModelID of modelIDs) {
+        push(modelCostKey(providerID, candidateModelID));
+        if (canonicalProviderID !== providerID) {
+            push(modelCostKey(canonicalProviderID, candidateModelID));
+        }
     }
     for (const key of [...keys]) {
         for (const alias of MODEL_COST_RATE_ALIASES[key] || []) {

package/dist/format.js

@@ -207,7 +207,7 @@ function compactProviderLabel(quota) {
     if (canonical === 'rightcode')
         return 'RC';
     if (canonical === 'xyai-vibe')
-        return 'XY';
+        return 'XYAI';
     if (canonical === 'buzz')
         return 'Buzz';
     return sanitizeLine(quotaDisplayLabel(quota));
@@ -226,6 +226,78 @@ function compactWindowToken(label) {
         return 'D';
     return safe;
 }
+function compactQuotaResetToken(resetLabel) {
+    const safe = sanitizeLine(resetLabel || '');
+    if (!safe || /^rst$/i.test(safe))
+        return 'R';
+    if (/^exp\+$/i.test(safe))
+        return 'E+';
+    if (/^exp$/i.test(safe))
+        return 'E';
+    return safe;
+}
+function compactQuotaPercentToken(label, percent) {
+    const rounded = percent !== undefined && Number.isFinite(percent)
+        ? `${Math.round(percent)}`
+        : '';
+    const safe = sanitizeLine(label || '');
+    if (!safe)
+        return rounded ? `R${rounded}` : '';
+    if (/^sonnet\s+7d$/i.test(safe))
+        return rounded ? `S7d${rounded}` : 'S7d';
+    const token = compactWindowToken(safe).replace(/\s+/g, '');
+    if (!rounded)
+        return token;
+    if (/^(?:D|W|M|\d+[hdw])$/i.test(token))
+        return `${token}${rounded}`;
+    return `${token} ${rounded}%`;
+}
+function compactQuotaWindowText(win) {
+    const reset = compactReset(win.resetAt, win.resetLabel, win.label);
+    const resetToken = reset
+        ? `${compactQuotaResetToken(win.resetLabel)}${reset}`
+        : undefined;
+    if (win.showPercent === false) {
+        const safe = sanitizeLine(win.label || '');
+        const daily = safe ? safe.replace(/^Daily\s+/i, 'D') : '';
+        return [daily, resetToken].filter(Boolean).join(' ');
+    }
+    const percentToken = compactQuotaPercentToken(win.label, win.remainingPercent);
+    return [percentToken, resetToken].filter(Boolean).join(' ');
+}
+function compactQuotaWindowTokens(win) {
+    const reset = compactReset(win.resetAt, win.resetLabel, win.label);
+    const resetToken = reset
+        ? `${compactQuotaResetToken(win.resetLabel)}${reset}`
+        : undefined;
+    if (win.showPercent === false) {
+        const safe = sanitizeLine(win.label || '');
+        const daily = safe ? safe.replace(/^Daily\s+/i, 'D') : '';
+        return [daily, resetToken].filter((value) => Boolean(value));
+    }
+    const percentToken = compactQuotaPercentToken(win.label, win.remainingPercent);
+    return [percentToken, resetToken].filter((value) => Boolean(value));
+}
+function compactQuotaBalanceText(balance) {
+    return `B${compactDesktopCurrencyValue(balance.amount, balance.currency)}`;
+}
+function packInlineTokens(label, tokens, width, indent = '  ') {
+    if (tokens.length === 0)
+        return [label];
+    const lines = [];
+    let current = label;
+    for (const token of tokens) {
+        const candidate = `${current} ${token}`;
+        if (stringCellWidth(candidate) <= width || current === label) {
+            current = candidate;
+            continue;
+        }
+        lines.push(current);
+        current = `${indent}${token}`;
+    }
+    lines.push(current);
+    return lines;
+}
 function compactDesktopCurrencyValue(value, currency) {
     const rendered = formatCurrency(value, currency);
     if (currency === '$')
@@ -243,23 +315,7 @@ function compactDesktopQuotaSegment(quota) {
     let hasBalanceToken = false;
     if (quota.windows && quota.windows.length > 0) {
         for (const win of quota.windows) {
-            const winLabel = sanitizeLine(win.label || '');
-            if (win.showPercent === false) {
-                const daily = winLabel.match(/^Daily\s+\$?([\d.,]+)\/\$?([\d.,]+)/i);
-                if (daily) {
-                    parts.push(`D${daily[1]}/${daily[2]}`);
-                    continue;
-                }
-                if (winLabel)
-                    parts.push(winLabel.replace(/^Daily\s+/i, 'D'));
-                continue;
-            }
-            const percent = win.remainingPercent !== undefined &&
-                Number.isFinite(win.remainingPercent)
-                ? `${compactWindowToken(winLabel)}${Math.round(win.remainingPercent)}`
-                : compactWindowToken(winLabel);
-            if (percent)
-                parts.push(percent);
+            parts.push(...compactQuotaWindowTokens(win));
         }
     }
     else if (quota.balance) {
@@ -283,10 +339,15 @@ function renderDesktopCompactTitle(baseTitle, usage, quotas, config, _width) {
         .filter((quota) => selectedProviderIDs.has(quota.providerID))
         .map(compactDesktopQuotaSegment)
         .filter(Boolean);
-    const segments = [
-        ...quotaSegments,
-        `R${shortNumber(usage.assistantMessages, 1)} I${sidebarNumber(usage.input)} O${sidebarNumber(usage.output)}`,
-    ];
+    const cacheMetrics = getCacheCoverageMetrics(usage);
+    const usageSegments = [];
+    if (cacheMetrics.cachedRatio !== undefined) {
+        usageSegments.push(`Cd${formatPercent(cacheMetrics.cachedRatio, 0)}`);
+    }
+    if (config.sidebar.showCost && usage.apiCost > 0) {
+        usageSegments.push(`Est${formatApiCostValue(usage.apiCost)}`);
+    }
+    const segments = [...quotaSegments, ...usageSegments];
     const detail = segments.join(' | ');
     const safeBase = sanitizeLine(baseTitle) || 'Session';
     if (!detail)
@@ -365,17 +426,14 @@ function renderSingleLineTitle(baseTitle, usage, quotas, config, width) {
         formatRequestsLabel(usage.assistantMessages, true),
         `Input ${sidebarNumber(usage.input)}  Output ${sidebarNumber(usage.output)}`,
     ];
-    if (usage.cacheRead > 0) {
-        segments.push(`Cache Read ${sidebarNumber(usage.cacheRead)}`);
-    }
     if (usage.cacheWrite > 0) {
         segments.push(`Cache Write ${sidebarNumber(usage.cacheWrite)}`);
     }
-    if (cacheMetrics.cacheCoverage !== undefined) {
-        segments.push(`Cache Coverage ${formatPercent(cacheMetrics.cacheCoverage, 0)}`);
+    if (usage.cacheRead > 0) {
+        segments.push(`Cache Read ${sidebarNumber(usage.cacheRead)}`);
     }
-    if (cacheMetrics.cacheReadCoverage !== undefined) {
-        segments.push(`Cache Read Coverage ${formatPercent(cacheMetrics.cacheReadCoverage, 0)}`);
+    if (cacheMetrics.cachedRatio !== undefined) {
+        segments.push(`Cached ${formatPercent(cacheMetrics.cachedRatio, 0)}`);
     }
     if (config.sidebar.showCost && usage.apiCost > 0) {
         segments.push(formatApiCostLine(usage.apiCost));
@@ -413,34 +471,21 @@ export function renderSidebarTitle(baseTitle, usage, quotas, config) {
         lines.push(fitLine(line || 'Session', width));
     }
     lines.push('');
-    // Input / Output line
-    lines.push(fitLine(formatRequestsLabel(usage.assistantMessages), width));
-    const io = `Input ${sidebarNumber(usage.input)}  Output ${sidebarNumber(usage.output)}`;
-    lines.push(fitLine(io, width));
-    // Cache lines (provider-compatible across OpenAI/Anthropic/Gemini/Copilot)
-    if (usage.cacheRead > 0) {
-        lines.push(fitLine(`Cache Read ${sidebarNumber(usage.cacheRead)}`, width));
-    }
-    if (usage.cacheWrite > 0) {
-        lines.push(fitLine(`Cache Write ${sidebarNumber(usage.cacheWrite)}`, width));
-    }
-    if (cacheMetrics.cacheCoverage !== undefined) {
-        lines.push(fitLine(`Cache Coverage ${formatPercent(cacheMetrics.cacheCoverage, 0)}`, width));
-    }
-    if (cacheMetrics.cacheReadCoverage !== undefined) {
-        lines.push(fitLine(`Cache Read Coverage ${formatPercent(cacheMetrics.cacheReadCoverage, 0)}`, width));
-    }
-    if (config.sidebar.showCost && usage.apiCost > 0) {
-        lines.push(fitLine(formatApiCostLine(usage.apiCost), width));
+    for (const detailLine of usageDetailLines(usage, cacheMetrics, {
+        width,
+        showCost: config.sidebar.showCost,
+    })) {
+        lines.push(fitLine(detailLine, width));
     }
     // Quota lines (one provider per line for stable wrapping)
     if (config.sidebar.showQuota) {
         const visibleQuotas = collapseQuotaSnapshots(quotas).filter((q) => ['ok', 'error', 'unsupported', 'unavailable'].includes(q.status));
-        // When multiple providers are visible, keep a consistent visual rhythm by
-        // always rendering each provider as a header line + indented detail line(s).
-        const forceWrappedProviders = visibleQuotas.length > 1;
+        const compactQuotaDetails = true;
+        const forceWrappedProviders = false;
         const labelWidth = visibleQuotas.reduce((max, item) => {
-            const label = sanitizeLine(quotaDisplayLabel(item));
+            const label = compactQuotaDetails
+                ? compactProviderLabel(item)
+                : sanitizeLine(quotaDisplayLabel(item));
             return Math.max(max, stringCellWidth(label));
         }, 0);
         const quotaItems = visibleQuotas
@@ -448,6 +493,7 @@ export function renderSidebarTitle(baseTitle, usage, quotas, config) {
             width,
             wrapLines: config.sidebar.wrapQuotaLines,
             forceWrapped: forceWrappedProviders,
+            compactDetails: compactQuotaDetails,
         }))
             .filter((s) => Boolean(s));
         if (quotaItems.length > 0) {
@@ -457,6 +503,49 @@ export function renderSidebarTitle(baseTitle, usage, quotas, config) {
             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');
 }
 /**
@@ -476,7 +565,10 @@ export function renderSidebarTitle(baseTitle, usage, quotas, config) {
  *   "  Balance $108.88"
  */
 function compactQuotaWide(quota, labelWidth = 0, options) {
-    const label = sanitizeLine(quotaDisplayLabel(quota));
+    const compactDetails = options?.compactDetails === true;
+    const label = compactDetails
+        ? compactProviderLabel(quota)
+        : sanitizeLine(quotaDisplayLabel(quota));
     const labelPadded = padEndCells(label, labelWidth);
     const detailIndent = '  ';
     const withLabel = (content) => `${labelPadded} ${content}`;
@@ -501,9 +593,13 @@ function compactQuotaWide(quota, labelWidth = 0, options) {
     if (quota.status !== 'ok')
         return [];
     const balanceText = quota.balance
-        ? `Balance ${formatCurrency(quota.balance.amount, quota.balance.currency)}`
+        ? compactDetails
+            ? compactQuotaBalanceText(quota.balance)
+            : `Balance ${formatCurrency(quota.balance.amount, quota.balance.currency)}`
         : undefined;
     const renderWindow = (win) => {
+        if (compactDetails)
+            return compactQuotaWindowText(win);
         const showPercent = win.showPercent !== false;
         const pct = formatQuotaPercent(win.remainingPercent, { rounded: true });
         const parts = win.label
@@ -520,11 +616,20 @@ function compactQuotaWide(quota, labelWidth = 0, options) {
     // Multi-window rendering
     if (quota.windows && quota.windows.length > 0) {
         const parts = quota.windows.map(renderWindow);
+        const compactTokens = compactDetails
+            ? quota.windows.flatMap((win) => compactQuotaWindowTokens(win))
+            : [];
         // Build the detail lines (window texts + optional balance)
         const details = [...parts];
         if (balanceText && !parts.some((p) => p.includes('Balance '))) {
             details.push(balanceText);
         }
+        if (compactDetails) {
+            const tokens = [...compactTokens];
+            if (balanceText)
+                tokens.push(balanceText);
+            return packInlineTokens(label, tokens, width, ' '.repeat(stringCellWidth(label) + 1));
+        }
         // Keep a unified wrapped layout for providers that have multiple detail
         // lines so OpenAI/Copilot/others match the RightCode multi-line style,
         // regardless of wrapLines.
@@ -541,7 +646,11 @@ function compactQuotaWide(quota, labelWidth = 0, options) {
     // Fallback: single value from top-level remainingPercent
     const percent = formatQuotaPercent(quota.remainingPercent, { rounded: true });
     const reset = compactReset(quota.resetAt, 'Rst');
-    const fallbackText = `Remaining ${percent}${reset ? ` Rst ${reset}` : ''}`;
+    const fallbackText = compactDetails
+        ? [`R${percent.replace(/%$/, '')}`, reset ? `R${reset}` : undefined]
+            .filter(Boolean)
+            .join(' ')
+        : `Remaining ${percent}${reset ? ` Rst ${reset}` : ''}`;
     return maybeBreak(fallbackText, [fallbackText]);
 }
 function isShortResetWindow(label) {
@@ -679,16 +788,10 @@ export function renderMarkdownReport(period, usage, quotas, options) {
             return '-';
         return formatApiCostValue(usage.apiCost);
     };
-    const cacheCoverageCell = (provider) => {
-        const metrics = getProviderCacheCoverageMetrics(provider);
-        return metrics.cacheCoverage !== undefined
-            ? formatPercent(metrics.cacheCoverage, 1)
-            : '-';
-    };
-    const cacheReadCoverageCell = (provider) => {
+    const cachedCell = (provider) => {
         const metrics = getProviderCacheCoverageMetrics(provider);
-        return metrics.cacheReadCoverage !== undefined
-            ? formatPercent(metrics.cacheReadCoverage, 1)
+        return metrics.cachedRatio !== undefined
+            ? formatPercent(metrics.cachedRatio, 1)
             : '-';
     };
     const providerEntries = Object.values(usage.providers).sort((a, b) => b.total - a.total);
@@ -711,25 +814,15 @@ export function renderMarkdownReport(period, usage, quotas, options) {
                 checkedAt: 0,
             })} (${formatUsd(topApiCost.apiCost)})`);
         }
-        const bestCacheCoverage = providerEntries
+        const bestCachedRatio = providerEntries
             .map((provider) => ({
             provider,
-            value: getProviderCacheCoverageMetrics(provider).cacheCoverage,
+            value: getProviderCacheCoverageMetrics(provider).cachedRatio,
         }))
             .filter((entry) => entry.value !== undefined)
             .sort((a, b) => b.value - a.value)[0];
-        if (bestCacheCoverage) {
-            lines.push(`- Best Cache Coverage: ${providerLabel(bestCacheCoverage.provider.providerID)} (${formatPercent(bestCacheCoverage.value, 1)})`);
-        }
-        const bestCacheReadCoverage = providerEntries
-            .map((provider) => ({
-            provider,
-            value: getProviderCacheCoverageMetrics(provider).cacheReadCoverage,
-        }))
-            .filter((entry) => entry.value !== undefined)
-            .sort((a, b) => b.value - a.value)[0];
-        if (bestCacheReadCoverage) {
-            lines.push(`- Best Cache Read Coverage: ${providerLabel(bestCacheReadCoverage.provider.providerID)} (${formatPercent(bestCacheReadCoverage.value, 1)})`);
+        if (bestCachedRatio) {
+            lines.push(`- Best Cached Ratio: ${providerLabel(bestCachedRatio.provider.providerID)} (${formatPercent(bestCachedRatio.value, 1)})`);
         }
         const highestMeasured = providerEntries
             .filter((provider) => measuredCostCell(provider.providerID, provider.cost) !== '-')
@@ -742,9 +835,15 @@ export function renderMarkdownReport(period, usage, quotas, options) {
     const providerRows = providerEntries.map((provider) => {
         const providerID = mdCell(provider.providerID);
         return showCost
-            ? `| ${providerID} | ${shortNumber(provider.assistantMessages)} | ${shortNumber(provider.input)} | ${shortNumber(provider.output)} | ${shortNumber(provider.cacheRead + provider.cacheWrite)} | ${shortNumber(provider.total)} | ${cacheCoverageCell(provider)} | ${cacheReadCoverageCell(provider)} | ${measuredCostCell(provider.providerID, provider.cost)} | ${apiCostCell(provider.providerID, provider.apiCost)} |`
+            ? `| ${providerID} | ${shortNumber(provider.assistantMessages)} | ${shortNumber(provider.input)} | ${shortNumber(provider.output)} | ${shortNumber(provider.cacheRead + provider.cacheWrite)} | ${shortNumber(provider.total)} | ${cachedCell(provider)} | ${measuredCostCell(provider.providerID, provider.cost)} | ${apiCostCell(provider.providerID, provider.apiCost)} |`
             : `| ${providerID} | ${shortNumber(provider.assistantMessages)} | ${shortNumber(provider.input)} | ${shortNumber(provider.output)} | ${shortNumber(provider.cacheRead + provider.cacheWrite)} | ${shortNumber(provider.total)} |`;
     });
+    const providerHeader = showCost
+        ? '| Provider | Requests | Input | Output | Cache | Total | Cached | Measured Cost | API Cost |'
+        : '| Provider | Requests | Input | Output | Cache | Total |';
+    const providerDivider = showCost
+        ? '| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |'
+        : '| --- | ---: | ---: | ---: | ---: | ---: |';
     const quotaLines = collapseQuotaSnapshots(quotas).flatMap((quota) => {
         const displayLabel = quotaDisplayLabel(quota);
         // Multi-window detail
@@ -785,13 +884,8 @@ export function renderMarkdownReport(period, usage, quotas, options) {
         `- Sessions: ${usage.sessionCount}`,
         `- Requests: ${usage.assistantMessages}`,
         `- Tokens: input ${usage.input}, output ${usage.output}, cache_read ${usage.cacheRead}, cache_write ${usage.cacheWrite}, total ${usage.total}`,
-        ...(cacheMetrics.cacheCoverage !== undefined
-            ? [`- Cache Coverage: ${formatPercent(cacheMetrics.cacheCoverage, 1)}`]
-            : []),
-        ...(cacheMetrics.cacheReadCoverage !== undefined
-            ? [
-                `- Cache Read Coverage: ${formatPercent(cacheMetrics.cacheReadCoverage, 1)}`,
-            ]
+        ...(cacheMetrics.cachedRatio !== undefined
+            ? [`- Cached: ${formatPercent(cacheMetrics.cachedRatio, 1)}`]
             : []),
         ...(showCost
             ? [
@@ -804,21 +898,19 @@ export function renderMarkdownReport(period, usage, quotas, options) {
             : []),
         '',
         '### Usage by Provider',
-        showCost
-            ? '| Provider | Requests | Input | Output | Cache | Total | Cache Coverage | Cache Read Coverage | Measured Cost | API Cost |'
-            : '| Provider | Requests | Input | Output | Cache | Total |',
-        showCost
-            ? '|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|'
-            : '|---|---:|---:|---:|---:|---:|',
+        '',
+        providerHeader,
+        providerDivider,
         ...(providerRows.length
             ? providerRows
             : [
                 showCost
-                    ? '| - | - | - | - | - | - | - | - | - | - |'
+                    ? '| - | - | - | - | - | - | - | - | - |'
                     : '| - | - | - | - | - | - |',
             ]),
         '',
         '### Subscription Quota',
+        '',
         ...(quotaLines.length
             ? quotaLines
             : ['- no provider quota data available']),
@@ -837,28 +929,22 @@ export function renderToastMessage(period, usage, quotas, options) {
         { label: 'Input', value: shortNumber(usage.input) },
         { label: 'Output', value: shortNumber(usage.output) },
     ];
-    if (usage.cacheRead > 0) {
-        tokenPairs.push({
-            label: 'Cache Read',
-            value: shortNumber(usage.cacheRead),
-        });
-    }
     if (usage.cacheWrite > 0) {
         tokenPairs.push({
             label: 'Cache Write',
             value: shortNumber(usage.cacheWrite),
         });
     }
-    if (cacheMetrics.cacheCoverage !== undefined) {
+    if (usage.cacheRead > 0) {
         tokenPairs.push({
-            label: 'Cache Coverage',
-            value: formatPercent(cacheMetrics.cacheCoverage, 1),
+            label: 'Cache Read',
+            value: shortNumber(usage.cacheRead),
         });
     }
-    if (cacheMetrics.cacheReadCoverage !== undefined) {
+    if (cacheMetrics.cachedRatio !== undefined) {
         tokenPairs.push({
-            label: 'Cache Read Coverage',
-            value: formatPercent(cacheMetrics.cacheReadCoverage, 1),
+            label: 'Cached',
+            value: formatPercent(cacheMetrics.cachedRatio, 1),
         });
     }
     lines.push(...alignPairs(tokenPairs).map((line) => fitLine(line, width)));
@@ -884,18 +970,11 @@ export function renderToastMessage(period, usage, quotas, options) {
     const providerCachePairs = Object.values(usage.providers)
         .map((provider) => {
         const metrics = getProviderCacheCoverageMetrics(provider);
-        const parts = [];
-        if (metrics.cacheCoverage !== undefined) {
-            parts.push(`Cov ${formatPercent(metrics.cacheCoverage, 1)}`);
-        }
-        if (metrics.cacheReadCoverage !== undefined) {
-            parts.push(`Read ${formatPercent(metrics.cacheReadCoverage, 1)}`);
-        }
-        if (parts.length === 0)
+        if (metrics.cachedRatio === undefined)
             return undefined;
         return {
             label: displayShortLabel(provider.providerID),
-            value: parts.join('  '),
+            value: `Cached ${formatPercent(metrics.cachedRatio, 1)}`,
         };
     })
         .filter((item) => Boolean(item));

package/dist/title.js

@@ -6,6 +6,8 @@ function sanitizeTitleFragment(value) {
 function isCoreDecoratedDetail(line) {
     if (!line)
         return false;
+    // Legacy coverage/Cov/CRC/CC tokens remain recognized so old decorated titles
+    // can still be detected and cleaned up after format migrations.
     if (/^Requests\s+\$?\d[\d.,]*[kKmM]?$/.test(line))
         return true;
     if (/^Input\s+\$?[\d.,]+[kKmM]?(?:\s+Output(?:\s+\$?[\d.,]+[kKmM]?)?)?~?$/.test(line)) {
@@ -16,8 +18,20 @@ function isCoreDecoratedDetail(line) {
     if (/^Cache(?:\s+Read)?\s+Coverage\s+\d[\d.,]*(?:%|~)?$/.test(line)) {
         return true;
     }
+    if (/^Cache(?:\s+Read|\s+R)?\s+Cov\s+\d[\d.,]*(?:%|~)?$/.test(line)) {
+        return true;
+    }
+    if (/^Cached\s+\d[\d.,]*(?:%|~)?$/.test(line))
+        return true;
     if (/^\$\S+\s+as API cost$/.test(line))
         return true;
+    if (/^API\s+\$\S+$/.test(line))
+        return true;
+    if (/^Est\$\S+$/.test(line))
+        return true;
+    if (/^(?:R\$?[\d.,]+[kKmM]?|I\$?[\d.,]+[kKmM]?|O\$?[\d.,]+[kKmM]?|CR\$?[\d.,]+[kKmM]?|CW\$?[\d.,]+[kKmM]?|Cd\d[\d.,]*%|CC\d[\d.,]*%|CRC\d[\d.,]*%|API\$\S+|Est\$\S+)(?:\s+(?:R\$?[\d.,]+[kKmM]?|I\$?[\d.,]+[kKmM]?|O\$?[\d.,]+[kKmM]?|CR\$?[\d.,]+[kKmM]?|CW\$?[\d.,]+[kKmM]?|Cd\d[\d.,]*%|CC\d[\d.,]*%|CRC\d[\d.,]*%|API\$\S+|Est\$\S+))*$/.test(line)) {
+        return true;
+    }
     // Single-line compact mode compatibility.
     if (/^I(?:nput)?\s+\$?\d[\d.,]*[kKmM]?\s+O(?:utput)?\s+\$?\d[\d.,]*[kKmM]?$/.test(line))
         return true;
@@ -31,12 +45,19 @@ function isCoreDecoratedDetail(line) {
     if (/^C(?:ache(?:\s*R(?:ead)?)?)?\s*Coverage\s+\d[\d.,]*(?:%|~)?$/.test(line)) {
         return true;
     }
+    if (/^C(?:ache(?:\s*(?:R|Read))?)?\s*Cov\s+\d[\d.,]*(?:%|~)?$/.test(line)) {
+        return true;
+    }
+    if (/^Cached\s+\d[\d.,]*(?:%|~)?$/.test(line))
+        return true;
+    if (/^API\s+\$\S+$/.test(line))
+        return true;
     return false;
 }
 function isQuotaDecoratedDetail(line) {
     if (!line)
         return false;
-    if (/^(OAI|Cop|Ant|Kimi|XY|Buzz|RC(?:-[^\s]+)?)(?:\s+(?:\?|unsupported|unavailable|error|(?:\d+h|D|W|M)\d{1,3}|D[\d.,]+\/[\d.,]+|B(?:[￥$-])?[\d.,]+))+$/i.test(line)) {
+    if (/^(OAI|Cop|Ant|Kimi|XYAI|Buzz|RC(?:-[^\s]+)?)(?:\s+(?:\?|unsupported|unavailable|error|(?:\d+h|D|W|M)\d{1,3}|D[\d.,]+\/[\d.,]+|B(?:[￥$-])?[\d.,]+))+$/i.test(line)) {
         return true;
     }
     if (/^(OpenAI|Copilot|Anthropic|Kimi|XYAI|Buzz|RC(?:-[^\s]+)?)\s*$/.test(line)) {
@@ -45,9 +66,21 @@ function isQuotaDecoratedDetail(line) {
     if (/^(?:(?:Daily\s+\$[\d.,]+\/\$[\d.,]+|\$[\d.,]+\/\$[\d.,]+)(?:\s+(?:Rst|Exp\+?)\s+[-:\d]+)?|(?:\d+[hdw]|Weekly|Monthly)\s+\d{1,3}%(?:\s+Rst\s+[-:\d]+)?|Balance\s+\$[\d.,]+|Remaining\s+\?|(?:error|unsupported|unavailable))$/.test(line)) {
         return true;
     }
+    if (/^(?:D\$?[\d.,]+\/\$?[\d.,]+|B(?:[￥$-])?[\d.,]+|(?:\d+[hdw]|[DWM])\d{1,3}|S7d\d{1,3})(?:\s+(?:R|E\+?)\d[\d:.-]*)?$/.test(line)) {
+        return true;
+    }
     if (/^(OpenAI|Copilot|Anthropic|Kimi|XYAI|Buzz|RC(?:-[^\s]+)?)(?:\s+(?:(?:Daily\s+\$[\d.,]+\/\$[\d.,]+|\$[\d.,]+\/\$[\d.,]+)(?:\s+(?:Rst|Exp\+?)\s+[-:\d]+)?|(?:\d+[hdw]|Weekly|Monthly)\s+\d{1,3}%(?:\s+Rst\s+[-:\d]+)?|(?:error|unsupported|unavailable)))$/.test(line)) {
         return true;
     }
+    if (/^(OpenAI|Copilot|Anthropic|Kimi|XYAI|Buzz|RC(?:-[^\s]+)?)(?:\s+(?:D\$?[\d.,]+\/\$?[\d.,]+|B(?:[￥$-])?[\d.,]+|(?:\d+[hdw]|[DWM])\d{1,3}|S7d\d{1,3})(?:\s+(?:R|E\+?)\d[\d:.-]*)?)$/.test(line)) {
+        return true;
+    }
+    if (/^(?:(?:D\$?[\d.,]+\/\$?[\d.,]+|B(?:[￥$-])?[\d.,]+|(?:\d+[hdw]|[DWM])\d{1,3}|S7d\d{1,3}|(?:R|E\+?)\d[\d:.-]*))(?:\s+(?:(?:D\$?[\d.,]+\/\$?[\d.,]+|B(?:[￥$-])?[\d.,]+|(?:\d+[hdw]|[DWM])\d{1,3}|S7d\d{1,3}|(?:R|E\+?)\d[\d:.-]*)))*$/.test(line)) {
+        return true;
+    }
+    if (/^(OpenAI|Copilot|Anthropic|Kimi|XYAI|Buzz|RC(?:-[^\s]+)?)(?:\s+(?:(?:D\$?[\d.,]+\/\$?[\d.,]+|B(?:[￥$-])?[\d.,]+|(?:\d+[hdw]|[DWM])\d{1,3}|S7d\d{1,3}|(?:R|E\+?)\d[\d:.-]*)))*$/.test(line)) {
+        return true;
+    }
     return false;
 }
 function isSingleLineDecoratedPrefix(line) {
@@ -69,8 +102,20 @@ function isSingleLineDecoratedPrefix(line) {
     if (/^Cache(?:\s+Read)?\s+Coverage\s+\d[\d.,]*(?:%|~)$/.test(line)) {
         return true;
     }
+    if (/^Cache(?:\s+Read|\s+R)?\s+Cov\s+\d[\d.,]*(?:%|~)$/.test(line)) {
+        return true;
+    }
+    if (/^Cached\s+\d[\d.,]*(?:%|~)$/.test(line))
+        return true;
     if (/^\$\S+\s+as API cost(?:~|$)/.test(line))
         return true;
+    if (/^API\s+\$\S+(?:~|$)/.test(line))
+        return true;
+    if (/^Est\$\S+(?:~|$)/.test(line))
+        return true;
+    if (/^(?:R\$?[\d.,]+[kKmM]?|I\$?[\d.,]+[kKmM]?|O\$?[\d.,]+[kKmM]?|CR\$?[\d.,]+[kKmM]?|CW\$?[\d.,]+[kKmM]?|Cd\d[\d.,]*%|CC\d[\d.,]*%|CRC\d[\d.,]*%|API\$\S+|Est\$\S+)(?:\s+(?:R\$?[\d.,]+[kKmM]?|I\$?[\d.,]+[kKmM]?|O\$?[\d.,]+[kKmM]?|CR\$?[\d.,]+[kKmM]?|CW\$?[\d.,]+[kKmM]?|Cd\d[\d.,]*%|CC\d[\d.,]*%|CRC\d[\d.,]*%|API\$\S+|Est\$\S+))*?(?:~|$)/.test(line)) {
+        return true;
+    }
     return false;
 }
 function isSingleLineDetailPrefix(line) {

package/dist/tools.js

@@ -11,7 +11,7 @@ export function createQuotaSidebarTools(deps) {
     };
     return {
         quota_summary: tool({
-            description: 'Show usage and quota summary for session/day/week/month.',
+            description: 'Show usage and quota summary for session/day/week/month. Returns the full markdown report with totals, highlights, provider table, and subscription quota so callers can present the report directly to the user.',
             args: {
                 period: z.enum(['session', 'day', 'week', 'month']).optional(),
                 toast: z.boolean().optional(),
@@ -42,7 +42,7 @@ export function createQuotaSidebarTools(deps) {
             },
         }),
         quota_show: tool({
-            description: 'Toggle sidebar title display mode. When on, titles show token usage and quota; when off, titles revert to original.',
+            description: 'Toggle sidebar title display mode. When on, titles show token usage and quota; when off, titles revert to original. Returns a user-facing status message that callers should present directly.',
             args: {
                 enabled: z
                     .boolean()

package/dist/types.d.ts

@@ -53,18 +53,15 @@ export type CacheUsageBuckets = {
     readWrite: CacheUsageBucket;
 };
 /**
- * Derived cache coverage metrics.
+ * Derived cache metrics.
  *
- * - `cacheCoverage`: fraction of prompt surface covered by read-write cache
- *   (`(cacheRead + cacheWrite) / (input + cacheRead + cacheWrite)`).
- *   Only defined when the read-write bucket has traffic.
- * - `cacheReadCoverage`: fraction of prompt surface served from read-only cache
- *   (`cacheRead / (input + cacheRead)`).
- *   Only defined when the read-only bucket has traffic.
+ * - `cachedRatio`: fraction of the observed input surface that was served from
+ *   cache (`cacheRead / (input + cacheRead)`).
+ *   This is an exact ratio over normalized message totals, not a theoretical
+ *   cache hit rate.
  */
 export type CacheCoverageMetrics = {
-    cacheCoverage: number | undefined;
-    cacheReadCoverage: number | undefined;
+    cachedRatio: number | undefined;
 };
 export type RecentProviderEvent = {
     providerID: string;
@@ -81,7 +78,7 @@ export type CachedProviderUsage = {
     /** Equivalent API billing cost (USD) computed from model pricing. */
     apiCost: number;
     assistantMessages: number;
-    /** Provider-level cache coverage buckets grouped by model cache behavior. */
+    /** Provider-level cache buckets grouped by model cache behavior. */
     cacheBuckets?: CacheUsageBuckets;
 };
 export type CachedSessionUsage = {
@@ -98,7 +95,7 @@ export type CachedSessionUsage = {
     apiCost: number;
     assistantMessages: number;
     /**
-     * Cache coverage buckets grouped by model cache behavior.
+     * Cache buckets grouped by model cache behavior.
      *
      * `undefined` when no cache-capable models were used or data predates
      * billingVersion 3. The fallback in `resolvedCacheUsageBuckets()` derives
@@ -150,9 +147,9 @@ export type QuotaSidebarConfig = {
         enabled: boolean;
         width: number;
         /**
-         * When true, render multi-line decorated session titles.
-         * Enabled by default for clearer token/quota layout in sidebar.
-         * Set false to keep a compact single-line title.
+         * Legacy switch retained for compatibility.
+         * TUI keeps a compact multiline sidebar layout; Desktop keeps a compact
+         * single-line layout.
          */
         multilineTitle?: boolean;
         showCost: boolean;

package/dist/usage.d.ts

@@ -6,7 +6,7 @@ import type { CacheCoverageMetrics, CacheCoverageMode, CacheUsageBuckets, Cached
  * fields).  This is distinct from the plugin *state* version managed by the
  * persistence layer; billing version only governs usage-cache staleness.
  */
-export declare const USAGE_BILLING_CACHE_VERSION = 6;
+export declare const USAGE_BILLING_CACHE_VERSION = 7;
 export type ProviderUsage = {
     providerID: string;
     input: number;

package/dist/usage.js

@@ -4,7 +4,7 @@
  * fields).  This is distinct from the plugin *state* version managed by the
  * persistence layer; billing version only governs usage-cache staleness.
  */
-export const USAGE_BILLING_CACHE_VERSION = 6;
+export const USAGE_BILLING_CACHE_VERSION = 7;
 const MAX_RECENT_PROVIDER_EVENTS = 100;
 function emptyCacheUsageBucket() {
     return {
@@ -107,18 +107,11 @@ function resolvedCacheUsageBuckets(usage) {
     return explicit;
 }
 export function getCacheCoverageMetrics(usage) {
-    const buckets = resolvedCacheUsageBuckets(usage);
-    const readWritePromptSurface = buckets.readWrite.input +
-        buckets.readWrite.cacheRead +
-        buckets.readWrite.cacheWrite;
-    const readOnlyPromptSurface = buckets.readOnly.input + buckets.readOnly.cacheRead;
+    const hasCacheActivity = usage.cacheRead > 0 || usage.cacheWrite > 0;
+    const cachedSurface = usage.input + usage.cacheRead;
     return {
-        cacheCoverage: readWritePromptSurface > 0
-            ? (buckets.readWrite.cacheRead + buckets.readWrite.cacheWrite) /
-                readWritePromptSurface
-            : undefined,
-        cacheReadCoverage: readOnlyPromptSurface > 0
-            ? buckets.readOnly.cacheRead / readOnlyPromptSurface
+        cachedRatio: hasCacheActivity && cachedSurface > 0
+            ? usage.cacheRead / cachedSurface
             : undefined,
     };
 }

package/dist/usage_service.js

@@ -70,15 +70,16 @@ export function createUsageService(deps) {
                 if (!rates)
                     continue;
                 const modelID = typeof modelValue.id === 'string' ? modelValue.id : modelKey;
-                acc[modelCostKey(rawProviderID, modelID)] = rates;
-                if (modelKey !== modelID) {
-                    acc[modelCostKey(rawProviderID, modelKey)] = rates;
-                }
+                const lookupKeys = new Set([
+                    ...modelCostLookupKeys(rawProviderID, modelID),
+                    ...modelCostLookupKeys(rawProviderID, modelKey),
+                ]);
                 if (canonicalProviderID !== rawProviderID) {
-                    acc[modelCostKey(canonicalProviderID, modelID)] = rates;
-                    if (modelKey !== modelID) {
-                        acc[modelCostKey(canonicalProviderID, modelKey)] = rates;
-                    }
+                    lookupKeys.add(modelCostKey(canonicalProviderID, modelID));
+                    lookupKeys.add(modelCostKey(canonicalProviderID, modelKey));
+                }
+                for (const key of lookupKeys) {
+                    acc[key] = rates;
                 }
             }
             return acc;
@@ -130,7 +131,7 @@ export function createUsageService(deps) {
             return 'read-write';
         }
         // Last resort: if the message has cache.read tokens from an unknown provider,
-        // treat it as read-only (the safer default — avoids inflating Cache Coverage).
+        // treat it as read-only (the safer default — avoids overstating cached ratio).
         return 'read-only';
     };
     const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
@@ -332,7 +333,8 @@ export function createUsageService(deps) {
             return { usage: empty, persist: false };
         }
         const modelCostMap = await getModelCostMap();
-        const staleBillingCache = Boolean(sessionState?.usage) && !isUsageBillingCurrent(sessionState?.usage);
+        const staleBillingCache = Boolean(sessionState?.usage) &&
+            !isUsageBillingCurrent(sessionState?.usage);
         const forceRescan = forceRescanSessions.has(sessionID) || staleBillingCache;
         if (forceRescan)
             forceRescanSessions.delete(sessionID);

package/package.json

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