agentfootprint-lens 0.53.0 → 0.53.3

package/README.md

@@ -78,6 +78,7 @@ changes.
 |---|---|
 | `agentfootprint-lens/why` | Replay a recording as the agent's own milestones. `<WhyLens recording={...} />` takes the recording straight (`recordRun()`'s `{ snapshot, events, structure }`, or the `persistRecording` envelope), validates it at mount, and mounts the shipped `<Lens>` shell on the milestone axis — plus the axis helpers (`scrubAxisFor`, `stepForCommitIdx`, `stepForRuntimeStageId`, `resolveNavigation`) for hosts holding one cursor across views. |
 | `agentfootprint-lens/skillgraph` | Debug how a run routed through its skills. `<SkillGraphDebugger recorder={...} />` plus its headless selectors (`selectSkillRoute`, `selectSkillBeats`, `selectSkillTopology`, `selectSkillFrameContext`, `stepForRuntimeStageId`, `resolveNavigation`). |
+| `agentfootprint-lens/context` | The context object at a stop, key by key — who wrote each, what moved, what was served. `<ContextView runner={...} />` walks the milestone axis on its own; hand it `cursor` and it follows the ONE cursor (0.53.1). |
 
 The axis model in three sentences: one run leaves one causal trace, and each
 lens replays one AXIS of it — the Why reading scrubs the milestones, the Flow

package/dist/{Lens-CcVUyiCm.d.cts → Lens-DHmINGvn.d.cts}

@@ -3,8 +3,8 @@ import { ToolChoiceCall, ToolChoiceSummary } from 'agentfootprint/observe';
 import * as agentfootprint from 'agentfootprint';
 import { CommentaryTemplates } from 'agentfootprint';
 import React__default, { Ref } from 'react';
-import { a as LensCursorReading, C as CursorPosition, L as LensCursor, e as NavigationResult, h as LensRecorder } from './lensCursor-B8HFFZgR.cjs';
-import { C as ChartGroupHighlight, c as LensCursorPort, H as Humanizer, b as BookmarkStore } from './tagAxis-BUrsQ1fX.cjs';
+import { a as LensCursorReading, C as CursorPosition, L as LensCursor, e as NavigationResult, h as LensRecorder } from './lensCursor-BQyMCkdo.cjs';
+import { C as ChartGroupHighlight, c as LensCursorPort, H as Humanizer, b as BookmarkStore } from './tagAxis-Dh-lINvw.cjs';
 import { NodeTypes } from '@xyflow/react';
 import { TraceGraph, TraceFlowLayout, RuntimeOverlay } from 'footprint-explainable-ui/flowchart';
 

package/dist/{Lens-CdUkz_qq.d.ts → Lens-DKbZBkI8.d.ts}

@@ -3,8 +3,8 @@ import { ToolChoiceCall, ToolChoiceSummary } from 'agentfootprint/observe';
 import * as agentfootprint from 'agentfootprint';
 import { CommentaryTemplates } from 'agentfootprint';
 import React__default, { Ref } from 'react';
-import { a as LensCursorReading, C as CursorPosition, L as LensCursor, e as NavigationResult, h as LensRecorder } from './lensCursor-B8HFFZgR.js';
-import { C as ChartGroupHighlight, c as LensCursorPort, H as Humanizer, b as BookmarkStore } from './tagAxis-Cqom3DPf.js';
+import { a as LensCursorReading, C as CursorPosition, L as LensCursor, e as NavigationResult, h as LensRecorder } from './lensCursor-BQyMCkdo.js';
+import { C as ChartGroupHighlight, c as LensCursorPort, H as Humanizer, b as BookmarkStore } from './tagAxis-DuOMNXvq.js';
 import { NodeTypes } from '@xyflow/react';
 import { TraceGraph, TraceFlowLayout, RuntimeOverlay } from 'footprint-explainable-ui/flowchart';
 

package/dist/chunk-35DQLVDZ.js

