@n8n/engine 0.13.1 → 0.15.0

package/dist/execution/start-execution.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-execution.service.js","sourceRoot":"","sources":["../../src/execution/start-execution.service.ts"],"names":[],"mappings":";;;AAAA,8CAAgF;AAkBhF;IAEmB,UAAU;IACV,cAAc;IACd,SAAS;IAH3B,YACkB,UAA6B,EAC7B,cAA8B,EAC9B,SAAoB;0BAFpB,UAAU;8BACV,cAAc;yBACd,SAAS;IACxB,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,OAA8B;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,oCAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC;YACxD,UAAU,EAAE,OAAO,CAAC,UAAU;YAE9B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;SAC9C,CAAC,CAAC;QAKH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,EAAE;SACf,CAAC,CAAC;QAEH,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;CACD"}
+{"version":3,"file":"start-execution.service.js","sourceRoot":"","sources":["../../src/execution/start-execution.service.ts"],"names":[],"mappings":";;;AAAA,8CAAgF;AAEhF,oCAAuE;AAgBvE;IAEmB,UAAU;IACV,cAAc;IACd,SAAS;IACT,aAAa;IAJ/B,YACkB,UAA6B,EAC7B,cAA8B,EAC9B,SAA0C,EAC1C,aAAa,GAAmC,+BAAuB;0BAHvE,UAAU;8BACV,cAAc;yBACd,SAAS;6BACT,aAAa;IAC5B,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,OAA8B;QAGzC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAElC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,oCAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC;YACxD,UAAU,EAAE,OAAO,CAAC,UAAU;YAE9B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;SAC9C,CAAC,CAAC;QAKH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,EAAE;SACf,CAAC,CAAC;QAEH,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC5B,CAAC;CACD"}

package/dist/execution/step-completed-handler.d.ts

@@ -0,0 +1,13 @@
+import type { StepCompletedEvent, StepMessage, WorkQueue } from '../queue';
+import type { ExecutionStore } from './execution-store';
+import type { StepStore } from './step-store';
+export declare class StepCompletedHandler {
+    private readonly executionStore;
+    private readonly stepStore;
+    private readonly stepQueue;
+    constructor(executionStore: ExecutionStore, stepStore: StepStore, stepQueue: WorkQueue<StepMessage>);
+    handle(event: StepCompletedEvent): Promise<void>;
+    private finishExecutionIfDone;
+    private planSuccessors;
+    private readySuccessorNodeIds;
+}

package/dist/execution/step-completed-handler.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepCompletedHandler = void 0;
+const graph_1 = require("../graph");
+const validate_step_context_1 = require("./validate-step-context");
+class StepCompletedHandler {
+    executionStore;
+    stepStore;
+    stepQueue;
+    constructor(executionStore, stepStore, stepQueue) {
+        this.executionStore = executionStore;
+        this.stepStore = stepStore;
+        this.stepQueue = stepQueue;
+    }
+    async handle(event) {
+        const [step, execution] = await Promise.all([
+            this.stepStore.loadStep(event.stepId),
+            this.executionStore.loadExecution(event.executionId),
+        ]);
+        (0, validate_step_context_1.validateStepContext)(step, execution);
+        if (step.status === 'failed') {
+            await this.executionStore.finishExecution(execution.id, 'failed');
+            await this.stepStore.cancelQueuedSteps(execution.id);
+            return;
+        }
+        if (execution.status !== 'running')
+            return;
+        const planned = step.status === 'completed' ? await this.planSuccessors(execution, step.nodeId) : 0;
+        if (planned > 0)
+            return;
+        await this.finishExecutionIfDone(execution.id);
+    }
+    async finishExecutionIfDone(executionId) {
+        if (await this.stepStore.hasActiveSteps(executionId))
+            return;
+        const failed = await this.stepStore.hasFailedSteps(executionId);
+        await this.executionStore.finishExecution(executionId, failed ? 'failed' : 'completed');
+    }
+    async planSuccessors(execution, nodeId) {
+        const readyNodeIds = await this.readySuccessorNodeIds(execution, nodeId);
+        if (readyNodeIds.length === 0)
+            return 0;
+        const created = await this.stepStore.createSteps(readyNodeIds.map((readyNodeId) => ({
+            executionId: execution.id,
+            nodeId: readyNodeId,
+            status: 'queued',
+        })));
+        for (const { id: stepId } of created) {
+            await this.stepQueue.publish({
+                type: 'step:ready',
+                executionId: execution.id,
+                stepId,
+            });
+        }
+        return created.length;
+    }
+    async readySuccessorNodeIds(execution, nodeId) {
+        const successors = (0, graph_1.getSuccessorNodeIds)(execution.graph, nodeId).map((id) => ({
+            id,
+            predecessorIds: (0, graph_1.getPredecessorNodeIds)(execution.graph, id),
+        }));
+        const predecessorsToCheck = successors
+            .flatMap(({ predecessorIds }) => predecessorIds)
+            .filter((id) => id !== nodeId);
+        const completed = predecessorsToCheck.length === 0
+            ? new Set()
+            : await this.stepStore.loadCompletedNodeIds(execution.id, predecessorsToCheck);
+        return successors
+            .filter(({ predecessorIds }) => predecessorIds.every((id) => id === nodeId || completed.has(id)))
+            .map(({ id }) => id);
+    }
+}
+exports.StepCompletedHandler = StepCompletedHandler;
+//# sourceMappingURL=step-completed-handler.js.map

