@blokjs/runner 0.2.1 → 0.4.0

package/dist/RuntimeAdapterNode.d.ts

@@ -11,9 +11,39 @@ import type { RuntimeAdapter } from "./adapters/RuntimeAdapter";
 export declare class RuntimeAdapterNode extends RunnerNode {
     private adapter;
     private targetNode;
-    constructor(adapter: RuntimeAdapter, targetNode: RunnerNode);
+    private streamLogs;
     /**
-     * Execute the node using the runtime adapter
+     * Wire transport this node uses (`http` | `grpc` | `module`). Surfaced
+     * in the step-prefix log by `RunnerSteps` so operators can tell at a
+     * glance which path a runtime node took during the migration. Read-only;
+     * mirrors the underlying adapter's `transport` field.
+     */
+    readonly transport: RuntimeAdapter["transport"];
+    constructor(adapter: RuntimeAdapter, targetNode: RunnerNode, opts?: {
+        streamLogs?: boolean;
+    });
+    /**
+     * Execute the node using the runtime adapter.
+     *
+     * When `streamLogs=true` AND the adapter exposes `executeStream`, routes
+     * through the server-streaming path so node-emitted `LogLine` events flow
+     * into the tracker (and thus into Studio's SSE stream) live. Falls back
+     * to unary `execute` when streaming isn't enabled or isn't supported by
+     * this adapter (e.g. HttpRuntimeAdapter has no streaming surface).
      */
     run(ctx: Context): Promise<ResponseContext>;
+    /**
+     * True when streaming is enabled for this node AND the adapter exposes a
+     * server-streaming `executeStream` method. The shape check is
+     * intentionally duck-typed so any future adapter that implements
+     * streaming Just Works without coupling this class to GrpcRuntimeAdapter.
+     */
+    private canStream;
+    /**
+     * Run the node via the adapter's streaming surface, draining log frames
+     * into `RunTracker.addLog` as they arrive. Returns the same
+     * `ExecutionResult` shape as the unary path so callers handle both flows
+     * identically.
+     */
+    private runStreaming;
 }

package/dist/RuntimeAdapterNode.js

@@ -1,6 +1,7 @@
 import { GlobalError } from "@blokjs/shared";
 import RunnerNode from "./RunnerNode";
 import { RunTracker } from "./tracing/RunTracker";
