footprintjs 5.0.0 → 6.1.0

package/dist/types/lib/engine/narrative/index.d.ts

@@ -5,7 +5,7 @@ export { NullControlFlowNarrativeGenerator } from './NullControlFlowNarrativeGen
 export type { IControlFlowNarrative } from './types.js';
 export { FlowRecorderDispatcher } from './FlowRecorderDispatcher.js';
 export { NarrativeFlowRecorder } from './NarrativeFlowRecorder.js';
-export type { FlowBreakEvent, FlowDecisionEvent, FlowErrorEvent, FlowForkEvent, FlowLoopEvent, FlowNextEvent, FlowRecorder, FlowSelectedEvent, FlowStageEvent, FlowSubflowEvent, } from './types.js';
+export type { FlowBreakEvent, FlowDecisionEvent, FlowErrorEvent, FlowForkEvent, FlowLoopEvent, FlowNextEvent, FlowRecorder, FlowRunEvent, FlowRunFailedEvent, FlowSelectedEvent, FlowStageEvent, FlowSubflowEvent, } from './types.js';
 export { AdaptiveNarrativeFlowRecorder } from './recorders/AdaptiveNarrativeFlowRecorder.js';
 export { MilestoneNarrativeFlowRecorder } from './recorders/MilestoneNarrativeFlowRecorder.js';
 export { ProgressiveNarrativeFlowRecorder } from './recorders/ProgressiveNarrativeFlowRecorder.js';

package/dist/types/lib/engine/narrative/types.d.ts

@@ -13,9 +13,25 @@ import type { StructuredErrorInfo } from '../errors/errorInfo.js';
  * Uses Null Object pattern: NullControlFlowNarrativeGenerator satisfies this
  * interface with empty methods for zero-cost disabled path.
  */
