@songsid/agend 2.1.12 → 2.2.0-alpha.2

package/dist/cache-analysis.js

@@ -0,0 +1,147 @@
+/**
+ * #1468: the prompt-cache expiry analysis — pure, over a ledger (cache-ledger.ts). For a window [from, to]:
+ *
+ * - Each gap carries the TTL of the cache it sat on, as that session last wrote it: Claude Code's own write split
+ *   (1 hour, or 5 minutes), Codex's 30 minutes (GPT-5.6 and later). Sessions of one instance can differ.
+ * - An expired request: one that came after a gap longer than its TTL and had to write at least half of the context
+ *   the previous request left cached (the cache can outlive its TTL; then nothing was lost). What it rewrote, up to
+ *   that context, is the expiry's tokens; its cost is those tokens at the write rate minus what reading them would
+ *   have cost, at the returning request's own price tier.
+ * - Keep-warm, simulated: a ping at every I = TTL − TTL/10 after a request (t + k·I, k ≥ 1, up to and including
+ *   the moment the gap ends — floor(gap / I) of them), each reading the cached context at that context's own tier.
+ *   Only pings whose instant falls inside the window are counted. A gap that ended in an expired request inside the
+ *   window saves its expiry cost; any other gap only pays for its pings. After a session's last request the pings
+ *   are pure loss, up to the moment the next session of the instance starts, or the window ends.
+ * - Recommendation: on when the simulated pings cost less than the expiries they prevent (by a margin), else off.
+ *
+ * Money is list price (cache-prices.ts). If any model the window touches — requests, pinged contexts, idle tails —
+ * is missing from the table, the whole instance is weighed in input-price units instead (write 1.25x, 1-hour write
+ * 2x, read 0.1x, output 5x) and shows no dollars.
+ */
+import { ratesFor } from "./cache-prices.js";
+import { GAP_BUCKETS } from "./cache-ledger.js";
+export const UNITS = { input: 1, read: 0.1, write5m: 1.25, write1h: 2, write: 1.25, output: 5 };
+const M = 1_000_000;
+export const pingIntervalMs = (ttlSec) => Math.round(ttlSec * 900);
+const writeRate = (r, ttlSec) => (ttlSec >= 3600 ? r.write1h : ttlSec <= 300 ? r.write5m : r.write);
+/** Pings at t + k·I (k ≥ 1) no later than `end`, counted only where they fall inside [from, to]. */
+export function pingsBetween(t, end, intervalMs, from, to) {
+    if (!(intervalMs > 0))
+        return 0;
+    const kMin = Math.max(1, Math.ceil((from - t) / intervalMs));
+    const kMax = Math.floor((Math.min(end, to) - t) / intervalMs);
+    return Math.max(0, kMax - kMin + 1);
+}
+/** The keep-warm simulation over a window's long gaps and its sessions' ends. */
+export function simulate(gaps, tails, o) {
+    const res = { pastTtl: 0, expired: 0, rewriteTokens: 0, expiryCost: 0, pings: 0, pingCost: 0, tailPings: 0, tailCost: 0, net: 0, estimated: false };
+    let saved = 0;
+    for (const [tEnd, gap, ctx, ctxModel, ttl, model, prompt, measured, estimated] of gaps) {
+        if (tEnd < o.from)
+            continue;
+        const start = tEnd - Math.round(gap * 1000);
+        const pings = pingsBetween(start, tEnd, pingIntervalMs(ttl), o.from, o.to);
+        if (pings) {
+            res.pings += pings;
+            res.pingCost += pings * ctx * o.rates(ctxModel, ctx).read / M;
+        }
+        if (tEnd > o.to || !(gap > ttl))
+            continue;
+        res.pastTtl++;
+        const useMeasured = o.measured && measured !== null;
+        if (!useMeasured)
+            res.estimated = true;
+        const rewrite = useMeasured ? measured : estimated;
+        const lost = Math.min(rewrite, ctx);
+        if (ctx > 0 && lost >= ctx / 2) {
+            const r = o.rates(model, prompt);
+            const cost = lost * (writeRate(r, ttl) - r.read) / M;
+            res.expired++;
+            res.rewriteTokens += lost;
+            res.expiryCost += cost;
+            saved += cost;
+        }
+    }
+    for (const tail of tails) {
+        const n = pingsBetween(tail.t, tail.until, pingIntervalMs(tail.ttl), o.from, o.to);
+        if (!n)
+            continue;
+        res.tailPings += n;
+        res.tailCost += n * tail.ctx * o.rates(tail.model, tail.ctx).read / M;
+    }
+    res.net = saved - res.pingCost - res.tailCost;
+    return res;
+}
+/**
+ * Each session's end: its last request, until the next session of the instance starts (the earliest other session
+ * that starts at or after it — one that starts at the same instant leaves no idle time), or `to`.
+ */
+export function sessionTails(ledger, to) {
+    const sessions = Object.values(ledger.files).filter((f) => f.last && f.first !== undefined).map((f) => ({ first: f.first, last: f.last }));
+    return sessions.map((s) => {
+        let until = to;
+        for (const o of sessions)
+            if (o !== s && o.first >= s.last.t && o.first < until)
+                until = o.first;
+        return { t: s.last.t, ctx: s.last.ctx, model: s.last.model, ttl: s.last.ttl, until };
+    });
+}
+/** Codex GPT-5.6 and later bill cache writes and keep a prefix 30 minutes. */
+export const isOpenAiTtlModel = (model) => /^gpt-(5\.(6|[7-9])|[6-9])/.test(model);
+/** Requests in a window below this are too few to say anything. */
+export const MIN_REQUESTS = 3;
+export function analyzeLedger(ledger, o) {
+    const listed = o.rates ?? ratesFor;
+    const inWindow = (h) => h + 3_600_000 > o.from && h <= o.to;
+    const tails = sessionTails(ledger, o.to);
+    const estimatedTotals = o.backend === "codex" && !ledger.writesSeen;
+    // One unit for the whole instance: dollars when every model that contributes to this window is priced — the
+    // window's requests, and whatever the simulation itself prices (a pinged context, an expired request, an idle tail).
+    // A probe run records exactly the models the simulation asks a rate for.
+    const requestModels = new Set();
+    for (const [hk, hour] of Object.entries(ledger.hours)) {
+        if (!inWindow(Number(hk)))
+            continue;
+        for (const mk of Object.keys(hour.m))
+            requestModels.add(mk.slice(0, mk.lastIndexOf("|")));
+    }
+    const touched = new Set(requestModels);
+    simulate(ledger.gaps, tails, { rates: (model) => { touched.add(model); return UNITS; }, from: o.from, to: o.to, measured: !estimatedTotals });
+    const priced = [...touched].every((m) => listed(m, 0) !== null);
+    const rates = (model, prompt) => (priced ? listed(model, prompt) : null) ?? UNITS;
+    const gapBuckets = new Array(GAP_BUCKETS).fill(0);
+    let requests = 0, totalCost = 0;
+    for (const [hk, hour] of Object.entries(ledger.hours)) {
+        if (!inWindow(Number(hk)))
+            continue;
+        hour.g.forEach((n, i) => { gapBuckets[i] += n; });
+        for (const [mk, [n, uncached, read, write5m, write1h, write, output]] of Object.entries(hour.m)) {
+            const bar = mk.lastIndexOf("|");
+            const model = mk.slice(0, bar), long = mk.slice(bar + 1) === "1";
+            requests += n;
+            const r = rates(model, long ? Number.MAX_SAFE_INTEGER : 0);
+            // Codex on GPT-5.6+ with no recorded writes: its uncached input is what got written (the estimate).
+            const uncachedRate = estimatedTotals && isOpenAiTtlModel(model) ? r.write : r.input;
+            totalCost += (uncached * uncachedRate + read * r.read + write5m * r.write5m + write1h * r.write1h + write * r.write + output * r.output) / M;
+        }
+    }
+    const sim = simulate(ledger.gaps, tails, { rates, from: o.from, to: o.to, measured: !estimatedTotals });
+    const latest = tails.reduce((a, t) => (!a || t.t > a.t ? t : a), null);
+    const ttlSec = latest ? latest.ttl : o.backend === "codex" ? 1800 : 3600;
+    const assumedTtl = o.backend === "codex" && [...requestModels].some((m) => !isOpenAiTtlModel(m));
+    let recommendation;
+    if (requests < MIN_REQUESTS)
+        recommendation = { on: false, reason: "quiet" };
+    else if (!sim.expired)
+        recommendation = { on: false, reason: "never_expired" };
+    else if (sim.net > 0 && sim.net >= sim.expiryCost * 0.1)
+        recommendation = { on: true, reason: "saves" };
+    else
+        recommendation = { on: false, reason: "costs_more", pingsPerExpiry: Math.round((sim.pings + sim.tailPings) / sim.expired) };
+    return {
+        // An estimate when anything shown used one: the totals (Codex with no recorded write), a gap's rewrite, a TTL.
+        requests, ttlSec, estimate: (estimatedTotals && requests > 0) || sim.estimated || assumedTtl, priced, models: [...requestModels].sort(), gapBuckets, sim,
+        totalCost, share: totalCost > 0 ? sim.expiryCost / totalCost : null, recommendation,
+    };
+}
+//# sourceMappingURL=cache-analysis.js.map

