flowcraft 2.0.0 → 2.1.1

package/dist/{chunk-RAZXOMZC.js → chunk-UETC63DP.js}

@@ -1,4 +1,4 @@
-import { analyzeBlueprint } from './chunk-M23P46ZL.js';
+import { analyzeBlueprint } from './chunk-HN72TZY5.js';
 
 // src/linter.ts
 function lintBlueprint(blueprint, registry) {
@@ -37,11 +37,12 @@ function lintBlueprint(blueprint, registry) {
     const visited = /* @__PURE__ */ new Set();
     while (nodesToVisit.length > 0) {
       const currentId = nodesToVisit.pop();
-      if (visited.has(currentId))
-        continue;
+      if (!currentId || visited.has(currentId)) continue;
       visited.add(currentId);
       connectedNodes.add(currentId);
-      blueprint.edges.filter((e) => e.source === currentId).forEach((e) => nodesToVisit.push(e.target));
+      for (const e of blueprint.edges.filter((e2) => e2.source === currentId)) {
+        nodesToVisit.push(e.target);
+      }
     }
     for (const nodeId of nodeIds) {
       if (!connectedNodes.has(nodeId)) {
@@ -60,5 +61,5 @@ function lintBlueprint(blueprint, registry) {
 }
 
 export { lintBlueprint };
-//# sourceMappingURL=chunk-RAZXOMZC.js.map
-//# sourceMappingURL=chunk-RAZXOMZC.js.map
+//# sourceMappingURL=chunk-UETC63DP.js.map
+//# sourceMappingURL=chunk-UETC63DP.js.map

package/dist/chunk-UETC63DP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/linter.ts"],"names":["e"],"mappings":"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","file":"chunk-UETC63DP.js","sourcesContent":["import { analyzeBlueprint } from './analysis'\nimport type { NodeClass, NodeFunction, WorkflowBlueprint } from './types'\n\nexport type LinterIssueCode =\n\t| 'INVALID_EDGE_SOURCE'\n\t| 'INVALID_EDGE_TARGET'\n\t| 'MISSING_NODE_IMPLEMENTATION'\n\t| 'ORPHAN_NODE'\n\nexport interface LinterIssue {\n\tcode: LinterIssueCode\n\tmessage: string\n\tnodeId?: string\n\trelatedId?: string\n}\n\nexport interface LinterResult {\n\tisValid: boolean\n\tissues: LinterIssue[]\n}\n\n/**\n * Statically analyzes a workflow blueprint against a registry of implementations\n * to find common errors before runtime.\n *\n * @param blueprint The WorkflowBlueprint to analyze.\n * @param registry A map of node implementations (functions or classes) to check against.\n * @returns A LinterResult object containing any issues found.\n */\nexport function lintBlueprint(\n\tblueprint: WorkflowBlueprint,\n\tregistry: Map<string, NodeFunction | NodeClass> | Record<string, NodeFunction | NodeClass>,\n): LinterResult {\n\tconst issues: LinterIssue[] = []\n\tconst nodeIds = new Set(blueprint.nodes.map((n) => n.id))\n\tconst registryKeys = registry instanceof Map ? new Set(registry.keys()) : new Set(Object.keys(registry))\n\n\t// check for missing node implementations\n\tfor (const node of blueprint.nodes) {\n\t\tif (!node.uses.startsWith('batch-') && !node.uses.startsWith('loop-') && !registryKeys.has(node.uses)) {\n\t\t\tissues.push({\n\t\t\t\tcode: 'MISSING_NODE_IMPLEMENTATION',\n\t\t\t\tmessage: `Node implementation key '${node.uses}' is not found in the provided registry.`,\n\t\t\t\tnodeId: node.id,\n\t\t\t})\n\t\t}\n\t}\n\n\t// check for graph integrity (edges must point to valid nodes)\n\tfor (const edge of blueprint.edges || []) {\n\t\tif (!nodeIds.has(edge.source)) {\n\t\t\tissues.push({\n\t\t\t\tcode: 'INVALID_EDGE_SOURCE',\n\t\t\t\tmessage: `Edge source '${edge.source}' does not correspond to a valid node ID.`,\n\t\t\t\trelatedId: edge.target,\n\t\t\t})\n\t\t}\n\t\tif (!nodeIds.has(edge.target)) {\n\t\t\tissues.push({\n\t\t\t\tcode: 'INVALID_EDGE_TARGET',\n\t\t\t\tmessage: `Edge target '${edge.target}' does not correspond to a valid node ID.`,\n\t\t\t\trelatedId: edge.source,\n\t\t\t})\n\t\t}\n\t}\n\n\t// check for orphan nodes (not connected to the main graph)\n\tif (blueprint.nodes.length > 1) {\n\t\tconst analysis = analyzeBlueprint(blueprint)\n\t\tconst connectedNodes = new Set<string>()\n\t\tconst nodesToVisit = [...analysis.startNodeIds]\n\t\tconst visited = new Set<string>()\n\n\t\twhile (nodesToVisit.length > 0) {\n\t\t\tconst currentId = nodesToVisit.pop()\n\t\t\tif (!currentId || visited.has(currentId)) continue\n\n\t\t\tvisited.add(currentId)\n\t\t\tconnectedNodes.add(currentId)\n\n\t\t\tfor (const e of blueprint.edges.filter((e) => e.source === currentId)) {\n\t\t\t\tnodesToVisit.push(e.target)\n\t\t\t}\n\t\t}\n\n\t\tfor (const nodeId of nodeIds) {\n\t\t\tif (!connectedNodes.has(nodeId)) {\n\t\t\t\tissues.push({\n\t\t\t\t\tcode: 'ORPHAN_NODE',\n\t\t\t\t\tmessage: `Node '${nodeId}' is not reachable from any start node.`,\n\t\t\t\t\tnodeId,\n\t\t\t\t})\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tisValid: issues.length === 0,\n\t\tissues,\n\t}\n}\n"]}

package/dist/context.d.ts

@@ -1,4 +1,4 @@
-import { I as ISyncContext, h as IAsyncContext } from './types-CZN_FcB6.js';
+import { I as ISyncContext, h as IAsyncContext } from './types-CQCe_nBM.js';
 
 /**
  * A default, high-performance, in-memory implementation of ISyncContext using a Map.
@@ -9,8 +9,8 @@ declare class Context<TContext extends Record<string, any>> implements ISyncCont
     constructor(initialData?: Partial<TContext>);
     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>;
 }
 /**
@@ -23,8 +23,8 @@ declare class AsyncContextView<TContext extends Record<string, any>> implements
     constructor(syncContext: ISyncContext<TContext>);
     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>>;
 }
 

package/dist/context.js

@@ -1,3 +1,3 @@
-export { AsyncContextView, Context } from './chunk-MICPMOTW.js';
+export { AsyncContextView, Context } from './chunk-KWQHFT7E.js';
 //# sourceMappingURL=context.js.map
 //# sourceMappingURL=context.js.map

package/dist/errors.js

@@ -1,3 +1,3 @@
-export { CancelledWorkflowError, FatalNodeExecutionError, NodeExecutionError } from './chunk-WXT3YEWU.js';
+export { CancelledWorkflowError, FatalNodeExecutionError, NodeExecutionError } from './chunk-5ZXV3R5D.js';
 //# sourceMappingURL=errors.js.map
 //# sourceMappingURL=errors.js.map

package/dist/evaluator.d.ts

@@ -1,22 +1,30 @@
-import { k as IEvaluator } from './types-CZN_FcB6.js';
+import { k as IEvaluator } from './types-CQCe_nBM.js';
 
 /**
- * A simple, safe, placeholder expression evaluator.
- * It provides a sandboxed environment for evaluating edge conditions and transforms.
+ * A safe evaluator that only allows simple property access.
+ * It cannot execute arbitrary code and is secure for untrusted inputs.
  *
- * @warning This implementation uses `new Function()` which, while sandboxed from the global
- * scope, can be a security risk if expressions are provided by end-users. It is NOT
- * recommended for production systems. Please replace this with a more robust and secure
- * library like `jsep` by providing your own implementation in the runtime options.
- *
- * This implementation can only access properties on a single context object.
  * Example expressions:
- * - "result.output.status === 'SUCCESS'"
+ * - "result.output.status"
  * - "context.user.isAdmin"
- * - "input.value * 100"
+ * - "input.value"
+ */
+declare class PropertyEvaluator implements IEvaluator {
+    evaluate(expression: string, context: Record<string, any>): any;
+}
+/**
+ * @warning This evaluator uses `new Function()` and can execute arbitrary
+ * JavaScript code. It poses a significant security risk if the expressions
+ * are not from a trusted source (e.g., user input).
+ *
+ * It should only be used in controlled environments where all workflow
+ * definitions are static and authored by trusted developers.
+ *
+ * For safer evaluation, use the default `PropertyEvaluator` or install a
+ * sandboxed library like `jsep` to create a custom, secure evaluator.
  */
-declare class SimpleEvaluator implements IEvaluator {
+declare class UnsafeEvaluator implements IEvaluator {
     evaluate(expression: string, context: Record<string, any>): any;
 }
 
-export { SimpleEvaluator };
+export { PropertyEvaluator, UnsafeEvaluator };

package/dist/evaluator.js

@@ -1,3 +1,3 @@
-export { SimpleEvaluator } from './chunk-GTZC6PQI.js';
+export { PropertyEvaluator, UnsafeEvaluator } from './chunk-PH2IYZHV.js';
 //# sourceMappingURL=evaluator.js.map
 //# sourceMappingURL=evaluator.js.map

package/dist/flow.d.ts

@@ -1,4 +1,4 @@
-import { d as NodeFunction, e as NodeClass, N as NodeDefinition, E as EdgeDefinition, W as WorkflowBlueprint } from './types-CZN_FcB6.js';
+import { d as NodeFunction, e as NodeClass, N as NodeDefinition, E as EdgeDefinition, W as WorkflowBlueprint } from './types-CQCe_nBM.js';
 
 /**
  * A fluent API for programmatically constructing a WorkflowBlueprint.
@@ -7,8 +7,9 @@ declare class Flow<TContext extends Record<string, any> = Record<string, any>, T
     private blueprint;
     private functionRegistry;
     private loopControllerIds;
+    private loopDefinitions;
     constructor(id: string);
-    node(id: string, implementation: NodeFunction<TContext, TDependencies> | NodeClass, options?: Omit<NodeDefinition, 'id' | 'uses'>): this;
+    node<TInput = any, TOutput = any, TAction extends string = string>(id: string, implementation: NodeFunction<TContext, TDependencies, TInput, TOutput, TAction> | NodeClass<TContext, TDependencies, TInput, TOutput, TAction>, options?: Omit<NodeDefinition, 'id' | 'uses'>): this;
     edge(source: string, target: string, options?: Omit<EdgeDefinition, 'source' | 'target'>): this;
     /**
      * Creates a batch processing pattern.
@@ -20,11 +21,11 @@ declare class Flow<TContext extends Record<string, any> = Record<string, any>, T
      * @param options.outputKey The key in the context where the array of results will be stored.
      * @returns The Flow instance for chaining.
      */
-    batch(id: string, worker: NodeFunction<TContext, TDependencies> | NodeClass, options: {
+    batch<TInput = any, TOutput = any, TAction extends string = string>(id: string, worker: NodeFunction<TContext, TDependencies, TInput, TOutput, TAction> | NodeClass<TContext, TDependencies, TInput, TOutput, TAction>, options: {
         /** The key in the context that holds the input array for the batch. */
-        inputKey: string;
+        inputKey: keyof TContext;
         /** The key in the context where the array of results will be stored. */
-        outputKey: string;
+        outputKey: keyof TContext;
     }): this;
     /**
      * Creates a loop pattern in the workflow graph.

package/dist/flow.js

@@ -1,4 +1,4 @@
-export { Flow, createFlow } from './chunk-6DNEDIIT.js';
-import './chunk-DSZSR7UE.js';
+export { Flow, createFlow } from './chunk-4A627Q6L.js';
+import './chunk-U5V5O5MN.js';
 //# sourceMappingURL=flow.js.map
 //# sourceMappingURL=flow.js.map

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export { BlueprintAnalysis, Cycles, analyzeBlueprint, checkForCycles, generateMermaid } from './analysis.js';
 export { AsyncContextView, Context } from './context.js';
 export { CancelledWorkflowError, FatalNodeExecutionError, NodeExecutionError } from './errors.js';
+export { PropertyEvaluator, UnsafeEvaluator } from './evaluator.js';
 export { Flow, createFlow } from './flow.js';
 export { LinterIssue, LinterIssueCode, LinterResult, lintBlueprint } from './linter.js';
 export { ConsoleLogger, NullLogger } from './logger.js';
-export { B as BaseNode, 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, i as isNodeClass } from './types-CZN_FcB6.js';
+export { B as BaseNode, 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, i as isNodeClass } from './types-CQCe_nBM.js';
 export { AdapterOptions, BaseDistributedAdapter, ICoordinationStore, JobPayload } from './runtime/adapter.js';
 export { BuiltInNodeExecutor, ClassNodeExecutor, ExecutionStrategy, FunctionNodeExecutor } from './runtime/executors.js';
 export { FlowRuntime } from './runtime/runtime.js';

package/dist/index.js

@@ -1,19 +1,19 @@
 import './chunk-55J6XMHW.js';
 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';
-export { sanitizeBlueprint } from './chunk-J3RNCPED.js';
-import './chunk-REH55ZXV.js';
-export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from './chunk-734J4PTM.js';
-export { AsyncContextView, Context } from './chunk-MICPMOTW.js';
-export { CancelledWorkflowError, FatalNodeExecutionError, NodeExecutionError } from './chunk-WXT3YEWU.js';
-import './chunk-GTZC6PQI.js';
-export { Flow, createFlow } from './chunk-6DNEDIIT.js';
-export { BaseNode, isNodeClass } from './chunk-DSZSR7UE.js';
-export { lintBlueprint } from './chunk-RAZXOMZC.js';
-export { analyzeBlueprint, checkForCycles, generateMermaid } from './chunk-M23P46ZL.js';
-export { ConsoleLogger, NullLogger } from './chunk-VFC342WL.js';
+export { BaseDistributedAdapter } from './chunk-O3XD45IL.js';
+export { FlowRuntime } from './chunk-3XVVR2SR.js';
+export { WorkflowState } from './chunk-CSZ6EOWG.js';
+export { GraphTraverser } from './chunk-NBIRTKZ7.js';
+export { sanitizeBlueprint } from './chunk-DSYAC4WB.js';
+import './chunk-CYHZ2YVH.js';
+export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from './chunk-M2FRTT2K.js';
+export { AsyncContextView, Context } from './chunk-KWQHFT7E.js';
+export { CancelledWorkflowError, FatalNodeExecutionError, NodeExecutionError } from './chunk-5ZXV3R5D.js';
+export { PropertyEvaluator, UnsafeEvaluator } from './chunk-PH2IYZHV.js';
+export { Flow, createFlow } from './chunk-4A627Q6L.js';
+export { BaseNode, isNodeClass } from './chunk-U5V5O5MN.js';
+export { lintBlueprint } from './chunk-UETC63DP.js';
+export { analyzeBlueprint, checkForCycles, generateMermaid } from './chunk-HN72TZY5.js';
+export { ConsoleLogger, NullLogger } from './chunk-4PELJWF7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/linter.d.ts

@@ -1,4 +1,4 @@
-import { W as WorkflowBlueprint, d as NodeFunction, e as NodeClass } from './types-CZN_FcB6.js';
+import { W as WorkflowBlueprint, d as NodeFunction, e as NodeClass } from './types-CQCe_nBM.js';
 
 type LinterIssueCode = 'INVALID_EDGE_SOURCE' | 'INVALID_EDGE_TARGET' | 'MISSING_NODE_IMPLEMENTATION' | 'ORPHAN_NODE';
 interface LinterIssue {

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-CQCe_nBM.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-CQCe_nBM.js';

package/dist/node.js

@@ -1,3 +1,3 @@
-export { BaseNode, isNodeClass } from './chunk-DSZSR7UE.js';
+export { BaseNode, isNodeClass } from './chunk-U5V5O5MN.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-CQCe_nBM.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,34 @@ 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;
+    /**
+     * Writes a poison pill for 'all' join successors of a failed node to prevent stalling.
+     */
+    private writePoisonPillForSuccessors;
 }
 
 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-O3XD45IL.js';
+import '../chunk-3XVVR2SR.js';
+import '../chunk-CSZ6EOWG.js';
+import '../chunk-NBIRTKZ7.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-CYHZ2YVH.js';
+import '../chunk-M2FRTT2K.js';
+import '../chunk-KWQHFT7E.js';
+import '../chunk-5ZXV3R5D.js';
+import '../chunk-PH2IYZHV.js';
+import '../chunk-U5V5O5MN.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-CQCe_nBM.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-M2FRTT2K.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-CQCe_nBM.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-O3XD45IL.js';
+export { FlowRuntime } from '../chunk-3XVVR2SR.js';
+export { WorkflowState } from '../chunk-CSZ6EOWG.js';
+export { GraphTraverser } from '../chunk-NBIRTKZ7.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-CYHZ2YVH.js';
+export { BuiltInNodeExecutor, ClassNodeExecutor, FunctionNodeExecutor } from '../chunk-M2FRTT2K.js';
+import '../chunk-KWQHFT7E.js';
+import '../chunk-5ZXV3R5D.js';
+import '../chunk-PH2IYZHV.js';
+import '../chunk-U5V5O5MN.js';
+import '../chunk-HN72TZY5.js';
+import '../chunk-4PELJWF7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/runtime/runtime.d.ts

@@ -1,9 +1,9 @@
-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 { 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-CQCe_nBM.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;
+    registry: Record<string, NodeFunction | NodeClass | typeof BaseNode>;
     private blueprints;
     private dependencies;
     private logger;
@@ -11,23 +11,25 @@ declare class FlowRuntime<TContext extends Record<string, any>, TDependencies ex
     private serializer;
     private middleware;
     private evaluator;
+    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>;
+    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-3XVVR2SR.js';
+import '../chunk-CSZ6EOWG.js';
+import '../chunk-NBIRTKZ7.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-CYHZ2YVH.js';
+import '../chunk-M2FRTT2K.js';
+import '../chunk-KWQHFT7E.js';
+import '../chunk-5ZXV3R5D.js';
+import '../chunk-PH2IYZHV.js';
+import '../chunk-U5V5O5MN.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-CQCe_nBM.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,22 @@
-import { W as WorkflowBlueprint } from '../types-CZN_FcB6.js';
+import { W as WorkflowBlueprint } from '../types-CQCe_nBM.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;
+    private getEffectiveJoinStrategy;
     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-NBIRTKZ7.js';
+import '../chunk-5ZXV3R5D.js';
+import '../chunk-HN72TZY5.js';
 //# sourceMappingURL=traverser.js.map
 //# sourceMappingURL=traverser.js.map

package/dist/runtime/types.d.ts

@@ -1,9 +1,10 @@
-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-CQCe_nBM.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>) => Promise<{
         node: NodeDefinition;

package/dist/sanitizer.d.ts

@@ -1,4 +1,4 @@
-import { W as WorkflowBlueprint } from './types-CZN_FcB6.js';
+import { W as WorkflowBlueprint } from './types-CQCe_nBM.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-CQCe_nBM.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>;
 }