waterplane 0.0.1 → 0.1.6

package/packages/host/dist/ctxlog/ctxproject.js

@@ -0,0 +1,198 @@
+/** The cursor as the wire document, and the row sparkline. Moved from ctxlog.ts. */
+import { updateContextLog } from "./ctxupdate.js";
+import { agentEnvelope, agentSpendAt, liveAgentOf } from "./ctxagents.js";
+import { seriesCostFields, downsample } from "@waterplane/shared";
+import { projectCold, projectCompaction } from "./ctxcursor.js";
+/**
+ * The model table the client gets, and the permutation that gets it there.
+ *
+ * The cursor claims a slot on FIRST SIGHT, because that is the only order a
+ * single forward pass can assign. The client needs them ordered by VOLUME: the
+ * order is what picks a colour, the palette has four validated slots and no
+ * fifth, so the models that fall off the end have to be the small ones and the
+ * dominant model has to be slot 0 on both this screen and the all-sessions one.
+ *
+ * So the table is sorted once, here, and every index that pointed into it is
+ * rewritten. Sorting the table without rewriting the indices is the failure
+ * this function exists to make impossible — every sample would keep pointing at
+ * the model that used to be in that slot, and the chart would be confidently,
+ * silently, wrong about which model did what.
+ */
+export function modelOrder(cur) {
+    const idx = cur.models.map((_, i) => i);
+    // Ties broken by the id, so two models with identical totals do not swap
+    // places (and swap colours) between one read and the next.
+    idx.sort((a, b) => (cur.modelTok[b] - cur.modelTok[a]) || (cur.models[a] < cur.models[b] ? -1 : 1));
+    const at = new Array(cur.models.length);
+    idx.forEach((from, to) => { at[from] = to; });
+    return { models: idx.map((i) => cur.models[i]), at };
+}
+/** Project a cursor into the document a client gets. */
+export function projectContextLog(cur) {
+    const order = modelOrder(cur);
+    return {
+        // Re-pointed onto the sorted table, into NEW objects: `downsample` returns
+        // the cursor's own array when the series is under the cap, and rewriting a
+        // field in place would corrupt the live cursor every other projection.
+        samples: downsample(cur.samples).map((s) => (s.model != null ? { ...s, model: order.at[s.model] } : s)),
+        models: order.models,
+        events: cur.events,
+        turns: cur.turns,
+        usageTok: cur.usageTok,
+        split: cur.split,
+        // Null, never a breakdown of zeros, when not one record could be priced:
+        // a $0 beside a conversation that visibly ran reads as "this was free",
+        // and the honest answer is that nothing here knows what it cost. The
+        // unpriced tokens travel either way, so the screen can say which it is.
+        cost: cur.cost.total > 0 ? cur.cost : null,
+        unpricedTok: cur.unpriced,
+        compaction: projectCompaction(cur.compaction),
+        coldStarts: projectCold(cur.cold),
+        autoCompactTok: cur.autoCompactTok,
+        model: cur.model,
+        skills: cur.skills,
+        truncated: cur.truncated,
+        mtime: cur.mtime,
+    };
+}
+/**
+ * Parse one conversation log into a context-window series, from scratch.
+ *
+ * The stateless form, for a caller with nowhere to keep a cursor (and for the
+ * tests, where "the same file read twice gives the same answer" is the point).
+ */
+export function readContextLog(path) {
+    const cur = updateContextLog(path, null);
+    return cur ? projectContextLog(cur) : null;
+}
+// ── The row miniature ─────────────────────────────────────────────────────
+/** Readings in a sparkline. Sixteen is what fits legibly in ~72 px. */
+export const SPARK_POINTS = 16;
+/**
+ * Event ticks in a sparkline.
+ *
+ * Six, not ten. A tick is a full-height rule across a 76 px box, and past a
+ * handful of them the miniature reads as a hatch pattern rather than a curve
+ * with things marked on it — which loses the curve, the thing the row is
+ * actually for. The count is in the badge's title text either way.
+ */
+export const SPARK_MARKS = 6;
+/**
+ * The same series, small enough to ride on `SessionInfo`.
+ *
+ * A sparkline's x axis is the READING, not the clock — the standard convention,
+ * and the only one available here: sixteen points cannot carry a time axis, and
+ * an event tick placed by time against a curve placed by index would sit beside
+ * the drop it is naming rather than on it. So the ticks are placed by finding
+ * the reading nearest each event and using ITS index, which keeps the tick and
+ * the cliff together whatever the spacing does.
+ */
+/**
+ * The session's list-price cost, as the three optional fields the spark carries.
+ *
+ * Its own function because the rule is a conjunction that is easy to get wrong
+ * inline: the figure is the conversation's cost PLUS its agents', and a total
+ * of zero is not a cost of zero — it is a conversation nothing in the rate
+ * table could price, which must come out absent so the row falls back to
+ * tokens. `unpricedTok` is published whenever there IS one, including beside a
+ * real cost: a session that ran an unknown model for half its turns has a
+ * figure that is true and low, and saying so is the only honest form of it.
+ */
+function costFields(cur, agents) {
+    // An agent tally from before this field existed cannot say what its logs
+    // cost, and the rule `usageTok` follows applies to money first: a figure that
+    // leaves the agents out is worse than no figure. So an absent agent cost
+    // withholds the WHOLE reading rather than publishing the parent's half of it.
+    if (!agents.cost)
+        return {};
+    const total = cur.cost.total + agents.cost.total;
+    const unpriced = cur.unpriced + (agents.unpriced || 0);
+    return {
+        ...(total > 0 ? { costUsd: total } : {}),
+        ...(total > 0 && agents.cost.total > 0 ? { agentCostUsd: agents.cost.total } : {}),
+        ...(unpriced > 0 ? { unpricedTok: unpriced } : {}),
+    };
+}
+export function sparkOf(cur, windowTok, windowFrom, 
+/** What this session's subagents have spent (`agentUsage`), when the caller
+ *  looked. Absent ⇒ the spark carries no total at all rather than one that
+ *  silently leaves the agents out — on a fan-out session those ARE the bill. */
+agents, 
+/** The clock `liveAgentOf` asks recency against — a parameter for the test. */
+now = Date.now()) {
+    const pts = downsample(cur.samples, SPARK_POINTS);
+    if (!pts.length)
+        return null;
+    const last = pts.length - 1;
+    const marks = [];
+    // Newest events first, so what survives the cap is what just happened.
+    //
+    // A `rebuild` is deliberately NOT a mark. The curve is the window, and a
+    // re-write leaves the window exactly where it was — there is nothing at that
+    // x for a tick to point at. It also has no validated colour of its own (the
+    // chart has two event colours, measured under three kinds of colour
+    // blindness in both themes), and painting it in the usage-limit red would
+    // say "your account refused this request", which is a different and much
+    // more alarming claim. It travels as a COUNT on `coldStarts` and as a
+    // sentence instead.
+    for (const e of cur.events.filter((e) => e.kind !== "rebuild").slice(-SPARK_MARKS)) {
+        let idx = 0;
+        // Nearest reading by time. Linear, over at most sixteen points.
+        for (let i = 1; i <= last; i++) {
+            if (Math.abs(pts[i].t - e.t) < Math.abs(pts[idx].t - e.t))
+                idx = i;
+        }
+        marks.push({ at: last ? idx / last : 0, kind: e.kind });
+    }
+    // The spend curve, index-for-index with the readings. Emitted only when the
+    // backend actually records output tokens: a series of zeros would draw a flat
+    // line along the floor, which reads as "this session has spent nothing"
+    // rather than as "nobody measured it". Absent, and the row draws no second
+    // miniature — the `ContextSpark.usedPts` rule.
+    const usedPts = pts.some((p) => p.used != null && p.used > 0)
+        ? pts.map((p) => p.used ?? 0)
+        : null;
+    // The agents' own windows, bucketed onto these same readings — the one fact
+    // a fan-out session's row otherwise hides (the parent at 31%, an agent at 97%).
+    const agentEnv = agents?.runs ? agentEnvelope(pts.map((p) => p.t), agents.runs) : null;
+    // What the agents had SPENT by each of those readings, so the spend
+    // miniature stacks them on the parent's curve the way the sheet's spend chart
+    // does. Only beside `usedPts` — a stack needs the parent band under it.
+    const agentUsedPts = usedPts && agents?.files ? agentSpendAt(pts.map((p) => p.t), agents) : null;
+    const live = agents?.files ? liveAgentOf(agents, now) : null;
+    return {
+        pts: pts.map((p) => p.tok),
+        ...(usedPts ? { usedPts } : {}),
+        ...(agentEnv ? { agentEnv } : {}),
+        ...(agentUsedPts ? { agentUsedPts } : {}),
+        ...(live ? { liveAgentTok: live.tok, liveAgentAt: live.at, liveAgentId: live.id, ...(live.type ? { liveAgentType: live.type } : {}) } : {}),
+        marks,
+        peak: cur.samples.reduce((m, p) => (p.tok > m ? p.tok : m), 0),
+        // The three the cost reading needs, off the FULL series rather than `pts`.
+        // Derived in `@waterplane/shared` so the context sheet — which holds the same
+        // series at full resolution — cannot decide for itself what a baseline is.
+        // The truncated case withholds the baseline there; see `seriesCostFields`.
+        // `turns` is COUNTED (`cur.turns`), never `samples.length` — see the field.
+        ...seriesCostFields(cur.samples, cur.truncated, cur.turns),
+        // The total, and the agent share of it. Both absent when nobody looked at
+        // the subagent directory: "1.4M used" that omits eight agents is worse than
+        // no figure, and the phone words what it gets, never what it assumes.
+        ...(agents ? { usageTok: cur.usageTok + agents.tok, agentTok: agents.tok } : {}),
+        // …and the same two facts in money, which is what the row PRINTS. They
+        // follow `usageTok` exactly: absent unless the agents were looked at, so
+        // the chip can never quote a figure that leaves eight conversations out,
+        // and absent (never `0`) when nothing could be priced at all — the row
+        // then falls back to the token total, which is what it showed before any
+        // of this existed. `unpricedTok` travels beside them so the title can name
+        // what was left out instead of the chip silently coming in low.
+        ...(agents ? costFields(cur, agents) : {}),
+        windowTok,
+        windowFrom,
+        autoCompactTok: cur.autoCompactTok,
+        // Three small numbers, on the spark that every launcher row already holds:
+        // this is the one fact about a conversation's price that the curve above it
+        // cannot show, because a re-write leaves the window exactly where it was.
+        coldStarts: projectCold(cur.cold),
+    };
+}
+//# sourceMappingURL=ctxproject.js.map

