flowcraft 2.2.0 → 2.3.1

package/dist/runtime/executors.js

@@ -1,4 +1,4 @@
-export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from '../chunk-M2FRTT2K.js';
-import '../chunk-5ZXV3R5D.js';
+export { ClassNodeExecutor, FunctionNodeExecutor, NodeExecutor } from '../chunk-ONH7PIJZ.js';
+import '../chunk-BCRWXTWX.js';
 //# sourceMappingURL=executors.js.map
 //# sourceMappingURL=executors.js.map

package/dist/runtime/index.d.ts

@@ -1,8 +1,6 @@
 export { AdapterOptions, BaseDistributedAdapter, ICoordinationStore, JobPayload } from './adapter.js';
-export { BuiltInNodeExecutor, ClassNodeExecutor, ExecutionStrategy, FunctionNodeExecutor } from './executors.js';
-export { FlowRuntime } from './runtime.js';
-export { WorkflowState } from './state.js';
-export { GraphTraverser } from './traverser.js';
-import '../types-CsTeXTiA.js';
-import './builtin-keys.js';
-import './types.js';
+export { C as ClassNodeExecutor, e as ExecutionServices, E as ExecutionStrategy, c as FlowRuntime, F as FunctionNodeExecutor, G as GraphTraverser, I as IOrchestrator, f as IRuntime, N as NodeExecutionResult, b as NodeExecutor, a as NodeExecutorConfig, d as NodeExecutorFactory, R as ReadyNode, W as WorkflowState } from '../types-ezHUBdpL.js';
+export { DefaultOrchestrator } from './orchestrator.js';
+export { executeBatch, processResults } from './orchestrators/utils.js';
+import '../errors.js';
+import '../container.js';

package/dist/runtime/index.js

@@ -1,16 +1,27 @@
-import '../chunk-HMR2GEGE.js';
-export { BaseDistributedAdapter } from '../chunk-QLGJUDQF.js';
-export { FlowRuntime } from '../chunk-OTS5YJ3S.js';
-export { WorkflowState } from '../chunk-VSGQDLBF.js';
-export { GraphTraverser } from '../chunk-GEKDR2SS.js';
+import '../chunk-NVJ3ZO3P.js';
+import '../chunk-NVLZFLYM.js';
+export { BaseDistributedAdapter } from '../chunk-ZNL7ZXPR.js';
+export { FlowRuntime } from '../chunk-HKX7WQLS.js';
+import '../chunk-MCGK3FXQ.js';
+import '../chunk-MKNZBKSR.js';
+export { GraphTraverser } from '../chunk-G5BGBPFP.js';
+import '../chunk-CD3Q4N6V.js';
+import '../chunk-DL7KVYZF.js';
+export { ClassNodeExecutor, FunctionNodeExecutor, NodeExecutor } from '../chunk-ONH7PIJZ.js';
 import '../chunk-DSYAC4WB.js';
+import '../chunk-BC4G7OM6.js';
+import '../chunk-RM677CNU.js';
+import '../chunk-233SESC2.js';
+export { DefaultOrchestrator } from '../chunk-33NO4PUJ.js';
+export { executeBatch, processResults } from '../chunk-HAZ26F3P.js';
+import '../chunk-FRKO3WX4.js';
+export { WorkflowState } from '../chunk-CD4FUZOJ.js';
+import '../chunk-4PELJWF7.js';
 import '../chunk-CYHZ2YVH.js';
-export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from '../chunk-M2FRTT2K.js';
+import '../chunk-WWGFIYKW.js';
 import '../chunk-R3HQXIEL.js';
-import '../chunk-5ZXV3R5D.js';
+import '../chunk-BCRWXTWX.js';
 import '../chunk-PH2IYZHV.js';
-import '../chunk-U5V5O5MN.js';
-import '../chunk-233SESC2.js';
-import '../chunk-4PELJWF7.js';
+import '../chunk-LNK7LZER.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/runtime/node-executor-factory.d.ts