package/dist/execution/step-completed-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-completed-handler.js","sourceRoot":"","sources":["../../src/execution/step-completed-handler.ts"],"names":[],"mappings":";;;AAAA,oCAAsE;AAItE,mEAA8D;AAc9D;IAEmB,cAAc;IACd,SAAS;IACT,SAAS;IAH3B,YACkB,cAA8B,EAC9B,SAAoB,EACpB,SAAiC;8BAFjC,cAAc;yBACd,SAAS;yBACT,SAAS;IACxB,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,KAAyB;QACrC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;YACrC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC;SACpD,CAAC,CAAC;QACH,IAAA,2CAAmB,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAIrC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAClE,MAAM,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACrD,OAAO;QACR,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QAE3C,MAAM,OAAO,GACZ,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAIrF,IAAI,OAAO,GAAG,CAAC;YAAE,OAAO;QAExB,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IAaO,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QACtD,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,WAAW,CAAC;YAAE,OAAO;QAE7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACzF,CAAC;IAGO,KAAK,CAAC,cAAc,CAAC,SAA0B,EAAE,MAAc;QACtE,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACzE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAOxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAC/C,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAClC,WAAW,EAAE,SAAS,CAAC,EAAE;YACzB,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,QAAiB;SACzB,CAAC,CAAC,CACH,CAAC;QAEF,KAAK,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC5B,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,SAAS,CAAC,EAAE;gBACzB,MAAM;aACN,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC;IACvB,CAAC;IAYO,KAAK,CAAC,qBAAqB,CAClC,SAA0B,EAC1B,MAAc;QAEd,MAAM,UAAU,GAAG,IAAA,2BAAmB,EAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5E,EAAE;YACF,cAAc,EAAE,IAAA,6BAAqB,EAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;SAC1D,CAAC,CAAC,CAAC;QAGJ,MAAM,mBAAmB,GAAG,UAAU;aACpC,OAAO,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC;aAE/C,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAEhC,MAAM,SAAS,GACd,mBAAmB,CAAC,MAAM,KAAK,CAAC;YAC/B,CAAC,CAAC,IAAI,GAAG,EAAU;YACnB,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAEjF,OAAO,UAAU;aACf,MAAM,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC9B,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAChE;aACA,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;CACD"}

package/dist/execution/step-ready-handler.d.ts

@@ -0,0 +1,16 @@
+import type { ExternalDependencies } from '../dependencies';
+import type { OrchestrationMessage, StepReadyEvent, WorkQueue } from '../queue';
+import type { ExecutionStore } from './execution-store';
+import type { StepStore } from './step-store';
+export declare class StepReadyHandler {
+    private readonly executionStore;
+    private readonly stepStore;
+    private readonly orchestrationQueue;
+    private readonly dependencies;
+    constructor(executionStore: ExecutionStore, stepStore: StepStore, orchestrationQueue: WorkQueue<OrchestrationMessage>, dependencies: ExternalDependencies);
+    handle(event: StepReadyEvent): Promise<void>;
+    private runStep;
+    private assertOutputFiredForSuccessors;
+    private gatherInputs;
+    private executorFor;
+}

