letmecode 0.1.20 → 0.1.22

package/README.md

@@ -3,43 +3,26 @@
 Ussage:
 
 ```bash
-npx -y letmecode
-npx -y letmecode -- -h
-npx -y letmecode -- --log-to log.txt
+npx -y letmecode@latest
 ```
 
-`--log-to` now records Claude binary discovery, session-root selection, parsed transcript file summaries, entrypoint matching, raw `/usage` output, and live-window event matching so zero-token windows are diagnosable.
 
-<img width="2308" height="1491" alt="image" src="https://github.com/user-attachments/assets/f3f52d79-00e3-4ff5-bf2f-65f8be632aaa" />
+Preview:
 
-## Controls
+<img width="2301" height="1397" alt="image" src="https://github.com/user-attachments/assets/c37d6847-9926-4977-8592-5cab8346a86f" />
 
-| Key | Action |
-| --- | --- |
-| `[` / `]` | Switch providers |
-| `Tab` / `Shift+Tab` | Switch providers when supported by the terminal |
-| `Up` / `Down` or `k` / `j` | Switch dashboard sections |
-| `Left` / `Right` | Select the previous or next table row |
-| `Enter` | Run the selected provider action |
-| `1` | Select the Copilot VS Code setup action |
-| `h` / `l` | Select a Copilot setup action |
-| `q` or `Esc` | Quit |
-| Mouse click | Click a provider tab or a section tab to switch to it. Hold `Shift` while dragging to select/copy text anywhere else. |
 
-## Copilot
 
-Copilot CLI usage is read from `~/.copilot/session-state`.
 
-VS Code extension usage needs file OTEL logging first. Select the `Copilot` provider, choose `Start logging VS Code` with `1` or `h` / `l`, then press `Enter`; letmecode will update the current user's VS Code settings with:
+## Advanced ussage
 
-```json
-{
-  "github.copilot.chat.otel.enabled": true,
-  "github.copilot.chat.otel.exporterType": "file",
-  "github.copilot.chat.otel.outfile": "~/.copilot/otel/vscode.jsonl",
-  "github.copilot.chat.otel.captureContent": false
-}
 ```
