@ashx-j/lunr 0.1.0

package/dist/core/usage-history.d.ts

@@ -0,0 +1,63 @@
+/**
+ * lunr: 30-day token usage history for the /usage command.
+ *
+ * Scans the on-disk session files (`.jsonl` under `getSessionsDir()`, both the
+ * flat and the per-project-subdirectory layouts) and aggregates:
+ * - REAL token totals per provider/model from assistant-message `usage`
+ *   metadata (same fields the live session rows use),
+ * - per-day totals (YYYY-MM-DD buckets from the entry timestamp),
+ * - an ESTIMATED category breakdown (chars/4) via the same accounting as
+ *   `computeContextBreakdown` — session files don't store the system prompt or
+ *   tool definitions, so `includesSystemPrompt` is always false and the
+ *   message categories carry the whole breakdown.
+ *
+ * Results are cached per file keyed on mtime+size; unchanged files are not
+ * re-parsed. Never throws — corrupt files are skipped, total failure returns
+ * an empty aggregate.
+ */
+export interface UsageHistoryModelRow {
+    model: string;
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    total: number;
+}
+export interface UsageHistoryDayRow {
+    /** YYYY-MM-DD (UTC). */
+    day: string;
+    total: number;
+}
+export interface UsageHistoryCategories {
+    user: number;
+    assistantText: number;
+    thinking: number;
+    toolCalls: number;
+    toolResults: number;
+    summaries: number;
+    total: number;
+}
+export interface UsageHistory {
+    perModel: UsageHistoryModelRow[];
+    perDay: UsageHistoryDayRow[];
+    categories: UsageHistoryCategories;
+    /** False: session files don't store the system prompt / tool definitions. */
+    includesSystemPrompt: boolean;
+    /** Session files inside the scan window (mtime ≥ sinceMs). */
+    filesScanned: number;
+    /** Files actually parsed this call (cache misses). Also serves as a test hook. */
+    filesParsed: number;
+    /** Scanned files containing at least one assistant message with usage. */
+    sessionsWithUsage: number;
+}
+/** Test hook: drop all cached per-file aggregates. */
+export declare function resetUsageHistoryCache(): void;
+/**
+ * Aggregate token usage across all session files modified since `sinceMs`.
+ * Never throws; on total failure returns an empty aggregate.
+ */
+export declare function collectUsageHistory(options: {
+    sinceMs: number;
+    sessionsDir?: string;
+}): UsageHistory;
+//# sourceMappingURL=usage-history.d.ts.map

