tokenmaxxing-cli 0.1.0

package/dist/pricing/modelsdev.snapshot.json

@@ -0,0 +1 @@
+{"openai":{"models":{"gpt-5.4":{"cost":{"input":2.5,"output":15,"cache_read":0.25,"tiers":[{"input":5,"output":22.5,"cache_read":0.5,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":5,"output":22.5,"cache_read":0.5}},"name":"GPT-5.4"},"gpt-5.4-pro":{"cost":{"input":30,"output":180,"tiers":[{"input":60,"output":270,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":60,"output":270}},"name":"GPT-5.4 Pro"},"gpt-3.5-turbo":{"cost":{"input":0.5,"output":1.5,"cache_read":0},"name":"GPT-3.5-turbo"},"gpt-5.5-pro":{"cost":{"input":30,"output":180,"tiers":[{"input":60,"output":270,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":60,"output":270}},"name":"GPT-5.5 Pro"},"text-embedding-3-small":{"cost":{"input":0.02,"output":0},"name":"text-embedding-3-small"},"gpt-5.4-nano":{"cost":{"input":0.2,"output":1.25,"cache_read":0.02},"name":"GPT-5.4 nano"},"gpt-realtime-2.1":{"cost":{"input":4,"output":24,"cache_read":0.4,"input_audio":32,"output_audio":64},"name":"GPT-Realtime-2.1"},"gpt-4o-2024-05-13":{"cost":{"input":5,"output":15},"name":"GPT-4o (2024-05-13)"},"gpt-4o":{"cost":{"input":2.5,"output":10,"cache_read":1.25},"name":"GPT-4o"},"gpt-5-mini":{"cost":{"input":0.25,"output":2,"cache_read":0.025},"name":"GPT-5 Mini"},"gpt-image-2":{"cost":{"input":5,"output":30,"cache_read":1.25},"name":"gpt-image-2"},"gpt-5.2-pro":{"cost":{"input":21,"output":168},"name":"GPT-5.2 Pro"},"o4-mini":{"cost":{"input":1.1,"output":4.4,"cache_read":0.275},"name":"o4-mini"},"o3-mini":{"cost":{"input":1.1,"output":4.4,"cache_read":0.55},"name":"o3-mini"},"text-embedding-ada-002":{"cost":{"input":0.1,"output":0},"name":"text-embedding-ada-002"},"gpt-4":{"cost":{"input":30,"output":60},"name":"GPT-4"},"gpt-5.3-codex":{"cost":{"input":1.75,"output":14,"cache_read":0.175},"name":"GPT-5.3 Codex"},"gpt-4.1-nano":{"cost":{"input":0.1,"output":0.4,"cache_read":0.025},"name":"GPT-4.1 nano"},"gpt-5-nano":{"cost":{"input":0.05,"output":0.4,"cache_read":0.005},"name":"GPT-5 Nano"},"gpt-5.6":{"cost":{"input":4,"output":20,"cache_read":0.4,"cache_write":5,"tiers":[{"input":8,"output":30,"cache_read":0.8,"cache_write":10,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":8,"output":30,"cache_read":0.8,"cache_write":10}},"name":"GPT-5.6"},"gpt-5.2-chat-latest":{"cost":{"input":1.75,"output":14,"cache_read":0.175},"name":"GPT-5.2 Chat"},"o1":{"cost":{"input":15,"output":60,"cache_read":7.5},"name":"o1"},"gpt-5-pro":{"cost":{"input":15,"output":120},"name":"GPT-5 Pro"},"gpt-5.3-codex-spark":{"cost":{"input":1.75,"output":14,"cache_read":0.175},"name":"GPT-5.3 Codex Spark"},"text-embedding-3-large":{"cost":{"input":0.13,"output":0},"name":"text-embedding-3-large"},"gpt-4o-2024-08-06":{"cost":{"input":2.5,"output":10,"cache_read":1.25},"name":"GPT-4o (2024-08-06)"},"gpt-6-astra":{"cost":{"input":10,"output":50,"cache_read":1,"cache_write":12.5,"tiers":[{"input":20,"output":75,"cache_read":2,"cache_write":25,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":20,"output":75,"cache_read":2,"cache_write":25}},"name":"GPT-6 Astra"},"gpt-5.1":{"cost":{"input":1.25,"output":10,"cache_read":0.125},"name":"GPT-5.1"},"gpt-4o-mini":{"cost":{"input":0.15,"output":0.6,"cache_read":0.075},"name":"GPT-4o mini"},"o3-pro":{"cost":{"input":20,"output":80},"name":"o3-pro"},"gpt-5.4-mini":{"cost":{"input":0.75,"output":4.5,"cache_read":0.075},"name":"GPT-5.4 mini"},"gpt-5.6-luna":{"cost":{"input":0.2,"output":1.2,"cache_read":0.02,"cache_write":0.25,"tiers":[{"input":0.4,"output":1.8,"cache_read":0.04,"cache_write":0.5,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":0.4,"output":1.8,"cache_read":0.04,"cache_write":0.5}},"name":"GPT-5.6 Luna"},"gpt-5.2":{"cost":{"input":1.75,"output":14,"cache_read":0.175},"name":"GPT-5.2"},"gpt-5.5":{"cost":{"input":5,"output":30,"cache_read":0.5,"tiers":[{"input":10,"output":45,"cache_read":1,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":10,"output":45,"cache_read":1}},"name":"GPT-5.5"},"gpt-4.1":{"cost":{"input":2,"output":8,"cache_read":0.5},"name":"GPT-4.1"},"gpt-4o-2024-11-20":{"cost":{"input":2.5,"output":10,"cache_read":1.25},"name":"GPT-4o (2024-11-20)"},"gpt-4.1-mini":{"cost":{"input":0.4,"output":1.6,"cache_read":0.1},"name":"GPT-4.1 mini"},"gpt-6-luna":{"cost":{"input":0.1,"output":0.5,"cache_read":0.01,"cache_write":0.125,"tiers":[{"input":0.2,"output":0.75,"cache_read":0.02,"cache_write":0.25,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":0.2,"output":0.75,"cache_read":0.02,"cache_write":0.25}},"name":"GPT-6 Luna"},"gpt-5.3-chat-latest":{"cost":{"input":1.75,"output":14,"cache_read":0.175},"name":"GPT-5.3 Chat (latest)"},"gpt-5.6-terra":{"cost":{"input":2,"output":12,"cache_read":0.2,"cache_write":2.5,"tiers":[{"input":4,"output":18,"cache_read":0.4,"cache_write":5,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":4,"output":18,"cache_read":0.4,"cache_write":5}},"name":"GPT-5.6 Terra"},"gpt-4-turbo":{"cost":{"input":10,"output":30},"name":"GPT-4 Turbo"},"o3":{"cost":{"input":2,"output":8,"cache_read":0.5},"name":"o3"},"gpt-5":{"cost":{"input":1.25,"output":10,"cache_read":0.125},"name":"GPT-5"},"gpt-5.6-sol":{"cost":{"input":4,"output":20,"cache_read":0.4,"cache_write":5,"tiers":[{"input":8,"output":30,"cache_read":0.8,"cache_write":10,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":8,"output":30,"cache_read":0.8,"cache_write":10}},"name":"GPT-5.6 Sol"},"gpt-6-sol":{"cost":{"input":2,"output":10,"cache_read":0.2,"cache_write":2.5,"tiers":[{"input":4,"output":15,"cache_read":0.4,"cache_write":5,"tier":{"type":"context","size":272000}}],"context_over_200k":{"input":4,"output":15,"cache_read":0.4,"cache_write":5}},"name":"GPT-6 Sol"},"o1-pro":{"cost":{"input":150,"output":600},"name":"o1-pro"}}},"anthropic":{"models":{"claude-haiku-4-5":{"cost":{"input":1,"output":5,"cache_read":0.1,"cache_write":1.25},"name":"Claude Haiku 4.5 (latest)"},"claude-opus-4-5":{"cost":{"input":5,"output":25,"cache_read":0.5,"cache_write":6.25},"name":"Claude Opus 4.5 (latest)"},"claude-sonnet-4-5":{"cost":{"input":3,"output":15,"cache_read":0.3,"cache_write":3.75},"name":"Claude Sonnet 4.5 (latest)"},"claude-opus-5-5":{"cost":{"input":4,"output":20,"cache_read":0.2,"cache_write":5},"name":"Claude Opus 5.5"},"claude-fable-5-1":{"cost":{"input":10,"output":50,"cache_read":0.25,"cache_write":12.5},"name":"Claude Fable 5.1"},"claude-opus-4-5-20251101":{"cost":{"input":5,"output":25,"cache_read":0.5,"cache_write":6.25},"name":"Claude Opus 4.5"},"claude-opus-5":{"cost":{"input":5,"output":25,"cache_read":0.5,"cache_write":6.25},"name":"Claude Opus 5"},"claude-fable-5":{"cost":{"input":10,"output":50,"cache_read":1,"cache_write":12.5},"name":"Claude Fable 5"},"claude-opus-4-8":{"cost":{"input":5,"output":25,"cache_read":0.5,"cache_write":6.25},"name":"Claude Opus 4.8"},"claude-sonnet-4-5-20250929":{"cost":{"input":3,"output":15,"cache_read":0.3,"cache_write":3.75},"name":"Claude Sonnet 4.5"},"claude-sonnet-5":{"cost":{"input":2,"output":10,"cache_read":0.2,"cache_write":2.5},"name":"Claude Sonnet 5"},"claude-opus-4-6":{"cost":{"input":5,"output":25,"cache_read":0.5,"cache_write":6.25},"name":"Claude Opus 4.6"},"claude-haiku-4-5-20251001":{"cost":{"input":1,"output":5,"cache_read":0.1,"cache_write":1.25},"name":"Claude Haiku 4.5"},"claude-sonnet-4-6":{"cost":{"input":3,"output":15,"cache_read":0.3,"cache_write":3.75},"name":"Claude Sonnet 4.6"},"claude-opus-4-7":{"cost":{"input":5,"output":25,"cache_read":0.5,"cache_write":6.25},"name":"Claude Opus 4.7"}}},"google":{"models":{"gemini-flash-latest":{"cost":{"input":0.75,"output":3.75,"cache_read":0.075,"input_audio":0.75},"name":"Gemini Flash Latest"},"gemini-omni-flash-preview":{"cost":{"input":1.5,"output":17.5},"name":"Gemini Omni Flash Preview"},"gemini-3.1-flash-image-preview":{"cost":{"input":0.5,"output":60},"name":"Nano Banana 2"},"lyria-3-pro-preview":{"cost":{"input":0,"output":0},"name":"Lyria 3 Pro Preview"},"gemini-3.1-flash-tts-preview":{"cost":{"input":1,"output":20},"name":"Gemini 3.1 Flash TTS Preview"},"gemini-2.5-flash-image":{"cost":{"input":0.3,"output":30,"cache_read":0.075},"name":"Nano Banana"},"gemini-flash-lite-latest":{"cost":{"input":0.3,"output":2.5,"cache_read":0.03},"name":"Gemini Flash-Lite Latest"},"gemini-embedding-2":{"cost":{"input":0.2,"output":0,"input_audio":6.5},"name":"Gemini Embedding 2"},"gemini-3.6-flash":{"cost":{"input":0.75,"output":3.75,"cache_read":0.075,"input_audio":0.75},"name":"Gemini 3.6 Flash"},"gemini-3-pro-image-preview":{"cost":{"input":2,"output":120},"name":"Nano Banana Pro"},"gemini-2.5-pro-preview-tts":{"cost":{"input":1,"output":20},"name":"Gemini 2.5 Pro Preview TTS"},"gemini-3.5-flash-lite":{"cost":{"input":0.3,"output":2.5,"cache_read":0.03},"name":"Gemini 3.5 Flash Lite"},"gemini-3.1-flash-image":{"cost":{"input":0.5,"output":60},"name":"Nano Banana 2"},"lyria-3-clip-preview":{"cost":{"input":0,"output":0},"name":"Lyria 3 Clip Preview"},"gemini-3.1-pro-preview":{"cost":{"input":2,"output":12,"cache_read":0.2,"tiers":[{"input":4,"output":18,"cache_read":0.4,"tier":{"type":"context","size":200000}}],"context_over_200k":{"input":4,"output":18,"cache_read":0.4}},"name":"Gemini 3.1 Pro Preview"},"gemini-2.5-computer-use-preview-10-2025":{"cost":{"input":1.25,"output":10,"tiers":[{"input":2.5,"output":15,"tier":{"type":"context","size":200000}}],"context_over_200k":{"input":2.5,"output":15}},"name":"Gemini 2.5 Computer Use Preview 10-2025"},"gemini-3.5-flash":{"cost":{"input":1.5,"output":9,"cache_read":0.15,"input_audio":1.5},"name":"Gemini 3.5 Flash"},"gemini-2.5-pro":{"cost":{"input":1.25,"output":10,"cache_read":0.125,"tiers":[{"input":2.5,"output":15,"cache_read":0.25,"tier":{"type":"context","size":200000}}],"context_over_200k":{"input":2.5,"output":15,"cache_read":0.25}},"name":"Gemini 2.5 Pro"},"gemini-3-pro-image":{"cost":{"input":2,"output":120},"name":"Nano Banana Pro"},"gemini-2.5-flash":{"cost":{"input":0.3,"output":2.5,"cache_read":0.03,"input_audio":1},"name":"Gemini 2.5 Flash"},"gemini-2.5-flash-preview-tts":{"cost":{"input":0.5,"output":10},"name":"Gemini 2.5 Flash Preview TTS"},"gemini-3.1-flash-lite-image":{"cost":{"input":0.25,"output":30},"name":"Nano Banana 2 Lite"},"deep-research-preview-04-2026":{"cost":{"input":2,"output":12,"cache_read":0.2,"tiers":[{"input":4,"output":18,"cache_read":0.4,"tier":{"type":"context","size":200000}}],"context_over_200k":{"input":4,"output":18,"cache_read":0.4}},"name":"Deep Research Preview (Apr-21-2026)"},"deep-research-max-preview-04-2026":{"cost":{"input":2,"output":12,"cache_read":0.2,"tiers":[{"input":4,"output":18,"cache_read":0.4,"tier":{"type":"context","size":200000}}],"context_over_200k":{"input":4,"output":18,"cache_read":0.4}},"name":"Deep Research Max Preview (Apr-21-2026)"},"gemini-3.7-flash":{"cost":{"input":0.75,"output":3.75,"cache_read":0.075,"input_audio":0.75},"name":"Gemini 3.7 Flash"},"gemini-3.1-pro-preview-customtools":{"cost":{"input":2,"output":12,"cache_read":0.2,"tiers":[{"input":4,"output":18,"cache_read":0.4,"tier":{"type":"context","size":200000}}],"context_over_200k":{"input":4,"output":18,"cache_read":0.4}},"name":"Gemini 3.1 Pro Preview Custom Tools"},"gemini-3-flash-preview":{"cost":{"input":0.5,"output":3,"cache_read":0.05,"input_audio":1},"name":"Gemini 3 Flash Preview"},"gemini-3.8-flash":{"cost":{"input":0.75,"output":3.75,"cache_read":0.075,"input_audio":0.75},"name":"Gemini 3.8 Flash"},"gemini-3.5-live-translate-preview":{"cost":{"input":3.5,"output":21,"input_audio":3.5,"output_audio":21},"name":"Gemini 3.5 Live Translate Preview"},"gemini-2.5-flash-lite":{"cost":{"input":0.1,"output":0.4,"cache_read":0.01,"input_audio":0.3},"name":"Gemini 2.5 Flash-Lite"},"gemini-embedding-001":{"cost":{"input":0.15,"output":0},"name":"Gemini Embedding 001"},"gemini-3.1-flash-lite-preview":{"cost":{"input":0.25,"output":1.5,"cache_read":0.025,"input_audio":0.5},"name":"Gemini 3.1 Flash Lite Preview"},"gemini-3.1-flash-live-preview":{"cost":{"input":0.75,"output":4.5,"input_audio":3,"output_audio":12},"name":"Gemini 3.1 Flash Live Preview"},"gemini-3.1-flash-lite":{"cost":{"input":0.25,"output":1.5,"cache_read":0.025,"input_audio":0.5},"name":"Gemini 3.1 Flash Lite"}}}}

package/dist/pricing/overrides.json

@@ -0,0 +1,4 @@
+{
+  "codex-auto-review": { "unpriced": "bundled reviewer, no list price" },
+  "gpt-reserve": { "unpriced": "bundled with Codex, no list price" }
+}

package/dist/prompt.js

@@ -0,0 +1,61 @@
+import { createInterface } from 'node:readline/promises';
+/** Ask a yes/no question on the TTY. Non-interactive stdin answers "no". */
+export async function confirm(question) {
+    if (!process.stdin.isTTY)
+        return false;
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const a = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
+        return a === 'y' || a === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Minimal line diff (LCS) for showing exactly what an edit changes. */
+export function lineDiff(before, after) {
+    const a = before === '' ? [] : before.replace(/\n$/, '').split('\n');
+    const b = after === '' ? [] : after.replace(/\n$/, '').split('\n');
+    const n = a.length;
+    const m = b.length;
+    const dp = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+    for (let i = n - 1; i >= 0; i--)
+        for (let j = m - 1; j >= 0; j--)
+            dp[i][j] = a[i] === b[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+    const out = [];
+    let i = 0;
+    let j = 0;
+    while (i < n || j < m) {
+        if (i < n && j < m && a[i] === b[j]) {
+            out.push(`  ${a[i]}`);
+            i++;
+            j++;
+        }
+        else if (i < n && (j >= m || dp[i + 1][j] >= dp[i][j + 1])) {
+            out.push(`- ${a[i++]}`);
+        }
+        else {
+            out.push(`+ ${b[j++]}`);
+        }
+    }
+    // Keep 3 lines of context around changes.
+    const keep = new Set();
+    out.forEach((l, k) => {
+        if (l[0] !== ' ')
+            for (let d = -3; d <= 3; d++)
+                keep.add(k + d);
+    });
+    const res = [];
+    let skipped = false;
+    out.forEach((l, k) => {
+        if (keep.has(k)) {
+            res.push(l);
+            skipped = false;
+        }
+        else if (!skipped) {
+            res.push('  …');
+            skipped = true;
+        }
+    });
+    return res.join('\n');
+}

package/dist/report.js

@@ -0,0 +1,186 @@
+import { fmtPrice, fmtTokens, fmtUsd, localDate, table } from './format.js';
+import { inPeriod } from './period.js';
+import { CUSTOM, describeLines, providerMonthly, PROVIDERS, roi, sourceFor, unitPrice } from './plans.js';
+import { cost, resolve, SNAPSHOT_DATE, unpricedNote } from './pricing/index.js';
+import { COUNT_FIELDS } from './types.js';
+const tokensOf = (b) => b.input + b.cache_read + b.cache_write_5m + b.cache_write_1h + b.output;
+function zeroRow() {
+    return {
+        input: 0, cache_read: 0, cache_write_5m: 0, cache_write_1h: 0, output: 0, reasoning: 0,
+        requests: 0, conversations: 0, cost: null, unpriced_tokens: 0,
+    };
+}
+export function buildReport(buckets, period, cfg, by = 'source-model') {
+    const groups = new Map();
+    const unpriced = new Map();
+    const costBySource = new Map();
+    const totals = { ...zeroRow(), cost: 0 };
+    for (const b of buckets) {
+        if (b.source === 'cursor' || !inPeriod(b.ts, period))
+            continue;
+        const day = localDate(Date.parse(b.ts));
+        const key = by === 'model' ? b.model : by === 'source' ? b.source : by === 'day' ? day : `${b.source}|${b.model}`;
+        let row = groups.get(key);
+        if (!row) {
+            row = zeroRow();
+            if (by === 'model')
+                row.model = b.model;
+            else if (by === 'source')
+                row.source = b.source;
+            else if (by === 'day')
+                row.day = day;
+            else {
+                row.source = b.source;
+                row.model = b.model;
+            }
+            groups.set(key, row);
+        }
+        for (const f of COUNT_FIELDS) {
+            row[f] += b[f];
+            totals[f] += b[f];
+        }
+        const rates = resolve(b.model);
+        if (rates) {
+            const c = cost(b, rates);
+            row.cost = (row.cost ?? 0) + c;
+            totals.cost += c;
+            costBySource.set(b.source, (costBySource.get(b.source) ?? 0) + c);
+        }
+        else {
+            const t = tokensOf(b);
+            row.unpriced_tokens += t;
+            totals.unpriced_tokens += t;
+            const uk = `${b.source}|${b.model}`;
+            let u = unpriced.get(uk);
+            if (!u) {
+                const note = unpricedNote(b.model);
+                u = { source: b.source, model: b.model, tokens: 0, ...(note ? { note } : {}) };
+            }
+            u.tokens += t;
+            unpriced.set(uk, u);
+        }
+    }
+    const rows = [...groups.values()].sort((a, b) => {
+        if (by === 'day')
+            return (a.day ?? '') < (b.day ?? '') ? -1 : 1;
+        if (a.source !== b.source)
+            return (a.source ?? '') < (b.source ?? '') ? -1 : 1;
+        return (b.cost ?? -1) - (a.cost ?? -1) || tokensOf(b) - tokensOf(a);
+    });
+    const plans = [];
+    for (const provider of PROVIDERS) {
+        const lines = cfg.plans[provider];
+        if (!lines?.length)
+            continue;
+        const source = sourceFor(provider);
+        const monthly = providerMonthly(provider, lines);
+        const c = costBySource.get(source) ?? 0;
+        plans.push({
+            provider,
+            source,
+            lines: lines.map((l) => ({
+                plan: l.plan,
+                qty: l.qty,
+                monthly: unitPrice(provider, l),
+                ...(l.plan === CUSTOM ? { label: l.label } : {}),
+            })),
+            monthly,
+            api_equiv: c,
+            roi: monthly > 0 ? roi(c, monthly, period.days) : null,
+        });
+    }
+    const excluded = [];
+    if (cfg.sources.cursor?.enabled) {
+        excluded.push({ source: 'cursor', reason: 'token counts not available locally; Cursor is excluded from totals' });
+    }
+    return {
+        period: {
+            label: period.label,
+            since: period.sinceDate,
+            until: period.untilDate,
+            days: period.days,
+            start: period.start.toISOString(),
+            end: period.end.toISOString(),
+        },
+        pricing_snapshot: SNAPSHOT_DATE,
+        by,
+        rows,
+        totals,
+        plans,
+        unpriced: [...unpriced.values()].sort((a, b) => b.tokens - a.tokens),
+        excluded,
+    };
+}
+function costCell(r) {
+    if (r.cost === null)
+        return 'unpriced';
+    return fmtUsd(r.cost) + (r.unpriced_tokens > 0 ? '*' : '');
+}
+export function renderReport(rep) {
+    const out = [];
+    out.push(`tokenmaxxing · ${rep.period.label} · ${rep.period.since} → ${rep.period.until} · pricing snapshot ${rep.pricing_snapshot}`, '');
+    const lead = rep.by === 'model' ? ['MODEL'] : rep.by === 'source' ? ['SOURCE'] : rep.by === 'day' ? ['DAY'] : ['SOURCE', 'MODEL'];
+    const header = [...lead, 'INPUT', 'CACHE R', 'CACHE W', 'OUTPUT', 'API-EQUIV'];
+    const align = [...lead.map(() => 'l'), 'r', 'r', 'r', 'r', 'r'];
+    const body = rep.rows.map((r) => [
+        ...(rep.by === 'model' ? [r.model] : rep.by === 'source' ? [r.source] : rep.by === 'day' ? [r.day] : [r.source, r.model]),
+        fmtTokens(r.input),
+        fmtTokens(r.cache_read),
+        fmtTokens(r.cache_write_5m + r.cache_write_1h),
+        fmtTokens(r.output),
+        costCell(r),
+    ]);
+    if (!body.length) {
+        out.push('No usage in this period.');
+    }
+    else {
+        const lines = table(header, body, align);
+        const width = Math.max(...lines.map((l) => l.length));
+        out.push(...lines);
+        out.push('─'.repeat(width));
+        const t = rep.totals;
+        const totalCells = [
+            'TOTAL',
+            ...lead.slice(1).map(() => ''),
+            fmtTokens(t.input),
+            fmtTokens(t.cache_read),
+            fmtTokens(t.cache_write_5m + t.cache_write_1h),
+            fmtTokens(t.output),
+            fmtUsd(t.cost),
+        ];
+        // Align the TOTAL row with the table's columns.
+        out.push(table(header, [...body, totalCells], align).at(-1));
+    }
+    out.push('');
+    if (!rep.plans.length) {
+        out.push('Plans:  none set (tokenmaxxing plan set <provider> <plan> to see ROI)');
+    }
+    else {
+        const planRows = rep.plans.map((p) => [
+            p.provider,
+            describeLines(p.lines),
+            `= ${fmtPrice(p.monthly)}/mo`,
+            `→ API-equivalent ${fmtUsd(p.api_equiv)}`,
+            p.roi === null ? '' : `→ ROI ${p.roi.toFixed(1)}×`,
+        ]);
+        if (rep.plans.length > 1) {
+            const monthly = Math.round(rep.plans.reduce((s, p) => s + p.monthly, 0) * 100) / 100;
+            const c = rep.plans.reduce((s, p) => s + p.api_equiv, 0);
+            planRows.push(['total', '', `= ${fmtPrice(monthly)}/mo`, `→ API-equivalent ${fmtUsd(c)}`, `→ ROI ${roi(c, monthly, rep.period.days).toFixed(1)}×`]);
+        }
+        table(['', '', '', '', ''], planRows, ['l', 'l', 'l', 'l', 'l'], 2)
+            .slice(1)
+            .forEach((l, i) => out.push((i === 0 ? 'Plans:  ' : '        ') + l));
+    }
+    const up = rep.unpriced.length
+        ? rep.unpriced.map((u) => `${u.source}/${u.model} (${fmtTokens(u.tokens)} tokens${u.note ? ` — ${u.note}` : ''})`).join(', ')
+        : 'none';
+    out.push(`Unpriced models (0 tokens counted toward $): ${up}`);
+    for (const e of rep.excluded)
+        out.push(`${cap(e.source)}: detected — ${e.reason}`);
+    return out.join('\n');
+}
+const cap = (s) => s[0].toUpperCase() + s.slice(1);
+export function reportJson(rep) {
+    return JSON.stringify(rep, null, 2);
+}

package/dist/schedule.js

@@ -0,0 +1,160 @@
+import { execFileSync, spawnSync } from 'node:child_process';
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { isFile } from './fsutil.js';
+import { home, tmxHome } from './paths.js';
+import { confirm, lineDiff } from './prompt.js';
+export const LABEL = 'fyi.tokenmaxxing.sync';
+const CRON_MARK = '# tokenmaxxing sync';
+const INTERVAL_S = 30 * 60;
+function nodeBinDir() {
+    return dirname(process.execPath);
+}
+function npxPath() {
+    const p = join(nodeBinDir(), 'npx');
+    return isFile(p) ? p : 'npx';
+}
+export function plistPath() {
+    return join(home(), 'Library', 'LaunchAgents', `${LABEL}.plist`);
+}
+const esc = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+export function launchdPlist(npx, binDir, tmx, envHome) {
+    const args = [npx, '-y', 'tokenmaxxing-cli', 'sync', '--quiet'];
+    const env = { PATH: `${binDir}:/usr/bin:/bin:/usr/sbin:/sbin` };
+    if (envHome)
+        env.TOKENMAXXING_HOME = envHome;
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${args.map((a) => `    <string>${esc(a)}</string>`).join('\n')}
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+${Object.entries(env)
+        .map(([k, v]) => `    <key>${esc(k)}</key>\n    <string>${esc(v)}</string>`)
+        .join('\n')}
+  </dict>
+  <key>StartInterval</key>
+  <integer>${INTERVAL_S}</integer>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${esc(join(tmx, 'schedule.log'))}</string>
+  <key>StandardErrorPath</key>
+  <string>${esc(join(tmx, 'schedule.log'))}</string>
+</dict>
+</plist>
+`;
+}
+export function cronLine(npx, binDir, envHome) {
+    const envs = [`PATH=${binDir}:/usr/bin:/bin`, ...(envHome ? [`TOKENMAXXING_HOME=${envHome}`] : [])].join(' ');
+    return `*/30 * * * * ${envs} ${npx} -y tokenmaxxing-cli sync --quiet >/dev/null 2>&1 ${CRON_MARK}`;
+}
+function readCrontab() {
+    const r = spawnSync('crontab', ['-l'], { encoding: 'utf8' });
+    return r.status === 0 ? r.stdout : '';
+}
+function writeCrontab(text) {
+    execFileSync('crontab', ['-'], { input: text });
+}
+export async function scheduleCommand(sub, opts, log = console.log) {
+    const envHome = process.env.TOKENMAXXING_HOME;
+    if (process.platform === 'darwin') {
+        const path = plistPath();
+        const exists = isFile(path);
+        if (sub === 'status' || sub === undefined) {
+            log(`launchd agent ${LABEL}: ${exists ? 'installed' : 'not installed'}  (${path})`);
+            if (sub === undefined)
+                log('\nUsage: tokenmaxxing schedule install|uninstall [--yes]');
+            return 0;
+        }
+        const uid = process.getuid?.() ?? 0;
+        if (sub === 'install') {
+            const body = launchdPlist(npxPath(), nodeBinDir(), tmxHome(), envHome);
+            const before = exists ? readFileSync(path, 'utf8') : '';
+            if (before === body) {
+                log(`Already installed: ${path}`);
+                return 0;
+            }
+            log(`Will write ${path} (runs \`tokenmaxxing sync\` every 30 min) and load it with launchctl:\n`);
+            log(lineDiff(before, body));
+            if (!(opts.yes || (await confirm('Install?')))) {
+                log('Nothing was changed. Re-run with --yes to apply.');
+                return 1;
+            }
+            mkdirSync(dirname(path), { recursive: true });
+            mkdirSync(tmxHome(), { recursive: true });
+            if (exists)
+                spawnSync('launchctl', ['bootout', `gui/${uid}`, path], { stdio: 'ignore' });
+            writeFileSync(path, body);
+            const r = spawnSync('launchctl', ['bootstrap', `gui/${uid}`, path], { encoding: 'utf8' });
+            if (r.status !== 0)
+                log(`launchctl bootstrap failed (${(r.stderr || '').trim()}); the agent will load at next login.`);
+            log(`Installed ${path}`);
+            return 0;
+        }
+        if (sub === 'uninstall') {
+            if (!exists) {
+                log('Not installed.');
+                return 0;
+            }
+            if (!(opts.yes || (await confirm(`Unload and delete ${path}?`)))) {
+                log('Nothing was changed. Re-run with --yes to apply.');
+                return 1;
+            }
+            spawnSync('launchctl', ['bootout', `gui/${uid}`, path], { stdio: 'ignore' });
+            rmSync(path, { force: true });
+            log(`Removed ${path}`);
+            return 0;
+        }
+    }
+    else if (process.platform === 'linux') {
+        const current = readCrontab();
+        const has = current.split('\n').some((l) => l.includes(CRON_MARK));
+        if (sub === 'status' || sub === undefined) {
+            log(`cron entry: ${has ? 'installed' : 'not installed'}`);
+            return 0;
+        }
+        let next;
+        if (sub === 'install') {
+            if (has) {
+                log('Already installed.');
+                return 0;
+            }
+            next = (current && !current.endsWith('\n') ? current + '\n' : current) + cronLine(npxPath(), nodeBinDir(), envHome) + '\n';
+        }
+        else if (sub === 'uninstall') {
+            if (!has) {
+                log('Not installed.');
+                return 0;
+            }
+            next = current
+                .split('\n')
+                .filter((l) => !l.includes(CRON_MARK))
+                .join('\n');
+        }
+        else {
+            log('Usage: tokenmaxxing schedule install|uninstall [--yes]');
+            return 1;
+        }
+        log('crontab change:\n' + lineDiff(current, next));
+        if (!(opts.yes || (await confirm('Apply?')))) {
+            log('Nothing was changed. Re-run with --yes to apply.');
+            return 1;
+        }
+        writeCrontab(next);
+        log(sub === 'install' ? 'Installed cron entry.' : 'Removed cron entry.');
+        return 0;
+    }
+    else {
+        log(`schedule is supported on macOS (launchd) and Linux (cron); on ${process.platform} use your OS scheduler to run \`npx -y tokenmaxxing-cli sync --quiet\` every 30 minutes.`);
+        return 1;
+    }
+    log('Usage: tokenmaxxing schedule install|uninstall [--yes]');
+    return 1;
+}

package/dist/site.js

@@ -0,0 +1,196 @@
+import { randomBytes } from 'node:crypto';
+import { saveConfig, siteUrl } from './config.js';
+import { cleanRow, loadBuckets, sortRows } from './store.js';
+export const PUSH_BATCH = 5000;
+const ALPHABET = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789'; // no I, O, 0, 1
+export function linkCode() {
+    const bytes = randomBytes(8);
+    let s = '';
+    for (const b of bytes)
+        s += ALPHABET[b % ALPHABET.length];
+    return s;
+}
+function describeNetError(e, url) {
+    const err = e;
+    const code = err?.cause?.code ?? err?.code;
+    if (code === 'ECONNREFUSED')
+        return `could not connect to ${url} (connection refused). Is the site running? Use --site to point elsewhere.`;
+    if (code === 'ENOTFOUND' || code === 'EAI_AGAIN')
+        return `could not resolve ${new URL(url).host}. Check your network or use --site.`;
+    if (err?.name === 'TimeoutError' || err?.name === 'AbortError')
+        return `request to ${url} timed out.`;
+    return `request to ${url} failed: ${err?.cause?.message ?? err?.message ?? String(e)}`;
+}
+export class SiteError extends Error {
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** Print the sign-in URL, poll the site until it hands back { token, handle }, store both. */
+export async function link(cfg, opts = {}) {
+    const log = opts.log ?? console.log;
+    const site = siteUrl(cfg, opts.site);
+    const interval = opts.intervalMs ?? Number(process.env.TOKENMAXXING_POLL_MS ?? 3000);
+    const timeout = opts.timeoutMs ?? 5 * 60 * 1000;
+    const code = linkCode();
+    log(`Open ${site}/link?code=${code} and sign in`);
+    log(`Waiting for the site to confirm (polling ${site}/api/v1/link/${code} every ${Math.round(interval / 1000)}s, up to ${Math.round(timeout / 60000)} min)…`);
+    const deadline = Date.now() + timeout;
+    const url = `${site}/api/v1/link/${code}`;
+    while (Date.now() < deadline) {
+        let res;
+        try {
+            res = await fetch(url, { headers: { accept: 'application/json' }, signal: AbortSignal.timeout(15000) });
+        }
+        catch (e) {
+            throw new SiteError(describeNetError(e, url));
+        }
+        if (res.status === 404) {
+            throw new SiteError(`${site} has no link endpoint yet (GET /api/v1/link/{code} returned 404). The site may not be live; nothing was stored.`);
+        }
+        if (res.ok && res.status !== 202 && res.status !== 204) {
+            let body = null;
+            try {
+                body = await res.json();
+            }
+            catch {
+                /* not json yet */
+            }
+            if (body && typeof body.token === 'string' && body.token) {
+                cfg.site = { ...cfg.site, url: site, token: body.token, handle: typeof body.handle === 'string' ? body.handle : undefined };
+                saveConfig(cfg);
+                log(`Linked${cfg.site.handle ? ` as @${cfg.site.handle}` : ''}. Run \`tokenmaxxing push\` to publish your buckets.`);
+                return { handle: cfg.site.handle };
+            }
+        }
+        else if (!res.ok) {
+            throw new SiteError(`${url} returned HTTP ${res.status}.`);
+        }
+        await sleep(interval);
+    }
+    throw new SiteError('Timed out waiting for sign-in (5 min). Run `tokenmaxxing link` again.');
+}
+/** Start of the period containing an hourly ts: the hour itself, 00:00 UTC, or Monday 00:00 UTC. */
+export function periodStart(ts, g) {
+    if (g === 'hour')
+        return ts;
+    const d = new Date(ts);
+    d.setUTCHours(0, 0, 0, 0);
+    if (g === 'week')
+        d.setUTCDate(d.getUTCDate() - ((d.getUTCDay() + 6) % 7));
+    return d.toISOString().replace('.000Z', 'Z');
+}
+/** Sum hourly rows into one row per (period, source, model). Hour is the identity. */
+export function foldRows(rows, g) {
+    if (g === 'hour')
+        return rows;
+    const out = new Map();
+    for (const r of rows) {
+        const ts = periodStart(r.ts, g);
+        const k = `${ts}|${r.source}|${r.model}`;
+        const cur = out.get(k);
+        if (!cur) {
+            out.set(k, { ...r, ts });
+            continue;
+        }
+        for (const f of ['input', 'cache_read', 'cache_write_5m', 'cache_write_1h', 'output', 'reasoning', 'requests', 'conversations']) {
+            cur[f] += r[f];
+        }
+    }
+    return sortRows([...out.values()]);
+}
+/**
+ * Rows to send: the current (last-per-key) row for every hour at or after lastPushedTs, folded to
+ * the chosen granularity. The whole period containing lastPushedTs is resent so a partial day or
+ * week is replaced by its complete total on the next push.
+ */
+export function planPush(all, lastPushedTs, granularity = 'hour') {
+    const floor = lastPushedTs ? periodStart(lastPushedTs, granularity) : undefined;
+    const hourly = sortRows([...all].filter((r) => r.source !== 'cursor' && (!floor || r.ts >= floor))).map(cleanRow);
+    const rows = foldRows(hourly, granularity);
+    const batches = [];
+    for (let i = 0; i < rows.length; i += PUSH_BATCH)
+        batches.push(rows.slice(i, i + PUSH_BATCH));
+    return { rows, batches, from: rows[0]?.ts, to: rows.at(-1)?.ts, maxHourlyTs: hourly.at(-1)?.ts, granularity };
+}
+export async function push(cfg, opts = {}) {
+    const log = opts.log ?? console.log;
+    const site = siteUrl(cfg, opts.site);
+    if (!cfg.site.token && !opts.dryRun) {
+        throw new SiteError('Not linked. Run `tokenmaxxing link` first.');
+    }
+    const { rows } = await loadBuckets();
+    const granularity = opts.granularity ?? cfg.site.granularity ?? 'hour';
+    if (opts.granularity && opts.granularity !== cfg.site.granularity) {
+        cfg.site.granularity = opts.granularity;
+        saveConfig(cfg);
+    }
+    // Changing granularity (or --all) replaces everything the site holds for this device.
+    const replace = opts.all || (cfg.site.lastPushedGranularity ?? 'hour') !== granularity;
+    const plan = planPush(rows.values(), replace ? undefined : cfg.site.lastPushedTs, granularity);
+    let earliestRejected;
+    if (!plan.rows.length) {
+        log('Nothing to push.');
+        return 0;
+    }
+    const url = `${site}/api/v1/push`;
+    log(`${opts.dryRun ? 'Would send' : 'Sending'} ${plan.rows.length} bucket row${plan.rows.length === 1 ? '' : 's'} (${plan.from} → ${plan.to}) in ${plan.batches.length} request${plan.batches.length === 1 ? '' : 's'} to POST ${url}`);
+    log(`Granularity: ${granularity}${granularity === 'hour' ? '' : ' (rows are ' + granularity + 'ly totals; the site never sees your hours)'}${replace ? ' — replacing every row the site holds for this device' : ''}.`);
+    log(`Each request body is exactly: { "v": 1, "deviceId": "${cfg.deviceId}", "granularity": "${granularity}"${replace ? ', "replaceDevice": true (first request only)' : ''}, "rows": [ …up to ${PUSH_BATCH} rows… ] }`);
+    log(`Row fields: v, ts, source, model, input, cache_read, cache_write_5m, cache_write_1h, output, reasoning, requests, conversations. No paths, projects or prompts.`);
+    log(`First row: ${JSON.stringify(plan.rows[0])}`);
+    if (opts.dryRun) {
+        plan.batches.forEach((b, i) => log(JSON.stringify({ v: 1, deviceId: cfg.deviceId, granularity, ...(replace && i === 0 ? { replaceDevice: true } : {}), rows: b })));
+        return 0;
+    }
+    log('(run `tokenmaxxing push --dry-run` to print every row without sending)');
+    let sent = 0;
+    for (const [bi, batch] of plan.batches.entries()) {
+        let res;
+        try {
+            res = await fetch(url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.site.token}` },
+                body: JSON.stringify({ v: 1, deviceId: cfg.deviceId, granularity, ...(replace && bi === 0 ? { replaceDevice: true } : {}), rows: batch }),
+                signal: AbortSignal.timeout(60000),
+            });
+        }
+        catch (e) {
+            throw new SiteError(describeNetError(e, url));
+        }
+        if (res.status === 404)
+            throw new SiteError(`${site} has no push endpoint yet (POST /api/v1/push returned 404). The site may not be live.`);
+        if (res.status === 401 || res.status === 403)
+            throw new SiteError(`${site} rejected the token (HTTP ${res.status}). Run \`tokenmaxxing link\` again.`);
+        if (!res.ok)
+            throw new SiteError(`${url} returned HTTP ${res.status}.`);
+        let body = null;
+        try {
+            body = await res.json();
+        }
+        catch {
+            /* no body */
+        }
+        const rejected = Array.isArray(body?.rejected) ? body.rejected : [];
+        if (rejected.length) {
+            log(`Site rejected ${rejected.length} of ${batch.length} rows in this batch (kept the rest):`);
+            for (const r of rejected.slice(0, 5))
+                log(`  ${JSON.stringify(r)}`);
+            if (rejected.length > 5)
+                log(`  …and ${rejected.length - 5} more`);
+            for (const r of rejected) {
+                const row = typeof r.index === 'number' ? batch[r.index] : undefined;
+                if (row && (!earliestRejected || row.ts < earliestRejected))
+                    earliestRejected = row.ts;
+            }
+        }
+        sent += batch.length - rejected.length;
+        // Never advance the high-water mark past a rejected period, so the next push retries it.
+        const mark = bi === plan.batches.length - 1 ? (plan.maxHourlyTs ?? batch.at(-1).ts) : batch.at(-1).ts;
+        cfg.site.lastPushedTs = earliestRejected && earliestRejected < mark ? earliestRejected : mark;
+        cfg.site.lastPushedGranularity = granularity;
+        saveConfig(cfg);
+    }
+    if (earliestRejected)
+        log(`Some rows were rejected; the next push retries from ${earliestRejected}. Run \`tokenmaxxing push --all\` to resend everything.`);
+    log(`Pushed ${sent} rows.`);
+    return sent;
+}