flowcraft 2.0.0 → 2.1.0

package/dist/linter.js

@@ -1,4 +1,4 @@
-export { lintBlueprint } from './chunk-RAZXOMZC.js';
-import './chunk-M23P46ZL.js';
+export { lintBlueprint } from './chunk-UETC63DP.js';
+import './chunk-HN72TZY5.js';
 //# sourceMappingURL=linter.js.map
 //# sourceMappingURL=linter.js.map

package/dist/logger.d.ts

@@ -1,4 +1,4 @@
-import { l as ILogger } from './types-CZN_FcB6.js';
+import { l as ILogger } from './types-lG3xCzp_.js';
 
 /** A logger implementation that outputs to the console. */
 declare class ConsoleLogger implements ILogger {
@@ -9,10 +9,10 @@ declare class ConsoleLogger implements ILogger {
 }
 /** A logger implementation that does nothing (no-op). */
 declare class NullLogger implements ILogger {
-    debug(): void;
-    info(): void;
-    warn(): void;
-    error(): void;
+    debug(_message: string, _meta?: Record<string, any>): void;
+    info(_message: string, _meta?: Record<string, any>): void;
+    warn(_message: string, _meta?: Record<string, any>): void;
+    error(_message: string, _meta?: Record<string, any>): void;
 }
 
 export { ConsoleLogger, NullLogger };

package/dist/logger.js

@@ -1,3 +1,3 @@
-export { ConsoleLogger, NullLogger } from './chunk-VFC342WL.js';
+export { ConsoleLogger, NullLogger } from './chunk-4PELJWF7.js';
 //# sourceMappingURL=logger.js.map
 //# sourceMappingURL=logger.js.map

package/dist/node.d.ts

@@ -1 +1 @@
-export { B as BaseNode, i as isNodeClass } from './types-CZN_FcB6.js';
+export { B as BaseNode, i as isNodeClass } from './types-lG3xCzp_.js';

package/dist/node.js

@@ -1,3 +1,3 @@
-export { BaseNode, isNodeClass } from './chunk-DSZSR7UE.js';
+export { BaseNode, isNodeClass } from './chunk-5QMPFUKA.js';
 //# sourceMappingURL=node.js.map
 //# sourceMappingURL=node.js.map

package/dist/runtime/adapter.d.ts

@@ -1,7 +1,7 @@
-import { j as RuntimeOptions, n as ISerializer, h as IAsyncContext, p as WorkflowResult } from '../types-CZN_FcB6.js';
+import { j as RuntimeOptions, n as ISerializer, h as IAsyncContext, p as WorkflowResult, W as WorkflowBlueprint } from '../types-lG3xCzp_.js';
 import { FlowRuntime } from './runtime.js';
-import './types.js';
 import './state.js';
+import './types.js';
 
 /**
  * Defines the contract for an atomic, distributed key-value store required by
@@ -65,14 +65,30 @@ declare abstract class BaseDistributedAdapter {
         payload?: WorkflowResult;
         reason?: string;
     }): Promise<void>;
+    /**
+     * Hook called at the start of job processing. Subclasses can override this
+     * to perform additional setup (e.g., timestamp tracking for reconciliation).
+     */
+    protected onJobStart(_runId: string, _blueprintId: string, _nodeId: string): Promise<void>;
     /**
      * The main handler for processing a single job from the queue.
      */
-    private handleJob;
+    protected handleJob(job: JobPayload): Promise<void>;
     /**
      * Encapsulates the fan-in join logic using the coordination store.
      */
-    private isReadyForFanIn;
+    protected isReadyForFanIn(runId: string, blueprint: WorkflowBlueprint, targetNodeId: string): Promise<boolean>;
+    /**
+     * Reconciles the state of a workflow run. It inspects the persisted
+     * context to find completed nodes, determines the next set of executable
+     * nodes (the frontier), and enqueues jobs for them if they aren't
+     * already running. This is the core of the resume functionality.
+     *
+     * @param runId The unique ID of the workflow execution to reconcile.
+     * @returns The set of node IDs that were enqueued for execution.
+     */
+    reconcile(runId: string): Promise<Set<string>>;
+    private calculateResumedFrontier;
 }
 
 export { type AdapterOptions, BaseDistributedAdapter, type ICoordinationStore, type JobPayload };

package/dist/runtime/adapter.js

@@ -1,15 +1,15 @@
-export { BaseDistributedAdapter } from '../chunk-NPAJNLXQ.js';
-import '../chunk-RYTIQZIB.js';
-import '../chunk-UYPIWXZG.js';
-import '../chunk-RW4FH7IL.js';
-import '../chunk-J3RNCPED.js';
-import '../chunk-REH55ZXV.js';
-import '../chunk-734J4PTM.js';
-import '../chunk-MICPMOTW.js';
-import '../chunk-WXT3YEWU.js';
-import '../chunk-GTZC6PQI.js';
-import '../chunk-DSZSR7UE.js';
-import '../chunk-M23P46ZL.js';
-import '../chunk-VFC342WL.js';
+export { BaseDistributedAdapter } from '../chunk-5EHIPX23.js';
+import '../chunk-CO5BTPKI.js';
+import '../chunk-CSZ6EOWG.js';
+import '../chunk-UMXW3TCY.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-CYHZ2YVH.js';
+import '../chunk-QRMUKDSP.js';
+import '../chunk-KWQHFT7E.js';
+import '../chunk-5ZXV3R5D.js';
+import '../chunk-PH2IYZHV.js';
+import '../chunk-5QMPFUKA.js';
+import '../chunk-HN72TZY5.js';
+import '../chunk-4PELJWF7.js';
 //# sourceMappingURL=adapter.js.map
 //# sourceMappingURL=adapter.js.map

package/dist/runtime/executors.d.ts