package/dist/core/usage-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-history.d.ts","sourceRoot":"","sources":["../../src/core/usage-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAcH,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IAClC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,UAAU,EAAE,sBAAsB,CAAC;IACnC,6EAA6E;IAC7E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gEAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAaD,sDAAsD;AACtD,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAoID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CA2EpG","sourcesContent":["/**\n * lunr: 30-day token usage history for the /usage command.\n *\n * Scans the on-disk session files (`.jsonl` under `getSessionsDir()`, both the\n * flat and the per-project-subdirectory layouts) and aggregates:\n * - REAL token totals per provider/model from assistant-message `usage`\n *   metadata (same fields the live session rows use),\n * - per-day totals (YYYY-MM-DD buckets from the entry timestamp),\n * - an ESTIMATED category breakdown (chars/4) via the same accounting as\n *   `computeContextBreakdown` — session files don't store the system prompt or\n *   tool definitions, so `includesSystemPrompt` is always false and the\n *   message categories carry the whole breakdown.\n *\n * Results are cached per file keyed on mtime+size; unchanged files are not\n * re-parsed. Never throws — corrupt files are skipped, total failure returns\n * an empty aggregate.\n */\n\nimport { type Dirent, readdirSync, type Stats, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AssistantMessage } from \"@earendil-works/pi-ai/compat\";\nimport { getSessionsDir } from \"../config.ts\";\nimport { computeContextBreakdown } from \"./context-breakdown.ts\";\nimport {\n\ttype FileEntry,\n\tloadEntriesFromFile,\n\ttype SessionEntry,\n\tsessionEntryToContextMessages,\n} from \"./session-manager.ts\";\n\nexport interface UsageHistoryModelRow {\n\tmodel: string;\n\tinput: number;\n\toutput: number;\n\tcacheRead: number;\n\tcacheWrite: number;\n\ttotal: number;\n}\n\nexport interface UsageHistoryDayRow {\n\t/** YYYY-MM-DD (UTC). */\n\tday: string;\n\ttotal: number;\n}\n\nexport interface UsageHistoryCategories {\n\tuser: number;\n\tassistantText: number;\n\tthinking: number;\n\ttoolCalls: number;\n\ttoolResults: number;\n\tsummaries: number;\n\ttotal: number;\n}\n\nexport interface UsageHistory {\n\tperModel: UsageHistoryModelRow[];\n\tperDay: UsageHistoryDayRow[];\n\tcategories: UsageHistoryCategories;\n\t/** False: session files don't store the system prompt / tool definitions. */\n\tincludesSystemPrompt: boolean;\n\t/** Session files inside the scan window (mtime ≥ sinceMs). */\n\tfilesScanned: number;\n\t/** Files actually parsed this call (cache misses). Also serves as a test hook. */\n\tfilesParsed: number;\n\t/** Scanned files containing at least one assistant message with usage. */\n\tsessionsWithUsage: number;\n}\n\ninterface FileAggregate {\n\tmtimeMs: number;\n\tsize: number;\n\tperModel: Map<string, UsageHistoryModelRow>;\n\tperDay: Map<string, number>;\n\tcategories: UsageHistoryCategories;\n\thasUsage: boolean;\n}\n\nconst fileCache = new Map<string, FileAggregate>();\n\n/** Test hook: drop all cached per-file aggregates. */\nexport function resetUsageHistoryCache(): void {\n\tfileCache.clear();\n}\n\nfunction emptyCategories(): UsageHistoryCategories {\n\treturn { user: 0, assistantText: 0, thinking: 0, toolCalls: 0, toolResults: 0, summaries: 0, total: 0 };\n}\n\nfunction emptyHistory(): UsageHistory {\n\treturn {\n\t\tperModel: [],\n\t\tperDay: [],\n\t\tcategories: emptyCategories(),\n\t\tincludesSystemPrompt: false,\n\t\tfilesScanned: 0,\n\t\tfilesParsed: 0,\n\t\tsessionsWithUsage: 0,\n\t};\n}\n\n/** Enumerate `.jsonl` session files in both layouts: flat and per-project subdirectories. */\nfunction enumerateSessionFiles(sessionsDir: string): string[] {\n\tconst files: string[] = [];\n\tlet dirEntries: Dirent[];\n\ttry {\n\t\tdirEntries = readdirSync(sessionsDir, { withFileTypes: true });\n\t} catch {\n\t\treturn files;\n\t}\n\tfor (const entry of dirEntries) {\n\t\tif (entry.isFile() && entry.name.endsWith(\".jsonl\")) {\n\t\t\tfiles.push(join(sessionsDir, entry.name));\n\t\t} else if (entry.isDirectory()) {\n\t\t\ttry {\n\t\t\t\tconst subDir = join(sessionsDir, entry.name);\n\t\t\t\tfor (const name of readdirSync(subDir)) {\n\t\t\t\t\tif (name.endsWith(\".jsonl\")) files.push(join(subDir, name));\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Unreadable subdirectory — skip.\n\t\t\t}\n\t\t}\n\t}\n\treturn files;\n}\n\n/** Milliseconds for day bucketing: entry timestamp, then message timestamp, then file mtime. */\nfunction entryTimestampMs(entry: SessionEntry, message: AssistantMessage, fallbackMs: number): number {\n\tconst entryMs = Date.parse(entry.timestamp ?? \"\");\n\tif (!Number.isNaN(entryMs)) return entryMs;\n\tif (typeof message.timestamp === \"number\" && message.timestamp > 0) return message.timestamp;\n\treturn fallbackMs;\n}\n\n/** Parse one session file into its aggregate. Returns null when the file is unusable. */\nfunction parseSessionFile(filePath: string, mtimeMs: number, size: number): FileAggregate | null {\n\tlet entries: FileEntry[];\n\ttry {\n\t\tentries = loadEntriesFromFile(filePath);\n\t} catch {\n\t\treturn null;\n\t}\n\tif (entries.length === 0) return null;\n\n\tconst aggregate: FileAggregate = {\n\t\tmtimeMs,\n\t\tsize,\n\t\tperModel: new Map(),\n\t\tperDay: new Map(),\n\t\tcategories: emptyCategories(),\n\t\thasUsage: false,\n\t};\n\n\tconst sessionEntries: SessionEntry[] = [];\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") continue; // header\n\t\tsessionEntries.push(entry);\n\n\t\tif (entry.type !== \"message\" || entry.message.role !== \"assistant\") continue;\n\t\tconst message = entry.message as AssistantMessage;\n\t\tconst usage = message.usage;\n\t\tif (!usage || typeof usage.input !== \"number\" || typeof usage.output !== \"number\") continue;\n\n\t\tconst provider = typeof message.provider === \"string\" && message.provider ? message.provider : \"unknown\";\n\t\tconst modelId = message.responseModel ?? message.model;\n\t\tconst key = `${provider}/${typeof modelId === \"string\" && modelId ? modelId : \"unknown\"}`;\n\t\tconst input = usage.input;\n\t\tconst output = usage.output;\n\t\tconst cacheRead = typeof usage.cacheRead === \"number\" ? usage.cacheRead : 0;\n\t\tconst cacheWrite = typeof usage.cacheWrite === \"number\" ? usage.cacheWrite : 0;\n\n\t\tlet row = aggregate.perModel.get(key);\n\t\tif (!row) {\n\t\t\trow = { model: key, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 };\n\t\t\taggregate.perModel.set(key, row);\n\t\t}\n\t\trow.input += input;\n\t\trow.output += output;\n\t\trow.cacheRead += cacheRead;\n\t\trow.cacheWrite += cacheWrite;\n\t\trow.total += input + output + cacheRead + cacheWrite;\n\t\taggregate.hasUsage = true;\n\n\t\tconst day = new Date(entryTimestampMs(entry, message, mtimeMs)).toISOString().slice(0, 10);\n\t\taggregate.perDay.set(day, (aggregate.perDay.get(day) ?? 0) + input + output + cacheRead + cacheWrite);\n\t}\n\n\t// Category estimate over the file's messages (system prompt/tools are not\n\t// stored in session files, so message categories carry the breakdown).\n\ttry {\n\t\tconst messages = sessionEntries.flatMap(sessionEntryToContextMessages);\n\t\tconst breakdown = computeContextBreakdown({ systemPrompt: \"\", tools: [], messages, contextWindow: 0 });\n\t\taggregate.categories = {\n\t\t\tuser: breakdown.user,\n\t\t\tassistantText: breakdown.assistantText,\n\t\t\tthinking: breakdown.thinking,\n\t\t\ttoolCalls: breakdown.toolCalls,\n\t\t\ttoolResults: breakdown.toolResults,\n\t\t\tsummaries: breakdown.summaries,\n\t\t\ttotal:\n\t\t\t\tbreakdown.user +\n\t\t\t\tbreakdown.assistantText +\n\t\t\t\tbreakdown.thinking +\n\t\t\t\tbreakdown.toolCalls +\n\t\t\t\tbreakdown.toolResults +\n\t\t\t\tbreakdown.summaries,\n\t\t};\n\t} catch {\n\t\t// Category estimation is best-effort; per-model/day totals above still stand.\n\t}\n\n\treturn aggregate;\n}\n\n/**\n * Aggregate token usage across all session files modified since `sinceMs`.\n * Never throws; on total failure returns an empty aggregate.\n */\nexport function collectUsageHistory(options: { sinceMs: number; sessionsDir?: string }): UsageHistory {\n\tconst result = emptyHistory();\n\ttry {\n\t\tconst sessionsDir = options.sessionsDir ?? getSessionsDir();\n\t\tconst files = enumerateSessionFiles(sessionsDir);\n\t\tconst seen = new Set<string>();\n\n\t\tfor (const filePath of files) {\n\t\t\tseen.add(filePath);\n\t\t\tlet stats: Stats;\n\t\t\ttry {\n\t\t\t\tstats = statSync(filePath);\n\t\t\t} catch {\n\t\t\t\tcontinue; // vanished between readdir and stat\n\t\t\t}\n\t\t\tif (stats.mtimeMs < options.sinceMs) continue;\n\t\t\tresult.filesScanned++;\n\n\t\t\tlet aggregate = fileCache.get(filePath);\n\t\t\tif (!aggregate || aggregate.mtimeMs !== stats.mtimeMs || aggregate.size !== stats.size) {\n\t\t\t\taggregate = parseSessionFile(filePath, stats.mtimeMs, stats.size) ?? undefined;\n\t\t\t\tresult.filesParsed++;\n\t\t\t\tif (aggregate) {\n\t\t\t\t\tfileCache.set(filePath, aggregate);\n\t\t\t\t} else {\n\t\t\t\t\tfileCache.delete(filePath);\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (!aggregate) continue;\n\n\t\t\tif (aggregate.hasUsage) result.sessionsWithUsage++;\n\t\t\tfor (const row of aggregate.perModel.values()) {\n\t\t\t\tlet target = result.perModel.find((r) => r.model === row.model);\n\t\t\t\tif (!target) {\n\t\t\t\t\ttarget = { model: row.model, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 };\n\t\t\t\t\tresult.perModel.push(target);\n\t\t\t\t}\n\t\t\t\ttarget.input += row.input;\n\t\t\t\ttarget.output += row.output;\n\t\t\t\ttarget.cacheRead += row.cacheRead;\n\t\t\t\ttarget.cacheWrite += row.cacheWrite;\n\t\t\t\ttarget.total += row.total;\n\t\t\t}\n\t\t\tfor (const [day, total] of aggregate.perDay) {\n\t\t\t\tconst existing = result.perDay.find((r) => r.day === day);\n\t\t\t\tif (existing) {\n\t\t\t\t\texisting.total += total;\n\t\t\t\t} else {\n\t\t\t\t\tresult.perDay.push({ day, total });\n\t\t\t\t}\n\t\t\t}\n\t\t\tfor (const key of [\n\t\t\t\t\"user\",\n\t\t\t\t\"assistantText\",\n\t\t\t\t\"thinking\",\n\t\t\t\t\"toolCalls\",\n\t\t\t\t\"toolResults\",\n\t\t\t\t\"summaries\",\n\t\t\t\t\"total\",\n\t\t\t] as const) {\n\t\t\t\tresult.categories[key] += aggregate.categories[key];\n\t\t\t}\n\t\t}\n\n\t\t// Drop cache entries for deleted files.\n\t\tfor (const cachedPath of fileCache.keys()) {\n\t\t\tif (!seen.has(cachedPath)) fileCache.delete(cachedPath);\n\t\t}\n\n\t\tresult.perModel.sort((a, b) => b.total - a.total);\n\t\tresult.perDay.sort((a, b) => a.day.localeCompare(b.day));\n\t} catch {\n\t\treturn emptyHistory();\n\t}\n\treturn result;\n}\n"]}

package/dist/core/usage-history.js

