@xyne/workflow-sdk 1.0.0

package/dist/steps/builtin/loop.step.d.ts

@@ -0,0 +1,100 @@
+/**
+ * LOOP step — iterate over an array and walk a body branch per item.
+ *
+ * BaseControlFlowStep with a single `body` branch. For each item in the
+ * source array, sets `ctx.workflow.steps[loopStepId].currentItem` and walks
+ * the body branch.
+ *
+ * Output: `{ results: unknown[], count: number }`
+ */
+import { z } from 'zod';
+import { BaseControlFlowStep } from '../base-step.js';
+import type { ControlFlowExecutionContext } from '../base-step.js';
+import { BuiltinStepType } from '../../types/known-types.js';
+import type { WorkflowStepConfig } from '../../types/workflow-config.js';
+export declare const LoopStepConfigSchema: z.ZodObject<{
+    source: z.ZodString;
+    body: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    body: z.objectOutputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[];
+    source: string;
+    maxIterations: number;
+}, {
+    body: z.objectInputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[];
+    source: string;
+    maxIterations?: number | undefined;
+}>;
+export type LoopStepConfig = z.infer<typeof LoopStepConfigSchema>;
+export interface LoopStepOutput extends Record<string, unknown> {
+    results: unknown[];
+    count: number;
+}
+export declare class LoopStep extends BaseControlFlowStep<typeof LoopStepConfigSchema, LoopStepOutput> {
+    readonly type = BuiltinStepType.LOOP;
+    readonly name = "Loop";
+    readonly description = "Iterate over an array and execute steps for each item";
+    readonly configSchema: z.ZodObject<{
+        source: z.ZodString;
+        body: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        body: z.objectOutputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        source: string;
+        maxIterations: number;
+    }, {
+        body: z.objectInputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        source: string;
+        maxIterations?: number | undefined;
+    }>;
+    readonly outputSchema: z.ZodObject<{
+        results: z.ZodArray<z.ZodUnknown, "many">;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        results: unknown[];
+        count: number;
+    }, {
+        results: unknown[];
+        count: number;
+    }>;
+    readonly category: "control";
+    readonly branchModel: "iterate";
+    readonly icon = "repeat";
+    readonly declaredOutputs: readonly [{
+        readonly key: "body";
+        readonly label: "For each item";
+    }];
+    getBranches(config: Record<string, unknown>): Record<string, WorkflowStepConfig[]>;
+    execute(config: LoopStepConfig, ctx: ControlFlowExecutionContext): Promise<LoopStepOutput>;
+}
+//# sourceMappingURL=loop.step.d.ts.map

package/dist/steps/builtin/loop.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.step.d.ts","sourceRoot":"","sources":["../../../src/steps/builtin/loop.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAKzE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AASD,qBAAa,QAAS,SAAQ,mBAAmB,CAC/C,OAAO,oBAAoB,EAC3B,cAAc,CACf;IACC,SAAkB,IAAI,wBAAwB;IAC9C,SAAkB,IAAI,UAAU;IAChC,SAAkB,WAAW,2DAA2D;IACxF,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAwB;IACtD,SAAkB,YAAY;;;;;;;;;OAAwB;IACtD,SAAkB,QAAQ,EAAG,SAAS,CAAU;IAChD,SAAkB,WAAW,EAAG,SAAS,CAAU;IACnD,SAAkB,IAAI,YAAY;IAClC,SAAkB,eAAe;;;OAEtB;IAEF,WAAW,CAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAMxB,OAAO,CACpB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,2BAA2B,GAC/B,OAAO,CAAC,cAAc,CAAC;CAkD3B"}

package/dist/steps/builtin/loop.step.js