package/dist/execution/step-ready-handler.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepReadyHandler = void 0;
+const common_1 = require("../common");
+const validate_step_context_1 = require("./validate-step-context");
+class StepReadyHandler {
+    executionStore;
+    stepStore;
+    orchestrationQueue;
+    dependencies;
+    constructor(executionStore, stepStore, orchestrationQueue, dependencies) {
+        this.executionStore = executionStore;
+        this.stepStore = stepStore;
+        this.orchestrationQueue = orchestrationQueue;
+        this.dependencies = dependencies;
+    }
+    async handle(event) {
+        const step = await this.stepStore.claimStep(event.stepId);
+        if (!step)
+            return;
+        const execution = await this.executionStore.loadExecution(event.executionId);
+        const node = (0, validate_step_context_1.validateStepContext)(step, execution);
+        const executor = this.executorFor(step, node);
+        if (execution.status !== 'running') {
+            return;
+        }
+        const inputs = await this.gatherInputs(execution, step);
+        let run;
+        try {
+            run = {
+                ok: true,
+                outputs: await this.runStep(step, execution, node, inputs, executor),
+            };
+        }
+        catch (error) {
+            run = { ok: false, error };
+        }
+        const recorded = run.ok
+            ? await this.stepStore.completeStep(event.stepId, run.outputs)
+            : await this.stepStore.failStep(event.stepId, toStepError(run.error));
+        if (!recorded)
+            return;
+        await this.orchestrationQueue.publish({
+            type: 'step:completed',
+            executionId: event.executionId,
+            stepId: event.stepId,
+        });
+    }
+    async runStep(step, execution, node, inputs, executor) {
+        const { outputs } = await executor.execute({
+            node,
+            inputs,
+            context: {
+                executionId: execution.id,
+                stepId: step.id,
+                workflowId: execution.workflowId,
+                mode: execution.mode,
+            },
+        });
+        if (outputs.length > 1) {
+            throw new common_1.UnimplementedError(`step ${step.id} runs node ${step.nodeId}, which produced ${outputs.length} output slots; only output slot 0 is supported yet`);
+        }
+        this.assertOutputFiredForSuccessors(step, execution, outputs);
+        return outputs;
+    }
+    assertOutputFiredForSuccessors(step, execution, outputs) {
+        const hasSuccessors = execution.graph.edges.some((edge) => edge.from === step.nodeId);
+        if (hasSuccessors && (outputs.length === 0 || outputs[0] === null)) {
+            throw new common_1.UnimplementedError(`step ${step.id} runs node ${step.nodeId}, which did not fire output slot 0 despite having successors; branch selection is not supported yet`);
+        }
+    }
+    async gatherInputs(execution, step) {
+        const incoming = execution.graph.edges.filter((edge) => edge.to === step.nodeId);
+        if (incoming.length === 0) {
+            throw new common_1.UnexpectedError(`step ${step.id} runs node ${step.nodeId}, which has no predecessor in the execution graph`);
+        }
+        if (incoming.length > 1) {
+            throw new common_1.UnexpectedError(`step ${step.id} runs node ${step.nodeId}, which has ${incoming.length} incoming edges; validated graphs have at most one edge per input slot`);
+        }
+        const [edge] = incoming;
+        if (edge.outputIndex !== 0 || edge.inputIndex !== 0) {
+            throw new common_1.UnexpectedError(`step ${step.id} runs node ${step.nodeId} through edge slots ${edge.outputIndex} → ${edge.inputIndex}; validated graphs only use slot 0`);
+        }
+        const outputsByNodeId = await this.stepStore.loadStepOutputs(execution.id, [edge.from]);
+        const predecessorOutputs = outputsByNodeId[edge.from];
+        if (!predecessorOutputs) {
+            throw new common_1.UnexpectedError(`step ${step.id} reads node ${edge.from}, whose step has not completed`);
+        }
+        if (predecessorOutputs.length > 1) {
+            throw new common_1.UnexpectedError(`step ${step.id} reads node ${edge.from}, whose step recorded more than one output slot; the write-time guard admits only slot 0`);
+        }
+        return [predecessorOutputs[0] ?? null];
+    }
+    executorFor(step, node) {
+        if (node.type === 'v1-node') {
+            const executor = this.dependencies.v1StepExecutor;
+            if (!executor) {
+                throw new common_1.UnimplementedError(`step ${step.id}: no executor configured for v1-node steps; the host must supply one in integrated mode`);
+            }
+            return executor;
+        }
+        throw new common_1.UnimplementedError(`step ${step.id}: no executor for step type ${node.type}`);
+    }
+}
+exports.StepReadyHandler = StepReadyHandler;
+function toStepError(error) {
+    if (error instanceof Error) {
+        return { name: error.name, message: error.message, stack: error.stack };
+    }
+    return { name: 'Error', message: String(error) };
+}
+//# sourceMappingURL=step-ready-handler.js.map