@@ -0,0 +1,12 @@
+import { z as IEventBus, K as ExecutionContext, b as NodeExecutor } from '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';
+
+declare class NodeExecutorFactory {
+    private readonly eventBus;
+    constructor(eventBus: IEventBus);
+    createExecutorForNode(nodeId: string, context: ExecutionContext<any, any>): NodeExecutor<any, any>;
+    private getExecutionStrategy;
+}
+
+export { NodeExecutorFactory };

package/dist/runtime/node-executor-factory.js

@@ -0,0 +1,6 @@
+export { NodeExecutorFactory } from '../chunk-DL7KVYZF.js';
+import '../chunk-ONH7PIJZ.js';
+import '../chunk-BCRWXTWX.js';
+import '../chunk-LNK7LZER.js';
+//# sourceMappingURL=node-executor-factory.js.map
+//# sourceMappingURL=node-executor-factory.js.map

package/dist/runtime/node-executor-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"node-executor-factory.js"}

package/dist/runtime/orchestrator.d.ts

@@ -0,0 +1,9 @@
+import { I as IOrchestrator, K as ExecutionContext, G as GraphTraverser, J as WorkflowResult } from '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';
+
+declare class DefaultOrchestrator implements IOrchestrator {
+    run(context: ExecutionContext<any, any>, traverser: GraphTraverser): Promise<WorkflowResult<any>>;
+}
+
+export { DefaultOrchestrator };

package/dist/runtime/orchestrator.js

@@ -0,0 +1,8 @@
+export { DefaultOrchestrator } from '../chunk-33NO4PUJ.js';
+import '../chunk-HAZ26F3P.js';
+import '../chunk-FRKO3WX4.js';
+import '../chunk-CD4FUZOJ.js';
+import '../chunk-R3HQXIEL.js';
+import '../chunk-BCRWXTWX.js';
+//# sourceMappingURL=orchestrator.js.map
+//# sourceMappingURL=orchestrator.js.map

package/dist/runtime/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"orchestrator.js"}

package/dist/runtime/orchestrators/step-by-step.d.ts

@@ -0,0 +1,16 @@
+import { I as IOrchestrator, K as ExecutionContext, G as GraphTraverser, J as WorkflowResult } from '../../types-ezHUBdpL.js';
+import '../../errors.js';
+import '../../container.js';
+
+/**
+ * An orchestrator that executes only one "tick" or "turn" of the workflow.
+ * It processes a single batch of ready nodes from the frontier and then returns,
+ * allowing the caller to inspect the intermediate state before proceeding.
+ *
+ * Useful for debugging, testing, or building interactive tools.
+ */
+declare class StepByStepOrchestrator implements IOrchestrator {
+    run(context: ExecutionContext<any, any>, traverser: GraphTraverser): Promise<WorkflowResult<any>>;
+}
+
+export { StepByStepOrchestrator };

package/dist/runtime/orchestrators/step-by-step.js

@@ -0,0 +1,5 @@
+export { StepByStepOrchestrator } from '../../chunk-G53CSLBF.js';
+import '../../chunk-HAZ26F3P.js';
+import '../../chunk-BCRWXTWX.js';
+//# sourceMappingURL=step-by-step.js.map
+//# sourceMappingURL=step-by-step.js.map

package/dist/runtime/orchestrators/step-by-step.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"step-by-step.js"}

package/dist/runtime/orchestrators/utils.d.ts

@@ -0,0 +1,35 @@
+import { g as WorkflowBlueprint, W as WorkflowState, N as NodeExecutionResult, G as GraphTraverser } from '../../types-ezHUBdpL.js';
+import '../../errors.js';
+import '../../container.js';
+
+declare function executeBatch(readyNodes: Array<{
+    nodeId: string;
+    nodeDef: any;
+}>, blueprint: WorkflowBlueprint, state: WorkflowState<any>, executorFactory: (nodeId: string) => any, runtime: any, maxConcurrency?: number): Promise<Array<{
+    status: 'fulfilled';
+    value: {
+        nodeId: string;
+        executionResult: NodeExecutionResult;
+    };
+} | {
+    status: 'rejected';
+    reason: {
+        nodeId: string;
+        error: unknown;
+    };
+}>>;
+declare function processResults(settledResults: Array<{
+    status: 'fulfilled';
+    value: {
+        nodeId: string;
+        executionResult: NodeExecutionResult;
+    };
+} | {
+    status: 'rejected';
+    reason: {
+        nodeId: string;
+        error: unknown;
+    };
+}>, traverser: GraphTraverser, state: WorkflowState<any>, runtime: any, _blueprint: WorkflowBlueprint, executionId?: string): Promise<void>;
+
+export { executeBatch, processResults };