@@ -1,26 +1,26 @@
-import { N as NodeDefinition, c as NodeContext, b as NodeResult, d as NodeFunction, m as IEventBus, B as BaseNode, C as ContextImplementation } from '../types-CZN_FcB6.js';
+import { N as NodeDefinition, c as NodeContext, b as NodeResult, d as NodeFunction, m as IEventBus, e as NodeClass, C as ContextImplementation } from '../types-lG3xCzp_.js';
 
 interface ExecutionStrategy {
-    execute: (nodeDef: NodeDefinition, context: NodeContext<any, any>, executionId?: string, signal?: AbortSignal) => Promise<NodeResult>;
+    execute: (nodeDef: NodeDefinition, context: NodeContext<any, any, any>, executionId?: string, signal?: AbortSignal) => Promise<NodeResult<any, any>>;
 }
 declare class FunctionNodeExecutor implements ExecutionStrategy {
     private implementation;
     private maxRetries;
     private eventBus;
     constructor(implementation: NodeFunction, maxRetries: number, eventBus: IEventBus);
-    execute(nodeDef: NodeDefinition, context: NodeContext<any, any>, executionId?: string, signal?: AbortSignal): Promise<NodeResult>;
+    execute(nodeDef: NodeDefinition, context: NodeContext<any, any, any>, executionId?: string, signal?: AbortSignal): Promise<NodeResult<any, any>>;
 }
 declare class ClassNodeExecutor implements ExecutionStrategy {
     private implementation;
     private maxRetries;
     private eventBus;
-    constructor(implementation: typeof BaseNode, maxRetries: number, eventBus: IEventBus);
-    execute(nodeDef: NodeDefinition, context: NodeContext<any, any>, executionId?: string, signal?: AbortSignal): Promise<NodeResult>;
+    constructor(implementation: NodeClass, maxRetries: number, eventBus: IEventBus);
+    execute(nodeDef: NodeDefinition, context: NodeContext<any, any, any>, executionId?: string, signal?: AbortSignal): Promise<NodeResult<any, any>>;
 }
 declare class BuiltInNodeExecutor implements ExecutionStrategy {
     private executeBuiltIn;
-    constructor(executeBuiltIn: (nodeDef: NodeDefinition, context: ContextImplementation<any>) => Promise<NodeResult>);
-    execute(nodeDef: NodeDefinition, context: NodeContext<any, any>): Promise<NodeResult>;
+    constructor(executeBuiltIn: (nodeDef: NodeDefinition, context: ContextImplementation<any>) => Promise<NodeResult<any, any>>);
+    execute(nodeDef: NodeDefinition, context: NodeContext<Record<string, unknown>, Record<string, unknown>, any>): Promise<NodeResult<any, any>>;
 }
 
 export { BuiltInNodeExecutor, ClassNodeExecutor, type ExecutionStrategy, FunctionNodeExecutor };

package/dist/runtime/executors.js

@@ -1,4 +1,4 @@
-export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from '../chunk-734J4PTM.js';
-import '../chunk-WXT3YEWU.js';
+export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from '../chunk-QRMUKDSP.js';
+import '../chunk-5ZXV3R5D.js';
 //# sourceMappingURL=executors.js.map
 //# sourceMappingURL=executors.js.map

package/dist/runtime/index.d.ts

@@ -3,5 +3,5 @@ export { BuiltInNodeExecutor, ClassNodeExecutor, ExecutionStrategy, FunctionNode
 export { FlowRuntime } from './runtime.js';
 export { WorkflowState } from './state.js';
 export { GraphTraverser } from './traverser.js';
-import '../types-CZN_FcB6.js';
+import '../types-lG3xCzp_.js';
 import './types.js';

package/dist/runtime/index.js

@@ -1,16 +1,16 @@
 import '../chunk-HMR2GEGE.js';
-export { BaseDistributedAdapter } from '../chunk-NPAJNLXQ.js';
-export { FlowRuntime } from '../chunk-RYTIQZIB.js';
-export { WorkflowState } from '../chunk-UYPIWXZG.js';
-export { GraphTraverser } from '../chunk-RW4FH7IL.js';
-import '../chunk-J3RNCPED.js';
-import '../chunk-REH55ZXV.js';
-export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from '../chunk-734J4PTM.js';
-import '../chunk-MICPMOTW.js';
-import '../chunk-WXT3YEWU.js';
-import '../chunk-GTZC6PQI.js';
-import '../chunk-DSZSR7UE.js';
-import '../chunk-M23P46ZL.js';
-import '../chunk-VFC342WL.js';
+export { BaseDistributedAdapter } from '../chunk-5EHIPX23.js';
+export { FlowRuntime } from '../chunk-CO5BTPKI.js';
+export { WorkflowState } from '../chunk-CSZ6EOWG.js';
+export { GraphTraverser } from '../chunk-UMXW3TCY.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-CYHZ2YVH.js';
+export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from '../chunk-QRMUKDSP.js';
+import '../chunk-KWQHFT7E.js';
+import '../chunk-5ZXV3R5D.js';
+import '../chunk-PH2IYZHV.js';
+import '../chunk-5QMPFUKA.js';
+import '../chunk-HN72TZY5.js';
+import '../chunk-4PELJWF7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/runtime/runtime.d.ts

@@ -1,6 +1,6 @@
-import { j as RuntimeOptions, W as WorkflowBlueprint, p as WorkflowResult, b as NodeResult, C as ContextImplementation, N as NodeDefinition, E as EdgeDefinition } from '../types-CZN_FcB6.js';
-import { IRuntime } from './types.js';
+import { j as RuntimeOptions, W as WorkflowBlueprint, p as WorkflowResult, b as NodeResult, C as ContextImplementation, N as NodeDefinition, E as EdgeDefinition } from '../types-lG3xCzp_.js';
 import { WorkflowState } from './state.js';
+import { IRuntime } from './types.js';
 
 declare class FlowRuntime<TContext extends Record<string, any>, TDependencies extends Record<string, any>> implements IRuntime<TContext, TDependencies> {
     private registry;
@@ -17,17 +17,18 @@ declare class FlowRuntime<TContext extends Record<string, any>, TDependencies ex
         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>;
+    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, context: ContextImplementation<TContext>): Promise<{
+    determineNextNodes(blueprint: WorkflowBlueprint, nodeId: string, result: NodeResult<any, any>, context: ContextImplementation<TContext>): Promise<{
         node: NodeDefinition;
         edge: EdgeDefinition;
     }[]>;
-    applyEdgeTransform(edge: EdgeDefinition, sourceResult: NodeResult, targetNode: NodeDefinition, context: ContextImplementation<TContext>, allPredecessors?: Map<string, Set<string>>): Promise<void>;
+    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<TContext>): Promise<NodeResult>;
+    protected _executeBuiltInNode(nodeDef: NodeDefinition, contextImpl: ContextImplementation<TContext>): Promise<NodeResult<any, any>>;
 }
 
 export { FlowRuntime };

