@trazum/core 1.10.0 → 1.25.0

package/dist/output-shape.js

@@ -0,0 +1,145 @@
+import { effectivePricing } from './pricing.js';
+import { UNLABELLED } from './usage.js';
+/**
+ * Bucket edges, fine where answers actually land and coarse in the tail.
+ *
+ * 64 tokens up to 8,192 covers ordinary answers at a resolution finer than anybody
+ * would act on; past that the buckets widen, because the difference between a
+ * 40,000-token answer and a 41,000-token one changes no decision. The last bucket is
+ * open-ended so nothing falls off the end — an answer longer than the largest edge
+ * still counts, in the group where it belongs.
+ */
+const EDGES = (() => {
+    const edges = [];
+    for (let t = 0; t < 8192; t += 64)
+        edges.push(t);
+    for (let t = 8192; t < 131_072; t += 1024)
+        edges.push(t);
+    return edges;
+})();
+/** Index of the bucket a count falls in. The last bucket is open-ended. */
+function bucketOf(tokens) {
+    if (tokens >= EDGES[EDGES.length - 1])
+        return EDGES.length - 1;
+    if (tokens < 8192)
+        return Math.floor(tokens / 64);
+    return 128 + Math.floor((tokens - 8192) / 1024);
+}
+/** A bucket's upper edge, or `null` for the open-ended last one. */
+function upperEdgeOf(bucket) {
+    if (bucket >= EDGES.length - 1)
+        return null;
+    return EDGES[bucket + 1];
+}
+/**
+ * The bucket ceiling covering `share` of the calls, walking up from the
+ * shortest answers. Exact over the histogram: every call at or below the
+ * returned ceiling is counted, none is interpolated.
+ */
+function ceilingFor(buckets, totalCalls, share) {
+    const ascending = [...buckets.keys()].sort((a, b) => a - b);
+    const target = totalCalls * share;
+    let covered = 0;
+    for (const b of ascending) {
+        covered += buckets.get(b).calls;
+        if (covered >= target)
+            return upperEdgeOf(b);
+    }
+    return upperEdgeOf(ascending[ascending.length - 1]);
+}
+/**
+ * An accumulator, fed in the pass a profile already makes.
+ *
+ * What it holds is bounded by the number of slices times the number of buckets any
+ * of them actually touches, not by the size of the log.
+ */
+export function createOutputShapeTracker(options) {
+    const { catalogue, on = new Date(), minShare = 0.05 } = options;
+    const slices = new Map();
+    const add = (record) => {
+        const model = catalogue.byId.get(record.model);
+        // An unpriced model contributes no dollars anywhere else; a shape drawn from
+        // one would be a distribution of a bill that was never computed.
+        if (!model)
+            return;
+        if (record.outputTokens <= 0)
+            return;
+        const key = `${record.label ?? UNLABELLED}\n${record.model}`;
+        let slice = slices.get(key);
+        if (!slice) {
+            slice = { calls: 0, outputTokens: 0, outputUsd: 0, buckets: new Map() };
+            slices.set(key, slice);
+        }
+        const { outputPerMTok } = effectivePricing(model, on);
+        slice.calls += 1;
+        slice.outputTokens += record.outputTokens;
+        slice.outputUsd += (record.outputTokens / 1_000_000) * outputPerMTok;
+        const b = bucketOf(record.outputTokens);
+        const cell = slice.buckets.get(b);
+        if (cell) {
+            cell.calls += 1;
+            cell.tokens += record.outputTokens;
+        }
+        else {
+            slice.buckets.set(b, { calls: 1, tokens: record.outputTokens });
+        }
+    };
+    const finish = (totalUsd) => {
+        const out = [];
+        for (const [key, slice] of slices) {
+            const split = key.indexOf('\n');
+            const label = key.slice(0, split);
+            const modelId = key.slice(split + 1);
+            const model = catalogue.byId.get(modelId);
+            if (!model || slice.outputTokens === 0)
+                continue;
+            const shareOfBill = totalUsd > 0 ? slice.outputUsd / totalUsd : 0;
+            if (shareOfBill < minShare)
+                continue;
+            /**
+             * Walk down from the longest answers until half the output spend is
+             * covered. Spend is proportional to tokens inside one slice — one model,
+             * one rate — so the tokens are the money here and no second accumulator is
+             * needed.
+             */
+            const target = slice.outputTokens / 2;
+            const descending = [...slice.buckets.keys()].sort((a, b) => b - a);
+            let tokens = 0;
+            let heavyCalls = 0;
+            let lastBucket = descending[0];
+            for (const b of descending) {
+                const cell = slice.buckets.get(b);
+                tokens += cell.tokens;
+                heavyCalls += cell.calls;
+                lastBucket = b;
+                if (tokens >= target)
+                    break;
+            }
+            out.push({
+                label,
+                model: modelId,
+                modelName: model.displayName,
+                calls: slice.calls,
+                outputTokens: slice.outputTokens,
+                outputUsd: slice.outputUsd,
+                aboveTokens: EDGES[lastBucket],
+                heavyCalls,
+                heavyCallShare: heavyCalls / slice.calls,
+                heavySpendShare: tokens / slice.outputTokens,
+                shareOfBill,
+                medianWithinTokens: ceilingFor(slice.buckets, slice.calls, 0.5),
+                p95WithinTokens: ceilingFor(slice.buckets, slice.calls, 0.95),
+            });
+        }
+        return out.sort((a, b) => b.outputUsd - a.outputUsd);
+    };
+    return { add, finish };
+}
+/** The same measurement over a list of records, for a caller holding one. */
+export function outputShapes(records, totalUsd, options) {
+    const tracker = createOutputShapeTracker(options);
+    for (const record of records)
+        tracker.add(record);
+    return tracker.finish(totalUsd);
+}
+//# sourceMappingURL=output-shape.js.map