package/dist/runtime/orchestrators/utils.js

@@ -0,0 +1,4 @@
+export { executeBatch, processResults } from '../../chunk-HAZ26F3P.js';
+import '../../chunk-BCRWXTWX.js';
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/runtime/orchestrators/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"utils.js"}

package/dist/runtime/runtime.d.ts

@@ -1,41 +1,3 @@
-import { d as NodeFunction, e as NodeClass, B as BaseNode, j as RuntimeOptions, W as WorkflowBlueprint, p as WorkflowResult, b as NodeResult, C as ContextImplementation, N as NodeDefinition, E as EdgeDefinition } from '../types-CsTeXTiA.js';
-import { DynamicKeys } from './builtin-keys.js';
-import { WorkflowState } from './state.js';
-import { IRuntime } from './types.js';
-
-type InternalFlowContext<TContext extends Record<string, any>> = TContext & Partial<DynamicKeys>;
-declare class FlowRuntime<TContext extends Record<string, any>, TDependencies extends Record<string, any>> implements IRuntime<TContext, TDependencies> {
-    registry: Record<string, NodeFunction | NodeClass | typeof BaseNode>;
-    private blueprints;
-    private dependencies;
-    private logger;
-    private eventBus;
-    private serializer;
-    private middleware;
-    private evaluator;
-    /**
-     * Cache for blueprint analysis results to avoid recomputing for the same blueprint object.
-     * Uses WeakMap to allow garbage collection of unused blueprints.
-     */
-    private analysisCache;
-    options: RuntimeOptions<TDependencies>;
-    constructor(options: RuntimeOptions<TDependencies>);
-    run(blueprint: WorkflowBlueprint, initialState?: Partial<TContext> | string, options?: {
-        functionRegistry?: Map<string, any>;
-        strict?: boolean;
-        signal?: AbortSignal;
-        concurrency?: number;
-    }): Promise<WorkflowResult<TContext>>;
-    executeNode(blueprint: WorkflowBlueprint, nodeId: string, state: WorkflowState<TContext>, allPredecessors?: Map<string, Set<string>>, functionRegistry?: Map<string, any>, executionId?: string, signal?: AbortSignal): Promise<NodeResult<any, any>>;
-    private getExecutor;
-    private executeWithFallback;
-    determineNextNodes(blueprint: WorkflowBlueprint, nodeId: string, result: NodeResult<any, any>, context: ContextImplementation<TContext>, executionId?: string): Promise<{
-        node: NodeDefinition;
-        edge: EdgeDefinition;
-    }[]>;
-    applyEdgeTransform(edge: EdgeDefinition, sourceResult: NodeResult<any, any>, targetNode: NodeDefinition, context: ContextImplementation<TContext>, allPredecessors?: Map<string, Set<string>>): Promise<void>;
-    private _resolveNodeInput;
-    protected _executeBuiltInNode(nodeDef: NodeDefinition, contextImpl: ContextImplementation<InternalFlowContext<TContext>>, functionRegistry?: Map<string, any>): Promise<NodeResult<any, any>>;
-}
-
-export { FlowRuntime };
+import '../container.js';
+export { c as FlowRuntime } from '../types-ezHUBdpL.js';
+import '../errors.js';

package/dist/runtime/runtime.js

@@ -1,14 +1,24 @@
-export { FlowRuntime } from '../chunk-OTS5YJ3S.js';
-import '../chunk-VSGQDLBF.js';
-import '../chunk-GEKDR2SS.js';
+export { FlowRuntime } from '../chunk-HKX7WQLS.js';
+import '../chunk-MCGK3FXQ.js';
+import '../chunk-MKNZBKSR.js';
+import '../chunk-G5BGBPFP.js';
+import '../chunk-CD3Q4N6V.js';
+import '../chunk-DL7KVYZF.js';
+import '../chunk-ONH7PIJZ.js';
 import '../chunk-DSYAC4WB.js';