+npx -y letmecode -- -h
+npx -y letmecode -- --log-to log.txt
+```
+
+`--log-to` now records Claude binary discovery, session-root selection, parsed transcript file summaries, entrypoint matching, raw `/usage` output, and live-window event matching so zero-token windows are diagnosable.
+
 
 ## Local development
 

package/ink-app/dist/index.js

@@ -19,7 +19,7 @@ const DETAIL_TABS = [
     { id: "usage-by-model", label: "Models" }
 ];
 const CODEX_CREDIT_COST_USD = 0.01;
-const LIMIT_TABLE_HEADERS = ["Scope", "Plan", "Window", "Used", "Start", "End", "API eq."];
+const LIMIT_TABLE_HEADERS = ["Scope", "Plan", "Models", "Window", "Used", "Start", "End", "API eq."];
 const DAILY_TABLE_HEADERS = ["Day", "Ev", "Input", "Output", "C read", "C write", "API eq."];
 const MODEL_TABLE_HEADERS = ["Model", "Input", "Output", "C read", "C write", "API eq."];
 const COPILOT_ACTIONS = [
@@ -195,7 +195,7 @@ function App(props) {
             moveSelectedTableRow(-1);
         }
     });
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, height: viewportHeight, overflow: "hidden", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "LetMeCode Usage Dashboard" }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, color: "white", backgroundColor: "green", children: " beta " })] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "gray", children: "Provider  " }), sortedProviderStates.map((state) => (_jsx(ProviderTab, { label: state.provider.label, active: state.provider.id === selectedProvider.provider.id, status: state.status, regionRef: getRegionRef(`provider:${state.provider.id}`) }, state.provider.id)))] }), _jsxs(Box, { children: [_jsx(Text, { color: "gray", children: "View      " }), DETAIL_TABS.map((tab, index) => (_jsx(DetailTab, { label: tab.label, active: index === selectedDetailTabIndex, regionRef: getRegionRef(`vtab:${index}`) }, tab.id)))] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", flexGrow: 1, overflow: "hidden", children: [_jsx(Box, { flexGrow: 1, overflow: "hidden", children: _jsx(Box, { ref: contentPanelRef, flexDirection: "column", flexGrow: 1, overflow: "hidden", children: _jsx(ContentPanel, { providerState: selectedProvider, tabId: selectedDetailTab.id, selectedLimitRowKey: selectedLimitRow ? getLimitRowKey(selectedLimitRow) : undefined, selectedDayKey: selectedDayRow?.dayKey, selectedModelId: selectedModelRow?.modelId, availableHeight: contentPanelHeight }) }) }), _jsx(SelectionDetailsPanel, { providerState: selectedProvider, tabId: selectedDetailTab.id, selectedLimitRow: selectedLimitRow, selectedDayRow: selectedDayRow, selectedModelRow: selectedModelRow }), _jsx(CopilotActionsPanel, { providerState: selectedProvider, actionMessage: copilotActionMessage, selectedActionIndex: selectedCopilotActionIndex }), selectedProvider.status === "ready" && selectedProvider.stats.warnings.length > 0 ? (_jsxs(Box, { marginTop: 1, borderStyle: "round", borderColor: "yellow", paddingX: 1, flexDirection: "column", overflow: "hidden", children: [_jsx(Text, { color: "yellow", children: "Warnings" }), selectedProvider.stats.warnings.map((warning) => (_jsx(Text, { children: warning }, warning)))] })) : null] }), _jsx(Text, { color: "gray", children: "Tab provider \u00B7 \u2190/\u2192 view \u00B7 \u2191/\u2193 row \u00B7 q quit" })] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, height: viewportHeight, overflow: "hidden", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "LetMeCode Usage Dashboard" }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, color: "white", backgroundColor: "green", children: " beta " })] }), _jsxs(Box, { children: [_jsx(Text, { color: "gray", children: "Provider  " }), sortedProviderStates.map((state) => (_jsx(ProviderTab, { label: state.provider.label, active: state.provider.id === selectedProvider.provider.id, status: state.status, regionRef: getRegionRef(`provider:${state.provider.id}`) }, state.provider.id)))] }), _jsxs(Box, { children: [_jsx(Text, { color: "gray", children: "View      " }), DETAIL_TABS.map((tab, index) => (_jsx(DetailTab, { label: tab.label, active: index === selectedDetailTabIndex, regionRef: getRegionRef(`vtab:${index}`) }, tab.id)))] }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children: [_jsx(Box, { flexGrow: 1, overflow: "hidden", children: _jsx(Box, { ref: contentPanelRef, flexDirection: "column", flexGrow: 1, overflow: "hidden", children: _jsx(ContentPanel, { providerState: selectedProvider, tabId: selectedDetailTab.id, selectedLimitRowKey: selectedLimitRow ? getLimitRowKey(selectedLimitRow) : undefined, selectedDayKey: selectedDayRow?.dayKey, selectedModelId: selectedModelRow?.modelId, availableHeight: contentPanelHeight }) }) }), _jsx(SelectionDetailsPanel, { providerState: selectedProvider, tabId: selectedDetailTab.id, selectedLimitRow: selectedLimitRow, selectedDayRow: selectedDayRow, selectedModelRow: selectedModelRow }), _jsx(CopilotActionsPanel, { providerState: selectedProvider, actionMessage: copilotActionMessage, selectedActionIndex: selectedCopilotActionIndex }), selectedProvider.status === "ready" && selectedProvider.stats.warnings.length > 0 ? (_jsxs(Box, { borderStyle: "round", borderColor: "yellow", paddingX: 1, flexDirection: "column", overflow: "hidden", children: [_jsx(Text, { color: "yellow", children: "Warnings" }), selectedProvider.stats.warnings.map((warning) => (_jsx(Text, { children: warning }, warning)))] })) : null] }), _jsx(Text, { color: "gray", children: "Tab provider \u00B7 \u2190/\u2192 view \u00B7 \u2191/\u2193 row \u00B7 q quit" })] }));
 }
 function CopilotActionsPanel(props) {
     if (props.providerState.provider.id !== "copilot") {
@@ -203,7 +203,7 @@ function CopilotActionsPanel(props) {
     }
     const hasNoUsage = props.providerState.status === "ready" && props.providerState.stats.summary.tokenEvents === 0;
     const accentColor = hasNoUsage ? "red" : "cyan";
-    return (_jsxs(Box, { marginTop: 1, borderStyle: "round", borderColor: accentColor, paddingX: 1, flexDirection: "column", children: [_jsx(Text, { color: accentColor, children: "Copilot setup" }), _jsx(Box, { children: COPILOT_ACTIONS.map((action, index) => (_jsx(Box, { marginRight: 1, children: _jsx(Text, { inverse: index === (props.selectedActionIndex ?? 0), bold: hasNoUsage && action.id === "vscode", color: action.enabled ? (hasNoUsage && action.id === "vscode" ? accentColor : undefined) : "gray", children: `${index + 1} ${action.label}` }) }, action.id))) }), _jsx(Text, { color: hasNoUsage ? accentColor : "gray", children: "Press 1 or h/l to select an action, enter to run selected." }), props.actionMessage ? _jsx(Text, { children: props.actionMessage }) : null] }));
+    return (_jsxs(Box, { borderStyle: "round", borderColor: accentColor, paddingX: 1, flexDirection: "column", children: [_jsx(Text, { color: accentColor, children: "Copilot setup" }), _jsx(Box, { children: COPILOT_ACTIONS.map((action, index) => (_jsx(Box, { marginRight: 1, children: _jsx(Text, { inverse: index === (props.selectedActionIndex ?? 0), bold: hasNoUsage && action.id === "vscode", color: action.enabled ? (hasNoUsage && action.id === "vscode" ? accentColor : undefined) : "gray", children: `${index + 1} ${action.label}` }) }, action.id))) }), _jsx(Text, { color: hasNoUsage ? accentColor : "gray", children: "Press 1 or h/l to select an action, enter to run selected." }), props.actionMessage ? _jsx(Text, { children: props.actionMessage }) : null] }));
 }
 function runCopilotAction(actionId, setCopilotActionMessage) {
     setCopilotActionMessage("Updating VS Code settings...");
@@ -247,7 +247,10 @@ function SummaryPanel(props) {
     const costPerEvent = totals.eventCount > 0
         ? (totals.estimatedCredits * CODEX_CREDIT_COST_USD) / totals.eventCount
         : 0;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [props.stats.providerLabel, " overview"] }), _jsx(Text, { children: " " }), _jsxs(Box, { children: [_jsxs(Box, { flexDirection: "column", width: 45, children: [_jsx(DetailRow, { label: "Plan", value: summary.distinctPlanTypes.join(", ") || "none" }), _jsx(DetailRow, { label: "Models", value: summary.distinctModels.join(", ") || "none" }), _jsx(DetailRow, { label: "Period", value: period }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: "Usage" }), _jsx(DetailRow, { label: "Events", value: formatInteger(totals.eventCount) }), _jsx(DetailRow, { label: "Input", value: formatOverviewTokenCount(totals.inputTokens) }), _jsx(DetailRow, { label: "Output", value: formatOverviewTokenCount(totals.outputTokens) }), _jsx(DetailRow, { label: "Cache read", value: formatCacheOverviewTokenCount(totals, totals.cacheReadInputTokens) }), _jsx(DetailRow, { label: "Reasoning", value: formatOverviewTokenCount(totals.reasoningOutputTokens) }), _jsx(DetailRow, { label: "Total", value: formatOverviewTokenCount(totals.totalTokens) }), _jsx(DetailRow, { label: "API equiv.", value: formatUsageUsd(totals) })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", children: "Efficiency" }), _jsx(DetailRow, { label: "Cache ratio", value: formatPercent(cacheRatio) }), _jsx(DetailRow, { label: "Input/output", value: formatInputOutputRatio(totals) }), _jsx(DetailRow, { label: "Avg/event", value: `${formatOverviewTokenCount(averageTokensPerEvent)} tokens` }), _jsx(DetailRow, { label: "Cost/event", value: formatUnitUsd(costPerEvent) }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: "Data source" }), _jsx(DetailRow, { label: "Files", value: formatInteger(summary.filesScanned) }), _jsx(DetailRow, { label: "Lines", value: formatInteger(summary.linesRead) }), _jsx(DetailRow, { label: "Path", value: summary.rootPath })] })] })] }));
+    return (_jsxs(Box, { borderStyle: "round", paddingX: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", children: "Summary" }), _jsxs(Box, { children: [_jsxs(Box, { flexDirection: "column", width: 45, children: [_jsx(DetailRow, { label: "Plan", value: summary.distinctPlanTypes.join(", ") || "none" }), _jsx(DetailRow, { label: "Models", value: summary.distinctModels.join(", ") || "none" }), _jsx(DetailRow, { label: "Period", value: period }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: "Usage" }), _jsx(DetailRow, { label: "Events", value: formatInteger(totals.eventCount) }), _jsx(DetailRow, { label: "Input", value: formatOverviewTokenCount(totals.inputTokens) }), _jsx(DetailRow, { label: "Output", value: formatOverviewTokenCount(totals.outputTokens) }), _jsx(DetailRow, { label: "Cache read", value: formatCacheOverviewTokenCount(totals.cacheReadStatus, totals.cacheReadInputTokens) }), _jsx(DetailRow, { label: "Reasoning", value: formatOverviewTokenCount(totals.reasoningOutputTokens) }), _jsx(DetailRow, { label: "Total", value: formatOverviewTokenCount(totals.totalTokens) }), _jsx(DetailRow, { label: "API equiv.", value: formatUsageUsd(totals) })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", children: "Efficiency" }), _jsx(DetailRow, { label: "Cache ratio", value: formatPercent(cacheRatio) }), (() => {
+                                const { label, value } = formatInputOutputRatio(totals, props.stats.providerId);
+                                return _jsx(DetailRow, { label: label, value: value, padLength: Math.max(14, label.length + 1), noSlice: true });
+                            })(), _jsx(DetailRow, { label: "Avg/event", value: `${formatOverviewTokenCount(averageTokensPerEvent)} tokens` }), _jsx(DetailRow, { label: "Cost/event", value: formatUnitUsd(costPerEvent) }), _jsx(Text, { children: " " }), _jsx(Text, { color: "cyan", children: "Data source" }), _jsx(DetailRow, { label: "Files", value: formatInteger(summary.filesScanned) }), _jsx(DetailRow, { label: "Lines", value: formatInteger(summary.linesRead) }), _jsx(DetailRow, { label: "Path", value: summary.rootPath })] })] })] }));
 }
 function ContentPanel(props) {
     if (props.providerState.status === "loading") {
@@ -320,7 +323,6 @@ function buildTextTableLines(options) {
     if (options.rows.length === 0 && !options.totalRow) {
         return {
             bodyLines: [
-                { key: `${options.lineKeyPrefix}-title`, text: options.title, bold: true },
                 { key: `${options.lineKeyPrefix}-empty`, text: "No rows found.", color: "gray" }
             ]
         };
@@ -330,7 +332,6 @@ function buildTextTableLines(options) {
         : options.rows;
     const table = createTextTable(options.headers, tableRows.map((row) => row.cells));
     const headerLines = [
-        { key: `${options.lineKeyPrefix}-title`, text: options.title, bold: true },
         {
             key: `${options.lineKeyPrefix}-top-border`,
             text: buildTableBorder(table, "┌", "┬", "┐"),
@@ -394,7 +395,6 @@ function buildLimitWindowTableLines(stats, selectedRowKey) {
         ? new Set([primaryRows[primaryRows.length - 1].key])
         : undefined;
     return buildTextTableLines({
-        title: "Limits",
         lineKeyPrefix: "limits",
         headers: LIMIT_TABLE_HEADERS,
         rows: [...primaryRows, ...secondaryRows],
@@ -408,17 +408,19 @@ function buildLimitWindowTableRow(window) {
         cells: [
             window.scope,
             window.planType,
+            formatLimitWindowModels(window),
             formatCompactWindowMinutes(window.windowMinutes),
             formatUsedPercentRange(window.minUsedPercent, window.maxUsedPercent),
             formatCompactLocalDateTime(window.startTimeUtcIso),
             formatCompactLocalDateTime(window.endTimeUtcIso),
-            formatUsd(window.totals.estimatedCredits * CODEX_CREDIT_COST_USD)
+            // Status-aware: shows "-" when the API-equivalent cost is unknown rather
+            // than a misleading $0.00.
+            formatUsageUsd(window.totals)
         ]
     };
 }
 function buildDailyUsageTableLines(rows, selectedDayKey) {
     return buildTextTableLines({
-        title: "Daily usage",
         lineKeyPrefix: "daily",
         headers: DAILY_TABLE_HEADERS,
         rows: rows.map((row) => ({
@@ -428,8 +430,8 @@ function buildDailyUsageTableLines(rows, selectedDayKey) {
                 formatCompactTokenCount(row.totals.eventCount),
                 formatCompactTokenCount(row.totals.inputTokens),
                 formatCompactTokenCount(row.totals.outputTokens),
-                formatCompactCacheTokens(row.totals, row.totals.cacheReadInputTokens),
-                formatCompactCacheTokens(row.totals, row.totals.cacheWriteInputTokens),
+                formatCompactCacheTokens(row.totals.cacheReadStatus, row.totals.cacheReadInputTokens),
+                formatCompactCacheTokens(row.totals.cacheWriteStatus, row.totals.cacheWriteInputTokens),
                 formatUsageUsd(row.totals)
             ]
         })),
@@ -438,7 +440,6 @@ function buildDailyUsageTableLines(rows, selectedDayKey) {
 }
 function buildModelUsageTableLines(rows, totals, selectedModelId) {
     return buildTextTableLines({
-        title: "Model usage",
         lineKeyPrefix: "model",
         headers: MODEL_TABLE_HEADERS,
         rows: rows.map((row) => ({
@@ -458,7 +459,7 @@ function SelectionDetailsPanel(props) {
     }
     if (props.tabId === "limit-windows" && props.selectedLimitRow) {
         const row = props.selectedLimitRow;
-        return (_jsx(DetailsPanelFrame, { children: _jsxs(Box, { children: [_jsxs(Box, { flexDirection: "column", width: 25, children: [_jsx(DetailRow, { label: "Plan", value: row.planType }), _jsx(DetailRow, { label: "Window", value: formatCompactWindowMinutes(row.windowMinutes) }), _jsx(DetailRow, { label: "Usage", value: formatUsedPercentRange(row.minUsedPercent, row.maxUsedPercent) }), _jsx(DetailRow, { label: "Events", value: formatInteger(row.eventCount) }), _jsx(DetailRow, { label: "API eq.", value: formatUsageUsd(row.totals) })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(DetailRow, { label: "Period", value: `${formatCompactLocalDateTime(row.startTimeUtcIso)} → ${formatCompactLocalDateTime(row.endTimeUtcIso)}` }), _jsx(DetailRow, { label: "Input", value: formatInteger(row.totals.inputTokens) }), _jsx(DetailRow, { label: "Cache read", value: formatCacheTokens(row.totals, row.totals.cacheReadInputTokens) }), _jsx(DetailRow, { label: "Cache write", value: formatCacheTokens(row.totals, row.totals.cacheWriteInputTokens) }), _jsx(DetailRow, { label: "Output", value: formatInteger(row.totals.outputTokens) }), _jsx(DetailRow, { label: "Total", value: formatInteger(row.totals.totalTokens) })] })] }) }));
+        return (_jsx(DetailsPanelFrame, { children: _jsxs(Box, { children: [_jsxs(Box, { flexDirection: "column", width: 25, children: [_jsx(DetailRow, { label: "Plan", value: row.planType }), _jsx(DetailRow, { label: "Models", value: formatLimitWindowModels(row) }), _jsx(DetailRow, { label: "Window", value: formatCompactWindowMinutes(row.windowMinutes) }), _jsx(DetailRow, { label: "Usage", value: formatUsedPercentRange(row.minUsedPercent, row.maxUsedPercent) }), _jsx(DetailRow, { label: "Events", value: formatInteger(row.eventCount) }), _jsx(DetailRow, { label: "API eq.", value: formatUsageUsd(row.totals) })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(DetailRow, { label: "Period", value: `${formatCompactLocalDateTime(row.startTimeUtcIso)} → ${formatCompactLocalDateTime(row.endTimeUtcIso)}` }), _jsx(DetailRow, { label: "Input", value: formatInteger(row.totals.inputTokens) }), _jsx(DetailRow, { label: "Cache read", value: formatCacheTokens(row.totals.cacheReadStatus, row.totals.cacheReadInputTokens) }), _jsx(DetailRow, { label: "Cache write", value: formatCacheTokens(row.totals.cacheWriteStatus, row.totals.cacheWriteInputTokens) }), _jsx(DetailRow, { label: "Output", value: formatInteger(row.totals.outputTokens) }), _jsx(DetailRow, { label: "Total", value: formatInteger(row.totals.totalTokens) })] })] }) }));
     }
     if (props.tabId === "day-to-day-analyses" && props.selectedDayRow) {
         const row = props.selectedDayRow;
@@ -470,10 +471,13 @@ function SelectionDetailsPanel(props) {
     return null;
 }
 function DetailsPanelFrame(props) {
-    return (_jsxs(Box, { marginTop: 1, borderStyle: "round", paddingX: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", children: "Details" }), props.children] }));
+    return (_jsxs(Box, { borderStyle: "round", paddingX: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", children: "Details" }), props.children] }));
 }
 function DetailRow(props) {
-    return (_jsxs(Text, { children: [pad(props.label, 14), props.value] }));
+    const labelText = props.noSlice
+        ? props.label.padEnd(props.padLength ?? 14)
+        : pad(props.label, props.padLength ?? 14);
+    return (_jsxs(Text, { children: [labelText, props.value] }));
 }
 function UsageTotalsDetails(props) {
     const { totals } = props;
@@ -495,8 +499,8 @@ function formatOverviewTokenCount(value) {
     }
     return formatInteger(roundedValue);
 }
-function formatCacheOverviewTokenCount(totals, value) {
-    return totals.cacheStatus === "unavailable" ? "-" : formatOverviewTokenCount(value);
+function formatCacheOverviewTokenCount(status, value) {
+    return status === "unavailable" ? "-" : formatOverviewTokenCount(value);
 }
 function formatFixedCompactNumber(value) {
     return value.toLocaleString("en-US", {
@@ -580,7 +584,7 @@ function formatPercent(value) {
     })}%`;
 }
 function resolveCacheRatio(totals) {
-    if (totals.cacheStatus === "unavailable") {
+    if (totals.cacheReadStatus === "unavailable") {
         return NaN;
     }
     const inputPool = totals.inputTokens +
@@ -590,14 +594,32 @@ function resolveCacheRatio(totals) {
         ? (totals.cacheReadInputTokens / inputPool) * 100
         : 0;
 }
-function formatInputOutputRatio(totals) {
+function formatInputOutputRatio(totals, providerId) {
     if (totals.outputTokens <= 0) {
-        return "-";
+        return {
+            label: providerId === "claude" ? "Input/Write/Read/W5m/W1h/Output" : "Input/ReadCache/Output",
+            value: "-"
+        };
+    }
+    const fmt = (val) => {
+        const ratio = val / totals.outputTokens;
+        return ratio.toLocaleString("en-US", {
+            maximumFractionDigits: 1,
+            minimumFractionDigits: 0
+        });
+    };
+    if (providerId === "claude") {
+        return {
+            label: "Input/Write/Read/W5m/W1h/Output",
+            value: `${fmt(totals.inputTokens)} : ${fmt(totals.cacheWriteInputTokens)} : ${fmt(totals.cacheReadInputTokens)} : ${fmt(totals.cacheWrite5mInputTokens)} : ${fmt(totals.cacheWrite1hInputTokens)} : 1`
+        };
+    }
+    else {
+        return {
+            label: "Input/ReadCache/Output",
+            value: `${fmt(totals.inputTokens)} : ${fmt(totals.cacheReadInputTokens)} : 1`
+        };
     }
-    return `${(totals.inputTokens / totals.outputTokens).toLocaleString("en-US", {
-        maximumFractionDigits: 1,
-        minimumFractionDigits: 0
-    })} : 1`;
 }
 function formatUsedPercentRange(minUsedPercent, maxUsedPercent) {
     const fmt = (v) => `${Math.round(v)}%`;
@@ -619,6 +641,13 @@ function formatCompactWindowMinutes(value) {
     }
     return `${formatCompactNumber(hours)}h`;
 }
+function formatLimitWindowModels(window) {
+    const label = window.modelType?.trim();
+    if (!label) {
+        return "All";
+    }
+    return label.charAt(0).toUpperCase() + label.slice(1);
+}
 function formatLocalDateTime(value) {
     const parts = new Intl.DateTimeFormat("en-US", {
         month: "short",
@@ -683,23 +712,23 @@ function formatModelUsageTableCells(modelId, totals) {
         displayModelId,
         formatCompactTokenCount(totals.inputTokens),
         formatCompactTokenCount(totals.outputTokens),
-        formatCompactCacheTokens(totals, totals.cacheReadInputTokens),
-        formatCompactCacheTokens(totals, totals.cacheWriteInputTokens),
+        formatCompactCacheTokens(totals.cacheReadStatus, totals.cacheReadInputTokens),
+        formatCompactCacheTokens(totals.cacheWriteStatus, totals.cacheWriteInputTokens),
         formatUsageUsd(totals, modelId)
     ];
 }
 function UsageBreakdownLines(props) {
     const { totals } = props;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["input: ", formatInteger(totals.inputTokens), "  output: ", formatInteger(totals.outputTokens), "  cacheRead: ", formatCacheTokens(totals, totals.cacheReadInputTokens)] }), _jsxs(Text, { children: ["cacheWrite: ", formatCacheTokens(totals, totals.cacheWriteInputTokens), "  cacheW5m: ", formatOptionalTokens(totals.cacheWrite5mInputTokens), "  cacheW1h: ", formatOptionalTokens(totals.cacheWrite1hInputTokens), "  reasoning: ", formatInteger(totals.reasoningOutputTokens), "  total: ", formatInteger(totals.totalTokens)] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["input: ", formatInteger(totals.inputTokens), "  output: ", formatInteger(totals.outputTokens), "  cacheRead: ", formatCacheTokens(totals.cacheReadStatus, totals.cacheReadInputTokens)] }), _jsxs(Text, { children: ["cacheWrite: ", formatCacheTokens(totals.cacheWriteStatus, totals.cacheWriteInputTokens), "  cacheW5m: ", formatOptionalTokens(totals.cacheWrite5mInputTokens), "  cacheW1h: ", formatOptionalTokens(totals.cacheWrite1hInputTokens), "  reasoning: ", formatInteger(totals.reasoningOutputTokens), "  total: ", formatInteger(totals.totalTokens)] })] }));
 }
