agentfootprint 7.7.0 → 7.8.0

package/dist/esm/recorders/observability/recordRun.js

@@ -0,0 +1,133 @@
+/**
+ * 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 { boundaryRecorder } from './BoundaryRecorder.js';
+/** Default retained-event cap — see `RecordRunOptions.maxEvents`. */
+const DEFAULT_MAX_EVENTS = 10_000;
+/**
+ * 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 function recordRun(runner, options = {}) {
+    const maxEvents = options.maxEvents ?? DEFAULT_MAX_EVENTS;
+    const events = [];
+    let dropped = 0;
+    // 1. THE TIMELINE. Subscribed before the run so nothing is missed —
+    //    the dispatcher drops events with no listener rather than queuing
+    //    them, so a late subscription starts mid-story.
+    const offEvents = runner.on('*', (event) => {
+        events.push(event);
+        if (events.length > maxEvents) {
+            events.shift();
+            dropped += 1;
+        }
+    });
+    // 2. THE BOUNDARIES — all three connections, which is the whole reason
+    //    to call this instead of wiring it yourself. `getCommitCount` reads
+    //    through the runner on every boundary, so it reports the count at
+    //    that moment rather than a number captured now (when it is 0).
+    const boundary = boundaryRecorder({
+        getCommitCount: () => runner.getCommitCount(),
+        ...(options.boundaryDetail === 'lean' ? { snapshot: 'lean' } : {}),
+    });
+    const offAttach = runner.attach(boundary);
+    const offTyped = boundary.subscribe(runner);
+    let stopped = false;
+    return {
+        toRecording: () => ({
+            // Read at freeze time. Before the run there is no snapshot; during
+            // one it grows; after it, it is the finished run's.
+            snapshot: runner.getLastSnapshot(),
+            events: events.slice(),
+            // The one piece a run does not leave behind — it lives on the
+            // chart, which is built once and never changes.
+            structure: runner.getSpec().buildTimeStructure,
+        }),
+        boundary,
+        get eventCount() {
+            return events.length;
+        },
+        get droppedEvents() {
+            return dropped;
+        },
+        stop: () => {
+            // Idempotent: a consumer that stops in both a finally block and an
+            // unmount handler should not detach someone else's later recorder.
+            if (stopped)
+                return;
+            stopped = true;
+            offEvents();
+            offTyped();
+            offAttach();
+        },
+    };
+}
+//# sourceMappingURL=recordRun.js.map

package/dist/esm/recorders/observability/recordRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordRun.js","sourceRoot":"","sources":["../../../../src/recorders/observability/recordRun.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAKH,OAAO,EAAE,gBAAgB,EAAyB,MAAM,uBAAuB,CAAC;AAqEhF,qEAAqE;AACrE,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,UAA4B,EAAE;IACtE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,oEAAoE;IACpE,sEAAsE;IACtE,oDAAoD;IACpD,MAAM,SAAS,GAAgB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAA0B,EAAE,EAAE;QAC3E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,wEAAwE;IACxE,sEAAsE;IACtE,mEAAmE;IACnE,MAAM,QAAQ,GAAG,gBAAgB,CAAC;QAChC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE;QAC7C,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5E,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAE5C,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO;QACL,WAAW,EAAE,GAAc,EAAE,CAAC,CAAC;YAC7B,mEAAmE;YACnE,oDAAoD;YACpD,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE;YAClC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE;YACtB,8DAA8D;YAC9D,gDAAgD;YAChD,SAAS,EAAG,MAAM,CAAC,OAAO,EAAuC,CAAC,kBAAkB;SACrF,CAAC;QACF,QAAQ;QACR,IAAI,UAAU;YACZ,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,IAAI,aAAa;YACf,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,mEAAmE;YACnE,mEAAmE;YACnE,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/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/esm/recorders/observability/trace.js

@@ -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`,
@@ -66,13 +83,17 @@ export function redactContent(event) {
  * `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 function serializeTrace(events, options = {}) {
-    const { redact, redactionLabel, structure, summary, capturedAtMs } = options;
+    const { redact, redactionLabel, structure, snapshot, summary, capturedAtMs } = options;
     // A fresh array either way, so a held Trace is detached from the live store.
     const safeEvents = redact ? events.map((e) => redact(e)) : events.slice();
     const redaction = redactionLabel ?? (redact ? 'pii' : 'none');
@@ -80,6 +101,12 @@ export function serializeTrace(events, options = {}) {
         version: 1,
         events: safeEvents,
         ...(structure !== undefined && { structure }),
+        // Held by reference, not cloned. footprintjs's `sharedState` is a live
+        // view of working memory, so a Trace taken mid-run keeps moving until the
+        // run ends — which is the same caveat `getSnapshot()` carries, and the
+        // reason `onRecorded` fires at the run's exit boundary. Serializing the
+        // Trace (its whole purpose) detaches it.
+        ...(snapshot !== undefined && { snapshot }),
         ...(summary !== undefined && { summary }),
         redaction,
         ...(capturedAtMs !== undefined && { capturedAtMs }),

package/dist/esm/recorders/observability/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../src/recorders/observability/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,wBAAwB,EAAkB,MAAM,wBAAwB,CAAC;AA6DlF;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,SAAS,EAAE,CAAC;QAClE,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7E,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACjF,KAAK,kBAAkB;YACrB,OAAO,KAAK,CAAC,cAAc,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE;gBAC5C,CAAC,CAAC,KAAK,CAAC;QACZ,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACnF,KAAK,eAAe,CAAC;QACrB,KAAK,cAAc;YACjB,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACnF,KAAK,iBAAiB;YACpB,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACvF;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA8B,EAC9B,UAAiC,EAAE;IAEnC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAC7E,6EAA6E;IAC7E,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1E,MAAM,SAAS,GAAmB,cAAc,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9E,OAAO;QACL,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,UAAU;QAClB,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;QACzC,SAAS;QACT,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../src/recorders/observability/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,OAAO,EAAE,wBAAwB,EAAkB,MAAM,wBAAwB,CAAC;AA4FlF;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,SAAS,EAAE,CAAC;QAClE,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7E,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACjF,KAAK,kBAAkB;YACrB,OAAO,KAAK,CAAC,cAAc,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE;gBAC5C,CAAC,CAAC,KAAK,CAAC;QACZ,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACnF,KAAK,eAAe,CAAC;QACrB,KAAK,cAAc;YACjB,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACnF,KAAK,iBAAiB;YACpB,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACvF;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA8B,EAC9B,UAAiC,EAAE;IAEnC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACvF,6EAA6E;IAC7E,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1E,MAAM,SAAS,GAAmB,cAAc,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9E,OAAO;QACL,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,UAAU;QAClB,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,uEAAuE;QACvE,0EAA0E;QAC1E,uEAAuE;QACvE,wEAAwE;QACxE,yCAAyC;QACzC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3C,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;QACzC,SAAS;QACT,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/esm/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/esm/reliability/buildReliabilityGateChart.js

@@ -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.
  */
