@leo000001/opencode-quota-sidebar 1.10.0 → 1.12.0

package/README.md

@@ -164,6 +164,38 @@ Resolution order (low -> high):
 
 Values are layered; later sources override earlier ones.
 
+## Defaults
+
+If you do not provide any config file, the plugin uses the built-in defaults below.
+
+Sidebar defaults:
+
+- `sidebar.enabled`: `true`
+- `sidebar.width`: `36` (clamped to `20`-`60`)
+- `sidebar.multilineTitle`: `true`
+- `sidebar.showCost`: `true`
+- `sidebar.showQuota`: `true`
+- `sidebar.wrapQuotaLines`: `true`
+- `sidebar.includeChildren`: `true`
+- `sidebar.childrenMaxDepth`: `6` (clamped to `1`-`32`)
+- `sidebar.childrenMaxSessions`: `128` (clamped to `0`-`2000`)
+- `sidebar.childrenConcurrency`: `5` (clamped to `1`-`10`)
+
+Quota defaults:
+
+- `quota.refreshMs`: `300000` (clamped to `>=30000`)
+- `quota.includeOpenAI`: `true`
+- `quota.includeCopilot`: `true`
+- `quota.includeAnthropic`: `true`
+- `quota.providers`: `{}` (per-adapter switches, for example `rightcode.enabled`)
+- `quota.refreshAccessToken`: `false`
+- `quota.requestTimeoutMs`: `8000` (clamped to `>=1000`)
+
+Other defaults:
+
+- `toast.durationMs`: `12000` (clamped to `>=1000`)
+- `retentionDays`: `730`
+
 Example config:
 
 ```json
@@ -171,8 +203,10 @@ Example config:
   "sidebar": {
     "enabled": true,
     "width": 36,
+    "multilineTitle": true,
     "showCost": true,
     "showQuota": true,
+    "wrapQuotaLines": true,
     "includeChildren": true,
     "childrenMaxDepth": 6,
     "childrenMaxSessions": 128,
@@ -202,6 +236,8 @@ Notes:
 
 - `sidebar.showCost` controls API-cost visibility in sidebar title, `quota_summary` markdown report, and toast message.
 - `sidebar.width` is measured in terminal cells. CJK/emoji truncation is best-effort to avoid sidebar overflow.
+- `sidebar.multilineTitle` controls multi-line sidebar layout (default: `true`). Set `false` for compact single-line title.
+- `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).
 - `sidebar.childrenMaxSessions` caps the total number of descendant sessions aggregated (default: `128`, clamped 0–2000).
@@ -211,6 +247,81 @@ Notes:
 - `quota.providers` is the extensible per-adapter switch map.
 - If API Cost is `$0.00`, it usually means the model/provider has no pricing mapping in OpenCode at the moment, so equivalent API cost cannot be estimated.
 
+## Rendering examples
+
+These examples show the quota block portion of the sidebar title.
+
+### `sidebar.multilineTitle=true`
+
+0 providers (no quota data):
+
+```text
+(no quota block)
+```
+
+1 provider, 1 window (fits):
+
+```text
+Copilot Monthly 78% Rst 04-01
+```
+
+1 provider, multi-window (for example OpenAI 5h + Weekly):
+
+```text
+OpenAI
+  5h 78% Rst 05:05
+  Weekly 73% Rst 03-12
+```
+
+2+ providers (even if each provider is single-window):
+
+```text
+OpenAI
+  5h 78% Rst 05:05
+Copilot
+  Monthly 78% Rst 04-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
+```
+
+Balance-style quota:
+
+```text
+RC Balance $260
+```
+
+Multi-detail quota (window + balance):
+
+```text
+RC
+  Daily $88.9/$60 Exp 02-27
+  Balance $260
+```
+
+Provider status (examples):
+
+```text
+Anthropic unsupported
+Copilot unavailable
+OpenAI Remaining ?
+```
+
+### `sidebar.multilineTitle=false`
+
+Quota is rendered inline as part of a single-line title:
+
+```text
+<base> | Input ... | Output ... | OpenAI 5h 78%+ | Copilot Monthly 78% | ...
+```
+
 `quota_summary` also supports an optional `includeChildren` flag (only effective for `period=session`) to override the config per call. For `day`/`week`/`month` periods, children are never merged — each session is counted independently.
 
 ## Debug logging

