@leo000001/opencode-quota-sidebar 1.0.0

package/dist/format.js

@@ -0,0 +1,426 @@
+import { canonicalProviderID, collapseQuotaSnapshots, displayShortLabel, quotaDisplayLabel, } from './quota_render.js';
+import { stripAnsi } from './title.js';
+/** M6 fix: handle negative, NaN, Infinity gracefully. */
+function shortNumber(value, decimals = 1) {
+    if (!Number.isFinite(value) || value < 0)
+        return '0';
+    if (value >= 1_000_000)
+        return `${(value / 1_000_000).toFixed(decimals)}m`;
+    if (value >= 1000) {
+        const k = value / 1000;
+        // Avoid "1000.0k" — promote to "m" when rounding pushes past 999
+        if (Number(k.toFixed(decimals)) >= 1000)
+            return `${(value / 1_000_000).toFixed(decimals)}m`;
+        return `${k.toFixed(decimals)}k`;
+    }
+    return `${Math.round(value)}`;
+}
+/** Sidebar token display: adaptive short unit (k/m) with one decimal. */
+function sidebarNumber(value) {
+    return shortNumber(value, 1);
+}
+/**
+ * Truncate `value` to at most `width` visible characters.
+ * Keep plain text only (no ANSI) to avoid renderer corruption.
+ */
+function fitLine(value, width) {
+    if (width <= 0)
+        return '';
+    if (value.length > width) {
+        return width <= 1 ? value.slice(0, width) : `${value.slice(0, width - 1)}~`;
+    }
+    return value;
+}
+function formatApiCostValue(value) {
+    const safe = Number.isFinite(value) && value > 0 ? value : 0;
+    return `$${safe.toFixed(2)}`;
+}
+function formatApiCostLine(value) {
+    return `${formatApiCostValue(value)} as API cost`;
+}
+function alignPairs(pairs, indent = '  ') {
+    if (pairs.length === 0)
+        return [];
+    const labelWidth = Math.max(...pairs.map((pair) => pair.label.length), 0);
+    return pairs.map((pair) => {
+        if (!pair.label) {
+            return `${indent}${' '.repeat(labelWidth)}  ${pair.value}`;
+        }
+        return `${indent}${pair.label.padEnd(labelWidth)}  ${pair.value}`;
+    });
+}
+/**
+ * Render sidebar title with multi-line token breakdown.
+ *
+ * Layout:
+ *   Session title
+ *   Input 18.9k  Output 53
+ *   Cache Read 1.5k           (only if read > 0)
+ *   Cache Write 200           (only if write > 0)
+ *   $3.81 as API cost         (only if showCost=true)
+ *   OpenAI Remaining 78%      (only if quota available)
+ */
+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';
+    lines.push(fitLine(safeBaseTitle, width));
+    lines.push('');
+    // Input / Output line
+    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 (config.sidebar.showCost && usage.apiCost > 0) {
+        lines.push(fitLine(formatApiCostLine(usage.apiCost), 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));
+        const labelWidth = visibleQuotas.reduce((max, item) => {
+            const label = quotaDisplayLabel(item);
+            return Math.max(max, label.length);
+        }, 0);
+        const quotaItems = visibleQuotas
+            .flatMap((item) => compactQuotaWide(item, labelWidth))
+            .filter((s) => Boolean(s));
+        if (quotaItems.length > 0) {
+            lines.push('');
+        }
+        for (const line of quotaItems) {
+            lines.push(fitLine(line, width));
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Multi-window quota format for sidebar.
+ * Single window:  "OpenAI 5h 80% Rst 16:20"
+ * Multi window:   "OpenAI 5h 80% Rst 16:20" + indented next line
+ * Copilot:        "Copilot Monthly 70% Rst 03-01"
+ */
+function compactQuotaWide(quota, labelWidth = 0) {
+    const label = quotaDisplayLabel(quota);
+    const labelPadding = ' '.repeat(Math.max(0, labelWidth - label.length));
+    const withLabel = (content) => `${label}${labelPadding} ${content}`;
+    if (quota.status === 'error')
+        return [withLabel('Remaining ?')];
+    if (quota.status === 'unsupported')
+        return [withLabel('unsupported')];
+    if (quota.status === 'unavailable')
+        return [withLabel('unavailable')];
+    if (quota.status !== 'ok')
+        return [];
+    const balanceText = quota.balance
+        ? `Balance ${quota.balance.currency}${quota.balance.amount.toFixed(2)}`
+        : undefined;
+    const renderWindow = (win) => {
+        const showPercent = win.showPercent !== false;
+        const pct = win.remainingPercent === undefined
+            ? '?'
+            : `${Math.round(win.remainingPercent)}%`;
+        const parts = win.label
+            ? showPercent
+                ? [win.label, pct]
+                : [win.label]
+            : [pct];
+        const reset = compactReset(win.resetAt);
+        if (reset) {
+            parts.push(`${win.resetLabel || 'Rst'} ${reset}`);
+        }
+        return parts.join(' ');
+    };
+    // Multi-window rendering
+    if (quota.windows && quota.windows.length > 0) {
+        const parts = quota.windows.map(renderWindow);
+        if (parts.length === 1) {
+            const first = withLabel(parts[0]);
+            if (balanceText && !parts[0].includes('Balance ')) {
+                const indent = ' '.repeat(labelWidth + 1);
+                return [first, `${indent}${balanceText}`];
+            }
+            return [first];
+        }
+        const indent = ' '.repeat(labelWidth + 1);
+        const lines = [
+            withLabel(parts[0]),
+            ...parts.slice(1).map((part) => `${indent}${part}`),
+        ];
+        const alreadyHasBalance = parts.some((part) => part.includes('Balance '));
+        if (balanceText && !alreadyHasBalance) {
+            lines.push(`${indent}${balanceText}`);
+        }
+        return lines;
+    }
+    if (balanceText) {
+        return [withLabel(balanceText)];
+    }
+    // Fallback: single value from top-level remainingPercent
+    const percent = quota.remainingPercent === undefined
+        ? '?'
+        : `${Math.round(quota.remainingPercent)}%`;
+    const reset = compactReset(quota.resetAt);
+    return [withLabel(`Remaining ${percent}${reset ? ` Rst ${reset}` : ''}`)];
+}
+function compactReset(iso) {
+    if (!iso)
+        return undefined;
+    const timestamp = Date.parse(iso);
+    if (Number.isNaN(timestamp))
+        return undefined;
+    const value = new Date(timestamp);
+    const now = new Date();
+    const sameDay = value.getFullYear() === now.getFullYear() &&
+        value.getMonth() === now.getMonth() &&
+        value.getDate() === now.getDate();
+    const two = (num) => `${num}`.padStart(2, '0');
+    if (sameDay) {
+        return `${two(value.getHours())}:${two(value.getMinutes())}`;
+    }
+    return `${two(value.getMonth() + 1)}-${two(value.getDate())}`;
+}
+function dateLine(iso) {
+    if (!iso)
+        return '-';
+    const time = Date.parse(iso);
+    if (Number.isNaN(time))
+        return iso;
+    return new Date(time).toLocaleString();
+}
+function periodLabel(period) {
+    if (period === 'day')
+        return 'Today';
+    if (period === 'week')
+        return 'This Week';
+    if (period === 'month')
+        return 'This Month';
+    return 'Current Session';
+}
+export function renderMarkdownReport(period, usage, quotas, options) {
+    const showCost = options?.showCost !== false;
+    const rightCodeSubscriptionProviderIDs = new Set(collapseQuotaSnapshots(quotas)
+        .filter((quota) => quota.adapterID === 'rightcode')
+        .filter((quota) => quota.status === 'ok')
+        .filter((quota) => Array.isArray(quota.windows) && quota.windows.length)
+        .filter((quota) => quota.windows[0].label.startsWith('Daily $'))
+        .map((quota) => quota.providerID));
+    const measuredCostCell = (providerID, cost) => {
+        const canonical = canonicalProviderID(providerID);
+        const isSubscription = canonical === 'openai' ||
+            canonical === 'github-copilot' ||
+            rightCodeSubscriptionProviderIDs.has(providerID);
+        if (isSubscription)
+            return '-';
+        return `$${cost.toFixed(3)}`;
+    };
+    const isSubscriptionMeasuredProvider = (providerID) => {
+        const canonical = canonicalProviderID(providerID);
+        return (canonical === 'openai' ||
+            canonical === 'github-copilot' ||
+            rightCodeSubscriptionProviderIDs.has(providerID));
+    };
+    const apiCostCell = (providerID, apiCost) => {
+        const canonical = canonicalProviderID(providerID);
+        if (canonical === 'github-copilot')
+            return '-';
+        if (!Number.isFinite(apiCost) || apiCost <= 0)
+            return '$0.00';
+        return `$${apiCost.toFixed(2)}`;
+    };
+    const measuredCostSummaryValue = () => {
+        const providers = Object.values(usage.providers);
+        if (providers.length === 0)
+            return `$${usage.cost.toFixed(4)}`;
+        const hasNonSubscription = providers.some((provider) => !isSubscriptionMeasuredProvider(provider.providerID));
+        if (!hasNonSubscription)
+            return '-';
+        return `$${usage.cost.toFixed(4)}`;
+    };
+    const apiCostSummaryValue = () => {
+        const providers = Object.values(usage.providers);
+        if (providers.length === 0)
+            return formatApiCostValue(usage.apiCost);
+        const hasNonCopilot = providers.some((provider) => canonicalProviderID(provider.providerID) !== 'github-copilot');
+        if (!hasNonCopilot)
+            return '-';
+        return formatApiCostValue(usage.apiCost);
+    };
+    const providerRows = Object.values(usage.providers)
+        .sort((a, b) => b.total - a.total)
+        .map((provider) => showCost
+        ? `| ${provider.providerID} | ${shortNumber(provider.input)} | ${shortNumber(provider.output)} | ${shortNumber(provider.cacheRead + provider.cacheWrite)} | ${shortNumber(provider.total)} | ${measuredCostCell(provider.providerID, provider.cost)} | ${apiCostCell(provider.providerID, provider.apiCost)} |`
+        : `| ${provider.providerID} | ${shortNumber(provider.input)} | ${shortNumber(provider.output)} | ${shortNumber(provider.cacheRead + provider.cacheWrite)} | ${shortNumber(provider.total)} |`);
+    const quotaLines = collapseQuotaSnapshots(quotas).flatMap((quota) => {
+        // Multi-window detail
+        if (quota.windows && quota.windows.length > 0 && quota.status === 'ok') {
+            return quota.windows.map((win) => {
+                if (win.showPercent === false) {
+                    const winLabel = win.label ? ` (${win.label})` : '';
+                    return `- ${quota.label}${winLabel}: ${quota.status} | reset ${dateLine(win.resetAt)}`;
+                }
+                const remaining = win.remainingPercent === undefined
+                    ? '-'
+                    : `${win.remainingPercent.toFixed(1)}%`;
+                const winLabel = win.label ? ` (${win.label})` : '';
+                return `- ${quota.label}${winLabel}: ${quota.status} | remaining ${remaining} | reset ${dateLine(win.resetAt)}`;
+            });
+        }
+        if (quota.status === 'ok' && quota.balance) {
+            return [
+                `- ${quota.label}: ${quota.status} | balance ${quota.balance.currency}${quota.balance.amount.toFixed(2)}`,
+            ];
+        }
+        const remaining = quota.remainingPercent === undefined
+            ? '-'
+            : `${quota.remainingPercent.toFixed(1)}%`;
+        return [
+            `- ${quota.label}: ${quota.status} | remaining ${remaining} | reset ${dateLine(quota.resetAt)}${quota.note ? ` | ${quota.note}` : ''}`,
+        ];
+    });
+    return [
+        `## Quota Report - ${periodLabel(period)}`,
+        '',
+        `- Sessions: ${usage.sessionCount}`,
+        `- Assistant messages: ${usage.assistantMessages}`,
+        `- Tokens: input ${usage.input}, output ${usage.output}, cache_read ${usage.cacheRead}, cache_write ${usage.cacheWrite}, total ${usage.total}`,
+        ...(showCost
+            ? [
+                `- Measured cost: ${measuredCostSummaryValue()}`,
+                `- API cost: ${apiCostSummaryValue()}`,
+            ]
+            : []),
+        '',
+        '### Usage by Provider',
+        showCost
+            ? '| Provider | Input | Output | Cache | Total | Measured Cost | API Cost |'
+            : '| Provider | Input | Output | Cache | Total |',
+        showCost
+            ? '|---|---:|---:|---:|---:|---:|---:|'
+            : '|---|---:|---:|---:|---:|',
+        ...(providerRows.length
+            ? providerRows
+            : [showCost ? '| - | - | - | - | - | - | - |' : '| - | - | - | - | - |']),
+        '',
+        '### Subscription Quota',
+        ...(quotaLines.length
+            ? quotaLines
+            : ['- no provider quota data available']),
+    ].join('\n');
+}
+export function renderToastMessage(period, usage, quotas, options) {
+    const width = Math.max(24, Math.floor(options?.width || 56));
+    const showCost = options?.showCost !== false;
+    const lines = [];
+    lines.push(fitLine(`${periodLabel(period)} - Total ${shortNumber(usage.total)}`, width));
+    lines.push('');
+    lines.push(fitLine('Token Usage', width));
+    const tokenPairs = [
+        { 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 (showCost) {
+        if (usage.apiCost > 0) {
+            tokenPairs.push({
+                label: 'API Cost',
+                value: formatApiCostValue(usage.apiCost),
+            });
+        }
+    }
+    lines.push(...alignPairs(tokenPairs).map((line) => fitLine(line, width)));
+    if (showCost) {
+        const costPairs = Object.values(usage.providers)
+            .filter((provider) => canonicalProviderID(provider.providerID) !== 'github-copilot')
+            .filter((provider) => provider.apiCost > 0)
+            .sort((left, right) => right.apiCost - left.apiCost)
+            .map((provider) => ({
+            label: displayShortLabel(provider.providerID),
+            value: `$${provider.apiCost.toFixed(2)}`,
+        }));
+        lines.push('');
+        lines.push(fitLine('Cost as API', width));
+        if (costPairs.length > 0) {
+            lines.push(...alignPairs(costPairs).map((line) => fitLine(line, width)));
+        }
+        else {
+            const hasAnyUsage = Object.keys(usage.providers).length > 0;
+            lines.push(fitLine(hasAnyUsage ? '  N/A (Copilot)' : '  -', width));
+        }
+    }
+    const quotaPairs = collapseQuotaSnapshots(quotas).flatMap((item) => {
+        if (item.status === 'ok') {
+            if (item.windows && item.windows.length > 0) {
+                const pairs = item.windows.map((win, idx) => {
+                    const showPercent = win.showPercent !== false;
+                    const pct = win.remainingPercent === undefined
+                        ? '-'
+                        : `${win.remainingPercent.toFixed(1)}%`;
+                    const reset = compactReset(win.resetAt);
+                    const parts = [win.label];
+                    if (showPercent)
+                        parts.push(pct);
+                    if (reset)
+                        parts.push(`${win.resetLabel || 'Rst'} ${reset}`);
+                    return {
+                        label: idx === 0 ? quotaDisplayLabel(item) : '',
+                        value: parts.filter(Boolean).join(' '),
+                    };
+                });
+                if (item.balance) {
+                    pairs.push({
+                        label: '',
+                        value: `Balance ${item.balance.currency}${item.balance.amount.toFixed(2)}`,
+                    });
+                }
+                return pairs;
+            }
+            if (item.balance) {
+                return [
+                    {
+                        label: quotaDisplayLabel(item),
+                        value: `Balance ${item.balance.currency}${item.balance.amount.toFixed(2)}`,
+                    },
+                ];
+            }
+            const percent = item.remainingPercent === undefined
+                ? '-'
+                : `${item.remainingPercent.toFixed(1)}%`;
+            const reset = compactReset(item.resetAt);
+            return [
+                {
+                    label: quotaDisplayLabel(item),
+                    value: `Remaining ${percent}${reset ? ` Rst ${reset}` : ''}`,
+                },
+            ];
+        }
+        if (item.status === 'unsupported') {
+            return [{ label: quotaDisplayLabel(item), value: 'unsupported' }];
+        }
+        if (item.status === 'unavailable') {
+            return [{ label: quotaDisplayLabel(item), value: 'unavailable' }];
+        }
+        return [{ label: quotaDisplayLabel(item), value: 'Remaining ?' }];
+    });
+    if (quotaPairs.length > 0) {
+        lines.push('');
+        lines.push(fitLine('Quota', width));
+        lines.push(...alignPairs(quotaPairs).map((line) => fitLine(line, width)));
+    }
+    return lines.join('\n');
+}

package/dist/helpers.d.ts

@@ -0,0 +1,14 @@
+/** Shared type guards, utilities, and debug logging. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function asNumber(value: unknown, fallback: number): number;
+export declare function asNumber(value: unknown): number | undefined;
+export declare function asBoolean(value: unknown, fallback: boolean): boolean;
+export declare function debug(message: string, ...args: unknown[]): void;
+export declare function debugError(context: string, error: unknown): void;
+/** Returns a `.catch()` handler that logs in debug mode and returns undefined. */
+export declare function swallow(context: string): (error: unknown) => undefined;
+/**
+ * Run up to `limit` async tasks concurrently from `items`.
+ * Returns results in original order.
+ */
+export declare function mapConcurrent<T, R>(items: T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/dist/helpers.js

@@ -0,0 +1,50 @@
+/** Shared type guards, utilities, and debug logging. */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function asNumber(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    return value;
+}
+export function asBoolean(value, fallback) {
+    if (typeof value !== 'boolean')
+        return fallback;
+    return value;
+}
+const DEBUG = typeof process !== 'undefined' && process.env.OPENCODE_QUOTA_DEBUG === '1';
+export function debug(message, ...args) {
+    if (!DEBUG)
+        return;
+    console.error(`[quota-sidebar] ${message}`, ...args);
+}
+export function debugError(context, error) {
+    if (!DEBUG)
+        return;
+    const msg = error instanceof Error ? error.message : String(error);
+    console.error(`[quota-sidebar] ${context}: ${msg}`);
+}
+/** Returns a `.catch()` handler that logs in debug mode and returns undefined. */
+export function swallow(context) {
+    return (error) => {
+        debugError(context, error);
+        return undefined;
+    };
+}
+/**
+ * Run up to `limit` async tasks concurrently from `items`.
+ * Returns results in original order.
+ */
+export async function mapConcurrent(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    async function worker() {
+        while (next < items.length) {
+            const idx = next++;
+            results[idx] = await fn(items[idx], idx);
+        }
+    }
+    const workers = Array.from({ length: Math.min(limit, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { type Hooks, type PluginInput } from '@opencode-ai/plugin';
+export declare function QuotaSidebarPlugin(input: PluginInput): Promise<Hooks>;
+export default QuotaSidebarPlugin;
+export type { QuotaSidebarConfig, QuotaSidebarState, QuotaSnapshot, QuotaStatus, SessionState, CachedSessionUsage, CachedProviderUsage, IncrementalCursor, } from './types.js';
+export type { UsageSummary } from './usage.js';