nomoreide 0.1.64 → 0.1.65

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

@@ -0,0 +1,81 @@
+/**
+ * Minimal shape this store needs from a usage reading. The web layer's
+ * `UsageInfo` is structurally assignable to it, so core never imports the web
+ * layer (no dependency cycle).
+ */
+export interface UsageSnapshotInput {
+    claude?: {
+        sessionId?: string;
+        costUSD: number;
+        inputTokens: number;
+        outputTokens: number;
+        models?: Array<{
+            model: string;
+        }>;
+    };
+    codex?: {
+        timestamp?: string;
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+}
+export type UsageSource = "claude" | "codex";
+export interface UsageHistoryEntry {
+    at: string;
+    source: UsageSource;
+    /** Claude: the agent session id. Codex: the reading's source timestamp. */
+    sessionId?: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    /** Real per-session cost for Claude; 0 for Codex (no honest price available). */
+    costUSD: number;
+    models?: string[];
+}
+export interface UsageDayBucket {
+    date: string;
+    costUSD: number;
+    runs: number;
+    totalTokens: number;
+}
+export interface UsageHistorySummary {
+    /** Distinct Claude sessions recorded — i.e. agent runs. */
+    runs: number;
+    totalCostUSD: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalTokens: number;
+    firstAt?: string;
+    lastAt?: string;
+    byDay: UsageDayBucket[];
+    /** Latest cumulative Codex token total (Codex reports lifetime totals, not per-run). */
+    codexTotalTokens: number;
+}
+/**
+ * Append-only token/cost history at `.nomoreide/usage-history.jsonl`. A sampler
+ * calls {@link record} with the latest usage reading; a row is appended only
+ * when a source's totals actually change, so an idle agent doesn't grow the file
+ * each tick. Claude's `costUSD` is a real per-session figure (it resets and the
+ * session id changes on a new run), so the summary groups by session to answer
+ * "this work cost ~$X over N runs".
+ */
+export declare class UsageHistory {
+    private readonly filePath;
+    private seeded;
+    private readonly lastKey;
+    constructor(options: {
+        filePath: string;
+    });
+    /** Append a row per source whose totals changed since the last recorded row. */
+    record(input: UsageSnapshotInput): Promise<UsageHistoryEntry[]>;
+    list(options?: {
+        since?: string;
+    }): Promise<UsageHistoryEntry[]>;
+    summary(options?: {
+        since?: string;
+    }): Promise<UsageHistorySummary>;
+    /** Prime dedup keys from the last recorded row per source so a restart doesn't re-append. */
+    private seed;
+    private loadEntries;
+}

package/dist/core/usage-history.js

@@ -0,0 +1,149 @@
+import { appendFile, mkdir, readFile } from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * Append-only token/cost history at `.nomoreide/usage-history.jsonl`. A sampler
+ * calls {@link record} with the latest usage reading; a row is appended only
+ * when a source's totals actually change, so an idle agent doesn't grow the file
+ * each tick. Claude's `costUSD` is a real per-session figure (it resets and the
+ * session id changes on a new run), so the summary groups by session to answer
+ * "this work cost ~$X over N runs".
+ */
+export class UsageHistory {
+    filePath;
+    seeded = false;
+    lastKey = {};
+    constructor(options) {
+        this.filePath = options.filePath;
+    }
+    /** Append a row per source whose totals changed since the last recorded row. */
+    async record(input) {
+        if (!this.seeded)
+            await this.seed();
+        const at = new Date().toISOString();
+        const candidates = [];
+        if (input.claude && hasClaudeData(input.claude)) {
+            candidates.push({
+                at,
+                source: "claude",
+                sessionId: input.claude.sessionId,
+                inputTokens: input.claude.inputTokens,
+                outputTokens: input.claude.outputTokens,
+                totalTokens: input.claude.inputTokens + input.claude.outputTokens,
+                costUSD: input.claude.costUSD,
+                models: input.claude.models?.map((m) => m.model),
+            });
+        }
+        if (input.codex && input.codex.totalTokens > 0) {
+            candidates.push({
+                at,
+                source: "codex",
+                sessionId: input.codex.timestamp,
+                inputTokens: input.codex.inputTokens,
+                outputTokens: input.codex.outputTokens,
+                totalTokens: input.codex.totalTokens,
+                costUSD: 0,
+            });
+        }
+        const appended = [];
+        for (const entry of candidates) {
+            const key = entryKey(entry);
+            if (this.lastKey[entry.source] === key)
+                continue;
+            this.lastKey[entry.source] = key;
+            appended.push(entry);
+        }
+        if (appended.length > 0) {
+            await mkdir(dirname(this.filePath), { recursive: true });
+            await appendFile(this.filePath, `${appended.map((e) => JSON.stringify(e)).join("\n")}\n`);
+        }
+        return appended;
+    }
+    async list(options = {}) {
+        const entries = await this.loadEntries();
+        const since = options.since;
+        return since ? entries.filter((entry) => entry.at >= since) : entries;
+    }
+    async summary(options = {}) {
+        const entries = await this.list(options);
+        const codex = entries.filter((e) => e.source === "codex");
+        // Each Claude session contributes its final (max-cost) snapshot once.
+        const bySession = new Map();
+        for (const entry of entries) {
+            if (entry.source !== "claude")
+                continue;
+            const key = entry.sessionId ?? entry.at;
+            const prev = bySession.get(key);
+            if (!prev || entry.costUSD >= prev.costUSD)
+                bySession.set(key, entry);
+        }
+        const sessions = [...bySession.values()];
+        let totalCostUSD = 0;
+        let totalInputTokens = 0;
+        let totalOutputTokens = 0;
+        let totalTokens = 0;
+        const dayMap = new Map();
+        for (const session of sessions) {
+            totalCostUSD += session.costUSD;
+            totalInputTokens += session.inputTokens;
+            totalOutputTokens += session.outputTokens;
+            totalTokens += session.totalTokens;
+            const date = session.at.slice(0, 10);
+            const bucket = dayMap.get(date) ?? { date, costUSD: 0, runs: 0, totalTokens: 0 };
+            bucket.costUSD += session.costUSD;
+            bucket.runs += 1;
+            bucket.totalTokens += session.totalTokens;
+            dayMap.set(date, bucket);
+        }
+        const ats = entries.map((e) => e.at).sort();
+        return {
+            runs: sessions.length,
+            totalCostUSD,
+            totalInputTokens,
+            totalOutputTokens,
+            totalTokens,
+            firstAt: ats[0],
+            lastAt: ats[ats.length - 1],
+            byDay: [...dayMap.values()].sort((a, b) => a.date.localeCompare(b.date)),
+            codexTotalTokens: codex.length > 0 ? Math.max(...codex.map((e) => e.totalTokens)) : 0,
+        };
+    }
+    /** Prime dedup keys from the last recorded row per source so a restart doesn't re-append. */
+    async seed() {
+        this.seeded = true;
+        for (const entry of await this.loadEntries()) {
+            this.lastKey[entry.source] = entryKey(entry);
+        }
+    }
+    async loadEntries() {
+        let raw;
+        try {
+            raw = await readFile(this.filePath, "utf8");
+        }
+        catch {
+            return [];
+        }
+        const entries = [];
+        for (const line of raw.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                entries.push(JSON.parse(trimmed));
+            }
+            catch {
+                // skip a corrupt line
+            }
+        }
+        return entries;
+    }
+}
+function hasClaudeData(claude) {
+    return claude.costUSD > 0 || claude.inputTokens > 0 || claude.outputTokens > 0;
+}
+function entryKey(entry) {
+    if (entry.source === "codex") {
+        return `codex:${entry.sessionId ?? ""}:${entry.totalTokens}`;
+    }
+    return `claude:${entry.sessionId ?? ""}:${entry.costUSD}:${entry.inputTokens}:${entry.outputTokens}`;
+}
+//# 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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"}