agentfootprint 2.14.5 → 3.0.0

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

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

package/dist/types/recorders/observability/internal/ActorArrowClassifier.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @internal — not part of the public agentfootprint API. Imported only
+ * by RunStepRecorder. Subject to change without notice.
+ *
+ * ActorArrowClassifier — classifies the next `llm.start` as
+ * `'user→llm'` (no pending tool result) vs `'tool→llm'` (after a
+ * tool result), and the next `llm.end` as `'llm→tool'` vs `'llm→user'`
+ * based on the call's `toolCallCount`.
+ *
+ * Extracted from RunStepRecorder per Convention 1. Keeps a single
+ * boolean of state — `prevLLMEndHadTools` — and consumes-then-resets
+ * it on each `llm.start`.
+ */
+export type StartArrow = 'user→llm' | 'tool→llm';
+export type EndArrow = 'llm→tool' | 'llm→user';
+export declare class ActorArrowClassifier {
+    private prevLLMEndHadTools;
+    /** Classify the next `llm.start`. Consumes + resets the pending
+     *  flag after returning. */
+    classifyStart(): StartArrow;
+    /** Classify an `llm.end` based on its tool-call count, and update
+     *  the pending flag for the NEXT llm.start. */
+    classifyEnd(toolCallCount: number): EndArrow;
+    clear(): void;
+}
+//# sourceMappingURL=ActorArrowClassifier.d.ts.map

package/dist/types/recorders/observability/internal/ActorArrowClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorArrowClassifier.d.ts","sourceRoot":"","sources":["../../../../../src/recorders/observability/internal/ActorArrowClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/C,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IAEnC;gCAC4B;IAC5B,aAAa,IAAI,UAAU;IAM3B;mDAC+C;IAC/C,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ;IAM5C,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/recorders/observability/internal/CandidateAnswerBuffer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @internal — not part of the public agentfootprint API. Imported only
+ * by RunStepRecorder. Subject to change without notice.
+ *
+ * CandidateAnswerBuffer — buffers a "this leaf MIGHT be the run's
+ * answer" candidate that's only confirmed on `onRunEnd`. Replaced
+ * by every later leaf exit at run scope; the last one wins.
+ *
+ * Extracted from RunStepRecorder per Convention 1.
+ *
+ * Use:
+ *   - On leaf EXIT at run scope: `set(frame, ts, runtimeStageId)`.
+ *   - On `onRunEnd`: `flush()` returns the buffered candidate (or
+ *     undefined if none), and clears the buffer.
+ */
+export interface CandidateAnswer<TFrame> {
+    readonly frame: TFrame;
+    readonly tsMs: number;
+    readonly runtimeStageId: string;
+}
+export declare class CandidateAnswerBuffer<TFrame> {
+    private candidate;
+    /** Buffer a new candidate, replacing any prior one. */
+    set(frame: TFrame, tsMs: number, runtimeStageId: string): void;
+    /** Return + clear the buffered candidate (or undefined if empty). */
+    flush(): CandidateAnswer<TFrame> | undefined;
+    clear(): void;
+}
+//# sourceMappingURL=CandidateAnswerBuffer.d.ts.map

