agentfootprint 7.7.0 → 7.8.0

package/dist/types/recorders/observability/BoundaryRecorder.d.ts.map

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

package/dist/types/recorders/observability/FlowchartRecorder.d.ts

@@ -181,7 +181,9 @@ export interface FlowchartHandle {
 /**
  * Attach a live FlowchartRecorder to a runner.
  *
- *   1. Creates a `BoundaryRecorder` (the unified domain event log).
+ *   1. Creates a `BoundaryRecorder` (the unified domain event log) with
+ *      commit tracking, so every boundary records WHERE on the commit
+ *      axis it happened.
  *   2. Attaches it to the executor's FlowRecorder channel via
  *      `runnerAttach` — captures run / subflow / fork / decision / loop.
  *   3. Subscribes it to the dispatcher — captures llm.* / tool.* /
@@ -189,9 +191,18 @@ export interface FlowchartHandle {
  *   4. Wires `onUpdate` so the consumer sees a fresh derived StepGraph
  *      on every event.
  *
+ * @param getCommitCount  where each boundary sits on the run's commit
+ *   axis — the runner's `getCommitCount()`, sampled live. Optional only
+ *   because a caller may have no runner to sample; omitting it stamps
+ *   every boundary `commitIdxBefore: 0`, which reads as "all boundaries
+ *   opened at once" and leaves an offline step strip with nothing to
+ *   place. Nothing downstream can repair it — the commit log records
+ *   what stages wrote, never when a boundary was crossed — so the
+ *   runner always passes it.
+ *
  * @internal Called from `RunnerBase.enable.flowchart`.
  */
-export declare function attachFlowchart(runnerAttach: (recorder: CombinedRecorder) => () => void, dispatcher: EventDispatcher, options?: FlowchartOptions): FlowchartHandle;
+export declare function attachFlowchart(runnerAttach: (recorder: CombinedRecorder) => () => void, dispatcher: EventDispatcher, options?: FlowchartOptions, getCommitCount?: () => number): FlowchartHandle;
 /**
  * Project a `BoundaryRecorder`'s event stream into a `StepGraph`.
  *

package/dist/types/recorders/observability/FlowchartRecorder.d.ts.map

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

package/dist/types/recorders/observability/localObservability.d.ts

@@ -3,10 +3,24 @@
  * render it live, and snapshot it for offline replay.
  *
  * One handle, two outputs:
- *   - LIVE   — `onUpdate(graph)` fires per event; pass the handle to
- *              `<Lens recorder={handle} />` and it re-renders as the agent runs.
- *   - OFFLINE— `getTrace()` (any time) and `onComplete(trace)` (auto, at run
- *              exit) freeze the model into a JSON-lossless `Trace` for `<Replay>`.
+ *   - LIVE   — `onLive(graph)` fires per event with a fresh `StepGraph`; hand
+ *              it to your own renderer, or read `handle.getSnapshot()` /
+ *              `handle.boundary` whenever you like.
+ *   - OFFLINE— `getTrace()` (any time) and `onRecorded(trace)` (auto, at run
+ *              exit) freeze the model into a JSON-lossless `Trace`.
+ *
+ * This handle is NOT a Lens recorder. `<Lens recorder={…} />` wants a
+ * `LensRecorder` — a different object with a different surface — and passing
+ * this one gives a component with none of the members it calls. To put a run
+ * in front of Lens, record it and hand the recording over:
+ *
+ *   const stop = recordRun(agent);          // agentfootprint/observe
+ *   await agent.run({ message });
+ *   const recording = stop.toRecording();   // { snapshot, events, structure }
+ *
+ *   // …in the viewer:
+ *   const { recorder, runner } = observeRecording(recording);   // lens
+ *   <Lens recorder={recorder} runner={runner} />
  *
  * Contrast with `enable.observability({ strategy })` (Tier-4 / Monitor), which
  * ships each event to a vendor and FORGETS. localObservability KEEPS the model
@@ -22,7 +36,7 @@ import type { DomainEvent } from './BoundaryRecorder.js';
 import { type FlowchartHandle, type StepGraph } from './FlowchartRecorder.js';
 import { type SerializeTraceOptions, type Trace } from './trace.js';
 export interface LocalObservabilityOptions {
-    /** LIVE recording — called with a fresh StepGraph on every event (drives `<Lens>`). */
+    /** LIVE recording — called with a fresh StepGraph on every event. */
     readonly onLive?: (graph: StepGraph) => void;
     /** At run exit — called once with the finalized recording (a Trace, auto-serialized) to replay offline. */
     readonly onRecorded?: (trace: Trace) => void;
@@ -33,6 +47,52 @@ export interface LocalObservabilityOptions {
      * Pass `redactContent` for a ready-made redactor.
      */
     readonly redact?: (event: DomainEvent) => DomainEvent;
+    /**
+     * Carry the run's footprintjs snapshot (state + commit log + recorder
+     * data) in the Trace. Default `false`.
+     *
+     * A Trace WITHOUT it draws a chart and a timeline and nothing else: the
+     * commit axis, ExplainableShell's memory and provenance panels, and
+     * WhereFrom all read the commit log, which lives in the snapshot and
+     * appears nowhere in the event log. Turn this on and the Trace can feed
+     * them.
+     *
+     * Off by default because of `redact`, not because of size. `redact` is a
+     * per-DOMAIN-EVENT function — it cannot reach inside a snapshot, whose
+     * `sharedState` is the run's raw working memory. Filling this field
+     * automatically would have widened what a carefully redacted Trace
+     * exports without a line of code changing at any call site, which is the
+     * kind of quiet trust-boundary move a library has no business making.
+     * When you turn it on, redaction for the snapshot half is footprintjs's
+     * `setRedactionPolicy()` at run time — the run's own policy, applied when
+     * the values were written.
+     *
+     * For a viewer, prefer `recordRun()`: `{ snapshot, events, structure }`
+     * is the shape the UIs consume, and it is explicit about carrying state.
+     */
+    readonly includeSnapshot?: boolean;
+}
+/**
+ * The three things a live runner knows that a recorder cannot see for
+ * itself. Each one lights a different surface of the stored Trace, and a
+ * missing one degrades exactly that surface:
+ *
+ *   - `getStructure`   → the chart. Nothing else can draw it.
+ *   - `getSnapshot`    → state, commit log, every attached recorder's data.
+ *   - `getCommitCount` → where each boundary sits on the commit axis.
+ *
+ * All three are read lazily, at the moment they are needed, because all
+ * three answer differently before, during and after a run.
+ *
+ * @internal Supplied by `RunnerBase.enable.localObservability`.
+ */
+export interface RunAccess {
+    /** `() => runner.getSpec().buildTimeStructure` — the static chart. */
+    readonly getStructure?: () => unknown;
+    /** `() => runner.getLastSnapshot()` — the footprintjs run snapshot. */
+    readonly getSnapshot?: () => unknown;
+    /** `() => runner.getCommitCount()` — sampled live on every boundary. */
+    readonly getCommitCount?: () => number;
 }
 /** A `FlowchartHandle` (live) plus `getTrace()` (offline snapshot). */
 export interface LocalObservabilityHandle extends FlowchartHandle {
@@ -45,5 +105,5 @@ export interface LocalObservabilityHandle extends FlowchartHandle {
  *
  * @internal Called from `RunnerBase.enable.localObservability`.
  */
-export declare function attachLocalObservability(runnerAttach: (recorder: CombinedRecorder) => () => void, dispatcher: EventDispatcher, options?: LocalObservabilityOptions, now?: () => number, getStructure?: () => unknown): LocalObservabilityHandle;
+export declare function attachLocalObservability(runnerAttach: (recorder: CombinedRecorder) => () => void, dispatcher: EventDispatcher, options?: LocalObservabilityOptions, now?: () => number, access?: RunAccess): LocalObservabilityHandle;
 //# sourceMappingURL=localObservability.d.ts.map

package/dist/types/recorders/observability/localObservability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localObservability.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/localObservability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAmB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAkB,KAAK,qBAAqB,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC7C,2GAA2G;IAC3G,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,CAAC;CACvD;AAED,uEAAuE;AACvE,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,MAAM,IAAI,EACxD,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,yBAA8B,EACvC,GAAG,GAAE,MAAM,MAAiB,EAC5B,YAAY,CAAC,EAAE,MAAM,OAAO,GAC3B,wBAAwB,CAgC1B"}
+{"version":3,"file":"localObservability.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/localObservability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAmB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAkB,KAAK,qBAAqB,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,WAAW,yBAAyB;IACxC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC7C,2GAA2G;IAC3G,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,CAAC;IACtD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;IACrC,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC;CACxC;AAED,uEAAuE;AACvE,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,MAAM,IAAI,EACxD,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,yBAA8B,EACvC,GAAG,GAAE,MAAM,MAAiB,EAC5B,MAAM,GAAE,SAAc,GACrB,wBAAwB,CA2C1B"}

package/dist/types/recorders/observability/recordRun.d.ts

@@ -0,0 +1,144 @@
+/**
+ * recordRun — save a run so a viewer can show it later.
+ *
+ * A RECORDING is exactly three things, and each one lights a different
+ * surface:
+ *
+ *   `events`     the typed agentfootprint stream, in the order it fired —
+ *                the story, the commentary, the summary.
+ *   `snapshot`   the footprintjs run snapshot — shared state, the commit
+ *                log, and every attached recorder's data (narrative,
+ *                metrics, boundaries).
+ *   `structure`  the agent's build-time chart — THE CHART. Nothing else
+ *                can draw it, and no snapshot carries it.
+ *
+ * Miss one and one surface goes dark. That is why this exists: every
+ * integration that assembled the bundle by hand assembled a different,
+ * incomplete one, and the piece most often missing was `structure` —
+ * because a completed run does not leave it behind. This is also the
+ * producer for the shape lens's `observeRecording()` consumes, which
+ * until now nothing produced.
+ *
+ *   import { recordRun } from 'agentfootprint/observe';
+ *
+ *   const recorder = recordRun(agent);
+ *   await agent.run({ message });
+ *   fs.writeFileSync('run.json', JSON.stringify(recorder.toRecording()));
+ *
+ * …and in the viewer:
+ *
+ *   const { recorder, runner } = observeRecording(JSON.parse(json));  // lens
+ *   <Lens recorder={recorder} runner={runner} />
+ *
+ * WHAT IT WIRES THAT HAND-ROLLING GETS WRONG
+ * ──────────────────────────────────────────
+ * The boundary recorder — the one that puts stops on the step strip —
+ * needs three connections, and each missing one fails differently:
+ *
+ *   attach          no boundaries at all (loud: the strip is empty)
+ *   subscribe       boundaries with nothing in them (quiet: no LLM or
+ *                   tool detail behind any stop)
+ *   getCommitCount  every boundary stamped at commit 0 (SILENT: the
+ *                   events look complete, and the strip cannot be
+ *                   rebuilt offline — the commit log records what
+ *                   stages wrote, never when a boundary was crossed,
+ *                   so nothing downstream can repair it)
+ *
+ * Wire it before the run or not at all — none of the three can be
+ * reconstructed from a finished run.
+ *
+ * WHAT IT DOES NOT DO
+ * ───────────────────
+ * It attaches no OTHER recorders. `narrative()` and `metrics()` are the
+ * consumer's choice — their data rides the snapshot when attached, and
+ * each viewer says so when it isn't there (a Gantt with no timings shows
+ * execution ORDER and says so; a story panel falls back to "X executed.
+ * Wrote: y"). Attaching them behind the consumer's back would make every
+ * recording pay for panels most runs never open.
+ */
+import type { Runner } from '../../core/runner.js';
+import type { AgentfootprintEvent } from '../../events/registry.js';
+import { type BoundaryRecorder } from './BoundaryRecorder.js';
+/**
+ * One frozen run — everything a viewer needs, and nothing it doesn't.
+ *
+ * The field names are the ones `observeRecording()` reads, so a recording
+ * is handed over whole: no mapping, no adapter, no per-integration shape.
+ */
+export interface Recording {
+    /** The footprintjs run snapshot. `undefined` if nothing has run yet. */
+    readonly snapshot: unknown;
+    /** The typed events the run fired, in order. */
+    readonly events: readonly AgentfootprintEvent[];
+    /** The agent's build-time chart — the only route to a drawable graph. */
+    readonly structure: unknown;
+}
+export interface RecordRunOptions {
+    /**
+     * Cap on retained events. The oldest are dropped once the cap is hit,
+     * so a long-running server records a bounded tail rather than growing
+     * without limit. Default 10,000 — a few hundred KB for a typical turn,
+     * and far more than any single turn fires.
+     *
+     * A recording that dropped events says so: `droppedEvents` counts them
+     * rather than leaving a consumer to wonder why its timeline starts
+     * mid-run.
+     */
+    readonly maxEvents?: number;
+    /**
+     * How much of the boundary log rides the snapshot:
+     *   - `'full'` (default) — every field, content included. What an
+     *     offline step strip needs to show detail behind each stop.
+     *   - `'lean'` — boundary structure only, no captured payloads. The
+     *     strip still rebuilds; the detail panels are empty, and a
+     *     consumer reading the bundle's `meta.mode` can say so.
+     */
+    readonly boundaryDetail?: 'full' | 'lean';
+}
+/** A recording in progress. Keep it until the run ends, then freeze it. */
+export interface RunRecorder {
+    /**
+     * Freeze what has happened so far into `{ snapshot, events, structure }`.
+     * Call it after the run; calling it during one gives a partial
+     * recording, which is legitimate for a crash report but will show a
+     * timeline that stops mid-run.
+     *
+     * The events array is a fresh copy, so a recording taken and stored
+     * does not keep growing behind the caller's back. `snapshot` and
+     * `structure` are the runner's own objects, held by reference —
+     * serialize to detach.
+     */
+    toRecording(): Recording;
+    /** The boundary recorder, for richer live queries (slot rows, ranges). */
+    readonly boundary: BoundaryRecorder;
+    /** How many events have been captured. */
+    readonly eventCount: number;
+    /** Events discarded to stay under `maxEvents`. `0` on a normal turn. */
+    readonly droppedEvents: number;
+    /**
+     * Stop recording. The events already captured stay readable, so
+     * `toRecording()` after `stop()` is the normal end of a run; call it
+     * when the runner outlives the recording (a server that records one
+     * turn out of many).
+     */
+    stop(): void;
+}
+/**
+ * Start recording a runner. Call BEFORE `run()` — a recording is
+ * collected as the run happens and cannot be reconstructed after it.
+ *
+ * @param runner   the Agent / composition / pattern to record.
+ * @param options  event cap and boundary detail level.
+ *
+ * @example
+ * ```ts
+ * const recorder = recordRun(agent);
+ * await agent.run({ message: 'Weather in San Francisco?' });
+ * const recording = recorder.toRecording();
+ * recorder.stop();
+ *
+ * fs.writeFileSync('run.json', JSON.stringify(recording));
+ * ```
+ */
+export declare function recordRun(runner: Runner, options?: RecordRunOptions): RunRecorder;
+//# sourceMappingURL=recordRun.d.ts.map

package/dist/types/recorders/observability/recordRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordRun.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/recordRun.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3C;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;OAUG;IACH,WAAW,IAAI,SAAS,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,IAAI,IAAI,IAAI,CAAC;CACd;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAwDrF"}

package/dist/types/recorders/observability/trace.d.ts

@@ -5,14 +5,31 @@
  * `serializeTrace()` freezes that model into a `Trace` — plain JSON you can
  * persist (file, Redis, a bug report) and later rehydrate WITHOUT re-running
  * the agent. `agentfootprint-lens`'s `<Replay trace={…} />` consumes it and
- * rebuilds the flowchart via the existing translators.
+ * draws the flowchart via the existing translators.
  *
- * A `Trace` stores ONLY the domain-event log (the single source of truth the
- * Lens already reads). The step graph is ALWAYS a derived projection of those
- * events (footprint.js's "graph is derived, never post-processed" principle) —
- * it is rebuilt at render time, never stored. Storing a derived graph would be
- * redundant AND a redaction hazard: a second content surface a per-event
- * `redact` could never reach.
+ * A `Trace` stores the domain-event log (the single source of truth the Lens
+ * already reads) plus, since 7.8, the run's footprintjs snapshot. The step
+ * graph is ALWAYS a derived projection of those events (footprint.js's "graph
+ * is derived, never post-processed" principle) — it is rebuilt at render time,
+ * never stored. Storing a derived graph would be redundant AND a redaction
+ * hazard: a second content surface a per-event `redact` could never reach.
+ *
+ * WHAT A TRACE CAN AND CANNOT DRIVE
+ * ─────────────────────────────────
+ * `<Replay trace={…} />` draws the chart from `structure`, and that is all it
+ * draws: a static shape, not a lit-up path. It does not read `trace.events` —
+ * time-travel over them is a planned refinement, and until it lands an offline
+ * `<Replay>` is a strictly smaller view than the live `<Lens>`, not a match
+ * for it.
+ *
+ * For the full viewers — `<Lens>`, ExplainableShell, WhereFrom, the commit
+ * axis — what you want is a RECORDING: `{ snapshot, events, structure }`, the
+ * shape `recordRun()` produces and lens's `observeRecording()` consumes. Note
+ * `events` there means the TYPED agentfootprint stream (`runner.on('*')`),
+ * which is not the domain-event log a Trace carries: the two are different
+ * projections of the same run, and a Trace holds only the second. So a Trace
+ * with a `snapshot` can drive the snapshot-fed surfaces, but it is not itself
+ * a recording — reach for `recordRun()` when the destination is a viewer.
  *
  * PII / trust boundary: the event log carries real content — `llm.end.content`,
  * `tool.start.args`, `tool.end.result`, `context.injected.contentSummary`,
@@ -49,7 +66,8 @@ export interface TraceSummary {
 }
 /**
  * A JSON-lossless, UI-free snapshot of one run. Persist it, ship it, replay it.
- * `events` ARE the run (the graph is a derived projection, rebuilt at render).
+ * `events` ARE the timeline (the graph is a derived projection, rebuilt at
+ * render); `structure` is the chart; `snapshot` is the state the run left.
  */
 export interface Trace {
     /** Schema version. Bump on a breaking shape change. */
@@ -58,12 +76,36 @@ export interface Trace {
     readonly events: readonly DomainEvent[];
     /**
      * The serialized STATIC chart structure (footprint.js `buildTimeStructure`).
-     * Design-time data (stage ids/names/types/edges) — UI-free. `<Replay>` rebuilds
-     * the flowchart from this and overlays `events`, so an offline replay matches
-     * the live `<Lens>` exactly. NOT runtime-redacted (it carries no user data; the
+     * Design-time data (stage ids/names/types/edges) — UI-free. `<Replay>` draws
+     * the flowchart from this. NOT runtime-redacted (it carries no user data; the
      * `redact` function targets runtime events).
+     *
+     * Absent, `<Replay>` has nothing to draw and says so.
      */
     readonly structure?: unknown;
+    /**
+     * The run's footprintjs snapshot (`runner.getLastSnapshot()`) — shared
+     * state, the commit log, and every attached recorder's data.
+     *
+     * This is the piece the snapshot-fed surfaces need and the event log cannot
+     * supply: ExplainableShell's memory and provenance panels, WhereFrom, and
+     * the commit axis all read the commit log, which is a footprintjs artifact
+     * and appears nowhere in `events`. Without it a Trace draws a chart and a
+     * timeline and nothing else — which is what every Trace captured before 7.8
+     * is, and why they replay as a static picture.
+     *
+     * `unknown` on purpose: this is footprintjs's shape, not agentfootprint's,
+     * and a Trace is a transport — it should not pin a peer's type into its own
+     * schema. Cast at the consumer.
+     *
+     * NOT redacted by `redact`, which runs per domain event and cannot reach
+     * inside a snapshot. This field carries whatever the run's own footprintjs
+     * redaction policy (`setRedactionPolicy()`) let through, so a run whose
+     * state holds secrets wants that policy set at run time — which is why
+     * `enable.localObservability({ includeSnapshot: true })` is opt-in and a
+     * redacted Trace does not quietly grow a second content surface.
+     */
+    readonly snapshot?: unknown;
     /** Optional headline totals. */
     readonly summary?: TraceSummary;
     /** Self-describing redaction state — travels with the trace. */
@@ -81,8 +123,14 @@ export interface SerializeTraceOptions {
     readonly redact?: (event: DomainEvent) => DomainEvent;
     /** Override the `redaction` label. Defaults to `'pii'` when `redact` is given, else `'none'`. */
     readonly redactionLabel?: TraceRedaction;
-    /** The serialized static chart (`getSpec().buildTimeStructure`) — for `<Replay>` to rebuild the flowchart. */
+    /** The serialized static chart (`getSpec().buildTimeStructure`) — what `<Replay>` draws. */
     readonly structure?: unknown;
+    /**
+     * The run's footprintjs snapshot (`runner.getLastSnapshot()`) — the commit
+     * log and recorder data the snapshot-fed panels read. `enable.localObservability()`
+     * fills this for you; pass it explicitly when calling `serializeTrace` by hand.
+     */
+    readonly snapshot?: unknown;
     /** Optional precomputed headline rollup. */
     readonly summary?: TraceSummary;
     /** Wall-clock capture time. Pass `Date.now()` from the call site. */
@@ -102,10 +150,14 @@ export declare function redactContent(event: DomainEvent): DomainEvent;
  * `getEvents()` output.
  *
  *   const trace = serializeTrace(handle.boundary.getEvents(), {
- *     redact: redactContent,         // PII stripped before it enters the trace
+ *     redact: redactContent,                      // PII stripped before it enters the trace
+ *     structure: agent.getSpec().buildTimeStructure,  // the chart
+ *     snapshot: agent.getLastSnapshot(),          // state + commit log + recorders
  *     capturedAtMs: Date.now(),
  *   });
  *   fs.writeFileSync('run.trace.json', JSON.stringify(trace));
+ *
+ * `enable.localObservability().getTrace()` passes all three for you.
  */
 export declare function serializeTrace(events: readonly DomainEvent[], options?: SerializeTraceOptions): Trace;
 /**

package/dist/types/recorders/observability/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvD,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,qFAAqF;IACrF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,CAAC;IACtD,iGAAiG;IACjG,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,8GAA8G;IAC9G,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAuB7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,OAAO,GAAE,qBAA0B,GAClC,KAAK,CAaP;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAExD"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvD,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,qFAAqF;IACrF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,CAAC;IACtD,iGAAiG;IACjG,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAuB7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,OAAO,GAAE,qBAA0B,GAClC,KAAK,CAmBP;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAExD"}

package/dist/types/reliability/buildReliabilityGateChart.d.ts

@@ -3,9 +3,20 @@
  * an LLM call with rules-based reliability semantics, using the native
  * `decide()` DSL via `addDeciderFunction` decider stages.
  *
- * The returned chart is mounted as a subflow in the agent's chart at
- * Agent.build() time (only when reliability is configured). Inside the
- * subflow:
+ * ⚠ NOT REACHABLE FROM ANY SHIPPED PATH (verified 2026-07-28). This header
+ * used to say the chart "is mounted as a subflow in the agent's chart at
+ * Agent.build() time (only when reliability is configured)". It is not:
+ * `buildReliabilityGateChart` is exported from no barrel, and its only
+ * consumer in the repository is its own test
+ * (`test/reliability/gate-chart-7pattern.test.ts`). The live
+ * `.reliability()` path is `executeWithReliability`
+ * (`core/agent/stages/reliabilityExecution.ts`) driving
+ * `singleProviderCall` inline in `core/agent/stages/callLLM.ts` — which
+ * trades this chart's subflow visibility for streaming support. Keep this
+ * file honest rather than deleting it: it is the only implementation that
+ * honours the `providers` failover list (see MENTAL_MODEL §14 item 3).
+ *
+ * Inside the subflow, when something does mount it:
  *
  *   PreCheck (decider) → CallProvider (function) → PostDecide (decider)
  *                                                       │
@@ -26,15 +37,18 @@
  *     'fallback'    → call config.fallback(); $break() on success
  *     'fail-fast'   → set failKind, $emit, $break(reason)
  *
- * The subflow is mounted WITHOUT `propagateBreak: true`. Subflow $break is
- * local — agent.ts adds a `TranslateFailFast` agent-level stage AFTER the
- * subflow that reads scope.reliabilityFailKind and converts it into an
- * agent-level `$break(reason)`. This split lets normal subflow exits
- * (`ok`/`fallback`) leave the agent running while fail-fast stops it.
+ * The design intends the subflow to be mounted WITHOUT `propagateBreak:
+ * true`, so subflow `$break` stays local and an agent-level
+ * `TranslateFailFast` stage reads `scope.reliabilityFailKind` and converts
+ * it into an agent-level `$break(reason)` — letting normal subflow exits
+ * (`ok`/`fallback`) leave the agent running while fail-fast stops it. That
+ * stage was never built (`grep TranslateFailFast` finds only comments), which
+ * is part of why nothing mounts this chart; the live path throws
+ * `ReliabilityFailFastError` from `Agent.run` instead.
  *
  * Three-channel discipline preserved:
  *   • SCOPE STATE  — failKind/failPayload/failReason mapped to parent via
- *                    outputMapper; consumed by agent's TranslateFailFast.
+ *                    outputMapper; for the intended TranslateFailFast.
  *   • $emit        — passive observability for external consumers.
  *   • $break(reason)— control flow + human reason for narrative.
  */

package/dist/types/reliability/buildReliabilityGateChart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildReliabilityGateChart.d.ts","sourceRoot":"","sources":["../../../src/reliability/buildReliabilityGateChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAWzD,OAAO,KAAK,EAAE,iBAAiB,EAAqC,MAAM,YAAY,CAAC;AAmFvF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAsT9E"}
+{"version":3,"file":"buildReliabilityGateChart.d.ts","sourceRoot":"","sources":["../../../src/reliability/buildReliabilityGateChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAWzD,OAAO,KAAK,EAAE,iBAAiB,EAAqC,MAAM,YAAY,CAAC;AAoFvF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAmU9E"}

package/dist/types/resilience/withCircuitBreaker.d.ts

@@ -48,9 +48,12 @@
  *
  *     HALF-OPEN ──[ probe failure ]──► OPEN (cooldown restarts)
  *
- * `stream()` is decorated identically. `name`/`flush`/`stop` pass
- * through unchanged (the consumer's existing observability hooks
- * still see the underlying provider's identity).
+ * `stream()` is decorated identically. `name` passes through unchanged
+ * (the consumer's existing observability hooks still see the underlying
+ * provider's identity), and the optional per-call `LLMCallHooks` is
+ * forwarded inward so a decorator nested inside this one can still
+ * report. Nothing else is copied — `LLMProvider` has exactly `name`,
+ * `complete` and the optional `stream`.
  *
  * **Scope: per-instance, NOT distributed.** Each `withCircuitBreaker(...)`
  * call holds its own breaker state in process memory. If you run 100
@@ -93,8 +96,15 @@ export interface WithCircuitBreakerOptions {
      * breaker for everyone.
      */
     readonly shouldCount?: (error: unknown) => boolean;
-    /** Hook invoked on every state transition. Useful for emitting
-     *  `agentfootprint.resilience.circuit_state_changed`. */
+    /**
+     * Hook invoked on every state transition. This is the ONLY way to
+     * observe breaker state: there is no declared event for a breaker
+     * transition, so unlike `withFallback`/`withRetry` this decorator
+     * reports nothing through the in-run `LLMCallHooks` channel. A trip
+     * becomes visible in a trace only when composed under
+     * `withFallback`, whose `agentfootprint.fallback.triggered` carries
+     * the `CircuitOpenError` message as its `reason`.
+     */
     readonly onStateChange?: (state: CircuitState, reason: string) => void;
 }
 export type CircuitState = 'closed' | 'open' | 'half-open';

package/dist/types/resilience/withCircuitBreaker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withCircuitBreaker.d.ts","sourceRoot":"","sources":["../../../src/resilience/withCircuitBreaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AAEH,OAAO,KAAK,EAAY,WAAW,EAA2B,MAAM,sBAAsB,CAAC;AAI3F,MAAM,WAAW,yBAAyB;IACxC,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACnD;6DACyD;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAI3D;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,qBAA+B;IAC5C;+CAC2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAChB,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM;CAYrE;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,yBAA8B,GACtC,WAAW,CA0Hb"}
+{"version":3,"file":"withCircuitBreaker.d.ts","sourceRoot":"","sources":["../../../src/resilience/withCircuitBreaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAEH,OAAO,KAAK,EAGV,WAAW,EAGZ,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,yBAAyB;IACxC,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACnD;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAI3D;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,qBAA+B;IAC5C;+CAC2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAChB,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM;CAYrE;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,yBAA8B,GACtC,WAAW,CA8Hb"}

package/dist/types/resilience/withFallback.d.ts

@@ -27,7 +27,13 @@ export interface WithFallbackOptions {
     readonly shouldFallback?: (error: unknown) => boolean;
     /**
      * Hook invoked when the primary fails and we're about to call the
-     * fallback. Useful for emitting `agentfootprint.resilience.fallback`.
+     * fallback. Useful for logging in standalone (non-agentfootprint) use.
+     *
+     * You do NOT need this to get fallback telemetry inside a run: since
+     * v7.8 the in-run LLM call sites hand this decorator an `LLMCallHooks`
+     * and translate its reports into `agentfootprint.fallback.triggered`
+     * events, stamped with the real `runId`/`runtimeStageId`. This hook is
+     * the consumer-owned escape hatch and its contract is unchanged.
      */
     readonly onFallback?: (error: unknown) => void;
 }

package/dist/types/resilience/withFallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withFallback.d.ts","sourceRoot":"","sources":["../../../src/resilience/withFallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAY,WAAW,EAA2B,MAAM,sBAAsB,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,mBAAwB,GAChC,WAAW,CA6Cb"}
+{"version":3,"file":"withFallback.d.ts","sourceRoot":"","sources":["../../../src/resilience/withFallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAGV,WAAW,EAGZ,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACtD;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,mBAAwB,GAChC,WAAW,CAoEb"}

package/dist/types/resilience/withRetry.d.ts

@@ -35,11 +35,16 @@ export interface WithRetryOptions {
      */
     readonly shouldRetry?: (error: unknown, attempt: number) => boolean;
     /**
-     * Hook invoked before each retry. Useful for logging or an
-     * `agentfootprint.error.retried` emit (the event family reserved for
-     * the standalone provider decorators — see events/payloads.ts).
-     * Receives the attempt number that's about to start (so attempt 2 =
-     * first retry).
+     * Hook invoked before each retry. Useful for logging in standalone
+     * (non-agentfootprint) use. Receives the attempt number that's about
+     * to start (so attempt 2 = first retry).
+     *
+     * You do NOT need this to get retry telemetry inside a run: since v7.8
+     * the in-run LLM call sites hand this decorator an `LLMCallHooks` and
+     * translate its reports into `agentfootprint.error.retried` /
+     * `agentfootprint.error.recovered` events, stamped with the real
+     * `runId`/`runtimeStageId`. This hook is the consumer-owned escape
+     * hatch and its contract is unchanged.
      */
     readonly onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
 }