agentfootprint 7.7.0 → 7.9.0

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

@@ -44,7 +44,9 @@ import { boundaryRecorder, } from './BoundaryRecorder.js';
 /**
  * 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.* /
@@ -52,10 +54,19 @@ import { boundaryRecorder, } from './BoundaryRecorder.js';
  *   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 function attachFlowchart(runnerAttach, dispatcher, options = {}) {
-    const boundary = boundaryRecorder();
+export function attachFlowchart(runnerAttach, dispatcher, options = {}, getCommitCount) {
+    const boundary = boundaryRecorder(getCommitCount ? { getCommitCount } : {});
     const onUpdate = options.onUpdate;
     // Wrap the recorder to also re-emit StepGraph after each FlowRecorder
     // event. Without this, consumers see updates only on dispatcher events

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

@@ -1 +1 @@
-{"version":3,"file":"FlowchartRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/observability/FlowchartRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EAEL,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC;AAuJ/B,wEAAwE;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAwD,EACxD,UAA2B,EAC3B,UAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,sEAAsE;IACtE,uEAAuE;IACvE,mDAAmD;IACnD,MAAM,OAAO,GAAqB,QAAQ;QACxC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAExC,kEAAkE;IAClE,mEAAmE;IACnE,MAAM,aAAa,GAAG,UAAU,CAAC,EAAE,CACjC,GAAyC,EACzC,CAAC,KAA0B,EAAE,EAAE;QAC7B,iEAAiE;QACjE,kEAAkE;QAClE,kCAAkC;QAClC,8DAA8D;QAC7D,QAAgB,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5C,QAAQ,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvC,CAAC,CACF,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC;QAC3C,QAAQ;QACR,WAAW,EAAE,GAAG,EAAE;YAChB,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,QAA0B,EAAE,SAAqB;IACrE,gEAAgE;IAChE,gEAAgE;IAChE,+DAA+D;IAC/D,4CAA4C;IAC5C,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;YAChB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;YACzB,SAAS,EAAE,CAAC;QACd,CAAC;QACD,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YACd,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;YACvB,SAAS,EAAE,CAAC;QACd,CAAC;QACD,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;YACpB,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7B,SAAS,EAAE,CAAC;QACd,CAAC;QACD,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE;YACnB,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5B,SAAS,EAAE,CAAC;QACd,CAAC;QACD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACZ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACrB,SAAS,EAAE,CAAC;QACd,CAAC;QACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;YAChB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;YACzB,SAAS,EAAE,CAAC;QACd,CAAC;QACD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACZ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACrB,SAAS,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wEAAwE;AAExE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IACpD,OAAO;IACP,SAAS;IACT,UAAU;IACV,UAAU;IACV,aAAa;IACb,MAAM;CACP,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAC,QAA0B;IACvD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAA8B;IACrE,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,iBAAiB,GAAuB,EAAE,CAAC;IAC/C,IAAI,WAA+B,CAAC;IACpC,IAAI,UAA8B,CAAC;IACnC,IAAI,YAAgC,CAAC;IAErC;;;;;;;;;OASG;IACH,IAAI,qBAAqB,GAIrB,EAAE,CAAC;IAEP,wEAAwE;IACxE,uEAAuE;IACvE,gEAAgE;IAChE,IAAI,oBAAwC,CAAC;IAC7C,qEAAqE;IACrE,uEAAuE;IACvE,yBAAyB;IACzB,IAAI,iBAA0B,CAAC;IAE/B,kEAAkE;IAClE,qEAAqE;IACrE,mEAAmE;IACnE,qBAAqB;IACrB,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE5D,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,UAAU,KAAK,SAAS;YAAE,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC;QAE5B,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,IAAI,GAAa;oBACrB,EAAE,EAAE,CAAC,CAAC,cAAc;oBACpB,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE,KAAK;oBACZ,aAAa,EAAE,CAAC;oBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,aAAa,EAAE,KAAK;oBACpB,mBAAmB,EAAE,KAAK;oBAC1B,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/D,cAAc,EAAE,CAAC,CAAC,cAAc;iBACjC,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;gBACpD,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC;gBACvB,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBAC3D,IAAI,IAAI,EAAE,CAAC;oBACR,IAAiC,CAAC,WAAW,GAAG,CAAC,CAAC;oBACnD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC3B,IAAkC,CAAC,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC;oBAC9D,CAAC;oBACD,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBACnD,CAAC;gBACD,YAAY,GAAG,SAAS,CAAC;gBACzB,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,4DAA4D;gBAC5D,2DAA2D;gBAC3D,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACf,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG;wBAChD,cAAc,EAAE,CAAC,CAAC,cAAc;wBAChC,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAChE,CAAC;oBACF,MAAM;gBACR,CAAC;gBACD,qDAAqD;gBACrD,IAAI,CAAC,CAAC,eAAe;oBAAE,MAAM;gBAC7B,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC9B,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;gBACpD,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC;gBACvB,MAAM;YACR,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,4DAA4D;gBAC5D,6DAA6D;gBAC7D,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACf,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;oBACrC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;oBAC5C,IAAI,QAAQ,EAAE,CAAC;wBACb,qBAAqB,CAAC,GAAG,CAAC,GAAG;4BAC3B,GAAG,QAAQ;4BACX,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC/D,CAAC;oBACJ,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,IAAI,CAAC,CAAC,eAAe;oBAAE,MAAM;gBAC7B,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBAC3D,IAAI,IAAI,EAAE,CAAC;oBACR,IAAiC,CAAC,WAAW,GAAG,CAAC,CAAC;oBACnD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC3B,IAAkC,CAAC,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC;oBAC9D,CAAC;oBACD,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBACnD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE;oBACF,IAAI,EAAE,aAAa;oBACnB,KAAK,EAAE,CAAC,CAAC,SAAS;oBAClB,aAAa,EAAE,CAAC;oBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,0DAA0D;gBAC1D,2DAA2D;gBAC3D,wDAAwD;gBACxD,4DAA4D;gBAC5D,mCAAmC;gBACnC,IAAI,CAAC,CAAC,eAAe;oBAAE,MAAM;gBAC7B,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE;oBACF,IAAI,EAAE,iBAAiB;oBACvB,KAAK,EAAE,CAAC,CAAC,MAAM;oBACf,aAAa,EAAE,CAAC;oBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,+DAA+D;gBAC/D,gEAAgE;gBAChE,IAAI,YAAY,EAAE,CAAC;oBACjB,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,QAAQ,YAAY,IAAI,CAAC,CAAC,SAAS,EAAE;wBACzC,IAAI,EAAE,YAAY;wBAClB,EAAE,EAAE,YAAY;wBAChB,IAAI,EAAE,gBAAgB;wBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;qBACvB,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,iBAAiB,CAAC,IAAI,CAAC;oBACrB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/C,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrD,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,GAAG,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/E,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzE,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzE,GAAG,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChF,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,IAAI,IAAI,CAAC,CAAC;gBACV,MAAM,EAAE,GAAG,kBAAkB,CAAC,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;gBACxD,MAAM,UAAU,GAAG,iBAAiB,CAAC;gBACrC,iBAAiB,GAAG,EAAE,CAAC;gBACvB,0DAA0D;gBAC1D,gEAAgE;gBAChE,+BAA+B;gBAC/B,MAAM,cAAc,GAClB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpF,qBAAqB,GAAG,EAAE,CAAC;gBAC3B,4DAA4D;gBAC5D,+DAA+D;gBAC/D,mCAAmC;gBACnC,MAAM,QAAQ,GAAqB,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;gBAC3F,gEAAgE;gBAChE,+DAA+D;gBAC/D,MAAM,UAAU,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC5E,IAAI,QAAQ,KAAK,WAAW;oBAAE,iBAAiB,GAAG,SAAS,CAAC;gBAC5D,MAAM,IAAI,GAAa;oBACrB,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY;oBAC7D,aAAa,EAAE,CAAC;oBAChB,QAAQ,EAAE,CAAC,CAAC,KAAK;oBACjB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,UAAU;oBACV,cAAc,EAAE,IAAI;oBACpB,WAAW,EAAE,UAAU;oBACvB,4DAA4D;oBAC5D,6DAA6D;oBAC7D,mDAAmD;oBACnD,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACpD,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,WAAW,EAAE,CAAC;oBAChB,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,GAAG,WAAW,KAAK,EAAE,EAAE;wBAC3B,IAAI,EAAE,WAAW;wBACjB,EAAE,EAAE,EAAE;wBACN,IAAI,EAAE,MAAM;qBACb,CAAC,CAAC;gBACL,CAAC;gBACD,WAAW,GAAG,EAAE,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,yDAAyD;gBACzD,8DAA8D;gBAC9D,wDAAwD;gBACxD,wCAAwC;gBACxC,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;gBACpE,IAAI,SAAS,EAAE,CAAC;oBACb,SAA6C,CAAC,MAAM,GAAG;wBACtD,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK;wBACjB,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;qBACpB,CAAC;oBACD,SAAsC,CAAC,WAAW,GAAG,CAAC,CAAC;gBAC1D,CAAC;gBACD,IAAI,CAAC,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAChC,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;oBACtD,MAAM,IAAI,GAAa;wBACrB,EAAE;wBACF,IAAI,EAAE,WAAW;wBACjB,KAAK,EAAE,YAAY;wBACnB,aAAa,EAAE,CAAC;wBAChB,WAAW,EAAE,CAAC;wBACd,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,cAAc,EAAE,IAAI;wBACpB,cAAc,EAAE,CAAC,CAAC,cAAc;wBAChC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACnD,CAAC;oBACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACjB,IAAI,WAAW,EAAE,CAAC;wBAChB,KAAK,CAAC,IAAI,CAAC;4BACT,EAAE,EAAE,GAAG,WAAW,KAAK,EAAE,EAAE;4BAC3B,IAAI,EAAE,WAAW;4BACjB,EAAE,EAAE,EAAE;4BACN,IAAI,EAAE,MAAM;yBACb,CAAC,CAAC;oBACL,CAAC;oBACD,WAAW,GAAG,EAAE,CAAC;gBACnB,CAAC;qBAAM,CAAC;oBACN,8DAA8D;oBAC9D,+DAA+D;oBAC/D,kCAAkC;oBAClC,oBAAoB,GAAG,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC;gBAChD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,EAAE,GAAG,mBAAmB,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjE,MAAM,aAAa,GAAG,oBAAoB,CAAC;gBAC3C,oBAAoB,GAAG,SAAS,CAAC;gBACjC,MAAM,IAAI,GAAa;oBACrB,EAAE;oBACF,IAAI,EAAE,WAAW;oBACjB,KAAK,EAAE,eAAe,CAAC,CAAC,QAAQ,GAAG;oBACnC,aAAa,EAAE,CAAC;oBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,cAAc,EAAE,IAAI;oBACpB,WAAW,EAAE,OAAO;oBACpB,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3C,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtD,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,WAAW,EAAE,CAAC;oBAChB,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,GAAG,WAAW,KAAK,EAAE,EAAE;wBAC3B,IAAI,EAAE,WAAW;wBACjB,EAAE,EAAE,EAAE;wBACN,IAAI,EAAE,MAAM;qBACb,CAAC,CAAC;gBACL,CAAC;gBACD,WAAW,GAAG,EAAE,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;gBACtD,IAAI,QAAQ,EAAE,CAAC;oBACZ,QAAqC,CAAC,WAAW,GAAG,CAAC,CAAC;gBACzD,CAAC;gBACD,8DAA8D;gBAC9D,gEAAgE;gBAChE,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;oBAAE,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;gBACzD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC;AAED,wEAAwE;AAExE,SAAS,iBAAiB,CAAC,CAAqB,EAAE,CAAS;IACzD,MAAM,eAAe,GAAG,CAAC,CAAC,aAAa,KAAK,OAAO,CAAC;IACpD,MAAM,mBAAmB,GACvB,CAAC,CAAC,aAAa,KAAK,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACzE,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,cAAc;QACpB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,CAAC,CAAC,WAAW;QACpB,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,eAAe;QACf,mBAAmB;QACnB,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,cAAc,EAAE,CAAC,CAAC,cAAc;KACjC,CAAC;AACJ,CAAC;AAED;;gDAEgD;AAChD,SAAS,eAAe,CAAC,KAAiB,EAAE,KAAiB;IAC3D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO;IAC/D,KAAK,CAAC,IAAI,CAAC;QACT,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE;QAC5B,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,MAAM;KACb,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,IAAsB;IACzC,OAAO,CACL,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,CAC7F,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,KAA0B,EAC1B,KAAkC;IAElC,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;yBAEyB;AACzB,SAAS,YAAY,CACnB,QAAgD;IAEhD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,eAAe;YAClB,OAAO,cAAc,CAAC;QACxB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"FlowchartRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/observability/FlowchartRecorder.ts"],"names":[],"mappings":"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"}

package/dist/esm/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,4 +105,4 @@ 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;

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

@@ -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
@@ -24,7 +38,7 @@ import { serializeTrace } from './trace.js';
  *
  * @internal Called from `RunnerBase.enable.localObservability`.
  */
