flowcraft 2.1.1 → 2.3.0

package/dist/chunk-QNYXQKFW.js

@@ -0,0 +1,25 @@
+import { DefaultOrchestrator } from './chunk-33NO4PUJ.js';
+import { NullLogger } from './chunk-4PELJWF7.js';
+import { JsonSerializer } from './chunk-CYHZ2YVH.js';
+import { DIContainer, ServiceTokens } from './chunk-WWGFIYKW.js';
+import { PropertyEvaluator } from './chunk-PH2IYZHV.js';
+
+// src/container-factory.ts
+function createDefaultContainer(options = {}) {
+  const container = new DIContainer();
+  container.register(ServiceTokens.Logger, options.logger || new NullLogger());
+  container.register(ServiceTokens.Serializer, options.serializer || new JsonSerializer());
+  container.register(ServiceTokens.Evaluator, options.evaluator || new PropertyEvaluator());
+  container.register(ServiceTokens.EventBus, options.eventBus || { emit: async () => {
+  } });
+  container.register(ServiceTokens.Middleware, options.middleware || []);
+  container.register(ServiceTokens.NodeRegistry, options.registry || {});
+  container.register(ServiceTokens.BlueprintRegistry, options.blueprints || {});
+  container.register(ServiceTokens.Dependencies, options.dependencies || {});
+  container.registerFactory(ServiceTokens.Orchestrator, () => new DefaultOrchestrator());
+  return container;
+}
+
+export { createDefaultContainer };
+//# sourceMappingURL=chunk-QNYXQKFW.js.map
+//# sourceMappingURL=chunk-QNYXQKFW.js.map

package/dist/chunk-QNYXQKFW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/container-factory.ts"],"names":[],"mappings":";;;;;;;AA4BO,SAAS,sBAAA,CACf,OAAA,GAA2C,EAAC,EAC9B;AACd,EAAA,MAAM,SAAA,GAAY,IAAI,WAAA,EAAY;AAElC,EAAA,SAAA,CAAU,SAAS,aAAA,CAAc,MAAA,EAAQ,QAAQ,MAAA,IAAU,IAAI,YAAY,CAAA;AAC3E,EAAA,SAAA,CAAU,SAAS,aAAA,CAAc,UAAA,EAAY,QAAQ,UAAA,IAAc,IAAI,gBAAgB,CAAA;AACvF,EAAA,SAAA,CAAU,SAAS,aAAA,CAAc,SAAA,EAAW,QAAQ,SAAA,IAAa,IAAI,mBAAmB,CAAA;AACxF,EAAA,SAAA,CAAU,SAAS,aAAA,CAAc,QAAA,EAAU,QAAQ,QAAA,IAAY,EAAE,MAAM,YAAY;AAAA,EAAC,GAAG,CAAA;AACvF,EAAA,SAAA,CAAU,SAAS,aAAA,CAAc,UAAA,EAAY,OAAA,CAAQ,UAAA,IAAc,EAAE,CAAA;AACrE,EAAA,SAAA,CAAU,SAAS,aAAA,CAAc,YAAA,EAAc,OAAA,CAAQ,QAAA,IAAY,EAAE,CAAA;AACrE,EAAA,SAAA,CAAU,SAAS,aAAA,CAAc,iBAAA,EAAmB,OAAA,CAAQ,UAAA,IAAc,EAAE,CAAA;AAC5E,EAAA,SAAA,CAAU,SAAS,aAAA,CAAc,YAAA,EAAc,OAAA,CAAQ,YAAA,IAAiB,EAAoB,CAAA;AAE5F,EAAA,SAAA,CAAU,gBAAgB,aAAA,CAAc,YAAA,EAAc,MAAM,IAAI,qBAAqB,CAAA;AAErF,EAAA,OAAO,SAAA;AACR","file":"chunk-QNYXQKFW.js","sourcesContent":["import { DIContainer, ServiceTokens } from './container'\nimport { PropertyEvaluator } from './evaluator'\nimport { NullLogger } from './logger'\nimport { DefaultOrchestrator } from './runtime/orchestrator'\nimport { JsonSerializer } from './serializer'\nimport type {\n\tIEvaluator,\n\tIEventBus,\n\tILogger,\n\tISerializer,\n\tMiddleware,\n\tNodeClass,\n\tNodeFunction,\n\tRuntimeDependencies,\n\tWorkflowBlueprint,\n} from './types'\n\nexport interface ContainerOptions<TDependencies extends RuntimeDependencies = RuntimeDependencies> {\n\tlogger?: ILogger\n\tserializer?: ISerializer\n\tevaluator?: IEvaluator\n\teventBus?: IEventBus\n\tmiddleware?: Middleware[]\n\tregistry?: Record<string, NodeFunction | NodeClass>\n\tblueprints?: Record<string, WorkflowBlueprint>\n\tdependencies?: TDependencies\n}\n\nexport function createDefaultContainer<TDependencies extends RuntimeDependencies = RuntimeDependencies>(\n\toptions: ContainerOptions<TDependencies> = {},\n): DIContainer {\n\tconst container = new DIContainer()\n\n\tcontainer.register(ServiceTokens.Logger, options.logger || new NullLogger())\n\tcontainer.register(ServiceTokens.Serializer, options.serializer || new JsonSerializer())\n\tcontainer.register(ServiceTokens.Evaluator, options.evaluator || new PropertyEvaluator())\n\tcontainer.register(ServiceTokens.EventBus, options.eventBus || { emit: async () => {} })\n\tcontainer.register(ServiceTokens.Middleware, options.middleware || [])\n\tcontainer.register(ServiceTokens.NodeRegistry, options.registry || {})\n\tcontainer.register(ServiceTokens.BlueprintRegistry, options.blueprints || {})\n\tcontainer.register(ServiceTokens.Dependencies, options.dependencies || ({} as TDependencies))\n\n\tcontainer.registerFactory(ServiceTokens.Orchestrator, () => new DefaultOrchestrator())\n\n\treturn container\n}\n"]}

package/dist/{chunk-KWQHFT7E.js → chunk-R3HQXIEL.js}