package/dist/execution/step-ready-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-ready-handler.js","sourceRoot":"","sources":["../../src/execution/step-ready-handler.ts"],"names":[],"mappings":";;;AAAA,sCAAgE;AAOhE,mEAA8D;AAW9D;IAEmB,cAAc;IACd,SAAS;IACT,kBAAkB;IAClB,YAAY;IAJ9B,YACkB,cAA8B,EAC9B,SAAoB,EACpB,kBAAmD,EACnD,YAAkC;8BAHlC,cAAc;yBACd,SAAS;kCACT,kBAAkB;4BAClB,YAAY;IAC3B,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,KAAqB;QAEjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI;YAAE,OAAO;QAOlB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,IAAA,2CAAmB,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE9C,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAIpC,OAAO;QACR,CAAC;QAMD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAIxD,IAAI,GAAqE,CAAC;QAC1E,IAAI,CAAC;YACJ,GAAG,GAAG;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;aACpE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,GAAG,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE;YACtB,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC;YAC9D,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAMvE,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;YACrC,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;SACpB,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,OAAO,CACpB,IAAgB,EAChB,SAA0B,EAC1B,IAAe,EACf,MAAiB,EACjB,QAAuB;QAEvB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;YAC1C,IAAI;YACJ,MAAM;YACN,OAAO,EAAE;gBACR,WAAW,EAAE,SAAS,CAAC,EAAE;gBACzB,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,IAAI,EAAE,SAAS,CAAC,IAAI;aACpB;SACD,CAAC,CAAC;QAGH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,EAAE,cAAc,IAAI,CAAC,MAAM,oBAAoB,OAAO,CAAC,MAAM,oDAAoD,CAC9H,CAAC;QACH,CAAC;QAED,IAAI,CAAC,8BAA8B,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAE9D,OAAO,OAAO,CAAC;IAChB,CAAC;IAOO,8BAA8B,CACrC,IAAgB,EAChB,SAA0B,EAC1B,OAAkB;QAGlB,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QACtF,IAAI,aAAa,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,EAAE,cAAc,IAAI,CAAC,MAAM,qGAAqG,CAC7I,CAAC;QACH,CAAC;IACF,CAAC;IAGO,KAAK,CAAC,YAAY,CAAC,SAA0B,EAAE,IAAgB;QACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QACjF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAG3B,MAAM,IAAI,wBAAe,CACxB,QAAQ,IAAI,CAAC,EAAE,cAAc,IAAI,CAAC,MAAM,mDAAmD,CAC3F,CAAC;QACH,CAAC;QAGD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,wBAAe,CACxB,QAAQ,IAAI,CAAC,EAAE,cAAc,IAAI,CAAC,MAAM,eAAe,QAAQ,CAAC,MAAM,wEAAwE,CAC9I,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;QAGxB,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,wBAAe,CACxB,QAAQ,IAAI,CAAC,EAAE,cAAc,IAAI,CAAC,MAAM,uBAAuB,IAAI,CAAC,WAAW,MAAM,IAAI,CAAC,UAAU,oCAAoC,CACxI,CAAC;QACH,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxF,MAAM,kBAAkB,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAGzB,MAAM,IAAI,wBAAe,CACxB,QAAQ,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,IAAI,gCAAgC,CACvE,CAAC;QACH,CAAC;QACD,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,wBAAe,CACxB,QAAQ,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,IAAI,0FAA0F,CACjI,CAAC;QACH,CAAC;QAED,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IACxC,CAAC;IAMO,WAAW,CAAC,IAAgB,EAAE,IAAe;QACpD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC;YAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,EAAE,yFAAyF,CACxG,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QACjB,CAAC;QAED,MAAM,IAAI,2BAAkB,CAAC,QAAQ,IAAI,CAAC,EAAE,+BAA+B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzF,CAAC;CACD;;AAED,SAAS,WAAW,CAAC,KAAc;IAClC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAClD,CAAC"}

package/dist/execution/step-store.d.ts

@@ -1,11 +1,41 @@
-import type { StepStatus } from './execution.types';
+import type { JsonValue } from '../common';
+import type { StepSlots, StepStatus } from './execution.types';
 export interface NewStepRecord {
     executionId: string;
     nodeId: string;
     status: StepStatus;
+    outputs?: StepSlots;
+}
+export interface StepError {
+    name: string;
+    message: string;
+    stack?: string;
+    details?: JsonValue;
+}
+export interface StepRecord {
+    id: string;
+    executionId: string;
+    nodeId: string;
+    status: StepStatus;
+    outputs: StepSlots | null;
+    error: StepError | null;
+}
+export declare class StepNotFoundError extends Error {
+    readonly stepId: string;
+    constructor(stepId: string);
 }
 export interface StepStore {
-    createStep(record: NewStepRecord): Promise<{
+    createSteps(records: NewStepRecord[]): Promise<Array<{
         id: string;
-    }>;
+        nodeId: string;
+    }>>;
+    loadStep(id: string): Promise<StepRecord>;
+    claimStep(id: string): Promise<StepRecord | null>;
+    completeStep(id: string, outputs: StepSlots): Promise<boolean>;
+    failStep(id: string, error: StepError): Promise<boolean>;
+    cancelQueuedSteps(executionId: string): Promise<void>;
+    loadStepOutputs(executionId: string, nodeIds: string[]): Promise<Record<string, StepSlots | null>>;
+    loadCompletedNodeIds(executionId: string, nodeIds: string[]): Promise<Set<string>>;
+    hasActiveSteps(executionId: string): Promise<boolean>;
+    hasFailedSteps(executionId: string): Promise<boolean>;
 }

package/dist/execution/step-store.js