@@ -0,0 +1,88 @@
+import {
+  T
+} from "./chunk-7HGQNIMP.js";
+
+// src/react/components/ServedBadge.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var BADGE_LABELS = Object.freeze({
+  verified: "Verified",
+  reconstructed: "Reconstructed",
+  damaged: "Damaged",
+  notOnRecord: "Not on record",
+  onReceipt: "on receipt",
+  receipt: "receipt",
+  rebuilt: "rebuilt"
+});
+function statusLabel(status) {
+  switch (status) {
+    case "verified":
+      return BADGE_LABELS.verified;
+    case "reconstructed":
+      return BADGE_LABELS.reconstructed;
+    case "damaged":
+      return BADGE_LABELS.damaged;
+    default:
+      return BADGE_LABELS.notOnRecord;
+  }
+}
+function statusColor(status) {
+  switch (status) {
+    case "verified":
+      return T.success;
+    case "damaged":
+      return T.error;
+    default:
+      return T.textMuted;
+  }
+}
+function Badge({ check }) {
+  const title = [
+    check.onReceipt !== void 0 ? `${BADGE_LABELS.receipt} ${check.onReceipt}` : void 0,
+    check.rebuilt !== void 0 ? `${BADGE_LABELS.rebuilt} ${check.rebuilt}` : void 0
+  ].filter((s) => s !== void 0).join(" \xB7 ");
+  const disagree = check.onReceipt !== void 0 && check.rebuilt !== void 0 && check.onReceipt !== check.rebuilt;
+  return /* @__PURE__ */ jsxs("span", { style: { display: "inline-flex", gap: 6, alignItems: "center" }, children: [
+    disagree && /* @__PURE__ */ jsxs("span", { style: hashesStyle, "data-testid": "served-hashes", children: [
+      BADGE_LABELS.receipt,
+      " ",
+      check.onReceipt,
+      " \xB7 ",
+      BADGE_LABELS.rebuilt,
+      " ",
+      check.rebuilt
+    ] }),
+    /* @__PURE__ */ jsx(
+      "span",
+      {
+        style: badgeStyle(statusColor(check.status), check.status === "not-on-record"),
+        "data-testid": "served-badge",
+        "data-status": check.status,
+        ...title !== "" ? { title } : {},
+        children: statusLabel(check.status)
+      }
+    )
+  ] });
+}
+function badgeStyle(color, dashed) {
+  return {
+    padding: "0 6px",
+    borderRadius: 999,
+    border: `1px ${dashed ? "dashed" : "solid"} ${color}`,
+    color,
+    fontSize: 10,
+    fontWeight: 600,
+    letterSpacing: "0.02em",
+    whiteSpace: "nowrap"
+  };
+}
+var hashesStyle = {
+  fontFamily: T.fontMono,
+  fontSize: 10.5,
+  color: T.textMuted
+};
+
+export {
+  BADGE_LABELS,
+  Badge
+};
+//# sourceMappingURL=chunk-35DQLVDZ.js.map

