flowcraft 2.9.2 → 2.10.0

package/README.md

@@ -98,7 +98,7 @@ The `FlowRuntime` can be configured with pluggable components to tailor its beha
 
 ## Distributed Execution
 
-Flowcraft's architecture is designed for progressive scalability. The `BaseDistributedAdapter` provides a foundation for running workflows across multiple machines. Flowcraft provides official adapters for [BullMQ](https://www.npmjs.com/package/@flowcraft/bullmq-adapter), [AWS](https://www.npmjs.com/package/@flowcraft/sqs-adapter), [GCP](https://www.npmjs.com/package/@flowcraft/gcp-adapter), [Azure](https://www.npmjs.com/package/@flowcraft/azure-adapter), [RabbitMQ](https://www.npmjs.com/package/@flowcraft/rabbitmq-adapter), [Kafka](https://www.npmjs.com/package/@flowcraft/kafka-adapter), and [Cloudflare](https://www.npmjs.com/package/@flowcraft/cloudflare-adapter).
+Flowcraft's architecture is designed for progressive scalability. The `BaseDistributedAdapter` provides a foundation for running workflows across multiple machines. Flowcraft provides official adapters for [BullMQ](https://www.npmjs.com/package/@flowcraft/bullmq-adapter), [AWS](https://www.npmjs.com/package/@flowcraft/sqs-adapter), [GCP](https://www.npmjs.com/package/@flowcraft/gcp-adapter), [Azure](https://www.npmjs.com/package/@flowcraft/azure-adapter), [RabbitMQ](https://www.npmjs.com/package/@flowcraft/rabbitmq-adapter), [Kafka](https://www.npmjs.com/package/@flowcraft/kafka-adapter), [Vercel](https://www.npmjs.com/package/@flowcraft/vercel-adapter), and [Cloudflare](https://www.npmjs.com/package/@flowcraft/cloudflare-adapter).
 
 ## Documentation
 

package/dist/{index-DUPpyNvU.d.mts → index-BXRN44Qf.d.mts}

@@ -125,6 +125,7 @@ declare class WorkflowState<TContext extends Record<string, any>> {
   private _isAwaiting;
   private _awaitingNodeIds;
   private _awaitingDetails;
+  isLastAttempt?: boolean;
   constructor(initialData: Partial<TContext>, context?: IAsyncContext<TContext>);
   /**
    * Configure the context to emit events when modified.
@@ -1141,6 +1142,10 @@ interface JobPayload {
   runId: string;
   blueprintId: string;
   nodeId: string;
+  /** Used to suppress intermediate failures and fallback triggers when delegating to Queue retries */
+  isLastAttempt?: boolean;
+  /** Optional attempt tracking metadata */
+  attempt?: number;
 }
 /**
  * The base class for all distributed adapters. It handles the technology-agnostic
@@ -1157,6 +1162,17 @@ declare abstract class BaseDistributedAdapter {
    * Starts the worker, which begins listening for and processing jobs from the queue.
    */
   start(): void;
+  /**
+   * Hook called by the execution factory to determine if a node's automatic
+   * retries should be executed synchronously in-process (true) or delegated
+   * to the Queue backoff behavior configured by the adapter (false).
+   */
+  protected shouldRetryInProcess(_nodeDef: NodeDefinition): boolean;
+  /**
+   * Returns queue-level retry options for enqueuing successor jobs.
+   * Only used when shouldRetryInProcess() returns false.
+   */
+  protected getQueueRetryOptions(_nodeDef: NodeDefinition): Record<string, any> | undefined;
   /**
    * Creates a technology-specific distributed context for a given workflow run.
    * @param runId The unique ID for the workflow execution.
@@ -1202,6 +1218,11 @@ declare abstract class BaseDistributedAdapter {
    * The main handler for processing a single job from the queue.
    */
   protected handleJob(job: JobPayload): Promise<void>;
+  /**
+   * Handles post-execution logic: terminal node checks, successor determination,
+   * and enqueueing of ready nodes. Extracted to support the idempotency guard.
+   */
+  private handleNodeCompletion;
   /**
    * Encapsulates the fan-in join logic using the coordination store.
    */