@@ -1,3 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepNotFoundError = void 0;
+class StepNotFoundError extends Error {
+    stepId;
+    constructor(stepId) {
+        super(`Step not found: ${stepId}`);
+        this.stepId = stepId;
+        this.name = 'StepNotFoundError';
+    }
+}
+exports.StepNotFoundError = StepNotFoundError;
 //# sourceMappingURL=step-store.js.map

package/dist/execution/step-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-store.js","sourceRoot":"","sources":["../../src/execution/step-store.ts"],"names":[],"mappings":""}
+{"version":3,"file":"step-store.js","sourceRoot":"","sources":["../../src/execution/step-store.ts"],"names":[],"mappings":";;;AAsCA,uBAA+B,SAAQ,KAAK;IACtB,MAAM;IAA3B,YAAqB,MAAc;QAClC,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;sBADf,MAAM;QAE1B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD"}

package/dist/execution/step-worker.d.ts

@@ -0,0 +1,9 @@
+import type { StepMessage, WorkQueue } from '../queue';
+import type { StepReadyHandler } from './step-ready-handler';
+export declare class StepWorker {
+    private readonly stepQueue;
+    private readonly readyHandler;
+    constructor(stepQueue: WorkQueue<StepMessage>, readyHandler: StepReadyHandler);
+    start(): void;
+    stop(): Promise<void>;
+}

package/dist/execution/step-worker.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepWorker = void 0;
+const common_1 = require("../common");
+class StepWorker {
+    stepQueue;
+    readyHandler;
+    constructor(stepQueue, readyHandler) {
+        this.stepQueue = stepQueue;
+        this.readyHandler = readyHandler;
+    }
+    start() {
+        this.stepQueue.start(async (message) => {
+            switch (message.type) {
+                case 'step:ready':
+                    await this.readyHandler.handle(message);
+                    break;
+                default: {
+                    const unhandled = message.type;
+                    throw new common_1.UnimplementedError(`step worker received an unimplemented message type: ${String(unhandled)}`);
+                }
+            }
+        });
+    }
+    async stop() {
+        await this.stepQueue.stop();
+    }
+}
+exports.StepWorker = StepWorker;
+//# sourceMappingURL=step-worker.js.map

package/dist/execution/step-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-worker.js","sourceRoot":"","sources":["../../src/execution/step-worker.ts"],"names":[],"mappings":";;;AAAA,sCAA+C;AAQ/C;IAEmB,SAAS;IACT,YAAY;IAF9B,YACkB,SAAiC,EACjC,YAA8B;yBAD9B,SAAS;4BACT,YAAY;IAC3B,CAAC;IAEJ,KAAK;QACJ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACtC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;gBACtB,KAAK,YAAY;oBAChB,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACxC,MAAM;gBACP,SAAS,CAAC;oBAGT,MAAM,SAAS,GAAU,OAAO,CAAC,IAAI,CAAC;oBACtC,MAAM,IAAI,2BAAkB,CAC3B,uDAAuD,MAAM,CAAC,SAAS,CAAC,EAAE,CAC1E,CAAC;gBACH,CAAC;YACF,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACT,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;CACD"}

package/dist/execution/validate-step-context.d.ts

@@ -0,0 +1,4 @@
+import type { GraphNode } from '../graph';
+import type { ExecutionRecord } from './execution-store';
+import type { StepRecord } from './step-store';
+export declare function validateStepContext(step: StepRecord, execution: ExecutionRecord): GraphNode;

package/dist/execution/validate-step-context.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateStepContext = validateStepContext;
+const common_1 = require("../common");
+function validateStepContext(step, execution) {
+    if (step.executionId !== execution.id) {
+        throw new common_1.UnexpectedError(`step ${step.id} belongs to execution ${step.executionId}, but the event claims ${execution.id}`);
+    }
+    const node = execution.graph.nodes.find((candidate) => candidate.id === step.nodeId);
+    if (!node) {
+        throw new common_1.UnexpectedError(`step ${step.id} references node ${step.nodeId}, which is absent from the execution graph`);
+    }
+    return node;
+}
+//# sourceMappingURL=validate-step-context.js.map

package/dist/execution/validate-step-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-step-context.js","sourceRoot":"","sources":["../../src/execution/validate-step-context.ts"],"names":[],"mappings":";;;AAAA,sCAA4C;AAY5C,6BAAoC,IAAgB,EAAE,SAA0B;IAC/E,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,wBAAe,CACxB,QAAQ,IAAI,CAAC,EAAE,yBAAyB,IAAI,CAAC,WAAW,0BAA0B,SAAS,CAAC,EAAE,EAAE,CAChG,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IACrF,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,IAAI,wBAAe,CACxB,QAAQ,IAAI,CAAC,EAAE,oBAAoB,IAAI,CAAC,MAAM,4CAA4C,CAC1F,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/graph/index.d.ts