-function formatCacheTokens(totals, value) {
-    if (totals.cacheStatus === "unavailable") {
+function formatCacheTokens(status, value) {
+    if (status === "unavailable") {
         return "-";
     }
     return formatOptionalTokens(value);
 }
-function formatCompactCacheTokens(totals, value) {
-    if (totals.cacheStatus === "unavailable") {
+function formatCompactCacheTokens(status, value) {
+    if (status === "unavailable") {
         return "-";
     }
     return formatOptionalCompactTokens(value);
@@ -714,10 +743,14 @@ function formatInputPerOutput(totals) {
     if (totals.outputTokens <= 0) {
         return "input:cacheRead:cacheWrite:output = 0:0:0:0";
     }
-    if (totals.cacheStatus === "unavailable") {
-        return `input:cacheRead:cacheWrite:output = ${formatInteger(Math.round(totals.inputTokens / totals.outputTokens))}:-:-:1`;
-    }
-    return `input:cacheRead:cacheWrite:output = ${formatInteger(Math.round(totals.inputTokens / totals.outputTokens))}:${formatInteger(Math.round(totals.cacheReadInputTokens / totals.outputTokens))}:${formatInteger(Math.round(totals.cacheWriteInputTokens / totals.outputTokens))}:1`;
+    const inputRatio = formatInteger(Math.round(totals.inputTokens / totals.outputTokens));
+    const cacheReadRatio = totals.cacheReadStatus === "unavailable"
+        ? "-"
+        : formatInteger(Math.round(totals.cacheReadInputTokens / totals.outputTokens));
+    const cacheWriteRatio = totals.cacheWriteStatus === "unavailable"
+        ? "-"
+        : formatInteger(Math.round(totals.cacheWriteInputTokens / totals.outputTokens));
+    return `input:cacheRead:cacheWrite:output = ${inputRatio}:${cacheReadRatio}:${cacheWriteRatio}:1`;
 }
 function useMeasuredElementSize() {
     const ref = useRef(null);

package/ink-app/dist/providers/antigravity/models.js

@@ -0,0 +1,46 @@
+/**
+ * Single source of truth for mapping Antigravity model identifiers to canonical
+ * model ids. Covers both the opaque RPC placeholders (MODEL_PLACEHOLDER_*) and
+ * the dated/suffixed aliases that show up in usage records.
+ */
+const MODEL_IDS = {
+    MODEL_PLACEHOLDER_M20: "gemini-3.5-flash",
+    MODEL_PLACEHOLDER_M132: "gemini-3.5-flash",
+    MODEL_PLACEHOLDER_M187: "gemini-3.5-flash",
+    MODEL_PLACEHOLDER_M36: "gemini-3.1-pro",
+    MODEL_PLACEHOLDER_M16: "gemini-3.1-pro",
+    MODEL_PLACEHOLDER_M35: "claude-sonnet-4-6",
+    MODEL_PLACEHOLDER_M26: "claude-opus-4-6",
+    MODEL_OPENAI_GPT_OSS_120B_MEDIUM: "gpt-oss-120b",
+    "gemini-3-flash-a": "gemini-3-flash",
+    "gemini-3-flash-preview": "gemini-3-flash",
+    "gemini-3.1-pro-preview": "gemini-3.1-pro",
+    "gemini-3.5-flash-preview": "gemini-3.5-flash",
+    "claude-sonnet-4-6-20251201": "claude-sonnet-4-6",
+    "claude-opus-4-6-20251201": "claude-opus-4-6"
+};
+export function normalizeAntigravityModelId(modelId) {
+    return MODEL_IDS[modelId] ?? (modelId || "unknown");
+}
+export function antigravityModelScope(rawModelId) {
+    const modelId = normalizeAntigravityModelId(rawModelId);
+    if (modelId.startsWith("gemini")) {
+        return "gemini";
+    }
+    if (modelId.startsWith("claude") || modelId.startsWith("gpt")) {
+        return "third-party";
+    }
+    return "unknown";
+}
+export function modelScopeMatches(scope, modelId) {
+    return antigravityModelScope(modelId) === scope;
+}
+export function modelScopeLabel(scope) {
+    if (scope === "gemini") {
+        return "Gemini";
+    }
+    if (scope === "third-party") {
+        return "Claude/GPT";
+    }
+    return "Unknown";
+}

package/ink-app/dist/providers/antigravity/provider.js

@@ -0,0 +1,288 @@
+import { createHash } from "node:crypto";
+import { UsageProviderBase, addUsageTotals, createEmptyUsageTotals, sumUsageTotals } from "../contract.js";
+import { addDailyUsage, buildDailyUsageRows, createDailyUsageAggregates } from "../daily.js";
+import { resolveUsageRate } from "../pricing.js";
+import { modelScopeLabel, modelScopeMatches, normalizeAntigravityModelId } from "./models.js";
+import { parseAntigravityQuotaEntries } from "./quota-parser.js";
+import { findAntigravityLocalServer } from "./rpc/discovery.js";
+import { extractQuotaGroups, fetchAntigravityUserStatus } from "./rpc/quota.js";
+import { collectUsageFromLocalRpc } from "./usage-parse.js";
+const RATE_CARD = {
+    "gemini-3.5-flash": {
+        input: 150,
+        cacheRead: 15,
+        cacheWrite: 150,
+        cacheWrite5m: 150,
+        cacheWrite1h: 150,
+        output: 900
+    },
+    "gemini-3.1-pro": {
+        input: 200,
+        cacheRead: 20,
+        cacheWrite: 200,
+        cacheWrite5m: 200,
+        cacheWrite1h: 200,
+        output: 1200,
+        longContext: {
+            thresholdTokens: 200000,
+            rate: {
+                input: 400,
+                cacheRead: 40,
+                cacheWrite: 400,
+                cacheWrite5m: 400,
+                cacheWrite1h: 400,
+                output: 1800
+            }
+        }
+    },
+    "gemini-3-flash": {
+        input: 50,
+        cacheRead: 5,
+        cacheWrite: 50,
+        cacheWrite5m: 50,
+        cacheWrite1h: 50,
+        output: 300
+    },
+    "claude-sonnet-4-6": {
+        input: 300,
+        cacheRead: 30,
+        cacheWrite: 375,
+        cacheWrite5m: 375,
+        cacheWrite1h: 600,
+        output: 1500
+    },
+    "claude-opus-4-6": {
+        input: 500,
+        cacheRead: 50,
+        cacheWrite: 625,
+        cacheWrite5m: 625,
+        cacheWrite1h: 1000,
+        output: 2500
+    }
+};
+const UNPRICED_MODELS = new Set([
+    "gpt-oss-120b"
+]);
+export class AntigravityUsageProvider extends UsageProviderBase {
+    constructor(options = {}) {
+        super("antigravity", "Antigravity");
+        this.collectUsageOverride = options.collectUsage;
+        this.collectQuotaOverride = options.collectQuota;
+        this.findConnection = options.findConnection ?? findAntigravityLocalServer;
+    }
+    async getStats(options = {}) {
+        const warnings = [];
+        // Discover the local language server at most once per refresh and share the
+        // resulting connection (and its probe payload) between both collectors.
+        let connectionPromise;
+        const connect = () => (connectionPromise ?? (connectionPromise = this.findConnection()));
+        const [usageResult, quotaResult] = await Promise.allSettled([
+            this.collectUsageOverride
+                ? this.collectUsageOverride(options)
+                : collectUsageFromConnection(connect, options),
+            this.collectQuotaOverride
+                ? this.collectQuotaOverride()
+                : collectQuotaFromConnection(connect)
+        ]);
+        const records = usageResult.status === "fulfilled"
+            ? usageResult.value
+            : [];
+        const quotaSnapshot = quotaResult.status === "fulfilled"
+            ? quotaResult.value
+            : null;
+        if (usageResult.status === "rejected") {
+            warnings.push("Could not read Antigravity usage from the local RPC.");
+        }
+        if (quotaResult.status === "rejected") {
+            warnings.push("Live Antigravity quota is unavailable. Ensure the Antigravity IDE is running.");
+        }
+        else if (quotaResult.value.entries.length === 0) {
+            warnings.push("Antigravity local quota RPC responded, but no recognized model quota windows were found.");
+        }
+        const selectedRecords = deduplicateRecords(records);
+        const duplicateEvents = records.length - selectedRecords.length;
+        if (duplicateEvents > 0) {
+            warnings.push(`Collapsed ${duplicateEvents} duplicate Antigravity usage response(s).`);
+        }
+        const byModel = new Map();
+        const byDay = createDailyUsageAggregates();
+        for (const record of selectedRecords) {
+            const modelId = normalizeAntigravityModelId(record.modelId);
+            const totals = usageRecordToTotals(modelId, record);
+            addModelUsage(byModel, modelId, totals);
+            addDailyUsage(byDay, record.timestamp, modelId, undefined, totals);
+        }
+        const modelUsage = [...byModel.entries()]
+            .map(([modelId, totals]) => ({
+            modelId,
+            totals
+        }))
+            .sort((left, right) => right.totals.estimatedCredits -
+            left.totals.estimatedCredits);
+        const unknownPricedModels = modelUsage
+            .filter((row) => !rateForModel(row.modelId, rowInputTokens(row)) && !UNPRICED_MODELS.has(row.modelId))
+            .map((row) => row.modelId);
+        if (unknownPricedModels.length > 0) {
+            warnings.push(`No Antigravity estimated API-equivalent rate configured for: ${unknownPricedModels.join(", ")}.`);
+        }
+        const limitWindows = quotaSnapshot?.entries.map((quota) => buildAntigravityLimitWindow(quota, quotaSnapshot.planType, selectedRecords, quotaSnapshot.fetchedAt)) ?? [];
+        return {
+            providerId: this.id,
+            providerLabel: this.label,
+            summary: {
+                // The provider reads no files or lines; usage comes from the local RPC.
+                filesScanned: 0,
+                linesRead: 0,
+                tokenEvents: selectedRecords.length,
+                totals: sumUsageTotals(modelUsage.map((row) => row.totals)),
+                distinctModels: modelUsage.map((row) => row.modelId),
+                distinctPlanTypes: [
+                    ...new Set(limitWindows.map((window) => window.planType))
+                ],
+                rootLabel: "Antigravity local RPC",
+                rootPath: "127.0.0.1"
+            },
+            modelUsage,
+            dayUsage: buildDailyUsageRows(byDay),
+            primaryLimitWindows: limitWindows.filter((window) => window.scope === "primary"),
+            secondaryLimitWindows: limitWindows.filter((window) => window.scope === "secondary"),
+            warnings,
+            analytics: quotaSnapshot?.userIdHash
+                ? {
+                    agentName: this.label.replace(/\s/g, ""),
+                    userIdHash: quotaSnapshot.userIdHash
+                }
+                : undefined
+        };
+    }
+}
+async function collectUsageFromConnection(connect, options) {
+    const connection = await connect();
+    return connection
+        ? collectUsageFromLocalRpc(connection.server, options)
+        : [];
+}
+async function collectQuotaFromConnection(connect) {
+    const connection = await connect();
+    if (!connection) {
+        throw new Error("Antigravity local language server was not found.");
+    }
+    const status = await fetchAntigravityUserStatus(connection.server);
+    return {
+        entries: parseAntigravityQuotaEntries(extractQuotaGroups(connection.quotaSummary)),
+        fetchedAt: Date.now(),
+        planType: status.planName ?? "unknown",
+        userIdHash: status.email
+            ? createHash("md5").update(status.email).digest("hex")
+            : null
+    };
+}
+function buildAntigravityLimitWindow(quota, planType, records, fetchedAt) {
+    const startAt = quota.resetAt - quota.windowMinutes * 60000;
+    const byModel = new Map();
+    const matchingTimestamps = [];
+    for (const record of records) {
+        const modelId = normalizeAntigravityModelId(record.modelId);
+        if (record.timestamp < startAt ||
+            record.timestamp >= quota.resetAt ||
+            !modelScopeMatches(quota.modelScope, modelId)) {
+            continue;
+        }
+        matchingTimestamps.push(record.timestamp);
+        addModelUsage(byModel, modelId, usageRecordToTotals(modelId, record));
+    }
+    const modelUsage = [...byModel.entries()]
+        .map(([modelId, totals]) => ({
+        modelId,
+        totals
+    }))
+        .sort((left, right) => right.totals.estimatedCredits -
+        left.totals.estimatedCredits);
+    const totals = sumUsageTotals(modelUsage.map((row) => row.totals));
+    const usedPercent = clampPercent((1 - quota.remainingFraction) * 100);
+    // The first/last-seen range reflects the matched local usage events inside
+    // the window. With no matches, fall back to the window start and the fetch
+    // time. Quota percentage is authoritative from Antigravity RPC; token totals
+    // are reconstructed locally and may not match its internal accounting exactly.
+    const firstSeenMs = matchingTimestamps.length
+        ? Math.min(...matchingTimestamps)
+        : startAt;
+    const lastSeenMs = matchingTimestamps.length
+        ? Math.max(...matchingTimestamps)
+        : fetchedAt;
+    return {
+        scope: quota.scope,
+        planType,
+        limitId: quota.limitId,
+        modelType: modelScopeLabel(quota.modelScope),
+        windowMinutes: quota.windowMinutes,
+        startTimeUtcIso: new Date(startAt).toISOString(),
+        endTimeUtcIso: new Date(quota.resetAt).toISOString(),
+        firstSeenUtcIso: new Date(firstSeenMs).toISOString(),
+        lastSeenUtcIso: new Date(lastSeenMs).toISOString(),
+        minUsedPercent: usedPercent,
+        maxUsedPercent: usedPercent,
+        totals,
+        modelUsage,
+        eventCount: totals.eventCount
+    };
+}
+function clampPercent(value) {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.min(100, Math.max(0, value));
+}
+function deduplicateRecords(records) {
+    const byKey = new Map();
+    for (const record of records) {
+        byKey.set(`${record.sessionId}:${record.responseId}`, record);
+    }
+    return [...byKey.values()];
+}
+function usageRecordToTotals(modelId, record) {
+    return {
+        inputTokens: record.input,
+        outputTokens: record.output,
+        cacheReadInputTokens: record.cacheRead,
+        cacheWriteInputTokens: record.cacheWrite,
+        cacheWrite5mInputTokens: 0,
+        cacheWrite1hInputTokens: 0,
+        reasoningOutputTokens: Math.min(record.reasoning, record.output),
+        totalTokens: record.input +
+            record.cacheRead +
+            record.cacheWrite +
+            record.output,
+        estimatedCredits: creditsFor(modelId, record),
+        eventCount: 1,
+        // The local RPC reports cache reads but never cache writes, so cache reads
+        // are accurate while cache writes are genuinely unknown (not a confirmed
+        // zero) — surfaced as "-" everywhere, including the input/output ratio.
+        cacheReadStatus: "known",
+        cacheWriteStatus: "unavailable",
+        estimatedCreditsStatus: rateForModel(modelId, record.input)
+            ? "known"
+            : "unavailable"
+    };
+}
+function creditsFor(modelId, record) {
+    const rate = rateForModel(modelId, record.input);
+    if (!rate) {
+        return 0;
+    }
+    return ((record.input / 1000000) * rate.input +
+        (record.cacheRead / 1000000) * rate.cacheRead +
+        (record.cacheWrite / 1000000) * rate.cacheWrite +
+        (record.output / 1000000) * rate.output);
+}
+function rateForModel(modelId, inputTokens) {
+    return resolveUsageRate(RATE_CARD, modelId, inputTokens);
+}
+function rowInputTokens(row) {
+    return row.totals.inputTokens + row.totals.cacheReadInputTokens + row.totals.cacheWriteInputTokens;
+}
+function addModelUsage(byModel, modelId, deltaTotals) {
+    const totals = byModel.get(modelId) ?? createEmptyUsageTotals();
+    addUsageTotals(totals, deltaTotals);
+    byModel.set(modelId, totals);
+}