@@ -1323,4 +1344,4 @@ declare class JsonSerializer implements ISerializer {
 }
 //#endregion
 export { NodeConfig as $, TrackedAsyncContext as A, DIContainer as At, InMemoryEventStore as B, FlowBuilder as C, ClassNodeExecutor as Ct, createErrorMapper as D, NodeExecutor as Dt, UnsafeEvaluator as E, NodeExecutionResult as Et, analyzeBlueprint as F, FlowcraftError as Ft, IAsyncContext as G, ContextImplementation as H, checkForCycles as I, ILogger as J, IEvaluator as K, generateMermaid as L, createDefaultContainer as M, ServiceTokens as Mt, BlueprintAnalysis as N, BaseNode as Nt, AsyncContextView as O, NodeExecutorConfig as Ot, Cycles as P, isNodeClass as Pt, NodeClass as Q, generateMermaidForRun as R, lintBlueprint as S, ReadyNode as St, PropertyEvaluator as T, FunctionNodeExecutor as Tt, EdgeDefinition as U, PersistentEventBusAdapter as V, FlowcraftEvent as W, ISyncContext as X, ISerializer as Y, Middleware as Z, ConsoleLogger as _, ExecutionServices as _t, ReplayOrchestrator as a, NodeResult as at, LinterIssueCode as b, NodeExecutorFactory as bt, BaseDistributedAdapter as c, RuntimeOptions as ct, WebhookNode as d, WorkflowBlueprint as dt, NodeContext as et, WaitNode as f, WorkflowBlueprintMetadata as ft, BatchGatherNode as g, FlowRuntime as gt, BatchScatterNode as h, WorkflowStatus as ht, processResults as i, NodeRegistry as it, ContainerOptions as j, ServiceToken as jt, Context as k, WorkflowState as kt, ICoordinationStore as l, SourceLocation as lt, SleepNode as m, WorkflowResult as mt, sanitizeBlueprint as n, NodeFunction as nt, DefaultOrchestrator as o, PatchOperation as ot, SubflowNode as p, WorkflowError as pt, IEventBus as q, executeBatch as r, NodeImplementation as rt, AdapterOptions as s, RuntimeDependencies as st, JsonSerializer as t, NodeDefinition as tt, JobPayload as u, UIGraph as ut, NullLogger as v, IOrchestrator as vt, createFlow as w, ExecutionStrategy as wt, LinterResult as x, GraphTraverser as xt, LinterIssue as y, IRuntime as yt, IEventStore as z };