+import '../chunk-BC4G7OM6.js';
+import '../chunk-RM677CNU.js';
+import '../chunk-233SESC2.js';
+import '../chunk-33NO4PUJ.js';
+import '../chunk-HAZ26F3P.js';
+import '../chunk-FRKO3WX4.js';
+import '../chunk-CD4FUZOJ.js';
+import '../chunk-4PELJWF7.js';
 import '../chunk-CYHZ2YVH.js';
-import '../chunk-M2FRTT2K.js';
+import '../chunk-WWGFIYKW.js';
 import '../chunk-R3HQXIEL.js';
-import '../chunk-5ZXV3R5D.js';
+import '../chunk-BCRWXTWX.js';
 import '../chunk-PH2IYZHV.js';
-import '../chunk-U5V5O5MN.js';
-import '../chunk-233SESC2.js';
-import '../chunk-4PELJWF7.js';
+import '../chunk-LNK7LZER.js';
 //# sourceMappingURL=runtime.js.map
 //# sourceMappingURL=runtime.js.map

package/dist/runtime/state.d.ts

@@ -1,21 +1,3 @@
-import { C as ContextImplementation, o as WorkflowError, p as WorkflowResult, n as ISerializer } from '../types-CsTeXTiA.js';
-
-declare class WorkflowState<TContext extends Record<string, any>> {
-    private _completedNodes;
-    private errors;
-    private anyFallbackExecuted;
-    private context;
-    constructor(initialData: Partial<TContext>);
-    addCompletedNode(nodeId: string, output: any): void;
-    addError(nodeId: string, error: Error): void;
-    clearError(nodeId: string): void;
-    markFallbackExecuted(): void;
-    getContext(): ContextImplementation<TContext>;
-    getCompletedNodes(): Set<string>;
-    getErrors(): WorkflowError[];
-    getAnyFallbackExecuted(): boolean;
-    getStatus(allNodeIds: Set<string>, _fallbackNodeIds: Set<string>): WorkflowResult['status'];
-    toResult(serializer: ISerializer): WorkflowResult<TContext>;
-}
-
-export { WorkflowState };
+export { W as WorkflowState } from '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';

package/dist/runtime/state.js

@@ -1,4 +1,5 @@
-export { WorkflowState } from '../chunk-VSGQDLBF.js';
+export { WorkflowState } from '../chunk-CD4FUZOJ.js';
 import '../chunk-R3HQXIEL.js';
+import '../chunk-BCRWXTWX.js';
 //# sourceMappingURL=state.js.map
 //# sourceMappingURL=state.js.map

package/dist/runtime/traverser.d.ts

@@ -1,26 +1,3 @@
-import { W as WorkflowBlueprint } from '../types-CsTeXTiA.js';
-import { WorkflowState } from './state.js';
-import { IRuntime } from './types.js';
-
-declare class GraphTraverser<TContext extends Record<string, any>, TDependencies extends Record<string, any>> {
-    private runtime;
-    private state;
-    private functionRegistry;
-    private executionId;
-    private signal?;
-    private concurrency?;
-    private frontier;
-    private allPredecessors;
-    private dynamicBlueprint;
-    constructor(blueprint: WorkflowBlueprint, runtime: IRuntime<TContext, TDependencies>, state: WorkflowState<TContext>, functionRegistry: Map<string, any> | undefined, executionId: string, signal?: AbortSignal | undefined, concurrency?: number | undefined);
-    private isFallbackNode;
-    private getEffectiveJoinStrategy;
-    traverse(): Promise<void>;
-    private executeWithConcurrency;
-    private handleDynamicNodes;
-    getAllNodeIds(): Set<string>;
-    getFallbackNodeIds(): Set<string>;
-    getDynamicBlueprint(): WorkflowBlueprint;
-}
-
-export { GraphTraverser };
+export { G as GraphTraverser, R as ReadyNode } from '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';

package/dist/runtime/traverser.js