@@ -1 +1,3 @@
 export type { GraphEdge, GraphNode, StepConfig, StepType, WorkflowGraph, } from './workflow-graph';
+export { findTriggerNode, getPredecessorNodeIds, getSuccessorNodeIds, } from './workflow-graph-queries';
+export { GraphValidationError, validateExecutableGraph } from './validate-executable-graph';

package/dist/graph/index.js

@@ -1,3 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateExecutableGraph = exports.GraphValidationError = exports.getSuccessorNodeIds = exports.getPredecessorNodeIds = exports.findTriggerNode = void 0;
+var workflow_graph_queries_1 = require("./workflow-graph-queries");
+Object.defineProperty(exports, "findTriggerNode", { enumerable: true, get: function () { return workflow_graph_queries_1.findTriggerNode; } });
+Object.defineProperty(exports, "getPredecessorNodeIds", { enumerable: true, get: function () { return workflow_graph_queries_1.getPredecessorNodeIds; } });
+Object.defineProperty(exports, "getSuccessorNodeIds", { enumerable: true, get: function () { return workflow_graph_queries_1.getSuccessorNodeIds; } });
+var validate_executable_graph_1 = require("./validate-executable-graph");
+Object.defineProperty(exports, "GraphValidationError", { enumerable: true, get: function () { return validate_executable_graph_1.GraphValidationError; } });
+Object.defineProperty(exports, "validateExecutableGraph", { enumerable: true, get: function () { return validate_executable_graph_1.validateExecutableGraph; } });
 //# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":";;;AAOA,mEAIkC;AAHjC,yHAAA,eAAe,OAAA;AACf,+HAAA,qBAAqB,OAAA;AACrB,6HAAA,mBAAmB,OAAA;AAEpB,yEAA4F;AAAnF,iIAAA,oBAAoB,OAAA;AAAE,oIAAA,uBAAuB,OAAA"}

package/dist/graph/validate-executable-graph.d.ts

@@ -0,0 +1,5 @@
+import type { WorkflowGraph } from './workflow-graph';
+export declare class GraphValidationError extends Error {
+    constructor(message: string);
+}
+export declare function validateExecutableGraph(graph: WorkflowGraph): void;

package/dist/graph/validate-executable-graph.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphValidationError = void 0;
+exports.validateExecutableGraph = validateExecutableGraph;
+const common_1 = require("../common");
+class GraphValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GraphValidationError';
+    }
+}
+exports.GraphValidationError = GraphValidationError;
+function validateExecutableGraph(graph) {
+    const triggers = graph.nodes.filter((node) => node.type === 'trigger');
+    if (triggers.length === 0) {
+        throw new GraphValidationError('Graph has no trigger node to start from');
+    }
+    if (triggers.length > 1) {
+        throw new GraphValidationError('Graph must have exactly one trigger node');
+    }
+    if (graph.edges.some((edge) => edge.isBackEdge)) {
+        throw new common_1.UnimplementedError('Graphs with back-edges (loops) are not supported yet');
+    }
+    for (const edge of graph.edges) {
+        if (edge.outputIndex !== 0) {
+            throw new common_1.UnimplementedError(`Edge ${edge.from} → ${edge.to} leaves output slot ${edge.outputIndex}; only output slot 0 is supported yet`);
+        }
+        if (edge.inputIndex !== 0) {
+            throw new common_1.UnimplementedError(`Edge ${edge.from} → ${edge.to} arrives at input slot ${edge.inputIndex}; only input slot 0 is supported yet`);
+        }
+    }
+    const seenInputSlots = new Set();
+    for (const edge of graph.edges) {
+        const slot = `${edge.to}#${edge.inputIndex}`;
+        if (seenInputSlots.has(slot)) {
+            throw new common_1.UnimplementedError(`Node ${edge.to} has more than one edge into input slot ${edge.inputIndex}; converging branches on one slot is not supported yet`);
+        }
+        seenInputSlots.add(slot);
+    }
+}
+//# sourceMappingURL=validate-executable-graph.js.map

package/dist/graph/validate-executable-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-executable-graph.js","sourceRoot":"","sources":["../../src/graph/validate-executable-graph.ts"],"names":[],"mappings":";;;;AAAA,sCAA+C;AAI/C,0BAAkC,SAAQ,KAAK;IAC9C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD;;AAUD,iCAAwC,KAAoB;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACvE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,oBAAoB,CAAC,yCAAyC,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,oBAAoB,CAAC,0CAA0C,CAAC,CAAC;IAC5E,CAAC;IAID,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,2BAAkB,CAAC,sDAAsD,CAAC,CAAC;IACtF,CAAC;IAID,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,uBAAuB,IAAI,CAAC,WAAW,uCAAuC,CAC5G,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,0BAA0B,IAAI,CAAC,UAAU,sCAAsC,CAC7G,CAAC;QACH,CAAC;IACF,CAAC;IAID,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7C,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,EAAE,2CAA2C,IAAI,CAAC,UAAU,wDAAwD,CACjI,CAAC;QACH,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACF,CAAC"}

