@xyne/workflow-sdk 1.0.0

package/dist/engine/available-context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * getAvailableContext — computes the variable context available at a given step.
+ *
+ * Pure function: takes the workflow config + registries, returns a map of
+ * JSON Schema objects keyed by dotted path (e.g. "trigger", "steps.fetch_data.output").
+ * The frontend's variable picker uses this to show what refs are available at each step.
+ */
+import type { WorkflowConfig } from '../types/workflow-config.js';
+import type { StepRegistry } from '../steps/step-registry.js';
+import type { TriggerRegistry } from '../triggers/trigger-registry.js';
+export interface AvailableContext {
+    /**
+     * Map of context path → JSON Schema.
+     *
+     * Keys use the same dotted-path convention as variable refs:
+     * - `"trigger"` — the trigger's output schema
+     * - `"steps.<stepId>.output"` — a preceding step's output schema
+     */
+    [path: string]: Record<string, unknown>;
+}
+/**
+ * Compute the available variable context at a given step in the workflow.
+ *
+ * Returns a map of path → JSON Schema for the trigger output and all
+ * preceding step outputs. Returns `null` if `atStepId` is not found
+ * anywhere in the step tree.
+ */
+export declare function getAvailableContext(config: WorkflowConfig, atStepId: string, steps: StepRegistry, triggers: TriggerRegistry): AvailableContext | null;
+//# sourceMappingURL=available-context.d.ts.map

package/dist/engine/available-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"available-context.d.ts","sourceRoot":"","sources":["../../src/engine/available-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIvE,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,eAAe,GACxB,gBAAgB,GAAG,IAAI,CAkBzB"}

package/dist/engine/available-context.js