+/**
+ * The kind of stage that completed. Lets consumers route uniform
+ * "did this stage execute" handling without a side-table lookup into
+ * the chart spec. Required on every `onStageExecuted` event since
+ * proposal #003 unified the event to fire for ALL stage kinds.
+ */
+export type StageType = 'linear' | 'decider' | 'fork' | 'selector' | 'subflow-mount';
 export interface IControlFlowNarrative {
-    /** Called when a stage executes. First stage uses distinct opening pattern. */
-    onStageExecuted(stageName: string, description?: string, traversalContext?: TraversalContext): void;
+    /**
+     * Called when a stage completes its main work. Fires for ALL stage
+     * kinds (`'linear'`, `'decider'`, `'fork'`, `'selector'`, `'subflow-mount'`)
+     * AFTER the corresponding specialized event (`onDecision`, `onFork`,
+     * `onSelected`, `onSubflowEntry`). For linear stages, fires after
+     * the stage function returns.
+     *
+     * Consumers tracking "did this stage run?" use this event uniformly
+     * and switch on `stageType` for kind-specific work.
+     */
+    onStageExecuted(stageName: string, description: string | undefined, traversalContext: TraversalContext | undefined, stageType: StageType): void;
     /** Called on linear continuation from one stage to the next. */
     onNext(fromStage: string, toStage: string, description?: string, traversalContext?: TraversalContext): void;
     /** Called when a decider selects a branch. Most valuable for LLM context. */
@@ -61,6 +77,22 @@ export interface IControlFlowNarrative {
      * NOT fire this event — they fire `onSubflowExit`.
      */
     onRunEnd(output: unknown, traversalContext?: TraversalContext): void;
+    /**
+     * Called once per top-level `executor.run()` when traversal throws a
+     * NON-pause error, BEFORE the exception propagates to `run()`'s caller.
+     *
+     * This is the TERMINAL counterpart to `onRunEnd` — it closes the run
+     * boundary symmetrically so every `onRunStart` is followed by exactly
+     * one of `onRunEnd` (clean) or `onRunFailed` (error). Without it, a
+     * live monitor sees `onRunStart` then silence on a failed run and can't
+     * tell "still running" from "crashed."
+     *
+     * Errors STILL throw — this is the observable terminal signal, not a
+     * recovery mechanism (no routing, no error-subflow). Pause is NOT an
+     * error, so it does not fire this. Subflow-traversers do NOT fire it;
+     * their errors propagate to the parent and surface at the top level.
+     */
+    onRunFailed(error: StructuredErrorInfo, traversalContext?: TraversalContext): void;
     /** Returns accumulated narrative sentences in execution order. */
     getSentences(): string[];
 }
@@ -115,6 +147,12 @@ export interface FlowStageEvent {
     description?: string;
     /** Traversal context from the engine — read-only, set by traverser. */
     traversalContext?: TraversalContext;
+    /**
+     * Which kind of stage completed. The engine fires `onStageExecuted`
+     * uniformly for every stage kind (proposal #003); consumers route by
+     * `stageType` without a chart-spec lookup.
+     */
+    stageType: StageType;
 }
 /** Event passed to FlowRecorder.onNext. */
 export interface FlowNextEvent {
@@ -242,6 +280,18 @@ export interface FlowRunEvent {
     payload?: unknown;
     traversalContext?: TraversalContext;
 }
+/**
+ * Event passed to FlowRecorder.onRunFailed — the TERMINAL failure boundary
+ * for a top-level run. Mirror of `onRunEnd` for the error path: it fires
+ * once, during traversal, when the run throws a non-pause error, before
+ * the exception propagates. Carries the structured error (field-level
+ * issues, codes) rather than a flattened string.
+ */
+export interface FlowRunFailedEvent {
+    /** Structured details of the error that terminated the run. */
+    structuredError: StructuredErrorInfo;
+    traversalContext?: TraversalContext;
+}
 /**
  * FlowRecorder — Pluggable observer for control flow events.
  *
@@ -287,6 +337,13 @@ export interface FlowRecorder {
      * pause (the run didn't end) or uncaught error.
      */
     onRunEnd?(event: FlowRunEvent): void;
+    /**
+     * Called once per top-level `executor.run()` when the run throws a
+     * non-pause error, BEFORE the exception propagates. The TERMINAL
+     * counterpart to `onRunEnd` — lets a monitor close the run boundary on
+     * failure instead of waiting forever. NOT fired on pause.
+     */
+    onRunFailed?(event: FlowRunFailedEvent): void;
     /** Called before each run to reset per-run state. Implement for stateful recorders. */
     clear?(): void;
     /** Optional: expose collected data for inclusion in snapshots. */

package/dist/types/lib/engine/runtimeStageId.d.ts

@@ -14,6 +14,15 @@
  *   - Human-readable ('sf-tools/execute-tool-calls#8')
  *   - Parseable (split on '#' for stageId and index, split stageId on '/' for subflow path)
  *
+ * Naming-collision warning
+ * ────────────────────────
+ *   The parsed-output `.stageId` field below is the LOCAL form (segment
+ *   after the last '/'). This is NOT the same as `spec.id` / `node.id`
+ *   for subflow-nested stages, which carry the FULL prefixed form
+ *   (`'sf-tools/execute-tool-calls'`). To compare safely, use
+ *   `splitStageId(spec.id)` to decompose the prefixed form the same
+ *   way `parseRuntimeStageId` decomposes a runtimeStageId.
+ *
  * @example
  * ```
  * buildRuntimeStageId('call-llm', 5)                    // 'call-llm#5'
@@ -29,12 +38,59 @@
  * consumers constructing IDs from parsed components (round-trip via parseRuntimeStageId).
  */
 export declare function buildRuntimeStageId(stageId: string, executionIndex: number, subflowPath?: string): string;
-/** Parse a runtimeStageId into its components. */
+/**
+ * Parse a runtimeStageId into its components.
+ *
+ * IMPORTANT — naming collision: the returned `stageId` is the LOCAL
+ * form (the segment between the last '/' and the '#'). This is NOT
+ * the same as `spec.id` or `node.id` for subflow-nested stages,
+ * which contain the FULL prefixed form.
+ *
+ *   parseRuntimeStageId('sf-tools/execute-tool-calls#8').stageId
+ *   // → 'execute-tool-calls'   (LOCAL)
+ *
+ *   node.id  // (post-mount, in a spec that contains subflows)
+ *   // → 'sf-tools/execute-tool-calls'   (FULL prefixed)
+ *
+ * To compare these two safely, use `splitStageId(node.id)` to get
+ * the local form, OR reconstruct the full form via
+ * `(subflowPath ? subflowPath + '/' : '') + stageId`.
+ */
 export declare function parseRuntimeStageId(runtimeStageId: string): {
     stageId: string;
     executionIndex: number;
     subflowPath: string | undefined;
 };
+/**
+ * Decompose a (possibly prefixed) stage id into its components.
+ *
+ * Use this when you have an id WITHOUT the `#N` execution suffix and
+ * need the local stage name and/or the subflow path. Common sources
+ * of such ids:
+ *   - `spec.id` (post-mount the id includes any subflow prefix)
+ *   - `CommitBundle.stageId` (post-mount id)
+ *   - `node.id` from xyflow nodes built off the spec
+ *   - the segment of `runtimeStageId` BEFORE the `#` (use
+ *     `parseRuntimeStageId` directly for full runtimeStageId strings)
+ *
+ * Mirrors the decomposition `parseRuntimeStageId` performs on the
+ * stageId portion of a runtimeStageId, so the two helpers stay in
+ * lockstep on naming and behavior.
+ *
+ * @example
+ * splitStageId('sf-tools/execute-tool-calls')
+ * // → { localStageId: 'execute-tool-calls', subflowPath: 'sf-tools' }
+ *
+ * splitStageId('execute-tool-calls')
+ * // → { localStageId: 'execute-tool-calls', subflowPath: undefined }
+ *
+ * splitStageId('sf-outer/sf-inner/validate')
+ * // → { localStageId: 'validate', subflowPath: 'sf-outer/sf-inner' }
+ */
+export declare function splitStageId(prefixedStageId: string): {
+    localStageId: string;
+    subflowPath: string | undefined;
+};
 /**
  * Shared mutable counter for execution index.
  * Passed by reference to child traversers (subflows) so they

package/dist/types/lib/engine/traversal/FlowchartTraverser.d.ts

@@ -21,7 +21,7 @@
 import type { ScopeProtectionMode } from '../../scope/protection/types.js';
 import { FlowRecorderDispatcher } from '../narrative/FlowRecorderDispatcher.js';
 import type { FlowRecorder, IControlFlowNarrative } from '../narrative/types.js';
-import type { ExtractorError, IExecutionRuntime, ILogger, ScopeFactory, SerializedPipelineStructure, StageFunction, StageNode, StreamHandlers, SubflowResult, TraversalExtractor, TraversalResult } from '../types.js';
+import type { IExecutionRuntime, ILogger, ScopeFactory, SerializedPipelineStructure, StageFunction, StageNode, StreamHandlers, SubflowResult, TraversalResult } from '../types.js';
 export interface TraverserOptions<TOut = any, TScope = any> {
     root: StageNode<TOut, TScope>;
     stageMap: Map<string, StageFunction<TOut, TScope>>;
@@ -32,12 +32,10 @@ export interface TraverserOptions<TOut = any, TScope = any> {
     executionEnv?: import('../../engine/types').ExecutionEnv;
     throttlingErrorChecker?: (error: unknown) => boolean;
     streamHandlers?: StreamHandlers;
-    extractor?: TraversalExtractor;
     scopeProtectionMode?: ScopeProtectionMode;
     subflows?: Record<string, {
         root: StageNode<TOut, TScope>;
     }>;
-    enrichSnapshots?: boolean;
     narrativeEnabled?: boolean;
     buildTimeStructure?: SerializedPipelineStructure;
     logger: ILogger;
@@ -103,7 +101,6 @@ export declare class FlowchartTraverser<TOut = any, TScope = any> {
     private readonly deciderHandler;
     private readonly selectorHandler;
     private readonly structureManager;
-    private readonly extractorRunner;
     private readonly narrativeGenerator;
     private readonly flowRecorderDispatcher;
     private subflowResults;
@@ -194,8 +191,6 @@ export declare class FlowchartTraverser<TOut = any, TScope = any> {
     getBranchIds(): string[];
     getRuntimeRoot(): StageNode;
     getSubflowResults(): Map<string, SubflowResult>;
-    getExtractedResults<TResult = unknown>(): Map<string, TResult>;
-    getExtractorErrors(): ExtractorError[];
     getNarrative(): string[];
     /** Returns the FlowRecorderDispatcher, or undefined if narrative is disabled. */
     getFlowRecorderDispatcher(): FlowRecorderDispatcher | undefined;

package/dist/types/lib/engine/types.d.ts

@@ -88,6 +88,25 @@ export interface SubflowMountOptions<TParentScope = any, TSubflowInput = any, TS
      * @default ArrayMergeMode.Concat
      */
     arrayMerge?: ArrayMergeMode;
+    /**
+     * STRUCTURE-ONLY: the downstream stage id this branch's convergence edge
+     * points to, overriding the default "converge at the next linear stage."
+     *
+     * When a fork/selector/decider branch carries `convergeAt`, its visualized
+     * `next` edge is fired to the named stage instead of to the shared
+     * convergence node its siblings use. This expresses an unequal-depth merge
+     * — e.g. a `tools` slot that bypasses the `messageAPI` assembly node and
+     * pairs with its output at `call-llm` (so `call-llm` reads as a 2-parent
+     * merge), faithful to the Anthropic wire protocol (system+messages = the
+     * message payload; tools = a separate top-level field).
+     *
+     * **This affects the STRUCTURE/topology graph only** — the runtime is
+     * unchanged (the branch's outputs ride shared scope; the named target reads
+     * them when it runs). It does NOT introduce a join barrier. The target is a
+     * FORWARD stage (added later in the chain), so it is not validated at
+     * branch-declaration time.
+     */
+    convergeAt?: string;
     /**
      * When `true`, an inner `scope.$break(reason)` call inside this subflow
      * propagates up to the parent — i.e., the parent's `breakFlag` is set
@@ -323,32 +342,6 @@ export interface RuntimeStructureMetadata {
     isLoopReference?: boolean;
     streamId?: string;
 }
-export interface StageSnapshot<TOut = any, TScope = any> {
-    node: StageNode<TOut, TScope>;
-    context: StageContext;
-    stepNumber: number;
-    structureMetadata: RuntimeStructureMetadata;
-    scopeState?: Record<string, unknown>;
-    debugInfo?: {
-        logs: Record<string, unknown>;
-        errors: Record<string, unknown>;
-        metrics: Record<string, unknown>;
-        evals: Record<string, unknown>;
-        flowMessages?: FlowMessage[];
-    };
-    stageOutput?: unknown;
-    errorInfo?: {
-        type: string;
-        message: string;
-    };
-    historyIndex?: number;
-}
-export type TraversalExtractor<TResult = unknown> = (snapshot: StageSnapshot) => TResult | undefined | null;
-export interface ExtractorError {
-    stagePath: string;
-    message: string;
-    error: unknown;
-}
 export type NodeResultType = {
     id: string;
     result: unknown;

package/dist/types/lib/engine/walkSubflowSpec.d.ts

@@ -0,0 +1,95 @@
+/**
+ * walkSubflowSpec — yield the structural shape of a subflow spec as a
+ * flat ordered stream of items, with `subflowPath` already composed
+ * for nested subflows.
+ *
+ * This is the public contract for traversing the structure delivered
+ * via `StructureSubflowMountedEvent.subflowSpec`. Item shapes mirror
+ * the corresponding Structure event payloads so consumers can route
+ * walker items through the same handlers they use for live events.
+ *
+ * Walker contract (LOCKED):
+ *   1. AUTO-RECURSE by default into nested subflows, with composed
+ *      paths (`parent/child/...`). Pass `{ recurse: false }` to walk
+ *      only one level.
+ *   2. ENTRY-STAGE MARKER FIRST: for each subflow (top-level and
+ *      nested), yields a `{ kind: 'subflow-start', ... }` item BEFORE
+ *      any stage/edge items from that subflow. Lets consumers draw the
+ *      boundary edge from the mount node to the entry stage.
+ *   3. COMPOSED PATHS: nested subflows get `parentPath + '/' + localId`.
+ *      Top-level mount paths are local-only (`'auth'`, NOT `'__root__/auth'`).
+ *   4. SHAPE MIRRORING: stage/edge/loop items have the same payload
+ *      shape as Structure events, with `subflowPath` added.
+ *   5. SOURCE DISCRIMINATOR: every walker item carries `source: 'walker'`
+ *      (Structure events do NOT). Lets consumers distinguish event vs
+ *      walker in logs/debuggers while still sharing handler code paths.
+ *   6. STAGE-ID PREFIXING: stage IDs in nested subflows are already
+ *      prefixed by the spec (e.g. `'auth/verify/check'`). Walker
+ *      preserves this; `subflowPath` field is redundant-but-explicit.
+ */
+import type { SerializedPipelineStructure } from '../builder/types.js';
+export interface WalkerOptions {
+    /** Auto-recurse into nested subflows (default: true). When false,
+     *  nested subflow items are yielded but their internals are not
+     *  traversed. */
+    recurse?: boolean;
+}
+export type WalkerItem = {
+    kind: 'subflow-start';
+    stageId: string;
+    subflowPath: string;
+    source: 'walker';
+} | {
+    kind: 'stage';
+    stageId: string;
+    name: string;
+    type: NonNullable<SerializedPipelineStructure['type']>;
+    isPausable?: boolean;
+    spec: SerializedPipelineStructure;
+    subflowPath: string;
+    source: 'walker';
+} | {
+    kind: 'edge';
+    from: string;
+    to: string;
+    edgeKind: 'next' | 'fork-branch' | 'decision-branch';
+    label?: string;
+    subflowPath: string;
+    source: 'walker';
+} | {
+    kind: 'loop';
+    from: string;
+    to: string;
+    subflowPath: string;
+    source: 'walker';
+} | {
+    kind: 'subflow';
+    mountStageId: string;
+    subflowId: string;
+    subflowName: string;
+    subflowSpec: SerializedPipelineStructure;
+    subflowPath: string;
+    source: 'walker';
+};
+/**
+ * Walk a subflow spec, yielding its structure as flat ordered items.
+ *
+ * @example
+ * ```ts
+ * import { walkSubflowSpec } from 'footprintjs/trace';
+ *
+ * onSubflowMounted(event) {
+ *   if (!event.subflowSpec) return; // lazy mount — no spec yet
+ *   for (const item of walkSubflowSpec(event.subflowSpec, event.subflowPath)) {
+ *     switch (item.kind) {
+ *       case 'subflow-start': break;        // entry boundary
+ *       case 'stage':         break;        // inner stage
+ *       case 'edge':          break;        // inner edge
+ *       case 'loop':          break;        // inner loop back-edge
+ *       case 'subflow':       break;        // nested mount marker
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare function walkSubflowSpec(spec: SerializedPipelineStructure, subflowPath: string, options?: WalkerOptions): Generator<WalkerItem, void, void>;

package/dist/types/lib/runner/FlowChartExecutor.d.ts

@@ -9,7 +9,7 @@
  *   const executor = new FlowChartExecutor(chart);
  *
  *   // Options-object form (preferred when you need to customize behavior):
- *   const executor = new FlowChartExecutor(chart, { scopeFactory: myFactory, enrichSnapshots: true });
+ *   const executor = new FlowChartExecutor(chart, { scopeFactory: myFactory });
  *
  *   // 2-param form (accepts a ScopeFactory directly, for backward compatibility):
  *   const executor = new FlowChartExecutor(chart, myFactory);
@@ -21,7 +21,7 @@ import type { CombinedNarrativeRecorderOptions } from '../engine/narrative/Combi
 import type { CombinedNarrativeEntry } from '../engine/narrative/narrativeTypes.js';
 import type { ManifestEntry } from '../engine/narrative/recorders/ManifestFlowRecorder.js';
 import type { FlowRecorder } from '../engine/narrative/types.js';
-import { type ExecutorResult, type ExtractorError, type RunOptions, type ScopeFactory, type SerializedPipelineStructure, type StageNode, type StreamHandlers, type SubflowResult } from '../engine/types.js';
+import { type ExecutorResult, type RunOptions, type ScopeFactory, type SerializedPipelineStructure, type StageNode, type StreamHandlers, type SubflowResult } from '../engine/types.js';
 import type { FlowchartCheckpoint } from '../pause/types.js';
 import type { CombinedRecorder } from '../recorder/CombinedRecorder.js';
 import type { EmitRecorder } from '../recorder/EmitRecorder.js';
@@ -34,7 +34,7 @@ import { type RuntimeSnapshot } from './ExecutionRuntime.js';
  * ```typescript
  * const ex = new FlowChartExecutor(chart, {
  *   scopeFactory: myFactory,
- *   enrichSnapshots: true,
+ *   defaultValuesForContext: { ... },
  * });
  * ```
  *
@@ -50,14 +50,6 @@ import { type RuntimeSnapshot } from './ExecutionRuntime.js';
 export interface FlowChartExecutorOptions<TScope = any> {
     /** Custom scope factory. Defaults to TypedScope or ScopeFacade auto-detection. */
     scopeFactory?: ScopeFactory<TScope>;
-    /**
-     * Attach a per-stage scope snapshot to each extractor result. When `true`, the
-     * extraction callback receives the full shared state at the point that stage
-     * committed — useful for debugging multi-stage state transitions. Defaults to
-     * `false` (no scope snapshot attached). Can also be set on the chart via
-     * `flowChart(...).enrichSnapshots(true)`.
-     */
-    enrichSnapshots?: boolean;
     /**
      * Default values pre-populated into the shared context before **each** stage
      * (re-applied every stage, acting as baseline defaults).
@@ -121,7 +113,7 @@ export declare class FlowChartExecutor<TOut = any, TScope = any> {
      *
      * **Options object form** (preferred):
      * ```typescript
-     * new FlowChartExecutor(chart, { scopeFactory, enrichSnapshots: true })
+     * new FlowChartExecutor(chart, { scopeFactory, defaultValuesForContext })
      * ```
      *
      * **2-param form** (also supported):
@@ -419,10 +411,6 @@ export declare class FlowChartExecutor<TOut = any, TScope = any> {
     getRuntimeStructure(): SerializedPipelineStructure | undefined;
     /** @internal */
     getSubflowResults(): Map<string, SubflowResult>;
-    /** @internal */
-    getExtractedResults<TResult = unknown>(): Map<string, TResult>;
-    /** @internal */
-    getExtractorErrors(): ExtractorError[];
     /**
      * Returns the subflow manifest from an attached ManifestFlowRecorder.
      * Returns empty array if no ManifestFlowRecorder is attached.

package/dist/types/trace.d.ts

@@ -21,7 +21,9 @@
  * ```
  */
 export type { ExecutionCounter } from './lib/engine/runtimeStageId.js';
-export { buildRuntimeStageId, createExecutionCounter, parseRuntimeStageId } from './lib/engine/runtimeStageId.js';
+export { buildRuntimeStageId, createExecutionCounter, parseRuntimeStageId, splitStageId, } from './lib/engine/runtimeStageId.js';
+export type { WalkerItem, WalkerOptions } from './lib/engine/walkSubflowSpec.js';
+export { walkSubflowSpec } from './lib/engine/walkSubflowSpec.js';
 export { findCommit, findCommits, findLastWriter } from './lib/memory/commitLogUtils.js';
 export type { CausalChainOptions, CausalNode, KeysReadLookup } from './lib/memory/backtrack.js';
 export { causalChain, flattenCausalDAG, formatCausalChain } from './lib/memory/backtrack.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "footprintjs",
-  "version": "5.0.0",
+  "version": "6.1.0",
   "description": "Explainable backend flows — automatic causal traces, decision evidence, and MCP tool generation for AI agents",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",
@@ -55,7 +55,9 @@
     "format": "prettier --config .prettierrc.js --list-different '{src,test}/**/*.ts'",
     "bench": "npx tsx bench/run.ts",
     "docs": "typedoc",
-    "docs:serve": "typedoc && npx serve docs"
+    "docs:serve": "typedoc && npx serve docs",
+    "test:coverage": "vitest run --coverage --coverage.reporter=json-summary --coverage.reporter=text-summary --coverage.reportsDirectory=coverage",
+    "coverage:badge": "npm run test:coverage; node scripts/coverage-badge.mjs"
   },
   "files": [
     "dist/**/*",
@@ -113,6 +115,7 @@
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "^5.61.0",
     "@typescript-eslint/parser": "^5.61.0",
+    "@vitest/coverage-v8": "^4.1.8",
     "concurrently": "^8.0.1",
     "eslint": "^8.44.0",
     "eslint-config-prettier": "^6.15.0",
@@ -129,6 +132,5 @@
     "typedoc": "^0.28.17",
     "typescript": "~5.4.5",
     "vitest": "^4.0.18"
-  },
-  "dependencies": {}
+  }
 }