package/dist/cache-analysis.js.map

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

package/dist/cache-ledger.d.ts

@@ -0,0 +1,108 @@
+/**
+ * #1468: what the prompt-cache analysis keeps per instance — never the transcripts themselves. Each model request a
+ * CLI made (a Claude assistant message, a Codex `token_count`) becomes a "turn"; the ledger folds turns into:
+ * - hourly totals per model and price tier (requests and tokens: uncached input, cache reads, cache writes, output)
+ *   with the hour's histogram of gaps between consecutive requests of the same session;
+ * - one event per long gap (≥ GAP_EVENT_SEC): when it ended, how long it was, the context it left cached, what the
+ *   request after it wrote to the cache — all the keep-warm simulation needs;
+ * - per transcript file: where reading stopped (a line start), and the session's first and last request.
+ * That keeps a month of a busy fleet in kilobytes per instance, and a file is read once, incrementally.
+ *
+ * Usage fields (real shapes, checked 2026-10-09):
+ * - Claude Code: `message.usage` { input_tokens, cache_read_input_tokens, cache_creation_input_tokens,
+ *   cache_creation: { ephemeral_5m_input_tokens, ephemeral_1h_input_tokens }, output_tokens }. A message spans several
+ *   lines (one per content block) carrying the same id and usage: counted once.
+ * - Codex (0.160): `event_msg` `token_count` with `info.last_token_usage` { input_tokens (cached included),
+ *   cached_input_tokens, cache_write_input_tokens, output_tokens }. The write field exists but was 0 in every one of
+ *   38,551 real events on GPT-5.6+ models — so a write is estimated as the request's uncached input unless a real
+ *   write count shows up. The model comes from the preceding `turn_context`.
+ */
+import { type ScanLine } from "./cache-scan.js";
+export type TranscriptKind = "claude" | "codex";
+/** One model request, as the transcript records it. */
+export interface Turn {
+    t: number;
+    model: string;
+    /** Everything the request sent: uncached input + cache reads + cache writes. */
+    prompt: number;
+    uncached: number;
+    read: number;
+    write5m: number;
+    write1h: number;
+    /** An OpenAI cache write as recorded (null: not recorded, 0 included when the field is absent). */
+    write: number | null;
+    output: number;
+}
+/** Gap histogram edges, seconds: ≤5 min, ≤30 min, ≤1 h, ≤2 h, ≤6 h, ≤24 h, longer. */
+export declare const GAP_EDGES: readonly [300, 1800, 3600, 7200, 21600, 86400];
+export declare const GAP_BUCKETS: number;
+/** Gaps at least this long are kept one by one (the shortest keep-warm interval is a 5-minute TTL's 270 s). */
+export declare const GAP_EVENT_SEC = 240;
+export declare const KEEP_DAYS = 31;
+/** [requests, uncached, read, write5m, write1h, write, output] */
+export type HourTotals = [number, number, number, number, number, number, number];
+export interface HourAgg {
+    m: Record<string, HourTotals>;
+    g: number[];
+}
+/**
+ * One long gap: [tEnd, gapSec, contextCached, contextModel, ttlSec, model, promptAfter, measuredWrite, estimatedWrite].
+ * - `contextCached`/`contextModel`: what the previous request left cached, and its model — what a ping would read.
+ * - `ttlSec`: the TTL of that cache as the session last wrote it (Claude's own write split; Codex's 30 minutes).
+ * - `measuredWrite`: what the request after the gap recorded writing (Claude always; Codex its write field, 0
+ *   included, or null when the field is absent). `estimatedWrite`: Codex's uncached input — used only while the
+ *   instance has never recorded a real write (the field exists but stays 0 on the CLIs seen so far).
+ */
+export type GapEvent = [number, number, number, string, number, string, number, number | null, number];
+export interface SessionPoint {
+    t: number;
+    ctx: number;
+    model: string;
+    ttl: number;
+}
+export interface FileCursor {
+    kind: TranscriptKind;
+    ino: number;
+    offset: number;
+    first?: number;
+    last?: SessionPoint;
+    /** Claude: the TTL the session's latest cache write used (1 h or 5 min). */
+    ttl?: number;
+    /** The file size at which only an unfinished line was left: not read again until the file grows. */
+    stalled?: number;
+    /** Codex: the model of the latest turn_context; the last cumulative total (token_count repeats itself). */
+    model?: string;
+    total?: number;
+    /** Claude: ids of the last messages counted (one message spans several lines). */
+    ids?: string[];
+}
+export interface Ledger {
+    v: 2;
+    files: Record<string, FileCursor>;
+    hours: Record<string, HourAgg>;
+    gaps: GapEvent[];
+    /** A real OpenAI cache-write count was seen (Codex): writes are then measured, not estimated. */
+    writesSeen?: boolean;
+}
+export declare function emptyLedger(): Ledger;
+/** A ledger read back from disk; anything that is not one is a fresh ledger. */
+export declare function reviveLedger(raw: unknown): Ledger;
+export declare const hourOf: (t: number) => number;
+export declare const gapBucket: (sec: number) => number;
+/** The key hourly totals are kept under: the model, and whether the request paid its long-prompt row. */
+export declare const modelKey: (model: string, prompt: number) => string;
+/** Codex keeps a prefix 30 minutes (GPT-5.6 and later; assumed for any other Codex model, which is then an estimate). */
+export declare const CODEX_TTL_SEC = 1800;
+/** The TTL a Claude request's own cache writes used: its write split decides; no write leaves the session's as it was. */
+export declare function claudeTtlAfter(turn: Turn, current: number | undefined): number;
+/**
+ * Fold one turn into the ledger, in file order. Turns older than `cutoff` only move the session's last point (the
+ * next gap needs it); everything else is counted. Pure apart from mutating `ledger`.
+ */
+export declare function addTurn(ledger: Ledger, file: FileCursor, turn: Turn, cutoff: number): void;
+/** Drop what is older than `cutoff` (hours and gap events). */
+export declare function pruneLedger(ledger: Ledger, cutoff: number): void;
+/** The turn a Claude Code transcript line records, or null; a message already counted (`file.ids`) is null too. */
+export declare function claudeLine(line: ScanLine, file: FileCursor): Turn | null;
+/** The turn a Codex rollout line records, or null. A `turn_context` line updates the file's model. */
+export declare function codexLine(line: ScanLine, file: FileCursor): Turn | null;