@@ -0,0 +1,79 @@
+/**
+ * LOOP step — iterate over an array and walk a body branch per item.
+ *
+ * BaseControlFlowStep with a single `body` branch. For each item in the
+ * source array, sets `ctx.workflow.steps[loopStepId].currentItem` and walks
+ * the body branch.
+ *
+ * Output: `{ results: unknown[], count: number }`
+ */
+import { z } from 'zod';
+import { BaseControlFlowStep } from '../base-step.js';
+import { BuiltinStepType } from '../../types/known-types.js';
+import { resolvePath } from '../../engine/variable-resolver.js';
+// ─── Config ───
+export const LoopStepConfigSchema = z.object({
+    source: z.string().min(1).describe('Path to the array to iterate over (e.g. steps.fetch.output.items). Supports {{variable}} refs'),
+    body: z.array(z.object({ id: z.string(), type: z.string() }).passthrough()).describe('Steps to execute for each item in the array'),
+    maxIterations: z.number().int().positive().default(1000).describe('Maximum number of iterations as a safety limit'),
+});
+const LoopStepOutputSchema = z.object({
+    results: z.array(z.unknown()),
+    count: z.number(),
+});
+// ─── Step ───
+export class LoopStep extends BaseControlFlowStep {
+    type = BuiltinStepType.LOOP;
+    name = 'Loop';
+    description = 'Iterate over an array and execute steps for each item';
+    configSchema = LoopStepConfigSchema;
+    outputSchema = LoopStepOutputSchema;
+    category = 'control';
+    branchModel = 'iterate';
+    icon = 'repeat';
+    declaredOutputs = [
+        { key: 'body', label: 'For each item' },
+    ];
+    getBranches(config) {
+        return {
+            body: (config['body'] ?? []),
+        };
+    }
+    async execute(config, ctx) {
+        // Resolve the source array from context
+        const sourceValue = resolvePath(ctx.workflow, config.source);
+        if (!Array.isArray(sourceValue)) {
+            throw new Error(`LOOP source "${config.source}" did not resolve to an array (got ${typeof sourceValue})`);
+        }
+        const items = sourceValue;
+        const limit = Math.min(items.length, config.maxIterations);
+        const results = [];
+        for (let i = 0; i < limit; i++) {
+            const item = items[i];
+            // Expose current item + index in the workflow context for body steps
+            const loopMeta = {
+                currentItem: item,
+                currentIndex: i,
+                totalItems: items.length,
+            };
+            // Store loop metadata in a well-known location
+            const prevMeta = ctx.workflow.steps['__loop'];
+            ctx.workflow.steps['__loop'] = {
+                type: 'LOOP',
+                output: loopMeta,
+            };
+            // Walk the body branch for this item
+            await ctx.walkBranch(config.body, ctx.workflow, 'body');
+            results.push(item);
+            // Restore previous loop metadata (for nested loops)
+            if (prevMeta !== undefined) {
+                ctx.workflow.steps['__loop'] = prevMeta;
+            }
+            else {
+                delete ctx.workflow.steps['__loop'];
+            }
+        }
+        return { results, count: results.length };
+    }
+}
+//# sourceMappingURL=loop.step.js.map

package/dist/steps/builtin/loop.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.step.js","sourceRoot":"","sources":["../../../src/steps/builtin/loop.step.ts"],"names":[],"mappings":"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"}

package/dist/steps/builtin/parallel.step.d.ts