-//# sourceMappingURL=index-DUPpyNvU.d.mts.map
+//# sourceMappingURL=index-BXRN44Qf.d.mts.map

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as NodeConfig, A as TrackedAsyncContext, At as DIContainer, B as InMemoryEventStore, C as FlowBuilder, Ct as ClassNodeExecutor, D as createErrorMapper, Dt as NodeExecutor, E as UnsafeEvaluator, Et as NodeExecutionResult, F as analyzeBlueprint, Ft as FlowcraftError, G as IAsyncContext, H as ContextImplementation, I as checkForCycles, J as ILogger, K as IEvaluator, L as generateMermaid, M as createDefaultContainer, Mt as ServiceTokens, N as BlueprintAnalysis, Nt as BaseNode, O as AsyncContextView, Ot as NodeExecutorConfig, P as Cycles, Pt as isNodeClass, Q as NodeClass, R as generateMermaidForRun, S as lintBlueprint, St as ReadyNode, T as PropertyEvaluator, Tt as FunctionNodeExecutor, U as EdgeDefinition, V as PersistentEventBusAdapter, W as FlowcraftEvent, X as ISyncContext, Y as ISerializer, Z as Middleware, _ as ConsoleLogger, _t as ExecutionServices, a as ReplayOrchestrator, at as NodeResult, b as LinterIssueCode, bt as NodeExecutorFactory, c as BaseDistributedAdapter, ct as RuntimeOptions, d as WebhookNode, dt as WorkflowBlueprint, et as NodeContext, f as WaitNode, ft as WorkflowBlueprintMetadata, g as BatchGatherNode, gt as FlowRuntime, h as BatchScatterNode, ht as WorkflowStatus, i as processResults, it as NodeRegistry, j as ContainerOptions, jt as ServiceToken, k as Context, kt as WorkflowState, l as ICoordinationStore, lt as SourceLocation, m as SleepNode, mt as WorkflowResult, n as sanitizeBlueprint, nt as NodeFunction, o as DefaultOrchestrator, ot as PatchOperation, p as SubflowNode, pt as WorkflowError, q as IEventBus, r as executeBatch, rt as NodeImplementation, s as AdapterOptions, st as RuntimeDependencies, t as JsonSerializer, tt as NodeDefinition, u as JobPayload, ut as UIGraph, v as NullLogger, vt as IOrchestrator, w as createFlow, wt as ExecutionStrategy, x as LinterResult, xt as GraphTraverser, y as LinterIssue, yt as IRuntime, z as IEventStore } from "./index-DUPpyNvU.mjs";
+import { $ as NodeConfig, A as TrackedAsyncContext, At as DIContainer, B as InMemoryEventStore, C as FlowBuilder, Ct as ClassNodeExecutor, D as createErrorMapper, Dt as NodeExecutor, E as UnsafeEvaluator, Et as NodeExecutionResult, F as analyzeBlueprint, Ft as FlowcraftError, G as IAsyncContext, H as ContextImplementation, I as checkForCycles, J as ILogger, K as IEvaluator, L as generateMermaid, M as createDefaultContainer, Mt as ServiceTokens, N as BlueprintAnalysis, Nt as BaseNode, O as AsyncContextView, Ot as NodeExecutorConfig, P as Cycles, Pt as isNodeClass, Q as NodeClass, R as generateMermaidForRun, S as lintBlueprint, St as ReadyNode, T as PropertyEvaluator, Tt as FunctionNodeExecutor, U as EdgeDefinition, V as PersistentEventBusAdapter, W as FlowcraftEvent, X as ISyncContext, Y as ISerializer, Z as Middleware, _ as ConsoleLogger, _t as ExecutionServices, a as ReplayOrchestrator, at as NodeResult, b as LinterIssueCode, bt as NodeExecutorFactory, c as BaseDistributedAdapter, ct as RuntimeOptions, d as WebhookNode, dt as WorkflowBlueprint, et as NodeContext, f as WaitNode, ft as WorkflowBlueprintMetadata, g as BatchGatherNode, gt as FlowRuntime, h as BatchScatterNode, ht as WorkflowStatus, i as processResults, it as NodeRegistry, j as ContainerOptions, jt as ServiceToken, k as Context, kt as WorkflowState, l as ICoordinationStore, lt as SourceLocation, m as SleepNode, mt as WorkflowResult, n as sanitizeBlueprint, nt as NodeFunction, o as DefaultOrchestrator, ot as PatchOperation, p as SubflowNode, pt as WorkflowError, q as IEventBus, r as executeBatch, rt as NodeImplementation, s as AdapterOptions, st as RuntimeDependencies, t as JsonSerializer, tt as NodeDefinition, u as JobPayload, ut as UIGraph, v as NullLogger, vt as IOrchestrator, w as createFlow, wt as ExecutionStrategy, x as LinterResult, xt as GraphTraverser, y as LinterIssue, yt as IRuntime, z as IEventStore } from "./index-BXRN44Qf.mjs";
 export { AdapterOptions, AsyncContextView, BaseDistributedAdapter, BaseNode, BatchGatherNode, BatchScatterNode, BlueprintAnalysis, ClassNodeExecutor, ConsoleLogger, ContainerOptions, Context, ContextImplementation, Cycles, DIContainer, DefaultOrchestrator, EdgeDefinition, ExecutionServices, ExecutionStrategy, FlowBuilder, FlowRuntime, FlowcraftError, FlowcraftEvent, FunctionNodeExecutor, GraphTraverser, IAsyncContext, ICoordinationStore, IEvaluator, IEventBus, IEventStore, ILogger, IOrchestrator, IRuntime, ISerializer, ISyncContext, InMemoryEventStore, JobPayload, JsonSerializer, LinterIssue, LinterIssueCode, LinterResult, Middleware, NodeClass, NodeConfig, NodeContext, NodeDefinition, NodeExecutionResult, NodeExecutor, NodeExecutorConfig, NodeExecutorFactory, NodeFunction, NodeImplementation, NodeRegistry, NodeResult, NullLogger, PatchOperation, PersistentEventBusAdapter, PropertyEvaluator, ReadyNode, ReplayOrchestrator, RuntimeDependencies, RuntimeOptions, ServiceToken, ServiceTokens, SleepNode, SourceLocation, SubflowNode, TrackedAsyncContext, UIGraph, UnsafeEvaluator, WaitNode, WebhookNode, WorkflowBlueprint, WorkflowBlueprintMetadata, WorkflowError, WorkflowResult, WorkflowState, WorkflowStatus, analyzeBlueprint, checkForCycles, createDefaultContainer, createErrorMapper, createFlow, executeBatch, generateMermaid, generateMermaidForRun, isNodeClass, lintBlueprint, processResults, sanitizeBlueprint };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { t as ReplayOrchestrator } from "./replay-BB11M6K1.mjs";