package/dist/graph/workflow-graph-queries.d.ts

@@ -0,0 +1,4 @@
+import type { GraphNode, WorkflowGraph } from './workflow-graph';
+export declare function findTriggerNode(graph: WorkflowGraph): GraphNode | undefined;
+export declare function getSuccessorNodeIds(graph: WorkflowGraph, nodeId: string): string[];
+export declare function getPredecessorNodeIds(graph: WorkflowGraph, nodeId: string): string[];

package/dist/graph/workflow-graph-queries.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTriggerNode = findTriggerNode;
+exports.getSuccessorNodeIds = getSuccessorNodeIds;
+exports.getPredecessorNodeIds = getPredecessorNodeIds;
+function findTriggerNode(graph) {
+    return graph.nodes.find((node) => node.type === 'trigger');
+}
+function getSuccessorNodeIds(graph, nodeId) {
+    const successors = [];
+    for (const edge of graph.edges) {
+        if (edge.from === nodeId && !successors.includes(edge.to)) {
+            successors.push(edge.to);
+        }
+    }
+    return successors;
+}
+function getPredecessorNodeIds(graph, nodeId) {
+    const predecessors = [];
+    for (const edge of graph.edges) {
+        if (edge.to === nodeId && !predecessors.includes(edge.from)) {
+            predecessors.push(edge.from);
+        }
+    }
+    return predecessors;
+}
+//# sourceMappingURL=workflow-graph-queries.js.map

package/dist/graph/workflow-graph-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-graph-queries.js","sourceRoot":"","sources":["../../src/graph/workflow-graph-queries.ts"],"names":[],"mappings":";;;;;AAGA,yBAAgC,KAAoB;IACnD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC5D,CAAC;AAOD,6BAAoC,KAAoB,EAAE,MAAc;IACvE,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;IACF,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAOD,+BAAsC,KAAoB,EAAE,MAAc;IACzE,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACF,CAAC;IACD,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/dist/graph/workflow-graph.d.ts