@@ -0,0 +1,208 @@
+/**
+ * PARALLEL step — fan-out N named branches concurrently and collect results.
+ *
+ * BaseControlFlowStep with N dynamic branches. Runs all in parallel via
+ * Promise.allSettled or Promise.race depending on `merge` mode.
+ *
+ * Each branch gets an isolated copy of the workflow context so concurrent
+ * writes to `context.steps` don't conflict. After completion, the last
+ * step's output from each branch is collected into the parallel step's output.
+ *
+ * ## Pause handling (allSettled)
+ *
+ * When branches pause, completed branch results are preserved in the step's
+ * `statePatch` so they survive across resume cycles. On resume, only paused
+ * branches are re-walked — completed branches are restored from saved state.
+ * Multiple branches can be paused simultaneously; each `resume()` call
+ * resolves one branch. When the last paused branch completes, PARALLEL
+ * merges everything and returns.
+ *
+ * PausePath stays linear — it just points to the PARALLEL step. The
+ * per-branch state is managed internally via `statePatch`, keeping the
+ * executor's pause/resume logic completely generic.
+ *
+ * ## Output
+ *
+ * Discriminated union on `mode` so consumers (including the UI)
+ * can switch on `mode` and get full type safety for each case:
+ *
+ *   allSettled: { mode: 'allSettled', branches: { [name]: { status, value?, reason? } } }
+ *   race:       { mode: 'race',       winner: string, result: { output } }
+ */
+import { z } from 'zod';
+import { BaseControlFlowStep } from '../base-step.js';
+import type { ControlFlowExecutionContext } from '../base-step.js';
+import { BuiltinStepType } from '../../types/known-types.js';
+import type { WorkflowStepConfig } from '../../types/workflow-config.js';
+export declare const ParallelStepConfigSchema: z.ZodObject<{
+    branches: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    merge: z.ZodDefault<z.ZodEnum<["allSettled", "race"]>>;
+}, "strip", z.ZodTypeAny, {
+    branches: Record<string, z.objectOutputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[]>;
+    merge: "allSettled" | "race";
+}, {
+    branches: Record<string, z.objectInputType<{
+        id: z.ZodString;
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[]>;
+    merge?: "allSettled" | "race" | undefined;
+}>;
+export type ParallelStepConfig = z.infer<typeof ParallelStepConfigSchema>;
+/** Per-branch result wrapper (used in race output). */
+export interface ParallelBranchResult {
+    output: Record<string, unknown>;
+}
+/** Per-branch result in 'allSettled' mode — mirrors PromiseSettledResult. */
+export type ParallelSettledBranchResult = {
+    status: 'fulfilled';
+    value: Record<string, unknown>;
+} | {
+    status: 'rejected';
+    reason: string;
+};
+export interface ParallelAllSettledOutput extends Record<string, unknown> {
+    mode: 'allSettled';
+    branches: Record<string, ParallelSettledBranchResult>;
+}
+export interface ParallelRaceOutput extends Record<string, unknown> {
+    mode: 'race';
+    winner: string;
+    result: ParallelBranchResult;
+}
+export type ParallelStepOutput = ParallelAllSettledOutput | ParallelRaceOutput;
+export declare class ParallelStep extends BaseControlFlowStep<typeof ParallelStepConfigSchema, ParallelStepOutput> {
+    readonly type = BuiltinStepType.PARALLEL;
+    readonly name = "Parallel";
+    readonly description = "Run multiple branches concurrently and collect results";
+    readonly configSchema: z.ZodObject<{
+        branches: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">>;
+        merge: z.ZodDefault<z.ZodEnum<["allSettled", "race"]>>;
+    }, "strip", z.ZodTypeAny, {
+        branches: Record<string, z.objectOutputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[]>;
+        merge: "allSettled" | "race";
+    }, {
+        branches: Record<string, z.objectInputType<{
+            id: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[]>;
+        merge?: "allSettled" | "race" | undefined;
+    }>;
+    readonly outputSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"allSettled">;
+        branches: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+            status: z.ZodLiteral<"fulfilled">;
+            value: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            value: Record<string, unknown>;
+            status: "fulfilled";
+        }, {
+            value: Record<string, unknown>;
+            status: "fulfilled";
+        }>, z.ZodObject<{
+            status: z.ZodLiteral<"rejected">;
+            reason: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "rejected";
+            reason: string;
+        }, {
+            status: "rejected";
+            reason: string;
+        }>]>>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "allSettled";
+        branches: Record<string, {
+            value: Record<string, unknown>;
+            status: "fulfilled";
+        } | {
+            status: "rejected";
+            reason: string;
+        }>;
+    }, {
+        mode: "allSettled";
+        branches: Record<string, {
+            value: Record<string, unknown>;
+            status: "fulfilled";
+        } | {
+            status: "rejected";
+            reason: string;
+        }>;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"race">;
+        winner: z.ZodString;
+        result: z.ZodObject<{
+            output: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            output: Record<string, unknown>;
+        }, {
+            output: Record<string, unknown>;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        result: {
+            output: Record<string, unknown>;
+        };
+        mode: "race";
+        winner: string;
+    }, {
+        result: {
+            output: Record<string, unknown>;
+        };
+        mode: "race";
+        winner: string;
+    }>]>;
+    readonly category: "control";
+    readonly icon = "columns";
+    /**
+     * Declared outputs are dynamic — one per branch key.
+     * Since branch keys are user-defined, we return empty here and let
+     * `getBranches()` handle discovery for validation.
+     */
+    readonly declaredOutputs: readonly [];
+    getBranches(config: Record<string, unknown>): Record<string, WorkflowStepConfig[]>;
+    execute(config: ParallelStepConfig, ctx: ControlFlowExecutionContext): Promise<ParallelStepOutput>;
+    private executeAllSettled;
+    private executeRace;
+    /**
+     * Load saved parallel state from a prior pause cycle.
+     *
+     * On resume, the executor hydrates `context.steps[stepId]` from the
+     * persisted step row (which includes our statePatch). We check for
+     * `__parallelState` in that entry to restore completed branch results.
+     */
+    private loadSavedState;
+    /**
+     * Create an isolated copy of the workflow context for a branch.
+     * Shares trigger and workflow identity, but each branch gets its own
+     * steps map so concurrent writes don't conflict.
+     */
+    private cloneContext;
+    /**
+     * Extract the output of the last step in a branch from its context.
+     * Returns the full output record, or an empty object if the branch has no steps.
+     */
+    private extractLastStepOutput;
+}
+//# sourceMappingURL=parallel.step.d.ts.map