package/dist/chunk-35DQLVDZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/components/ServedBadge.tsx"],"sourcesContent":["/**\n * <Badge> — what the hash check established for one row, on screen.\n *\n * ONE OWNER, TWO VIEWS. The Served tab's list and the Served graph draw the\n * same four verdicts, so the badge, its four words and its colours live here\n * and nowhere else: a badge softened in one view and not the other would be\n * two different accounts of one record. `ServedTab` re-exports it, and its\n * `LABELS` take the four words from {@link BADGE_LABELS} rather than repeating\n * them.\n *\n * A badge is NEVER softened for a prettier picture. `'damaged'` draws Damaged,\n * whatever it sits beside.\n */\n\nimport React from 'react';\n\nimport type { FieldCheck, ServedFieldStatus } from '../../core/served/index.js';\nimport { T } from '../theme/index.js';\n\n/** The four verdicts, and the two words for the hashes they were decided by. */\nexport const BADGE_LABELS = Object.freeze({\n  verified: 'Verified',\n  reconstructed: 'Reconstructed',\n  damaged: 'Damaged',\n  notOnRecord: 'Not on record',\n  onReceipt: 'on receipt',\n  receipt: 'receipt',\n  rebuilt: 'rebuilt',\n} as const);\n\nexport function statusLabel(status: ServedFieldStatus): string {\n  switch (status) {\n    case 'verified':\n      return BADGE_LABELS.verified;\n    case 'reconstructed':\n      return BADGE_LABELS.reconstructed;\n    case 'damaged':\n      return BADGE_LABELS.damaged;\n    default:\n      return BADGE_LABELS.notOnRecord;\n  }\n}\n\nexport function statusColor(status: ServedFieldStatus): string {\n  switch (status) {\n    case 'verified':\n      return T.success;\n    case 'damaged':\n      return T.error;\n    default:\n      return T.textMuted;\n  }\n}\n\n/**\n * The status badge. Title carries the two hashes it was decided by — data.\n * When the two DISAGREE they are also printed inline, whatever the status: a\n * disagreement an excusing gap turned into \"reconstructed\" is still a fact the\n * reader wants on screen, not only in a tooltip.\n */\nexport function Badge({ check }: { check: FieldCheck }): React.ReactElement {\n  const title = [\n    check.onReceipt !== undefined ? `${BADGE_LABELS.receipt} ${check.onReceipt}` : undefined,\n    check.rebuilt !== undefined ? `${BADGE_LABELS.rebuilt} ${check.rebuilt}` : undefined,\n  ]\n    .filter((s) => s !== undefined)\n    .join(' · ');\n  const disagree =\n    check.onReceipt !== undefined &&\n    check.rebuilt !== undefined &&\n    check.onReceipt !== check.rebuilt;\n  return (\n    <span style={{ display: 'inline-flex', gap: 6, alignItems: 'center' }}>\n      {disagree && (\n        <span style={hashesStyle} data-testid=\"served-hashes\">\n          {BADGE_LABELS.receipt} {check.onReceipt} · {BADGE_LABELS.rebuilt} {check.rebuilt}\n        </span>\n      )}\n      <span\n        style={badgeStyle(statusColor(check.status), check.status === 'not-on-record')}\n        data-testid=\"served-badge\"\n        data-status={check.status}\n        {...(title !== '' ? { title } : {})}\n      >\n        {statusLabel(check.status)}\n      </span>\n    </span>\n  );\n}\n\nexport function badgeStyle(color: string, dashed: boolean): React.CSSProperties {\n  return {\n    padding: '0 6px',\n    borderRadius: 999,\n    border: `1px ${dashed ? 'dashed' : 'solid'} ${color}`,\n    color,\n    fontSize: 10,\n    fontWeight: 600,\n    letterSpacing: '0.02em',\n    whiteSpace: 'nowrap',\n  };\n}\n\nconst hashesStyle: React.CSSProperties = {\n  fontFamily: T.fontMono,\n  fontSize: 10.5,\n  color: T.textMuted,\n};\n"],"mappings":";;;;;AA0EQ,SAIF,KAJE;AAtDD,IAAM,eAAe,OAAO,OAAO;AAAA,EACxC,UAAU;AAAA,EACV,eAAe;AAAA,EACf,SAAS;AAAA,EACT,aAAa;AAAA,EACb,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AACX,CAAU;AAEH,SAAS,YAAY,QAAmC;AAC7D,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,aAAa;AAAA,IACtB,KAAK;AACH,aAAO,aAAa;AAAA,IACtB,KAAK;AACH,aAAO,aAAa;AAAA,IACtB;AACE,aAAO,aAAa;AAAA,EACxB;AACF;AAEO,SAAS,YAAY,QAAmC;AAC7D,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,EAAE;AAAA,IACX,KAAK;AACH,aAAO,EAAE;AAAA,IACX;AACE,aAAO,EAAE;AAAA,EACb;AACF;AAQO,SAAS,MAAM,EAAE,MAAM,GAA8C;AAC1E,QAAM,QAAQ;AAAA,IACZ,MAAM,cAAc,SAAY,GAAG,aAAa,OAAO,IAAI,MAAM,SAAS,KAAK;AAAA,IAC/E,MAAM,YAAY,SAAY,GAAG,aAAa,OAAO,IAAI,MAAM,OAAO,KAAK;AAAA,EAC7E,EACG,OAAO,CAAC,MAAM,MAAM,MAAS,EAC7B,KAAK,QAAK;AACb,QAAM,WACJ,MAAM,cAAc,UACpB,MAAM,YAAY,UAClB,MAAM,cAAc,MAAM;AAC5B,SACE,qBAAC,UAAK,OAAO,EAAE,SAAS,eAAe,KAAK,GAAG,YAAY,SAAS,GACjE;AAAA,gBACC,qBAAC,UAAK,OAAO,aAAa,eAAY,iBACnC;AAAA,mBAAa;AAAA,MAAQ;AAAA,MAAE,MAAM;AAAA,MAAU;AAAA,MAAI,aAAa;AAAA,MAAQ;AAAA,MAAE,MAAM;AAAA,OAC3E;AAAA,IAEF;AAAA,MAAC;AAAA;AAAA,QACC,OAAO,WAAW,YAAY,MAAM,MAAM,GAAG,MAAM,WAAW,eAAe;AAAA,QAC7E,eAAY;AAAA,QACZ,eAAa,MAAM;AAAA,QAClB,GAAI,UAAU,KAAK,EAAE,MAAM,IAAI,CAAC;AAAA,QAEhC,sBAAY,MAAM,MAAM;AAAA;AAAA,IAC3B;AAAA,KACF;AAEJ;AAEO,SAAS,WAAW,OAAe,QAAsC;AAC9E,SAAO;AAAA,IACL,SAAS;AAAA,IACT,cAAc;AAAA,IACd,QAAQ,OAAO,SAAS,WAAW,OAAO,IAAI,KAAK;AAAA,IACnD;AAAA,IACA,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,eAAe;AAAA,IACf,YAAY;AAAA,EACd;AACF;AAEA,IAAM,cAAmC;AAAA,EACvC,YAAY,EAAE;AAAA,EACd,UAAU;AAAA,EACV,OAAO,EAAE;AACX;","names":[]}

package/dist/chunk-45QIXKMD.js

@@ -0,0 +1,133 @@
+import {
+  servedRowAt,
+  servedRowForEpoch,
+  sincePrevious,
+  verify
+} from "./chunk-47W3TQT6.js";
+
+// src/core/context/contextAt.ts
+import { pathSegments, stateAt } from "footprintjs/trace";
+function logOf(snapshot) {
+  const s = snapshot;
+  return Array.isArray(s?.commitLog) ? s.commitLog : [];
+}
+function writersUpTo(log, commitIdx) {
+  const out = /* @__PURE__ */ new Map();
+  const last = Math.min(commitIdx, log.length - 1);
+  for (let i = 0; i <= last; i++) {
+    const bundle = log[i];
+    if (bundle === void 0 || typeof bundle.runtimeStageId !== "string" || !Array.isArray(bundle.trace))
+      continue;
+    for (const row of bundle.trace) {
+      const key = pathSegments(row.path)[0];
+      if (key === void 0) continue;
+      const prior = out.get(key);
+      out.set(key, {
+        wroteBy: bundle.runtimeStageId,
+        wroteAt: i,
+        enteredAt: prior?.enteredAt ?? i,
+        verb: row.verb
+      });
+    }
+  }
+  return out;
+}
+function foldAt(snapshot, commitIdx) {
+  const source = typeof snapshot === "object" && snapshot !== null ? snapshot : void 0;
+  try {
+    return stateAt(source, commitIdx);
+  } catch (e) {
+    return { error: e instanceof Error ? e.message : String(e) };
+  }
+}
+var same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+function servedFor(snapshot, cursor) {
+  try {
+    const row = servedRowAt(snapshot, cursor);
+    if (row === void 0) return {};
+    const checks = verify(row.view, row.receipt, row.receipt?.basis.runId ?? "", row.receiptCause);
+    const previous = row.previousEpoch !== void 0 ? servedRowForEpoch(snapshot, row.previousEpoch) : void 0;
+    const since = previous !== void 0 ? sincePrevious(row, previous) : void 0;
+    return {
+      served: Object.freeze({
+        row,
+        checks,
+        ...since !== void 0 ? { since } : {}
+      })
+    };
+  } catch (e) {
+    return { servedError: e instanceof Error ? e.message : String(e) };
+  }
+}
+function whyFor(events, stages) {
+  if (events === void 0 || stages.size === 0) return Object.freeze([]);
+  const out = [];
+  for (const entry of events) {
+    const id = entry.runtimeStageId;
+    if (id === void 0 || !stages.has(id)) continue;
+    out.push({ seq: entry.seq, name: entry.event.type, runtimeStageId: id });
+  }
+  return Object.freeze(out);
+}
+function contextAt(recording, cursor, options = {}) {
+  const log = logOf(recording);
+  const folded = foldAt(recording, cursor.commitIdx);
+  if ("error" in folded) {
+    return Object.freeze({
+      cursor,
+      keys: Object.freeze([]),
+      left: Object.freeze([]),
+      rows: Object.freeze([]),
+      redacted: false,
+      foldError: folded.error,
+      why: Object.freeze([])
+    });
+  }
+  const writers = writersUpTo(log, cursor.commitIdx);
+  const previous = options.previous !== void 0 ? foldAt(recording, options.previous.commitIdx) : void 0;
+  const previousState = previous !== void 0 && !("error" in previous) ? previous.state : void 0;
+  const keys = [];
+  for (const [path, value] of Object.entries(folded.state)) {
+    const w = writers.get(path);
+    const since = previousState === void 0 ? void 0 : !(path in previousState) ? "entered" : same(previousState[path], value) ? "unchanged" : "changed";
+    keys.push(
+      Object.freeze({
+        path,
+        value,
+        ...w !== void 0 ? {
+          wroteBy: w.wroteBy,
+          wroteAt: w.wroteAt,
+          enteredAt: w.enteredAt,
+          verb: w.verb
+        } : {},
+        ...since !== void 0 ? { since } : {}
+      })
+    );
+  }
+  const left = previousState === void 0 ? [] : Object.keys(previousState).filter((k) => !(k in folded.state));
+  const bundle = log[cursor.commitIdx];
+  const rows = Array.isArray(bundle?.trace) ? bundle.trace.map((r) => Object.freeze({ path: r.path, verb: r.verb })) : [];
+  const stages = /* @__PURE__ */ new Set();
+  if (bundle !== void 0 && typeof bundle.runtimeStageId === "string") stages.add(bundle.runtimeStageId);
+  for (const k of keys)
+    if (k.since !== void 0 && k.since !== "unchanged" && k.wroteBy !== void 0) stages.add(k.wroteBy);
+  const skipped = folded.skipped !== void 0 && folded.skipped.length > 0 ? folded.skipped.map((g) => g.index) : void 0;
+  const { served, servedError } = servedFor(recording, cursor);
+  return Object.freeze({
+    cursor,
+    keys: Object.freeze(keys),
+    left: Object.freeze(left),
+    rows: Object.freeze(rows),
+    basis: folded.basis,
+    redacted: folded.redacted,
+    ...skipped !== void 0 ? { skipped: Object.freeze(skipped) } : {},
+    ...served !== void 0 ? { served } : {},
+    ...servedError !== void 0 ? { servedError } : {},
+    why: whyFor(options.events, stages)
+  });
+}
+
+export {
+  contextAt
+};
+//# sourceMappingURL=chunk-45QIXKMD.js.map

package/dist/chunk-45QIXKMD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/context/contextAt.ts"],"sourcesContent":["/**\n * core/context/contextAt — the context object at a stop, with who wrote each\n * key, what moved since the previous stop, and what was served beside it.\n *\n * THE JOIN, nothing more. Three records already exist and this file writes\n * none of its own:\n *\n *   1. the COMMIT LOG — `stateAt(snapshot, commitIdx)` is the object at the\n *      stop; the trace rows of the bundles up to it name, per top-level key,\n *      the stage that last wrote it (`runtimeStageId`) and the first that\n *      did; the bundle's own rows are the DELTA of the stop;\n *   2. the RECEIPT at the stop's epoch — `servedRowAt` (the Served tab's own\n *      core) says what crossed into the model call and what the catalogue\n *      withheld; it is handed through untouched, never re-derived;\n *   3. the EVENT STREAM — entries stamped with the stages that wrote this\n *      stop's delta, or with the stop's own stage, are the \"why\" beside the\n *      keys; names only, no sentence.\n *\n * Join keys: `runtimeStageId` (commit log ⟂ events), `epoch` (commit log ⟂\n * receipt, through `servedRowAt`). A key the fold holds with no writer row —\n * the run's initial state, or a row the log lost — is `wroteBy: undefined`:\n * UNATTRIBUTED, never guessed (the reads law: omit, never deny). Owners are\n * stage ids, because that is what the record says; a word like \"host\" or\n * \"model\" is a reader's mapping, not this file's.\n *\n * Pure; frozen returns; no React. Consumers with their own UI read this.\n */\nimport { pathSegments, stateAt } from 'footprintjs/trace';\nimport type { FoldSource, FoldedState } from 'footprintjs/trace';\n\nimport type { EventLogEntry } from '../types.js';\nimport { servedRowAt, servedRowForEpoch } from '../served/servedRowAt.js';\nimport { sincePrevious, type SincePrevious } from '../served/sincePrevious.js';\nimport { verify, type ServedVerification } from '../served/verify.js';\nimport type { ServedCursor, ServedRow } from '../served/types.js';\n\n/** The slice of a footprintjs commit bundle this file reads — narrowed per row, never trusted whole. */\ninterface TraceRow {\n  readonly path: string;\n  readonly verb: string;\n}\ninterface CommitBundle {\n  readonly idx?: number;\n  readonly runtimeStageId: string;\n  readonly trace?: readonly TraceRow[];\n}\n\n/** One top-level key of the context object at the stop. */\nexport interface ContextKey {\n  readonly path: string;\n  readonly value: unknown;\n  /** The stage that LAST wrote the key, from its trace row; absent = unattributed. */\n  readonly wroteBy?: string;\n  /** The commit index of that last write. */\n  readonly wroteAt?: number;\n  /** The first commit that wrote the key — when it ENTERED the context. */\n  readonly enteredAt?: number;\n  /** The verb of the last write, from the trace row. */\n  readonly verb?: string;\n  /** How the key moved since the previous stop (absent when no previous stop was given). */\n  readonly since?: 'entered' | 'changed' | 'unchanged';\n}\n\n/** What is served beside the object at this stop — the Served tab's own row, handed through. */\nexport interface ContextServed {\n  readonly row: ServedRow;\n  readonly checks: ServedVerification;\n  readonly since?: SincePrevious;\n}\n\nexport interface ContextAt {\n  readonly cursor: ServedCursor;\n  /** Every top-level key of the fold at the stop, in the fold's key order. */\n  readonly keys: readonly ContextKey[];\n  /** Keys the previous stop held that this one does not (only with a previous stop). */\n  readonly left: readonly string[];\n  /** The trace rows the stop's own bundle wrote — its delta as the log spells it. */\n  readonly rows: readonly { readonly path: string; readonly verb: string }[];\n  /** The fold's honesty facts, as `stateAt` reports them. */\n  readonly basis?: FoldedState['basis'];\n  readonly redacted: boolean;\n  readonly skipped?: readonly number[];\n  readonly foldError?: string;\n  /** The served side at this stop's epoch, when the stop is at or after a model call. */\n  readonly served?: ContextServed;\n  /** The Served core refused this snapshot — its message, verbatim; `served` is then absent. */\n  readonly servedError?: string;\n  /** Event names raised by the stages that wrote this stop's delta, or by its own stage. */\n  readonly why: readonly {\n    readonly seq: number;\n    readonly name: string;\n    readonly runtimeStageId: string;\n  }[];\n}\n\nexport interface ContextAtOptions {\n  /** The previous stop on the reader's axis — enables `since` and `left`. */\n  readonly previous?: ServedCursor;\n  /** The recording's event stream, when the reader has one (a replay's `getEntries()`). */\n  readonly events?: readonly EventLogEntry[];\n}\n\ninterface WriterFacts {\n  readonly wroteBy: string;\n  readonly wroteAt: number;\n  readonly enteredAt: number;\n  readonly verb: string;\n}\n\nfunction logOf(snapshot: unknown): readonly CommitBundle[] {\n  const s = snapshot as { commitLog?: unknown } | null | undefined;\n  return Array.isArray(s?.commitLog) ? (s.commitLog as CommitBundle[]) : [];\n}\n\n/** Per top-level key, the first and last trace rows up to `commitIdx` (inclusive). */\nfunction writersUpTo(log: readonly CommitBundle[], commitIdx: number): ReadonlyMap<string, WriterFacts> {\n  const out = new Map<string, WriterFacts>();\n  const last = Math.min(commitIdx, log.length - 1);\n  for (let i = 0; i <= last; i++) {\n    const bundle = log[i];\n    if (bundle === undefined || typeof bundle.runtimeStageId !== 'string' || !Array.isArray(bundle.trace))\n      continue;\n    for (const row of bundle.trace) {\n      const key = pathSegments(row.path)[0];\n      if (key === undefined) continue;\n      const prior = out.get(key);\n      out.set(key, {\n        wroteBy: bundle.runtimeStageId,\n        wroteAt: i,\n        enteredAt: prior?.enteredAt ?? i,\n        verb: row.verb,\n      });\n    }\n  }\n  return out;\n}\n\nfunction foldAt(snapshot: unknown, commitIdx: number): FoldedState | { readonly error: string } {\n  const source: FoldSource | undefined =\n    typeof snapshot === 'object' && snapshot !== null ? (snapshot as FoldSource) : undefined;\n  try {\n    return stateAt(source, commitIdx);\n  } catch (e) {\n    return { error: e instanceof Error ? e.message : String(e) };\n  }\n}\n\nconst same = (a: unknown, b: unknown): boolean => JSON.stringify(a) === JSON.stringify(b);\n\nfunction servedFor(\n  snapshot: unknown,\n  cursor: ServedCursor,\n): { readonly served?: ContextServed; readonly servedError?: string } {\n  try {\n    const row = servedRowAt(snapshot, cursor);\n    if (row === undefined) return {};\n    const checks = verify(row.view, row.receipt, row.receipt?.basis.runId ?? '', row.receiptCause);\n    const previous =\n      row.previousEpoch !== undefined ? servedRowForEpoch(snapshot, row.previousEpoch) : undefined;\n    const since = previous !== undefined ? sincePrevious(row, previous) : undefined;\n    return {\n      served: Object.freeze({\n        row,\n        checks,\n        ...(since !== undefined ? { since } : {}),\n      }),\n    };\n  } catch (e) {\n    return { servedError: e instanceof Error ? e.message : String(e) };\n  }\n}\n\nfunction whyFor(events: readonly EventLogEntry[] | undefined, stages: ReadonlySet<string>): ContextAt['why'] {\n  if (events === undefined || stages.size === 0) return Object.freeze([]);\n  const out: { seq: number; name: string; runtimeStageId: string }[] = [];\n  for (const entry of events) {\n    const id = entry.runtimeStageId;\n    if (id === undefined || !stages.has(id)) continue;\n    out.push({ seq: entry.seq, name: entry.event.type, runtimeStageId: id });\n  }\n  return Object.freeze(out);\n}\n\n/**\n * The context at `cursor`: the fold's keys with their writers, the delta\n * since `options.previous`, the served side at this epoch, and the events\n * beside the delta. Returns a frozen object; a fold that cannot be replayed\n * reports `foldError` with no keys rather than an empty object pretending to\n * be one.\n */\nexport function contextAt(\n  recording: unknown,\n  cursor: ServedCursor,\n  options: ContextAtOptions = {},\n): ContextAt {\n  const log = logOf(recording);\n  const folded = foldAt(recording, cursor.commitIdx);\n  if ('error' in folded) {\n    return Object.freeze({\n      cursor,\n      keys: Object.freeze([]),\n      left: Object.freeze([]),\n      rows: Object.freeze([]),\n      redacted: false,\n      foldError: folded.error,\n      why: Object.freeze([]),\n    });\n  }\n  const writers = writersUpTo(log, cursor.commitIdx);\n  const previous = options.previous !== undefined ? foldAt(recording, options.previous.commitIdx) : undefined;\n  const previousState = previous !== undefined && !('error' in previous) ? previous.state : undefined;\n\n  const keys: ContextKey[] = [];\n  for (const [path, value] of Object.entries(folded.state)) {\n    const w = writers.get(path);\n    const since: ContextKey['since'] | undefined =\n      previousState === undefined\n        ? undefined\n        : !(path in previousState)\n          ? 'entered'\n          : same(previousState[path], value)\n            ? 'unchanged'\n            : 'changed';\n    keys.push(\n      Object.freeze({\n        path,\n        value,\n        ...(w !== undefined\n          ? {\n              wroteBy: w.wroteBy,\n              wroteAt: w.wroteAt,\n              enteredAt: w.enteredAt,\n              verb: w.verb,\n            }\n          : {}),\n        ...(since !== undefined ? { since } : {}),\n      }),\n    );\n  }\n  const left =\n    previousState === undefined ? [] : Object.keys(previousState).filter((k) => !(k in folded.state));\n\n  const bundle = log[cursor.commitIdx];\n  const rows = Array.isArray(bundle?.trace)\n    ? bundle.trace.map((r: TraceRow) => Object.freeze({ path: r.path, verb: r.verb }))\n    : [];\n\n  const stages = new Set<string>();\n  if (bundle !== undefined && typeof bundle.runtimeStageId === 'string') stages.add(bundle.runtimeStageId);\n  for (const k of keys)\n    if (k.since !== undefined && k.since !== 'unchanged' && k.wroteBy !== undefined) stages.add(k.wroteBy);\n\n  const skipped =\n    folded.skipped !== undefined && folded.skipped.length > 0\n      ? folded.skipped.map((g) => g.index)\n      : undefined;\n  const { served, servedError } = servedFor(recording, cursor);\n\n  return Object.freeze({\n    cursor,\n    keys: Object.freeze(keys),\n    left: Object.freeze(left),\n    rows: Object.freeze(rows),\n    basis: folded.basis,\n    redacted: folded.redacted,\n    ...(skipped !== undefined ? { skipped: Object.freeze(skipped) } : {}),\n    ...(served !== undefined ? { served } : {}),\n    ...(servedError !== undefined ? { servedError } : {}),\n    why: whyFor(options.events, stages),\n  });\n}\n"],"mappings":"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","names":[]}