@@ -9,8 +9,8 @@ export interface GraphNode {
 export interface GraphEdge {
     from: string;
     to: string;
-    outputIndex?: number;
-    inputIndex?: number;
+    outputIndex: number;
+    inputIndex: number;
     isBackEdge?: boolean;
 }
 export interface WorkflowGraph {

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export type { ExternalDependencies, IStepExecutor, StepExecutionContext, StepExe
 export { AllowAllAdmittance, AdmittanceRejectedError } from './admittance';
 export type { AdmittanceDecision, AdmittanceRequest, AdmittanceService, } from './admittance';
 export { InMemoryWorkQueue } from './queue';
-export type { ExecutionEnqueuedEvent, WorkQueue, WorkQueueMessage, } from './queue';
-export type { ExecutionMode, ExecutionStatus, ExecutionStore, NewExecutionRecord, NewStepRecord, StepStatus, StepStore, } from './execution';
+export type { ExecutionEnqueuedEvent, OrchestrationMessage, StepCompletedEvent, StepMessage, StepReadyEvent, WorkQueue, } from './queue';
+export { ExecutionNotFoundError, ExecutionStartHandler, OrchestrationWorker, StepCompletedHandler, StepNotFoundError, StepReadyHandler, StepWorker, } from './execution';
+export type { ExecutionMode, ExecutionRecord, ExecutionStatus, ExecutionStore, NewExecutionRecord, NewStepRecord, StepError, StepRecord, StepSlots, StepStatus, StepStore, } from './execution';
 export { createDataSource, TypeOrmExecutionStore, TypeOrmStepStore } from './database';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypeOrmStepStore = exports.TypeOrmExecutionStore = exports.createDataSource = exports.InMemoryWorkQueue = exports.AdmittanceRejectedError = exports.AllowAllAdmittance = exports.createEngineServer = void 0;
+exports.TypeOrmStepStore = exports.TypeOrmExecutionStore = exports.createDataSource = exports.StepWorker = exports.StepReadyHandler = exports.StepNotFoundError = exports.StepCompletedHandler = exports.OrchestrationWorker = exports.ExecutionStartHandler = exports.ExecutionNotFoundError = exports.InMemoryWorkQueue = exports.AdmittanceRejectedError = exports.AllowAllAdmittance = exports.createEngineServer = void 0;
 var server_1 = require("./server");
 Object.defineProperty(exports, "createEngineServer", { enumerable: true, get: function () { return server_1.createEngineServer; } });
 var admittance_1 = require("./admittance");
@@ -8,6 +8,14 @@ Object.defineProperty(exports, "AllowAllAdmittance", { enumerable: true, get: fu
 Object.defineProperty(exports, "AdmittanceRejectedError", { enumerable: true, get: function () { return admittance_1.AdmittanceRejectedError; } });
 var queue_1 = require("./queue");
 Object.defineProperty(exports, "InMemoryWorkQueue", { enumerable: true, get: function () { return queue_1.InMemoryWorkQueue; } });
+var execution_1 = require("./execution");
+Object.defineProperty(exports, "ExecutionNotFoundError", { enumerable: true, get: function () { return execution_1.ExecutionNotFoundError; } });
+Object.defineProperty(exports, "ExecutionStartHandler", { enumerable: true, get: function () { return execution_1.ExecutionStartHandler; } });
+Object.defineProperty(exports, "OrchestrationWorker", { enumerable: true, get: function () { return execution_1.OrchestrationWorker; } });
+Object.defineProperty(exports, "StepCompletedHandler", { enumerable: true, get: function () { return execution_1.StepCompletedHandler; } });
+Object.defineProperty(exports, "StepNotFoundError", { enumerable: true, get: function () { return execution_1.StepNotFoundError; } });
+Object.defineProperty(exports, "StepReadyHandler", { enumerable: true, get: function () { return execution_1.StepReadyHandler; } });
+Object.defineProperty(exports, "StepWorker", { enumerable: true, get: function () { return execution_1.StepWorker; } });
 var database_1 = require("./database");
 Object.defineProperty(exports, "createDataSource", { enumerable: true, get: function () { return database_1.createDataSource; } });
 Object.defineProperty(exports, "TypeOrmExecutionStore", { enumerable: true, get: function () { return database_1.TypeOrmExecutionStore; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA;AAqB3B,2CAA2E;AAAlE,gHAAA,kBAAkB,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAOpD,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAiB1B,uCAAuF;AAA9E,4GAAA,gBAAgB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,4GAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA;AAqB3B,2CAA2E;AAAlE,gHAAA,kBAAkB,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAOpD,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAU1B,yCAQqB;AAPpB,mHAAA,sBAAsB,OAAA;AACtB,kHAAA,qBAAqB,OAAA;AACrB,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA;AACpB,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,uGAAA,UAAU,OAAA;AAgBX,uCAAuF;AAA9E,4GAAA,gBAAgB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,4GAAA,gBAAgB,OAAA"}

package/dist/queue/in-memory-work-queue.d.ts

@@ -1,5 +1,12 @@
-import type { WorkQueue, WorkQueueMessage } from './work-queue.types';
-export declare class InMemoryWorkQueue implements WorkQueue {
-    readonly messages: WorkQueueMessage[];
-    publish(message: WorkQueueMessage): Promise<void>;
+import type { WorkQueue } from './work-queue.types';
+export declare class InMemoryWorkQueue<TMessage> implements WorkQueue<TMessage> {
+    private pending;
+    private handler;
+    private dispatching;
+    private idleWaiters;
+    publish(message: TMessage): Promise<void>;
+    start(handler: (message: TMessage) => Promise<void>): void;
+    stop(): Promise<void>;
+    private startDispatchLoop;
+    private dispatchPending;
 }

package/dist/queue/in-memory-work-queue.js

@@ -2,9 +2,51 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InMemoryWorkQueue = void 0;
 class InMemoryWorkQueue {
-    messages = [];
+    pending = [];
+    handler;
+    dispatching = false;
+    idleWaiters = [];
     async publish(message) {
-        this.messages.push(message);
+        this.pending.push(message);
+        this.startDispatchLoop();
+    }
+    start(handler) {
+        this.handler = handler;
+        this.startDispatchLoop();
+    }
+    async stop() {
+        this.handler = undefined;
+        if (!this.dispatching)
+            return;
+        await new Promise((resolve) => this.idleWaiters.push(resolve));
+    }
+    startDispatchLoop() {
+        if (this.dispatching || !this.handler || this.pending.length === 0)
+            return;
+        this.dispatching = true;
+        this.dispatchPending().catch((error) => {
+            console.error('engine: work queue dispatch failed', error);
+        });
+    }
+    async dispatchPending() {
+        try {
+            while (this.handler && this.pending.length > 0) {
+                const [message] = this.pending.splice(0, 1);
+                try {
+                    await this.handler(message);
+                }
+                catch (error) {
+                    console.error('engine: work queue handler failed', error);
+                }
+            }
+        }
+        finally {
+            this.dispatching = false;
+            const waiters = this.idleWaiters;
+            this.idleWaiters = [];
+            for (const resolve of waiters)
+                resolve();
+        }
     }
 }
 exports.InMemoryWorkQueue = InMemoryWorkQueue;