package/dist/types/recorders/observability/internal/CandidateAnswerBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CandidateAnswerBuffer.d.ts","sourceRoot":"","sources":["../../../../../src/recorders/observability/internal/CandidateAnswerBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,eAAe,CAAC,MAAM;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,qBAAqB,CAAC,MAAM;IACvC,OAAO,CAAC,SAAS,CAAsC;IAEvD,uDAAuD;IACvD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAI9D,qEAAqE;IACrE,KAAK,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,SAAS;IAM5C,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/recorders/observability/internal/ForkTracker.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @internal — not part of the public agentfootprint API. Imported only
+ * by RunStepRecorder. Subject to change without notice; do not import
+ * via deep paths.
+ *
+ * ForkTracker — owns the bookkeeping for parallel-fork emission and
+ * merge-step detection. Extracted from RunStepRecorder per Convention 1
+ * (one purpose per recorder/state machine).
+ *
+ * Responsibilities (and ONLY these):
+ *   1. Coalesce repeated `onFork` events for the same parent (race-safe
+ *      via parent+runtimeStageId key).
+ *   2. Track which child branches belong to which parent fork.
+ *   3. Track which branches have exited; signal "merge ready" when ALL
+ *      branches of a fork have exited.
+ *
+ * What it does NOT own:
+ *   - Storage (the recorder writes RunSteps to its SequenceStore).
+ *   - Run-boundary detection (the recorder's runIdGuard wipes this
+ *     tracker via `clear()`).
+ *   - Any other state machine.
+ */
+export interface ForkRegistration {
+    /** True if this is a NEW fork; false if the same fork was already seen
+     *  (caller should suppress duplicate emission). */
+    readonly fresh: boolean;
+}
+export interface MergeReady {
+    /** All branch IDs of the now-fully-exited fork, in the order they
+     *  were originally registered. */
+    readonly branches: readonly string[];
+}
+export declare class ForkTracker {
+    /** Per-parent: the ordered list of child branch IDs registered. */
+    private readonly branches;
+    /** Per-parent: the set of child branch IDs that have exited so far. */
+    private readonly exited;
+    /** Reverse index: child branch ID → its parent fork. */
+    private readonly childToParent;
+    /** Set of `${parent}@${runtimeStageId}` keys already registered, to
+     *  coalesce repeated onFork events. */
+    private readonly emittedKeys;
+    /**
+     * Register a new fork. If the same fork (by parent+runtimeStageId)
+     * was already registered, returns `{ fresh: false }` and the caller
+     * should suppress emission. Otherwise registers all child branches
+     * and returns `{ fresh: true }`.
+     */
+    registerFork(parent: string, runtimeStageId: string, children: readonly string[]): ForkRegistration;
+    /** True if this child belongs to a tracked fork (used to suppress
+     *  sequential-emission for fork-branch entry events). */
+    isForkChild(childSubflowId: string): boolean;
+    /**
+     * Record a fork-branch exit. If this completes the fork (all branches
+     * have exited), returns `{ branches }` so the caller can emit a merge
+     * step. Returns `undefined` if not yet complete or not a fork branch.
+     */
+    recordChildExit(childSubflowId: string): MergeReady | undefined;
+    clear(): void;
+}
+//# sourceMappingURL=ForkTracker.d.ts.map

package/dist/types/recorders/observability/internal/ForkTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForkTracker.d.ts","sourceRoot":"","sources":["../../../../../src/recorders/observability/internal/ForkTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B;uDACmD;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB;sCACkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,qBAAa,WAAW;IACtB,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D;2CACuC;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAEjD;;;;;OAKG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,gBAAgB;IAYnB;6DACyD;IACzD,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;OAIG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAgB/D,KAAK,IAAI,IAAI;CAMd"}

package/dist/types/recorders/observability/internal/RootInferrer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @internal — not part of the public agentfootprint API. Imported only
+ * by RunStepRecorder. Subject to change without notice.
+ *
+ * RootInferrer — small state machine deciding whether a run's root is
+ * a single leaf primitive (Agent / LLMCall) or a composition (Sequence
+ * / Parallel / Conditional / Loop).
+ *
+ * Extracted from RunStepRecorder per Convention 1.
+ *
+ * Inputs: subflow entries (with their depth + parsed primitiveKind),
+ * fork events (depth 0 → Parallel root), decision events (depth 0 →
+ * Conditional root), loop events (depth 0 → Loop root).
+ *
+ * Output: query `kind()` for the inferred root. Returns `undefined`
+ * until a signal arrives.
+ *
+ * Inference rules:
+ *   - Decisive composition signals (fork / decide / loop AT DEPTH 0)
+ *     lock the root and are never overridden.
+ *   - Shallowest primitive boundary IS a composition kind → root is
+ *     that composition.
+ *   - Two+ leaf siblings at the shallowest depth → implicit Sequence
+ *     root (Sequence-as-runner case where the Sequence itself doesn't
+ *     fire its own subflow.entry).
+ *   - Single leaf at the shallowest depth → root is "leaf".
+ */
+export type InferredRoot = 'leaf' | 'sequence' | 'parallel' | 'conditional' | 'loop' | undefined;
+export declare class RootInferrer {
+    private inferred;
+    private shallowestDepth;
+    private shallowestSiblings;
+    /** Currently-inferred root kind, or undefined if no signal yet. */
+    kind(): InferredRoot;
+    /** True when the root is a single leaf primitive (or unknown,
+     *  which should be treated as leaf for kind-filter purposes). */
+    isLeafRoot(): boolean;
+    /** Observe a subflow entry. */
+    observeSubflowEntry(depth: number, primitiveKind: string | undefined): void;
+    /** Observe a fork event. Locks root to Parallel if at depth 0 and
+     *  no decisive root has been inferred yet. */
+    observeFork(depth: number): void;
+    /** Observe a decision event. Locks root to Conditional if at depth 0
+     *  and no decisive root has been inferred yet. */
+    observeDecision(depth: number): void;
+    /** Observe a loop event. Locks root to Loop if at depth 0 and no
+     *  decisive root has been inferred yet. */
+    observeLoop(depth: number): void;
+    clear(): void;
+    private tryInfer;
+}
+//# sourceMappingURL=RootInferrer.d.ts.map

