@loompad/cli 0.1.0 → 1.1.1

package/dist/core/turn-stats.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Turns, read straight off the event log: who ran how many, how often they
+ * finished without an error, how long a turn takes, what one costs — and the
+ * same turns day by day and row by row. Nothing estimated: every number is
+ * a field an agent's own CLI reported on run_complete (or an error event).
+ */
+import type { LoomEvent } from "../types.js";
+export interface TurnRow {
+    id: number;
+    ts: number;
+    agentId: string;
+    chat: string;
+    ok: boolean;
+    durationMs?: number;
+    costUsd?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    model?: string;
+    error?: string;
+}
+export interface AgentStanding {
+    agentId: string;
+    turns: number;
+    ok: number;
+    errors: number;
+    successRate: number;
+    medianMs: number | null;
+    avgCostUsd: number | null;
+    totalCostUsd: number;
+    tokens: number;
+}
+export interface DayCount {
+    date: string;
+    turns: number;
+    errors: number;
+    costUsd: number;
+}
+export declare function turnRows(events: LoomEvent[]): TurnRow[];
+/** Agents ranked by how reliably they finish, then by how many turns they've run. */
+export declare function leaderboard(rows: TurnRow[]): AgentStanding[];
+/**
+ * Trust: how often an agent's "done" held up. Read from what Loom checked —
+ * Proof's verdicts on its turns (verified / didn't hold / unverified), the
+ * loop watch catching it in circles, the shield catching a command that can't
+ * be taken back. Cost per verified "done" is its spend over the checks that
+ * held: what a result you can trust costs from this agent.
+ */
+export interface Trust {
+    verified: number;
+    contradicted: number;
+    unverified: number;
+    /** verified / (verified + contradicted); null until something was checked either way. */
+    holdRate: number | null;
+    loops: number;
+    shield: number;
+}
+export declare function trustByAgent(events: LoomEvent[]): Record<string, Trust>;
+/** The last `days` days, oldest first, every day present (zeros included). */
+export declare function perDay(rows: TurnRow[], days: number, now?: number): DayCount[];
+/** One row per turn, for a spreadsheet. */
+export declare function turnsCsv(rows: TurnRow[]): string;

package/dist/core/turn-stats.js