@@ -0,0 +1,66 @@
+/**
+ * getAvailableContext — computes the variable context available at a given step.
+ *
+ * Pure function: takes the workflow config + registries, returns a map of
+ * JSON Schema objects keyed by dotted path (e.g. "trigger", "steps.fetch_data.output").
+ * The frontend's variable picker uses this to show what refs are available at each step.
+ */
+import { BaseControlFlowStep } from '../steps/base-step.js';
+import { zodToJsonSchemaRecord } from '../util/schema-convert.js';
+/**
+ * Compute the available variable context at a given step in the workflow.
+ *
+ * Returns a map of path → JSON Schema for the trigger output and all
+ * preceding step outputs. Returns `null` if `atStepId` is not found
+ * anywhere in the step tree.
+ */
+export function getAvailableContext(config, atStepId, steps, triggers) {
+    const ctx = {};
+    // Add trigger output if registered. Use the trigger's per-instance
+    // `resolveOutputJsonSchema(config)` when available (lets webhook /
+    // manual triggers type headers/body/query from author-supplied schemas);
+    // otherwise fall back to the static outputSchema.
+    if (config.trigger && triggers.has(config.trigger.type)) {
+        const triggerImpl = triggers.get(config.trigger.type);
+        ctx['trigger'] = triggerImpl.resolveOutputJsonSchema
+            ? triggerImpl.resolveOutputJsonSchema((config.trigger.config ?? {}))
+            : zodToJsonSchemaRecord(triggerImpl.outputSchema);
+    }
+    const found = walkForContext(config.steps, atStepId, ctx, steps);
+    return found ? ctx : null;
+}
+/**
+ * Walk steps in order. Returns true if `targetId` was found (meaning ctx is populated).
+ * Stops as soon as the target is found — no further steps are added.
+ */
+function walkForContext(stepList, targetId, ctx, steps) {
+    for (const step of stepList) {
+        // If this is the target step, stop — don't include its own output
+        if (step.id === targetId) {
+            return true;
+        }
+        // Register this step's output schema if registered
+        if (steps.has(step.type)) {
+            const impl = steps.get(step.type);
+            ctx[`steps.${step.id}.output`] = impl.resolveOutputJsonSchema
+                ? impl.resolveOutputJsonSchema(step.config)
+                : zodToJsonSchemaRecord(impl.outputSchema);
+            // Recurse into control-flow branches
+            if (impl instanceof BaseControlFlowStep && impl.getBranches) {
+                const branches = impl.getBranches(step.config);
+                for (const branchSteps of Object.values(branches)) {
+                    // Branch gets a snapshot of current context — steps inside a branch
+                    // shouldn't leak to sibling branches
+                    const branchCtx = { ...ctx };
+                    if (walkForContext(branchSteps, targetId, branchCtx, steps)) {
+                        // Found inside this branch — copy back accumulated context
+                        Object.assign(ctx, branchCtx);
+                        return true;
+                    }
+                }
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=available-context.js.map

package/dist/engine/available-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"available-context.js","sourceRoot":"","sources":["../../src/engine/available-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAalE;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAsB,EACtB,QAAgB,EAChB,KAAmB,EACnB,QAAyB;IAEzB,MAAM,GAAG,GAAqB,EAAE,CAAC;IAEjC,mEAAmE;IACnE,mEAAmE;IACnE,yEAAyE;IACzE,kDAAkD;IAClD,IAAI,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,GAAG,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,uBAAuB;YAClD,CAAC,CAAC,WAAW,CAAC,uBAAuB,CACjC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAA4B,CACzD;YACH,CAAC,CAAC,qBAAqB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CACrB,QAA8B,EAC9B,QAAgB,EAChB,GAAqB,EACrB,KAAmB;IAEnB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,kEAAkE;QAClE,IAAI,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mDAAmD;QACnD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,GAAG,CAAC,SAAS,IAAI,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,uBAAuB;gBAC3D,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAiC,CAAC;gBACtE,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAE7C,qCAAqC;YACrC,IAAI,IAAI,YAAY,mBAAmB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAC/B,IAAI,CAAC,MAAiC,CACvC,CAAC;gBACF,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAClD,oEAAoE;oBACpE,qCAAqC;oBACrC,MAAM,SAAS,GAAqB,EAAE,GAAG,GAAG,EAAE,CAAC;oBAC/C,IAAI,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;wBAC5D,2DAA2D;wBAC3D,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;wBAC9B,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/engine/condition-evaluator.d.ts

@@ -0,0 +1,13 @@
+import type { Condition } from '../types/workflow-config.js';
+import type { WorkflowContext } from '../types/context.js';
+/**
+ * Evaluates a recursive Condition tree against a WorkflowContext.
+ *
+ * - Leaf: resolves the variable, applies the operator
+ * - `all`: short-circuit AND (all children must be true)
+ * - `any`: short-circuit OR (any child must be true)
+ */
+export declare class ConditionEvaluator {
+    evaluate(condition: Condition, context: WorkflowContext): boolean;
+}
+//# sourceMappingURL=condition-evaluator.d.ts.map

package/dist/engine/condition-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-evaluator.d.ts","sourceRoot":"","sources":["../../src/engine/condition-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAwF3D;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO;CAoBlE"}

package/dist/engine/condition-evaluator.js

@@ -0,0 +1,92 @@
+import { ConditionOperator } from '../types/operators.js';
+import { extractRefPath } from '../util/variable-ref.js';
+import { resolvePath } from './variable-resolver.js';
+function looseEquals(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || a === undefined)
+        return b === null || b === undefined;
+    if (b === null || b === undefined)
+        return false;
+    if (typeof a === 'number' && typeof b === 'string')
+        return a === Number(b);
+    if (typeof a === 'string' && typeof b === 'number')
+        return Number(a) === b;
+    if (typeof a === 'boolean' || typeof b === 'boolean')
+        return Number(a) === Number(b);
+    return false;
+}
+function applyOperator(operator, resolved, refValue) {
+    switch (operator) {
+        case ConditionOperator.EXISTS:
+            return resolved !== undefined && resolved !== null;
+        case ConditionOperator.EQ:
+            return looseEquals(resolved, refValue);
+        case ConditionOperator.NEQ:
+            return !looseEquals(resolved, refValue);
+        case ConditionOperator.CONTAINS:
+            if (typeof resolved === 'string' && typeof refValue === 'string') {
+                return resolved.includes(refValue);
+            }
+            if (Array.isArray(resolved))
+                return resolved.includes(refValue);
+            return false;
+        case ConditionOperator.GT:
+            return (resolved !== undefined &&
+                resolved !== null &&
+                resolved > refValue);
+        case ConditionOperator.GTE:
+            return (resolved !== undefined &&
+                resolved !== null &&
+                resolved >= refValue);
+        case ConditionOperator.LT:
+            return (resolved !== undefined &&
+                resolved !== null &&
+                resolved < refValue);
+        case ConditionOperator.LTE:
+            return (resolved !== undefined &&
+                resolved !== null &&
+                resolved <= refValue);
+        default:
+            throw new Error(`Unhandled ConditionOperator: ${String(operator)}`);
+    }
+}
+function resolveVariable(variable, context) {
+    const path = extractRefPath(variable);
+    if (!path)
+        return undefined;
+    return resolvePath(context, path);
+}
+function evaluateLeaf(leaf, context) {
+    return applyOperator(leaf.operator, resolveVariable(leaf.variable, context), leaf.value);
+}
+/**
+ * Evaluates a recursive Condition tree against a WorkflowContext.
+ *
+ * - Leaf: resolves the variable, applies the operator
+ * - `all`: short-circuit AND (all children must be true)
+ * - `any`: short-circuit OR (any child must be true)
+ */
+export class ConditionEvaluator {
+    evaluate(condition, context) {
+        if ('variable' in condition && 'operator' in condition) {
+            return evaluateLeaf(condition, context);
+        }
+        if ('all' in condition) {
+            for (const child of condition.all) {
+                if (!this.evaluate(child, context))
+                    return false;
+            }
+            return true;
+        }
+        if ('any' in condition) {
+            for (const child of condition.any) {
+                if (this.evaluate(child, context))
+                    return true;
+            }
+            return false;
+        }
+        throw new Error(`Unrecognised condition shape: ${JSON.stringify(condition)}`);
+    }
+}
+//# sourceMappingURL=condition-evaluator.js.map

package/dist/engine/condition-evaluator.js.map

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

package/dist/engine/config-validator.d.ts

@@ -0,0 +1,25 @@
+import type { WorkflowConfig } from '../types/workflow-config.js';
+import type { ValidationResult } from '../types/validation.js';
+import type { TriggerRegistry } from '../triggers/trigger-registry.js';
+import type { StepRegistry } from '../steps/step-registry.js';
+/**
+ * Validates a complete WorkflowConfig against registered triggers and steps.
+ *
+ * Checks:
+ * 1. Trigger type is registered + config validates against trigger schema
+ * 2. Step types are registered + configs validate against step schemas
+ * 3. Variable references (`{{...}}`) are resolvable (not forward refs, path exists)
+ * 4. Type compatibility between ref source and consumer schema
+ * 5. Control-flow branches are recursively validated via `getBranches()`
+ */
+export declare class ConfigValidator {
+    private readonly triggerRegistry;
+    private readonly stepRegistry;
+    constructor(triggerRegistry: TriggerRegistry, stepRegistry: StepRegistry);
+    validate(config: WorkflowConfig): ValidationResult;
+    private walkSteps;
+    private validateRefs;
+    private checkRef;
+    private getConsumerInnerSchema;
+}
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/engine/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../src/engine/config-validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAyI9D;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY;IAG7C,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB;IAqClD,OAAO,CAAC,SAAS;IA8EjB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,QAAQ;IAgFhB,OAAO,CAAC,sBAAsB;CAmB/B"}

package/dist/engine/config-validator.js

@@ -0,0 +1,316 @@
+import { z } from 'zod';
+import { getVariableRefInnerSchema } from '../types/workflow-config.js';
+import { ValidationIssueCode } from '../types/validation.js';
+import { BaseControlFlowStep } from '../steps/base-step.js';
+import { collectRefs } from '../util/variable-ref.js';
+const FORBIDDEN_KEYS = new Set([
+    '__proto__',
+    'constructor',
+    'prototype',
+]);
+// ─── Schema walking utilities ───
+function walkSchemaPath(schema, segments) {
+    if (segments.some((s) => FORBIDDEN_KEYS.has(s)))
+        return null;
+    let current = schema;
+    for (const segment of segments) {
+        current = unwrapOptional(current);
+        if (current instanceof z.ZodObject) {
+            const next = current.shape[segment];
+            if (next) {
+                current = next;
+            }
+            else {
+                const def = current._def;
+                if (def.unknownKeys === 'passthrough') {
+                    current = z.unknown();
+                }
+                else if (def.catchall && !(def.catchall instanceof z.ZodNever)) {
+                    current = def.catchall;
+                }
+                else {
+                    return null;
+                }
+            }
+        }
+        else if (current instanceof z.ZodArray) {
+            if (/^\d+$/.test(segment) || segment === '*') {
+                current = current._def.type;
+            }
+            else {
+                return null;
+            }
+        }
+        else if (current instanceof z.ZodRecord) {
+            current = current._def
+                .valueType;
+        }
+        else if (current instanceof z.ZodUnion) {
+            const options = current._def.options;
+            const walked = walkSchemaPath(options[0], [segment]);
+            if (!walked)
+                return null;
+            current = walked;
+        }
+        else if (current instanceof z.ZodLazy) {
+            const inner = current._def.getter();
+            const walked = walkSchemaPath(inner, [segment]);
+            if (!walked)
+                return null;
+            current = walked;
+        }
+        else {
+            return null;
+        }
+    }
+    return unwrapOptional(current);
+}
+function unwrapOptional(schema) {
+    let current = schema;
+    while (current instanceof z.ZodOptional ||
+        current instanceof z.ZodNullable ||
+        current instanceof z.ZodDefault) {
+        current = current._def.innerType;
+    }
+    return current;
+}
+// ─── Type compatibility ───
+const SCALAR_LIKE_ZOD_TYPES = new Set([
+    'ZodString',
+    'ZodNumber',
+    'ZodBigInt',
+    'ZodBoolean',
+    'ZodDate',
+    'ZodEnum',
+    'ZodNativeEnum',
+    'ZodLiteral',
+]);
+function isZodCompatible(upstream, consumer) {
+    if (consumer instanceof z.ZodUnknown || consumer instanceof z.ZodAny)
+        return true;
+    if (upstream instanceof z.ZodUnknown || upstream instanceof z.ZodAny)
+        return true;
+    const upType = upstream._def.typeName;
+    const conType = consumer._def.typeName;
+    if (upType === conType)
+        return true;
+    if (SCALAR_LIKE_ZOD_TYPES.has(upType) && SCALAR_LIKE_ZOD_TYPES.has(conType))
+        return true;
+    // Anything can be coerced to string in a template
+    if (conType === 'ZodString')
+        return true;
+    return false;
+}
+const ZOD_HUMAN_TYPE = {
+    ZodString: 'text',
+    ZodNumber: 'number',
+    ZodBigInt: 'number',
+    ZodBoolean: 'true/false',
+    ZodDate: 'date',
+    ZodArray: 'list',
+    ZodObject: 'object',
+    ZodEnum: 'option',
+    ZodNativeEnum: 'option',
+    ZodLiteral: 'fixed value',
+    ZodUnion: 'value',
+    ZodRecord: 'object',
+};
+function humanZodType(schema) {
+    const name = schema._def.typeName;
+    return ZOD_HUMAN_TYPE[name] ?? 'value';
+}
+// ─── ConfigValidator ───
+/**
+ * Validates a complete WorkflowConfig against registered triggers and steps.
+ *
+ * Checks:
+ * 1. Trigger type is registered + config validates against trigger schema
+ * 2. Step types are registered + configs validate against step schemas
+ * 3. Variable references (`{{...}}`) are resolvable (not forward refs, path exists)
+ * 4. Type compatibility between ref source and consumer schema
+ * 5. Control-flow branches are recursively validated via `getBranches()`
+ */
+export class ConfigValidator {
+    triggerRegistry;
+    stepRegistry;
+    constructor(triggerRegistry, stepRegistry) {
+        this.triggerRegistry = triggerRegistry;
+        this.stepRegistry = stepRegistry;
+    }
+    validate(config) {
+        const issues = [];
+        const outputSchemas = new Map();
+        // --- Trigger validation ---
+        if (config.trigger) {
+            if (!this.triggerRegistry.has(config.trigger.type)) {
+                issues.push({
+                    path: 'trigger.type',
+                    code: ValidationIssueCode.SHAPE,
+                    message: `Unknown trigger type "${config.trigger.type}". Is it registered?`,
+                });
+            }
+            else {
+                const triggerImpl = this.triggerRegistry.get(config.trigger.type);
+                const result = triggerImpl.configSchema.safeParse(config.trigger.config);
+                if (!result.success) {
+                    for (const issue of result.error.issues) {
+                        issues.push({
+                            path: `trigger.config.${issue.path.join('.')}`,
+                            code: ValidationIssueCode.SHAPE,
+                            message: issue.message,
+                        });
+                    }
+                }
+                outputSchemas.set('trigger', triggerImpl.outputSchema);
+            }
+        }
+        // --- Steps validation ---
+        const seenIds = new Set();
+        this.walkSteps(config.steps, 'steps', outputSchemas, issues, seenIds);
+        return { valid: issues.length === 0, issues };
+    }
+    walkSteps(steps, prefix, outputSchemas, issues, seenIds) {
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            const stepPath = `${prefix}[${i}]`;
+            // Check for duplicate step IDs across the entire config tree
+            if (seenIds.has(step.id)) {
+                issues.push({
+                    path: `${stepPath}.id`,
+                    code: ValidationIssueCode.DUPLICATE_STEP_ID,
+                    message: `Duplicate step ID "${step.id}". Step IDs must be unique across the entire workflow, including nested branches.`,
+                });
+            }
+            seenIds.add(step.id);
+            if (!this.stepRegistry.has(step.type)) {
+                issues.push({
+                    path: `${stepPath}.type`,
+                    code: ValidationIssueCode.SHAPE,
+                    message: `Unknown step type "${step.type}". Is it registered?`,
+                });
+                continue;
+            }
+            const stepImpl = this.stepRegistry.get(step.type);
+            // Shape validation
+            const shapeResult = stepImpl.configSchema.safeParse(step.config);
+            if (!shapeResult.success) {
+                for (const issue of shapeResult.error.issues) {
+                    issues.push({
+                        path: `${stepPath}.config.${issue.path.join('.')}`,
+                        code: ValidationIssueCode.SHAPE,
+                        message: issue.message,
+                    });
+                }
+            }
+            // Ref validation for action steps
+            this.validateRefs(step.config, `${stepPath}.config`, stepImpl.configSchema, outputSchemas, issues);
+            // Register this step's output schema
+            outputSchemas.set(`${step.id}.input`, stepImpl.configSchema);
+            outputSchemas.set(`${step.id}.output`, stepImpl.outputSchema);
+            // Control-flow branch discovery via getBranches()
+            if (stepImpl instanceof BaseControlFlowStep &&
+                stepImpl.getBranches) {
+                const branches = stepImpl.getBranches(step.config);
+                for (const [branchKey, branchSteps] of Object.entries(branches)) {
+                    this.walkSteps(branchSteps, `${stepPath}.config.${branchKey}`, new Map(outputSchemas), issues, seenIds);
+                }
+            }
+        }
+    }
+    validateRefs(config, prefix, configSchema, outputSchemas, issues) {
+        for (const { refPath, location } of collectRefs(config, prefix)) {
+            const consumerInner = this.getConsumerInnerSchema(configSchema, location, prefix);
+            this.checkRef(`{{context.${refPath}}}`, location, outputSchemas, issues, consumerInner);
+        }
+    }
+    checkRef(refString, location, outputSchemas, issues, consumerInnerSchema) {
+        const inner = refString.match(/^\{\{(?:context\.)?([^}]+)\}\}$/);
+        if (!inner?.[1])
+            return;
+        const refPath = inner[1];
+        const segments = refPath.split('.');
+        const sourceKey = segments[0];
+        if (!sourceKey)
+            return;
+        let resolverKey;
+        let pathSegments;
+        if (sourceKey === 'trigger') {
+            resolverKey = 'trigger';
+            pathSegments = segments.slice(1);
+        }
+        else if (sourceKey === 'workflow') {
+            // workflow.id, workflow.metadata.x — not validatable against output schemas
+            return;
+        }
+        else if (sourceKey === 'steps') {
+            // Explicit: steps.stepId.output.field
+            const stepId = segments[1];
+            const role = segments[2];
+            if (!stepId)
+                return;
+            if (role === 'input' || role === 'output') {
+                resolverKey = `${stepId}.${role}`;
+                pathSegments = segments.slice(3);
+            }
+            else {
+                resolverKey = `${stepId}.output`;
+                pathSegments = segments.slice(2);
+            }
+        }
+        else {
+            // Shorthand: stepId.output.field or stepId.field
+            const role = segments[1];
+            if (role === 'input' || role === 'output') {
+                resolverKey = `${sourceKey}.${role}`;
+                pathSegments = segments.slice(2);
+            }
+            else {
+                resolverKey = `${sourceKey}.output`;
+                pathSegments = segments.slice(1);
+            }
+        }
+        if (!outputSchemas.has(resolverKey)) {
+            issues.push({
+                path: location,
+                code: ValidationIssueCode.FORWARD_REFERENCE,
+                message: `"${refString}" references "${sourceKey}" which is not yet available at this point in the workflow (forward reference, or unknown step / trigger ID).`,
+            });
+            return;
+        }
+        const sourceSchema = outputSchemas.get(resolverKey);
+        const leafSchema = walkSchemaPath(sourceSchema, pathSegments);
+        if (leafSchema === null) {
+            issues.push({
+                path: location,
+                code: ValidationIssueCode.UNKNOWN_REFERENCE,
+                message: `"${refString}" — path "${pathSegments.join('.')}" does not exist in the schema of "${resolverKey}".`,
+            });
+            return;
+        }
+        if (consumerInnerSchema !== null) {
+            if (!isZodCompatible(leafSchema, consumerInnerSchema)) {
+                issues.push({
+                    path: location,
+                    code: ValidationIssueCode.TYPE_MISMATCH,
+                    message: `"${refString}" is a ${humanZodType(leafSchema)} but this field expects a ${humanZodType(consumerInnerSchema)}.`,
+                });
+            }
+        }
+    }
+    getConsumerInnerSchema(configSchema, location, prefix) {
+        const relative = location.startsWith(prefix + '.')
+            ? location.slice(prefix.length + 1)
+            : location.slice(prefix.length);
+        if (!relative)
+            return null;
+        const segments = relative
+            .replace(/\[(\d+)\]/g, '.$1')
+            .split('.')
+            .filter(Boolean);
+        const leafSchema = walkSchemaPath(configSchema, segments);
+        if (!leafSchema)
+            return null;
+        return getVariableRefInnerSchema(leafSchema);
+    }
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/engine/config-validator.js.map

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

package/dist/engine/pause-step.d.ts

@@ -0,0 +1,20 @@
+import type { PausePathSegment } from '../types/pause-path.js';
+/**
+ * Thrown by `ctx.pause()` to suspend workflow execution.
+ *
+ * The executor catches this, persists the context + state, and sets the
+ * execution status to EXTERNAL_WAIT. When the external event arrives, the
+ * executor resumes from the paused step by calling `onResume()`.
+ */
+export declare class PauseStep extends Error {
+    readonly externalRef: string | undefined;
+    readonly statePatch: Record<string, unknown> | undefined;
+    /** @internal Used by executor to track nested pause position in branches. */
+    _pausePath: PausePathSegment[];
+    constructor(reason: string, options?: {
+        externalRef?: string;
+        statePatch?: Record<string, unknown>;
+    });
+    static is(err: unknown): err is PauseStep;
+}
+//# sourceMappingURL=pause-step.d.ts.map

package/dist/engine/pause-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause-step.d.ts","sourceRoot":"","sources":["../../src/engine/pause-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAEzD,6EAA6E;IAC7E,UAAU,EAAE,gBAAgB,EAAE,CAAM;gBAGlC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAQ1E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS;CAM1C"}

package/dist/engine/pause-step.js

@@ -0,0 +1,24 @@
+/**
+ * Thrown by `ctx.pause()` to suspend workflow execution.
+ *
+ * The executor catches this, persists the context + state, and sets the
+ * execution status to EXTERNAL_WAIT. When the external event arrives, the
+ * executor resumes from the paused step by calling `onResume()`.
+ */
+export class PauseStep extends Error {
+    externalRef;
+    statePatch;
+    /** @internal Used by executor to track nested pause position in branches. */
+    _pausePath = [];
+    constructor(reason, options) {
+        super(`Step paused: ${reason}`);
+        this.name = 'PauseStep';
+        this.externalRef = options?.externalRef;
+        this.statePatch = options?.statePatch;
+    }
+    static is(err) {
+        return (err instanceof PauseStep ||
+            (err instanceof Error && err.name === 'PauseStep'));
+    }
+}
+//# sourceMappingURL=pause-step.js.map

package/dist/engine/pause-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause-step.js","sourceRoot":"","sources":["../../src/engine/pause-step.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,WAAW,CAAqB;IAChC,UAAU,CAAsC;IAEzD,6EAA6E;IAC7E,UAAU,GAAuB,EAAE,CAAC;IAEpC,YACE,MAAc,EACd,OAAwE;QAExE,KAAK,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,GAAY;QACpB,OAAO,CACL,GAAG,YAAY,SAAS;YACxB,CAAC,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CACnD,CAAC;IACJ,CAAC;CACF"}