package/packages/host/dist/ctxlog/ctxproject.js.map

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

package/packages/host/dist/ctxlog/ctxupdate.d.ts

@@ -0,0 +1,11 @@
+import type { SeriesCursor } from "./ctxcursor.js";
+/**
+ * Advance a cursor over whatever the CLI has appended since it was last read
+ * — or build one from scratch.
+ *
+ * Null only when the file is not there. An empty or unreadable log yields an
+ * empty cursor, because "the CLI has not written anything yet" and "the format
+ * moved under us" are both states the caller has to be able to say out loud,
+ * and neither is an error.
+ */
+export declare function updateContextLog(path: string, prev?: SeriesCursor | null): SeriesCursor | null;

package/packages/host/dist/ctxlog/ctxupdate.js

@@ -0,0 +1,338 @@
+/** Advance a cursor over what the CLI appended: updateContextLog. Moved from ctxlog.ts. */
+import { statSync } from "node:fs";
+import { addCost, addTotals, costOf, isColdRebuild, normalizeModel, tokenTotal, zeroCost, zeroTotals } from "@waterplane/shared";
+import { localDay, stamp, toMs } from "../convlog.js";
+import { opensTurn } from "../transcript/transcriptlog.js";
+import { RAW_CAP, EVENT_CAP, readRange, num, blankCold, blankCompaction, addSaved, remember, blank, skillLoadOf, pushSkill } from "./ctxcursor.js";
+/**
+ * Advance a cursor over whatever the CLI has appended since it was last read
+ * — or build one from scratch.
+ *
+ * Null only when the file is not there. An empty or unreadable log yields an
+ * empty cursor, because "the CLI has not written anything yet" and "the format
+ * moved under us" are both states the caller has to be able to say out loud,
+ * and neither is an error.
+ */
+export function updateContextLog(path, prev) {
+    // A file that shrank, went backwards in time, or is a different path is a
+    // different conversation as far as this is concerned — a fork writes a new
+    // log under a new id, and a rewritten one cannot be appended to.
+    const reusable = prev && prev.path === path && prev.size > 0;
+    const cur = reusable ? prev : blank(path);
+    // A stat, not a read: this runs on every poll, and a probe that READ the
+    // file re-read up to MAX_READ of a big log each time only to learn its size.
+    let st;
+    try {
+        st = statSync(path);
+    }
+    catch {
+        return null;
+    }
+    const rewound = reusable && (st.size < cur.size || st.mtimeMs < cur.mtime);
+    const from = reusable && !rewound ? cur.consumed : 0;
+    // FORWARD, to the end, never a tail: a tail-read log started its totals,
+    // its compactions and its chart in the middle and printed them as whole.
+    // Incremental after the first pass, so the whole-file read happens once.
+    let read = readRange(path, from);
+    if (!read)
+        return null;
+    if (from === 0 && cur !== prev) { /* fresh cursor, nothing to reset */ }
+    else if (from === 0) {
+        cur.consumed = 0;
+        cur.samples = [];
+        cur.events = [];
+        cur.turns = 0;
+        cur.usageTok = 0;
+        cur.split = zeroTotals();
+        cur.cost = zeroCost();
+        cur.unpriced = 0;
+        cur.models = [];
+        cur.modelTok = [];
+        cur.cum = zeroTotals();
+        cur.compaction = blankCompaction();
+        cur.shedAuto = 0;
+        cur.shedManual = 0;
+        cur.pendingRebuild = null;
+        cur.prevTok = 0;
+        cur.prevAt = 0;
+        cur.cold = blankCold();
+        cur.autoCompactTok = null;
+        cur.model = null;
+        cur.effort = null;
+        cur.skills = [];
+        cur.truncated = false;
+        cur.seen.clear();
+        cur.seenOrder.length = 0;
+    }
+    let added = 0;
+    for (;;) {
+        for (const line of read.lines) {
+            if (!line || line.charCodeAt(0) !== 123 /* { */)
+                continue;
+            // Cheap pre-filter: three quarters of a conversation log is tool results,
+            // and `JSON.parse` on 20 MB of them is the whole cost of this function.
+            //
+            // The turn count needs the USER records too, and they carry no `usage`. The
+            // bulk of them are tool results, so those are excluded by the one byte
+            // sequence that cannot be forged from prose: inside a JSON string every
+            // quote is escaped, so the unescaped `"type":"tool_result"` only ever
+            // appears as real structure — a prompt that talks ABOUT tool results is
+            // written `\"type\":\"tool_result\"` and still gets through.
+            const maybeTurn = line.includes('"type":"user"') && !line.includes('"type":"tool_result"');
+            if (!maybeTurn
+                && !line.includes('"usage"') && !line.includes('"compactMetadata"') && !line.includes('"quotaLimits"'))
+                continue;
+            let row;
+            try {
+                row = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            // A subagent's records are a different conversation's context, and on this
+            // CLI they are not in this file at all — measured on this desktop: 0 of
+            // 7,761 logs carry an `isSidechain` row, because a Task agent writes
+            // `<conversation>/subagents/agent-*.jsonl` instead. The guard stays for the
+            // older shape, and what those agents SPENT is added by `agentUsage()` off
+            // that directory — counting the inline form here as well would double it on
+            // any CLI that writes both.
+            if (row.isSidechain === true)
+                continue;
+            if (maybeTurn) {
+                if (opensTurn(row))
+                    cur.turns++;
+                // A skill body is a meta user record — never a turn, but the one
+                // moment the log says a skill's text entered this window.
+                const sk = skillLoadOf(row, stamp(row));
+                if (sk)
+                    pushSkill(cur.skills, sk);
+                // A user record is never a reading, a compaction or a wall — nothing
+                // below this line can match one, and the stamp it lacks would drop it.
+                continue;
+            }
+            const t = stamp(row);
+            if (t == null)
+                continue;
+            const meta = row.compactMetadata;
+            if (meta && typeof meta === "object") {
+                const trigger = meta.trigger === "auto" ? "auto" : meta.trigger === "manual" ? "manual" : undefined;
+                const preTok = num(meta.preTokens);
+                const postTok = num(meta.postTokens);
+                cur.events.push({
+                    kind: "compact", t,
+                    ...(trigger ? { trigger } : {}),
+                    ...(preTok ? { preTok } : {}),
+                    ...(postTok ? { postTok } : {}),
+                });
+                // Newest wins: the threshold is a property of the CLI version and the
+                // model in force, and both can change inside one conversation.
+                if (trigger === "auto" && preTok)
+                    cur.autoCompactTok = preTok;
+                // …and into the ledger. A boundary the log did not date with BOTH ends,
+                // or did not say who asked for, is counted in `unmeasured` and enters no
+                // figure: attributing it to the wrong trigger would answer "was typing
+                // /compact worth it" with the CLI's own decisions folded in.
+                if (trigger && preTok > 0 && postTok > 0 && preTok > postTok) {
+                    cur.compaction[trigger].count++;
+                    cur.compaction[trigger].shedTok += preTok - postTok;
+                    if (trigger === "auto")
+                        cur.shedAuto += preTok - postTok;
+                    else
+                        cur.shedManual += preTok - postTok;
+                    cur.pendingRebuild = trigger;
+                }
+                else
+                    cur.compaction.unmeasured++;
+                continue;
+            }
+            const quota = row.quotaLimits;
+            if (quota && typeof quota === "object" && quota.status === "rejected") {
+                const resetAt = toMs(quota.resetsAt);
+                const weekly = typeof quota.rateLimitType === "string" && quota.rateLimitType !== "five_hour";
+                cur.events.push({ kind: "limit", t, ...(resetAt != null ? { resetAt } : {}), ...(weekly ? { weekly } : {}) });
+                continue;
+            }
+            if (row.type !== "assistant")
+                continue;
+            const msg = row.message;
+            if (!msg || typeof msg !== "object")
+                continue;
+            // The rejection above is written as an assistant turn too, with
+            // `<synthetic>` for a model and a usage block of zeros. Plotting it would
+            // put a hard drop to zero on the graph at every usage wall — the opposite
+            // of what happened.
+            if (msg.model === "<synthetic>")
+                continue;
+            const usage = msg.usage;
+            if (!usage || typeof usage !== "object")
+                continue;
+            if (typeof msg.model === "string")
+                cur.model = msg.model; // newest wins
+            // Off the same record, so the pair always names one turn: a record with
+            // no effort clears it rather than leaving the previous turn's beside it.
+            cur.effort = typeof row.effort === "string" ? row.effort : null;
+            if (typeof msg.id === "string" && !remember(cur, msg.id))
+                continue;
+            const tok = num(usage.input_tokens) + num(usage.cache_read_input_tokens) + num(usage.cache_creation_input_tokens);
+            // What the request sent AND what it wrote back. Counted before the `tok`
+            // guard below on purpose: a turn that carried nothing readable still spent
+            // its output, and dropping it would make the total quietly low.
+            cur.usageTok += tok + num(usage.output_tokens);
+            // The same tokens by kind, off the same record and behind the same guards,
+            // so the split cannot come out disagreeing with the total beside it. The
+            // 1-hour cache-write tier is READ (`tokenstats.ts` measured it at 84% of
+            // all writes and present on every record carrying one) because it is what
+            // the payback ratio in `cacheReading` is blended over; absent simply
+            // prices at the cheaper tier, which is the conservative direction.
+            const out = num(usage.output_tokens);
+            // A record whose four counters are all zero is not a request that ran, and
+            // `tokenstats.ts` drops it before its own turn counter. Dropped here too:
+            // the totals are unaffected either way (it adds nothing), but the two
+            // screens divide context BY these turns, and a denominator that counted
+            // something on one screen and not the other is a per-turn figure that
+            // disagrees with itself.
+            const cc = usage.cache_creation;
+            const bag = {
+                input: num(usage.input_tokens),
+                output: out,
+                cacheRead: num(usage.cache_read_input_tokens),
+                cacheWrite: num(usage.cache_creation_input_tokens),
+                cacheWrite1h: cc && typeof cc === "object" ? num(cc.ephemeral_1h_input_tokens) : 0,
+                // A REQUEST, not a turn — see the field.
+                turns: 1,
+            };
+            // The model's slot in this conversation's table, claimed on first sight.
+            // Linear, over a list that is one or two entries long in every real log.
+            //
+            // Keyed by the ALIAS, not by the logged id. The log records dated snapshots
+            // and the long-context marker beside the plain id — the same model at the
+            // same price — and banded by raw id they are two slots, two colours and two
+            // legend entries reading `opus-5` and `opus-5`. Measured on a real
+            // conversation here: a parent and its own subagent took separate slots and
+            // the bar came out a different colour from the band above it while both
+            // sentences named one model. `pricing.ts` still prices the RAW id, which is
+            // where the dated snapshot belongs.
+            const raw = typeof msg.model === "string" ? msg.model : null;
+            const mid = raw ? normalizeModel(raw) ?? raw : null;
+            let mi = mid ? cur.models.indexOf(mid) : -1;
+            if (mid && mi < 0) {
+                mi = cur.models.length;
+                cur.models.push(mid);
+                cur.modelTok.push(0);
+            }
+            if (mi >= 0)
+                cur.modelTok[mi] += tok + out;
+            if (tok > 0 || out > 0) {
+                addTotals(cur.split, bag);
+                addTotals(cur.cum, bag);
+                // …and what it cost, on THIS record's own model and day. One bag, two
+                // accumulators, so the money and the tokens cannot come from different
+                // sets of records; `cur.model` is deliberately not used here (it is the
+                // newest one, and it would charge the whole conversation at whatever ran
+                // last). An unpriced model adds to `unpriced` and to no cost line — see
+                // the field.
+                const c = costOf(bag, raw, localDay(t));
+                if (c)
+                    addCost(cur.cost, c);
+                else
+                    cur.unpriced += tokenTotal(bag);
+            }
+            if (tok <= 0)
+                continue;
+            // ── Did this request come back to an expired cache? ──────────────────
+            //
+            // Asked HERE, before `pendingRebuild` is consumed, because the request
+            // after a compaction boundary is the one case that looks exactly like a
+            // rebuild and is not: the window was thrown away on purpose, its rebuild
+            // is charged to the compaction ledger three lines down, and counting it
+            // here too would bill compacting twice.
+            //
+            // The event carries the GAP as well as the tokens, because "this turn
+            // wrote 172k" is only alarming once you know the conversation had been
+            // asleep for fourteen hours — and the curve cannot show it: the window
+            // does not move, so the shape of the graph says nothing at all about the
+            // turn that cost twenty times the one before it.
+            if (isColdRebuild(cur.prevTok, bag, { afterCompaction: cur.pendingRebuild != null })) {
+                const gapMs = cur.prevAt > 0 ? t - cur.prevAt : 0;
+                cur.cold.count++;
+                cur.cold.tok += bag.cacheWrite;
+                cur.cold.lastAt = t;
+                cur.cold.lastTok = bag.cacheWrite;
+                // Priced on THIS record's own model and day, like everything else here.
+                // Two figures: what the writes cost, and what they cost ABOVE reading
+                // the same tokens back — the second is the money the clock spent rather
+                // than the work, and it is the one the sentence leads with.
+                const wrote = costOf({ input: 0, output: 0, cacheRead: 0, cacheWrite: bag.cacheWrite, cacheWrite1h: bag.cacheWrite1h }, raw, localDay(t));
+                const asRead = costOf({ input: 0, output: 0, cacheRead: bag.cacheWrite, cacheWrite: 0, cacheWrite1h: 0 }, raw, localDay(t));
+                if (wrote) {
+                    cur.cold.usd += wrote.total;
+                    if (asRead)
+                        cur.cold.premiumUsd += Math.max(0, wrote.total - asRead.total);
+                }
+                cur.events.push({ kind: "rebuild", t, wroteTok: bag.cacheWrite, prevTok: cur.prevTok, ...(gapMs > 0 ? { gapMs } : {}) });
+            }
+            cur.prevTok = tok;
+            cur.prevAt = t;
+            // What the compactions have saved by the time of THIS request, and what
+            // the first one after a boundary paid to rebuild the window.
+            //
+            // Here, on a request that actually carried context, because that is what
+            // the saving is about: a request re-sends the window, and every one of
+            // them since a boundary re-sent `shed` fewer tokens than it would have.
+            // A request that carried nothing re-sent nothing.
+            if (cur.shedAuto > 0)
+                addSaved(cur.compaction.auto, cur.shedAuto, raw, t);
+            if (cur.shedManual > 0)
+                addSaved(cur.compaction.manual, cur.shedManual, raw, t);
+            if (cur.pendingRebuild) {
+                const row = cur.compaction[cur.pendingRebuild];
+                row.rebuildTok += bag.cacheWrite;
+                const c = costOf({ input: 0, output: 0, cacheRead: 0, cacheWrite: bag.cacheWrite, cacheWrite1h: bag.cacheWrite1h }, raw, localDay(t));
+                if (c)
+                    row.rebuildUsd += c.total;
+                cur.pendingRebuild = null;
+            }
+            // The running total rides ALONG with the reading rather than being folded
+            // out of the series later: `usageTok` counts requests the readings skip (a
+            // turn that carried nothing readable still spent its output), so a cumsum
+            // over `samples` would end somewhere below the total the same parse prints
+            // three lines down. Two totals differing by a few percent is the most
+            // convincing wrong number this file could produce.
+            // The kinds ride ON the sample, not beside it: they are what the stacked
+            // chart is drawn from, and a parallel array would have to survive the
+            // downsampler's min/max pick — which reorders — to stay index-for-index.
+            cur.samples.push({
+                t, tok, used: cur.usageTok,
+                kinds: [bag.input, bag.output, bag.cacheRead, bag.cacheWrite],
+                cum: [cur.cum.input, cur.cum.output, cur.cum.cacheRead, cur.cum.cacheWrite],
+                ...(mi >= 0 ? { model: mi } : {}),
+            });
+            added++;
+        }
+        const moved = read.consumed > cur.consumed;
+        cur.consumed = read.consumed;
+        cur.size = read.size;
+        cur.mtime = read.mtime;
+        if (cur.samples.length > RAW_CAP) {
+            cur.samples.splice(0, cur.samples.length - RAW_CAP);
+            cur.truncated = true;
+        }
+        if (!moved || cur.consumed >= cur.size)
+            break;
+        const next = readRange(path, cur.consumed);
+        if (!next)
+            break;
+        read = next;
+    }
+    if (cur.events.length > EVENT_CAP)
+        cur.events.splice(0, cur.events.length - EVENT_CAP);
+    // The log is append-ordered, but a resumed conversation can interleave and a
+    // tail read can start anywhere; the graph's x axis has to be monotonic. Only
+    // worth doing when something actually arrived.
+    if (added)
+        cur.samples.sort((a, b) => a.t - b.t);
+    if (added || from === 0)
+        cur.events.sort((a, b) => a.t - b.t);
+    return cur;
+}
+//# sourceMappingURL=ctxupdate.js.map

package/packages/host/dist/ctxlog/ctxupdate.js.map

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

package/packages/host/dist/ctxlog.d.ts

@@ -0,0 +1,56 @@
+/**
+ * How full the context window has been — asked of the CLI's own log, which is
+ * DATED.
+ *
+ * `context.ts` reads a percentage off the terminal. That is the right thing for
+ * a badge and it is the wrong thing for a graph, for the same reason
+ * `limitlog.ts` exists: a screen carries no clock. The scraped meter is one
+ * number, overwritten in place, with no record of what it was ten minutes ago
+ * and nothing at all to say about the moment it dropped from 4% to 96%. A
+ * series accumulated from it host-side would start empty on every restart, hold
+ * only what one daemon lifetime saw, and — because the indicator is not always
+ * on screen — be full of holes it could not describe.
+ *
+ * The CLI already writes every one of these facts down, timestamped, in the
+ * conversation jsonl:
+ *
+ *  - every assistant turn carries `message.usage`, and
+ *    `input_tokens + cache_read_input_tokens + cache_creation_input_tokens` is
+ *    what that request actually sent — the context the model saw. Output is
+ *    excluded on purpose: it is not context until the turn after.
+ *  - a compaction writes `{"type":"system","subtype":"compact_boundary",
+ *    "compactMetadata":{"trigger":"auto"|"manual","preTokens":…,"postTokens":…}}`
+ *    — which is both WHEN the drop happened and how far it fell.
+ *  - a usage-limit rejection writes the `quotaLimits` row `limitlog.ts` already
+ *    reads, so the walls land on the same time axis at no extra cost.
+ *
+ * Read-only and best-effort, like `transcript.ts`: an unparseable line is
+ * skipped, and a missing file yields null. Every log is read WHOLE, forward in
+ * `MAX_READ` chunks — a tail read printed a total that started in the middle
+ * as if it were complete. `truncated` now means only that the chart's raw
+ * samples passed `RAW_CAP`.
+ *
+ * **What the session SPENT is a second question, and it is answered here too.**
+ * The series is the input side of THIS conversation — the right number for "what
+ * does the next turn re-read" and the wrong one for "what has this cost me". So
+ * `usageTok` adds each turn's output, and `agentUsage()` reads the Task tool's
+ * own logs beside it (`<conversation>/subagents/agent-*.jsonl`), which is where
+ * a fan-out session's tokens actually went: a 30k window over eight agents is
+ * millions. Both are FLOORS and both are absent rather than approximate.
+ *
+ * **The window SIZE is not in the log.** Nothing here guesses it. `totalTok` is
+ * whatever the TUI was seen to print and null otherwise, and the separate
+ * `autoCompactTok` is a measurement — the tokens an auto-compact was last
+ * observed to fire at — never relabelled as a window.
+ *
+ * The code is cut by subject into `ctxlog/` (this file is the barrel every
+ * importer keeps using): `ctxcursor.ts` (the cursor and its accumulators),
+ * `ctxupdate.ts` (the incremental pass), `ctxproject.ts` (the wire document and
+ * the row miniature) and `ctxagents.ts` (what the subagents spent).
+ */
+export { MAX_SAMPLES, downsample } from "@waterplane/shared";
+export type { ContextLog, SeriesCursor } from "./ctxlog/ctxcursor.js";
+export { updateContextLog } from "./ctxlog/ctxupdate.js";
+export { SPARK_MARKS, SPARK_POINTS, projectContextLog, readContextLog, sparkOf } from "./ctxlog/ctxproject.js";
+export type { AgentFile, AgentRunRaw, AgentUsage } from "./ctxlog/ctxagents.js";
+export { agentCumOf, agentEnvelope, agentSpendAt, agentUsage, liveAgentOf, thinMax, withAgentRuns } from "./ctxlog/ctxagents.js";