@@ -1,5 +1,4 @@
-export { GraphTraverser } from '../chunk-GEKDR2SS.js';
-import '../chunk-5ZXV3R5D.js';
+export { GraphTraverser } from '../chunk-G5BGBPFP.js';
 import '../chunk-233SESC2.js';
 //# sourceMappingURL=traverser.js.map
 //# sourceMappingURL=traverser.js.map

package/dist/runtime/types.d.ts

@@ -1,16 +1,3 @@
-import { R as RuntimeDependencies, j as RuntimeOptions, W as WorkflowBlueprint, b as NodeResult, C as ContextImplementation, N as NodeDefinition, E as EdgeDefinition } from '../types-CsTeXTiA.js';
-import { WorkflowState } from './state.js';
-
-/** Interface for the core runtime operations used by the traverser. */
-interface IRuntime<TContext extends Record<string, any> = Record<string, any>, TDependencies extends RuntimeDependencies = RuntimeDependencies> {
-    options: RuntimeOptions<TDependencies>;
-    registry: Record<string, any>;
-    executeNode: (blueprint: WorkflowBlueprint, nodeId: string, state: WorkflowState<TContext>, allPredecessors?: Map<string, Set<string>>, functionRegistry?: Map<string, any>, executionId?: string, signal?: AbortSignal) => Promise<NodeResult>;
-    determineNextNodes: (blueprint: WorkflowBlueprint, nodeId: string, result: NodeResult, context: ContextImplementation<TContext>, executionId?: string) => Promise<{
-        node: NodeDefinition;
-        edge: EdgeDefinition;
-    }[]>;
-    applyEdgeTransform: (edge: EdgeDefinition, sourceResult: NodeResult, targetNode: NodeDefinition, context: ContextImplementation<TContext>, allPredecessors?: Map<string, Set<string>>) => Promise<void>;
-}
-
-export type { IRuntime };
+export { e as ExecutionServices, I as IOrchestrator, f as IRuntime, N as NodeExecutionResult, b as NodeExecutor, d as NodeExecutorFactory } from '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';

package/dist/runtime/types.js

@@ -1,3 +1,3 @@
-
+import '../chunk-NVLZFLYM.js';
 //# sourceMappingURL=types.js.map
 //# sourceMappingURL=types.js.map

package/dist/runtime/workflow-logic-handler.d.ts

@@ -0,0 +1,17 @@
+import { w as IEvaluator, z as IEventBus, g as WorkflowBlueprint, l as NodeResult, r as ContextImplementation, h as NodeDefinition, j as EdgeDefinition } from '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';
+
+declare class WorkflowLogicHandler {
+    private readonly evaluator;
+    private readonly eventBus;
+    constructor(evaluator: IEvaluator, eventBus: IEventBus);
+    determineNextNodes(blueprint: WorkflowBlueprint, completedNodeId: string, result: NodeResult<any, any>, context: ContextImplementation<any>, executionId?: string): Promise<{
+        node: NodeDefinition;
+        edge: EdgeDefinition;
+    }[]>;
+    applyEdgeTransform(edge: EdgeDefinition, sourceResult: NodeResult<any, any>, targetNode: NodeDefinition, context: ContextImplementation<any>, allPredecessors?: Map<string, Set<string>>): Promise<void>;
+    resolveNodeInput(nodeId: string, blueprint: WorkflowBlueprint, context: ContextImplementation<any>): Promise<any>;
+}
+
+export { WorkflowLogicHandler };

package/dist/runtime/workflow-logic-handler.js

@@ -0,0 +1,5 @@
+export { WorkflowLogicHandler } from '../chunk-MCGK3FXQ.js';
+import '../chunk-R3HQXIEL.js';
+import '../chunk-BCRWXTWX.js';
+//# sourceMappingURL=workflow-logic-handler.js.map
+//# sourceMappingURL=workflow-logic-handler.js.map

package/dist/runtime/workflow-logic-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"workflow-logic-handler.js"}

package/dist/sanitizer.d.ts