@@ -0,0 +1,239 @@
+/**
+ * lunr: 30-day token usage history for the /usage command.
+ *
+ * Scans the on-disk session files (`.jsonl` under `getSessionsDir()`, both the
+ * flat and the per-project-subdirectory layouts) and aggregates:
+ * - REAL token totals per provider/model from assistant-message `usage`
+ *   metadata (same fields the live session rows use),
+ * - per-day totals (YYYY-MM-DD buckets from the entry timestamp),
+ * - an ESTIMATED category breakdown (chars/4) via the same accounting as
+ *   `computeContextBreakdown` — session files don't store the system prompt or
+ *   tool definitions, so `includesSystemPrompt` is always false and the
+ *   message categories carry the whole breakdown.
+ *
+ * Results are cached per file keyed on mtime+size; unchanged files are not
+ * re-parsed. Never throws — corrupt files are skipped, total failure returns
+ * an empty aggregate.
+ */
+import { readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { getSessionsDir } from "../config.js";
+import { computeContextBreakdown } from "./context-breakdown.js";
+import { loadEntriesFromFile, sessionEntryToContextMessages, } from "./session-manager.js";
+const fileCache = new Map();
+/** Test hook: drop all cached per-file aggregates. */
+export function resetUsageHistoryCache() {
+    fileCache.clear();
+}
+function emptyCategories() {
+    return { user: 0, assistantText: 0, thinking: 0, toolCalls: 0, toolResults: 0, summaries: 0, total: 0 };
+}
+function emptyHistory() {
+    return {
+        perModel: [],
+        perDay: [],
+        categories: emptyCategories(),
+        includesSystemPrompt: false,
+        filesScanned: 0,
+        filesParsed: 0,
+        sessionsWithUsage: 0,
+    };
+}
+/** Enumerate `.jsonl` session files in both layouts: flat and per-project subdirectories. */
+function enumerateSessionFiles(sessionsDir) {
+    const files = [];
+    let dirEntries;
+    try {
+        dirEntries = readdirSync(sessionsDir, { withFileTypes: true });
+    }
+    catch {
+        return files;
+    }
+    for (const entry of dirEntries) {
+        if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+            files.push(join(sessionsDir, entry.name));
+        }
+        else if (entry.isDirectory()) {
+            try {
+                const subDir = join(sessionsDir, entry.name);
+                for (const name of readdirSync(subDir)) {
+                    if (name.endsWith(".jsonl"))
+                        files.push(join(subDir, name));
+                }
+            }
+            catch {
+                // Unreadable subdirectory — skip.
+            }
+        }
+    }
+    return files;
+}
+/** Milliseconds for day bucketing: entry timestamp, then message timestamp, then file mtime. */
+function entryTimestampMs(entry, message, fallbackMs) {
+    const entryMs = Date.parse(entry.timestamp ?? "");
+    if (!Number.isNaN(entryMs))
+        return entryMs;
+    if (typeof message.timestamp === "number" && message.timestamp > 0)
+        return message.timestamp;
+    return fallbackMs;
+}
+/** Parse one session file into its aggregate. Returns null when the file is unusable. */
+function parseSessionFile(filePath, mtimeMs, size) {
+    let entries;
+    try {
+        entries = loadEntriesFromFile(filePath);
+    }
+    catch {
+        return null;
+    }
+    if (entries.length === 0)
+        return null;
+    const aggregate = {
+        mtimeMs,
+        size,
+        perModel: new Map(),
+        perDay: new Map(),
+        categories: emptyCategories(),
+        hasUsage: false,
+    };
+    const sessionEntries = [];
+    for (const entry of entries) {
+        if (entry.type === "session")
+            continue; // header
+        sessionEntries.push(entry);
+        if (entry.type !== "message" || entry.message.role !== "assistant")
+            continue;
+        const message = entry.message;
+        const usage = message.usage;
+        if (!usage || typeof usage.input !== "number" || typeof usage.output !== "number")
+            continue;
+        const provider = typeof message.provider === "string" && message.provider ? message.provider : "unknown";
+        const modelId = message.responseModel ?? message.model;
+        const key = `${provider}/${typeof modelId === "string" && modelId ? modelId : "unknown"}`;
+        const input = usage.input;
+        const output = usage.output;
+        const cacheRead = typeof usage.cacheRead === "number" ? usage.cacheRead : 0;
+        const cacheWrite = typeof usage.cacheWrite === "number" ? usage.cacheWrite : 0;
+        let row = aggregate.perModel.get(key);
+        if (!row) {
+            row = { model: key, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 };
+            aggregate.perModel.set(key, row);
+        }
+        row.input += input;
+        row.output += output;
+        row.cacheRead += cacheRead;
+        row.cacheWrite += cacheWrite;
+        row.total += input + output + cacheRead + cacheWrite;
+        aggregate.hasUsage = true;
+        const day = new Date(entryTimestampMs(entry, message, mtimeMs)).toISOString().slice(0, 10);
+        aggregate.perDay.set(day, (aggregate.perDay.get(day) ?? 0) + input + output + cacheRead + cacheWrite);
+    }
+    // Category estimate over the file's messages (system prompt/tools are not
+    // stored in session files, so message categories carry the breakdown).
+    try {
+        const messages = sessionEntries.flatMap(sessionEntryToContextMessages);
+        const breakdown = computeContextBreakdown({ systemPrompt: "", tools: [], messages, contextWindow: 0 });
+        aggregate.categories = {
+            user: breakdown.user,
+            assistantText: breakdown.assistantText,
+            thinking: breakdown.thinking,
+            toolCalls: breakdown.toolCalls,
+            toolResults: breakdown.toolResults,
+            summaries: breakdown.summaries,
+            total: breakdown.user +
+                breakdown.assistantText +
+                breakdown.thinking +
+                breakdown.toolCalls +
+                breakdown.toolResults +
+                breakdown.summaries,
+        };
+    }
+    catch {
+        // Category estimation is best-effort; per-model/day totals above still stand.
+    }
+    return aggregate;
+}
+/**
+ * Aggregate token usage across all session files modified since `sinceMs`.
+ * Never throws; on total failure returns an empty aggregate.
+ */
+export function collectUsageHistory(options) {
+    const result = emptyHistory();
+    try {
+        const sessionsDir = options.sessionsDir ?? getSessionsDir();
+        const files = enumerateSessionFiles(sessionsDir);
+        const seen = new Set();
+        for (const filePath of files) {
+            seen.add(filePath);
+            let stats;
+            try {
+                stats = statSync(filePath);
+            }
+            catch {
+                continue; // vanished between readdir and stat
+            }
+            if (stats.mtimeMs < options.sinceMs)
+                continue;
+            result.filesScanned++;
+            let aggregate = fileCache.get(filePath);
+            if (!aggregate || aggregate.mtimeMs !== stats.mtimeMs || aggregate.size !== stats.size) {
+                aggregate = parseSessionFile(filePath, stats.mtimeMs, stats.size) ?? undefined;
+                result.filesParsed++;
+                if (aggregate) {
+                    fileCache.set(filePath, aggregate);
+                }
+                else {
+                    fileCache.delete(filePath);
+                }
+            }
+            if (!aggregate)
+                continue;
+            if (aggregate.hasUsage)
+                result.sessionsWithUsage++;
+            for (const row of aggregate.perModel.values()) {
+                let target = result.perModel.find((r) => r.model === row.model);
+                if (!target) {
+                    target = { model: row.model, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 };
+                    result.perModel.push(target);
+                }
+                target.input += row.input;
+                target.output += row.output;
+                target.cacheRead += row.cacheRead;
+                target.cacheWrite += row.cacheWrite;
+                target.total += row.total;
+            }
+            for (const [day, total] of aggregate.perDay) {
+                const existing = result.perDay.find((r) => r.day === day);
+                if (existing) {
+                    existing.total += total;
+                }
+                else {
+                    result.perDay.push({ day, total });
+                }
+            }
+            for (const key of [
+                "user",
+                "assistantText",
+                "thinking",
+                "toolCalls",
+                "toolResults",
+                "summaries",
+                "total",
+            ]) {
+                result.categories[key] += aggregate.categories[key];
+            }
+        }
+        // Drop cache entries for deleted files.
+        for (const cachedPath of fileCache.keys()) {
+            if (!seen.has(cachedPath))
+                fileCache.delete(cachedPath);
+        }
+        result.perModel.sort((a, b) => b.total - a.total);
+        result.perDay.sort((a, b) => a.day.localeCompare(b.day));
+    }
+    catch {
+        return emptyHistory();
+    }
+    return result;
+}
+//# sourceMappingURL=usage-history.js.map