@@ -0,0 +1,124 @@
+/**
+ * Turns, read straight off the event log: who ran how many, how often they
+ * finished without an error, how long a turn takes, what one costs — and the
+ * same turns day by day and row by row. Nothing estimated: every number is
+ * a field an agent's own CLI reported on run_complete (or an error event).
+ */
+const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : undefined);
+export function turnRows(events) {
+    const rows = [];
+    for (const e of events) {
+        if (!e.agentId || (e.kind !== "run_complete" && e.kind !== "error"))
+            continue;
+        const p = e.payload;
+        const row = { id: e.id, ts: e.ts, agentId: e.agentId, chat: e.chat ?? "main", ok: e.kind === "run_complete" };
+        const d = num(p.durationMs), c = num(p.costUsd), ti = num(p.inputTokens), to = num(p.outputTokens);
+        if (d !== undefined)
+            row.durationMs = d;
+        if (c !== undefined)
+            row.costUsd = c;
+        if (ti !== undefined)
+            row.inputTokens = ti;
+        if (to !== undefined)
+            row.outputTokens = to;
+        if (typeof p.model === "string")
+            row.model = p.model;
+        if (!row.ok)
+            row.error = String(p.message ?? p.error ?? "error").split("\n")[0].slice(0, 300);
+        rows.push(row);
+    }
+    return rows;
+}
+function median(xs) {
+    if (!xs.length)
+        return null;
+    const s = [...xs].sort((a, b) => a - b);
+    const mid = Math.floor(s.length / 2);
+    return s.length % 2 ? s[mid] : Math.round((s[mid - 1] + s[mid]) / 2);
+}
+/** Agents ranked by how reliably they finish, then by how many turns they've run. */
+export function leaderboard(rows) {
+    const by = new Map();
+    for (const r of rows)
+        by.set(r.agentId, [...(by.get(r.agentId) ?? []), r]);
+    const out = [];
+    for (const [agentId, rs] of by) {
+        const ok = rs.filter((r) => r.ok);
+        const costs = ok.map((r) => r.costUsd).filter((c) => c !== undefined);
+        const total = costs.reduce((a, b) => a + b, 0);
+        out.push({
+            agentId,
+            turns: rs.length,
+            ok: ok.length,
+            errors: rs.length - ok.length,
+            successRate: rs.length ? ok.length / rs.length : 0,
+            medianMs: median(ok.map((r) => r.durationMs).filter((d) => d !== undefined)),
+            avgCostUsd: costs.length ? total / costs.length : null,
+            totalCostUsd: total,
+            tokens: rs.reduce((a, r) => a + (r.inputTokens ?? 0) + (r.outputTokens ?? 0), 0),
+        });
+    }
+    return out.sort((a, b) => b.successRate - a.successRate || b.turns - a.turns || a.agentId.localeCompare(b.agentId));
+}
+export function trustByAgent(events) {
+    const out = {};
+    const of = (id) => (out[id] ??= { verified: 0, contradicted: 0, unverified: 0, holdRate: null, loops: 0, shield: 0 });
+    for (const e of events) {
+        const p = e.payload;
+        if (e.kind === "proof" && typeof p.about === "string" && p.about) {
+            const t = of(p.about);
+            if (p.verdict === "verified")
+                t.verified++;
+            else if (p.verdict === "contradicted")
+                t.contradicted++;
+            else
+                t.unverified++;
+        }
+        else if (e.kind === "status" && e.agentId && p.state === "loop_detected")
+            of(e.agentId).loops++;
+        else if (e.kind === "status" && e.agentId && p.state === "shield_tripped")
+            of(e.agentId).shield++;
+    }
+    for (const t of Object.values(out))
+        t.holdRate = t.verified + t.contradicted ? t.verified / (t.verified + t.contradicted) : null;
+    return out;
+}
+function dayKey(ts) {
+    const d = new Date(ts);
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+/** The last `days` days, oldest first, every day present (zeros included). */
+export function perDay(rows, days, now = Date.now()) {
+    const map = new Map();
+    const start = new Date(now);
+    start.setHours(0, 0, 0, 0);
+    for (let i = days - 1; i >= 0; i--) {
+        const d = new Date(start);
+        d.setDate(d.getDate() - i);
+        const k = dayKey(d.getTime());
+        map.set(k, { date: k, turns: 0, errors: 0, costUsd: 0 });
+    }
+    for (const r of rows) {
+        const c = map.get(dayKey(r.ts));
+        if (!c)
+            continue;
+        c.turns++;
+        if (!r.ok)
+            c.errors++;
+        c.costUsd += r.costUsd ?? 0;
+    }
+    return [...map.values()];
+}
+const csvCell = (v) => {
+    const s = v === undefined || v === null ? "" : String(v);
+    return /[",\n\r]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+};
+/** One row per turn, for a spreadsheet. */
+export function turnsCsv(rows) {
+    const head = ["time", "agent", "chat", "ok", "duration_ms", "cost_usd", "input_tokens", "output_tokens", "model", "error"];
+    const lines = rows.map((r) => [new Date(r.ts).toISOString(), r.agentId, r.chat, r.ok ? "yes" : "no", r.durationMs, r.costUsd, r.inputTokens, r.outputTokens, r.model, r.error]
+        .map(csvCell)
+        .join(","));
+    return [head.join(","), ...lines].join("\n") + "\n";
+}
+//# sourceMappingURL=turn-stats.js.map

package/dist/core/turn-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-stats.js","sourceRoot":"","sources":["../../src/core/turn-stats.ts"],"names":[],"mappings":"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"}

package/dist/core/updater.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Is there a newer Loom, and can this copy fetch it?
+ *
+ * Two questions, and they have different answers depending on how Loom got
+ * here. A git checkout pulls and rebuilds; a global npm install reinstalls
+ * itself from the same spec it came from; anything else (a packaged desktop
+ * app, a copied folder) is told plainly to download the release rather than
+ * having a command guessed at and run over it.
+ *
+ * Nothing here decides on its own to upgrade. `check` looks, `plan` says what
+ * would happen in the exact words of the command, and the daemon runs it only
+ * when someone asks.
+ */
+export type InstallKind = "git" | "npm-global" | "unknown";
+export interface Release {
+    /** The tag without its leading v — comparable with VERSION. */
+    version: string;
+    tag: string;
+    url: string;
+    publishedAt: string | null;
+}
+export interface UpdatePlan {
+    /** What this copy is, and so what updating it means. */
+    install: InstallKind;
+    /** The directory the commands run in (a checkout, or the global prefix). */
+    cwd: string | null;
+    /** Each step, in the words that will be run — nothing hidden. */
+    steps: Array<{
+        cmd: string;
+        args: string[];
+    }>;
+    /** Null when we can update; otherwise why we won't try. */
+    refusal: string | null;
+}
+/** The repository releases are read from. Overridable for testing and forks. */
+export declare const RELEASES_REPO: string;
+/** How long a release check is trusted, so a background poll can't hammer the API. */
+export declare const CHECK_TTL_MS: number;
+/**
+ * Semver-ish comparison, enough for `v0.2.10` > `v0.2.9` and prereleases
+ * sorting under their release. Unknown shapes compare as equal, which means
+ * "no update" — the safe direction.
+ */
+export declare function newerThan(a: string, b: string): boolean;
+/** The newest published release, or null when the network or the repo says nothing. */
+export declare function latestRelease(fetchImpl?: typeof fetch, repo?: string): Promise<Release | null>;
+/**
+ * How this copy of Loom was installed, from where its own code sits.
+ *
+ * A checkout has a .git above it. A global npm install lives under a
+ * node_modules whose package.json is ours. Everything else is unknown, and
+ * unknown is a fine answer — it just means we don't run anything.
+ */
+export declare function detectInstall(moduleDir: string): {
+    kind: InstallKind;
+    cwd: string | null;
+    spec?: string;
+};
+/** What updating this copy would actually run. */
+export declare function plan(install: {
+    kind: InstallKind;
+    cwd: string | null;
+    spec?: string;
+}): UpdatePlan;
+/**
+ * A git checkout with uncommitted work is yours, not ours to move.
+ *
+ * Modified tracked files only. Untracked ones don't stop a fast-forward —
+ * refusing over a stray scratch file or a symlinked node_modules would block
+ * the update for something git is perfectly happy with. (If an untracked file
+ * would actually be overwritten, git itself refuses and that error is shown.)
+ */
+export declare function refuseDirtyCheckout(status: string): string | null;

package/dist/core/updater.js

@@ -0,0 +1,153 @@
+/**
+ * Is there a newer Loom, and can this copy fetch it?
+ *
+ * Two questions, and they have different answers depending on how Loom got
+ * here. A git checkout pulls and rebuilds; a global npm install reinstalls
+ * itself from the same spec it came from; anything else (a packaged desktop
+ * app, a copied folder) is told plainly to download the release rather than
+ * having a command guessed at and run over it.
+ *
+ * Nothing here decides on its own to upgrade. `check` looks, `plan` says what
+ * would happen in the exact words of the command, and the daemon runs it only
+ * when someone asks.
+ */
+import fs from "node:fs";
+import path from "node:path";
+/** The repository releases are read from. Overridable for testing and forks. */
+export const RELEASES_REPO = process.env.LOOM_RELEASES_REPO || "nickthelegend/loom";
+/** How long a release check is trusted, so a background poll can't hammer the API. */
+export const CHECK_TTL_MS = 6 * 60 * 60_000;
+/**
+ * Semver-ish comparison, enough for `v0.2.10` > `v0.2.9` and prereleases
+ * sorting under their release. Unknown shapes compare as equal, which means
+ * "no update" — the safe direction.
+ */
+export function newerThan(a, b) {
+    const parse = (v) => {
+        const m = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(v.trim());
+        return m ? { nums: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] ?? null } : null;
+    };
+    const x = parse(a);
+    const y = parse(b);
+    if (!x || !y)
+        return false;
+    for (let i = 0; i < 3; i++) {
+        if (x.nums[i] !== y.nums[i])
+            return x.nums[i] > y.nums[i];
+    }
+    // 1.0.0 is newer than 1.0.0-rc1; two prereleases compare as strings.
+    if (x.pre === y.pre)
+        return false;
+    if (!x.pre)
+        return true;
+    if (!y.pre)
+        return false;
+    return x.pre > y.pre;
+}
+/** The newest published release, or null when the network or the repo says nothing. */
+export async function latestRelease(fetchImpl = fetch, repo = RELEASES_REPO) {
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), 8000);
+    try {
+        const res = await fetchImpl(`https://api.github.com/repos/${repo}/releases/latest`, {
+            signal: ctl.signal,
+            headers: { accept: "application/vnd.github+json", "user-agent": "loom-updater" },
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        if (!body.tag_name || body.draft)
+            return null;
+        return {
+            version: body.tag_name.replace(/^v/, ""),
+            tag: body.tag_name,
+            url: body.html_url ?? `https://github.com/${repo}/releases/tag/${body.tag_name}`,
+            publishedAt: body.published_at ?? null,
+        };
+    }
+    catch {
+        // offline, rate-limited, a repo with no releases: not an error, just no answer
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * How this copy of Loom was installed, from where its own code sits.
+ *
+ * A checkout has a .git above it. A global npm install lives under a
+ * node_modules whose package.json is ours. Everything else is unknown, and
+ * unknown is a fine answer — it just means we don't run anything.
+ */
+export function detectInstall(moduleDir) {
+    let dir = moduleDir;
+    for (let i = 0; i < 8; i++) {
+        if (fs.existsSync(path.join(dir, ".git")))
+            return { kind: "git", cwd: dir };
+        // .../lib/node_modules/@loompad/cli/dist → the package root holds package.json
+        const pkgFile = path.join(dir, "package.json");
+        if (fs.existsSync(pkgFile)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
+                if (pkg.name && dir.includes(`${path.sep}node_modules${path.sep}`)) {
+                    return { kind: "npm-global", cwd: dir, spec: `github:${RELEASES_REPO}` };
+                }
+            }
+            catch {
+                /* a package.json we can't read tells us nothing */
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return { kind: "unknown", cwd: null };
+}
+/** What updating this copy would actually run. */
+export function plan(install) {
+    if (install.kind === "git" && install.cwd) {
+        return {
+            install: "git",
+            cwd: install.cwd,
+            steps: [
+                { cmd: "git", args: ["pull", "--ff-only"] },
+                { cmd: "npm", args: ["install", "--no-audit", "--no-fund"] },
+                { cmd: "npm", args: ["run", "build"] },
+            ],
+            refusal: null,
+        };
+    }
+    if (install.kind === "npm-global") {
+        return {
+            install: "npm-global",
+            cwd: install.cwd,
+            steps: [{ cmd: "npm", args: ["install", "-g", install.spec ?? `github:${RELEASES_REPO}`] }],
+            refusal: null,
+        };
+    }
+    return {
+        install: "unknown",
+        cwd: null,
+        steps: [],
+        refusal: "this copy of Loom wasn't installed from git or npm — download the release instead",
+    };
+}
+/**
+ * A git checkout with uncommitted work is yours, not ours to move.
+ *
+ * Modified tracked files only. Untracked ones don't stop a fast-forward —
+ * refusing over a stray scratch file or a symlinked node_modules would block
+ * the update for something git is perfectly happy with. (If an untracked file
+ * would actually be overwritten, git itself refuses and that error is shown.)
+ */
+export function refuseDirtyCheckout(status) {
+    const tracked = status
+        .split("\n")
+        .filter((l) => l.trim() && !l.startsWith("??"));
+    return tracked.length
+        ? `this checkout has uncommitted changes to ${tracked.length} file${tracked.length === 1 ? "" : "s"} — commit or stash them first`
+        : null;
+}
+//# sourceMappingURL=updater.js.map

package/dist/core/updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.js","sourceRoot":"","sources":["../../src/core/updater.ts"],"names":[],"mappings":"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"}

package/dist/core/usage.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Where the money and the tokens went: one walk over a project's event log,
+ * broken down by agent, by model, by chat, by day and by tool.
+ *
+ * The totals follow the accounting rule (runtime/accounting.ts): a turn's
+ * dollars arrive on a `turn_cost` status, and the same figure may be copied
+ * onto `run_complete` — counting both would double it. So a turn's cost is
+ * the `turn_cost` seen for that agent since its last turn ended, or, when an
+ * adapter only reported it on `run_complete`, that. Every dollar lands on the
+ * turn that spent it, which is what lets it be split by model and chat.
+ *
+ * Nothing is invented: an adapter that reports no price (a subscription CLI, a
+ * free model) shows tokens and $0, and `unpriced` counts those turns so the UI
+ * can say the total is a floor, not the bill.
+ */
+import type { LoomEvent } from "../types.js";
+export interface UsageSlice {
+    usd: number;
+    turns: number;
+    tokensIn: number;
+    tokensOut: number;
+    /** The part of tokensIn served from the provider's cache. */
+    cachedIn: number;
+    /** The part of tokensOut spent thinking. */
+    reasoning: number;
+    ms: number;
+}
+export interface UsageAgent extends UsageSlice {
+    agentId: string;
+    kind?: string;
+    models: string[];
+    toolCalls: number;
+    toolFailures: number;
+    errors: number;
+    /** Turns that reported tokens but no price. */
+    unpriced: number;
+}
+export interface UsageReport {
+    since: number;
+    totals: UsageSlice & {
+        toolCalls: number;
+        toolFailures: number;
+        errors: number;
+        prompts: number;
+        questions: number;
+        filesChanged: number;
+        linesAdded: number;
+        linesRemoved: number;
+        unpriced: number;
+        /** Derived, so every client says the same thing. */
+        avgTurnMs: number;
+        usdPerTurn: number;
+        cacheHitRate: number;
+    };
+    byAgent: UsageAgent[];
+    byModel: Array<UsageSlice & {
+        model: string;
+    }>;
+    byChat: Array<UsageSlice & {
+        chat: string;
+    }>;
+    byDay: Array<UsageSlice & {
+        day: string;
+    }>;
+    byTool: Array<{
+        tool: string;
+        calls: number;
+        failures: number;
+    }>;
+}
+export declare function usageReport(events: readonly LoomEvent[], opts?: {
+    since?: number;
+    kinds?: Record<string, string>;
+    models?: Record<string, string>;
+}): UsageReport;

package/dist/core/usage.js

@@ -0,0 +1,163 @@
+/**
+ * Where the money and the tokens went: one walk over a project's event log,
+ * broken down by agent, by model, by chat, by day and by tool.
+ *
+ * The totals follow the accounting rule (runtime/accounting.ts): a turn's
+ * dollars arrive on a `turn_cost` status, and the same figure may be copied
+ * onto `run_complete` — counting both would double it. So a turn's cost is
+ * the `turn_cost` seen for that agent since its last turn ended, or, when an
+ * adapter only reported it on `run_complete`, that. Every dollar lands on the
+ * turn that spent it, which is what lets it be split by model and chat.
+ *
+ * Nothing is invented: an adapter that reports no price (a subscription CLI, a
+ * free model) shows tokens and $0, and `unpriced` counts those turns so the UI
+ * can say the total is a floor, not the bill.
+ */
+const blank = () => ({ usd: 0, turns: 0, tokensIn: 0, tokensOut: 0, cachedIn: 0, reasoning: 0, ms: 0 });
+function add(into, t) {
+    into.usd += t.usd;
+    into.turns += t.turns;
+    into.tokensIn += t.tokensIn;
+    into.tokensOut += t.tokensOut;
+    into.cachedIn += t.cachedIn;
+    into.reasoning += t.reasoning;
+    into.ms += t.ms;
+}
+const num = (v) => {
+    const n = Number(v);
+    return Number.isFinite(n) && n > 0 ? n : 0;
+};
+/** Local calendar day, as the Observatory's daily series counts it. */
+function dayOf(ts) {
+    const d = new Date(ts);
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+export function usageReport(events, opts = {}) {
+    const since = opts.since ?? 0;
+    const agents = new Map();
+    const models = new Map();
+    const chats = new Map();
+    const days = new Map();
+    const tools = new Map();
+    const pending = new Map(); // agent → turn_cost not yet tied to a turn
+    const totals = blank();
+    let toolCalls = 0, toolFailures = 0, errors = 0, prompts = 0, questions = 0, filesChanged = 0, linesAdded = 0, linesRemoved = 0, unpriced = 0;
+    const agent = (id) => {
+        let a = agents.get(id);
+        if (!a) {
+            a = { agentId: id, ...(opts.kinds?.[id] ? { kind: opts.kinds[id] } : {}), ...blank(), models: [], toolCalls: 0, toolFailures: 0, errors: 0, unpriced: 0 };
+            agents.set(id, a);
+        }
+        return a;
+    };
+    const slice = (m, k) => {
+        let s = m.get(k);
+        if (!s)
+            m.set(k, (s = blank()));
+        return s;
+    };
+    for (const e of events) {
+        if (e.ts < since)
+            continue;
+        const p = (e.payload ?? {});
+        const who = e.agentId ?? "unknown";
+        if (e.kind === "status" && p.state === "turn_cost") {
+            pending.set(who, (pending.get(who) ?? 0) + num(p.costUsd));
+            continue;
+        }
+        if (e.kind === "run_complete") {
+            const owed = pending.get(who) ?? 0;
+            pending.delete(who);
+            const usd = owed > 0 ? owed : num(p.costUsd);
+            const t = {
+                usd,
+                turns: 1,
+                tokensIn: num(p.inputTokens ?? p.tokensIn),
+                tokensOut: num(p.outputTokens ?? p.tokensOut),
+                cachedIn: num(p.cachedInputTokens),
+                reasoning: num(p.reasoningTokens),
+                ms: num(p.durationMs),
+            };
+            // a turn that didn't name its model ran on whatever the agent defaults to
+            const model = String(p.model ?? opts.models?.[who] ?? "") || (opts.kinds?.[who] ? `${opts.kinds[who]} · default model` : "unknown");
+            const a = agent(who);
+            add(a, t);
+            if (!a.models.includes(model))
+                a.models.push(model);
+            if (!usd && (t.tokensIn || t.tokensOut)) {
+                a.unpriced++;
+                unpriced++;
+            }
+            add(totals, t);
+            add(slice(models, model), t);
+            add(slice(chats, e.chat ?? "main"), t);
+            add(slice(days, dayOf(e.ts)), t);
+            continue;
+        }
+        if (e.kind === "tool_call") {
+            const failed = p.ok === false || !!p.error || (typeof p.exitCode === "number" && p.exitCode !== 0);
+            const name = String(p.server ? `${String(p.server)}.${String(p.tool ?? "tool")}` : p.tool ?? "tool");
+            const t = tools.get(name) ?? { calls: 0, failures: 0 };
+            t.calls++;
+            if (failed)
+                t.failures++;
+            tools.set(name, t);
+            const a = agent(who);
+            a.toolCalls++;
+            toolCalls++;
+            if (failed) {
+                a.toolFailures++;
+                toolFailures++;
+            }
+            continue;
+        }
+        if (e.kind === "error") {
+            if (e.agentId)
+                agent(who).errors++;
+            errors++;
+            continue;
+        }
+        if (e.kind === "message" && !e.agentId)
+            prompts++;
+        else if (e.kind === "needs_input")
+            questions++;
+        else if (e.kind === "turn_diff") {
+            filesChanged += Array.isArray(p.files) ? p.files.length : 0;
+            linesAdded += num(p.added);
+            linesRemoved += num(p.removed);
+        }
+    }
+    // money reported with no turn after it (an interrupted turn) still counts
+    for (const [who, usd] of pending) {
+        if (!usd)
+            continue;
+        agent(who).usd += usd;
+        totals.usd += usd;
+        slice(models, opts.models?.[who] || "unknown").usd += usd;
+    }
+    const bySpend = (a, b) => b.usd - a.usd || b.tokensIn + b.tokensOut - (a.tokensIn + a.tokensOut) || b.turns - a.turns;
+    return {
+        since,
+        totals: {
+            ...totals,
+            toolCalls,
+            toolFailures,
+            errors,
+            prompts,
+            questions,
+            filesChanged,
+            linesAdded,
+            linesRemoved,
+            unpriced,
+            avgTurnMs: totals.turns ? Math.round(totals.ms / totals.turns) : 0,
+            usdPerTurn: totals.turns ? totals.usd / totals.turns : 0,
+            cacheHitRate: totals.tokensIn ? totals.cachedIn / totals.tokensIn : 0,
+        },
+        byAgent: [...agents.values()].sort(bySpend),
+        byModel: [...models.entries()].map(([model, s]) => ({ model, ...s })).sort(bySpend),
+        byChat: [...chats.entries()].map(([chat, s]) => ({ chat, ...s })).sort(bySpend).slice(0, 20),
+        byDay: [...days.entries()].map(([day, s]) => ({ day, ...s })).sort((a, b) => a.day.localeCompare(b.day)),
+        byTool: [...tools.entries()].map(([tool, t]) => ({ tool, ...t })).sort((a, b) => b.calls - a.calls).slice(0, 20),
+    };
+}
+//# sourceMappingURL=usage.js.map