package/dist/steps/builtin/parallel.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.step.d.ts","sourceRoot":"","sources":["../../../src/steps/builtin/parallel.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAMzE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,6EAA6E;AAC7E,MAAM,MAAM,2BAA2B,GACnC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,MAAM,WAAW,wBAAyB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAC1B,wBAAwB,GACxB,kBAAkB,CAAC;AA8CvB,qBAAa,YAAa,SAAQ,mBAAmB,CACnD,OAAO,wBAAwB,EAC/B,kBAAkB,CACnB;IACC,SAAkB,IAAI,4BAA4B;IAClD,SAAkB,IAAI,cAAc;IACpC,SAAkB,WAAW,4DAC8B;IAC3D,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;OAA4B;IAC1D,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAA4B;IAC1D,SAAkB,QAAQ,EAAG,SAAS,CAAU;IAChD,SAAkB,IAAI,aAAa;IAEnC;;;;OAIG;IACH,SAAkB,eAAe,cAAe;IAEvC,WAAW,CAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAYxB,OAAO,CACpB,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,2BAA2B,GAC/B,OAAO,CAAC,kBAAkB,CAAC;YAgBhB,iBAAiB;YAwGjB,WAAW;IA+BzB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAetB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAYpB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAc9B"}

package/dist/steps/builtin/parallel.step.js