@@ -1,4 +1,6 @@
-import { W as WorkflowBlueprint } from './types-CsTeXTiA.js';
+import { g as WorkflowBlueprint } from './types-ezHUBdpL.js';
+import './errors.js';
+import './container.js';
 
 /**
  * Sanitizes a raw workflow blueprint by removing extra properties

package/dist/serializer.d.ts

@@ -1,4 +1,6 @@
-import { n as ISerializer } from './types-CsTeXTiA.js';
+import { A as ISerializer } from './types-ezHUBdpL.js';
+import './errors.js';
+import './container.js';
 
 /**
  * A default serializer using standard JSON.

package/dist/testing/event-logger.d.ts

@@ -0,0 +1,63 @@
+import { z as IEventBus, y as FlowcraftEvent } from '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';
+
+/**
+ * A test utility that implements IEventBus to capture all workflow events
+ * in memory, acting as a "flight recorder" for behavioral testing.
+ *
+ * @example
+ * // In your test file (e.g., resiliency.test.ts)
+ * it('should retry a node on failure', async () => {
+ *   const eventLogger = new InMemoryEventLogger();
+ *   const runtime = new FlowRuntime({ eventBus: eventLogger });
+ *
+ *   const flow = createFlow('retry-flow')
+ *     .node('api-call', vi.fn().mockRejectedValueOnce(new Error('fail')), {
+ *       config: { maxRetries: 2 },
+ *     });
+ *
+ *   await runtime.run(flow.toBlueprint());
+ *
+ *   // Assert against the captured event history to prove behavior.
+ *   const retryEvents = eventLogger.filter('node:retry');
+ *   expect(retryEvents).toHaveLength(1); // The first attempt is not a "retry"
+ * });
+ */
+declare class InMemoryEventLogger implements IEventBus {
+    readonly events: FlowcraftEvent[];
+    /**
+     * Clears all captured events.
+     */
+    clear(): void;
+    /**
+     * The `emit` method required by the IEventBus interface.
+     * It simply pushes the received event into the internal events array.
+     * @param event The FlowcraftEvent to record.
+     */
+    emit(event: FlowcraftEvent): Promise<void>;
+    /**
+     * Finds the first event of a specific type.
+     * @param type The event type to find (e.g., 'node:error').
+     * @returns The first matching event, or undefined if not found.
+     */
+    find<T extends FlowcraftEvent['type']>(type: T): Extract<FlowcraftEvent, {
+        type: T;
+    }> | undefined;
+    /**
+     * Filters events to find all occurrences of a specific type.
+     * @param type The event type to filter by.
+     * @returns An array of matching events.
+     */
+    filter<T extends FlowcraftEvent['type']>(type: T): Extract<FlowcraftEvent, {
+        type: T;
+    }>[];
+    /**
+     * Prints a formatted log of all captured events to the console.
+     * Ideal for debugging failing tests.
+     * @param title A title for the log output.
+     */
+    printLog(title?: string): void;
+}
+
+export { InMemoryEventLogger };

package/dist/testing/event-logger.js

@@ -0,0 +1,3 @@
+export { InMemoryEventLogger } from '../chunk-MUYLRTSR.js';
+//# sourceMappingURL=event-logger.js.map
+//# sourceMappingURL=event-logger.js.map

package/dist/testing/event-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"event-logger.js"}

package/dist/testing/index.d.ts

@@ -0,0 +1,6 @@
+export { InMemoryEventLogger } from './event-logger.js';
+export { runWithTrace } from './run-with-trace.js';
+export { IWorkflowStepper, createStepper } from './stepper.js';
+import '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';

package/dist/testing/index.js