-export function attachLocalObservability(runnerAttach, dispatcher, options = {}, now = Date.now, getStructure) {
+export function attachLocalObservability(runnerAttach, dispatcher, options = {}, now = Date.now, access = {}) {
     let completed = false;
     // `let` (not const): `handle` is referenced by `buildTrace` and the onUpdate
     // closure below, both defined before its assignment. The closures only run
@@ -33,7 +47,13 @@ export function attachLocalObservability(runnerAttach, dispatcher, options = {},
     let handle;
     const buildTrace = (override) => serializeTrace(handle.boundary.getEvents(), {
         capturedAtMs: now(),
-        ...(getStructure && { structure: getStructure() }),
+        ...(access.getStructure && { structure: access.getStructure() }),
+        // Opt-in — `redact` is a per-event function and cannot reach inside a
+        // snapshot, so filling this by default would widen what a redacted
+        // Trace exports. Read at freeze time, not at attach time: before the
+        // run there is no snapshot, and during one it grows. `onRecorded`
+        // fires from the run's own exit boundary, where it is final.
+        ...(options.includeSnapshot && access.getSnapshot && { snapshot: access.getSnapshot() }),
         ...(options.redact && { redact: options.redact }),
         ...override,
     });
@@ -48,7 +68,7 @@ export function attachLocalObservability(runnerAttach, dispatcher, options = {},
                 options.onRecorded(buildTrace());
             }
         },
-    });
+    }, access.getCommitCount);
     return { ...handle, getTrace: buildTrace };
 }
 //# sourceMappingURL=localObservability.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"localObservability.js","sourceRoot":"","sources":["../../../../src/recorders/observability/localObservability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,EAAE,eAAe,EAAwC,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAA0C,MAAM,YAAY,CAAC;AAsBpF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAAwD,EACxD,UAA2B,EAC3B,UAAqC,EAAE,EACvC,MAAoB,IAAI,CAAC,GAAG,EAC5B,YAA4B;IAE5B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,wCAAwC;IACxC,IAAI,MAAuB,CAAC;IAE5B,MAAM,UAAU,GAAG,CAAC,QAAgC,EAAS,EAAE,CAC7D,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE;QAC1C,YAAY,EAAE,GAAG,EAAE;QACnB,GAAG,CAAC,YAAY,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,CAAC;QAClD,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACjD,GAAG,QAAQ;KACZ,CAAC,CAAC;IAEL,MAAM,GAAG,eAAe,CAAC,YAAY,EAAE,UAAU,EAAE;QACjD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;YACxB,2DAA2D;YAC3D,IACE,OAAO,CAAC,UAAU;gBAClB,CAAC,SAAS;gBACV,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAC9D,CAAC;gBACD,SAAS,GAAG,IAAI,CAAC;gBACjB,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"localObservability.js","sourceRoot":"","sources":["../../../../src/recorders/observability/localObservability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH,OAAO,EAAE,eAAe,EAAwC,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAA0C,MAAM,YAAY,CAAC;AAqEpF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAAwD,EACxD,UAA2B,EAC3B,UAAqC,EAAE,EACvC,MAAoB,IAAI,CAAC,GAAG,EAC5B,SAAoB,EAAE;IAEtB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,wCAAwC;IACxC,IAAI,MAAuB,CAAC;IAE5B,MAAM,UAAU,GAAG,CAAC,QAAgC,EAAS,EAAE,CAC7D,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE;QAC1C,YAAY,EAAE,GAAG,EAAE;QACnB,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC;QAChE,sEAAsE;QACtE,mEAAmE;QACnE,qEAAqE;QACrE,kEAAkE;QAClE,6DAA6D;QAC7D,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,MAAM,CAAC,WAAW,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACjD,GAAG,QAAQ;KACZ,CAAC,CAAC;IAEL,MAAM,GAAG,eAAe,CACtB,YAAY,EACZ,UAAU,EACV;QACE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;YACxB,2DAA2D;YAC3D,IACE,OAAO,CAAC,UAAU;gBAClB,CAAC,SAAS;gBACV,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAC9D,CAAC;gBACD,SAAS,GAAG,IAAI,CAAC;gBACjB,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,EACD,MAAM,CAAC,cAAc,CACtB,CAAC;IAEF,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,143 @@
+/**
+ * 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;

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"}