package/dist/core/usage-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-history.js","sourceRoot":"","sources":["../../src/core/usage-history.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * lunr: 30-day token usage history for the /usage command.\n *\n * Scans the on-disk session files (`.jsonl` under `getSessionsDir()`, both the\n * flat and the per-project-subdirectory layouts) and aggregates:\n * - REAL token totals per provider/model from assistant-message `usage`\n *   metadata (same fields the live session rows use),\n * - per-day totals (YYYY-MM-DD buckets from the entry timestamp),\n * - an ESTIMATED category breakdown (chars/4) via the same accounting as\n *   `computeContextBreakdown` — session files don't store the system prompt or\n *   tool definitions, so `includesSystemPrompt` is always false and the\n *   message categories carry the whole breakdown.\n *\n * Results are cached per file keyed on mtime+size; unchanged files are not\n * re-parsed. Never throws — corrupt files are skipped, total failure returns\n * an empty aggregate.\n */\n\nimport { type Dirent, readdirSync, type Stats, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AssistantMessage } from \"@earendil-works/pi-ai/compat\";\nimport { getSessionsDir } from \"../config.ts\";\nimport { computeContextBreakdown } from \"./context-breakdown.ts\";\nimport {\n\ttype FileEntry,\n\tloadEntriesFromFile,\n\ttype SessionEntry,\n\tsessionEntryToContextMessages,\n} from \"./session-manager.ts\";\n\nexport interface UsageHistoryModelRow {\n\tmodel: string;\n\tinput: number;\n\toutput: number;\n\tcacheRead: number;\n\tcacheWrite: number;\n\ttotal: number;\n}\n\nexport interface UsageHistoryDayRow {\n\t/** YYYY-MM-DD (UTC). */\n\tday: string;\n\ttotal: number;\n}\n\nexport interface UsageHistoryCategories {\n\tuser: number;\n\tassistantText: number;\n\tthinking: number;\n\ttoolCalls: number;\n\ttoolResults: number;\n\tsummaries: number;\n\ttotal: number;\n}\n\nexport interface UsageHistory {\n\tperModel: UsageHistoryModelRow[];\n\tperDay: UsageHistoryDayRow[];\n\tcategories: UsageHistoryCategories;\n\t/** False: session files don't store the system prompt / tool definitions. */\n\tincludesSystemPrompt: boolean;\n\t/** Session files inside the scan window (mtime ≥ sinceMs). */\n\tfilesScanned: number;\n\t/** Files actually parsed this call (cache misses). Also serves as a test hook. */\n\tfilesParsed: number;\n\t/** Scanned files containing at least one assistant message with usage. */\n\tsessionsWithUsage: number;\n}\n\ninterface FileAggregate {\n\tmtimeMs: number;\n\tsize: number;\n\tperModel: Map<string, UsageHistoryModelRow>;\n\tperDay: Map<string, number>;\n\tcategories: UsageHistoryCategories;\n\thasUsage: boolean;\n}\n\nconst fileCache = new Map<string, FileAggregate>();\n\n/** Test hook: drop all cached per-file aggregates. */\nexport function resetUsageHistoryCache(): void {\n\tfileCache.clear();\n}\n\nfunction emptyCategories(): UsageHistoryCategories {\n\treturn { user: 0, assistantText: 0, thinking: 0, toolCalls: 0, toolResults: 0, summaries: 0, total: 0 };\n}\n\nfunction emptyHistory(): UsageHistory {\n\treturn {\n\t\tperModel: [],\n\t\tperDay: [],\n\t\tcategories: emptyCategories(),\n\t\tincludesSystemPrompt: false,\n\t\tfilesScanned: 0,\n\t\tfilesParsed: 0,\n\t\tsessionsWithUsage: 0,\n\t};\n}\n\n/** Enumerate `.jsonl` session files in both layouts: flat and per-project subdirectories. */\nfunction enumerateSessionFiles(sessionsDir: string): string[] {\n\tconst files: string[] = [];\n\tlet dirEntries: Dirent[];\n\ttry {\n\t\tdirEntries = readdirSync(sessionsDir, { withFileTypes: true });\n\t} catch {\n\t\treturn files;\n\t}\n\tfor (const entry of dirEntries) {\n\t\tif (entry.isFile() && entry.name.endsWith(\".jsonl\")) {\n\t\t\tfiles.push(join(sessionsDir, entry.name));\n\t\t} else if (entry.isDirectory()) {\n\t\t\ttry {\n\t\t\t\tconst subDir = join(sessionsDir, entry.name);\n\t\t\t\tfor (const name of readdirSync(subDir)) {\n\t\t\t\t\tif (name.endsWith(\".jsonl\")) files.push(join(subDir, name));\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Unreadable subdirectory — skip.\n\t\t\t}\n\t\t}\n\t}\n\treturn files;\n}\n\n/** Milliseconds for day bucketing: entry timestamp, then message timestamp, then file mtime. */\nfunction entryTimestampMs(entry: SessionEntry, message: AssistantMessage, fallbackMs: number): number {\n\tconst entryMs = Date.parse(entry.timestamp ?? \"\");\n\tif (!Number.isNaN(entryMs)) return entryMs;\n\tif (typeof message.timestamp === \"number\" && message.timestamp > 0) return message.timestamp;\n\treturn fallbackMs;\n}\n\n/** Parse one session file into its aggregate. Returns null when the file is unusable. */\nfunction parseSessionFile(filePath: string, mtimeMs: number, size: number): FileAggregate | null {\n\tlet entries: FileEntry[];\n\ttry {\n\t\tentries = loadEntriesFromFile(filePath);\n\t} catch {\n\t\treturn null;\n\t}\n\tif (entries.length === 0) return null;\n\n\tconst aggregate: FileAggregate = {\n\t\tmtimeMs,\n\t\tsize,\n\t\tperModel: new Map(),\n\t\tperDay: new Map(),\n\t\tcategories: emptyCategories(),\n\t\thasUsage: false,\n\t};\n\n\tconst sessionEntries: SessionEntry[] = [];\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") continue; // header\n\t\tsessionEntries.push(entry);\n\n\t\tif (entry.type !== \"message\" || entry.message.role !== \"assistant\") continue;\n\t\tconst message = entry.message as AssistantMessage;\n\t\tconst usage = message.usage;\n\t\tif (!usage || typeof usage.input !== \"number\" || typeof usage.output !== \"number\") continue;\n\n\t\tconst provider = typeof message.provider === \"string\" && message.provider ? message.provider : \"unknown\";\n\t\tconst modelId = message.responseModel ?? message.model;\n\t\tconst key = `${provider}/${typeof modelId === \"string\" && modelId ? modelId : \"unknown\"}`;\n\t\tconst input = usage.input;\n\t\tconst output = usage.output;\n\t\tconst cacheRead = typeof usage.cacheRead === \"number\" ? usage.cacheRead : 0;\n\t\tconst cacheWrite = typeof usage.cacheWrite === \"number\" ? usage.cacheWrite : 0;\n\n\t\tlet row = aggregate.perModel.get(key);\n\t\tif (!row) {\n\t\t\trow = { model: key, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 };\n\t\t\taggregate.perModel.set(key, row);\n\t\t}\n\t\trow.input += input;\n\t\trow.output += output;\n\t\trow.cacheRead += cacheRead;\n\t\trow.cacheWrite += cacheWrite;\n\t\trow.total += input + output + cacheRead + cacheWrite;\n\t\taggregate.hasUsage = true;\n\n\t\tconst day = new Date(entryTimestampMs(entry, message, mtimeMs)).toISOString().slice(0, 10);\n\t\taggregate.perDay.set(day, (aggregate.perDay.get(day) ?? 0) + input + output + cacheRead + cacheWrite);\n\t}\n\n\t// Category estimate over the file's messages (system prompt/tools are not\n\t// stored in session files, so message categories carry the breakdown).\n\ttry {\n\t\tconst messages = sessionEntries.flatMap(sessionEntryToContextMessages);\n\t\tconst breakdown = computeContextBreakdown({ systemPrompt: \"\", tools: [], messages, contextWindow: 0 });\n\t\taggregate.categories = {\n\t\t\tuser: breakdown.user,\n\t\t\tassistantText: breakdown.assistantText,\n\t\t\tthinking: breakdown.thinking,\n\t\t\ttoolCalls: breakdown.toolCalls,\n\t\t\ttoolResults: breakdown.toolResults,\n\t\t\tsummaries: breakdown.summaries,\n\t\t\ttotal:\n\t\t\t\tbreakdown.user +\n\t\t\t\tbreakdown.assistantText +\n\t\t\t\tbreakdown.thinking +\n\t\t\t\tbreakdown.toolCalls +\n\t\t\t\tbreakdown.toolResults +\n\t\t\t\tbreakdown.summaries,\n\t\t};\n\t} catch {\n\t\t// Category estimation is best-effort; per-model/day totals above still stand.\n\t}\n\n\treturn aggregate;\n}\n\n/**\n * Aggregate token usage across all session files modified since `sinceMs`.\n * Never throws; on total failure returns an empty aggregate.\n */\nexport function collectUsageHistory(options: { sinceMs: number; sessionsDir?: string }): UsageHistory {\n\tconst result = emptyHistory();\n\ttry {\n\t\tconst sessionsDir = options.sessionsDir ?? getSessionsDir();\n\t\tconst files = enumerateSessionFiles(sessionsDir);\n\t\tconst seen = new Set<string>();\n\n\t\tfor (const filePath of files) {\n\t\t\tseen.add(filePath);\n\t\t\tlet stats: Stats;\n\t\t\ttry {\n\t\t\t\tstats = statSync(filePath);\n\t\t\t} catch {\n\t\t\t\tcontinue; // vanished between readdir and stat\n\t\t\t}\n\t\t\tif (stats.mtimeMs < options.sinceMs) continue;\n\t\t\tresult.filesScanned++;\n\n\t\t\tlet aggregate = fileCache.get(filePath);\n\t\t\tif (!aggregate || aggregate.mtimeMs !== stats.mtimeMs || aggregate.size !== stats.size) {\n\t\t\t\taggregate = parseSessionFile(filePath, stats.mtimeMs, stats.size) ?? undefined;\n\t\t\t\tresult.filesParsed++;\n\t\t\t\tif (aggregate) {\n\t\t\t\t\tfileCache.set(filePath, aggregate);\n\t\t\t\t} else {\n\t\t\t\t\tfileCache.delete(filePath);\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (!aggregate) continue;\n\n\t\t\tif (aggregate.hasUsage) result.sessionsWithUsage++;\n\t\t\tfor (const row of aggregate.perModel.values()) {\n\t\t\t\tlet target = result.perModel.find((r) => r.model === row.model);\n\t\t\t\tif (!target) {\n\t\t\t\t\ttarget = { model: row.model, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 };\n\t\t\t\t\tresult.perModel.push(target);\n\t\t\t\t}\n\t\t\t\ttarget.input += row.input;\n\t\t\t\ttarget.output += row.output;\n\t\t\t\ttarget.cacheRead += row.cacheRead;\n\t\t\t\ttarget.cacheWrite += row.cacheWrite;\n\t\t\t\ttarget.total += row.total;\n\t\t\t}\n\t\t\tfor (const [day, total] of aggregate.perDay) {\n\t\t\t\tconst existing = result.perDay.find((r) => r.day === day);\n\t\t\t\tif (existing) {\n\t\t\t\t\texisting.total += total;\n\t\t\t\t} else {\n\t\t\t\t\tresult.perDay.push({ day, total });\n\t\t\t\t}\n\t\t\t}\n\t\t\tfor (const key of [\n\t\t\t\t\"user\",\n\t\t\t\t\"assistantText\",\n\t\t\t\t\"thinking\",\n\t\t\t\t\"toolCalls\",\n\t\t\t\t\"toolResults\",\n\t\t\t\t\"summaries\",\n\t\t\t\t\"total\",\n\t\t\t] as const) {\n\t\t\t\tresult.categories[key] += aggregate.categories[key];\n\t\t\t}\n\t\t}\n\n\t\t// Drop cache entries for deleted files.\n\t\tfor (const cachedPath of fileCache.keys()) {\n\t\t\tif (!seen.has(cachedPath)) fileCache.delete(cachedPath);\n\t\t}\n\n\t\tresult.perModel.sort((a, b) => b.total - a.total);\n\t\tresult.perDay.sort((a, b) => a.day.localeCompare(b.day));\n\t} catch {\n\t\treturn emptyHistory();\n\t}\n\treturn result;\n}\n"]}

package/dist/core/usage-limit.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Provider error classification for subscription-key rotation.
+ *
+ * lunr: these classify provider free-text error bodies — regex-on-English,
+ * so wording drift across providers (or upstream changes to error text) can
+ * silently reclassify an error. Treat matches as heuristics, not contracts.
+ */
+export declare function isUsageLimitError(errorMessage: string): boolean;
+export declare function isAuthInvalidError(errorMessage: string): boolean;
+/**
+ * Parse a quota-reset time out of an error message: relative forms like
+ * "reset in 2h" / "retry in 30m" / "available in 3600s", or an ISO-8601
+ * timestamp. Returns epoch ms in the future, or undefined when unparseable.
+ * Port of the goal runtime's parseUsageResetTimeMs.
+ */
+export declare function parseResetTimeMs(errorMessage: string): number | undefined;
+//# sourceMappingURL=usage-limit.d.ts.map

package/dist/core/usage-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit.d.ts","sourceRoot":"","sources":["../../src/core/usage-limit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAM/D;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAGhE;AAWD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBzE","sourcesContent":["/**\n * Provider error classification for subscription-key rotation.\n *\n * lunr: these classify provider free-text error bodies — regex-on-English,\n * so wording drift across providers (or upstream changes to error text) can\n * silently reclassify an error. Treat matches as heuristics, not contracts.\n */\n\nconst USAGE_LIMIT_ERROR_PATTERNS = [\n\t// Provider-declared subscription/free-tier limit error types and wording\n\t// (pi-ai NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN spirit).\n\t\"GoUsageLimitError\",\n\t\"FreeUsageLimitError\",\n\t\"Monthly usage limit reached\",\n\t\"available balance\",\n\t\"insufficient_quota\",\n\t\"out of budget\",\n\t\"quota exceeded\",\n\t\"billing\",\n] as const;\n\nconst USAGE_LIMIT_ERROR_REGEXES = [\n\t// Goal runtime USAGE_LIMIT_GOAL_ERROR_PATTERNS: usage caps, quota exhaustion,\n\t// credit/balance exhaustion, payment required.\n\t/usage[_\\s-]*(?:limit|cap)|chatgpt.{0,32}usage/i,\n\t/quota.{0,32}(?:reached|exceeded|exhausted|depleted)|(?:reached|exceeded|exhausted|depleted).{0,32}quota/i,\n\t/insufficient[_\\s-]*(?:quota|credits?)|out of credits|out of budget|available balance|payment required/i,\n\t/(?:credit|balance).{0,32}(?:low|exhausted|depleted)|billing/i,\n] as const;\n\nconst AUTH_INVALID_ERROR_PATTERN =\n\t/\\b401\\b|unauthori[sz]ed|unauthenticated|invalid.{0,16}(?:api.?key|token|credentials?)|authentication.{0,16}failed/i;\n\nexport function isUsageLimitError(errorMessage: string): boolean {\n\tif (!errorMessage) return false;\n\tif (USAGE_LIMIT_ERROR_PATTERNS.some((pattern) => errorMessage.toLowerCase().includes(pattern.toLowerCase()))) {\n\t\treturn true;\n\t}\n\treturn USAGE_LIMIT_ERROR_REGEXES.some((pattern) => pattern.test(errorMessage));\n}\n\nexport function isAuthInvalidError(errorMessage: string): boolean {\n\tif (!errorMessage) return false;\n\treturn AUTH_INVALID_ERROR_PATTERN.test(errorMessage);\n}\n\nconst RESET_TIME_PATTERNS = [\n\t/reset(?:s|ting)?\\s*(?:in|after|at)?\\s*(\\d+)\\s*s(ec)?/i,\n\t/reset(?:s|ting)?\\s*(?:in|after|at)?\\s*(\\d+)\\s*m(in)?/i,\n\t/reset(?:s|ting)?\\s*(?:in|after|at)?\\s*(\\d+)\\s*h(our|r)?/i,\n\t/(?:retry|try(?:\\s+again)?|available)\\s+(?:in|after|at)\\s*(\\d+)\\s*s(ec)?/i,\n\t/(?:retry|try(?:\\s+again)?|available)\\s+(?:in|after|at)\\s*(\\d+)\\s*m(in)?/i,\n\t/(?:retry|try(?:\\s+again)?|available)\\s+(?:in|after|at)\\s*(\\d+)\\s*h(our|r)?/i,\n] as const;\n\n/**\n * Parse a quota-reset time out of an error message: relative forms like\n * \"reset in 2h\" / \"retry in 30m\" / \"available in 3600s\", or an ISO-8601\n * timestamp. Returns epoch ms in the future, or undefined when unparseable.\n * Port of the goal runtime's parseUsageResetTimeMs.\n */\nexport function parseResetTimeMs(errorMessage: string): number | undefined {\n\tif (!errorMessage) return undefined;\n\tconst now = Date.now();\n\tfor (const pattern of RESET_TIME_PATTERNS) {\n\t\tconst match = errorMessage.match(pattern);\n\t\tif (!match) continue;\n\t\tconst value = Number.parseInt(match[1] ?? \"\", 10);\n\t\tif (!Number.isFinite(value) || value <= 0) continue;\n\t\tconst unit = pattern.source.includes(\"\\\\s*h\") ? 3600_000 : pattern.source.includes(\"\\\\s*m\") ? 60_000 : 1_000;\n\t\treturn now + value * unit;\n\t}\n\t// ISO-8601 timestamp fallback (e.g. \"reset at 2026-08-01T09:00:00Z\").\n\tconst isoMatch = errorMessage.match(\n\t\t/(?:reset|available).{0,12}(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?(?:\\.\\d+)?(?:Z|[+-]\\d{2}:?\\d{2})?)/i,\n\t);\n\tif (isoMatch?.[1]) {\n\t\tconst parsed = Date.parse(isoMatch[1]);\n\t\tif (Number.isFinite(parsed) && parsed > now) return parsed;\n\t}\n\treturn undefined;\n}\n"]}

package/dist/core/usage-limit.js

@@ -0,0 +1,79 @@
+/**
+ * Provider error classification for subscription-key rotation.
+ *
+ * lunr: these classify provider free-text error bodies — regex-on-English,
+ * so wording drift across providers (or upstream changes to error text) can
+ * silently reclassify an error. Treat matches as heuristics, not contracts.
+ */
+const USAGE_LIMIT_ERROR_PATTERNS = [
+    // Provider-declared subscription/free-tier limit error types and wording
+    // (pi-ai NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN spirit).
+    "GoUsageLimitError",
+    "FreeUsageLimitError",
+    "Monthly usage limit reached",
+    "available balance",
+    "insufficient_quota",
+    "out of budget",
+    "quota exceeded",
+    "billing",
+];
+const USAGE_LIMIT_ERROR_REGEXES = [
+    // Goal runtime USAGE_LIMIT_GOAL_ERROR_PATTERNS: usage caps, quota exhaustion,
+    // credit/balance exhaustion, payment required.
+    /usage[_\s-]*(?:limit|cap)|chatgpt.{0,32}usage/i,
+    /quota.{0,32}(?:reached|exceeded|exhausted|depleted)|(?:reached|exceeded|exhausted|depleted).{0,32}quota/i,
+    /insufficient[_\s-]*(?:quota|credits?)|out of credits|out of budget|available balance|payment required/i,
+    /(?:credit|balance).{0,32}(?:low|exhausted|depleted)|billing/i,
+];
+const AUTH_INVALID_ERROR_PATTERN = /\b401\b|unauthori[sz]ed|unauthenticated|invalid.{0,16}(?:api.?key|token|credentials?)|authentication.{0,16}failed/i;
+export function isUsageLimitError(errorMessage) {
+    if (!errorMessage)
+        return false;
+    if (USAGE_LIMIT_ERROR_PATTERNS.some((pattern) => errorMessage.toLowerCase().includes(pattern.toLowerCase()))) {
+        return true;
+    }
+    return USAGE_LIMIT_ERROR_REGEXES.some((pattern) => pattern.test(errorMessage));
+}
+export function isAuthInvalidError(errorMessage) {
+    if (!errorMessage)
+        return false;
+    return AUTH_INVALID_ERROR_PATTERN.test(errorMessage);
+}
+const RESET_TIME_PATTERNS = [
+    /reset(?:s|ting)?\s*(?:in|after|at)?\s*(\d+)\s*s(ec)?/i,
+    /reset(?:s|ting)?\s*(?:in|after|at)?\s*(\d+)\s*m(in)?/i,
+    /reset(?:s|ting)?\s*(?:in|after|at)?\s*(\d+)\s*h(our|r)?/i,
+    /(?:retry|try(?:\s+again)?|available)\s+(?:in|after|at)\s*(\d+)\s*s(ec)?/i,
+    /(?:retry|try(?:\s+again)?|available)\s+(?:in|after|at)\s*(\d+)\s*m(in)?/i,
+    /(?:retry|try(?:\s+again)?|available)\s+(?:in|after|at)\s*(\d+)\s*h(our|r)?/i,
+];
+/**
+ * Parse a quota-reset time out of an error message: relative forms like
+ * "reset in 2h" / "retry in 30m" / "available in 3600s", or an ISO-8601
+ * timestamp. Returns epoch ms in the future, or undefined when unparseable.
+ * Port of the goal runtime's parseUsageResetTimeMs.
+ */
+export function parseResetTimeMs(errorMessage) {
+    if (!errorMessage)
+        return undefined;
+    const now = Date.now();
+    for (const pattern of RESET_TIME_PATTERNS) {
+        const match = errorMessage.match(pattern);
+        if (!match)
+            continue;
+        const value = Number.parseInt(match[1] ?? "", 10);
+        if (!Number.isFinite(value) || value <= 0)
+            continue;
+        const unit = pattern.source.includes("\\s*h") ? 3600_000 : pattern.source.includes("\\s*m") ? 60_000 : 1_000;
+        return now + value * unit;
+    }
+    // ISO-8601 timestamp fallback (e.g. "reset at 2026-08-01T09:00:00Z").
+    const isoMatch = errorMessage.match(/(?:reset|available).{0,12}(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?)/i);
+    if (isoMatch?.[1]) {
+        const parsed = Date.parse(isoMatch[1]);
+        if (Number.isFinite(parsed) && parsed > now)
+            return parsed;
+    }
+    return undefined;
+}
+//# sourceMappingURL=usage-limit.js.map

package/dist/core/usage-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit.js","sourceRoot":"","sources":["../../src/core/usage-limit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,0BAA0B,GAAG;IAClC,yEAAyE;IACzE,6DAA6D;IAC7D,mBAAmB;IACnB,qBAAqB;IACrB,6BAA6B;IAC7B,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,gBAAgB;IAChB,SAAS;CACA,CAAC;AAEX,MAAM,yBAAyB,GAAG;IACjC,8EAA8E;IAC9E,+CAA+C;IAC/C,gDAAgD;IAChD,0GAA0G;IAC1G,wGAAwG;IACxG,8DAA8D;CACrD,CAAC;AAEX,MAAM,0BAA0B,GAC/B,oHAAoH,CAAC;AAEtH,MAAM,UAAU,iBAAiB,CAAC,YAAoB,EAAW;IAChE,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9G,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;AAAA,CAC/E;AAED,MAAM,UAAU,kBAAkB,CAAC,YAAoB,EAAW;IACjE,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,0BAA0B,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAAA,CACrD;AAED,MAAM,mBAAmB,GAAG;IAC3B,uDAAuD;IACvD,uDAAuD;IACvD,0DAA0D;IAC1D,0EAA0E;IAC1E,0EAA0E;IAC1E,6EAA6E;CACpE,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB,EAAsB;IAC1E,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7G,OAAO,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC;IAC3B,CAAC;IACD,sEAAsE;IACtE,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAClC,sGAAsG,CACtG,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO,MAAM,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CACjB","sourcesContent":["/**\n * Provider error classification for subscription-key rotation.\n *\n * lunr: these classify provider free-text error bodies — regex-on-English,\n * so wording drift across providers (or upstream changes to error text) can\n * silently reclassify an error. Treat matches as heuristics, not contracts.\n */\n\nconst USAGE_LIMIT_ERROR_PATTERNS = [\n\t// Provider-declared subscription/free-tier limit error types and wording\n\t// (pi-ai NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN spirit).\n\t\"GoUsageLimitError\",\n\t\"FreeUsageLimitError\",\n\t\"Monthly usage limit reached\",\n\t\"available balance\",\n\t\"insufficient_quota\",\n\t\"out of budget\",\n\t\"quota exceeded\",\n\t\"billing\",\n] as const;\n\nconst USAGE_LIMIT_ERROR_REGEXES = [\n\t// Goal runtime USAGE_LIMIT_GOAL_ERROR_PATTERNS: usage caps, quota exhaustion,\n\t// credit/balance exhaustion, payment required.\n\t/usage[_\\s-]*(?:limit|cap)|chatgpt.{0,32}usage/i,\n\t/quota.{0,32}(?:reached|exceeded|exhausted|depleted)|(?:reached|exceeded|exhausted|depleted).{0,32}quota/i,\n\t/insufficient[_\\s-]*(?:quota|credits?)|out of credits|out of budget|available balance|payment required/i,\n\t/(?:credit|balance).{0,32}(?:low|exhausted|depleted)|billing/i,\n] as const;\n\nconst AUTH_INVALID_ERROR_PATTERN =\n\t/\\b401\\b|unauthori[sz]ed|unauthenticated|invalid.{0,16}(?:api.?key|token|credentials?)|authentication.{0,16}failed/i;\n\nexport function isUsageLimitError(errorMessage: string): boolean {\n\tif (!errorMessage) return false;\n\tif (USAGE_LIMIT_ERROR_PATTERNS.some((pattern) => errorMessage.toLowerCase().includes(pattern.toLowerCase()))) {\n\t\treturn true;\n\t}\n\treturn USAGE_LIMIT_ERROR_REGEXES.some((pattern) => pattern.test(errorMessage));\n}\n\nexport function isAuthInvalidError(errorMessage: string): boolean {\n\tif (!errorMessage) return false;\n\treturn AUTH_INVALID_ERROR_PATTERN.test(errorMessage);\n}\n\nconst RESET_TIME_PATTERNS = [\n\t/reset(?:s|ting)?\\s*(?:in|after|at)?\\s*(\\d+)\\s*s(ec)?/i,\n\t/reset(?:s|ting)?\\s*(?:in|after|at)?\\s*(\\d+)\\s*m(in)?/i,\n\t/reset(?:s|ting)?\\s*(?:in|after|at)?\\s*(\\d+)\\s*h(our|r)?/i,\n\t/(?:retry|try(?:\\s+again)?|available)\\s+(?:in|after|at)\\s*(\\d+)\\s*s(ec)?/i,\n\t/(?:retry|try(?:\\s+again)?|available)\\s+(?:in|after|at)\\s*(\\d+)\\s*m(in)?/i,\n\t/(?:retry|try(?:\\s+again)?|available)\\s+(?:in|after|at)\\s*(\\d+)\\s*h(our|r)?/i,\n] as const;\n\n/**\n * Parse a quota-reset time out of an error message: relative forms like\n * \"reset in 2h\" / \"retry in 30m\" / \"available in 3600s\", or an ISO-8601\n * timestamp. Returns epoch ms in the future, or undefined when unparseable.\n * Port of the goal runtime's parseUsageResetTimeMs.\n */\nexport function parseResetTimeMs(errorMessage: string): number | undefined {\n\tif (!errorMessage) return undefined;\n\tconst now = Date.now();\n\tfor (const pattern of RESET_TIME_PATTERNS) {\n\t\tconst match = errorMessage.match(pattern);\n\t\tif (!match) continue;\n\t\tconst value = Number.parseInt(match[1] ?? \"\", 10);\n\t\tif (!Number.isFinite(value) || value <= 0) continue;\n\t\tconst unit = pattern.source.includes(\"\\\\s*h\") ? 3600_000 : pattern.source.includes(\"\\\\s*m\") ? 60_000 : 1_000;\n\t\treturn now + value * unit;\n\t}\n\t// ISO-8601 timestamp fallback (e.g. \"reset at 2026-08-01T09:00:00Z\").\n\tconst isoMatch = errorMessage.match(\n\t\t/(?:reset|available).{0,12}(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?(?:\\.\\d+)?(?:Z|[+-]\\d{2}:?\\d{2})?)/i,\n\t);\n\tif (isoMatch?.[1]) {\n\t\tconst parsed = Date.parse(isoMatch[1]);\n\t\tif (Number.isFinite(parsed) && parsed > now) return parsed;\n\t}\n\treturn undefined;\n}\n"]}

package/dist/core/usage-service.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Plan/subscription usage service. Per-provider adapters query provider quota
+ * endpoints (5-minute cache each) so /usage can show subscription windows
+ * alongside session/context totals.
+ *
+ * Deliberately absent adapters:
+ * - anthropic: Anthropic policy prohibits subscription usage tracking in
+ *   third-party coding agents (2026-07-18 decision). OAuth Anthropic sessions
+ *   fall back to hiding the cost meter.
+ * - ollama-cloud: no usage API exists.
+ *
+ * All adapter/network errors resolve to `undefined` — callers omit the UI.
+ */
+import type { ModelRuntime } from "./model-runtime.ts";
+export interface PlanUsageWindow {
+    label: string;
+    usedPercent: number;
+    /** Epoch ms when the window resets. */
+    resetsAt?: number;
+}
+export interface PlanUsage {
+    provider: string;
+    planLabel?: string;
+    windows: PlanUsageWindow[];
+}
+export declare const PLAN_USAGE_CACHE_TTL_MS: number;
+/** Whether a plan-usage adapter exists for this provider. */
+export declare function hasPlanUsageAdapter(providerId: string): boolean;
+/** Plan usage for a provider, or undefined when unsupported/unavailable. Never throws. */
+export declare function getPlanUsage(providerId: string, runtime: ModelRuntime): Promise<PlanUsage | undefined>;
+/** Clear the adapter cache (tests, /login changes). */
+export declare function clearPlanUsageCache(): void;
+//# sourceMappingURL=usage-service.d.ts.map

package/dist/core/usage-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-service.d.ts","sourceRoot":"","sources":["../../src/core/usage-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC3B;AAWD,eAAO,MAAM,uBAAuB,QAAgB,CAAC;AAIrD,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,0FAA0F;AAC1F,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAc5G;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C","sourcesContent":["/**\n * Plan/subscription usage service. Per-provider adapters query provider quota\n * endpoints (5-minute cache each) so /usage can show subscription windows\n * alongside session/context totals.\n *\n * Deliberately absent adapters:\n * - anthropic: Anthropic policy prohibits subscription usage tracking in\n *   third-party coding agents (2026-07-18 decision). OAuth Anthropic sessions\n *   fall back to hiding the cost meter.\n * - ollama-cloud: no usage API exists.\n *\n * All adapter/network errors resolve to `undefined` — callers omit the UI.\n */\n\nimport type { ModelRuntime } from \"./model-runtime.ts\";\nimport { fetchKimiPlanUsage } from \"./usage-adapters/kimi-coding.ts\";\nimport { fetchCodexPlanUsage } from \"./usage-adapters/openai-codex.ts\";\nimport { fetchXaiPlanUsage } from \"./usage-adapters/xai.ts\";\nimport { fetchZaiPlanUsage } from \"./usage-adapters/zai.ts\";\n\nexport interface PlanUsageWindow {\n\tlabel: string;\n\tusedPercent: number;\n\t/** Epoch ms when the window resets. */\n\tresetsAt?: number;\n}\n\nexport interface PlanUsage {\n\tprovider: string;\n\tplanLabel?: string;\n\twindows: PlanUsageWindow[];\n}\n\ntype UsageAdapter = (runtime: ModelRuntime) => Promise<PlanUsage | undefined>;\n\nconst ADAPTERS: Readonly<Record<string, UsageAdapter>> = {\n\t\"openai-codex\": fetchCodexPlanUsage,\n\t\"kimi-coding\": fetchKimiPlanUsage,\n\tzai: fetchZaiPlanUsage,\n\txai: fetchXaiPlanUsage,\n};\n\nexport const PLAN_USAGE_CACHE_TTL_MS = 5 * 60 * 1000;\n\nconst cache = new Map<string, { expiresAt: number; value: PlanUsage | undefined }>();\n\n/** Whether a plan-usage adapter exists for this provider. */\nexport function hasPlanUsageAdapter(providerId: string): boolean {\n\treturn providerId in ADAPTERS;\n}\n\n/** Plan usage for a provider, or undefined when unsupported/unavailable. Never throws. */\nexport async function getPlanUsage(providerId: string, runtime: ModelRuntime): Promise<PlanUsage | undefined> {\n\tconst adapter = ADAPTERS[providerId];\n\tif (!adapter) return undefined;\n\tconst now = Date.now();\n\tconst cached = cache.get(providerId);\n\tif (cached && cached.expiresAt > now) return cached.value;\n\tlet value: PlanUsage | undefined;\n\ttry {\n\t\tvalue = await adapter(runtime);\n\t} catch {\n\t\tvalue = undefined;\n\t}\n\tcache.set(providerId, { expiresAt: now + PLAN_USAGE_CACHE_TTL_MS, value });\n\treturn value;\n}\n\n/** Clear the adapter cache (tests, /login changes). */\nexport function clearPlanUsageCache(): void {\n\tcache.clear();\n}\n\n// ---------------------------------------------------------------------------\n// Extension bridge\n// ---------------------------------------------------------------------------\n"]}

package/dist/core/usage-service.js

@@ -0,0 +1,56 @@
+/**
+ * Plan/subscription usage service. Per-provider adapters query provider quota
+ * endpoints (5-minute cache each) so /usage can show subscription windows
+ * alongside session/context totals.
+ *
+ * Deliberately absent adapters:
+ * - anthropic: Anthropic policy prohibits subscription usage tracking in
+ *   third-party coding agents (2026-07-18 decision). OAuth Anthropic sessions
+ *   fall back to hiding the cost meter.
+ * - ollama-cloud: no usage API exists.
+ *
+ * All adapter/network errors resolve to `undefined` — callers omit the UI.
+ */
+import { fetchKimiPlanUsage } from "./usage-adapters/kimi-coding.js";
+import { fetchCodexPlanUsage } from "./usage-adapters/openai-codex.js";
+import { fetchXaiPlanUsage } from "./usage-adapters/xai.js";
+import { fetchZaiPlanUsage } from "./usage-adapters/zai.js";
+const ADAPTERS = {
+    "openai-codex": fetchCodexPlanUsage,
+    "kimi-coding": fetchKimiPlanUsage,
+    zai: fetchZaiPlanUsage,
+    xai: fetchXaiPlanUsage,
+};
+export const PLAN_USAGE_CACHE_TTL_MS = 5 * 60 * 1000;
+const cache = new Map();
+/** Whether a plan-usage adapter exists for this provider. */
+export function hasPlanUsageAdapter(providerId) {
+    return providerId in ADAPTERS;
+}
+/** Plan usage for a provider, or undefined when unsupported/unavailable. Never throws. */
+export async function getPlanUsage(providerId, runtime) {
+    const adapter = ADAPTERS[providerId];
+    if (!adapter)
+        return undefined;
+    const now = Date.now();
+    const cached = cache.get(providerId);
+    if (cached && cached.expiresAt > now)
+        return cached.value;
+    let value;
+    try {
+        value = await adapter(runtime);
+    }
+    catch {
+        value = undefined;
+    }
+    cache.set(providerId, { expiresAt: now + PLAN_USAGE_CACHE_TTL_MS, value });
+    return value;
+}
+/** Clear the adapter cache (tests, /login changes). */
+export function clearPlanUsageCache() {
+    cache.clear();
+}
+// ---------------------------------------------------------------------------
+// Extension bridge
+// ---------------------------------------------------------------------------
+//# sourceMappingURL=usage-service.js.map

package/dist/core/usage-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-service.js","sourceRoot":"","sources":["../../src/core/usage-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAiB5D,MAAM,QAAQ,GAA2C;IACxD,cAAc,EAAE,mBAAmB;IACnC,aAAa,EAAE,kBAAkB;IACjC,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,iBAAiB;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAErD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+D,CAAC;AAErF,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAW;IAChE,OAAO,UAAU,IAAI,QAAQ,CAAC;AAAA,CAC9B;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB,EAAE,OAAqB,EAAkC;IAC7G,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAC1D,IAAI,KAA4B,CAAC;IACjC,IAAI,CAAC;QACJ,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACR,KAAK,GAAG,SAAS,CAAC;IACnB,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,uBAAuB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC;AAAA,CACb;AAED,uDAAuD;AACvD,MAAM,UAAU,mBAAmB,GAAS;IAC3C,KAAK,CAAC,KAAK,EAAE,CAAC;AAAA,CACd;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E","sourcesContent":["/**\n * Plan/subscription usage service. Per-provider adapters query provider quota\n * endpoints (5-minute cache each) so /usage can show subscription windows\n * alongside session/context totals.\n *\n * Deliberately absent adapters:\n * - anthropic: Anthropic policy prohibits subscription usage tracking in\n *   third-party coding agents (2026-07-18 decision). OAuth Anthropic sessions\n *   fall back to hiding the cost meter.\n * - ollama-cloud: no usage API exists.\n *\n * All adapter/network errors resolve to `undefined` — callers omit the UI.\n */\n\nimport type { ModelRuntime } from \"./model-runtime.ts\";\nimport { fetchKimiPlanUsage } from \"./usage-adapters/kimi-coding.ts\";\nimport { fetchCodexPlanUsage } from \"./usage-adapters/openai-codex.ts\";\nimport { fetchXaiPlanUsage } from \"./usage-adapters/xai.ts\";\nimport { fetchZaiPlanUsage } from \"./usage-adapters/zai.ts\";\n\nexport interface PlanUsageWindow {\n\tlabel: string;\n\tusedPercent: number;\n\t/** Epoch ms when the window resets. */\n\tresetsAt?: number;\n}\n\nexport interface PlanUsage {\n\tprovider: string;\n\tplanLabel?: string;\n\twindows: PlanUsageWindow[];\n}\n\ntype UsageAdapter = (runtime: ModelRuntime) => Promise<PlanUsage | undefined>;\n\nconst ADAPTERS: Readonly<Record<string, UsageAdapter>> = {\n\t\"openai-codex\": fetchCodexPlanUsage,\n\t\"kimi-coding\": fetchKimiPlanUsage,\n\tzai: fetchZaiPlanUsage,\n\txai: fetchXaiPlanUsage,\n};\n\nexport const PLAN_USAGE_CACHE_TTL_MS = 5 * 60 * 1000;\n\nconst cache = new Map<string, { expiresAt: number; value: PlanUsage | undefined }>();\n\n/** Whether a plan-usage adapter exists for this provider. */\nexport function hasPlanUsageAdapter(providerId: string): boolean {\n\treturn providerId in ADAPTERS;\n}\n\n/** Plan usage for a provider, or undefined when unsupported/unavailable. Never throws. */\nexport async function getPlanUsage(providerId: string, runtime: ModelRuntime): Promise<PlanUsage | undefined> {\n\tconst adapter = ADAPTERS[providerId];\n\tif (!adapter) return undefined;\n\tconst now = Date.now();\n\tconst cached = cache.get(providerId);\n\tif (cached && cached.expiresAt > now) return cached.value;\n\tlet value: PlanUsage | undefined;\n\ttry {\n\t\tvalue = await adapter(runtime);\n\t} catch {\n\t\tvalue = undefined;\n\t}\n\tcache.set(providerId, { expiresAt: now + PLAN_USAGE_CACHE_TTL_MS, value });\n\treturn value;\n}\n\n/** Clear the adapter cache (tests, /login changes). */\nexport function clearPlanUsageCache(): void {\n\tcache.clear();\n}\n\n// ---------------------------------------------------------------------------\n// Extension bridge\n// ---------------------------------------------------------------------------\n"]}