package/dist/output-shape.js.map

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

package/dist/pricing-overlay.d.ts

@@ -18,7 +18,7 @@ import type { ModelPricing } from './types.js';
  * exists to prevent.
  */
 export declare const PRICING_OVERLAY_KEYS: readonly ['lastReviewed', 'models'];
-export declare const PRICING_MODEL_KEYS: readonly ['displayName', 'inputPerMTok', 'outputPerMTok', 'contextWindow', 'cacheMinTokens', 'tier', 'capability', 'caching', 'notes', 'promo'];
+export declare const PRICING_MODEL_KEYS: readonly ['displayName', 'inputPerMTok', 'outputPerMTok', 'contextWindow', 'cacheMinTokens', 'tier', 'capability', 'caching', 'notes', 'promo', 'multipliers'];
 /** Largest overlay this will read — a price list, not a dataset. */
 export declare const MAX_PRICING_BYTES: number;
 export interface PricingOverlay {

package/dist/pricing-overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing-overlay.d.ts","sourceRoot":"","sources":["../src/pricing-overlay.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAA2B,YAAY,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,oBAAoB,YAAI,cAAc,EAAE,QAAQ,CAAU,CAAC;AAExE,eAAO,MAAM,kBAAkB,YAC7B,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,SAAS,EACT,OAAO,EACP,OAAO,CACC,CAAC;AAQX,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CAC3D;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,QAAQ,CAAC,MAAM,EAAE,MAAM;IAFzB,YACE,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EAIxB;CACF;AAqJD,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAoB,GAAG,cAAc,CAkC3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,EACvB,MAAM,SAAoB,GACzB,gBAAgB,CA6ClB;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAoB,GAAG,gBAAgB,CAE9F"}
+{"version":3,"file":"pricing-overlay.d.ts","sourceRoot":"","sources":["../src/pricing-overlay.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAA4C,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzF;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,oBAAoB,YAAI,cAAc,EAAE,QAAQ,CAAU,CAAC;AAExE,eAAO,MAAM,kBAAkB,YAC7B,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,SAAS,EACT,OAAO,EACP,OAAO,EACP,aAAa,CACL,CAAC;AAyBX,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CAC3D;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,QAAQ,CAAC,MAAM,EAAE,MAAM;IAFzB,YACE,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EAIxB;CACF;AAsLD,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAoB,GAAG,cAAc,CAkC3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,EACvB,MAAM,SAAoB,GACzB,gBAAgB,CA6ClB;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAoB,GAAG,gBAAgB,CAE9F"}

package/dist/pricing-overlay.js

@@ -29,8 +29,25 @@ export const PRICING_MODEL_KEYS = [
     'caching',
     'notes',
     'promo',
+    'multipliers',
 ];
 const PROMO_KEYS = ['inputPerMTok', 'outputPerMTok', 'until'];
+/**
+ * Cache and batch rates, which an overlay had no way to state — and had to.
+ *
+ * Without this, a model added through `--pricing` silently inherited Anthropic's
+ * multipliers: a cache write at 1.25x input, or 2x at the long TTL. Most
+ * providers charge plain input for a write, so `trazum profile` computed a
+ * premium that model never charged, accused the workload of a caching loss it
+ * could not have, and told the reader to turn caching off. Three documents
+ * claimed that could not happen to a provider whose writes cost what input costs,
+ * and for an overlay model it was exactly what happened.
+ *
+ * `batch` accepts `null`, which is not the same as leaving it out: "this provider
+ * has no batch API" should stop the advisory offering a discount nobody sells,
+ * while "nobody has said" should fall back to the default.
+ */
+const MULTIPLIER_KEYS = ['cacheRead', 'cacheWrite5m', 'cacheWrite1h', 'batch'];
 const TIERS = ['frontier', 'opus', 'sonnet', 'haiku', 'unknown'];
 const CAPABILITIES = ['small', 'mid', 'large', 'frontier', 'unknown'];
 const CACHING_MODES = ['explicit', 'automatic', 'none', 'unknown'];
@@ -88,6 +105,32 @@ function parsePromo(raw, label, source) {
         until: raw.until,
     };
 }
+function parseMultipliers(raw, label, source) {
+    if (!isPlainObject(raw)) {
+        throw new PricingOverlayError(`"${label}" must be an object`, source);
+    }
+    rejectUnknownKeys(raw, MULTIPLIER_KEYS, source, `${label}.`);
+    if (Object.keys(raw).length === 0) {
+        throw new PricingOverlayError(`"${label}" is empty — remove it, or say which rate it changes`, source);
+    }
+    const multipliers = {};
+    for (const key of ['cacheRead', 'cacheWrite5m', 'cacheWrite1h']) {
+        if (raw[key] === undefined)
+            continue;
+        /**
+         * Zero is refused along with the negatives. A free cache read is not a price
+         * anybody publishes, and admitting one would let an overlay typo turn a real
+         * cost into no cost — the flattering direction, and the one this whole file
+         * exists to keep out of a report.
+         */
+        multipliers[key] = positiveNumber(raw[key], `${label}.${key}`, source);
+    }
+    if (raw.batch !== undefined) {
+        multipliers.batch =
+            raw.batch === null ? null : positiveNumber(raw.batch, `${label}.batch`, source);
+    }
+    return multipliers;
+}
 function parseModel(raw, id, source) {
     if (!isPlainObject(raw)) {
         throw new PricingOverlayError(`"models.${id}" must be an object`, source);
@@ -150,6 +193,9 @@ function parseModel(raw, id, source) {
         // `null` is how you cancel a bundled promotion that has been withdrawn.
         model.promo = raw.promo === null ? undefined : parsePromo(raw.promo, `models.${id}.promo`, source);
     }
+    if (raw.multipliers !== undefined) {
+        model.multipliers = parseMultipliers(raw.multipliers, `models.${id}.multipliers`, source);
+    }
     return model;
 }
 /** Validates an overlay document. Every failure throws, with the source named. */

package/dist/pricing-overlay.js.map

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

package/dist/repeats.d.ts

@@ -0,0 +1,75 @@
+import type { PricingCatalogue } from './pricing.js';
+import type { UsageRecord } from './usage.js';
+/**
+ * The same request, sent again a moment later.
+ *
+ * ## The failure mode nothing else here can see
+ *
+ * A conversation's input **grows with every turn** — that is the finding
+ * `conversations` exists for. So two consecutive calls in one conversation
+ * carrying *exactly* the same input size, seconds apart, is the shape of
+ * something going wrong rather than something working: a retry after a
+ * timeout, an agent step repeating because a tool call failed, a loop that
+ * re-sends the whole context and gets nowhere.
+ *
+ * That is expensive in a way a total hides completely. The retried call is
+ * billed in full, and on an agent workload the input is the bill.
+ * `duplicateLines` catches the same line recorded twice; this catches two
+ * *different* calls that sent the same thing.
+ *
+ * ## What it compares, and why only that
+ *
+ * Each call is compared to **the one immediately before it in the same
+ * session**, and only when the log carries both a session and a clock. Not to
+ * every earlier call: a workload that legitimately sends a fixed-size prompt
+ * would light up under a looser rule, and holding every size a session has
+ * ever sent would grow without bound on a log measured in megabytes. One
+ * previous call per session is bounded and is where a retry actually sits.
+ *
+ * The gap must be **non-negative and under the window** (a minute by default).
+ * Non-negative because a log is not guaranteed to be in time order, and a
+ * negative gap means the two records arrived out of order rather than that a
+ * call repeated.
+ *
+ * ## What it refuses to conclude
+ *
+ * It cannot see content, so it cannot tell a retry from two genuinely
+ * identical requests a second apart. It reports the count and the money and
+ * stops — the same rule `duplicateLines` follows. Every rendering says the
+ * pattern is *usually* a retry or a loop, never that it is one.
+ */
+/** Consecutive same-size calls in one conversation, per slice. */
+export interface RepeatedTurns {
+    label: string;
+    model: string;
+    modelName: string;
+    /** How many calls repeated the previous call's input size inside the window. */
+    repeats: number;
+    /** Calls in this slice that could be checked at all — the denominator. */
+    checkedCalls: number;
+    /** What those repeated calls cost, in full. */
+    usd: number;
+    /** The window they had to fall inside, in milliseconds. */
+    withinMs: number;
+}
+export interface RepeatsOptions {
+    catalogue: PricingCatalogue;
+    on?: Date;
+    /**
+     * How close two calls have to be. A minute by default: long enough to cover
+     * a timeout and a retry, short enough that an ordinary next turn — which
+     * needs a human or a tool to produce it — rarely lands inside it.
+     */
+    withinMs?: number;
+    /** Slices below this many repeats are dropped. Default 2. */
+    minRepeats?: number;
+}
+export interface RepeatsTracker {
+    add(record: UsageRecord): void;
+    finish(): RepeatedTurns[];
+}
+/** An accumulator, fed in the pass a profile already makes. */
+export declare function createRepeatsTracker(options: RepeatsOptions): RepeatsTracker;
+/** The same measurement over a list of records, for a caller holding one. */
+export declare function repeatedTurns(records: readonly UsageRecord[], options: RepeatsOptions): RepeatedTurns[];
+//# sourceMappingURL=repeats.d.ts.map

package/dist/repeats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeats.d.ts","sourceRoot":"","sources":["../src/repeats.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,EAAE,CAAC,EAAE,IAAI,CAAC;IACV;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,MAAM,IAAI,aAAa,EAAE,CAAC;CAC3B;AAQD,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAuE5E;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,EAAE,cAAc,GACtB,aAAa,EAAE,CAIjB"}

package/dist/repeats.js

@@ -0,0 +1,82 @@
+import { effectivePricing, multipliersFor } from './pricing.js';
+import { UNLABELLED } from './usage.js';
+/** An accumulator, fed in the pass a profile already makes. */
+export function createRepeatsTracker(options) {
+    const { catalogue, on = new Date(), withinMs = 60_000, minRepeats = 2 } = options;
+    const slices = new Map();
+    /** The previous call of each session: its input size and when it happened. */
+    const previous = new Map();
+    const add = (record) => {
+        const model = catalogue.byId.get(record.model);
+        // An unpriced model has no dollars anywhere else; naming money here that
+        // no total contains would be a figure with nothing behind it.
+        if (!model)
+            return;
+        if (record.session === null || record.ts === null)
+            return;
+        const tokens = record.inputTokens +
+            record.cacheReadTokens +
+            record.cacheWrite5mTokens +
+            record.cacheWrite1hTokens;
+        if (tokens <= 0)
+            return;
+        const key = `${record.label ?? UNLABELLED}\n${record.model}`;
+        let slice = slices.get(key);
+        if (!slice) {
+            slice = { repeats: 0, checkedCalls: 0, usd: 0 };
+            slices.set(key, slice);
+        }
+        slice.checkedCalls += 1;
+        const before = previous.get(record.session);
+        previous.set(record.session, { tokens, ts: record.ts });
+        if (before === undefined)
+            return;
+        const gap = record.ts - before.ts;
+        // Out of order is not a repeat, and neither is a call an hour later.
+        if (gap < 0 || gap >= withinMs)
+            return;
+        if (before.tokens !== tokens)
+            return;
+        const { inputPerMTok, outputPerMTok } = effectivePricing(model, on);
+        const rates = multipliersFor(model);
+        const per = (count, rate) => (count / 1_000_000) * rate;
+        slice.repeats += 1;
+        slice.usd +=
+            per(record.inputTokens, inputPerMTok) +
+                per(record.cacheReadTokens, inputPerMTok * rates.cacheRead) +
+                per(record.cacheWrite5mTokens, inputPerMTok * rates.cacheWrite5m) +
+                per(record.cacheWrite1hTokens, inputPerMTok * rates.cacheWrite1h) +
+                per(record.outputTokens, outputPerMTok);
+    };
+    const finish = () => {
+        const out = [];
+        for (const [key, slice] of slices) {
+            if (slice.repeats < minRepeats)
+                continue;
+            const split = key.indexOf('\n');
+            const modelId = key.slice(split + 1);
+            const model = catalogue.byId.get(modelId);
+            if (!model)
+                continue;
+            out.push({
+                label: key.slice(0, split),
+                model: modelId,
+                modelName: model.displayName,
+                repeats: slice.repeats,
+                checkedCalls: slice.checkedCalls,
+                usd: slice.usd,
+                withinMs,
+            });
+        }
+        return out.sort((a, b) => b.usd - a.usd);
+    };
+    return { add, finish };
+}
+/** The same measurement over a list of records, for a caller holding one. */
+export function repeatedTurns(records, options) {
+    const tracker = createRepeatsTracker(options);
+    for (const record of records)
+        tracker.add(record);
+    return tracker.finish();
+}
+//# sourceMappingURL=repeats.js.map

package/dist/repeats.js.map

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

package/dist/reprice.d.ts

@@ -0,0 +1,143 @@
+import type { PricingCatalogue } from './pricing.js';
+import type { ModelPricing } from './types.js';
+import type { UsageBreakdown, UsageProfileReport } from './usage.js';
+/**
+ * The same tokens at another model's rates.
+ *
+ * ## Why this is allowed to exist
+ *
+ * `usage.ts` refuses to report a saving, and the reason is that a saving
+ * requires imagining a prompt nobody wrote. This does not. Every token here
+ * was actually billed; the only thing being changed is the rate card it is
+ * multiplied by, which is the same move `cacheEconomics` makes and is
+ * arithmetic rather than a guess.
+ *
+ * What it answers is the question a bill provokes and a total cannot settle:
+ * `classify` spent $4,000 on a frontier model — what would those exact calls
+ * have cost on the small one? That is a number, and it is the number a routing
+ * decision is argued over.
+ *
+ * ## The four things it refuses
+ *
+ * **It says nothing about whether the answers would be as good.** This is
+ * multiplication. Whether the cheap model can do the work is a question about
+ * the work, and Trazum has never seen the prompts — by design, there is nowhere
+ * in a usage record to put one. Every rendering states this next to the figure,
+ * because a dollar number with no caveat attached reads as a recommendation.
+ *
+ * **It refuses to price traffic that would not fit.** A cheaper model with a
+ * smaller context window does not make a 400k-token call cheaper; it makes it
+ * impossible. Slices holding a call larger than the target's window are pulled
+ * out into `overContext` and their money is excluded from every total here —
+ * counting an impossible call's price difference as a saving is exactly the
+ * flattering direction this repository refuses. `maxCallInputTokens` is the
+ * maximum rather than an average for the same reason: one call over the ceiling
+ * is a failed call, and a mean hides it.
+ *
+ * **It excludes what is already there.** Calls billed on the target model
+ * reprice to themselves, and folding them in would pad both totals with money
+ * that cannot move — a $10,000 bill of which $9,900 is already on the cheap
+ * model would report a 1% difference and read as "not worth doing". They are
+ * counted in `alreadyOnTarget` instead, so the reader sees the shape.
+ *
+ * **It assumes the token counts survive the move, and says so.** A different
+ * model tokenizes differently, and one that is worse at the task may answer at
+ * greater length or be retried. The counts are the ones that were billed, not a
+ * prediction; that makes this an exact restatement of the past at another price
+ * and an approximation of the future. Stated, not hidden — `sameTokensAssumed`
+ * exists so no rendering can forget to say it.
+ *
+ * ## Why the write TTLs are kept apart
+ *
+ * A cache write costs 1.25x input at five minutes and 2x at an hour, and that
+ * ratio is not a constant across providers. Repricing a combined write total
+ * would mean picking one of the two rates for tokens that were billed at both,
+ * so `UsageBreakdown` carries the split and this reads it. Writes whose TTL the
+ * log never stated are in the 5-minute bucket, the same assumption
+ * `cacheWriteUsdIfAssumed1h` prices — `assumedWriteTtlCalls` is carried through
+ * so a reader knows the comparison inherits it.
+ */
+/** One label-and-model slice, as billed and as it would have been billed. */
+export interface RepricedSlice {
+    label: string;
+    /** The model these calls were actually billed on. */
+    model: string;
+    calls: number;
+    /** What the log says this slice cost. */
+    currentUsd: number;
+    /** What the same tokens cost at the target's rates. */
+    targetUsd: number;
+    /** `targetUsd - currentUsd`. Negative is cheaper on the target. */
+    deltaUsd: number;
+    /** The slice's largest single call, cache reads and writes included. */
+    maxCallInputTokens: number;
+}
+/** A slice holding a call the target model could not have accepted. */
+export interface OverContextSlice {
+    label: string;
+    model: string;
+    calls: number;
+    currentUsd: number;
+    /** The call that does not fit, in tokens. */
+    maxCallInputTokens: number;
+}
+export interface RepriceReport {
+    target: {
+        id: string;
+        displayName: string;
+        /** The ceiling `overContext` was judged against. */
+        contextWindow: number;
+    };
+    /**
+     * Slices that could move, largest saving first. Ties break on the larger
+     * bill, so the row somebody would act on comes first.
+     */
+    slices: RepricedSlice[];
+    /** Totals over `slices` only — the money that would actually change hands. */
+    currentUsd: number;
+    targetUsd: number;
+    deltaUsd: number;
+    /**
+     * Slices excluded because at least one of their calls is larger than the
+     * target's context window. Their money is in none of the totals above.
+     */
+    overContext: OverContextSlice[];
+    /** Calls already billed on the target, and what they cost. Not repriced. */
+    alreadyOnTarget: {
+        calls: number;
+        usd: number;
+    };
+    /**
+     * Repriced calls whose write TTL the log did not state. Non-zero means both
+     * sides of the comparison rest on the cheaper assumption.
+     */
+    assumedWriteTtlCalls: number;
+    /**
+     * Models in the log the catalogue could not price, and how many calls they
+     * made. Their tokens could be priced on the target, but the difference
+     * cannot be — there is no current figure to subtract from. Named rather
+     * than dropped, so a comparison covering half a bill cannot look complete.
+     */
+    unpricedModels: string[];
+    unpricedCalls: number;
+    /** Always true. A field, not a comment, so a rendering can print it. */
+    sameTokensAssumed: true;
+}
+/**
+ * What a set of token counts costs on one model, at the rates in force on a
+ * date.
+ *
+ * The same arithmetic `profileUsage` does per call, over an aggregate — which
+ * is only sound because every token class is priced independently of the
+ * others and of how many calls produced them.
+ */
+export declare function priceTokensOn(breakdown: Pick<UsageBreakdown, 'inputTokens' | 'cacheReadTokens' | 'cacheWrite5mTokens' | 'cacheWrite1hTokens' | 'outputTokens'>, model: ModelPricing, on?: Date): number;
+/**
+ * Reprices a profile's label-and-model slices onto one target model.
+ *
+ * Returns `null` when the catalogue does not know the target: a comparison
+ * against a price nobody has is worse than no comparison, and the caller is
+ * better placed to say so in its own words than this is to invent a zero.
+ */
+export declare function repriceProfile(report: UsageProfileReport, targetId: string, catalogue: PricingCatalogue, on?: Date): RepriceReport | null;
+//# sourceMappingURL=reprice.d.ts.map

package/dist/reprice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reprice.d.ts","sourceRoot":"","sources":["../src/reprice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,oDAAoD;QACpD,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF;;;OAGG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,4EAA4E;IAC5E,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,iBAAiB,EAAE,IAAI,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,IAAI,CACb,cAAc,EACd,aAAa,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,cAAc,CACjG,EACD,KAAK,EAAE,YAAY,EACnB,EAAE,GAAE,IAAiB,GACpB,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,EAC3B,EAAE,GAAE,IAAiB,GACpB,aAAa,GAAG,IAAI,CA0DtB"}