-import { A as ServiceTokens, C as TrackedAsyncContext, D as PropertyEvaluator, E as NullLogger, F as InMemoryEventStore, I as PersistentEventBusAdapter, M as checkForCycles, N as generateMermaid, O as UnsafeEvaluator, P as generateMermaidForRun, S as Context, T as ConsoleLogger, _ as executeBatch, a as sanitizeBlueprint, b as WorkflowState, c as SubflowNode, d as BatchScatterNode, f as BatchGatherNode, g as DefaultOrchestrator, h as JsonSerializer, i as NodeExecutor, j as analyzeBlueprint, k as DIContainer, l as GraphTraverser, m as isNodeClass, n as ClassNodeExecutor, o as WebhookNode, p as BaseNode, r as FunctionNodeExecutor, s as WaitNode, t as FlowRuntime, u as SleepNode, v as processResults, w as FlowcraftError, x as AsyncContextView } from "./runtime-CRwlRW2p.mjs";
+import { A as ServiceTokens, C as TrackedAsyncContext, D as PropertyEvaluator, E as NullLogger, F as InMemoryEventStore, I as PersistentEventBusAdapter, M as checkForCycles, N as generateMermaid, O as UnsafeEvaluator, P as generateMermaidForRun, S as Context, T as ConsoleLogger, _ as executeBatch, a as sanitizeBlueprint, b as WorkflowState, c as SubflowNode, d as BatchScatterNode, f as BatchGatherNode, g as DefaultOrchestrator, h as JsonSerializer, i as NodeExecutor, j as analyzeBlueprint, k as DIContainer, l as GraphTraverser, m as isNodeClass, n as ClassNodeExecutor, o as WebhookNode, p as BaseNode, r as FunctionNodeExecutor, s as WaitNode, t as FlowRuntime, u as SleepNode, v as processResults, w as FlowcraftError, x as AsyncContextView } from "./runtime-ChsWirQN.mjs";
 
 //#region src/container-factory.ts
 function createDefaultContainer(options = {}) {
@@ -215,7 +215,7 @@ var FlowBuilder = class {
 		this.edge(endNodeId, id);
 		this.edge(id, startNodeId, {
 			action: "continue",
-			transform: `context.${endNodeId}`
+			transform: `context["${endNodeId}"]`
 		});
 		return this;
 	}
@@ -239,7 +239,7 @@ var FlowBuilder = class {
 				finalEdges.push({
 					...edge,
 					action: edge.action || "break",
-					transform: `context.${loopDef.endNodeId}`
+					transform: `context["${loopDef.endNodeId}"]`
 				});
 				processedOriginalEdges.add(edge);
 			}
@@ -324,7 +324,7 @@ var FlowBuilder = class {
 			const incomingEdges = blueprint.edges.filter((edge) => edge.target === id && edge.source !== loopDef.endNodeId);
 			for (const incomingEdge of incomingEdges) uiEdges.push({
 				...incomingEdge,
-				source: loopDef.startNodeId
+				target: loopDef.startNodeId
 			});
 		}
 		const scatterNodes = blueprint.nodes.filter((n) => n.uses === "batch-scatter");
@@ -480,6 +480,19 @@ var BaseDistributedAdapter = class {
 		this.processJobs(this.handleJob.bind(this));
 	}
 	/**
+	* Hook called by the execution factory to determine if a node's automatic
+	* retries should be executed synchronously in-process (true) or delegated
+	* to the Queue backoff behavior configured by the adapter (false).
+	*/
+	shouldRetryInProcess(_nodeDef) {
+		return true;
+	}
+	/**
+	* Returns queue-level retry options for enqueuing successor jobs.
+	* Only used when shouldRetryInProcess() returns false.
+	*/
+	getQueueRetryOptions(_nodeDef) {}
+	/**
 	* Hook called at the start of job processing. Subclasses can override this
 	* to perform additional setup (e.g., timestamp tracking for reconciliation).
 	*/
@@ -526,82 +539,40 @@ var BaseDistributedAdapter = class {
 		}, 18e5);
 		try {
 			const state = new WorkflowState(await context.toJSON(), context);
-			const result = await this.runtime.executeNode(blueprint, nodeId, state);
-			await context.set(`_outputs.${nodeId}`, result.output);
-			const stateContext = state.getContext();
-			if (stateContext instanceof TrackedAsyncContext) {
-				const deltas = stateContext.getDeltas();
-				if (deltas.length > 0) {
-					await stateContext.patch(deltas);
-					stateContext.clearDeltas();
+			state.isLastAttempt = job.isLastAttempt !== false;
+			let result;
+			if (await context.has(`_outputs.${nodeId}`)) {
+				this.logger.info(`[Adapter] Node '${nodeId}' already completed, skipping re-execution.`);
+				result = { output: await context.get(`_outputs.${nodeId}`) };
+			} else {
+				const nodeDef = blueprint.nodes.find((n) => n.id === nodeId);
+				if (nodeDef && !this.shouldRetryInProcess(nodeDef)) {
+					if (nodeDef.config?.maxRetries && nodeDef.config.maxRetries > 1) nodeDef.config.maxRetries = 1;
 				}
-			}
-			const analysis = analyzeBlueprint(blueprint);
-			const isTerminalNode = analysis.terminalNodeIds.includes(nodeId);
-			if (isTerminalNode) {
-				const allContextKeys = Object.keys(await context.toJSON());
-				const completedNodes = /* @__PURE__ */ new Set();
-				for (const key of allContextKeys) if (key.startsWith("_outputs.")) completedNodes.add(key.substring(9));
-				if (analysis.terminalNodeIds.every((terminalId) => completedNodes.has(terminalId))) {
-					this.logger.info(`[Adapter] All terminal nodes completed for Run ID: ${runId}. Declaring workflow complete.`);
-					const finalContext = await context.toJSON();
-					const finalResult = {
-						context: finalContext,
-						serializedContext: this.serializer.serialize(finalContext),
-						status: "completed"
-					};
-					await this.publishFinalResult(runId, {
-						status: "completed",
-						payload: finalResult
-					});
-					clearInterval(heartbeatInterval);
-					return;
-				} else this.logger.info(`[Adapter] Terminal node '${nodeId}' completed for Run ID '${runId}', but other terminal nodes are still running.`);
-			}
-			const nextNodes = await this.runtime.determineNextNodes(blueprint, nodeId, result, context, runId);
-			if (nextNodes.length === 0 && !isTerminalNode) {
-				this.logger.info(`[Adapter] Non-terminal node '${nodeId}' reached end of branch for Run ID '${runId}'. This branch will now terminate.`);
-				clearInterval(heartbeatInterval);
-				return;
-			}
-			for (const { node: nextNodeDef, edge } of nextNodes) {
-				await this.runtime.applyEdgeTransform(edge, result, nextNodeDef, context, void 0, runId);
-				if (await this.isReadyForFanIn(runId, blueprint, nextNodeDef.id)) {
-					this.logger.info(`[Adapter] Node '${nextNodeDef.id}' is ready. Enqueuing job.`);
-					await this.enqueueJob({
-						runId,
-						blueprintId,
-						nodeId: nextNodeDef.id
-					});
-					if (this.eventBus) await this.eventBus.emit({
-						type: "job:enqueued",
-						payload: {
-							runId,
-							blueprintId,
-							nodeId: nextNodeDef.id
-						}
-					});
-				} else this.logger.info(`[Adapter] Node '${nextNodeDef.id}' is waiting for other predecessors to complete.`);
-			}
-			const duration = Date.now() - startTime;
-			if (this.eventBus) await this.eventBus.emit({
-				type: "job:processed",
-				payload: {
-					runId,
-					blueprintId,
-					nodeId,
-					duration,
-					success: true
+				result = await this.runtime.executeNode(blueprint, nodeId, state);
+				await context.set(`_outputs.${nodeId}`, result.output);
+				const stateContext = state.getContext();
+				if (stateContext instanceof TrackedAsyncContext) {
+					const deltas = stateContext.getDeltas();
+					if (deltas.length > 0) {
+						await stateContext.patch(deltas);
+						stateContext.clearDeltas();
+					}
 				}
+			}
+			await this.handleNodeCompletion({
+				runId,
+				blueprintId,
+				nodeId,
+				blueprint,
+				result,
+				context,
+				startTime,
+				heartbeatInterval
 			});
 		} catch (error) {
 			const reason = error.message || "Unknown execution error";
 			this.logger.error(`[Adapter] FATAL: Job for node '${nodeId}' failed for Run ID '${runId}': ${reason}`);
-			await this.publishFinalResult(runId, {
-				status: "failed",
-				reason
-			});
-			await this.writePoisonPillForSuccessors(runId, blueprint, nodeId);
 			if (this.eventBus) await this.eventBus.emit({
 				type: "job:failed",
 				payload: {
@@ -611,11 +582,85 @@ var BaseDistributedAdapter = class {
 					error
 				}
 			});
+			if (job.isLastAttempt === false) {
+				this.logger.warn(`[Adapter] Job for node '${nodeId}' failed (queue attempt ${job.attempt || 1}), delegating retry to queue.`);
+				return;
+			}
+			await this.publishFinalResult(runId, {
+				status: "failed",
+				reason
+			});
+			await this.writePoisonPillForSuccessors(runId, blueprint, nodeId);
 		} finally {
 			clearInterval(heartbeatInterval);
 		}
 	}
 	/**
+	* Handles post-execution logic: terminal node checks, successor determination,
+	* and enqueueing of ready nodes. Extracted to support the idempotency guard.
+	*/
+	async handleNodeCompletion(params) {
+		const { runId, blueprintId, nodeId, blueprint, result, context, startTime, heartbeatInterval } = params;
+		const analysis = analyzeBlueprint(blueprint);
+		const isTerminalNode = analysis.terminalNodeIds.includes(nodeId);
+		if (isTerminalNode) {
+			const allContextKeys = Object.keys(await context.toJSON());
+			const completedNodes = /* @__PURE__ */ new Set();
+			for (const key of allContextKeys) if (key.startsWith("_outputs.")) completedNodes.add(key.substring(9));
+			if (analysis.terminalNodeIds.every((terminalId) => completedNodes.has(terminalId))) {
+				this.logger.info(`[Adapter] All terminal nodes completed for Run ID: ${runId}. Declaring workflow complete.`);
+				const finalContext = await context.toJSON();
+				const finalResult = {
+					context: finalContext,
+					serializedContext: this.serializer.serialize(finalContext),
+					status: "completed"
+				};
+				await this.publishFinalResult(runId, {
+					status: "completed",
+					payload: finalResult
+				});
+				clearInterval(heartbeatInterval);
+				return;
+			} else this.logger.info(`[Adapter] Terminal node '${nodeId}' completed for Run ID '${runId}', but other terminal nodes are still running.`);
+		}
+		const nextNodes = await this.runtime.determineNextNodes(blueprint, nodeId, result, context, runId);
+		if (nextNodes.length === 0 && !isTerminalNode) {
+			this.logger.info(`[Adapter] Non-terminal node '${nodeId}' reached end of branch for Run ID '${runId}'. This branch will now terminate.`);
+			clearInterval(heartbeatInterval);
+			return;
+		}
+		for (const { node: nextNodeDef, edge } of nextNodes) {
+			await this.runtime.applyEdgeTransform(edge, result, nextNodeDef, context, void 0, runId);
+			if (await this.isReadyForFanIn(runId, blueprint, nextNodeDef.id)) {
+				this.logger.info(`[Adapter] Node '${nextNodeDef.id}' is ready. Enqueuing job.`);
+				await this.enqueueJob({
+					runId,
+					blueprintId,
+					nodeId: nextNodeDef.id
+				});
+				if (this.eventBus) await this.eventBus.emit({
+					type: "job:enqueued",
+					payload: {
+						runId,
+						blueprintId,
+						nodeId: nextNodeDef.id
+					}
+				});
+			} else this.logger.info(`[Adapter] Node '${nextNodeDef.id}' is waiting for other predecessors to complete.`);
+		}
+		const duration = Date.now() - startTime;
+		if (this.eventBus) await this.eventBus.emit({
+			type: "job:processed",
+			payload: {
+				runId,
+				blueprintId,
+				nodeId,
+				duration,
+				success: true
+			}
+		});
+	}
+	/**
 	* Encapsulates the fan-in join logic using the coordination store.
 	*/
 	async isReadyForFanIn(runId, blueprint, targetNodeId) {