package/dist/format.js

@@ -162,6 +162,56 @@ function alignPairs(pairs, indent = '  ') {
         return `${indent}${padEndCells(pair.label, labelWidth)}  ${pair.value}`;
     });
 }
+function compactQuotaInline(quota) {
+    const label = sanitizeLine(quotaDisplayLabel(quota));
+    if (quota.status !== 'ok')
+        return label;
+    if (quota.windows && quota.windows.length > 0) {
+        const first = quota.windows[0];
+        const showPercent = first.showPercent !== false;
+        const firstLabel = sanitizeLine(first.label || '');
+        const pct = first.remainingPercent === undefined
+            ? undefined
+            : `${Math.round(first.remainingPercent)}%`;
+        const summary = showPercent
+            ? [firstLabel, pct].filter(Boolean).join(' ')
+            : firstLabel.replace(/^Daily\s+/i, '') || firstLabel;
+        const hasMore = quota.windows.length > 1 ||
+            (quota.balance !== undefined && !summary.includes('Balance '));
+        return `${label}${summary ? ` ${summary}` : ''}${hasMore ? '+' : ''}`;
+    }
+    if (quota.balance) {
+        return `${label} ${formatCurrency(quota.balance.amount, quota.balance.currency)}`;
+    }
+    if (quota.remainingPercent !== undefined) {
+        return `${label} ${Math.round(quota.remainingPercent)}%`;
+    }
+    return label;
+}
+function renderSingleLineTitle(baseTitle, usage, quotas, config, width) {
+    const baseBudget = Math.min(16, Math.max(8, Math.floor(width * 0.35)));
+    const base = fitLine(baseTitle, baseBudget);
+    const segments = [
+        `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 (config.sidebar.showCost && usage.apiCost > 0) {
+        segments.push(formatApiCostLine(usage.apiCost));
+    }
+    if (config.sidebar.showQuota) {
+        const visibleQuotas = collapseQuotaSnapshots(quotas).filter((q) => ['ok', 'error', 'unsupported', 'unavailable'].includes(q.status));
+        segments.push(...visibleQuotas.map(compactQuotaInline));
+    }
+    const detail = segments.filter(Boolean).join(' | ');
+    if (!detail)
+        return fitLine(baseTitle, width);
+    return fitLine(`${base} | ${detail}`, width);
+}
 /**
  * Render sidebar title with multi-line token breakdown.
  *
@@ -175,8 +225,11 @@ function alignPairs(pairs, indent = '  ') {
  */
 export function renderSidebarTitle(baseTitle, usage, quotas, config) {
     const width = Math.max(8, Math.floor(config.sidebar.width || 36));
-    const lines = [];
     const safeBaseTitle = stripAnsi(baseTitle || 'Session').split(/\r?\n/, 1)[0] || 'Session';
+    if (config.sidebar.multilineTitle !== true) {
+        return renderSingleLineTitle(safeBaseTitle, usage, quotas, config, width);
+    }
+    const lines = [];
     lines.push(fitLine(safeBaseTitle, width));
     lines.push('');
     // Input / Output line
@@ -195,6 +248,9 @@ export function renderSidebarTitle(baseTitle, usage, quotas, config) {
     // 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 labelWidth = visibleQuotas.reduce((max, item) => {
             const label = sanitizeLine(quotaDisplayLabel(item));
             return Math.max(max, stringCellWidth(label));
@@ -203,6 +259,7 @@ export function renderSidebarTitle(baseTitle, usage, quotas, config) {
             .flatMap((item) => compactQuotaWide(item, labelWidth, {
             width,
             wrapLines: config.sidebar.wrapQuotaLines,
+            forceWrapped: forceWrappedProviders,
         }))
             .filter((s) => Boolean(s));
         if (quotaItems.length > 0) {
@@ -237,19 +294,22 @@ function compactQuotaWide(quota, labelWidth = 0, options) {
     const withLabel = (content) => `${labelPadded} ${content}`;
     const wrap = options?.wrapLines === true && (options?.width || 0) > 0;
     const width = options?.width || 0;
+    const forceWrapped = options?.forceWrapped === true;
     /** If inline version overflows, break into label-line + indented detail lines. */
     const maybeBreak = (inlineText, detailLines) => {
         const inline = withLabel(inlineText);
+        if (forceWrapped)
+            return [label, ...detailLines.map((d) => `${detailIndent}${d}`)];
         if (!wrap || stringCellWidth(inline) <= width)
             return [inline];
         return [label, ...detailLines.map((d) => `${detailIndent}${d}`)];
     };
     if (quota.status === 'error')
-        return [withLabel('Remaining ?')];
+        return maybeBreak('Remaining ?', ['Remaining ?']);
     if (quota.status === 'unsupported')
-        return [withLabel('unsupported')];
+        return maybeBreak('unsupported', ['unsupported']);
     if (quota.status === 'unavailable')
-        return [withLabel('unavailable')];
+        return maybeBreak('unavailable', ['unavailable']);
     if (quota.status !== 'ok')
         return [];
     const balanceText = quota.balance

package/dist/index.js

@@ -155,7 +155,6 @@ export async function QuotaSidebarPlugin(input) {
         markDirty,
         scheduleSave,
         renderSidebarTitle,
-        quotaRuntime,
         getQuotaSnapshots,
         summarizeSessionUsageForDisplay,
         scheduleParentRefreshIfSafe,

package/dist/providers/core/copilot.js

@@ -2,11 +2,15 @@ import { isRecord, swallow } from '../../helpers.js';
 import { asNumber, configuredProviderEnabled, fetchWithTimeout, normalizePercent, toIso, } from '../common.js';
 async function fetchCopilotQuota(ctx) {
     const checkedAt = Date.now();
+    const sourceProviderID = typeof ctx.sourceProviderID === 'string' && ctx.sourceProviderID
+        ? ctx.sourceProviderID
+        : ctx.providerID;
+    const enterprise = sourceProviderID.startsWith('github-copilot-enterprise');
     const base = {
-        providerID: ctx.providerID,
+        providerID: sourceProviderID,
         adapterID: 'github-copilot',
-        label: 'GitHub Copilot',
-        shortLabel: 'Copilot',
+        label: enterprise ? 'GitHub Copilot Enterprise' : 'GitHub Copilot',
+        shortLabel: enterprise ? 'Copilot Ent' : 'Copilot',
         sortOrder: 20,
     };
     if (!ctx.auth) {

package/dist/storage.js

@@ -11,6 +11,7 @@ export const defaultConfig = {
     sidebar: {
         enabled: true,
         width: 36,
+        multilineTitle: true,
         showCost: true,
         showQuota: true,
         wrapQuotaLines: true,
@@ -64,6 +65,7 @@ export async function loadConfig(paths) {
             sidebar: {
                 enabled: asBoolean(sidebar.enabled, base.sidebar.enabled),
                 width: Math.max(20, Math.min(60, asNumber(sidebar.width, base.sidebar.width))),
+                multilineTitle: asBoolean(sidebar.multilineTitle, base.sidebar.multilineTitle ?? true),
                 showCost: asBoolean(sidebar.showCost, base.sidebar.showCost),
                 showQuota: asBoolean(sidebar.showQuota, base.sidebar.showQuota),
                 wrapQuotaLines: asBoolean(sidebar.wrapQuotaLines, base.sidebar.wrapQuotaLines),

package/dist/title.js

@@ -1,6 +1,51 @@
+function sanitizeTitleFragment(value) {
+    return stripAnsi(value)
+        .replace(/[\x00-\x1F\x7F-\x9F]/g, ' ')
+        .trimEnd();
+}
+function isStrongDecoratedDetail(line) {
+    if (!line)
+        return false;
+    if (/^Input\s+\S+\s+Output(?:\s+\S+)?/.test(line))
+        return true;
+    if (/^Cache\s+(Read|Write)\s+\S+/.test(line))
+        return true;
+    if (/^\$\S+\s+as API cost\b/.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;
+    if (/^C(?:ache\s*)?R(?:ead)?\s+\$?\d[\d.,]*[kKmM]?$/.test(line))
+        return true;
+    if (/^C(?:ache\s*)?W(?:rite)?\s+\$?\d[\d.,]*[kKmM]?$/.test(line))
+        return true;
+    return false;
+}
+function isQuotaLikeProviderDetail(line) {
+    if (!line)
+        return false;
+    if (!/^(OpenAI|Copilot|Anthropic|RightCode|RC)\b/.test(line))
+        return false;
+    return /\b(Rst|Exp\+?|Balance|Remaining)\b|\d{1,3}%/.test(line);
+}
+function decoratedSingleLineBase(line) {
+    const parts = sanitizeTitleFragment(line)
+        .split(/\s*\|\s*/)
+        .map((part) => part.trim());
+    if (parts.length < 2)
+        return undefined;
+    const details = parts.slice(1);
+    if (!details.some((detail) => isStrongDecoratedDetail(detail))) {
+        return undefined;
+    }
+    return parts[0] || 'Session';
+}
 export function normalizeBaseTitle(title) {
     const firstLine = stripAnsi(title).split(/\r?\n/, 1)[0] || 'Session';
-    return firstLine.replace(/[\x00-\x1F\x7F-\x9F]/g, ' ').trimEnd() || 'Session';
+    const decoratedBase = decoratedSingleLineBase(firstLine);
+    if (decoratedBase)
+        return decoratedBase;
+    return sanitizeTitleFragment(firstLine) || 'Session';
 }
 export function stripAnsi(value) {
     // Remove terminal escape sequences. Sidebar titles must be plain text.
@@ -40,20 +85,12 @@ export function canonicalizeTitleForCompare(value) {
  */
 export function looksDecorated(title) {
     const lines = stripAnsi(title).split(/\r?\n/);
-    if (lines.length < 2)
-        return false;
-    const detail = lines.slice(1).map((line) => line.trim());
-    return detail.some((line) => {
-        if (!line)
-            return false;
-        if (/^Input\s+\S+\s+Output\s+\S+/.test(line))
-            return true;
-        if (/^Cache\s+(Read|Write)\s+\S+/.test(line))
-            return true;
-        if (/^\$\S+\s+as API cost/.test(line))
-            return true;
-        if (/^(OpenAI|Copilot|Anthropic|RightCode|RC)\b/.test(line))
-            return true;
-        return false;
-    });
+    if (lines.length < 2) {
+        return Boolean(decoratedSingleLineBase(lines[0] || ''));
+    }
+    const detail = lines
+        .slice(1)
+        .map((line) => sanitizeTitleFragment(line).trim());
+    return (detail.some((line) => isStrongDecoratedDetail(line)) ||
+        detail.some((line) => isQuotaLikeProviderDetail(line)));
 }

package/dist/title_apply.d.ts

@@ -10,9 +10,6 @@ export declare function createTitleApplicator(deps: {
     markDirty: (dateKey: string | undefined) => void;
     scheduleSave: () => void;
     renderSidebarTitle: (baseTitle: string, usage: UsageSummary, quotas: QuotaSnapshot[], config: QuotaSidebarConfig) => string;
-    quotaRuntime: {
-        normalizeProviderID: (providerID: string) => string;
-    };
     getQuotaSnapshots: (providerIDs: string[], options?: {
         allowDefault?: boolean;
     }) => Promise<QuotaSnapshot[]>;

package/dist/title_apply.js

@@ -56,7 +56,7 @@ export function createTitleApplicator(deps) {
             }
         }
         const usage = await deps.summarizeSessionUsageForDisplay(sessionID, deps.config.sidebar.includeChildren);
-        const quotaProviders = Array.from(new Set(Object.keys(usage.providers).map((id) => deps.quotaRuntime.normalizeProviderID(id))));
+        const quotaProviders = Array.from(new Set(Object.keys(usage.providers)));
         const quotas = deps.config.sidebar.showQuota && quotaProviders.length > 0
             ? await deps.getQuotaSnapshots(quotaProviders)
             : [];

package/dist/types.d.ts

@@ -97,6 +97,12 @@ export type QuotaSidebarConfig = {
     sidebar: {
         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.
+         */
+        multilineTitle?: boolean;
         showCost: boolean;
         showQuota: boolean;
         /** When true, wrap long quota lines and indent continuations. */

package/package.json

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

package/quota-sidebar.config.example.json

@@ -2,8 +2,10 @@
   "sidebar": {
     "enabled": true,
     "width": 36,
+    "multilineTitle": true,
     "showCost": true,
     "showQuota": true,
+    "wrapQuotaLines": true,
     "includeChildren": true,
     "childrenMaxDepth": 6,
     "childrenMaxSessions": 128,