package/dist/runtime/runtime.js

@@ -1,14 +1,14 @@
-export { FlowRuntime } from '../chunk-RYTIQZIB.js';
-import '../chunk-UYPIWXZG.js';
-import '../chunk-RW4FH7IL.js';
-import '../chunk-J3RNCPED.js';
-import '../chunk-REH55ZXV.js';
-import '../chunk-734J4PTM.js';
-import '../chunk-MICPMOTW.js';
-import '../chunk-WXT3YEWU.js';
-import '../chunk-GTZC6PQI.js';
-import '../chunk-DSZSR7UE.js';
-import '../chunk-M23P46ZL.js';
-import '../chunk-VFC342WL.js';
+export { FlowRuntime } from '../chunk-CO5BTPKI.js';
+import '../chunk-CSZ6EOWG.js';
+import '../chunk-UMXW3TCY.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-CYHZ2YVH.js';
+import '../chunk-QRMUKDSP.js';
+import '../chunk-KWQHFT7E.js';
+import '../chunk-5ZXV3R5D.js';
+import '../chunk-PH2IYZHV.js';
+import '../chunk-5QMPFUKA.js';
+import '../chunk-HN72TZY5.js';
+import '../chunk-4PELJWF7.js';
 //# sourceMappingURL=runtime.js.map
 //# sourceMappingURL=runtime.js.map

package/dist/runtime/state.d.ts

@@ -1,4 +1,4 @@
-import { C as ContextImplementation, o as WorkflowError, p as WorkflowResult, n as ISerializer } from '../types-CZN_FcB6.js';
+import { C as ContextImplementation, o as WorkflowError, p as WorkflowResult, n as ISerializer } from '../types-lG3xCzp_.js';
 
 declare class WorkflowState<TContext extends Record<string, any>> {
     private _completedNodes;
@@ -14,7 +14,7 @@ declare class WorkflowState<TContext extends Record<string, any>> {
     getCompletedNodes(): Set<string>;
     getErrors(): WorkflowError[];
     getAnyFallbackExecuted(): boolean;
-    getStatus(allNodeIds: Set<string>, fallbackNodeIds: Set<string>): WorkflowResult['status'];
+    getStatus(allNodeIds: Set<string>, _fallbackNodeIds: Set<string>): WorkflowResult['status'];
     toResult(serializer: ISerializer): WorkflowResult<TContext>;
 }
 

package/dist/runtime/state.js

@@ -1,4 +1,4 @@
-export { WorkflowState } from '../chunk-UYPIWXZG.js';
-import '../chunk-MICPMOTW.js';
+export { WorkflowState } from '../chunk-CSZ6EOWG.js';
+import '../chunk-KWQHFT7E.js';
 //# sourceMappingURL=state.js.map
 //# sourceMappingURL=state.js.map

package/dist/runtime/traverser.d.ts

@@ -1,20 +1,21 @@
-import { W as WorkflowBlueprint } from '../types-CZN_FcB6.js';
+import { W as WorkflowBlueprint } from '../types-lG3xCzp_.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 blueprint;
     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);
+    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;
     traverse(): Promise<void>;
+    private executeWithConcurrency;
     private handleDynamicNodes;
     getAllNodeIds(): Set<string>;
     getFallbackNodeIds(): Set<string>;

package/dist/runtime/traverser.js

@@ -1,5 +1,5 @@
-export { GraphTraverser } from '../chunk-RW4FH7IL.js';
-import '../chunk-WXT3YEWU.js';
-import '../chunk-M23P46ZL.js';
+export { GraphTraverser } from '../chunk-UMXW3TCY.js';
+import '../chunk-5ZXV3R5D.js';
+import '../chunk-HN72TZY5.js';
 //# sourceMappingURL=traverser.js.map
 //# sourceMappingURL=traverser.js.map

package/dist/runtime/types.d.ts

@@ -1,4 +1,4 @@
-import { R as RuntimeDependencies, j as RuntimeOptions, W as WorkflowBlueprint, b as NodeResult, C as ContextImplementation, N as NodeDefinition, E as EdgeDefinition } from '../types-CZN_FcB6.js';
+import { R as RuntimeDependencies, j as RuntimeOptions, W as WorkflowBlueprint, b as NodeResult, C as ContextImplementation, N as NodeDefinition, E as EdgeDefinition } from '../types-lG3xCzp_.js';
 import { WorkflowState } from './state.js';
 
 /** Interface for the core runtime operations used by the traverser. */

package/dist/sanitizer.d.ts

@@ -1,4 +1,4 @@
-import { W as WorkflowBlueprint } from './types-CZN_FcB6.js';
+import { W as WorkflowBlueprint } from './types-lG3xCzp_.js';
 
 /**
  * Sanitizes a raw workflow blueprint by removing extra properties

package/dist/sanitizer.js

@@ -1,3 +1,3 @@
-export { sanitizeBlueprint } from './chunk-J3RNCPED.js';
+export { sanitizeBlueprint } from './chunk-DSYAC4WB.js';
 //# sourceMappingURL=sanitizer.js.map
 //# sourceMappingURL=sanitizer.js.map

package/dist/serializer.d.ts

@@ -1,4 +1,4 @@
-import { n as ISerializer } from './types-CZN_FcB6.js';
+import { n as ISerializer } from './types-lG3xCzp_.js';
 
 /**
  * A default serializer using standard JSON.
@@ -8,6 +8,7 @@ import { n as ISerializer } from './types-CZN_FcB6.js';
  * serializer like `superjson` if working with complex data types.
  */
 declare class JsonSerializer implements ISerializer {
+    private hasWarned;
     serialize(data: Record<string, any>): string;
     deserialize(text: string): Record<string, any>;
 }