package/dist/types/recorders/observability/internal/RootInferrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RootInferrer.d.ts","sourceRoot":"","sources":["../../../../../src/recorders/observability/internal/RootInferrer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAaH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjG,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,kBAAkB,CAAK;IAE/B,mEAAmE;IACnE,IAAI,IAAI,YAAY;IAIpB;qEACiE;IACjE,UAAU,IAAI,OAAO;IAIrB,+BAA+B;IAC/B,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAY3E;kDAC8C;IAC9C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC;sDACkD;IAClD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMpC;+CAC2C;IAC3C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,QAAQ;CA0BjB"}

package/dist/types/recorders/observability/internal/SequenceSiblingTracker.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @internal — not part of the public agentfootprint API. Imported only
+ * by RunStepRecorder. Subject to change without notice.
+ *
+ * SequenceSiblingTracker — tracks the most-recent leaf exit at each
+ * depth so the recorder knows when a new leaf entry at the same depth
+ * should emit a "sequential handoff" step ("forwards" semantics).
+ *
+ * Extracted from RunStepRecorder per Convention 1.
+ *
+ * Use:
+ *   - On leaf EXIT: `recordExit(depth, subflowId)`.
+ *   - On leaf ENTRY: `peekPrevSibling(depth)` returns the previous
+ *     leaf's subflowId at this depth, or undefined for the first leaf.
+ */
+export declare class SequenceSiblingTracker {
+    private readonly prevExitedAtDepth;
+    /** Returns the subflow id of the most-recently-exited leaf at this
+     *  depth, or undefined if this is the first leaf entry at the depth. */
+    peekPrevSibling(depth: number): string | undefined;
+    /** Record that a leaf at this depth just exited. */
+    recordExit(depth: number, subflowId: string): void;
+    clear(): void;
+}
+//# sourceMappingURL=SequenceSiblingTracker.d.ts.map

package/dist/types/recorders/observability/internal/SequenceSiblingTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceSiblingTracker.d.ts","sourceRoot":"","sources":["../../../../../src/recorders/observability/internal/SequenceSiblingTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAE/D;4EACwE;IACxE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIlD,oDAAoD;IACpD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIlD,KAAK,IAAI,IAAI;CAGd"}

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

@@ -0,0 +1,37 @@
+/**
+ * observeRunId — shared run-boundary detection helper for recorders.
+ *
+ * Why this exists: 5 places in observability/* duplicated the same
+ * 10-line pattern (lastRunId field + 3-line check + reset). Extract
+ * once so the contract stays consistent under maintenance.
+ *
+ * The pattern: hold a `lastRunId | undefined`. On every observed event:
+ *   - If runId is missing/undefined → no-op (defensive, allows callers
+ *     to pass `event.meta?.runId` without checking).
+ *   - First observation (lastRunId === undefined) → record, no reset.
+ *   - Same runId → no-op (steady state).
+ *   - Different runId → call onNewRun() then record the new id.
+ *
+ * Returned helper is mutable closure state — callers store it as a
+ * private field and call `.observe(runId)` from event hooks.
+ *
+ * @example
+ * ```typescript
+ * class MyRecorder implements ScopeRecorder {
+ *   private readonly runIdGuard = createRunIdObserver(() => this.reset());
+ *   onWrite(e) {
+ *     this.runIdGuard.observe(e.runId);
+ *     // ... handle event
+ *   }
+ *   private reset() { this.store.clear(); }
+ * }
+ * ```
+ */
+export interface RunIdObserver {
+    /** Process an event's runId; fires onNewRun callback when it changes. */
+    observe(runId: string | undefined): void;
+    /** Clear state so the next observation initializes fresh. */
+    reset(): void;
+}
+export declare function createRunIdObserver(onNewRun: () => void): RunIdObserver;
+//# sourceMappingURL=observeRunId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observeRunId.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/observeRunId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACzC,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,aAAa,CAkBvE"}

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;AAkFvF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAkT9E"}
+{"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;AAkFvF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAiT9E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "2.14.5",
+  "version": "3.0.0",
   "description": "The explainable agent framework — build AI agents you can explain, audit, and trust. Built on footprintjs.",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",
@@ -184,7 +184,7 @@
     "@aws-sdk/client-xray": "*",
     "@modelcontextprotocol/sdk": "*",
     "@opentelemetry/api": "*",
-    "footprintjs": ">=4.17.2",
+    "footprintjs": "^6.0.0",
     "ioredis": "*",
     "openai": "*",
     "zod": "*"
@@ -228,7 +228,7 @@
     "@vitest/coverage-v8": "^4.1.5",
     "eslint": "^8.44.0",
     "eslint-config-prettier": "^6.15.0",
-    "footprintjs": "^4.17.2",
+    "footprintjs": "^6.0.0",
     "prettier": "^2.8.1",
     "typedoc": "^0.28.19",
     "typedoc-plugin-markdown": "^4.11.0",