@@ -0,0 +1,249 @@
+/**
+ * PARALLEL step — fan-out N named branches concurrently and collect results.
+ *
+ * BaseControlFlowStep with N dynamic branches. Runs all in parallel via
+ * Promise.allSettled or Promise.race depending on `merge` mode.
+ *
+ * Each branch gets an isolated copy of the workflow context so concurrent
+ * writes to `context.steps` don't conflict. After completion, the last
+ * step's output from each branch is collected into the parallel step's output.
+ *
+ * ## Pause handling (allSettled)
+ *
+ * When branches pause, completed branch results are preserved in the step's
+ * `statePatch` so they survive across resume cycles. On resume, only paused
+ * branches are re-walked — completed branches are restored from saved state.
+ * Multiple branches can be paused simultaneously; each `resume()` call
+ * resolves one branch. When the last paused branch completes, PARALLEL
+ * merges everything and returns.
+ *
+ * PausePath stays linear — it just points to the PARALLEL step. The
+ * per-branch state is managed internally via `statePatch`, keeping the
+ * executor's pause/resume logic completely generic.
+ *
+ * ## Output
+ *
+ * Discriminated union on `mode` so consumers (including the UI)
+ * can switch on `mode` and get full type safety for each case:
+ *
+ *   allSettled: { mode: 'allSettled', branches: { [name]: { status, value?, reason? } } }
+ *   race:       { mode: 'race',       winner: string, result: { output } }
+ */
+import { z } from 'zod';
+import { BaseControlFlowStep } from '../base-step.js';
+import { BuiltinStepType } from '../../types/known-types.js';
+import { PauseStep } from '../../engine/pause-step.js';
+// ─── Config ───
+export const ParallelStepConfigSchema = z.object({
+    branches: z.record(z.string(), z.array(z.object({ id: z.string(), type: z.string() }).passthrough())).describe('Named branches that execute concurrently. Each key is a branch name, value is the steps to run'),
+    merge: z.enum(['allSettled', 'race']).default('allSettled').describe('How to combine branch results: allSettled waits for all, race returns first completed'),
+});
+// ─── Output Zod schema (for validation / introspection) ───
+const ParallelBranchResultSchema = z.object({
+    output: z.record(z.unknown()),
+});
+const ParallelSettledBranchResultSchema = z.discriminatedUnion('status', [
+    z.object({
+        status: z.literal('fulfilled'),
+        value: z.record(z.unknown()),
+    }),
+    z.object({
+        status: z.literal('rejected'),
+        reason: z.string(),
+    }),
+]);
+const ParallelStepOutputSchema = z.discriminatedUnion('mode', [
+    z.object({
+        mode: z.literal('allSettled'),
+        branches: z.record(ParallelSettledBranchResultSchema),
+    }),
+    z.object({
+        mode: z.literal('race'),
+        winner: z.string(),
+        result: ParallelBranchResultSchema,
+    }),
+]);
+// ─── Step ───
+export class ParallelStep extends BaseControlFlowStep {
+    type = BuiltinStepType.PARALLEL;
+    name = 'Parallel';
+    description = 'Run multiple branches concurrently and collect results';
+    configSchema = ParallelStepConfigSchema;
+    outputSchema = ParallelStepOutputSchema;
+    category = 'control';
+    icon = 'columns';
+    /**
+     * Declared outputs are dynamic — one per branch key.
+     * Since branch keys are user-defined, we return empty here and let
+     * `getBranches()` handle discovery for validation.
+     */
+    declaredOutputs = [];
+    getBranches(config) {
+        const branches = (config['branches'] ?? {});
+        const result = {};
+        for (const [key, steps] of Object.entries(branches)) {
+            result[key] = steps;
+        }
+        return result;
+    }
+    async execute(config, ctx) {
+        const branchEntries = Object.entries(config.branches);
+        if (branchEntries.length === 0) {
+            return { mode: config.merge, branches: {} };
+        }
+        if (config.merge === 'allSettled') {
+            return this.executeAllSettled(branchEntries, ctx);
+        }
+        // race
+        return this.executeRace(branchEntries, ctx);
+    }
+    // ─── Merge: allSettled ───
+    async executeAllSettled(branchEntries, ctx) {
+        // Check for saved state from a prior pause (resume path)
+        const savedState = this.loadSavedState(ctx);
+        // Determine which branches still need to run
+        const toRun = [];
+        const branches = {};
+        for (const [name, steps] of branchEntries) {
+            if (savedState?.completedBranches[name]) {
+                // Already completed in a prior run — restore result
+                branches[name] = savedState.completedBranches[name];
+            }
+            else {
+                toRun.push([name, steps]);
+            }
+        }
+        if (toRun.length === 0) {
+            return { mode: 'allSettled', branches };
+        }
+        // Run remaining branches concurrently
+        const promises = toRun.map(async ([name, steps]) => {
+            const branchCtx = this.cloneContext(ctx.workflow);
+            await ctx.walkBranch(steps, branchCtx, name);
+            return {
+                name,
+                output: this.extractLastStepOutput(steps, branchCtx),
+            };
+        });
+        const settled = await Promise.allSettled(promises);
+        // Separate results: completed (fulfilled/rejected) vs paused
+        const pausedBranches = {};
+        for (let i = 0; i < toRun.length; i++) {
+            const name = toRun[i][0];
+            const entry = settled[i];
+            if (entry.status === 'fulfilled') {
+                branches[name] = {
+                    status: 'fulfilled',
+                    value: entry.value.output,
+                };
+            }
+            else if (PauseStep.is(entry.reason)) {
+                const pe = entry.reason;
+                pausedBranches[name] = {
+                    reason: pe.message,
+                    ...(pe.externalRef !== undefined
+                        ? { externalRef: pe.externalRef }
+                        : {}),
+                };
+            }
+            else {
+                branches[name] = {
+                    status: 'rejected',
+                    reason: entry.reason instanceof Error
+                        ? entry.reason.message
+                        : String(entry.reason),
+                };
+            }
+        }
+        // If any branches paused, save completed state and re-throw
+        if (Object.keys(pausedBranches).length > 0) {
+            const state = {
+                completedBranches: branches,
+                pausedBranches,
+            };
+            // Pick the first paused branch's details for the PauseStep
+            const firstPaused = Object.values(pausedBranches)[0];
+            const pauseReason = Object.keys(pausedBranches).length === 1
+                ? firstPaused.reason
+                : `${String(Object.keys(pausedBranches).length)} branches paused`;
+            const opts = {
+                statePatch: { __parallelState: state },
+            };
+            if (firstPaused.externalRef !== undefined) {
+                opts.externalRef = firstPaused.externalRef;
+            }
+            throw new PauseStep(pauseReason, opts);
+        }
+        return { mode: 'allSettled', branches };
+    }
+    // ─── Merge: race ───
+    async executeRace(branchEntries, ctx) {
+        const promises = branchEntries.map(async ([name, steps]) => {
+            const branchCtx = this.cloneContext(ctx.workflow);
+            await ctx.walkBranch(steps, branchCtx, name);
+            return {
+                name,
+                output: this.extractLastStepOutput(steps, branchCtx),
+            };
+        });
+        const winner = await Promise.race(promises);
+        return {
+            mode: 'race',
+            winner: winner.name,
+            result: { output: winner.output },
+        };
+    }
+    // ─── Helpers ───
+    /**
+     * Load saved parallel state from a prior pause cycle.
+     *
+     * On resume, the executor hydrates `context.steps[stepId]` from the
+     * persisted step row (which includes our statePatch). We check for
+     * `__parallelState` in that entry to restore completed branch results.
+     */
+    loadSavedState(ctx) {
+        if (!ctx.runtime.isResuming)
+            return null;
+        const stepId = ctx.runtime.stepId;
+        const entry = ctx.workflow.steps[stepId];
+        if (!entry)
+            return null;
+        const raw = entry['__parallelState'];
+        if (!raw || typeof raw !== 'object')
+            return null;
+        return raw;
+    }
+    /**
+     * Create an isolated copy of the workflow context for a branch.
+     * Shares trigger and workflow identity, but each branch gets its own
+     * steps map so concurrent writes don't conflict.
+     */
+    cloneContext(parent) {
+        const clone = {
+            workflow: parent.workflow,
+            trigger: parent.trigger,
+            steps: { ...parent.steps },
+        };
+        if (parent.__meta !== undefined) {
+            clone.__meta = parent.__meta;
+        }
+        return clone;
+    }
+    /**
+     * Extract the output of the last step in a branch from its context.
+     * Returns the full output record, or an empty object if the branch has no steps.
+     */
+    extractLastStepOutput(steps, branchCtx) {
+        if (steps.length === 0)
+            return {};
+        for (let i = steps.length - 1; i >= 0; i--) {
+            const stepId = steps[i].id;
+            const entry = branchCtx.steps[stepId];
+            if (entry?.output) {
+                return entry.output;
+            }
+        }
+        return {};
+    }
+}
+//# sourceMappingURL=parallel.step.js.map

package/dist/steps/builtin/parallel.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.step.js","sourceRoot":"","sources":["../../../src/steps/builtin/parallel.step.ts"],"names":[],"mappings":"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"}