package/dist/serializer.js

@@ -1,3 +1,3 @@
-export { JsonSerializer } from './chunk-REH55ZXV.js';
+export { JsonSerializer } from './chunk-CYHZ2YVH.js';
 //# sourceMappingURL=serializer.js.map
 //# sourceMappingURL=serializer.js.map

package/dist/{types-CZN_FcB6.d.ts → types-lG3xCzp_.d.ts}

@@ -1,5 +1,3 @@
-/** eslint-disable unused-imports/no-unused-vars */
-
 /** A type guard to reliably distinguish a NodeClass from a NodeFunction. */
 declare function isNodeClass(impl: any): impl is NodeClass;
 /**
@@ -7,36 +5,36 @@ declare function isNodeClass(impl: any): impl is NodeClass;
  * This class is generic, allowing implementations to specify the exact context
  * and dependency types they expect.
  */
-declare abstract class BaseNode<TContext extends Record<string, any> = Record<string, any>, TDependencies extends RuntimeDependencies = RuntimeDependencies> {
-    protected params: Record<string, any>;
+declare abstract class BaseNode<TContext extends Record<string, any> = Record<string, any>, TDependencies extends RuntimeDependencies = RuntimeDependencies, TInput = any, TOutput = any, TAction extends string = string> {
+    protected params?: Record<string, any> | undefined;
     /**
      * @param params Static parameters for this node instance, passed from the blueprint.
      */
-    constructor(params: Record<string, any>);
+    constructor(params?: Record<string, any> | undefined);
     /**
      * Phase 1: Gathers and prepares data for execution. This phase is NOT retried on failure.
      * @param context The node's execution context.
      * @returns The data needed for the `exec` phase.
      */
-    prep(context: NodeContext<TContext, TDependencies>): Promise<any>;
+    prep(context: NodeContext<TContext, TDependencies, TInput>): Promise<any>;
     /**
      * Phase 2: Performs the core, isolated logic. This is the ONLY phase that is retried.
      * @param prepResult The data returned from the `prep` phase.
      * @param context The node's execution context.
      */
-    abstract exec(prepResult: any, context: NodeContext<TContext, TDependencies>): Promise<Omit<NodeResult, 'error'>>;
+    abstract exec(prepResult: any, context: NodeContext<TContext, TDependencies, TInput>): Promise<Omit<NodeResult<TOutput, TAction>, 'error'>>;
     /**
      * Phase 3: Processes the result and saves state. This phase is NOT retried.
      * @param execResult The successful result from the `exec` or `fallback` phase.
      * @param _context The node's execution context.
      */
-    post(execResult: Omit<NodeResult, 'error'>, _context: NodeContext<TContext, TDependencies>): Promise<NodeResult>;
+    post(execResult: Omit<NodeResult<TOutput, TAction>, 'error'>, _context: NodeContext<TContext, TDependencies, TInput>): Promise<NodeResult<TOutput, TAction>>;
     /**
      * An optional safety net that runs if all `exec` retries fail.
      * @param error The final error from the last `exec` attempt.
      * @param _context The node's execution context.
      */
-    fallback(error: Error, _context: NodeContext<TContext, TDependencies>): Promise<Omit<NodeResult, 'error'>>;
+    fallback(error: Error, _context: NodeContext<TContext, TDependencies, TInput>): Promise<Omit<NodeResult<TOutput, TAction>, 'error'>>;
 }
 
 /** The central, serializable representation of a workflow. */
@@ -80,9 +78,9 @@ interface NodeConfig {
     joinStrategy?: 'all' | 'any';
 }
 /** The required return type for any node implementation. */
-interface NodeResult<TOutput = any> {
+interface NodeResult<TOutput = any, TAction extends string = string> {
     output?: TOutput;
-    action?: string;
+    action?: TAction;
     error?: {
         message: string;
         [key: string]: any;
@@ -93,11 +91,11 @@ interface NodeResult<TOutput = any> {
     _fallbackExecuted?: boolean;
 }
 /** The context object passed to every node's execution logic. */
-interface NodeContext<TContext extends Record<string, any> = Record<string, any>, TDependencies extends RuntimeDependencies = RuntimeDependencies> {
+interface NodeContext<TContext extends Record<string, any> = Record<string, any>, TDependencies extends RuntimeDependencies = RuntimeDependencies, TInput = any> {
     /** The async-only interface for interacting with the workflow's state. */
     context: IAsyncContext<TContext>;
     /** The primary input data for this node, typically from its predecessor. */
-    input?: any;
+    input?: TInput;
     /** Static parameters defined in the blueprint. */
     params: Record<string, any>;
     /** Shared, runtime-level dependencies (e.g., database clients, loggers). */
@@ -106,9 +104,9 @@ interface NodeContext<TContext extends Record<string, any> = Record<string, any>
     signal?: AbortSignal;
 }
 /** A simple function-based node implementation. */
-type NodeFunction<TContext extends Record<string, any> = Record<string, any>, TDependencies extends RuntimeDependencies = RuntimeDependencies> = (context: NodeContext<TContext, TDependencies>) => Promise<NodeResult>;
+type NodeFunction<TContext extends Record<string, any> = Record<string, any>, TDependencies extends RuntimeDependencies = RuntimeDependencies, TInput = any, TOutput = any, TAction extends string = string> = (context: NodeContext<TContext, TDependencies, TInput>) => Promise<NodeResult<TOutput, TAction>>;
 /** Represents a constructor for any concrete class that extends the abstract BaseNode. */
-type NodeClass = new (params?: any) => BaseNode<any, any>;
+type NodeClass<TContext extends Record<string, any> = Record<string, any>, TDependencies extends RuntimeDependencies = RuntimeDependencies, TInput = any, TOutput = any, TAction extends string = string> = new (params?: Record<string, any>) => BaseNode<TContext, TDependencies, TInput, TOutput, TAction>;
 /** A union of all possible node implementation types. */
 type NodeImplementation = NodeFunction | NodeClass;
 /** A registry mapping node types to their implementations. */
@@ -120,8 +118,8 @@ interface ISyncContext<TContext extends Record<string, any> = Record<string, any
     readonly type: 'sync';
     get: <K extends keyof TContext>(key: K) => TContext[K] | undefined;
     set: <K extends keyof TContext>(key: K, value: TContext[K]) => void;
-    has: (key: keyof TContext) => boolean;
-    delete: (key: keyof TContext) => boolean;
+    has: <K extends keyof TContext>(key: K) => boolean;
+    delete: <K extends keyof TContext>(key: K) => boolean;
     toJSON: () => Record<string, any>;
 }
 /** The asynchronous context interface for remote or distributed state. */
@@ -129,8 +127,8 @@ interface IAsyncContext<TContext extends Record<string, any> = Record<string, an
     readonly type: 'async';
     get: <K extends keyof TContext>(key: K) => Promise<TContext[K] | undefined>;
     set: <K extends keyof TContext>(key: K, value: TContext[K]) => Promise<void>;
-    has: (key: keyof TContext) => Promise<boolean>;
-    delete: (key: keyof TContext) => Promise<boolean>;
+    has: <K extends keyof TContext>(key: K) => Promise<boolean>;
+    delete: <K extends keyof TContext>(key: K) => Promise<boolean>;
     toJSON: () => Promise<Record<string, any>>;
 }
 /** Generic for any set of dependencies. */
@@ -140,7 +138,7 @@ interface RuntimeDependencies {
 /** Configuration options for the FlowRuntime. */
 interface RuntimeOptions<TDependencies extends RuntimeDependencies = RuntimeDependencies> {
     /** A registry of globally available node implementations. */
-    registry?: Record<string, NodeFunction | NodeClass>;
+    registry?: Record<string, NodeFunction | NodeClass | typeof BaseNode>;
     /** A registry of all available workflow blueprints for subflow execution. */
     blueprints?: Record<string, WorkflowBlueprint>;
     /** Shared dependencies to be injected into every node. */
@@ -149,7 +147,12 @@ interface RuntimeOptions<TDependencies extends RuntimeDependencies = RuntimeDepe
     logger?: ILogger;
     /** A pluggable event bus for observability. */
     eventBus?: IEventBus;
-    /** A pluggable evaluator for edge conditions and transforms. */
+    /**
+     * A pluggable evaluator for edge conditions and transforms.
+     * @default new PropertyEvaluator() - A safe evaluator for simple property access.
+     * For complex logic, provide a custom implementation or use the `UnsafeEvaluator`
+     * (not recommended for production).
+     */
     evaluator?: IEvaluator;
     /** An array of middleware to wrap node execution. */
     middleware?: Middleware[];
@@ -189,9 +192,11 @@ interface WorkflowError {
     nodeId: string;
     message: string;
     originalError?: any;
+    timestamp: string;
+    stack?: string;
 }
 /** The final result of a workflow execution. */
-interface WorkflowResult<TContext = any> {
+interface WorkflowResult<TContext = Record<string, any>> {
     context: TContext;
     serializedContext: string;
     status: 'completed' | 'failed' | 'stalled' | 'cancelled';

package/dist/types.d.ts

@@ -1 +1 @@
-export { C as ContextImplementation, E as EdgeDefinition, h as IAsyncContext, k as IEvaluator, m as IEventBus, l as ILogger, n as ISerializer, I as ISyncContext, M as Middleware, e as NodeClass, a as NodeConfig, c as NodeContext, N as NodeDefinition, d as NodeFunction, f as NodeImplementation, g as NodeRegistry, b as NodeResult, R as RuntimeDependencies, j as RuntimeOptions, W as WorkflowBlueprint, o as WorkflowError, p as WorkflowResult } from './types-CZN_FcB6.js';
+export { C as ContextImplementation, E as EdgeDefinition, h as IAsyncContext, k as IEvaluator, m as IEventBus, l as ILogger, n as ISerializer, I as ISyncContext, M as Middleware, e as NodeClass, a as NodeConfig, c as NodeContext, N as NodeDefinition, d as NodeFunction, f as NodeImplementation, g as NodeRegistry, b as NodeResult, R as RuntimeDependencies, j as RuntimeOptions, W as WorkflowBlueprint, o as WorkflowError, p as WorkflowResult } from './types-lG3xCzp_.js';

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "flowcraft",
 	"type": "module",
-	"version": "2.0.0",
+	"version": "2.1.0",
 	"description": "A lightweight workflow framework",
 	"license": "MIT",
-	"homepage": "https://github.com/gorango/flowcraft",
+	"homepage": "https://flowcraft.js.org",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/gorango/flowcraft.git"

package/dist/chunk-6DNEDIIT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":"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","file":"chunk-6DNEDIIT.js","sourcesContent":["import type { EdgeDefinition, NodeClass, NodeDefinition, NodeFunction, WorkflowBlueprint } from './types'\nimport { isNodeClass } from './node'\n\n/**\n * A fluent API for programmatically constructing a WorkflowBlueprint.\n */\nexport class Flow<\n\tTContext extends Record<string, any> = Record<string, any>,\n\tTDependencies extends Record<string, any> = Record<string, any>,\n> {\n\tprivate blueprint: Partial<WorkflowBlueprint>\n\tprivate functionRegistry: Map<string, NodeFunction | NodeClass>\n\tprivate loopControllerIds: Map<string, string>\n\n\tconstructor(id: string) {\n\t\tthis.blueprint = { id, nodes: [], edges: [] }\n\t\tthis.functionRegistry = new Map()\n\t\tthis.loopControllerIds = new Map()\n\t}\n\n\tnode(\n\t\tid: string,\n\t\timplementation: NodeFunction<TContext, TDependencies> | NodeClass,\n\t\toptions?: Omit<NodeDefinition, 'id' | 'uses'>,\n\t): this {\n\t\tlet usesKey: string\n\n\t\tif (isNodeClass(implementation)) {\n\t\t\tusesKey = (implementation.name && implementation.name !== 'BaseNode')\n\t\t\t\t? implementation.name\n\t\t\t\t: `class_${globalThis.crypto.randomUUID()}`\n\t\t\tthis.functionRegistry.set(usesKey, implementation)\n\t\t}\n\t\telse {\n\t\t\tusesKey = `fn_${globalThis.crypto.randomUUID()}`\n\t\t\tthis.functionRegistry.set(usesKey, implementation as NodeFunction)\n\t\t}\n\n\t\tconst nodeDef: NodeDefinition = { id, uses: usesKey, ...options }\n\t\tthis.blueprint.nodes!.push(nodeDef)\n\t\treturn this\n\t}\n\n\tedge(source: string, target: string, options?: Omit<EdgeDefinition, 'source' | 'target'>): this {\n\t\tconst edgeDef: EdgeDefinition = { source, target, ...options }\n\t\tthis.blueprint.edges!.push(edgeDef)\n\t\treturn this\n\t}\n\n\t/**\n\t * Creates a batch processing pattern.\n\t * It takes an input array, runs a worker node on each item in parallel, and gathers the results.\n\t * @param id The base ID for this batch operation.\n\t * @param worker The node implementation to run on each item.\n\t * @param options Configuration for the batch operation.\n\t * @param options.inputKey The key in the context that holds the input array for the batch.\n\t * @param options.outputKey The key in the context where the array of results will be stored.\n\t * @returns The Flow instance for chaining.\n\t */\n\tbatch(id: string, worker: NodeFunction<TContext, TDependencies> | NodeClass, options: {\n\t\t/** The key in the context that holds the input array for the batch. */\n\t\tinputKey: string\n\t\t/** The key in the context where the array of results will be stored. */\n\t\toutputKey: string\n\t}): this {\n\t\tconst { inputKey, outputKey } = options\n\t\tconst scatterId = `${id}_scatter`\n\t\tconst gatherId = `${id}_gather`\n\n\t\t// Register the user's worker implementation under a unique key.\n\t\tlet workerUsesKey: string\n\t\tif (isNodeClass(worker)) {\n\t\t\tworkerUsesKey = (worker.name && worker.name !== 'BaseNode') ? worker.name : `class_batch_worker_${globalThis.crypto.randomUUID()}`\n\t\t\tthis.functionRegistry.set(workerUsesKey, worker)\n\t\t}\n\t\telse {\n\t\t\tworkerUsesKey = `fn_batch_worker_${globalThis.crypto.randomUUID()}`\n\t\t\tthis.functionRegistry.set(workerUsesKey, worker as NodeFunction)\n\t\t}\n\n\t\t// Scatter Node: A built-in node that takes an array and dynamically schedules worker nodes.\n\t\tthis.blueprint.nodes!.push({\n\t\t\tid: scatterId,\n\t\t\tuses: 'batch-scatter', // This is a special, built-in node type\n\t\t\tinputs: inputKey,\n\t\t\tparams: { workerUsesKey, outputKey, gatherNodeId: gatherId },\n\t\t})\n\n\t\t// Gather Node: A built-in node that waits for all workers to finish and collects the results.\n\t\tthis.blueprint.nodes!.push({\n\t\t\tid: gatherId,\n\t\t\tuses: 'batch-gather', // built-in node type\n\t\t\tparams: { outputKey },\n\t\t\tconfig: { joinStrategy: 'all' }, // Important: Must wait for all scattered jobs\n\t\t})\n\n\t\t// Edge to connect the scatter and gather nodes. The orchestrator will manage the dynamic workers.\n\t\tthis.edge(scatterId, gatherId)\n\n\t\treturn this\n\t}\n\n\t/**\n\t * Creates a loop pattern in the workflow graph.\n\t * @param id A unique identifier for the loop construct.\n\t * @param options Defines the start, end, and continuation condition of the loop.\n\t * @param options.startNodeId The ID of the first node inside the loop body.\n\t * @param options.endNodeId The ID of the last node inside the loop body.\n\t * @param options.condition An expression that, if true, causes the loop to run again.\n\t */\n\tloop(id: string, options: {\n\t\t/** The ID of the first node inside the loop body. */\n\t\tstartNodeId: string\n\t\t/** The ID of the last node inside the loop body. */\n\t\tendNodeId: string\n\t\t/** An expression that, if true, causes the loop to run again. */\n\t\tcondition: string\n\t}): this {\n\t\tconst { startNodeId, endNodeId, condition } = options\n\t\tconst controllerId = `${id}-loop`\n\n\t\t// Store the generated ID against the user-provided loop ID\n\t\tthis.loopControllerIds.set(id, controllerId)\n\n\t\t// Add the controller node, which evaluates the loop condition.\n\t\t// Set joinStrategy='any' to allow re-execution on each loop iteration\n\t\tthis.blueprint.nodes!.push({\n\t\t\tid: controllerId,\n\t\t\tuses: 'loop-controller', // Special built-in node type\n\t\t\tparams: { condition },\n\t\t\tconfig: { joinStrategy: 'any' },\n\t\t})\n\n\t\t// Connect the end of the loop body to the controller.\n\t\tthis.edge(endNodeId, controllerId)\n\n\t\t// Connect the controller back to the start of the loop if the condition is met.\n\t\t// Use a transform to pass the end node's value to the start node for the next iteration.\n\t\tthis.edge(controllerId, startNodeId, { action: 'continue', transform: `context.${endNodeId}` })\n\n\t\t// Set the start and end nodes to use 'any' join strategy so they can re-execute\n\t\t// Start node: executes when either its initial predecessor OR the loop controller completes\n\t\t// End node: needs to re-execute on each loop iteration\n\t\tconst startNode = this.blueprint.nodes!.find(n => n.id === startNodeId)\n\t\tif (startNode)\n\t\t\tstartNode.config = { ...startNode.config, joinStrategy: 'any' }\n\n\t\tconst endNode = this.blueprint.nodes!.find(n => n.id === endNodeId)\n\t\tif (endNode)\n\t\t\tendNode.config = { ...endNode.config, joinStrategy: 'any' }\n\n\t\treturn this\n\t}\n\n\tgetLoopControllerId(id: string): string {\n\t\tconst controllerId = this.loopControllerIds.get(id)\n\t\tif (!controllerId) {\n\t\t\tthrow new Error(`Loop with id '${id}' not found. Ensure you have defined it using the .loop() method.`)\n\t\t}\n\t\treturn controllerId\n\t}\n\n\ttoBlueprint(): WorkflowBlueprint {\n\t\tif (!this.blueprint.nodes || this.blueprint.nodes.length === 0) {\n\t\t\tthrow new Error('Cannot build a blueprint with no nodes.')\n\t\t}\n\t\treturn this.blueprint as WorkflowBlueprint\n\t}\n\n\tgetFunctionRegistry() {\n\t\treturn this.functionRegistry\n\t}\n}\n\n/**\n * Helper function to create a new Flow builder instance.\n */\nexport function createFlow<\n\tTContext extends Record<string, any> = Record<string, any>,\n\tTDependencies extends Record<string, any> = Record<string, any>,\n>(id: string): Flow<TContext, TDependencies> {\n\treturn new Flow(id)\n}\n"]}

package/dist/chunk-734J4PTM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/runtime/executors.ts"],"names":[],"mappings":"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","file":"chunk-734J4PTM.js","sourcesContent":["import type { BaseNode } from '../node'\nimport type { ContextImplementation, IEventBus, NodeContext, NodeDefinition, NodeFunction, NodeResult } from '../types'\nimport { CancelledWorkflowError, FatalNodeExecutionError } from '../errors'\n\nexport interface ExecutionStrategy {\n\texecute: (\n\t\tnodeDef: NodeDefinition,\n\t\tcontext: NodeContext<any, any>,\n\t\texecutionId?: string,\n\t\tsignal?: AbortSignal,\n\t) => Promise<NodeResult>\n}\n\nexport class FunctionNodeExecutor implements ExecutionStrategy {\n\tconstructor(\n\t\tprivate implementation: NodeFunction,\n\t\tprivate maxRetries: number,\n\t\tprivate eventBus: IEventBus,\n\t) { }\n\n\tasync execute(\n\t\tnodeDef: NodeDefinition,\n\t\tcontext: NodeContext<any, any>,\n\t\texecutionId?: string,\n\t\tsignal?: AbortSignal,\n\t): Promise<NodeResult> {\n\t\tlet lastError: any\n\t\tfor (let attempt = 1; attempt <= this.maxRetries; attempt++) {\n\t\t\ttry {\n\t\t\t\tsignal?.throwIfAborted()\n\t\t\t\tconst result = await this.implementation(context)\n\t\t\t\tif (attempt > 1) {\n\t\t\t\t\tcontext.dependencies.logger.info(`Node execution succeeded after retry`, { nodeId: nodeDef.id, attempt, executionId })\n\t\t\t\t}\n\t\t\t\treturn result\n\t\t\t}\n\t\t\tcatch (error) {\n\t\t\t\tlastError = error\n\t\t\t\tif (error instanceof DOMException && error.name === 'AbortError') {\n\t\t\t\t\tthrow new CancelledWorkflowError('Workflow cancelled')\n\t\t\t\t}\n\t\t\t\tif (error instanceof FatalNodeExecutionError)\n\t\t\t\t\tbreak\n\t\t\t\tif (attempt < this.maxRetries) {\n\t\t\t\t\tcontext.dependencies.logger.warn(`Node execution failed, retrying`, { nodeId: nodeDef.id, attempt, maxRetries: this.maxRetries, error: error instanceof Error ? error.message : String(error), executionId })\n\t\t\t\t\tawait this.eventBus.emit('node:retry', { blueprintId: context.dependencies.blueprint?.id || '', nodeId: nodeDef.id, attempt, executionId })\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\tcontext.dependencies.logger.error(`Node execution failed after all retries`, { nodeId: nodeDef.id, attempts: this.maxRetries, error: error instanceof Error ? error.message : String(error), executionId })\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tthrow lastError\n\t}\n}\n\nexport class ClassNodeExecutor implements ExecutionStrategy {\n\tconstructor(\n\t\tprivate implementation: typeof BaseNode,\n\t\tprivate maxRetries: number,\n\t\tprivate eventBus: IEventBus,\n\t) { }\n\n\tasync execute(\n\t\tnodeDef: NodeDefinition,\n\t\tcontext: NodeContext<any, any>,\n\t\texecutionId?: string,\n\t\tsignal?: AbortSignal,\n\t): Promise<NodeResult> {\n\t\tconst instance = new (this.implementation as new (params: Record<string, any>) => BaseNode)(nodeDef.params || {})\n\t\ttry {\n\t\t\tsignal?.throwIfAborted()\n\t\t\tconst prepResult = await instance.prep(context)\n\t\t\tlet execResult: Omit<NodeResult, 'error'>\n\t\t\tlet lastError: any\n\t\t\tfor (let attempt = 1; attempt <= this.maxRetries; attempt++) {\n\t\t\t\ttry {\n\t\t\t\t\tsignal?.throwIfAborted()\n\t\t\t\t\texecResult = await instance.exec(prepResult, context)\n\t\t\t\t\tlastError = undefined\n\t\t\t\t\tif (attempt > 1) {\n\t\t\t\t\t\tcontext.dependencies.logger.info(`Node execution succeeded after retry`, { nodeId: nodeDef.id, attempt, executionId })\n\t\t\t\t\t}\n\t\t\t\t\tbreak\n\t\t\t\t}\n\t\t\t\tcatch (error) {\n\t\t\t\t\tlastError = error\n\t\t\t\t\tif (error instanceof DOMException && error.name === 'AbortError') {\n\t\t\t\t\t\tthrow new CancelledWorkflowError('Workflow cancelled')\n\t\t\t\t\t}\n\t\t\t\t\tif (error instanceof FatalNodeExecutionError)\n\t\t\t\t\t\tbreak\n\t\t\t\t\tif (attempt < this.maxRetries) {\n\t\t\t\t\t\tcontext.dependencies.logger.warn(`Node execution failed, retrying`, { nodeId: nodeDef.id, attempt, maxRetries: this.maxRetries, error: error instanceof Error ? error.message : String(error), executionId })\n\t\t\t\t\t\tawait this.eventBus.emit('node:retry', { blueprintId: context.dependencies.blueprint?.id || '', nodeId: nodeDef.id, attempt, executionId })\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tcontext.dependencies.logger.error(`Node execution failed after all retries`, { nodeId: nodeDef.id, attempts: this.maxRetries, error: error instanceof Error ? error.message : String(error), executionId })\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (lastError) {\n\t\t\t\tsignal?.throwIfAborted()\n\t\t\t\texecResult = await instance.fallback(lastError, context)\n\t\t\t}\n\t\t\tsignal?.throwIfAborted()\n\t\t\treturn await instance.post(execResult!, context)\n\t\t}\n\t\tcatch (error) {\n\t\t\tif (error instanceof DOMException && error.name === 'AbortError') {\n\t\t\t\tthrow new CancelledWorkflowError('Workflow cancelled')\n\t\t\t}\n\t\t\tthrow error\n\t\t}\n\t}\n}\n\nexport class BuiltInNodeExecutor implements ExecutionStrategy {\n\tconstructor(\n\t\tprivate executeBuiltIn: (nodeDef: NodeDefinition, context: ContextImplementation<any>) => Promise<NodeResult>,\n\t) { }\n\n\tasync execute(\n\t\tnodeDef: NodeDefinition,\n\t\tcontext: NodeContext<any, any>,\n\t): Promise<NodeResult> {\n\t\treturn this.executeBuiltIn(nodeDef, context.context as ContextImplementation<any>)\n\t}\n}\n"]}

package/dist/chunk-DSZSR7UE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/node.ts"],"names":[],"mappings":";AAKO,SAAS,YAAY,IAAA,EAA8B;AACzD,EAAA,OAAO,OAAO,IAAA,KAAS,UAAA,IAAc,CAAC,CAAC,KAAK,SAAA,EAAW,IAAA;AACxD;AAOO,IAAe,WAAf,MAGL;AAAA;AAAA;AAAA;AAAA,EAID,YAAsB,MAAA,EAA6B;AAA7B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA+B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrD,MAAM,KAAK,OAAA,EAA6D;AACvE,IAAA,OAAO,OAAA,CAAQ,KAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,IAAA,CAAK,UAAA,EAAuC,QAAA,EAAqE;AACtH,IAAA,OAAO,UAAA;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAA,CAAS,KAAA,EAAc,QAAA,EAAoF;AAEhH,IAAA,MAAM,KAAA;AAAA,EACP;AACD","file":"chunk-DSZSR7UE.js","sourcesContent":["/** eslint-disable unused-imports/no-unused-vars */\n\nimport type { NodeClass, NodeContext, NodeResult, RuntimeDependencies } from './types'\n\n/** A type guard to reliably distinguish a NodeClass from a NodeFunction. */\nexport function isNodeClass(impl: any): impl is NodeClass {\n\treturn typeof impl === 'function' && !!impl.prototype?.exec\n}\n\n/**\n * A structured, class-based node for complex logic with a safe, granular lifecycle.\n * This class is generic, allowing implementations to specify the exact context\n * and dependency types they expect.\n */\nexport abstract class BaseNode<\n\tTContext extends Record<string, any> = Record<string, any>,\n\tTDependencies extends RuntimeDependencies = RuntimeDependencies,\n> {\n\t/**\n\t * @param params Static parameters for this node instance, passed from the blueprint.\n\t */\n\tconstructor(protected params: Record<string, any>) { }\n\n\t/**\n\t * Phase 1: Gathers and prepares data for execution. This phase is NOT retried on failure.\n\t * @param context The node's execution context.\n\t * @returns The data needed for the `exec` phase.\n\t */\n\tasync prep(context: NodeContext<TContext, TDependencies>): Promise<any> {\n\t\treturn context.input\n\t}\n\n\t/**\n\t * Phase 2: Performs the core, isolated logic. This is the ONLY phase that is retried.\n\t * @param prepResult The data returned from the `prep` phase.\n\t * @param context The node's execution context.\n\t */\n\tabstract exec(prepResult: any, context: NodeContext<TContext, TDependencies>): Promise<Omit<NodeResult, 'error'>>\n\n\t/**\n\t * Phase 3: Processes the result and saves state. This phase is NOT retried.\n\t * @param execResult The successful result from the `exec` or `fallback` phase.\n\t * @param _context The node's execution context.\n\t */\n\tasync post(execResult: Omit<NodeResult, 'error'>, _context: NodeContext<TContext, TDependencies>): Promise<NodeResult> {\n\t\treturn execResult\n\t}\n\n\t/**\n\t * An optional safety net that runs if all `exec` retries fail.\n\t * @param error The final error from the last `exec` attempt.\n\t * @param _context The node's execution context.\n\t */\n\tasync fallback(error: Error, _context: NodeContext<TContext, TDependencies>): Promise<Omit<NodeResult, 'error'>> {\n\t\t// By default, re-throw the error, failing the node.\n\t\tthrow error\n\t}\n}\n"]}

package/dist/chunk-GTZC6PQI.js

@@ -1,22 +0,0 @@
-// src/evaluator.ts
-var SimpleEvaluator = class {
-  evaluate(expression, context) {
-    try {
-      const validIdentifierRegex = /^[a-z_$][\w$]*$/i;
-      const validKeys = Object.keys(context).filter((key) => validIdentifierRegex.test(key));
-      const validContext = {};
-      for (const key of validKeys) {
-        validContext[key] = context[key];
-      }
-      const sandbox = new Function(...validKeys, `return ${expression}`);
-      return sandbox(...validKeys.map((k) => validContext[k]));
-    } catch (error) {
-      console.error(`Error evaluating expression "${expression}":`, error);
-      return void 0;
-    }
-  }
-};
-
-export { SimpleEvaluator };
-//# sourceMappingURL=chunk-GTZC6PQI.js.map
-//# sourceMappingURL=chunk-GTZC6PQI.js.map