@trazum/core 1.9.0 → 1.25.0

package/dist/usage.js

@@ -0,0 +1,634 @@
+import { effectivePricing, multipliersFor } from './pricing.js';
+import { createConversationTracker } from './conversation.js';
+import { createOutputShapeTracker } from './output-shape.js';
+import { createInputShapeTracker } from './input-shape.js';
+import { createRepeatsTracker } from './repeats.js';
+import { createTtlFitTracker } from './ttl-fit.js';
+import { createSessionLedgerTracker } from './session-ledger.js';
+import { createSessionCostTracker } from './session-cost.js';
+const EMPTY = () => ({
+    calls: 0,
+    inputTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0,
+    cacheWrite5mTokens: 0,
+    cacheWrite1hTokens: 0,
+    outputTokens: 0,
+    assumedWriteTtlCalls: 0,
+    maxCallInputTokens: 0,
+    inputUsd: 0,
+    cacheReadUsd: 0,
+    cacheWriteUsd: 0,
+    outputUsd: 0,
+    totalUsd: 0,
+    cachedTokensAtInputRateUsd: 0,
+    cacheWriteUsdIfAssumed1h: 0,
+    truncatedCalls: 0,
+    truncatedOutputUsd: 0,
+    stopReasonCalls: 0,
+});
+const OK = (value) => ({ kind: 'ok', value });
+function readCount(...candidates) {
+    let sawCorrupt = false;
+    for (const value of candidates) {
+        if (value === undefined)
+            continue;
+        if (typeof value === 'number' && Number.isFinite(value) && value >= 0)
+            return OK(value);
+        // Present and unusable: a string, a null, a negative, a NaN.
+        sawCorrupt = true;
+    }
+    return sawCorrupt ? { kind: 'corrupt' } : { kind: 'absent' };
+}
+/** Zero for an absent count. Callers reject corrupt ones before reaching this. */
+const valueOf = (count) => (count.kind === 'ok' ? count.value : 0);
+function readMoment(...candidates) {
+    let sawCorrupt = false;
+    for (const value of candidates) {
+        if (value === undefined)
+            continue;
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            if (value >= 1e12)
+                return { kind: 'ok', ms: value };
+            if (value >= 1e8)
+                return { kind: 'ok', ms: value * 1000 };
+            sawCorrupt = true;
+            continue;
+        }
+        if (typeof value === 'string') {
+            const parsed = Date.parse(value);
+            if (Number.isFinite(parsed))
+                return { kind: 'ok', ms: parsed };
+        }
+        sawCorrupt = true;
+    }
+    return sawCorrupt ? { kind: 'corrupt' } : { kind: 'absent' };
+}
+export function parseUsageLine(line) {
+    let raw;
+    try {
+        raw = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return null;
+    const record = raw;
+    // Anthropic nests usage on a response; a hand-rolled log usually flattens it.
+    const usage = typeof record.usage === 'object' && record.usage !== null
+        ? record.usage
+        : record;
+    const model = typeof record.model === 'string' ? record.model : null;
+    if (!model)
+        return null;
+    /**
+     * OpenAI reports cached tokens inside `prompt_tokens_details` **and counts them
+     * in `prompt_tokens`**, while Anthropic reports them separately and does not.
+     * Subtracting in one case and not the other is the difference between a correct
+     * bill and one that charges the cached half twice.
+     */
+    const details = typeof usage.prompt_tokens_details === 'object' && usage.prompt_tokens_details !== null
+        ? usage.prompt_tokens_details
+        : null;
+    const openAiCached = details ? readCount(details.cached_tokens) : { kind: 'absent' };
+    /**
+     * Anthropic splits cache writes by time-to-live, and the two cost different
+     * amounts: 1.25x input for the 5-minute entry, **2x** for the 1-hour one.
+     *
+     * Reading only the flat `cache_creation_input_tokens` threw that distinction
+     * away and then priced everything at the cheaper rate — a 1-hour workload
+     * reported 37.5% under, silently, on its largest line. The split is in the log
+     * whenever the recording recipe in the README is followed, because it is part of
+     * the `usage` object the API returns.
+     */
+    const creation = typeof usage.cache_creation === 'object' && usage.cache_creation !== null
+        ? usage.cache_creation
+        : null;
+    const write5m = creation ? readCount(creation.ephemeral_5m_input_tokens) : { kind: 'absent' };
+    const write1h = creation ? readCount(creation.ephemeral_1h_input_tokens) : { kind: 'absent' };
+    const counts = {
+        input: readCount(usage.input_tokens, usage.inputTokens, usage.prompt_tokens),
+        output: readCount(usage.output_tokens, usage.outputTokens, usage.completion_tokens),
+        cacheRead: readCount(usage.cache_read_input_tokens, usage.cacheReadTokens),
+        cacheWrite: readCount(usage.cache_creation_input_tokens, usage.cacheWriteTokens),
+        openAiCached,
+        write5m,
+        write1h,
+    };
+    // Any field present and unreadable rejects the line. See `readCount`.
+    if (Object.values(counts).some((c) => c.kind === 'corrupt'))
+        return null;
+    // Nothing to count at all.
+    if (Object.values(counts).every((c) => c.kind === 'absent'))
+        return null;
+    /**
+     * The clock, under the same rule as the counts: a timestamp that is present
+     * and unreadable rejects the line rather than becoming a silent absence.
+     * `created` is where OpenAI responses carry it (epoch seconds), so a log
+     * written by spreading the response already has one.
+     */
+    const moment = readMoment(record.ts, record.timestamp, record.created_at, record.created);
+    if (moment.kind === 'corrupt')
+        return null;
+    const cached = valueOf(counts.openAiCached);
+    const flatWrite = valueOf(counts.cacheWrite);
+    const split5m = valueOf(counts.write5m);
+    const split1h = valueOf(counts.write1h);
+    const hasSplit = counts.write5m.kind === 'ok' || counts.write1h.kind === 'ok';
+    return {
+        model,
+        inputTokens: Math.max(0, valueOf(counts.input) - cached),
+        cacheReadTokens: counts.cacheRead.kind === 'ok' ? counts.cacheRead.value : cached,
+        /**
+         * The split when the log carries it, the flat number otherwise — and
+         * `writeTtlKnown` says which, so the report can admit that a rate was assumed
+         * rather than quietly choosing the cheaper one.
+         */
+        cacheWrite5mTokens: hasSplit ? split5m : flatWrite,
+        cacheWrite1hTokens: hasSplit ? split1h : 0,
+        writeTtlKnown: hasSplit || flatWrite === 0,
+        outputTokens: valueOf(counts.output),
+        /**
+         * Trimmed and internally normalised: any whitespace run becomes one space.
+         * A label is a workload name, and it is also used as half of structured keys
+         * that split on `\n` — `byLabelAndModel`, the conversation tracker, the
+         * output-shape tracker. A label carrying a newline would corrupt that split
+         * and mis-file every figure under a truncated name; normalising at the one
+         * boundary where labels enter keeps every consumer honest at once.
+         */
+        label: nameOf(record.label),
+        /**
+         * Read from either spelling, because both are what people already have:
+         * `session` in a hand-rolled log, `conversation_id` in most chat schemas.
+         * Refusing one of them would make the field's adoption a chore, and a field
+         * nobody sets measures nothing.
+         */
+        session: nameOf(record.session) ?? nameOf(record.conversation_id),
+        ts: moment.kind === 'ok' ? moment.ms : null,
+        /**
+         * Anthropic spells it `stop_reason: "max_tokens"`, OpenAI
+         * `finish_reason: "length"`. Any other recorded reason is a completed
+         * answer; an absent field is `null`, which is "not measured" and not "did
+         * not happen" — the report treats those differently on purpose.
+         */
+        truncated: (() => {
+            const reason = record.stop_reason ?? record.finish_reason;
+            if (typeof reason !== 'string')
+                return null;
+            return reason === 'max_tokens' || reason === 'length';
+        })(),
+    };
+}
+/**
+ * A label or session identifier, from whatever a real log holds.
+ *
+ * **Numbers are identifiers too.** A conversation id is an auto-incremented
+ * integer in half the databases in existence, and the string-only version
+ * dropped `session: 12345` silently and then printed "No call in this log
+ * carried a session" — a false claim about a log that carried one on every
+ * line. A finite number is taken by its decimal form; booleans, objects and
+ * non-finite numbers stay out, because `session: true` names nothing.
+ *
+ * Strings are trimmed and internally normalised — any whitespace run becomes
+ * one space — because labels are half of structured keys that split on a
+ * newline, and a label carrying one would mis-file every figure it touches.
+ */
+function nameOf(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim().replace(/\s+/g, ' ');
+    return trimmed === '' ? null : trimmed;
+}
+/**
+ * The bucket unlabelled calls land in.
+ *
+ * The empty string, because it is the one value a parsed label can never be —
+ * `parseUsageLine` trims and rejects empty. The first version used the literal
+ * string `'unlabelled'`, and a workload somebody had actually named `unlabelled`
+ * merged silently into the missing-label bucket: 200 labelled calls and 200
+ * unlabelled ones reported as one row of 400, and the "none of these calls
+ * carried a label" warning fired over a log where half of them had.
+ *
+ * Presentation stays in the CLI, which translates this sentinel through the
+ * message catalogue; data consumers can tell `''` from any real label.
+ */
+export const UNLABELLED = '';
+/** Token counts only. Used for both halves, because both need them. */
+function countInto(into, record) {
+    into.calls += 1;
+    into.inputTokens += record.inputTokens;
+    into.cacheReadTokens += record.cacheReadTokens;
+    into.cacheWriteTokens += record.cacheWrite5mTokens + record.cacheWrite1hTokens;
+    into.cacheWrite5mTokens += record.cacheWrite5mTokens;
+    into.cacheWrite1hTokens += record.cacheWrite1hTokens;
+    if (!record.writeTtlKnown)
+        into.assumedWriteTtlCalls += 1;
+    into.outputTokens += record.outputTokens;
+    into.maxCallInputTokens = Math.max(into.maxCallInputTokens, record.inputTokens + record.cacheReadTokens + record.cacheWrite5mTokens + record.cacheWrite1hTokens);
+    if (record.truncated !== null) {
+        into.stopReasonCalls += 1;
+        if (record.truncated)
+            into.truncatedCalls += 1;
+    }
+}
+function add(into, record, catalogue, on) {
+    /**
+     * Looked up directly rather than through `modelFrom`, which **throws** on an id
+     * it does not know. A usage log is somebody's production traffic and will
+     * contain models this catalogue has never heard of — a fine-tune, a preview, a
+     * competitor. Throwing means one unfamiliar id destroys the whole profile;
+     * naming it separately means the report is honest about what it could not price
+     * and useful about everything else.
+     *
+     * **Priced first, counted second.** The other order was the bug: counts landed
+     * before the lookup could fail, so an unpriced call contributed tokens to a
+     * total whose dollars excluded it.
+     */
+    const model = catalogue.byId.get(record.model);
+    if (!model)
+        return false;
+    countInto(into, record);
+    const { inputPerMTok, outputPerMTok } = effectivePricing(model, on);
+    const rates = multipliersFor(model);
+    const per = (tokens, rate) => (tokens / 1_000_000) * rate;
+    into.inputUsd += per(record.inputTokens, inputPerMTok);
+    into.cacheReadUsd += per(record.cacheReadTokens, inputPerMTok * rates.cacheRead);
+    /**
+     * Each TTL at its own rate. Anthropic charges 1.25x input for a 5-minute entry
+     * and 2x for a 1-hour one, and the first version applied 1.25x to both — 37.5%
+     * under on a 1-hour workload, on the largest line, with nothing on screen
+     * saying a rate had been chosen.
+     */
+    into.cacheWriteUsd += per(record.cacheWrite5mTokens, inputPerMTok * rates.cacheWrite5m);
+    into.cacheWriteUsd += per(record.cacheWrite1hTokens, inputPerMTok * rates.cacheWrite1h);
+    /**
+     * The same writes with the assumption taken the other way.
+     *
+     * A record whose TTL the log did not state has all of its writes in the
+     * 5-minute bucket — `parseUsageLine` puts them there because one rate has to be
+     * chosen — so this prices exactly those at the 1-hour rate instead. Accumulated
+     * per call, and per model, because the ratio between the two rates is not a
+     * constant: 2.0/1.25 on Anthropic, 1.0/1.0 where a write costs what input
+     * costs. Scaling the total afterwards would invent a premium for providers that
+     * have none.
+     */
+    const writeRateIfWrong = record.writeTtlKnown ? rates.cacheWrite5m : rates.cacheWrite1h;
+    into.cacheWriteUsdIfAssumed1h += per(record.cacheWrite5mTokens, inputPerMTok * writeRateIfWrong);
+    into.cacheWriteUsdIfAssumed1h += per(record.cacheWrite1hTokens, inputPerMTok * rates.cacheWrite1h);
+    into.outputUsd += per(record.outputTokens, outputPerMTok);
+    if (record.truncated === true) {
+        into.truncatedOutputUsd += per(record.outputTokens, outputPerMTok);
+    }
+    /**
+     * The same cache-touched tokens at the plain input rate, banked here because
+     * `inputPerMTok` is per model and is gone by the time anybody reads the total.
+     */
+    into.cachedTokensAtInputRateUsd += per(record.cacheReadTokens + record.cacheWrite5mTokens + record.cacheWrite1hTokens, inputPerMTok);
+    into.totalUsd =
+        into.inputUsd + into.cacheReadUsd + into.cacheWriteUsd + into.outputUsd;
+    return true;
+}
+/**
+ * Reads a usage log and says where the money went.
+ *
+ * Takes the whole text rather than a stream: a usage log is measured in megabytes
+ * and this package imports no Node builtins, so streaming would mean an interface
+ * the browser build cannot satisfy. `@trazum/core/node` is where file reading
+ * lives, and it can chunk if it ever needs to.
+ */
+export function profileUsage(text, options) {
+    const { catalogue, on = new Date(), label: onlyLabel, sinceMs, untilMs } = options;
+    const windowed = sinceMs !== undefined || untilMs !== undefined;
+    let undatedExcluded = 0;
+    const total = EMPTY();
+    const unpriced = EMPTY();
+    const byLabel = new Map();
+    const byModel = new Map();
+    // Keyed on a pair, so the key carries a separator that cannot occur in either
+    // half. A model id is `[A-Za-z0-9._-]`, so a newline is safe in both.
+    const byPair = new Map();
+    const unpricedModels = new Set();
+    const skippedLines = [];
+    /**
+     * Fed in the pass this function already makes, rather than by keeping the records
+     * for a second one: a usage log is measured in megabytes, and what this holds is
+     * bounded by the number of conversations instead.
+     */
+    const conversations = createConversationTracker({ catalogue, on });
+    const output = createOutputShapeTracker({ catalogue, on });
+    const input = createInputShapeTracker({ catalogue, on });
+    const repeats = createRepeatsTracker({ catalogue, on });
+    const ttlFit = createTtlFitTracker({ catalogue, on });
+    const ledger = createSessionLedgerTracker({ catalogue, on });
+    const sessionCosts = createSessionCostTracker({ catalogue, on });
+    let hasSessions = false;
+    const coverage = { label: 0, session: 0, ts: 0, stopReason: 0, cacheTtl: 0, cacheWrites: 0, parsed: 0 };
+    /**
+     * Raw lines already seen, for the duplicate check. Bounded by the number of
+     * *timestamped* lines — the price of catching a doubled bill, paid only on
+     * logs that carry a clock.
+     */
+    const seenLines = new Set();
+    const duplicates = { count: 0, usd: 0 };
+    let spanFrom = Infinity;
+    let spanTo = -Infinity;
+    let spanCalls = 0;
+    /** Per UTC day: spend, calls, and spend per label. Bounded by days × labels. */
+    const days = new Map();
+    /** Per hour of the UTC day. Bounded by twenty-four entries, whatever the log. */
+    const hours = new Map();
+    const lines = text.split('\n');
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i].trim();
+        if (line === '')
+            continue;
+        const record = parseUsageLine(line);
+        if (!record) {
+            skippedLines.push(i + 1);
+            continue;
+        }
+        // The drill-down: after the skip accounting, so a corrupt line is reported
+        // whatever it might have been labelled.
+        if (onlyLabel !== undefined && (record.label ?? UNLABELLED) !== onlyLabel)
+            continue;
+        /**
+         * The time window, after the label filter so `undatedExcluded` counts only
+         * the selected workload's clockless calls — a count polluted by every other
+         * label's records would overstate how much of *this* answer is missing.
+         * Records outside the window are simply not the question; records with no
+         * clock are the question left unanswerable, so they are counted.
+         */
+        if (windowed) {
+            if (record.ts === null) {
+                undatedExcluded += 1;
+                continue;
+            }
+            if (sinceMs !== undefined && record.ts < sinceMs)
+                continue;
+            if (untilMs !== undefined && record.ts >= untilMs)
+                continue;
+        }
+        /**
+         * Coverage is counted before pricing: whether a field is present is a
+         * property of the log, and a record on an unknown model still says
+         * whether somebody set `label`.
+         */
+        coverage.parsed += 1;
+        if (record.label !== null)
+            coverage.label += 1;
+        if (record.session !== null)
+            coverage.session += 1;
+        if (record.ts !== null)
+            coverage.ts += 1;
+        if (record.truncated !== null)
+            coverage.stopReason += 1;
+        if (record.cacheWrite5mTokens + record.cacheWrite1hTokens > 0) {
+            coverage.cacheWrites += 1;
+            if (record.writeTtlKnown)
+                coverage.cacheTtl += 1;
+        }
+        if (record.session !== null)
+            hasSessions = true;
+        if (record.ts !== null) {
+            spanFrom = Math.min(spanFrom, record.ts);
+            spanTo = Math.max(spanTo, record.ts);
+            spanCalls += 1;
+        }
+        conversations.add(record);
+        output.add(record);
+        input.add(record);
+        repeats.add(record);
+        ttlFit.add(record);
+        ledger.add(record);
+        sessionCosts.add(record);
+        const usdBefore = total.totalUsd;
+        if (!add(total, record, catalogue, on)) {
+            unpricedModels.add(record.model);
+            countInto(unpriced, record);
+            // Still grouped by model, so the reader can see which unknown id is costing
+            // them attention — but with zero dollars, which the grouping makes obvious.
+            if (!byModel.has(record.model))
+                byModel.set(record.model, EMPTY());
+            countInto(byModel.get(record.model), record);
+            continue;
+        }
+        /**
+         * A line identical to one already read, with a clock to make the claim
+         * safe. Counted after pricing so the money is the exact delta this line
+         * added, which is what a doubled bill is overstated by.
+         */
+        if (record.ts !== null) {
+            if (seenLines.has(line)) {
+                duplicates.count += 1;
+                duplicates.usd += total.totalUsd - usdBefore;
+            }
+            else {
+                seenLines.add(line);
+            }
+        }
+        /**
+         * The day's spend, as the exact delta this record just added to the total —
+         * the one place the per-record dollar exists without re-deriving the rate
+         * arithmetic a second time, where the two could drift apart.
+         */
+        if (record.ts !== null) {
+            const day = new Date(record.ts).toISOString().slice(0, 10);
+            const usd = total.totalUsd - usdBefore;
+            let entry = days.get(day);
+            if (!entry) {
+                entry = { usd: 0, calls: 0, byLabel: new Map() };
+                days.set(day, entry);
+            }
+            entry.usd += usd;
+            entry.calls += 1;
+            const labelKey = record.label ?? UNLABELLED;
+            entry.byLabel.set(labelKey, (entry.byLabel.get(labelKey) ?? 0) + usd);
+            // The same exact per-record dollar, bucketed by hour of the UTC day.
+            const hour = new Date(record.ts).getUTCHours();
+            const hourEntry = hours.get(hour);
+            if (hourEntry) {
+                hourEntry.usd += usd;
+                hourEntry.calls += 1;
+            }
+            else {
+                hours.set(hour, { usd, calls: 1 });
+            }
+        }
+        const labelKey = record.label ?? UNLABELLED;
+        if (!byLabel.has(labelKey))
+            byLabel.set(labelKey, EMPTY());
+        add(byLabel.get(labelKey), record, catalogue, on);
+        if (!byModel.has(record.model))
+            byModel.set(record.model, EMPTY());
+        add(byModel.get(record.model), record, catalogue, on);
+        const pairKey = `${labelKey}\n${record.model}`;
+        if (!byPair.has(pairKey))
+            byPair.set(pairKey, EMPTY());
+        add(byPair.get(pairKey), record, catalogue, on);
+    }
+    const sorted = (map, key) => [...map.entries()]
+        .sort((a, b) => b[1].totalUsd - a[1].totalUsd || a[0].localeCompare(b[0]))
+        .map(([name, breakdown]) => ({ [key]: name, breakdown }));
+    return {
+        total,
+        byLabel: sorted(byLabel, 'label'),
+        byModel: sorted(byModel, 'model'),
+        byLabelAndModel: [...byPair.entries()]
+            .sort((a, b) => b[1].totalUsd - a[1].totalUsd || a[0].localeCompare(b[0]))
+            .map(([key, breakdown]) => {
+            const split = key.indexOf('\n');
+            return { label: key.slice(0, split), model: key.slice(split + 1), breakdown };
+        }),
+        unpricedModels: [...unpricedModels].sort(),
+        unpriced,
+        skippedLines,
+        conversations: conversations.finish(total.totalUsd),
+        hasSessions,
+        outputShapes: output.finish(total.totalUsd),
+        inputShapes: input.finish(total.totalUsd),
+        repeatedTurns: repeats.finish(),
+        span: spanCalls > 0 ? { fromMs: spanFrom, toMs: spanTo, calls: spanCalls } : null,
+        spendByDay: [...days.entries()]
+            .sort((a, b) => a[0].localeCompare(b[0]))
+            .map(([day, entry]) => {
+            let topLabel = null;
+            let topLabelUsd = 0;
+            for (const [label, usd] of entry.byLabel) {
+                if (usd > topLabelUsd) {
+                    topLabel = label;
+                    topLabelUsd = usd;
+                }
+            }
+            return { day, usd: entry.usd, calls: entry.calls, topLabel, topLabelUsd };
+        }),
+        duplicateLines: duplicates,
+        fieldCoverage: coverage,
+        spendByHour: [...hours.entries()]
+            .sort((a, b) => a[0] - b[0])
+            .map(([hour, entry]) => ({ hour, usd: entry.usd, calls: entry.calls })),
+        cacheTtlFit: ttlFit.finish(),
+        timeWindow: windowed
+            ? { sinceMs: sinceMs ?? null, untilMs: untilMs ?? null, undatedExcluded }
+            : null,
+        singleTurnCacheWrites: ledger.finish(),
+        sessionCosts: sessionCosts.finish(),
+    };
+}
+/**
+ * What share of the bill each part is.
+ *
+ * The point of the whole module in one function: a caller can print "output is
+ * 87% of this" without doing arithmetic that would drift from the arithmetic
+ * here.
+ *
+ * All zeroes when nothing was spent, rather than `NaN`. A profile of an empty log
+ * is a legitimate result — no calls yet — and a report full of `NaN%` is a bug
+ * report from somebody who did nothing wrong.
+ */
+export function sharesOf(breakdown) {
+    const { totalUsd } = breakdown;
+    if (totalUsd <= 0)
+        return { input: 0, cacheRead: 0, cacheWrite: 0, output: 0 };
+    return {
+        input: breakdown.inputUsd / totalUsd,
+        cacheRead: breakdown.cacheReadUsd / totalUsd,
+        cacheWrite: breakdown.cacheWriteUsd / totalUsd,
+        output: breakdown.outputUsd / totalUsd,
+    };
+}
+/**
+ * How much of the input that could have been cached was.
+ *
+ * `null` when nothing was cacheable-looking at all — no reads and no writes —
+ * because a hit rate over zero attempts is not zero, it is undefined, and
+ * printing "0% cache hit rate" for somebody who never turned caching on is a
+ * finding about nothing.
+ *
+ * Reads against reads-plus-full-price-input, deliberately. Cache *writes* are
+ * excluded from the denominator: a write is the cost of establishing an entry,
+ * not a missed read, and counting it as a miss makes a healthy cache look broken
+ * on the day it warms.
+ */
+export function cacheHitRate(breakdown) {
+    const attempts = breakdown.cacheReadTokens + breakdown.inputTokens;
+    if (breakdown.cacheReadTokens === 0 && breakdown.cacheWriteTokens === 0)
+        return null;
+    if (attempts === 0)
+        return null;
+    return breakdown.cacheReadTokens / attempts;
+}
+/**
+ * Floating-point noise, not a judgement threshold.
+ *
+ * Summing a million per-call doubles around a $100 bill accumulates roughly
+ * `n · eps · magnitude` ≈ $2e-8 of drift, and a verdict that flipped on that would
+ * be reporting arithmetic error as a finding. A millionth of a dollar is orders of
+ * magnitude below anything this tool prints, so nothing real is being rounded away
+ * — deliberately not a "too small to care about" cutoff, which would be a
+ * judgement and would belong somewhere a reader can see it.
+ */
+const CACHE_DELTA_NOISE_USD = 1e-6;
+/**
+ * Did caching pay for itself?
+ *
+ * The question nothing else in this package can answer, and the one that decides
+ * whether the advice the rest of it gives was right. Trazum tells people to cache;
+ * on Anthropic a cache **write** costs 1.25x plain input at the 5-minute TTL and
+ * **2x** at the 1-hour one, so a prefix that changes faster than it is reused is
+ * billed at a premium and returns nothing. That workload would be cheaper with
+ * caching switched off, and no other report in this repository would ever say so.
+ *
+ * The counterfactual is exact, which is why this is allowed to exist here at all:
+ * caching changes the multiplier on a token, never the token. Had `cache_control`
+ * not been set, the identical prefix would have gone up as ordinary input at 1x.
+ * So `withoutCachingUsd` is not an estimate of a different call — it is the same
+ * call, arithmetic away.
+ *
+ * Worth running per label as well as over the whole log. A profitable cache on one
+ * workload and a bleeding one on another net out to a comfortable-looking total,
+ * and the aggregate is exactly where a loss hides.
+ */
+export function cacheEconomics(breakdown) {
+    const touchedTokens = breakdown.cacheReadTokens + breakdown.cacheWriteTokens;
+    const spentUsd = breakdown.cacheReadUsd + breakdown.cacheWriteUsd;
+    const withoutCachingUsd = breakdown.cachedTokensAtInputRateUsd;
+    const none = (verdict) => ({
+        spentUsd,
+        withoutCachingUsd,
+        deltaUsd: 0,
+        readsPerWrite: null,
+        verdict,
+        worstCaseDeltaUsd: 0,
+        worstCaseVerdict: verdict,
+    });
+    if (touchedTokens === 0)
+        return none('not-attempted');
+    /**
+     * Tokens went through the cache and no money is attached to either side, so
+     * there is nothing to compare. This is what an unpriced model looks like: the
+     * counts accumulate through `countInto` and the dollars never do. Without this
+     * guard the delta is `0 - 0` and the verdict comes out `no-difference` — a
+     * confident claim about a bill that was never computed.
+     */
+    if (spentUsd === 0 && withoutCachingUsd === 0)
+        return none('unpriced');
+    const deltaUsd = spentUsd - withoutCachingUsd;
+    const worstCaseDeltaUsd = breakdown.cacheReadUsd + breakdown.cacheWriteUsdIfAssumed1h - withoutCachingUsd;
+    const readsPerWrite = breakdown.cacheWriteTokens === 0
+        ? null
+        : breakdown.cacheReadTokens / breakdown.cacheWriteTokens;
+    const decide = (delta) => Math.abs(delta) < CACHE_DELTA_NOISE_USD ? 'no-difference' : delta > 0 ? 'lost-money' : 'paid-off';
+    return {
+        spentUsd,
+        withoutCachingUsd,
+        deltaUsd,
+        readsPerWrite,
+        verdict: decide(deltaUsd),
+        worstCaseDeltaUsd,
+        worstCaseVerdict: decide(worstCaseDeltaUsd),
+    };
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

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