@@ -42,6 +56,7 @@ import { decide, flowChart } from 'footprintjs';
 import { CircuitOpenError, admitCall, initialBreakerState, nextProbeTime, recordFailure, recordSuccess, } from './CircuitBreaker.js';
 import { classifyError } from './classifyError.js';
 import { typedEmit } from '../recorders/core/typedEmit.js';
+import { resilienceHooks } from '../recorders/core/resilienceHooks.js';
 // ─── Stage IDs (also used for narrative/topology readability) ────────
 const STAGE_IDS = {
     INIT: 'reliability-init',
@@ -200,7 +215,19 @@ export function buildReliabilityGateChart(config) {
                     throw new CircuitOpenError(providerEntry.name, nextState.lastErrorMessage, nextProbeTime(nextState, breakerConfig));
                 }
             }
-            const response = await providerEntry.provider.complete(scope.request);
+            // Hooks are passed here too, so a DECORATED provider does not go
+            // dark. This is not cross-emitting: the decorator's own account of
+            // its own fixed-cap decision merely happens to occur inside a
+            // reliability stage. The two families stay distinct —
+            // `reliability.*` = this rules loop's dynamic decisions, `error.*` =
+            // the decorator's.
+            //
+            // NOTE: this chart is currently DEAD — see the file header. The
+            // live `.reliability()` path is `executeWithReliability` driving
+            // `singleProviderCall` in `core/agent/stages/callLLM.ts`, which
+            // passes the same hooks. Wiring the dead site anyway keeps it from
+            // being a silent hole if the chart is ever revived.
+            const response = await providerEntry.provider.complete(scope.request, resilienceHooks(scope));
             scope.response = response;
             scope.error = undefined;
             scope.errorKind = 'ok';

package/dist/esm/reliability/buildReliabilityGateChart.js.map

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

package/dist/esm/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/esm/resilience/withCircuitBreaker.js

@@ -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
@@ -191,10 +194,13 @@ export function withCircuitBreaker(inner, options = {}) {
     }
     const wrapped = {
         name: inner.name,
-        async complete(req) {
+        async complete(req, hooks) {
             rejectFastIfOpen();
             try {
-                const res = await inner.complete(req);
+                // Forward `hooks` — this decorator reports nothing of its own, but
+                // it rebuilds a fresh provider object, so an inner decorator's
+                // reports are silently swallowed unless they're passed through.
+                const res = await inner.complete(req, hooks);
                 recordSuccess();
                 return res;
             }
@@ -208,15 +214,16 @@ export function withCircuitBreaker(inner, options = {}) {
         // it undefined so the consumer's existing capability check
         // (`if (provider.stream)`) still works correctly.
         ...(inner.stream && {
-            async *stream(req) {
+            async *stream(req, hooks) {
                 rejectFastIfOpen();
                 let yieldedAnyChunk = false;
                 try {
                     // This stream() method is conditionally defined only when
                     // inner.stream exists (see `...(inner.stream && {` above), so
                     // inner.stream is guaranteed non-null inside this body.
+                    // `hooks` is forwarded for the same reason as in complete().
                     // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                    for await (const chunk of inner.stream(req)) {
+                    for await (const chunk of inner.stream(req, hooks)) {
                         yieldedAnyChunk = true;
                         yield chunk;
                     }