@blokjs/runner 0.4.0 → 0.6.0

package/dist/Blok.js

@@ -70,6 +70,15 @@ export default class BlokService extends NodeBase {
         const result = await this.handle(ctx, inputs);
         this.v.validate(result, this.outputSchema);
         const end = performance.now();
+        // Truthful failure indicator. `defineNode.handle()` catches every
+        // throw and stuffs it onto `BlokResponse.error` — so the previous
+        // "Executed node" log line and the `response.success === false`
+        // metrics counter at the bottom of run() were both wrong on the
+        // error path (one always said success, the other never fired).
+        // Read the BlokResponse's error field once and let the rest of the
+        // method use it consistently.
+        const blokResponse = result;
+        const errored = blokResponse.error !== undefined && blokResponse.error !== null;
         node_execution.add(1, {
             env: process.env.NODE_ENV,
             workflow_path: `${ctx.workflow_path}`,
@@ -84,16 +93,36 @@ export default class BlokService extends NodeBase {
             node_name: `${this.name}`,
             node: this.node,
         });
-        ctx.logger.log(`Executed node: ${this.name} in ${(end - start).toFixed(2)}ms`);
+        // Surface failures clearly on the per-node log so operators don't
+        // see a misleading "Executed node" line followed by a contradictory
+        // "FAILED" line from RunnerSteps. The structured per-step log
+        // emitted by RunnerSteps remains the canonical "step N/M" entry;
+        // this one is the inner-node companion.
+        if (errored) {
+            const errMsg = blokResponse.error instanceof Error ? blokResponse.error.message : String(blokResponse.error);
+            ctx.logger.log(`Node ${this.name} failed in ${(end - start).toFixed(2)}ms: ${errMsg}`);
+        }
+        else {
+            ctx.logger.log(`Executed node: ${this.name} in ${(end - start).toFixed(2)}ms`);
+        }
         // V2 persistence — runner-owned, declarative.
         // `ephemeral` skips, `spread` merges, `as` renames, default stores
-        // at state[name]. Legacy `set_var: false` maps to ephemeral; legacy
-        // `set_var: true` is a no-op (default already persists).
+        // at state[name].
+        // Pass through the full IBlokResponse so the helper's error guard
+        // (`success: false` / non-null `error`) skips state persistence on
+        // the failure path — see PersistenceHelper.isErroredResult.
         applyStepOutput(ctx, this, result);
         // Hand the raw result back to the runner. RunnerSteps mirrors
         // response.data into ctx.response so adjacent-step access via
         // `ctx.prev` / `$.prev` keeps working.
         response.data = result;
+        // Mirror the inner BlokResponse error state onto the outer envelope
+        // the metrics block at the bottom of run() reads. Without this flip
+        // the `if (response.success === false)` guard never matched, so
+        // the `node_errors` OTel counter has been silently broken for every
+        // defineNode-built step since v0.3.x.
+        response.success = !errored;
+        response.error = errored ? blokResponse.error : null;
         response.data.contentType = this.contentType;
         globalMetrics.retry();
         globalMetrics.stop();

package/dist/Blok.js.map

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

package/dist/Configuration.d.ts

@@ -12,19 +12,26 @@ export default class Configuration implements Config {
     steps: NodeBase[];
     nodes: Node;
     trigger: Trigger;
+    /**
+     * v0.5.2 — workflow-level middleware chain. Populated from the
+     * normalized workflow's `appliedMiddleware` field. HTTP and Worker
+     * triggers prepend this list to their own `trigger.<kind>.middleware`
+     * before invoking the chain, so workflow-level entries run BEFORE
+     * trigger-level entries on every request.
+     */
+    appliedMiddleware: readonly string[];
     static loaded_nodes: Node;
     globalOptions: GlobalOptions | undefined;
     constructor();
     /**
      * Initialize the RuntimeRegistry with built-in adapters.
      *
-     * Registers `NodeJsRuntimeAdapter` for in-process JS nodes, then for each
-     * SDK language picks `HttpRuntimeAdapter` or `GrpcRuntimeAdapter` based on
-     * {@link resolveTransportForKind} (env-driven). This is the single point
-     * of transport selection — no other file branches on transport.
+     * Registers `NodeJsRuntimeAdapter` for in-process JS nodes, then a
+     * `GrpcRuntimeAdapter` per SDK language. gRPC is the sole transport
+     * since v0.5 — `assertGrpcOnlyTransport` throws if the operator still
+     * has `RUNTIME_TRANSPORT=http` set.
      */
     private initializeRuntimeRegistry;
-    private buildHttpAdapter;
     private buildGrpcAdapter;
     /**
      * Initialize the configuration for a workflow run.
@@ -64,6 +71,35 @@ export default class Configuration implements Config {
      * doesn't fire on otherwise-valid wait steps.
      */
     protected waitResolver(node: RunnerNode): Promise<RunnerNode>;
+    /**
+     * v0.5 · resolve a `forEach` step. The actual iteration logic lives
+     * in `ForEachNode.run()`; the inner `steps` array is pre-resolved by
+     * the existing isFlowWithProperties path in `getNodes()`.
+     */
+    protected forEachResolver(node: RunnerNode): Promise<RunnerNode>;
+    /**
+     * v0.5 · resolve a `loop` step. While-loop semantics live in
+     * `LoopNode.run()`. Inner `steps` resolved by isFlowWithProperties.
+     */
+    protected loopResolver(node: RunnerNode): Promise<RunnerNode>;
+    /**
+     * v0.5 · resolve a `switch` step. The N-way match logic lives in
+     * `SwitchNode.run()`. Cases + default each carry their own resolved
+     * inner-step list — see the dedicated `cases` branch in `getNodes()`.
+     */
+    protected switchResolver(node: RunnerNode): Promise<RunnerNode>;
+    /**
+     * v0.5 · resolve a `tryCatch` step. JS-like try/catch/finally semantics
+     * live in `TryCatchNode.run()`. Each block (try, catch, finally) is
+     * pre-resolved by the dedicated tryCatch branch in `getNodes()` so
+     * the runtime can dispatch them through child Runners on-demand.
+     */
+    protected tryCatchResolver(node: RunnerNode): Promise<RunnerNode>;
+    /**
+     * Check if a resolved node has runtimeRequirements and validate them
+     * against the currently known runtime versions in the RuntimeRegistry.
+     */
+    private validateNodeRuntimeRequirements;
     protected localResolver(node: RunnerNode): Promise<RunnerNode>;
 }
 type NodeResolverTypes = {

package/dist/Configuration.js

@@ -6,11 +6,11 @@ import ConfigurationResolver from "./ConfigurationResolver";
 import RunnerNode from "./RunnerNode";
 import { RuntimeAdapterNode } from "./RuntimeAdapterNode";
 import { RuntimeRegistry } from "./RuntimeRegistry";
-import { HttpRuntimeAdapter } from "./adapters/HttpRuntimeAdapter";
 import { NodeJsRuntimeAdapter } from "./adapters/NodeJsRuntimeAdapter";
 import { GrpcRuntimeAdapter } from "./adapters/grpc/GrpcRuntimeAdapter";
 import { DEFAULT_GRPC_PORTS, GRPC_DEFAULTS } from "./adapters/grpc/types";
-import { isLoopbackHost, isStreamLogsEnabled, isStrictTlsEnabled, loadTlsConfigForKind, resolveHealthCheckFailureThreshold, resolveHealthCheckIntervalMs, resolveTransportForKind, } from "./adapters/transport";
+import { assertGrpcOnlyTransport, isLoopbackHost, isStreamLogsEnabled, isStrictTlsEnabled, loadTlsConfigForKind, resolveHealthCheckFailureThreshold, resolveHealthCheckIntervalMs, } from "./adapters/transport";
+import { RuntimeVersionValidator } from "./version/RuntimeVersionValidator";
 export default class Configuration {
     workflow = {};
     name;
@@ -18,6 +18,14 @@ export default class Configuration {
     steps;
     nodes;
     trigger;
+    /**
+     * v0.5.2 — workflow-level middleware chain. Populated from the
+     * normalized workflow's `appliedMiddleware` field. HTTP and Worker
+     * triggers prepend this list to their own `trigger.<kind>.middleware`
+     * before invoking the chain, so workflow-level entries run BEFORE
+     * trigger-level entries on every request.
+     */
+    appliedMiddleware;
     static loaded_nodes = {};
     globalOptions;
     constructor() {
@@ -26,87 +34,40 @@ export default class Configuration {
         this.version = "";
         this.name = "";
         this.trigger = {};
+        this.appliedMiddleware = [];
         this.initializeRuntimeRegistry();
     }
     /**
      * Initialize the RuntimeRegistry with built-in adapters.
      *
-     * Registers `NodeJsRuntimeAdapter` for in-process JS nodes, then for each
-     * SDK language picks `HttpRuntimeAdapter` or `GrpcRuntimeAdapter` based on
-     * {@link resolveTransportForKind} (env-driven). This is the single point
-     * of transport selection — no other file branches on transport.
+     * Registers `NodeJsRuntimeAdapter` for in-process JS nodes, then a
+     * `GrpcRuntimeAdapter` per SDK language. gRPC is the sole transport
+     * since v0.5 — `assertGrpcOnlyTransport` throws if the operator still
+     * has `RUNTIME_TRANSPORT=http` set.
      */
     initializeRuntimeRegistry() {
+        assertGrpcOnlyTransport();
         const registry = RuntimeRegistry.getInstance();
         if (!registry.has("nodejs")) {
             registry.register(new NodeJsRuntimeAdapter());
         }
         const sdkLanguages = [
-            {
-                kind: "go",
-                hostEnv: "RUNTIME_GO_HOST",
-                httpPortEnv: "RUNTIME_GO_PORT",
-                grpcPortEnv: "RUNTIME_GO_GRPC_PORT",
-                defaultHttpPort: 9001,
-            },
-            {
-                kind: "rust",
-                hostEnv: "RUNTIME_RUST_HOST",
-                httpPortEnv: "RUNTIME_RUST_PORT",
-                grpcPortEnv: "RUNTIME_RUST_GRPC_PORT",
-                defaultHttpPort: 9002,
-            },
-            {
-                kind: "java",
-                hostEnv: "RUNTIME_JAVA_HOST",
-                httpPortEnv: "RUNTIME_JAVA_PORT",
-                grpcPortEnv: "RUNTIME_JAVA_GRPC_PORT",
-                defaultHttpPort: 9003,
-            },
-            {
-                kind: "csharp",
-                hostEnv: "RUNTIME_CSHARP_HOST",
-                httpPortEnv: "RUNTIME_CSHARP_PORT",
-                grpcPortEnv: "RUNTIME_CSHARP_GRPC_PORT",
-                defaultHttpPort: 9004,
-            },
-            {
-                kind: "php",
-                hostEnv: "RUNTIME_PHP_HOST",
-                httpPortEnv: "RUNTIME_PHP_PORT",
-                grpcPortEnv: "RUNTIME_PHP_GRPC_PORT",
-                defaultHttpPort: 9005,
-            },
-            {
-                kind: "ruby",
-                hostEnv: "RUNTIME_RUBY_HOST",
-                httpPortEnv: "RUNTIME_RUBY_PORT",
-                grpcPortEnv: "RUNTIME_RUBY_GRPC_PORT",
-                defaultHttpPort: 9006,
-            },
-            {
-                kind: "python3",
-                hostEnv: "RUNTIME_PYTHON3_HOST",
-                httpPortEnv: "RUNTIME_PYTHON3_PORT",
-                grpcPortEnv: "RUNTIME_PYTHON3_GRPC_PORT",
-                defaultHttpPort: 9007,
-            },
+            { kind: "go", hostEnv: "RUNTIME_GO_HOST", grpcPortEnv: "RUNTIME_GO_GRPC_PORT" },
+            { kind: "rust", hostEnv: "RUNTIME_RUST_HOST", grpcPortEnv: "RUNTIME_RUST_GRPC_PORT" },
+            { kind: "java", hostEnv: "RUNTIME_JAVA_HOST", grpcPortEnv: "RUNTIME_JAVA_GRPC_PORT" },
+            { kind: "csharp", hostEnv: "RUNTIME_CSHARP_HOST", grpcPortEnv: "RUNTIME_CSHARP_GRPC_PORT" },
+            { kind: "php", hostEnv: "RUNTIME_PHP_HOST", grpcPortEnv: "RUNTIME_PHP_GRPC_PORT" },
+            { kind: "ruby", hostEnv: "RUNTIME_RUBY_HOST", grpcPortEnv: "RUNTIME_RUBY_GRPC_PORT" },
+            { kind: "python3", hostEnv: "RUNTIME_PYTHON3_HOST", grpcPortEnv: "RUNTIME_PYTHON3_GRPC_PORT" },
         ];
         for (const lang of sdkLanguages) {
             if (registry.has(lang.kind))
                 continue;
-            const transport = resolveTransportForKind(lang.kind);
             const host = process.env[lang.hostEnv] || "localhost";
-            const adapter = transport === "grpc"
-                ? this.buildGrpcAdapter(lang.kind, host, lang.grpcPortEnv)
-                : this.buildHttpAdapter(lang.kind, host, lang.httpPortEnv, lang.defaultHttpPort);
+            const adapter = this.buildGrpcAdapter(lang.kind, host, lang.grpcPortEnv);
             registry.register(adapter);
         }
     }
-    buildHttpAdapter(kind, host, portEnv, defaultPort) {
-        const port = process.env[portEnv] ? Number.parseInt(process.env[portEnv], 10) : defaultPort;
-        return new HttpRuntimeAdapter(kind, host, port);
-    }
     buildGrpcAdapter(kind, host, portEnv) {
         const defaultPort = DEFAULT_GRPC_PORTS[kind];
         const port = process.env[portEnv] ? Number.parseInt(process.env[portEnv], 10) : defaultPort;
@@ -185,6 +146,11 @@ export default class Configuration {
         this.version = this.workflow.version;
         this.name = this.workflow.name;
         this.trigger = this.workflow.trigger;
+        // Workflow-level middleware list (v0.5.2). Lives on the normalized
+        // workflow as `appliedMiddleware` — see WorkflowNormalizer for the
+        // schema overload (`middleware: string[]` at the top level).
+        const wfWithApplied = this.workflow;
+        this.appliedMiddleware = Array.isArray(wfWithApplied.appliedMiddleware) ? wfWithApplied.appliedMiddleware : [];
     }
     async getSteps(blueprint_steps) {
         const nodes = [];
@@ -203,13 +169,6 @@ export default class Configuration {
             node.name = step.name;
             node.active = step.active !== undefined ? step.active : true;
             node.stop = step.stop !== undefined ? step.stop : false;
-            // Pass `set_var` through verbatim — DO NOT default to `false`. The
-            // `false` value short-circuits PersistenceHelper.applyStepOutput
-            // and silently disables v2's default-store rule. Legacy v1
-            // workflows that explicitly set `set_var: false` are normalized
-            // to `ephemeral: true` upstream by WorkflowNormalizer.
-            if (step.set_var !== undefined)
-                node.set_var = step.set_var;
             // V2 persistence knobs — read by PersistenceHelper.applyStepOutput.
             // `as` renames the state key; `spread` flattens result.data into
             // state; `ephemeral: true` skips persistence entirely. Default
@@ -255,10 +214,17 @@ export default class Configuration {
                 const hasOutputs = currentNode.mapper !== undefined;
                 if (isFlowWithProperties) {
                     const steps = currentNode.steps;
-                    nodes[key] = await this.getFlow(steps);
-                    const copyBlueprintNode = { ...workflow_nodes[key] };
-                    copyBlueprintNode.steps = [];
-                    nodes[key] = { ...nodes[key], ...copyBlueprintNode };
+                    const flow = await this.getFlow(steps);
+                    // Spread the metadata FIRST, then the resolved flow — this
+                    // keeps the resolved NodeBase[] in `flow.steps` and lets
+                    // the metadata (e.g. forEach's in/as/mode/concurrency,
+                    // loop's while/maxIterations) survive on the merged config.
+                    // The earlier code spread metadata AFTER flow with a
+                    // `copyBlueprintNode.steps = []` reset, which clobbered
+                    // the resolved steps array — broken for any node config
+                    // that needed both inner steps AND sibling fields.
+                    const { steps: _drop, ...metadata } = workflow_nodes[key];
+                    nodes[key] = { ...metadata, ...flow };
                 }
                 else if (isFlow) {
                     const steps = currentNode.steps;
@@ -284,6 +250,47 @@ export default class Configuration {
                         catch: await this.getFlow(currentNode.catch.steps),
                     };
                 }
+                else if (typeof workflow_nodes[key] === "object" &&
+                    Array.isArray(currentNode.try) &&
+                    Array.isArray(currentNode.catch)) {
+                    // v0.5 · tryCatch step. `try`, `catch`, and optional `finally`
+                    // each carry their own inner-step array (set by
+                    // `normalizeTryCatchStep`). Resolve each block as its own Flow
+                    // so TryCatchNode.run() can dispatch them through child Runners.
+                    const raw = workflow_nodes[key];
+                    const merged = {
+                        try: (await this.getFlow(raw.try)).steps,
+                        catch: (await this.getFlow(raw.catch)).steps,
+                    };
+                    if (Array.isArray(raw.finally)) {
+                        merged.finally = (await this.getFlow(raw.finally)).steps;
+                    }
+                    nodes[key] = merged;
+                }
+                else if (typeof workflow_nodes[key] === "object" &&
+                    currentNode.cases !== undefined &&
+                    Array.isArray(currentNode.cases)) {
+                    // v0.5 · switch step. Each case carries its own inner-step
+                    // list at `case.steps` (set by `normalizeSwitchStep`); resolve
+                    // each independently via getFlow. Optional `default` is its
+                    // own resolved Flow. The merged config preserves the `on`
+                    // expression so the blueprint mapper can rewrite it before
+                    // SwitchNode.run() reads ctx.config[name].on at run time.
+                    const raw = workflow_nodes[key];
+                    const rawCases = raw.cases;
+                    const resolvedCases = await Promise.all(rawCases.map(async (c) => ({
+                        when: c.when,
+                        steps: (await this.getFlow(c.steps)).steps,
+                    })));
+                    const merged = {
+                        on: raw.on,
+                        cases: resolvedCases,
+                    };
+                    if (Array.isArray(raw.default)) {
+                        merged.default = (await this.getFlow(raw.default)).steps;
+                    }
+                    nodes[key] = merged;
+                }
                 else {
                     nodes[key] = { ...workflow_nodes[key] };
                 }
@@ -309,13 +316,6 @@ export default class Configuration {
             node.name = step.name;
             node.active = step.active !== undefined ? step.active : true;
             node.stop = step.stop !== undefined ? step.stop : false;
-            // Pass `set_var` through verbatim — DO NOT default to `false`. The
-            // `false` value short-circuits PersistenceHelper.applyStepOutput
-            // and silently disables v2's default-store rule. Legacy v1
-            // workflows that explicitly set `set_var: false` are normalized
-            // to `ephemeral: true` upstream by WorkflowNormalizer.
-            if (step.set_var !== undefined)
-                node.set_var = step.set_var;
             // V2 persistence + idempotency + retry knobs flow through nested
             // flow steps too. Without this, a `branch.then[0]` step with
             // `idempotencyKey` set would NOT be cached on rerun. Mirrors the
@@ -395,6 +395,23 @@ export default class Configuration {
             wait: {
                 resolver: async (node) => await this.waitResolver(node),
             },
+            // v0.5 · `forEach({...})` step — iterate a collection running
+            // inner steps per item. Sequential or parallel-bounded.
+            forEach: {
+                resolver: async (node) => await this.forEachResolver(node),
+            },
+            // v0.5 · `loop({...})` step — while-loop with maxIterations cap.
+            loop: {
+                resolver: async (node) => await this.loopResolver(node),
+            },
+            // v0.5 · `switchOn({...})` step — N-way branch; first matching case wins.
+            switch: {
+                resolver: async (node) => await this.switchResolver(node),
+            },
+            // v0.5 · `tryCatch({...})` step — JS-like try/catch/finally semantics.
+            tryCatch: {
+                resolver: async (node) => await this.tryCatchResolver(node),
+            },
         };
     }
     async runtimeResolver(node) {
@@ -424,15 +441,6 @@ export default class Configuration {
         targetNode.runtime = runtimeKind;
         targetNode.active = node.active !== undefined ? node.active : true;
         targetNode.stop = node.stop !== undefined ? node.stop : false;
-        // Pass `set_var` through verbatim — DO NOT default to `false`. The v2
-        // default-store rule in PersistenceHelper persists `result.data` at
-        // `state[name]` unless `set_var === false` is explicit. Defaulting to
-        // `false` here silently disabled persistence for every SDK step,
-        // breaking `js/ctx.state['<id>']` reads in v2 workflows
-        // (cross-runtime-chain regressed: `state['go']` was undefined even
-        // though the GO step ran fine).
-        if (node.set_var !== undefined)
-            targetNode.set_var = node.set_var;
         // V2 persistence knobs — flow through to PersistenceHelper.
         const v2 = node;
         if (v2.as !== undefined)
@@ -492,6 +500,31 @@ export default class Configuration {
         // `wait: false` triggers the fire-and-forget branch in SubworkflowNode.run.
         // Default to `true` (synchronous) when unset.
         subworkflowNode.wait = v2.wait !== false;
+        // v0.7 PR 4 — polymorphic sub-workflow dispatch carries the
+        // parent workflow's `trigger.webhook.namespace` so a resolved
+        // event-type name (e.g. `"invoice.paid"`) gets prefixed into a
+        // full registry name (e.g. `"stripe.invoice.paid"`). Static
+        // names are unaffected.
+        const triggerCfg = this.workflow?.trigger;
+        if (typeof triggerCfg?.webhook?.namespace === "string" && triggerCfg.webhook.namespace.length > 0) {
+            subworkflowNode.namespace = triggerCfg.webhook.namespace;
+        }
+        // G3 polymorphic dispatch — pass the per-step allowList (cleaned to
+        // non-empty strings by `normalizeSubworkflowStep`) onto the node so
+        // `resolveSubworkflowName` can reject unauthorized lookups at
+        // dispatch time without re-walking the workflow shape.
+        const allowListSource = node.allowList;
+        if (Array.isArray(allowListSource) && allowListSource.length > 0) {
+            subworkflowNode.allowList = Object.freeze(allowListSource.filter((s) => typeof s === "string" && s.length > 0));
+        }
+        // G2 (v0.6) — dispatch strategy. `in-process` (default) preserves
+        // the v0.5 behaviour; `http-self` routes the child via a fresh
+        // HTTP request to the deployment's own base URL so multi-process
+        // deployments can isolate child execution from the parent.
+        const dispatchRaw = node.dispatch;
+        if (dispatchRaw === "http-self" || dispatchRaw === "in-process") {
+            subworkflowNode.dispatch = dispatchRaw;
+        }
         // `globalOptions` is the runner's node registry — child Configuration.init
         // needs it for `module:` step resolution.
         subworkflowNode.globalOptions = this.globalOptions;
@@ -502,6 +535,8 @@ export default class Configuration {
         if (!nodeHandler) {
             throw new Error(`Node ${node.node} not found`);
         }
+        // Validate runtime requirements if the node declares them
+        this.validateNodeRuntimeRequirements(nodeHandler);
         const clone = Object.assign(Object.create(Object.getPrototypeOf(nodeHandler)), nodeHandler);
         // Copy step-level metadata from the workflow JSON onto the clone.
         // Without this, `step.type` is undefined for module nodes and
@@ -516,8 +551,6 @@ export default class Configuration {
             clone.active = node.active;
         if (node.stop !== undefined)
             clone.stop = node.stop;
-        if (node.set_var !== undefined)
-            clone.set_var = node.set_var;
         return clone;
     }
     /**
@@ -542,6 +575,96 @@ export default class Configuration {
             stub.waitUntil = v2.waitUntil;
         return stub;
     }
+    /**
+     * v0.5 · resolve a `forEach` step. The actual iteration logic lives
+     * in `ForEachNode.run()`; the inner `steps` array is pre-resolved by
+     * the existing isFlowWithProperties path in `getNodes()`.
+     */
+    async forEachResolver(node) {
+        const { ForEachNode } = await import("./ForEachNode");
+        const n = new ForEachNode();
+        n.node = node.node;
+        n.name = node.name;
+        n.type = node.type;
+        n.active = node.active !== undefined ? node.active : true;
+        n.stop = node.stop !== undefined ? node.stop : false;
+        return n;
+    }
+    /**
+     * v0.5 · resolve a `loop` step. While-loop semantics live in
+     * `LoopNode.run()`. Inner `steps` resolved by isFlowWithProperties.
+     */
+    async loopResolver(node) {
+        const { LoopNode } = await import("./LoopNode");
+        const n = new LoopNode();
+        n.node = node.node;
+        n.name = node.name;
+        n.type = node.type;
+        n.active = node.active !== undefined ? node.active : true;
+        n.stop = node.stop !== undefined ? node.stop : false;
+        return n;
+    }
+    /**
+     * v0.5 · resolve a `switch` step. The N-way match logic lives in
+     * `SwitchNode.run()`. Cases + default each carry their own resolved
+     * inner-step list — see the dedicated `cases` branch in `getNodes()`.
+     */
+    async switchResolver(node) {
+        const { SwitchNode } = await import("./SwitchNode");
+        const n = new SwitchNode();
+        n.node = node.node;
+        n.name = node.name;
+        n.type = node.type;
+        n.active = node.active !== undefined ? node.active : true;
+        n.stop = node.stop !== undefined ? node.stop : false;
+        return n;
+    }
+    /**
+     * v0.5 · resolve a `tryCatch` step. JS-like try/catch/finally semantics
+     * live in `TryCatchNode.run()`. Each block (try, catch, finally) is
+     * pre-resolved by the dedicated tryCatch branch in `getNodes()` so
+     * the runtime can dispatch them through child Runners on-demand.
+     */
+    async tryCatchResolver(node) {
+        const { TryCatchNode } = await import("./TryCatchNode");
+        const n = new TryCatchNode();
+        n.node = node.node;
+        n.name = node.name;
+        n.type = node.type;
+        n.active = node.active !== undefined ? node.active : true;
+        n.stop = node.stop !== undefined ? node.stop : false;
+        return n;
+    }
+    /**
+     * Check if a resolved node has runtimeRequirements and validate them
+     * against the currently known runtime versions in the RuntimeRegistry.
+     */
+    validateNodeRuntimeRequirements(node) {
+        const fnNode = node;
+        if (!fnNode.runtimeRequirements)
+            return;
+        const registry = RuntimeRegistry.getInstance();
+        const runtimeVersions = {};
+        for (const kind of registry.getRegisteredKinds()) {
+            const version = registry.getVersion(kind);
+            if (version) {
+                runtimeVersions[kind] = version;
+            }
+        }
+        // If no runtime versions are known yet, skip validation
+        // (versions are populated when health checks succeed)
+        if (Object.keys(runtimeVersions).length === 0)
+            return;
+        const validator = new RuntimeVersionValidator(runtimeVersions);
+        const results = validator.validateNode({
+            name: fnNode.name || "unknown",
+            runtimeRequirements: fnNode.runtimeRequirements,
+        });
+        const failures = results.filter((r) => !r.valid);
+        if (failures.length > 0) {
+            throw new Error(RuntimeVersionValidator.formatErrors(failures));
+        }
+    }
     async localResolver(node) {
         // Security review FW-3 — canonicalize the resolved path against
         // NODES_PATH so a node.node value like "../../malicious" can't