@@ -6,16 +6,16 @@ var Context = class {
     this.data = new Map(Object.entries(initialData));
   }
   get(key) {
-    return this.data.get(String(key));
+    return this.data.get(key);
   }
   set(key, value) {
-    this.data.set(String(key), value);
+    this.data.set(key, value);
   }
   has(key) {
-    return this.data.has(String(key));
+    return this.data.has(key);
   }
   delete(key) {
-    return this.data.delete(String(key));
+    return this.data.delete(key);
   }
   toJSON() {
     return Object.fromEntries(this.data);
@@ -45,5 +45,5 @@ var AsyncContextView = class {
 };
 
 export { AsyncContextView, Context };
-//# sourceMappingURL=chunk-KWQHFT7E.js.map
-//# sourceMappingURL=chunk-KWQHFT7E.js.map
+//# sourceMappingURL=chunk-R3HQXIEL.js.map
+//# sourceMappingURL=chunk-R3HQXIEL.js.map

package/dist/chunk-R3HQXIEL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts"],"names":[],"mappings":";AAKO,IAAM,UAAN,MAAsF;AAAA,EAC5E,IAAA,GAAO,MAAA;AAAA,EACf,IAAA;AAAA,EAER,WAAA,CAAY,WAAA,GAAiC,EAAC,EAAG;AAChD,IAAA,IAAA,CAAK,OAAO,IAAI,GAAA,CAAI,MAAA,CAAO,OAAA,CAAQ,WAAW,CAAC,CAAA;AAAA,EAChD;AAAA,EAGA,IAAI,GAAA,EAA8B;AACjC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA;AAAA,EACzB;AAAA,EAGA,GAAA,CAAI,KAAa,KAAA,EAAkB;AAClC,IAAA,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,EACzB;AAAA,EAGA,IAAI,GAAA,EAAsB;AACzB,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA;AAAA,EACzB;AAAA,EAGA,OAAO,GAAA,EAAsB;AAC5B,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,GAAG,CAAA;AAAA,EAC5B;AAAA,EAEA,MAAA,GAA8B;AAC7B,IAAA,OAAO,MAAA,CAAO,WAAA,CAAY,IAAA,CAAK,IAAI,CAAA;AAAA,EACpC;AACD;AAMO,IAAM,mBAAN,MAAgG;AAAA,EAGtG,YAAoB,WAAA,EAAqC;AAArC,IAAA,IAAA,CAAA,WAAA,GAAA,WAAA;AAAA,EAAsC;AAAA,EAF1C,IAAA,GAAO,OAAA;AAAA,EAKvB,IAAI,GAAA,EAAuC;AAC1C,IAAA,OAAO,QAAQ,OAAA,CAAQ,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,GAAG,CAAC,CAAA;AAAA,EACjD;AAAA,EAGA,GAAA,CAAI,KAAa,KAAA,EAA2B;AAC3C,IAAA,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAC/B,IAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,EACxB;AAAA,EAGA,IAAI,GAAA,EAA+B;AAClC,IAAA,OAAO,QAAQ,OAAA,CAAQ,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,GAAG,CAAC,CAAA;AAAA,EACjD;AAAA,EAGA,OAAO,GAAA,EAA+B;AACrC,IAAA,OAAO,QAAQ,OAAA,CAAQ,IAAA,CAAK,WAAA,CAAY,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,EACpD;AAAA,EAEA,MAAA,GAAuC;AACtC,IAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,WAAA,CAAY,QAAQ,CAAA;AAAA,EACjD;AACD","file":"chunk-R3HQXIEL.js","sourcesContent":["import type { IAsyncContext, ISyncContext } from './types'\n\n/**\n * A default, high-performance, in-memory implementation of ISyncContext using a Map.\n */\nexport class Context<TContext extends Record<string, any>> implements ISyncContext<TContext> {\n\tpublic readonly type = 'sync' as const\n\tprivate data: Map<string, any>\n\n\tconstructor(initialData: Partial<TContext> = {}) {\n\t\tthis.data = new Map(Object.entries(initialData))\n\t}\n\n\tget<K extends keyof TContext>(key: K): TContext[K] | undefined\n\tget(key: string): any | undefined {\n\t\treturn this.data.get(key)\n\t}\n\n\tset<K extends keyof TContext>(key: K, value: TContext[K]): void\n\tset(key: string, value: any): void {\n\t\tthis.data.set(key, value)\n\t}\n\n\thas<K extends keyof TContext>(key: K): boolean\n\thas(key: string): boolean {\n\t\treturn this.data.has(key)\n\t}\n\n\tdelete<K extends keyof TContext>(key: K): boolean\n\tdelete(key: string): boolean {\n\t\treturn this.data.delete(key)\n\t}\n\n\ttoJSON(): Record<string, any> {\n\t\treturn Object.fromEntries(this.data)\n\t}\n}\n\n/**\n * An adapter that provides a consistent, Promise-based view of a synchronous context.\n * This is created by the runtime and is transparent to the node author.\n */\nexport class AsyncContextView<TContext extends Record<string, any>> implements IAsyncContext<TContext> {\n\tpublic readonly type = 'async' as const\n\n\tconstructor(private syncContext: ISyncContext<TContext>) {}\n\n\tget<K extends keyof TContext>(key: K): Promise<TContext[K] | undefined>\n\tget(key: string): Promise<any | undefined> {\n\t\treturn Promise.resolve(this.syncContext.get(key))\n\t}\n\n\tset<K extends keyof TContext>(key: K, value: TContext[K]): Promise<void>\n\tset(key: string, value: any): Promise<void> {\n\t\tthis.syncContext.set(key, value)\n\t\treturn Promise.resolve()\n\t}\n\n\thas<K extends keyof TContext>(key: K): Promise<boolean>\n\thas(key: string): Promise<boolean> {\n\t\treturn Promise.resolve(this.syncContext.has(key))\n\t}\n\n\tdelete<K extends keyof TContext>(key: K): Promise<boolean>\n\tdelete(key: string): Promise<boolean> {\n\t\treturn Promise.resolve(this.syncContext.delete(key))\n\t}\n\n\ttoJSON(): Promise<Record<string, any>> {\n\t\treturn Promise.resolve(this.syncContext.toJSON())\n\t}\n}\n"]}

package/dist/chunk-RM677CNU.js

@@ -0,0 +1,52 @@
+import { BaseNode } from './chunk-LNK7LZER.js';
+
+// src/nodes/batch-scatter.ts
+var BatchScatterNode = class extends BaseNode {
+  async exec(_prepResult, context) {
+    const inputArray = context.input || [];
+    if (!Array.isArray(inputArray)) {
+      throw new Error(`Input for batch-scatter node '${this.nodeId}' must be an array.`);
+    }
+    const { chunkSize = inputArray.length, workerUsesKey, gatherNodeId } = this.params || {};
+    if (!workerUsesKey || !gatherNodeId) {
+      throw new Error(`BatchScatterNode requires 'workerUsesKey' and 'gatherNodeId' parameters.`);
+    }
+    const batchId = globalThis.crypto.randomUUID();
+    const currentIndex = await context.context.get(`${this.nodeId}_currentIndex`) || 0;
+    const endIndex = Math.min(currentIndex + chunkSize, inputArray.length);
+    const dynamicNodes = [];
+    const workerIds = [];
+    for (let i = currentIndex; i < endIndex; i++) {
+      const item = inputArray[i];
+      const itemInputKey = `_batch.${this.nodeId}_${batchId}_item_${i}`;
+      await context.context.set(itemInputKey, item);
+      const workerId = `${workerUsesKey}_${batchId}_${i}`;
+      workerIds.push(workerId);
+      dynamicNodes.push({
+        id: workerId,
+        uses: workerUsesKey,
+        inputs: itemInputKey
+      });
+    }
+    const parentBatchId = this.nodeId?.replace("_scatter", "") || "";
+    await context.dependencies.runtime.services.eventBus.emit({
+      type: "batch:start",
+      payload: {
+        batchId: parentBatchId,
+        scatterNodeId: this.nodeId,
+        workerNodeIds: workerIds
+      }
+    });
+    await context.context.set(`${this.nodeId}_currentIndex`, endIndex);
+    const hasMore = endIndex < inputArray.length;
+    await context.context.set(`${gatherNodeId}_hasMore`, hasMore);
+    const existingWorkerIds = await context.context.get(`${gatherNodeId}_allWorkerIds`) || [];
+    const allWorkerIds = [...existingWorkerIds, ...workerIds];
+    await context.context.set(`${gatherNodeId}_allWorkerIds`, allWorkerIds);
+    return { dynamicNodes, output: { gatherNodeId, hasMore } };
+  }
+};
+
+export { BatchScatterNode };
+//# sourceMappingURL=chunk-RM677CNU.js.map
+//# sourceMappingURL=chunk-RM677CNU.js.map

package/dist/chunk-RM677CNU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nodes/batch-scatter.ts"],"names":[],"mappings":"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","file":"chunk-RM677CNU.js","sourcesContent":["import { BaseNode } from '../node'\nimport type { NodeContext, NodeResult } from '../types'\n\nexport class BatchScatterNode extends BaseNode {\n\tasync exec(_prepResult: any, context: NodeContext<any, any, any>): Promise<Omit<NodeResult, 'error'>> {\n\t\tconst inputArray = context.input || []\n\t\tif (!Array.isArray(inputArray)) {\n\t\t\tthrow new Error(`Input for batch-scatter node '${this.nodeId}' must be an array.`)\n\t\t}\n\t\tconst { chunkSize = inputArray.length, workerUsesKey, gatherNodeId } = (this.params as any) || {}\n\t\tif (!workerUsesKey || !gatherNodeId) {\n\t\t\tthrow new Error(`BatchScatterNode requires 'workerUsesKey' and 'gatherNodeId' parameters.`)\n\t\t}\n\t\tconst batchId = globalThis.crypto.randomUUID()\n\t\tconst currentIndex = (await context.context.get(`${this.nodeId}_currentIndex`)) || 0\n\t\tconst endIndex = Math.min(currentIndex + chunkSize, inputArray.length)\n\t\tconst dynamicNodes: any[] = []\n\t\tconst workerIds = []\n\t\tfor (let i = currentIndex; i < endIndex; i++) {\n\t\t\tconst item = inputArray[i]\n\t\t\tconst itemInputKey = `_batch.${this.nodeId}_${batchId}_item_${i}`\n\t\t\tawait context.context.set(itemInputKey as any, item)\n\t\t\tconst workerId = `${workerUsesKey}_${batchId}_${i}`\n\t\t\tworkerIds.push(workerId)\n\t\t\tdynamicNodes.push({\n\t\t\t\tid: workerId,\n\t\t\t\tuses: workerUsesKey,\n\t\t\t\tinputs: itemInputKey,\n\t\t\t})\n\t\t}\n\n\t\tconst parentBatchId = this.nodeId?.replace('_scatter', '') || ''\n\t\tawait context.dependencies.runtime.services.eventBus.emit({\n\t\t\ttype: 'batch:start',\n\t\t\tpayload: {\n\t\t\t\tbatchId: parentBatchId,\n\t\t\t\tscatterNodeId: this.nodeId,\n\t\t\t\tworkerNodeIds: workerIds,\n\t\t\t},\n\t\t})\n\n\t\tawait context.context.set(`${this.nodeId}_currentIndex`, endIndex)\n\t\tconst hasMore = endIndex < inputArray.length\n\t\tawait context.context.set(`${gatherNodeId}_hasMore`, hasMore)\n\t\tconst existingWorkerIds = (await context.context.get(`${gatherNodeId}_allWorkerIds`)) || []\n\t\tconst allWorkerIds = [...existingWorkerIds, ...workerIds]\n\t\tawait context.context.set(`${gatherNodeId}_allWorkerIds`, allWorkerIds)\n\t\treturn { dynamicNodes, output: { gatherNodeId, hasMore } }\n\t}\n}\n"]}

package/dist/chunk-WWGFIYKW.js

@@ -0,0 +1,47 @@
+// src/container.ts
+var DIContainer = class _DIContainer {
+  services = /* @__PURE__ */ new Map();
+  factories = /* @__PURE__ */ new Map();
+  register(token, implementation) {
+    this.services.set(token, implementation);
+  }
+  registerFactory(token, factory) {
+    this.factories.set(token, factory);
+  }
+  resolve(token) {
+    if (this.services.has(token)) {
+      return this.services.get(token);
+    }
+    if (this.factories.has(token)) {
+      const factory = this.factories.get(token);
+      const instance = factory?.(this);
+      this.services.set(token, instance);
+      return instance;
+    }
+    throw new Error(`Service not found for token: ${String(token)}`);
+  }
+  has(token) {
+    return this.services.has(token) || this.factories.has(token);
+  }
+  createChild() {
+    const child = new _DIContainer();
+    child.services = new Map(this.services);
+    child.factories = new Map(this.factories);
+    return child;
+  }
+};
+var ServiceTokens = {
+  Logger: Symbol.for("flowcraft:logger"),
+  Serializer: Symbol.for("flowcraft:serializer"),
+  Evaluator: Symbol.for("flowcraft:evaluator"),
+  EventBus: Symbol.for("flowcraft:eventBus"),
+  Orchestrator: Symbol.for("flowcraft:orchestrator"),
+  Middleware: Symbol.for("flowcraft:middleware"),
+  NodeRegistry: Symbol.for("flowcraft:nodeRegistry"),
+  BlueprintRegistry: Symbol.for("flowcraft:blueprintRegistry"),
+  Dependencies: Symbol.for("flowcraft:dependencies")
+};
+
+export { DIContainer, ServiceTokens };
+//# sourceMappingURL=chunk-WWGFIYKW.js.map
+//# sourceMappingURL=chunk-WWGFIYKW.js.map

package/dist/chunk-WWGFIYKW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/container.ts"],"names":[],"mappings":";AAEO,IAAM,WAAA,GAAN,MAAM,YAAA,CAAY;AAAA,EAChB,QAAA,uBAAuC,GAAA,EAAI;AAAA,EAC3C,SAAA,uBAAoE,GAAA,EAAI;AAAA,EAEhF,QAAA,CAAY,OAAwB,cAAA,EAAyB;AAC5D,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAA,EAAO,cAAc,CAAA;AAAA,EACxC;AAAA,EAEA,eAAA,CAAmB,OAAwB,OAAA,EAA8C;AACxF,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAA,EAAO,OAAO,CAAA;AAAA,EAClC;AAAA,EAEA,QAAW,KAAA,EAA2B;AACrC,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA,EAAG;AAC7B,MAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA;AAAA,IAC/B;AAEA,IAAA,IAAI,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA,EAAG;AAC9B,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AACxC,MAAA,MAAM,QAAA,GAAW,UAAU,IAAI,CAAA;AAC/B,MAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAA,EAAO,QAAQ,CAAA;AACjC,MAAA,OAAO,QAAA;AAAA,IACR;AAEA,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,6BAAA,EAAgC,MAAA,CAAO,KAAK,CAAC,CAAA,CAAE,CAAA;AAAA,EAChE;AAAA,EAEA,IAAI,KAAA,EAA8B;AACjC,IAAA,OAAO,IAAA,CAAK,SAAS,GAAA,CAAI,KAAK,KAAK,IAAA,CAAK,SAAA,CAAU,IAAI,KAAK,CAAA;AAAA,EAC5D;AAAA,EAEA,WAAA,GAA2B;AAC1B,IAAA,MAAM,KAAA,GAAQ,IAAI,YAAA,EAAY;AAC9B,IAAA,KAAA,CAAM,QAAA,GAAW,IAAI,GAAA,CAAI,IAAA,CAAK,QAAQ,CAAA;AACtC,IAAA,KAAA,CAAM,SAAA,GAAY,IAAI,GAAA,CAAI,IAAA,CAAK,SAAS,CAAA;AACxC,IAAA,OAAO,KAAA;AAAA,EACR;AACD;AAEO,IAAM,aAAA,GAAgB;AAAA,EAC5B,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,kBAAkB,CAAA;AAAA,EACrC,UAAA,EAAY,MAAA,CAAO,GAAA,CAAI,sBAAsB,CAAA;AAAA,EAC7C,SAAA,EAAW,MAAA,CAAO,GAAA,CAAI,qBAAqB,CAAA;AAAA,EAC3C,QAAA,EAAU,MAAA,CAAO,GAAA,CAAI,oBAAoB,CAAA;AAAA,EACzC,YAAA,EAAc,MAAA,CAAO,GAAA,CAAI,wBAAwB,CAAA;AAAA,EACjD,UAAA,EAAY,MAAA,CAAO,GAAA,CAAI,sBAAsB,CAAA;AAAA,EAC7C,YAAA,EAAc,MAAA,CAAO,GAAA,CAAI,wBAAwB,CAAA;AAAA,EACjD,iBAAA,EAAmB,MAAA,CAAO,GAAA,CAAI,6BAA6B,CAAA;AAAA,EAC3D,YAAA,EAAc,MAAA,CAAO,GAAA,CAAI,wBAAwB;AAClD","file":"chunk-WWGFIYKW.js","sourcesContent":["export type ServiceToken<_T = any> = string | symbol\n\nexport class DIContainer {\n\tprivate services: Map<ServiceToken, any> = new Map()\n\tprivate factories: Map<ServiceToken, (container: DIContainer) => any> = new Map()\n\n\tregister<T>(token: ServiceToken<T>, implementation: T): void {\n\t\tthis.services.set(token, implementation)\n\t}\n\n\tregisterFactory<T>(token: ServiceToken<T>, factory: (container: DIContainer) => T): void {\n\t\tthis.factories.set(token, factory)\n\t}\n\n\tresolve<T>(token: ServiceToken<T>): T {\n\t\tif (this.services.has(token)) {\n\t\t\treturn this.services.get(token)\n\t\t}\n\n\t\tif (this.factories.has(token)) {\n\t\t\tconst factory = this.factories.get(token)\n\t\t\tconst instance = factory?.(this)\n\t\t\tthis.services.set(token, instance)\n\t\t\treturn instance\n\t\t}\n\n\t\tthrow new Error(`Service not found for token: ${String(token)}`)\n\t}\n\n\thas(token: ServiceToken): boolean {\n\t\treturn this.services.has(token) || this.factories.has(token)\n\t}\n\n\tcreateChild(): DIContainer {\n\t\tconst child = new DIContainer()\n\t\tchild.services = new Map(this.services)\n\t\tchild.factories = new Map(this.factories)\n\t\treturn child\n\t}\n}\n\nexport const ServiceTokens = {\n\tLogger: Symbol.for('flowcraft:logger'),\n\tSerializer: Symbol.for('flowcraft:serializer'),\n\tEvaluator: Symbol.for('flowcraft:evaluator'),\n\tEventBus: Symbol.for('flowcraft:eventBus'),\n\tOrchestrator: Symbol.for('flowcraft:orchestrator'),\n\tMiddleware: Symbol.for('flowcraft:middleware'),\n\tNodeRegistry: Symbol.for('flowcraft:nodeRegistry'),\n\tBlueprintRegistry: Symbol.for('flowcraft:blueprintRegistry'),\n\tDependencies: Symbol.for('flowcraft:dependencies'),\n} as const\n"]}

package/dist/chunk-XNRIM27H.js

@@ -0,0 +1,76 @@
+import { StepByStepOrchestrator } from './chunk-G53CSLBF.js';
+import { GraphTraverser } from './chunk-G5BGBPFP.js';
+import { ExecutionContext } from './chunk-FRKO3WX4.js';
+import { WorkflowState } from './chunk-CD4FUZOJ.js';
+
+// src/testing/stepper.ts
+async function createStepper(runtime, blueprint, functionRegistry, initialState = {}) {
+  const _initialBlueprint = structuredClone(blueprint);
+  const _initialState = structuredClone(initialState);
+  let state;
+  let traverser;
+  const history = [];
+  const orchestrator = new StepByStepOrchestrator();
+  const executionId = globalThis.crypto?.randomUUID();
+  const nodeRegistry = new Map([...runtime.registry, ...functionRegistry]);
+  const initialize = () => {
+    state = new WorkflowState(_initialState);
+    traverser = new GraphTraverser(_initialBlueprint);
+    history.length = 0;
+  };
+  initialize();
+  const stepper = {
+    get state() {
+      return state;
+    },
+    get traverser() {
+      return traverser;
+    },
+    isDone() {
+      return !traverser.hasMoreWork() && !state.isAwaiting();
+    },
+    reset() {
+      initialize();
+    },
+    async prev() {
+      const previousStateJson = history.pop();
+      if (!previousStateJson) {
+        return null;
+      }
+      const previousStateData = runtime.serializer.deserialize(previousStateJson);
+      state = new WorkflowState(previousStateData);
+      traverser = GraphTraverser.fromState(_initialBlueprint, state);
+      return state.toResult(runtime.serializer);
+    },
+    async next(options = {}) {
+      if (stepper.isDone()) {
+        return null;
+      }
+      const serializedContext = (await state.toResult(runtime.serializer)).serializedContext;
+      history.push(serializedContext);
+      const executionContext = new ExecutionContext(
+        _initialBlueprint,
+        state,
+        nodeRegistry,
+        executionId,
+        runtime,
+        {
+          logger: runtime.logger,
+          eventBus: runtime.eventBus,
+          serializer: runtime.serializer,
+          evaluator: runtime.evaluator,
+          middleware: runtime.middleware,
+          dependencies: runtime.dependencies
+        },
+        options.signal,
+        options.concurrency
+      );
+      return orchestrator.run(executionContext, traverser);
+    }
+  };
+  return stepper;
+}
+
+export { createStepper };
+//# sourceMappingURL=chunk-XNRIM27H.js.map
+//# sourceMappingURL=chunk-XNRIM27H.js.map

package/dist/chunk-XNRIM27H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/stepper.ts"],"names":[],"mappings":";;;;;;AAkFA,eAAsB,cACrB,OAAA,EACA,SAAA,EACA,gBAAA,EACA,YAAA,GAAkC,EAAC,EACG;AACtC,EAAA,MAAM,iBAAA,GAAoB,gBAAgB,SAAS,CAAA;AACnD,EAAA,MAAM,aAAA,GAAgB,gBAAgB,YAAY,CAAA;AAElD,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,SAAA;AACJ,EAAA,MAAM,UAAoB,EAAC;AAE3B,EAAA,MAAM,YAAA,GAAe,IAAI,sBAAA,EAAuB;AAChD,EAAA,MAAM,WAAA,GAAc,UAAA,CAAW,MAAA,EAAQ,UAAA,EAAW;AAClD,EAAA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,CAAC,GAAG,OAAA,CAAQ,QAAA,EAAU,GAAG,gBAAgB,CAAC,CAAA;AAEvE,EAAA,MAAM,aAAa,MAAM;AACxB,IAAA,KAAA,GAAQ,IAAI,cAAwB,aAAa,CAAA;AACjD,IAAA,SAAA,GAAY,IAAI,eAAe,iBAAiB,CAAA;AAChD,IAAA,OAAA,CAAQ,MAAA,GAAS,CAAA;AAAA,EAClB,CAAA;AAEA,EAAA,UAAA,EAAW;AAEX,EAAA,MAAM,OAAA,GAAsC;AAAA,IAC3C,IAAI,KAAA,GAAQ;AACX,MAAA,OAAO,KAAA;AAAA,IACR,CAAA;AAAA,IACA,IAAI,SAAA,GAAY;AACf,MAAA,OAAO,SAAA;AAAA,IACR,CAAA;AAAA,IACA,MAAA,GAAS;AACR,MAAA,OAAO,CAAC,SAAA,CAAU,WAAA,EAAY,IAAK,CAAC,MAAM,UAAA,EAAW;AAAA,IACtD,CAAA;AAAA,IACA,KAAA,GAAQ;AACP,MAAA,UAAA,EAAW;AAAA,IACZ,CAAA;AAAA,IACA,MAAM,IAAA,GAAO;AACZ,MAAA,MAAM,iBAAA,GAAoB,QAAQ,GAAA,EAAI;AACtC,MAAA,IAAI,CAAC,iBAAA,EAAmB;AACvB,QAAA,OAAO,IAAA;AAAA,MACR;AAEA,MAAA,MAAM,iBAAA,GAAoB,OAAA,CAAQ,UAAA,CAAW,WAAA,CAAY,iBAAiB,CAAA;AAE1E,MAAA,KAAA,GAAQ,IAAI,cAAc,iBAAiB,CAAA;AAC3C,MAAA,SAAA,GAAY,cAAA,CAAe,SAAA,CAAU,iBAAA,EAAmB,KAAK,CAAA;AAE7D,MAAA,OAAO,KAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,UAAU,CAAA;AAAA,IACzC,CAAA;AAAA,IACA,MAAM,IAAA,CAAK,OAAA,GAA0D,EAAC,EAAG;AACxE,MAAA,IAAI,OAAA,CAAQ,QAAO,EAAG;AACrB,QAAA,OAAO,IAAA;AAAA,MACR;AAEA,MAAA,MAAM,qBAAqB,MAAM,KAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,UAAU,CAAA,EAAG,iBAAA;AACrE,MAAA,OAAA,CAAQ,KAAK,iBAAiB,CAAA;AAE9B,MAAA,MAAM,mBAAmB,IAAI,gBAAA;AAAA,QAC5B,iBAAA;AAAA,QACA,KAAA;AAAA,QACA,YAAA;AAAA,QACA,WAAA;AAAA,QACA,OAAA;AAAA,QACA;AAAA,UACC,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,UAAU,OAAA,CAAQ,QAAA;AAAA,UAClB,YAAY,OAAA,CAAQ,UAAA;AAAA,UACpB,WAAW,OAAA,CAAQ,SAAA;AAAA,UACnB,YAAY,OAAA,CAAQ,UAAA;AAAA,UACpB,cAAc,OAAA,CAAQ;AAAA,SACvB;AAAA,QACA,OAAA,CAAQ,MAAA;AAAA,QACR,OAAA,CAAQ;AAAA,OACT;AACA,MAAA,OAAO,YAAA,CAAa,GAAA,CAAI,gBAAA,EAAkB,SAAS,CAAA;AAAA,IACpD;AAAA,GACD;AAEA,EAAA,OAAO,OAAA;AACR","file":"chunk-XNRIM27H.js","sourcesContent":["import type { FlowRuntime } from '../runtime'\nimport { ExecutionContext } from '../runtime/execution-context'\nimport { StepByStepOrchestrator } from '../runtime/orchestrators/step-by-step'\nimport { WorkflowState } from '../runtime/state'\nimport { GraphTraverser } from '../runtime/traverser'\nimport type { NodeClass, NodeFunction, WorkflowBlueprint, WorkflowResult } from '../types'\n\n/**\n * Represents the controlled, step-by-step execution of a workflow.\n * Returned by the `createStepper` utility.\n */\nexport interface IWorkflowStepper<TContext extends Record<string, any>> {\n\t/** The current state of the workflow. Can be inspected after each step. */\n\treadonly state: WorkflowState<TContext>\n\n\t/** The graph traverser instance. Can be used to inspect the frontier or completed nodes. */\n\treadonly traverser: GraphTraverser\n\n\t/**\n\t * Executes the next \"turn\" or batch of ready nodes in the workflow.\n\t * @param options Optional configuration for this specific step, like a cancellation signal.\n\t * @returns A `WorkflowResult` representing the state after the step, or `null` if the workflow has already completed.\n\t */\n\tnext(options?: { signal?: AbortSignal; concurrency?: number }): Promise<WorkflowResult<TContext> | null>\n\n\t/**\n\t * Reverts the workflow to its previous state.\n\t * @returns The `WorkflowResult` of the previous state, or `null` if there is no history to revert to.\n\t */\n\tprev(): Promise<WorkflowResult<TContext> | null>\n\n\t/**\n\t * Resets the stepper to its initial state, clearing all progress and history.\n\t */\n\treset(): void\n\n\t/**\n\t * A convenience method to check if the workflow has any more steps to run.\n\t * @returns `true` if the workflow is complete or stalled, `false` otherwise.\n\t */\n\tisDone(): boolean\n}\n\n/**\n * A test utility that creates a stepper to execute a workflow one \"turn\" at a time.\n * This is invaluable for debugging and writing fine-grained tests where you need to\n * assert the state of the workflow after each logical step.\n *\n * @example\n * // In your test file\n * it('should correctly execute step-by-step', async () => {\n *   const runtime = new FlowRuntime({ ... });\n *   const flow = createFlow('test')\n *     .node('a', async () => ({ output: 10 }))\n *     .node('b', async ({ input }) => ({ output: input * 2 }))\n *     .edge('a', 'b');\n *\n *   const stepper = await createStepper(runtime, flow.toBlueprint(), flow.getFunctionRegistry());\n *\n *   // First step (executes node 'a')\n *   const result1 = await stepper.next();\n *   expect(stepper.isDone()).toBe(false);\n *   expect(result1.status).toBe('stalled');\n *   expect(result1.context._outputs.a).toBe(10);\n *\n *   // Second step (executes node 'b')\n *   const result2 = await stepper.next();\n *   expect(stepper.isDone()).toBe(true);\n *   expect(result2.status).toBe('completed');\n *   expect(result2.context._outputs.b).toBe(20);\n *\n *   // Final step (no more work)\n *   const result3 = await stepper.next();\n *   expect(result3).toBeNull();\n * });\n *\n * @param runtime The `FlowRuntime` instance, used for its configuration.\n * @param blueprint The `WorkflowBlueprint` to execute.\n * @param functionRegistry The function registry from createFlow, containing the node implementations.\n * @param initialState The initial state for the workflow run.\n * @returns A Promise that resolves to an `IWorkflowStepper` instance.\n */\nexport async function createStepper<TContext extends Record<string, any>, TDependencies extends Record<string, any>>(\n\truntime: FlowRuntime<TContext, TDependencies>,\n\tblueprint: WorkflowBlueprint,\n\tfunctionRegistry: Map<string, NodeFunction | NodeClass>,\n\tinitialState: Partial<TContext> = {},\n): Promise<IWorkflowStepper<TContext>> {\n\tconst _initialBlueprint = structuredClone(blueprint)\n\tconst _initialState = structuredClone(initialState)\n\n\tlet state: WorkflowState<TContext>\n\tlet traverser: GraphTraverser\n\tconst history: string[] = []\n\n\tconst orchestrator = new StepByStepOrchestrator()\n\tconst executionId = globalThis.crypto?.randomUUID()\n\tconst nodeRegistry = new Map([...runtime.registry, ...functionRegistry])\n\n\tconst initialize = () => {\n\t\tstate = new WorkflowState<TContext>(_initialState)\n\t\ttraverser = new GraphTraverser(_initialBlueprint)\n\t\thistory.length = 0\n\t}\n\n\tinitialize()\n\n\tconst stepper: IWorkflowStepper<TContext> = {\n\t\tget state() {\n\t\t\treturn state\n\t\t},\n\t\tget traverser() {\n\t\t\treturn traverser\n\t\t},\n\t\tisDone() {\n\t\t\treturn !traverser.hasMoreWork() && !state.isAwaiting()\n\t\t},\n\t\treset() {\n\t\t\tinitialize()\n\t\t},\n\t\tasync prev() {\n\t\t\tconst previousStateJson = history.pop()\n\t\t\tif (!previousStateJson) {\n\t\t\t\treturn null\n\t\t\t}\n\n\t\t\tconst previousStateData = runtime.serializer.deserialize(previousStateJson) as Partial<TContext>\n\n\t\t\tstate = new WorkflowState(previousStateData)\n\t\t\ttraverser = GraphTraverser.fromState(_initialBlueprint, state)\n\n\t\t\treturn state.toResult(runtime.serializer)\n\t\t},\n\t\tasync next(options: { signal?: AbortSignal; concurrency?: number } = {}) {\n\t\t\tif (stepper.isDone()) {\n\t\t\t\treturn null\n\t\t\t}\n\n\t\t\tconst serializedContext = (await state.toResult(runtime.serializer)).serializedContext\n\t\t\thistory.push(serializedContext)\n\n\t\t\tconst executionContext = new ExecutionContext(\n\t\t\t\t_initialBlueprint,\n\t\t\t\tstate,\n\t\t\t\tnodeRegistry,\n\t\t\t\texecutionId,\n\t\t\t\truntime,\n\t\t\t\t{\n\t\t\t\t\tlogger: runtime.logger,\n\t\t\t\t\teventBus: runtime.eventBus,\n\t\t\t\t\tserializer: runtime.serializer,\n\t\t\t\t\tevaluator: runtime.evaluator,\n\t\t\t\t\tmiddleware: runtime.middleware,\n\t\t\t\t\tdependencies: runtime.dependencies,\n\t\t\t\t},\n\t\t\t\toptions.signal,\n\t\t\t\toptions.concurrency,\n\t\t\t)\n\t\t\treturn orchestrator.run(executionContext, traverser)\n\t\t},\n\t}\n\n\treturn stepper\n}\n"]}

package/dist/container-factory.d.ts

@@ -0,0 +1,17 @@
+import { DIContainer } from './container.js';
+import { u as RuntimeDependencies, x as ILogger, A as ISerializer, w as IEvaluator, z as IEventBus, M as Middleware, n as NodeFunction, o as NodeClass, g as WorkflowBlueprint } from './types-ezHUBdpL.js';
+import './errors.js';
+
+interface ContainerOptions<TDependencies extends RuntimeDependencies = RuntimeDependencies> {
+    logger?: ILogger;
+    serializer?: ISerializer;
+    evaluator?: IEvaluator;
+    eventBus?: IEventBus;
+    middleware?: Middleware[];
+    registry?: Record<string, NodeFunction | NodeClass>;
+    blueprints?: Record<string, WorkflowBlueprint>;
+    dependencies?: TDependencies;
+}
+declare function createDefaultContainer<TDependencies extends RuntimeDependencies = RuntimeDependencies>(options?: ContainerOptions<TDependencies>): DIContainer;
+
+export { type ContainerOptions, createDefaultContainer };

package/dist/container-factory.js

@@ -0,0 +1,13 @@
+export { createDefaultContainer } from './chunk-QNYXQKFW.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';
+//# sourceMappingURL=container-factory.js.map
+//# sourceMappingURL=container-factory.js.map

package/dist/container-factory.js.map

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

package/dist/container.d.ts

@@ -0,0 +1,23 @@
+type ServiceToken<_T = any> = string | symbol;
+declare class DIContainer {
+    private services;
+    private factories;
+    register<T>(token: ServiceToken<T>, implementation: T): void;
+    registerFactory<T>(token: ServiceToken<T>, factory: (container: DIContainer) => T): void;
+    resolve<T>(token: ServiceToken<T>): T;
+    has(token: ServiceToken): boolean;
+    createChild(): DIContainer;
+}
+declare const ServiceTokens: {
+    readonly Logger: symbol;
+    readonly Serializer: symbol;
+    readonly Evaluator: symbol;
+    readonly EventBus: symbol;
+    readonly Orchestrator: symbol;
+    readonly Middleware: symbol;
+    readonly NodeRegistry: symbol;
+    readonly BlueprintRegistry: symbol;
+    readonly Dependencies: symbol;
+};
+
+export { DIContainer, type ServiceToken, ServiceTokens };

package/dist/container.js

@@ -0,0 +1,3 @@
+export { DIContainer, ServiceTokens } from './chunk-WWGFIYKW.js';
+//# sourceMappingURL=container.js.map
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

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

package/dist/context.d.ts

@@ -1,4 +1,6 @@
-import { I as ISyncContext, h as IAsyncContext } from './types-CQCe_nBM.js';
+import { s as ISyncContext, t as IAsyncContext } from './types-ezHUBdpL.js';
+import './errors.js';
+import './container.js';
 
 /**
  * A default, high-performance, in-memory implementation of ISyncContext using a Map.

package/dist/context.js

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

package/dist/errors.d.ts

@@ -1,19 +1,20 @@
-/** Error thrown when a node fails during execution. */
-declare class NodeExecutionError extends Error {
-    readonly nodeId: string;
-    readonly blueprintId: string;
-    readonly originalError?: Error | undefined;
-    readonly executionId?: string | undefined;
-    constructor(message: string, nodeId: string, blueprintId: string, originalError?: Error | undefined, executionId?: string | undefined);
-}
-/** Error thrown when a workflow is gracefully aborted. */
-declare class CancelledWorkflowError extends Error {
-    readonly executionId?: string | undefined;
-    constructor(message?: string, executionId?: string | undefined);
-}
-/** Error thrown for a non-recoverable failure that should halt the workflow immediately. */
-declare class FatalNodeExecutionError extends NodeExecutionError {
-    constructor(message: string, nodeId: string, blueprintId: string, originalError?: Error, executionId?: string);
+/**
+ * A single, comprehensive error class for the framework.
+ * Use this for all errors to ensure consistent structure and easy debugging.
+ */
+declare class FlowcraftError extends Error {
+    readonly message: string;
+    readonly nodeId?: string;
+    readonly blueprintId?: string;
+    readonly executionId?: string;
+    readonly isFatal: boolean;
+    constructor(message: string, options?: {
+        cause?: Error;
+        nodeId?: string;
+        blueprintId?: string;
+        executionId?: string;
+        isFatal?: boolean;
+    });
 }
 
-export { CancelledWorkflowError, FatalNodeExecutionError, NodeExecutionError };
+export { FlowcraftError };

package/dist/errors.js

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

package/dist/evaluator.d.ts

@@ -1,4 +1,6 @@
-import { k as IEvaluator } from './types-CQCe_nBM.js';
+import { w as IEvaluator } from './types-ezHUBdpL.js';
+import './errors.js';
+import './container.js';
 
 /**
  * A safe evaluator that only allows simple property access.

package/dist/flow.d.ts

@@ -1,4 +1,6 @@
-import { d as NodeFunction, e as NodeClass, N as NodeDefinition, E as EdgeDefinition, W as WorkflowBlueprint } from './types-CQCe_nBM.js';
+import { n as NodeFunction, o as NodeClass, h as NodeDefinition, j as EdgeDefinition, g as WorkflowBlueprint, U as UIGraph } from './types-ezHUBdpL.js';
+import './errors.js';
+import './container.js';
 
 /**
  * A fluent API for programmatically constructing a WorkflowBlueprint.
@@ -8,25 +10,37 @@ declare class Flow<TContext extends Record<string, any> = Record<string, any>, T
     private functionRegistry;
     private loopControllerIds;
     private loopDefinitions;
+    private batchDefinitions;
+    private cycleEntryPoints;
     constructor(id: string);
     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.
      * It takes an input array, runs a worker node on each item in parallel, and gathers the results.
+     * This method augments the Flow's TContext with a new key for the output array.
+     *
      * @param id The base ID for this batch operation.
      * @param worker The node implementation to run on each item.
      * @param options Configuration for the batch operation.
-     * @param options.inputKey The key in the context that holds the input array for the batch.
-     * @param options.outputKey The key in the context where the array of results will be stored.
-     * @returns The Flow instance for chaining.
+     * @returns The Flow instance with an updated context type for chaining.
      */
-    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: {
+    batch<TWorkerInput, TWorkerOutput, TWorkerAction extends string, TOutputKey extends string>(id: string, worker: NodeFunction<TContext, TDependencies, TWorkerInput, TWorkerOutput, TWorkerAction> | NodeClass<TContext, TDependencies, TWorkerInput, TWorkerOutput, TWorkerAction>, options: {
         /** The key in the context that holds the input array for the batch. */
         inputKey: keyof TContext;
         /** The key in the context where the array of results will be stored. */
-        outputKey: keyof TContext;
-    }): this;
+        outputKey: TOutputKey;
+        /** The number of items to process in each chunk to limit memory usage. */
+        chunkSize?: number;
+    }): Flow<TContext & {
+        [K in TOutputKey]: TWorkerOutput[];
+    }, TDependencies>;
+    /**
+     * Creates a wait node that pauses workflow execution for external input.
+     * @param id A unique identifier for the wait node.
+     * @param options Optional configuration for the wait node.
+     */
+    wait(id: string, options?: Omit<NodeDefinition, 'id' | 'uses'>): this;
     /**
      * Creates a loop pattern in the workflow graph.
      * @param id A unique identifier for the loop construct.
@@ -44,8 +58,15 @@ declare class Flow<TContext extends Record<string, any> = Record<string, any>, T
         condition: string;
     }): this;
     getLoopControllerId(id: string): string;
+    /**
+     * Sets the preferred entry point for a cycle in non-DAG workflows.
+     * This helps remove ambiguity when the runtime needs to choose a starting node for cycles.
+     * @param nodeId The ID of the node to use as the entry point for cycles containing this node.
+     */
+    setCycleEntryPoint(nodeId: string): this;
     toBlueprint(): WorkflowBlueprint;
-    getFunctionRegistry(): Map<string, NodeClass | NodeFunction>;
+    getFunctionRegistry(): Map<string, NodeFunction | NodeClass>;
+    toGraphRepresentation(): UIGraph;
 }
 /**
  * Helper function to create a new Flow builder instance.

package/dist/flow.js

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

package/dist/index.d.ts

@@ -1,15 +1,15 @@
 export { BlueprintAnalysis, Cycles, analyzeBlueprint, checkForCycles, generateMermaid } from './analysis.js';
+export { DIContainer, ServiceToken, ServiceTokens } from './container.js';
+export { ContainerOptions, createDefaultContainer } from './container-factory.js';
 export { AsyncContextView, Context } from './context.js';
-export { CancelledWorkflowError, FatalNodeExecutionError, NodeExecutionError } from './errors.js';
+export { FlowcraftError } 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-CQCe_nBM.js';
+export { B as BaseNode, C as ClassNodeExecutor, r as ContextImplementation, j as EdgeDefinition, e as ExecutionServices, E as ExecutionStrategy, c as FlowRuntime, y as FlowcraftEvent, F as FunctionNodeExecutor, G as GraphTraverser, t as IAsyncContext, w as IEvaluator, z as IEventBus, x as ILogger, I as IOrchestrator, f as IRuntime, A as ISerializer, s as ISyncContext, M as Middleware, o as NodeClass, k as NodeConfig, m as NodeContext, h as NodeDefinition, N as NodeExecutionResult, b as NodeExecutor, a as NodeExecutorConfig, d as NodeExecutorFactory, n as NodeFunction, p as NodeImplementation, q as NodeRegistry, l as NodeResult, R as ReadyNode, u as RuntimeDependencies, v as RuntimeOptions, U as UIGraph, g as WorkflowBlueprint, D as WorkflowError, J as WorkflowResult, W as WorkflowState, H as WorkflowStatus, i as isNodeClass } from './types-ezHUBdpL.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';
-export { WorkflowState } from './runtime/state.js';
-export { GraphTraverser } from './runtime/traverser.js';
+export { DefaultOrchestrator } from './runtime/orchestrator.js';
+export { executeBatch, processResults } from './runtime/orchestrators/utils.js';
 export { sanitizeBlueprint } from './sanitizer.js';
-import './runtime/types.js';
+export { JsonSerializer } from './serializer.js';

package/dist/index.js

@@ -1,19 +1,31 @@
-import './chunk-55J6XMHW.js';
-import './chunk-HMR2GEGE.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-NVJ3ZO3P.js';
+import './chunk-NVLZFLYM.js';
+export { BaseDistributedAdapter } from './chunk-6INWPSZT.js';
+export { FlowRuntime } from './chunk-IB2BISIC.js';
+import './chunk-MCGK3FXQ.js';
+import './chunk-DL7KVYZF.js';
+export { ClassNodeExecutor, FunctionNodeExecutor, NodeExecutor } from './chunk-ONH7PIJZ.js';
+import './chunk-5KKSQWSC.js';
+import './chunk-CD3Q4N6V.js';
+export { GraphTraverser } from './chunk-G5BGBPFP.js';
+export { lintBlueprint } from './chunk-EUJWJWFA.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';
+import './chunk-55J6XMHW.js';
+import './chunk-BC4G7OM6.js';
+import './chunk-RM677CNU.js';
+export { analyzeBlueprint, checkForCycles, generateMermaid } from './chunk-233SESC2.js';
+export { createDefaultContainer } from './chunk-QNYXQKFW.js';
+export { DefaultOrchestrator } from './chunk-33NO4PUJ.js';
+export { executeBatch, processResults } from './chunk-HAZ26F3P.js';
+import './chunk-FRKO3WX4.js';
+export { WorkflowState } from './chunk-CD4FUZOJ.js';
 export { ConsoleLogger, NullLogger } from './chunk-4PELJWF7.js';
+export { JsonSerializer } from './chunk-CYHZ2YVH.js';
+export { DIContainer, ServiceTokens } from './chunk-WWGFIYKW.js';
+export { AsyncContextView, Context } from './chunk-R3HQXIEL.js';
+export { FlowcraftError } from './chunk-BCRWXTWX.js';
+export { PropertyEvaluator, UnsafeEvaluator } from './chunk-PH2IYZHV.js';
+export { Flow, createFlow } from './chunk-C4HYIJI3.js';
+export { BaseNode, isNodeClass } from './chunk-LNK7LZER.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/linter.d.ts

@@ -1,6 +1,8 @@
-import { W as WorkflowBlueprint, d as NodeFunction, e as NodeClass } from './types-CQCe_nBM.js';
+import { g as WorkflowBlueprint, n as NodeFunction, o as NodeClass } from './types-ezHUBdpL.js';
+import './errors.js';
+import './container.js';
 
-type LinterIssueCode = 'INVALID_EDGE_SOURCE' | 'INVALID_EDGE_TARGET' | 'MISSING_NODE_IMPLEMENTATION' | 'ORPHAN_NODE';
+type LinterIssueCode = 'INVALID_EDGE_SOURCE' | 'INVALID_EDGE_TARGET' | 'MISSING_NODE_IMPLEMENTATION' | 'ORPHAN_NODE' | 'INVALID_BATCH_WORKER_KEY' | 'INVALID_SUBFLOW_BLUEPRINT_ID';
 interface LinterIssue {
     code: LinterIssueCode;
     message: string;
@@ -19,6 +21,6 @@ interface LinterResult {
  * @param registry A map of node implementations (functions or classes) to check against.
  * @returns A LinterResult object containing any issues found.
  */
-declare function lintBlueprint(blueprint: WorkflowBlueprint, registry: Map<string, NodeFunction | NodeClass> | Record<string, NodeFunction | NodeClass>): LinterResult;
+declare function lintBlueprint(blueprint: WorkflowBlueprint, registry: Map<string, NodeFunction | NodeClass> | Record<string, NodeFunction | NodeClass>, blueprints?: Record<string, WorkflowBlueprint>): LinterResult;
 
 export { type LinterIssue, type LinterIssueCode, type LinterResult, lintBlueprint };

package/dist/linter.js

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

package/dist/logger.d.ts

@@ -1,4 +1,6 @@
-import { l as ILogger } from './types-CQCe_nBM.js';
+import { x as ILogger } from './types-ezHUBdpL.js';
+import './errors.js';
+import './container.js';
 
 /** A logger implementation that outputs to the console. */
 declare class ConsoleLogger implements ILogger {