@@ -0,0 +1,31 @@
+export { runWithTrace } from '../chunk-BN4MV36K.js';
+export { createStepper } from '../chunk-XNRIM27H.js';
+import '../chunk-G53CSLBF.js';
+export { InMemoryEventLogger } from '../chunk-MUYLRTSR.js';
+import '../chunk-NVJ3ZO3P.js';
+import '../chunk-NVLZFLYM.js';
+import '../chunk-ZNL7ZXPR.js';
+import '../chunk-HKX7WQLS.js';
+import '../chunk-MCGK3FXQ.js';
+import '../chunk-MKNZBKSR.js';
+import '../chunk-G5BGBPFP.js';
+import '../chunk-CD3Q4N6V.js';
+import '../chunk-DL7KVYZF.js';
+import '../chunk-ONH7PIJZ.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-BC4G7OM6.js';
+import '../chunk-RM677CNU.js';
+import '../chunk-233SESC2.js';
+import '../chunk-33NO4PUJ.js';
+import '../chunk-HAZ26F3P.js';
+import '../chunk-FRKO3WX4.js';
+import '../chunk-CD4FUZOJ.js';
+import '../chunk-4PELJWF7.js';
+import '../chunk-CYHZ2YVH.js';
+import '../chunk-WWGFIYKW.js';
+import '../chunk-R3HQXIEL.js';
+import '../chunk-BCRWXTWX.js';
+import '../chunk-PH2IYZHV.js';
+import '../chunk-LNK7LZER.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/testing/run-with-trace.d.ts

@@ -0,0 +1,38 @@
+import { c as FlowRuntime, g as WorkflowBlueprint, J as WorkflowResult } from '../types-ezHUBdpL.js';
+import '../errors.js';
+import '../container.js';
+
+/**
+ * A test helper that executes a workflow and automatically prints a detailed
+ * execution trace to the console if the workflow fails.
+ *
+ * @example
+ * // In your test file (e.g., my-workflow.test.ts)
+ * it('should process data correctly', async () => {
+ *   const flow = createFlow('my-flow')
+ *     .node('a', async () => ({ output: 1 }))
+ *     .node('b', async ({ input }) => ({ output: input + 1 })) // Bug: returns { output: 3 }
+ *     .edge('a', 'b')
+ *
+ *   const runtime = new FlowRuntime({})
+ *
+ *   // If this test fails, a full, human-readable trace of the execution
+ *   // (inputs, outputs, context changes) is printed to the console.
+ *   const result = await runWithTrace(runtime, flow.toBlueprint())
+ *
+ *   expect(result.context.b).toBe(2)
+ * })
+ *
+ * @param runtime The original FlowRuntime instance (its options will be used).
+ * @param blueprint The WorkflowBlueprint to execute.
+ * @param initialState The initial state for the workflow run.
+ * @param options Additional options for the run.
+ * @returns The WorkflowResult if successful.
+ */
+declare function runWithTrace<TContext extends Record<string, any>>(runtime: FlowRuntime<TContext, any>, blueprint: WorkflowBlueprint, initialState?: Partial<TContext> | string, options?: {
+    functionRegistry?: Map<string, any>;
+    strict?: boolean;
+    signal?: AbortSignal;
+}): Promise<WorkflowResult<Record<string, any>>>;
+
+export { runWithTrace };

package/dist/testing/run-with-trace.js

@@ -0,0 +1,29 @@
+export { runWithTrace } from '../chunk-BN4MV36K.js';
+import '../chunk-MUYLRTSR.js';
+import '../chunk-NVJ3ZO3P.js';
+import '../chunk-NVLZFLYM.js';
+import '../chunk-ZNL7ZXPR.js';
+import '../chunk-HKX7WQLS.js';
+import '../chunk-MCGK3FXQ.js';
+import '../chunk-MKNZBKSR.js';
+import '../chunk-G5BGBPFP.js';
+import '../chunk-CD3Q4N6V.js';
+import '../chunk-DL7KVYZF.js';
+import '../chunk-ONH7PIJZ.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-BC4G7OM6.js';
+import '../chunk-RM677CNU.js';
+import '../chunk-233SESC2.js';
+import '../chunk-33NO4PUJ.js';
+import '../chunk-HAZ26F3P.js';
+import '../chunk-FRKO3WX4.js';
+import '../chunk-CD4FUZOJ.js';
+import '../chunk-4PELJWF7.js';
+import '../chunk-CYHZ2YVH.js';
+import '../chunk-WWGFIYKW.js';
+import '../chunk-R3HQXIEL.js';
+import '../chunk-BCRWXTWX.js';
+import '../chunk-PH2IYZHV.js';
+import '../chunk-LNK7LZER.js';
+//# sourceMappingURL=run-with-trace.js.map
+//# sourceMappingURL=run-with-trace.js.map

package/dist/testing/run-with-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"run-with-trace.js"}