+import { applyStepOutput } from "./workflow/PersistenceHelper";
 /**
  * RuntimeAdapterNode is a wrapper that bridges the existing RunnerNode interface
  * with the new RuntimeAdapter system.
@@ -11,10 +12,20 @@ import { RunTracker } from "./tracing/RunTracker";
 export class RuntimeAdapterNode extends RunnerNode {
     adapter;
     targetNode;
-    constructor(adapter, targetNode) {
+    streamLogs;
+    /**
+     * Wire transport this node uses (`http` | `grpc` | `module`). Surfaced
+     * in the step-prefix log by `RunnerSteps` so operators can tell at a
+     * glance which path a runtime node took during the migration. Read-only;
+     * mirrors the underlying adapter's `transport` field.
+     */
+    transport;
+    constructor(adapter, targetNode, opts = {}) {
         super();
         this.adapter = adapter;
         this.targetNode = targetNode;
+        this.streamLogs = opts.streamLogs === true;
+        this.transport = adapter.transport;
         // Copy properties from target node
         this.node = targetNode.node;
         this.name = targetNode.name;
@@ -23,41 +34,57 @@ export class RuntimeAdapterNode extends RunnerNode {
         this.active = targetNode.active;
         this.stop = targetNode.stop;
         this.set_var = targetNode.set_var;
+        // V2 persistence knobs — flow through to PersistenceHelper.
+        this.as = targetNode.as;
+        this.spread = targetNode.spread;
+        this.ephemeral = targetNode.ephemeral;
     }
     /**
-     * Execute the node using the runtime adapter
+     * Execute the node using the runtime adapter.
+     *
+     * When `streamLogs=true` AND the adapter exposes `executeStream`, routes
+     * through the server-streaming path so node-emitted `LogLine` events flow
+     * into the tracker (and thus into Studio's SSE stream) live. Falls back
+     * to unary `execute` when streaming isn't enabled or isn't supported by
+     * this adapter (e.g. HttpRuntimeAdapter has no streaming surface).
      */
     async run(ctx) {
-        const result = await this.adapter.execute(this.targetNode, ctx);
-        // --- Trace: capture runtime metrics ---
+        const traceRunId = ctx._traceRunId;
         const traceNodeId = ctx._traceNodeId;
-        if (traceNodeId && result.metrics) {
-            const tracker = RunTracker.getInstance();
-            const nodeRun = tracker.getNodeRun(traceNodeId);
-            if (nodeRun) {
-                nodeRun.metrics = {
-                    duration_ms: result.metrics.duration_ms,
-                    cpu_ms: result.metrics.cpu_ms,
-                    memory_bytes: result.metrics.memory_bytes,
-                };
-                nodeRun.runtimeKind = this.adapter.kind;
-            }
+        const tracker = traceRunId ? RunTracker.getInstance() : null;
+        const result = this.canStream()
+            ? await this.runStreaming(ctx, tracker, traceRunId, traceNodeId)
+            : await this.adapter.execute(this.targetNode, ctx);
+        // --- Trace: stash runtime metrics on ctx so RunnerSteps can pass
+        // them to `tracker.completeNode(...)` as the third argument. The
+        // previous in-place mutation via `tracker.getNodeRun()` was a
+        // dead-end: SqliteRunStore.getNodeRun reconstructs from a row, so
+        // the mutation landed on a detached object; even on InMemoryRunStore
+        // the next `completeNode(nodeRunId, outputs)` call wrote
+        // `metrics: undefined` over it. Stashing on ctx and threading
+        // through `completeNode` is the single path that survives all
+        // store implementations and the NODE_COMPLETED event payload.
+        if (result.metrics) {
+            ctx._stepMetrics = result.metrics;
         }
-        // Ensure ctx.vars exists
-        if (!ctx.vars) {
-            ctx.vars = {};
+        // Defensive: ensure state exists. TriggerBase initializes it, but
+        // some legacy code paths construct ctx by hand. ctx.vars and
+        // ctx.state alias the same object; we read/write through `state`.
+        if (!ctx.state || typeof ctx.state !== "object") {
+            ctx.state = {};
         }
-        const vars = ctx.vars;
-        // Merge SDK-returned vars into ctx.vars (if the SDK server includes them)
+        const state = ctx.state;
+        // Merge SDK-returned `vars_delta` into state. This is the SDK's
+        // explicit publication path (proto field `vars_delta` on
+        // ExecuteResponse) — it stacks with the auto-store rule below.
         if (result.vars && typeof result.vars === "object") {
-            Object.assign(vars, result.vars);
-        }
-        // Auto-save the step's result data into ctx.vars[stepName]
-        // This ensures each runtime step's output is accessible downstream,
-        // even if the SDK server doesn't explicitly return vars
-        if (result.data != null) {
-            vars[this.name] = result.data;
+            Object.assign(state, result.vars);
         }
+        // V2 persistence — runner-owned, declarative.
+        // `ephemeral` skips, `spread` merges, `as` renames, default stores
+        // at state[name]. SDK nodes have always auto-stored (today's
+        // behaviour); this just routes through the unified helper.
+        applyStepOutput(ctx, this, result);
         // Convert errors to GlobalError if present
         let error = null;
         if (result.errors) {
@@ -83,5 +110,73 @@ export class RuntimeAdapterNode extends RunnerNode {
             error,
         };
     }
+    /**
+     * True when streaming is enabled for this node AND the adapter exposes a
+     * server-streaming `executeStream` method. The shape check is
+     * intentionally duck-typed so any future adapter that implements
+     * streaming Just Works without coupling this class to GrpcRuntimeAdapter.
+     */
+    canStream() {
+        if (!this.streamLogs)
+            return false;
+        const candidate = this.adapter;
+        return typeof candidate.executeStream === "function";
+    }
+    /**
+     * Run the node via the adapter's streaming surface, draining log frames
+     * into `RunTracker.addLog` as they arrive. Returns the same
+     * `ExecutionResult` shape as the unary path so callers handle both flows
+     * identically.
+     */
+    async runStreaming(ctx, tracker, traceRunId, traceNodeId) {
+        const streamingAdapter = this.adapter;
+        const { events, result } = streamingAdapter.executeStream(this.targetNode, ctx);
+        for await (const event of events) {
+            if (event.type === "log" && tracker && traceRunId) {
+                tracker.addLog({
+                    runId: traceRunId,
+                    nodeId: traceNodeId,
+                    nodeName: this.name,
+                    level: normalizeLogLevel(event.log.level),
+                    message: event.log.message,
+                    data: Object.keys(event.log.attributes).length > 0 ? event.log.attributes : undefined,
+                });
+            }
+            else if (event.type === "progress" && tracker && traceNodeId) {
+                // Live progress hint — overwrites any previous;
+                // emits NODE_PROGRESS for Studio SSE.
+                tracker.recordProgress(traceNodeId, event.percent, event.phase);
+            }
+            else if (event.type === "partial" && tracker && traceNodeId) {
+                // Interim snapshot — overwrites any previous;
+                // emits NODE_PARTIAL_RESULT for Studio SSE.
+                tracker.recordPartialResult(traceNodeId, event.snapshot);
+            }
+            // `started` is intentionally ignored at this layer — the
+            // node lifecycle (NodeStarted / metrics / completion) is
+            // already tracked by RunnerSteps via `startNode` /
+            // `completeNode`.
+        }
+        return result;
+    }
+}
+/**
+ * Coerce a wire-side log level string into the runner's 4-tier
+ * `TraceLogEntry["level"]`. Defensive against SDK-side variations
+ * ("warning" → "warn", "WARN" → "warn", unknown → "info").
+ */
+function normalizeLogLevel(level) {
+    const normalized = level.trim().toLowerCase();
+    switch (normalized) {
+        case "debug":
+        case "info":
+        case "error":
+            return normalized;
+        case "warn":
+        case "warning":
+            return "warn";
+        default:
+            return "info";
+    }
 }
 //# sourceMappingURL=RuntimeAdapterNode.js.map

package/dist/RuntimeAdapterNode.js.map

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

package/dist/SubworkflowNode.d.ts

@@ -0,0 +1,75 @@
+import type { Context, ResponseContext } from "@blokjs/shared";
+import RunnerNode from "./RunnerNode";
+import type GlobalOptions from "./types/GlobalOptions";
+/**
+ * `SubworkflowNode` — the runner-side dispatch primitive that powers
+ * the v2 `subworkflow:` step shape. Looks up the named child workflow
+ * in the `WorkflowRegistry`, materializes a child `Configuration` +
+ * `Runner`, runs the child to completion in its own isolated `Context`,
+ * and returns the child's `ctx.response` as this step's `model.data`.
+ *
+ * **Composition with Tier 1**:
+ * - Parent step's `idempotencyKey` is consulted by `RunnerSteps` BEFORE
+ *   `SubworkflowNode.run` is even called — cache hit short-circuits the
+ *   entire sub-workflow (no child invocation, no side effects fire).
+ *   This is the headline pattern AND the documented footgun.
+ * - Parent step's `retry` retries the whole sub-workflow on failure;
+ *   each retry creates a fresh child run record under the same parent.
+ * - Replay re-creates fresh sub-run lineage automatically — the new
+ *   parent run invokes the sub-workflow fresh.
+ *
+ * **Lineage**: child's `WorkflowRun.parentRunId` and
+ * `WorkflowRun.parentNodeRunId` carry the parent run + step that
+ * invoked it. Studio renders a "called from #..." breadcrumb on the
+ * child and a "Sub-runs" list on the parent.
+ *
+ * **Recursion guard**: `BLOK_MAX_SUBWORKFLOW_DEPTH` (default 10) bounds
+ * cycle / deep-nesting blast radius. Throws a clear error past the cap.
+ */
+export declare class SubworkflowNode extends RunnerNode {
+    /**
+     * The child workflow's `name:` field — looked up in `WorkflowRegistry`
+     * at run time. Set by `Configuration.subworkflowResolver`; this field
+     * shadows the inherited `NodeBase.subworkflow` so callers can rely on
+     * it being defined.
+     */
+    subworkflow: string;
+    /**
+     * Wait mode for the sub-workflow dispatch:
+     *
+     * - `true` (default) — synchronous: parent step blocks on the child
+     *   and the child's `ctx.response` becomes the parent step's output.
+     * - `false` — fire-and-forget: parent step returns IMMEDIATELY with
+     *   `{runId, workflowName, scheduledAt}`. The child runs
+     *   asynchronously via `setImmediate` and shows up in Studio's
+     *   Sub-runs strip with status transitioning `running → completed |
+     *   failed` independently of the parent.
+     *
+     * Combine `wait: false` with `idempotencyKey` for at-most-once
+     * dispatch deduplication (the `runId` is cached against the key
+     * regardless of child outcome — Trigger.dev / Stripe semantics).
+     */
+    wait: boolean;
+    /**
+     * Runner-wide options (carries the `nodes` registry that the child
+     * Configuration needs for `module` step resolution). Set by
+     * `Configuration.subworkflowResolver` before this node runs.
+     */
+    globalOptions?: GlobalOptions;
+    run(ctx: Context): Promise<ResponseContext>;
+    /**
+     * Fire-and-forget dispatch (Tier 2 #4 follow-up — `wait: false`).
+     *
+     * Schedules the child runner via `setImmediate` so the parent step
+     * can return immediately. Child errors are caught and routed to
+     * `tracker.failRun(childRunId, err)` — visible in Studio, NOT
+     * propagated to the parent step (which has already returned). Also
+     * logged via `console.error` for ops visibility.
+     *
+     * Parent step's output is the dispatch metadata `{runId,
+     * workflowName, scheduledAt}` — NOT the child's response (which
+     * doesn't exist yet). Caller polls `GET /__blok/runs/<runId>` for
+     * the actual outcome.
+     */
+    private dispatchAsync;
+}

package/dist/SubworkflowNode.js

@@ -0,0 +1,221 @@
+import Configuration from "./Configuration";
+import RunnerNode from "./RunnerNode";
+import { RunTracker } from "./tracing/RunTracker";
+import { createChildContext } from "./utils/createChildContext";
+import { applyStepOutput } from "./workflow/PersistenceHelper";
+import { WorkflowRegistry } from "./workflow/WorkflowRegistry";
+/**
+ * Hard cap on `parent → child → grandchild → …` recursion. Bounds the
+ * blast radius of an accidental cycle (workflow A calls B calls A) or
+ * a legitimate-but-pathological deep nesting. Tunable via
+ * `BLOK_MAX_SUBWORKFLOW_DEPTH` env var; falls back to 10.
+ */
+function getMaxDepth() {
+    const raw = process.env.BLOK_MAX_SUBWORKFLOW_DEPTH;
+    if (typeof raw === "string" && raw.length > 0) {
+        const parsed = Number.parseInt(raw, 10);
+        if (Number.isInteger(parsed) && parsed > 0)
+            return parsed;
+    }
+    return 10;
+}
+/**
+ * Internal ctx field that carries the current sub-workflow depth.
+ * Incremented by `SubworkflowNode.run` before invoking the child;
+ * read on entry to enforce the cap.
+ */
+const SUBWORKFLOW_DEPTH_KEY = "_subworkflowDepth";
+/**
+ * `SubworkflowNode` — the runner-side dispatch primitive that powers
+ * the v2 `subworkflow:` step shape. Looks up the named child workflow
+ * in the `WorkflowRegistry`, materializes a child `Configuration` +
+ * `Runner`, runs the child to completion in its own isolated `Context`,
+ * and returns the child's `ctx.response` as this step's `model.data`.
+ *
+ * **Composition with Tier 1**:
+ * - Parent step's `idempotencyKey` is consulted by `RunnerSteps` BEFORE
+ *   `SubworkflowNode.run` is even called — cache hit short-circuits the
+ *   entire sub-workflow (no child invocation, no side effects fire).
+ *   This is the headline pattern AND the documented footgun.
+ * - Parent step's `retry` retries the whole sub-workflow on failure;
+ *   each retry creates a fresh child run record under the same parent.
+ * - Replay re-creates fresh sub-run lineage automatically — the new
+ *   parent run invokes the sub-workflow fresh.
+ *
+ * **Lineage**: child's `WorkflowRun.parentRunId` and
+ * `WorkflowRun.parentNodeRunId` carry the parent run + step that
+ * invoked it. Studio renders a "called from #..." breadcrumb on the
+ * child and a "Sub-runs" list on the parent.
+ *
+ * **Recursion guard**: `BLOK_MAX_SUBWORKFLOW_DEPTH` (default 10) bounds
+ * cycle / deep-nesting blast radius. Throws a clear error past the cap.
+ */
+export class SubworkflowNode extends RunnerNode {
+    /**
+     * Runner-wide options (carries the `nodes` registry that the child
+     * Configuration needs for `module` step resolution). Set by
+     * `Configuration.subworkflowResolver` before this node runs.
+     */
+    globalOptions;
+    async run(ctx) {
+        // === 1. Recursion guard ===
+        const depth = (ctx[SUBWORKFLOW_DEPTH_KEY] ?? 0) + 1;
+        const maxDepth = getMaxDepth();
+        if (depth > maxDepth) {
+            throw new Error(`[blok] Sub-workflow recursion limit exceeded (depth ${depth} > ${maxDepth}). Likely a cycle: workflow "${ctx.workflow_name}" called sub-workflow "${this.subworkflow}" too deep. Bump via BLOK_MAX_SUBWORKFLOW_DEPTH if intentional.`);
+        }
+        // === 2. Look up the child workflow ===
+        const registry = WorkflowRegistry.getInstance();
+        const entry = registry.get(this.subworkflow);
+        if (!entry) {
+            const known = registry.list().map((w) => w.name);
+            const knownStr = known.length > 0 ? known.join(", ") : "(none registered yet)";
+            throw new Error(`[blok] Sub-workflow "${this.subworkflow}" not found in WorkflowRegistry. Available: ${knownStr}. Workflows are registered automatically by the HTTP trigger at boot — make sure the child workflow file is in the scanned directory and has \`name: "${this.subworkflow}"\`.`);
+        }
+        // === 3. Materialize child Configuration + Runner ===
+        // `preloaded` = entry.workflow skips the disk re-read; the
+        // normalizer still runs so v1→v2 conversion happens for legacy
+        // child workflows.
+        const childConfig = new Configuration();
+        await childConfig.init(entry.name, this.globalOptions, entry.workflow);
+        // Lazy import of Runner to avoid a circular dep
+        // (Configuration → RunnerNode → ... — Runner has its own chain).
+        const { default: Runner } = await import("./Runner");
+        const childRunner = new Runner(childConfig.steps);
+        // === 4. Build the child Context ===
+        // Parent step's resolved inputs (from blueprint mapper) live on
+        // `ctx.config[this.name].inputs` — the blueprint mapper has
+        // mutated the wrapper in place, so `js/...` and `$.<path>`
+        // expressions are now concrete values. These become the child's
+        // `request.body` so the child reads them via `$.req.body.<key>`
+        // exactly as if HTTP-triggered (function-call semantics).
+        const parentNodeConfig = ctx.config?.[this.name];
+        const parentInputs = parentNodeConfig?.inputs ?? {};
+        const childCtx = createChildContext(ctx, {
+            workflowName: entry.name,
+            workflowPath: entry.source,
+            body: parentInputs,
+            config: childConfig.nodes,
+        });
+        // Carry the depth counter forward so nested sub-workflows hit the cap.
+        childCtx[SUBWORKFLOW_DEPTH_KEY] = depth;
+        // === 5. Tracing — child gets its own run record + lineage ===
+        const tracker = RunTracker.getInstance();
+        const parentRunId = ctx._traceRunId;
+        const parentNodeRunId = ctx._traceNodeId;
+        const childTriggerSummary = `${ctx.workflow_name ?? "?"} → ${entry.name}`;
+        let childRunId;
+        if (tracker.active) {
+            const childRun = tracker.startRun({
+                workflowName: entry.name,
+                workflowPath: entry.source,
+                triggerType: "subworkflow",
+                triggerSummary: childTriggerSummary,
+                nodeCount: childConfig.steps.length,
+                parentRunId,
+                parentNodeRunId,
+            });
+            childRunId = childRun.id;
+            childCtx._traceRunId = childRun.id;
+        }
+        // === 6. Dispatch — sync or fire-and-forget based on `this.wait` ===
+        if (this.wait === false) {
+            return this.dispatchAsync(ctx, childRunner, childCtx, childRunId, entry.name);
+        }
+        // === 6a. Synchronous dispatch (wait: true / default) ===
+        try {
+            await childRunner.run(childCtx);
+            if (childRunId)
+                tracker.completeRun(childRunId, childCtx.response);
+        }
+        catch (err) {
+            if (childRunId)
+                tracker.failRun(childRunId, err);
+            throw err;
+        }
+        finally {
+            // PR 1 follow-up · A3 fix. Abort the listener-cleanup signal so
+            // the parent.signal listener (registered in createChildContext)
+            // auto-removes. Without this, listeners accumulate on long-lived
+            // parents that fire many sub-workflows.
+            const childPrivate = childCtx._PRIVATE_;
+            if (childPrivate?.listenerCleanup && !childPrivate.listenerCleanup.signal.aborted) {
+                childPrivate.listenerCleanup.abort();
+            }
+        }
+        // === 7. Apply parent persistence + return child's response ===
+        // Mirrors HTTP function-call semantics: parent reads child output
+        // at `$.state[<this.name>]`. Child author controls the shape via
+        // `@blokjs/respond` (or the last step's natural output).
+        //
+        // Persistence-helper call mirrors the RuntimeAdapterNode pattern
+        // (RuntimeAdapterNode.ts:100). The parent step's `as` / `spread`
+        // / `ephemeral` knobs apply identically here — sub-workflow
+        // output is just data, persistence rules are uniform.
+        const result = { success: !childCtx.response?.error, data: childCtx.response };
+        applyStepOutput(ctx, this, result);
+        return {
+            success: result.success,
+            data: childCtx.response,
+            error: childCtx.response?.error ?? null,
+        };
+    }
+    /**
+     * Fire-and-forget dispatch (Tier 2 #4 follow-up — `wait: false`).
+     *
+     * Schedules the child runner via `setImmediate` so the parent step
+     * can return immediately. Child errors are caught and routed to
+     * `tracker.failRun(childRunId, err)` — visible in Studio, NOT
+     * propagated to the parent step (which has already returned). Also
+     * logged via `console.error` for ops visibility.
+     *
+     * Parent step's output is the dispatch metadata `{runId,
+     * workflowName, scheduledAt}` — NOT the child's response (which
+     * doesn't exist yet). Caller polls `GET /__blok/runs/<runId>` for
+     * the actual outcome.
+     */
+    dispatchAsync(parentCtx, childRunner, childCtx, childRunId, childWorkflowName) {
+        const scheduledAt = Date.now();
+        const tracker = RunTracker.getInstance();
+        setImmediate(() => {
+            void (async () => {
+                try {
+                    await childRunner.run(childCtx);
+                    if (childRunId)
+                        tracker.completeRun(childRunId, childCtx.response);
+                }
+                catch (err) {
+                    if (childRunId) {
+                        tracker.failRun(childRunId, err instanceof Error ? err : new Error(String(err)));
+                    }
+                    console.error(`[blok][subworkflow] async child '${childWorkflowName}' (run ${childRunId ?? "?"}) failed:`, err instanceof Error ? err.stack || err.message : err);
+                }
+                finally {
+                    // PR 1 follow-up · A3 fix. Same listener-cleanup hook as the
+                    // sync path so async sub-workflows also auto-remove the
+                    // parent.signal listener on completion.
+                    const childPrivate = childCtx._PRIVATE_;
+                    if (childPrivate?.listenerCleanup && !childPrivate.listenerCleanup.signal.aborted) {
+                        childPrivate.listenerCleanup.abort();
+                    }
+                }
+            })();
+        });
+        // Parent step's output: dispatch metadata (the runId is the
+        // canonical handle for at-most-once dispatch deduplication when
+        // combined with `idempotencyKey`).
+        const dispatchData = {
+            runId: childRunId ?? null,
+            workflowName: childWorkflowName,
+            scheduledAt,
+        };
+        const result = { success: true, data: dispatchData };
+        applyStepOutput(parentCtx, this, result);
+        return {
+            success: true,
+            data: dispatchData,
+            error: null,
+        };
+    }
+}
+//# sourceMappingURL=SubworkflowNode.js.map

package/dist/SubworkflowNode.js.map

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