package/dist/cache-ledger.js

@@ -0,0 +1,230 @@
+/**
+ * #1468: what the prompt-cache analysis keeps per instance — never the transcripts themselves. Each model request a
+ * CLI made (a Claude assistant message, a Codex `token_count`) becomes a "turn"; the ledger folds turns into:
+ * - hourly totals per model and price tier (requests and tokens: uncached input, cache reads, cache writes, output)
+ *   with the hour's histogram of gaps between consecutive requests of the same session;
+ * - one event per long gap (≥ GAP_EVENT_SEC): when it ended, how long it was, the context it left cached, what the
+ *   request after it wrote to the cache — all the keep-warm simulation needs;
+ * - per transcript file: where reading stopped (a line start), and the session's first and last request.
+ * That keeps a month of a busy fleet in kilobytes per instance, and a file is read once, incrementally.
+ *
+ * Usage fields (real shapes, checked 2026-10-09):
+ * - Claude Code: `message.usage` { input_tokens, cache_read_input_tokens, cache_creation_input_tokens,
+ *   cache_creation: { ephemeral_5m_input_tokens, ephemeral_1h_input_tokens }, output_tokens }. A message spans several
+ *   lines (one per content block) carrying the same id and usage: counted once.
+ * - Codex (0.160): `event_msg` `token_count` with `info.last_token_usage` { input_tokens (cached included),
+ *   cached_input_tokens, cache_write_input_tokens, output_tokens }. The write field exists but was 0 in every one of
+ *   38,551 real events on GPT-5.6+ models — so a write is estimated as the request's uncached input unless a real
+ *   write count shows up. The model comes from the preceding `turn_context`.
+ */
+import { objectAt } from "./cache-scan.js";
+import { isLongPrompt } from "./cache-prices.js";
+/** Gap histogram edges, seconds: ≤5 min, ≤30 min, ≤1 h, ≤2 h, ≤6 h, ≤24 h, longer. */
+export const GAP_EDGES = [300, 1800, 3600, 7200, 21600, 86400];
+export const GAP_BUCKETS = GAP_EDGES.length + 1;
+/** Gaps at least this long are kept one by one (the shortest keep-warm interval is a 5-minute TTL's 270 s). */
+export const GAP_EVENT_SEC = 240;
+export const KEEP_DAYS = 31;
+/** A dictionary keyed by names from outside (paths, model ids): every key an own property (#1467 lesson). */
+const dict = () => Object.create(null);
+export function emptyLedger() { return { v: 2, files: dict(), hours: dict(), gaps: [] }; }
+/** A ledger read back from disk; anything that is not one is a fresh ledger. */
+export function reviveLedger(raw) {
+    const l = emptyLedger();
+    if (!raw || typeof raw !== "object" || raw.v !== 2)
+        return l;
+    const r = raw;
+    for (const [k, v] of Object.entries(r.files ?? {}))
+        if (v && typeof v.offset === "number")
+            l.files[k] = v;
+    for (const [k, v] of Object.entries(r.hours ?? {})) {
+        if (!v || !Array.isArray(v.g))
+            continue;
+        const m = dict();
+        for (const [mk, tot] of Object.entries(v.m ?? {}))
+            if (Array.isArray(tot) && tot.length === 7)
+                m[mk] = tot;
+        l.hours[k] = { m, g: v.g };
+    }
+    if (Array.isArray(r.gaps))
+        l.gaps = r.gaps.filter((g) => Array.isArray(g) && g.length === 9);
+    if (r.writesSeen)
+        l.writesSeen = true;
+    return l;
+}
+const HOUR = 3_600_000;
+export const hourOf = (t) => Math.floor(t / HOUR) * HOUR;
+export const gapBucket = (sec) => { let i = 0; while (i < GAP_EDGES.length && sec > GAP_EDGES[i])
+    i++; return i; };
+/** The key hourly totals are kept under: the model, and whether the request paid its long-prompt row. */
+export const modelKey = (model, prompt) => `${model}|${isLongPrompt(model, prompt) ? 1 : 0}`;
+/** Codex keeps a prefix 30 minutes (GPT-5.6 and later; assumed for any other Codex model, which is then an estimate). */
+export const CODEX_TTL_SEC = 1800;
+const CLAUDE_DEFAULT_TTL_SEC = 3600;
+/** The TTL a Claude request's own cache writes used: its write split decides; no write leaves the session's as it was. */
+export function claudeTtlAfter(turn, current) {
+    if (turn.write1h > 0 || turn.write5m > 0)
+        return turn.write5m > turn.write1h ? 300 : 3600;
+    return current ?? CLAUDE_DEFAULT_TTL_SEC;
+}
+/**
+ * Fold one turn into the ledger, in file order. Turns older than `cutoff` only move the session's last point (the
+ * next gap needs it); everything else is counted. Pure apart from mutating `ledger`.
+ */
+export function addTurn(ledger, file, turn, cutoff) {
+    const prev = file.last;
+    const ttlBefore = file.kind === "claude" ? (file.ttl ?? CLAUDE_DEFAULT_TTL_SEC) : CODEX_TTL_SEC;
+    if (file.kind === "claude")
+        file.ttl = claudeTtlAfter(turn, file.ttl);
+    file.first ??= turn.t;
+    file.last = { t: turn.t, ctx: turn.prompt + turn.output, model: turn.model, ttl: file.kind === "claude" ? file.ttl : CODEX_TTL_SEC };
+    if (turn.write !== null && turn.write > 0)
+        ledger.writesSeen = true;
+    if (turn.t < cutoff)
+        return;
+    const hk = String(hourOf(turn.t));
+    const hour = ledger.hours[hk] ??= { m: dict(), g: new Array(GAP_BUCKETS).fill(0) };
+    const mk = modelKey(turn.model, turn.prompt);
+    const tot = hour.m[mk] ??= [0, 0, 0, 0, 0, 0, 0];
+    tot[0] += 1;
+    tot[1] += turn.uncached;
+    tot[2] += turn.read;
+    tot[3] += turn.write5m;
+    tot[4] += turn.write1h;
+    tot[5] += turn.write ?? 0;
+    tot[6] += turn.output;
+    if (!prev)
+        return;
+    const gap = (turn.t - prev.t) / 1000;
+    if (!(gap >= 0))
+        return;
+    hour.g[gapBucket(gap)] += 1;
+    if (gap < GAP_EVENT_SEC)
+        return;
+    const measured = file.kind === "claude" ? turn.write5m + turn.write1h : turn.write;
+    const estimated = file.kind === "claude" ? turn.write5m + turn.write1h : turn.uncached + (turn.write ?? 0);
+    ledger.gaps.push([turn.t, gap, prev.ctx, prev.model, ttlBefore, turn.model, turn.prompt, measured, estimated]);
+}
+/** Drop what is older than `cutoff` (hours and gap events). */
+export function pruneLedger(ledger, cutoff) {
+    for (const k of Object.keys(ledger.hours))
+        if (Number(k) + HOUR <= cutoff)
+            delete ledger.hours[k];
+    if (ledger.gaps.length && ledger.gaps[0][0] < cutoff)
+        ledger.gaps = ledger.gaps.filter((g) => g[0] >= cutoff);
+}
+// ── Reading turns out of transcript lines ──
+const num = (v) => (typeof v === "number" && Number.isFinite(v) && v > 0 ? v : 0);
+const CLAUDE_ID = /"id":"(msg_[A-Za-z0-9_-]{1,120})"/;
+const CLAUDE_ID_G = /"id":"(msg_[A-Za-z0-9_-]{1,120})"/g;
+const CLAUDE_MODEL = /"model":"([^"]{1,120})"/;
+const CLAUDE_MODEL_G = /"model":"([^"]{1,120})"/g;
+const TIMESTAMP = /"timestamp":"([^"]{10,40})"/g;
+const lastMatch = (text, re) => { const all = [...text.matchAll(re)]; return all.length ? all[all.length - 1][1] : undefined; };
+function lastUsage(text) {
+    const at = text.lastIndexOf("\"usage\":{");
+    const obj = at === -1 ? null : objectAt(text, at + "\"usage\":".length);
+    try {
+        return obj ? JSON.parse(obj) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function claudeTurn(u, model, ts) {
+    if (!u || typeof model !== "string" || typeof ts !== "string")
+        return null;
+    const t = Date.parse(ts);
+    if (!Number.isFinite(t))
+        return null;
+    const input = num(u.input_tokens), read = num(u.cache_read_input_tokens), creation = num(u.cache_creation_input_tokens);
+    const split = u.cache_creation;
+    let write1h = num(split?.ephemeral_1h_input_tokens), write5m = num(split?.ephemeral_5m_input_tokens);
+    // No split recorded (older CLIs): the API's default, a 5-minute write.
+    if (!split && creation)
+        write5m = creation;
+    if (split && write1h + write5m !== creation)
+        write5m = Math.max(0, creation - write1h);
+    return { t, model, prompt: input + read + creation, uncached: input, read, write5m, write1h, write: null, output: num(u.output_tokens) };
+}
+/** The turn a Claude Code transcript line records, or null; a message already counted (`file.ids`) is null too. */
+export function claudeLine(line, file) {
+    let id, turn = null;
+    if ("whole" in line) {
+        if (line.whole.indexOf("\"usage\"") === -1 || line.whole.indexOf("\"assistant\"") === -1)
+            return null;
+        let d;
+        try {
+            d = JSON.parse(line.whole.toString("utf8"));
+        }
+        catch {
+            return null;
+        }
+        if (d.type !== "assistant" || d.isSidechain === true || !d.message)
+            return null;
+        id = typeof d.message.id === "string" ? d.message.id : undefined;
+        if (id && file.ids?.includes(id))
+            return null;
+        turn = claudeTurn(d.message.usage, d.message.model, d.timestamp);
+    }
+    else {
+        // A long line, kept as its two ends. Claude writes the model and id near the start and the usage and timestamp
+        // near the end, but where `type` and `isSidechain` sit depends on the writer: both ends are searched alike.
+        const head = line.head.toString("utf8"), tail = line.tail.toString("utf8");
+        const either = (needle) => head.includes(needle) || tail.includes(needle);
+        if (!either("\"type\":\"assistant\"") || either("\"isSidechain\":true"))
+            return null;
+        id = CLAUDE_ID.exec(head)?.[1] ?? lastMatch(tail, CLAUDE_ID_G);
+        if (id && file.ids?.includes(id))
+            return null;
+        const usage = lastUsage(tail) ?? lastUsage(head);
+        const ts = lastMatch(tail, TIMESTAMP) ?? lastMatch(head, TIMESTAMP);
+        turn = claudeTurn(usage, CLAUDE_MODEL.exec(head)?.[1] ?? lastMatch(tail, CLAUDE_MODEL_G), ts);
+    }
+    if (turn && id)
+        file.ids = [...(file.ids ?? []).slice(-15), id];
+    return turn;
+}
+/** The turn a Codex rollout line records, or null. A `turn_context` line updates the file's model. */
+export function codexLine(line, file) {
+    if (!("whole" in line))
+        return null; // token_count and turn_context lines are small
+    const w = line.whole;
+    const isCount = w.indexOf("\"token_count\"") !== -1;
+    if (!isCount && w.indexOf("\"turn_context\"") === -1)
+        return null;
+    let d;
+    try {
+        d = JSON.parse(w.toString("utf8"));
+    }
+    catch {
+        return null;
+    }
+    const p = d.payload;
+    if (!p)
+        return null;
+    if (d.type === "turn_context") {
+        if (typeof p.model === "string")
+            file.model = p.model;
+        return null;
+    }
+    if (d.type !== "event_msg" || p.type !== "token_count")
+        return null;
+    const info = p.info;
+    const u = info?.last_token_usage;
+    if (!u || typeof d.timestamp !== "string")
+        return null;
+    // The same usage is re-announced (a rate-limit update): the running total has not moved.
+    const total = num(info?.total_token_usage?.total_tokens);
+    if (total && file.total === total)
+        return null;
+    if (total)
+        file.total = total;
+    const t = Date.parse(d.timestamp);
+    if (!Number.isFinite(t))
+        return null;
+    const input = num(u.input_tokens), read = Math.min(num(u.cached_input_tokens), input);
+    const write = typeof u.cache_write_input_tokens === "number" ? Math.min(num(u.cache_write_input_tokens), input - read) : null;
+    return { t, model: file.model ?? "unknown", prompt: input, uncached: input - read - (write ?? 0), read, write5m: 0, write1h: 0, write, output: num(u.output_tokens) };
+}
+//# sourceMappingURL=cache-ledger.js.map

package/dist/cache-ledger.js.map

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

package/dist/cache-prices.d.ts

@@ -0,0 +1,32 @@
+/**
+ * #1468: list prices for the prompt-cache analysis — the one table, with the day it was checked against the vendors'
+ * own pricing pages. USD per million tokens, standard tier, global routing (no batch, fast, data-residency or
+ * regional uplift: AgEnD's CLIs run on subscriptions, so these are list-price equivalents, not a bill).
+ *
+ * Claude (platform.claude.com/docs/en/about-claude/pricing): a 5-minute cache write is 1.25x base input, a 1-hour
+ * write 2x; a cache hit is 0.1x, except 0.05x on Opus/Sonnet 5.5 and 0.025x on Fable/Mythos 5.1. Haiku 5.5 is priced
+ * by prompt length (over 100,000 tokens: the higher row), counting cache reads and writes.
+ * OpenAI (developers.openai.com/api/docs/pricing, …/guides/prompt-caching): on GPT-5.6 and later a cache write is
+ * 1.25x uncached input and the cache lives 30 minutes after its last write or reuse; prompts over 272K input tokens
+ * pay the long-context row.
+ */
+export declare const PRICES_CHECKED = "2026-10-09";
+export declare const PRICE_SOURCES: readonly ["https://platform.claude.com/docs/en/about-claude/pricing", "https://developers.openai.com/api/docs/pricing", "https://developers.openai.com/api/docs/guides/prompt-caching"];
+/** USD per million tokens. `write` is the one cache-write rate an OpenAI model has; Claude has `write5m`/`write1h`. */
+export interface Rates {
+    input: number;
+    read: number;
+    write5m: number;
+    write1h: number;
+    write: number;
+    output: number;
+}
+/**
+ * The table's key for a model id as a transcript records it: "claude-opus-4-5-20251101" → "claude-opus-4-5",
+ * "claude-opus-5-5[1m]" → "claude-opus-5-5". Exact keys only — "claude-opus-5" never prices "claude-opus-5-5".
+ */
+export declare function priceKey(model: string | null | undefined): string | null;
+/** The rates for one request of `model` with a prompt of `promptTokens`; null when the model is not in the table. */
+export declare function ratesFor(model: string | null | undefined, promptTokens?: number): Rates | null;
+/** Whether a prompt of this size pays the model's long-context (or over-100K) row. */
+export declare function isLongPrompt(model: string | null | undefined, promptTokens: number): boolean;

package/dist/cache-prices.js

@@ -0,0 +1,73 @@
+/**
+ * #1468: list prices for the prompt-cache analysis — the one table, with the day it was checked against the vendors'
+ * own pricing pages. USD per million tokens, standard tier, global routing (no batch, fast, data-residency or
+ * regional uplift: AgEnD's CLIs run on subscriptions, so these are list-price equivalents, not a bill).
+ *
+ * Claude (platform.claude.com/docs/en/about-claude/pricing): a 5-minute cache write is 1.25x base input, a 1-hour
+ * write 2x; a cache hit is 0.1x, except 0.05x on Opus/Sonnet 5.5 and 0.025x on Fable/Mythos 5.1. Haiku 5.5 is priced
+ * by prompt length (over 100,000 tokens: the higher row), counting cache reads and writes.
+ * OpenAI (developers.openai.com/api/docs/pricing, …/guides/prompt-caching): on GPT-5.6 and later a cache write is
+ * 1.25x uncached input and the cache lives 30 minutes after its last write or reuse; prompts over 272K input tokens
+ * pay the long-context row.
+ */
+export const PRICES_CHECKED = "2026-10-09";
+export const PRICE_SOURCES = [
+    "https://platform.claude.com/docs/en/about-claude/pricing",
+    "https://developers.openai.com/api/docs/pricing",
+    "https://developers.openai.com/api/docs/guides/prompt-caching",
+];
+const claude = (input, read, output) => ({ input, read, write5m: input * 1.25, write1h: input * 2, write: input * 1.25, output });
+const openai = (input, read, write, output) => ({ input, read, write5m: write, write1h: write, write, output });
+const TABLE = {
+    "claude-fable-5-1": { rates: [claude(10, 0.25, 50)] },
+    "claude-mythos-5-1": { rates: [claude(10, 0.25, 50)] },
+    "claude-fable-5": { rates: [claude(10, 1, 50)] },
+    "claude-mythos-5": { rates: [claude(10, 1, 50)] },
+    "claude-opus-5-5": { rates: [claude(4, 0.20, 20)] },
+    "claude-opus-5": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-8": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-7": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-6": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-5": { rates: [claude(5, 0.50, 25)] },
+    "claude-opus-4-1": { rates: [claude(15, 1.50, 75)] },
+    "claude-opus-4": { rates: [claude(15, 1.50, 75)] },
+    "claude-sonnet-5-5": { rates: [claude(2, 0.10, 10)] },
+    "claude-sonnet-5": { rates: [claude(2, 0.20, 10)] },
+    "claude-sonnet-4-6": { rates: [claude(3, 0.30, 15)] },
+    "claude-sonnet-4-5": { rates: [claude(3, 0.30, 15)] },
+    "claude-sonnet-4": { rates: [claude(3, 0.30, 15)] },
+    "claude-haiku-5-5": { rates: [claude(0.10, 0.01, 0.50), claude(0.50, 0.05, 2.50)], longOver: 100_000 },
+    "claude-haiku-4-5": { rates: [claude(1, 0.10, 5)] },
+    "gpt-6.1-sol": { rates: [openai(2, 0.10, 2.50, 10), openai(4, 0.20, 5, 15)], longOver: 272_000 },
+    "gpt-6-sol": { rates: [openai(2, 0.20, 2.50, 10), openai(4, 0.40, 5, 15)], longOver: 272_000 },
+    "gpt-6-astra": { rates: [openai(10, 1, 12.50, 50), openai(20, 2, 25, 75)], longOver: 272_000 },
+    "gpt-6-luna": { rates: [openai(0.10, 0.01, 0.125, 0.50), openai(0.20, 0.02, 0.25, 0.75)], longOver: 272_000 },
+    "gpt-5.6-sol": { rates: [openai(4, 0.40, 5, 20), openai(8, 0.80, 10, 30)], longOver: 272_000 },
+    "gpt-5.6-terra": { rates: [openai(2, 0.20, 2.50, 12), openai(4, 0.40, 5, 18)], longOver: 272_000 },
+    "gpt-5.6-luna": { rates: [openai(0.20, 0.02, 0.25, 1.20), openai(0.40, 0.04, 0.50, 1.80)], longOver: 272_000 },
+};
+/**
+ * The table's key for a model id as a transcript records it: "claude-opus-4-5-20251101" → "claude-opus-4-5",
+ * "claude-opus-5-5[1m]" → "claude-opus-5-5". Exact keys only — "claude-opus-5" never prices "claude-opus-5-5".
+ */
+export function priceKey(model) {
+    if (typeof model !== "string")
+        return null;
+    const id = model.trim().toLowerCase().replace(/\[[^\]]*\]$/, "").replace(/-\d{8}$/, "");
+    return Object.prototype.hasOwnProperty.call(TABLE, id) ? id : null;
+}
+/** The rates for one request of `model` with a prompt of `promptTokens`; null when the model is not in the table. */
+export function ratesFor(model, promptTokens = 0) {
+    const key = priceKey(model);
+    if (!key)
+        return null;
+    const row = TABLE[key];
+    return row.longOver !== undefined && promptTokens > row.longOver && row.rates[1] ? row.rates[1] : row.rates[0];
+}
+/** Whether a prompt of this size pays the model's long-context (or over-100K) row. */
+export function isLongPrompt(model, promptTokens) {
+    const key = priceKey(model);
+    const row = key ? TABLE[key] : undefined;
+    return !!row && row.longOver !== undefined && promptTokens > row.longOver;
+}
+//# sourceMappingURL=cache-prices.js.map