package/dist/esm/lib/engine/handlers/ExtractorRunner.js

@@ -1,122 +0,0 @@
-/**
- * ExtractorRunner — Per-stage snapshot extraction.
- *
- * Coordinates traversal extractor invocations: step counting,
- * snapshot enrichment, error collection, and result storage.
- */
-import { computeNodeType } from './RuntimeStructureManager.js';
-export class ExtractorRunner {
-    extractor;
-    enrichSnapshots;
-    executionRuntime;
-    logger;
-    extractedResults = new Map();
-    extractorErrors = [];
-    stepCounter = 0;
-    /** Current subflow context for metadata propagation. Set/cleared during subflow execution. */
-    currentSubflowId;
-    /** Current fork context for metadata propagation. Set/cleared during parallel children execution. */
-    currentForkId;
-    constructor(extractor, enrichSnapshots, executionRuntime, logger) {
-        this.extractor = extractor;
-        this.enrichSnapshots = enrichSnapshots;
-        this.executionRuntime = executionRuntime;
-        this.logger = logger;
-    }
-    /**
-     * Call the extractor for a stage and store the result.
-     * Increments stepCounter (1-based) before creating snapshot.
-     */
-    callExtractor(node, context, stagePath, stageOutput, errorInfo) {
-        if (!this.extractor)
-            return;
-        this.stepCounter++;
-        try {
-            const snapshot = {
-                node,
-                context,
-                stepNumber: this.stepCounter,
-                structureMetadata: this.buildStructureMetadata(node),
-            };
-            if (this.enrichSnapshots) {
-                try {
-                    snapshot.scopeState = { ...this.executionRuntime.globalStore.getState() };
-                    snapshot.debugInfo = {
-                        logs: { ...context.debug.logContext },
-                        errors: { ...context.debug.errorContext },
-                        metrics: { ...context.debug.metricContext },
-                        evals: { ...context.debug.evalContext },
-                    };
-                    if (context.debug.flowMessages.length > 0) {
-                        snapshot.debugInfo.flowMessages = [...context.debug.flowMessages];
-                    }
-                    snapshot.stageOutput = stageOutput;
-                    if (errorInfo) {
-                        snapshot.errorInfo = errorInfo;
-                    }
-                    snapshot.historyIndex = this.executionRuntime.executionHistory.list().length;
-                }
-                catch (enrichError) {
-                    this.logger.warn(`Enrichment error at stage '${stagePath}':`, { error: enrichError });
-                }
-            }
-            const result = this.extractor(snapshot);
-            if (result !== undefined && result !== null) {
-                this.extractedResults.set(stagePath, result);
-            }
-        }
-        catch (error) {
-            this.logger.error(`Extractor error at stage '${stagePath}':`, { error });
-            this.extractorErrors.push({
-                stagePath,
-                message: error?.message ?? String(error),
-                error,
-            });
-        }
-    }
-    /**
-     * Generate the stage path for extractor results.
-     * Uses node.id combined with branchPath.
-     */
-    getStagePath(node, branchPath, contextStageName) {
-        const baseName = node.id;
-        const nodeId = contextStageName && contextStageName !== node.name ? contextStageName : baseName;
-        if (!branchPath)
-            return nodeId;
-        return `${branchPath}.${nodeId}`;
-    }
-    buildStructureMetadata(node) {
-        const metadata = {
-            type: computeNodeType(node),
-        };
-        if (node.isSubflowRoot) {
-            metadata.isSubflowRoot = true;
-            metadata.subflowId = node.subflowId;
-            metadata.subflowName = node.subflowName;
-        }
-        else if (this.currentSubflowId) {
-            metadata.subflowId = this.currentSubflowId;
-        }
-        if (this.currentForkId) {
-            metadata.isParallelChild = true;
-            metadata.parallelGroupId = this.currentForkId;
-        }
-        if (node.isStreaming) {
-            metadata.streamId = node.streamId;
-        }
-        const hasDynamicChildren = Boolean(node.children?.length && !node.nextNodeSelector && node.fn);
-        if (hasDynamicChildren) {
-            metadata.isDynamic = true;
-        }
-        return metadata;
-    }
-    /** Returns extracted results collected during execution. */
-    getExtractedResults() {
-        return this.extractedResults;
-    }
-    /** Returns errors encountered during extraction. */
-    getExtractorErrors() {
-        return this.extractorErrors;
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRXh0cmFjdG9yUnVubmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL2xpYi9lbmdpbmUvaGFuZGxlcnMvRXh0cmFjdG9yUnVubmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7OztHQUtHO0FBWUgsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBRS9ELE1BQU0sT0FBTyxlQUFlO0lBQ1QsU0FBUyxDQUFzQjtJQUMvQixlQUFlLENBQVU7SUFDekIsZ0JBQWdCLENBQW9CO0lBQ3BDLE1BQU0sQ0FBVTtJQUV6QixnQkFBZ0IsR0FBeUIsSUFBSSxHQUFHLEVBQUUsQ0FBQztJQUNuRCxlQUFlLEdBQXFCLEVBQUUsQ0FBQztJQUN2QyxXQUFXLEdBQUcsQ0FBQyxDQUFDO0lBRXhCLDhGQUE4RjtJQUM5RixnQkFBZ0IsQ0FBVTtJQUUxQixxR0FBcUc7SUFDckcsYUFBYSxDQUFVO0lBRXZCLFlBQ0UsU0FBeUMsRUFDekMsZUFBd0IsRUFDeEIsZ0JBQW1DLEVBQ25DLE1BQWU7UUFFZixJQUFJLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQztRQUMzQixJQUFJLENBQUMsZUFBZSxHQUFHLGVBQWUsQ0FBQztRQUN2QyxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsZ0JBQWdCLENBQUM7UUFDekMsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7SUFDdkIsQ0FBQztJQUVEOzs7T0FHRztJQUNILGFBQWEsQ0FDWCxJQUFlLEVBQ2YsT0FBcUIsRUFDckIsU0FBaUIsRUFDakIsV0FBcUIsRUFDckIsU0FBNkM7UUFFN0MsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTO1lBQUUsT0FBTztRQUU1QixJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7UUFFbkIsSUFBSSxDQUFDO1lBQ0gsTUFBTSxRQUFRLEdBQWtCO2dCQUM5QixJQUFJO2dCQUNKLE9BQU87Z0JBQ1AsVUFBVSxFQUFFLElBQUksQ0FBQyxXQUFX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KiBFeHRyYWN0b3JSdW5uZXIg4oCUIFBlci1zdGFnZSBzbmFwc2hvdCBleHRyYWN0aW9uLlxuICpcbiAqIENvb3JkaW5hdGVzIHRyYXZlcnNhbCBleHRyYWN0b3IgaW52b2NhdGlvbnM6IHN0ZXAgY291bnRpbmcsXG4gKiBzbmFwc2hvdCBlbnJpY2htZW50LCBlcnJvciBjb2xsZWN0aW9uLCBhbmQgcmVzdWx0IHN0b3JhZ2UuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBTdGFnZUNvbnRleHQgfSBmcm9tICcuLi8uLi9tZW1vcnkvU3RhZ2VDb250ZXh0LmpzJztcbmltcG9ydCB0eXBlIHsgU3RhZ2VOb2RlIH0gZnJvbSAnLi4vZ3JhcGgvU3RhZ2VOb2RlLmpzJztcbmltcG9ydCB0eXBlIHtcbiAgRXh0cmFjdG9yRXJyb3IsXG4gIElFeGVjdXRpb25SdW50aW1lLFxuICBJTG9nZ2VyLFxuICBSdW50aW1lU3RydWN0dXJlTWV0YWRhdGEsXG4gIFN0YWdlU25hcHNob3QsXG4gIFRyYXZlcnNhbEV4dHJhY3Rvcixcbn0gZnJvbSAnLi4vdHlwZXMuanMnO1xuaW1wb3J0IHsgY29tcHV0ZU5vZGVUeXBlIH0gZnJvbSAnLi9SdW50aW1lU3RydWN0dXJlTWFuYWdlci5qcyc7XG5cbmV4cG9ydCBjbGFzcyBFeHRyYWN0b3JSdW5uZXI8VE91dCA9IGFueSwgVFNjb3BlID0gYW55PiB7XG4gIHByaXZhdGUgcmVhZG9ubHkgZXh0cmFjdG9yPzogVHJhdmVyc2FsRXh0cmFjdG9yO1xuICBwcml2YXRlIHJlYWRvbmx5IGVucmljaFNuYXBzaG90czogYm9vbGVhbjtcbiAgcHJpdmF0ZSByZWFkb25seSBleGVjdXRpb25SdW50aW1lOiBJRXhlY3V0aW9uUnVudGltZTtcbiAgcHJpdmF0ZSByZWFkb25seSBsb2dnZXI6IElMb2dnZXI7XG5cbiAgcHJpdmF0ZSBleHRyYWN0ZWRSZXN1bHRzOiBNYXA8c3RyaW5nLCB1bmtub3duPiA9IG5ldyBNYXAoKTtcbiAgcHJpdmF0ZSBleHRyYWN0b3JFcnJvcnM6IEV4dHJhY3RvckVycm9yW10gPSBbXTtcbiAgcHJpdmF0ZSBzdGVwQ291bnRlciA9IDA7XG5cbiAgLyoqIEN1cnJlbnQgc3ViZmxvdyBjb250ZXh0IGZvciBtZXRhZGF0YSBwcm9wYWdhdGlvbi4gU2V0L2NsZWFyZWQgZHVyaW5nIHN1YmZsb3cgZXhlY3V0aW9uLiAqL1xuICBjdXJyZW50U3ViZmxvd0lkPzogc3RyaW5nO1xuXG4gIC8qKiBDdXJyZW50IGZvcmsgY29udGV4dCBmb3IgbWV0YWRhdGEgcHJvcGFnYXRpb24uIFNldC9jbGVhcmVkIGR1cmluZyBwYXJhbGxlbCBjaGlsZHJlbiBleGVjdXRpb24uICovXG4gIGN1cnJlbnRGb3JrSWQ/OiBzdHJpbmc7XG5cbiAgY29uc3RydWN0b3IoXG4gICAgZXh0cmFjdG9yOiBUcmF2ZXJzYWxFeHRyYWN0b3IgfCB1bmRlZmluZWQsXG4gICAgZW5yaWNoU25hcHNob3RzOiBib29sZWFuLFxuICAgIGV4ZWN1dGlvblJ1bnRpbWU6IElFeGVjdXRpb25SdW50aW1lLFxuICAgIGxvZ2dlcjogSUxvZ2dlcixcbiAgKSB7XG4gICAgdGhpcy5leHRyYWN0b3IgPSBleHRyYWN0b3I7XG4gICAgdGhpcy5lbnJpY2hTbmFwc2hvdHMgPSBlbnJpY2hTbmFwc2hvdHM7XG4gICAgdGhpcy5leGVjdXRpb25SdW50aW1lID0gZXhlY3V0aW9uUnVudGltZTtcbiAgICB0aGlzLmxvZ2dlciA9IGxvZ2dlcjtcbiAgfVxuXG4gIC8qKlxuICAgKiBDYWxsIHRoZSBleHRyYWN0b3IgZm9yIGEgc3RhZ2UgYW5kIHN0b3JlIHRoZSByZXN1bHQuXG4gICAqIEluY3JlbWVudHMgc3RlcENvdW50ZXIgKDEtYmFzZWQpIGJlZm9yZSBjcmVhdGluZyBzbmFwc2hvdC5cbiAgICovXG4gIGNhbGxFeHRyYWN0b3IoXG4gICAgbm9kZTogU3RhZ2VOb2RlLFxuICAgIGNvbnRleHQ6IFN0YWdlQ29udGV4dCxcbiAgICBzdGFnZVBhdGg6IHN0cmluZyxcbiAgICBzdGFnZU91dHB1dD86IHVua25vd24sXG4gICAgZXJyb3JJbmZvPzogeyB0eXBlOiBzdHJpbmc7IG1lc3NhZ2U6IHN0cmluZyB9LFxuICApOiB2b2lkIHtcbiAgICBpZiAoIXRoaXMuZXh0cmFjdG9yKSByZXR1cm47XG5cbiAgICB0aGlzLnN0ZXBDb3VudGVyKys7XG5cbiAgICB0cnkge1xuICAgICAgY29uc3Qgc25hcHNob3Q6IFN0YWdlU25hcHNob3QgPSB7XG4gICAgICAgIG5vZGUsXG4gICAgICAgIGNvbnRleHQsXG4gICAgICAgIHN0ZXBOdW1iZXI6IHRoaXMuc3RlcENvdW50ZXIsXG4gICAgICAgIHN0cnVjdHVyZU1ldGFkYXRhOiB0aGlzLmJ1aWxkU3RydWN0dXJlTWV0YWRhdGEobm9kZSksXG4gICAgICB9O1xuXG4gICAgICBpZiAodGhpcy5lbnJpY2hTbmFwc2hvdHMpIHtcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICBzbmFwc2hvdC5zY29wZVN0YXRlID0geyAuLi50aGlzLmV4ZWN1dGlvblJ1bnRpbWUuZ2xvYmFsU3RvcmUuZ2V0U3RhdGUoKSB9O1xuXG4gICAgICAgICAgc25hcHNob3QuZGVidWdJbmZvID0ge1xuICAgICAgICAgICAgbG9nczogeyAuLi5jb250ZXh0LmRlYnVnLmxvZ0NvbnRleHQgfSxcbiAgICAgICAgICAgIGVycm9yczogeyAuLi5jb250ZXh0LmRlYnVnLmVycm9yQ29udGV4dCB9LFxuICAgICAgICAgICAgbWV0cmljczogeyAuLi5jb250ZXh0LmRlYnVnLm1ldHJpY0NvbnRleHQgfSxcbiAgICAgICAgICAgIGV2YWxzOiB7IC4uLmNvbnRleHQuZGVidWcuZXZhbENvbnRleHQgfSxcbiAgICAgICAgICB9O1xuICAgICAgICAgIGlmIChjb250ZXh0LmRlYnVnLmZsb3dNZXNzYWdlcy5sZW5ndGggPiAwKSB7XG4gICAgICAgICAgICBzbmFwc2hvdC5kZWJ1Z0luZm8uZmxvd01lc3NhZ2VzID0gWy4uLmNvbnRleHQuZGVidWcuZmxvd01lc3NhZ2VzXTtcbiAgICAgICAgICB9XG5cbiAgICAgICAgICBzbmFwc2hvdC5zdGFnZU91dHB1dCA9IHN0YWdlT3V0cHV0O1xuXG4gICAgICAgICAgaWYgKGVycm9ySW5mbykge1xuICAgICAgICAgICAgc25hcHNob3QuZXJyb3JJbmZvID0gZXJyb3JJbmZvO1xuICAgICAgICAgIH1cblxuICAgICAgICAgIHNuYXBzaG90Lmhpc3RvcnlJbmRleCA9IHRoaXMuZXhlY3V0aW9uUnVudGltZS5leGVjdXRpb25IaXN0b3J5Lmxpc3QoKS5sZW5ndGg7XG4gICAgICAgIH0gY2F0Y2ggKGVucmljaEVycm9yOiBhbnkpIHtcbiAgICAgICAgICB0aGlzLmxvZ2dlci53YXJuKGBFbnJpY2htZW50IGVycm9yIGF0IHN0YWdlICcke3N0YWdlUGF0aH0nOmAsIHsgZXJyb3I6IGVucmljaEVycm9yIH0pO1xuICAgICAgICB9XG4gICAgICB9XG5cbiAgICAgIGNvbnN0IHJlc3VsdCA9IHRoaXMuZXh0cmFjdG9yKHNuYXBzaG90KTtcblxuICAgICAgaWYgKHJlc3VsdCAhPT0gdW5kZWZpbmVkICYmIHJlc3VsdCAhPT0gbnVsbCkge1xuICAgICAgICB0aGlzLmV4dHJhY3RlZFJlc3VsdHMuc2V0KHN0YWdlUGF0aCwgcmVzdWx0KTtcbiAgICAgIH1cbiAgICB9IGNhdGNoIChlcnJvcjogYW55KSB7XG4gICAgICB0aGlzLmxvZ2dlci5lcnJvcihgRXh0cmFjdG9yIGVycm9yIGF0IHN0YWdlICcke3N0YWdlUGF0aH0nOmAsIHsgZXJyb3IgfSk7XG4gICAgICB0aGlzLmV4dHJhY3RvckVycm9ycy5wdXNoKHtcbiAgICAgICAgc3RhZ2VQYXRoLFxuICAgICAgICBtZXNzYWdlOiBlcnJvcj8ubWVzc2FnZSA/PyBTdHJpbmcoZXJyb3IpLFxuICAgICAgICBlcnJvcixcbiAgICAgIH0pO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBHZW5lcmF0ZSB0aGUgc3RhZ2UgcGF0aCBmb3IgZXh0cmFjdG9yIHJlc3VsdHMuXG4gICAqIFVzZXMgbm9kZS5pZCBjb21iaW5lZCB3aXRoIGJyYW5jaFBhdGguXG4gICAqL1xuICBnZXRTdGFnZVBhdGgobm9kZTogU3RhZ2VOb2RlLCBicmFuY2hQYXRoPzogc3RyaW5nLCBjb250ZXh0U3RhZ2VOYW1lPzogc3RyaW5nKTogc3RyaW5nIHtcbiAgICBjb25zdCBiYXNlTmFtZSA9IG5vZGUuaWQ7XG4gICAgY29uc3Qgbm9kZUlkID0gY29udGV4dFN0YWdlTmFtZSAmJiBjb250ZXh0U3RhZ2VOYW1lICE9PSBub2RlLm5hbWUgPyBjb250ZXh0U3RhZ2VOYW1lIDogYmFzZU5hbWU7XG4gICAgaWYgKCFicmFuY2hQYXRoKSByZXR1cm4gbm9kZUlkO1xuICAgIHJldHVybiBgJHticmFuY2hQYXRofS4ke25vZGVJZH1gO1xuICB9XG5cbiAgcHJpdmF0ZSBidWlsZFN0cnVjdHVyZU1ldGFkYXRhKG5vZGU6IFN0YWdlTm9kZSk6IFJ1bnRpbWVTdHJ1Y3R1cmVNZXRhZGF0YSB7XG4gICAgY29uc3QgbWV0YWRhdGE6IFJ1bnRpbWVTdHJ1Y3R1cmVNZXRhZGF0YSA9IHtcbiAgICAgIHR5cGU6IGNvbXB1dGVOb2RlVHlwZShub2RlKSxcbiAgICB9O1xuXG4gICAgaWYgKG5vZGUuaXNTdWJmbG93Um9vdCkge1xuICAgICAgbWV0YWRhdGEuaXNTdWJmbG93Um9vdCA9IHRydWU7XG4gICAgICBtZXRhZGF0YS5zdWJmbG93SWQgPSBub2RlLnN1YmZsb3dJZDtcbiAgICAgIG1ldGFkYXRhLnN1YmZsb3dOYW1lID0gbm9kZS5zdWJmbG93TmFtZTtcbiAgICB9IGVsc2UgaWYgKHRoaXMuY3VycmVudFN1YmZsb3dJZCkge1xuICAgICAgbWV0YWRhdGEuc3ViZmxvd0lkID0gdGhpcy5jdXJyZW50U3ViZmxvd0lkO1xuICAgIH1cblxuICAgIGlmICh0aGlzLmN1cnJlbnRGb3JrSWQpIHtcbiAgICAgIG1ldGFkYXRhLmlzUGFyYWxsZWxDaGlsZCA9IHRydWU7XG4gICAgICBtZXRhZGF0YS5wYXJhbGxlbEdyb3VwSWQgPSB0aGlzLmN1cnJlbnRGb3JrSWQ7XG4gICAgfVxuXG4gICAgaWYgKG5vZGUuaXNTdHJlYW1pbmcpIHtcbiAgICAgIG1ldGFkYXRhLnN0cmVhbUlkID0gbm9kZS5zdHJlYW1JZDtcbiAgICB9XG5cbiAgICBjb25zdCBoYXNEeW5hbWljQ2hpbGRyZW4gPSBCb29sZWFuKG5vZGUuY2hpbGRyZW4/Lmxlbmd0aCAmJiAhbm9kZS5uZXh0Tm9kZVNlbGVjdG9yICYmIG5vZGUuZm4pO1xuICAgIGlmIChoYXNEeW5hbWljQ2hpbGRyZW4pIHtcbiAgICAgIG1ldGFkYXRhLmlzRHluYW1pYyA9IHRydWU7XG4gICAgfVxuXG4gICAgcmV0dXJuIG1ldGFkYXRhO1xuICB9XG5cbiAgLyoqIFJldHVybnMgZXh0cmFjdGVkIHJlc3VsdHMgY29sbGVjdGVkIGR1cmluZyBleGVjdXRpb24uICovXG4gIGdldEV4dHJhY3RlZFJlc3VsdHM8VFJlc3VsdCA9IHVua25vd24+KCk6IE1hcDxzdHJpbmcsIFRSZXN1bHQ+IHtcbiAgICByZXR1cm4gdGhpcy5leHRyYWN0ZWRSZXN1bHRzIGFzIE1hcDxzdHJpbmcsIFRSZXN1bHQ+O1xuICB9XG5cbiAgLyoqIFJldHVybnMgZXJyb3JzIGVuY291bnRlcmVkIGR1cmluZyBleHRyYWN0aW9uLiAqL1xuICBnZXRFeHRyYWN0b3JFcnJvcnMoKTogRXh0cmFjdG9yRXJyb3JbXSB7XG4gICAgcmV0dXJuIHRoaXMuZXh0cmFjdG9yRXJyb3JzO1xuICB9XG59XG4iXX0=