@blokjs/runner 0.4.0 → 0.6.0

package/dist/workflow/sampleBody.js

@@ -0,0 +1,320 @@
+/**
+ * Sample-body inference for the Studio empty-state curl snippet.
+ *
+ * Generates a JSON payload shape that a workflow's HTTP trigger
+ * would accept, so the "no runs yet" curl example on the workflow
+ * detail page can show an example body that actually exercises the
+ * workflow — instead of the previous `-d '{}'` which immediately
+ * crashed every workflow that read from `ctx.request.body`.
+ *
+ * Two layers (B + A in the design discussion):
+ *
+ *   B. Static analysis. Walk every step's inputs + control-flow
+ *      expressions, collect every `ctx.request.body.<path>` and
+ *      `$.req.body.<path>` reference, and build a nested object
+ *      mirroring those paths. Array shapes are inferred from
+ *      `forEach.in` references — if a path feeds a forEach, it's
+ *      an array, and references to `ctx.state.<asVar>.<sub>` inside
+ *      the body translate back into element-shape fields.
+ *
+ *   A. Author override. If the workflow declares
+ *      `trigger.http.examples.body: {...}`, that value wins
+ *      verbatim and the static inference is skipped.
+ *
+ * Inference is best-effort and intentionally permissive — the
+ * placeholder values are "string" everywhere, since the goal is to
+ * produce a payload that satisfies the workflow's *shape*, not its
+ * semantics. A workflow author who cares about value semantics
+ * declares an explicit example.
+ */
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Read author-declared examples from the workflow's trigger config.
+ * Returns the raw body value (whatever the author wrote) when
+ * `trigger.http.examples.body` is set.
+ */
+function readAuthorOverride(workflow) {
+    if (!isPlainObject(workflow))
+        return undefined;
+    const trigger = workflow.trigger;
+    if (!isPlainObject(trigger))
+        return undefined;
+    const http = trigger.http;
+    if (!isPlainObject(http))
+        return undefined;
+    const examples = http.examples;
+    if (!isPlainObject(examples))
+        return undefined;
+    return examples.body;
+}
+const BODY_REF_RE = /(?:ctx\.req(?:uest)?\.body|\$\.req\.body)\.([A-Za-z_][\w.]*)/g;
+const STATE_REF_RE = /(?:ctx\.state\.|\$\.state\.)([A-Za-z_]\w*)(?:\.([\w.]+))?/g;
+/**
+ * Extract dotted paths from a single string value. Handles both the
+ * `js/ctx.request.body.X.Y` form (used by JS expressions) and the
+ * `$.req.body.X.Y` form (the v2 DSL). Same regex matches both.
+ *
+ * Also resolves `ctx.state.<asVar>.X.Y` references against the
+ * current scope's `as` bindings — these come from inside a `forEach`
+ * or `loop` body and mean "field X.Y on the source array's elements."
+ */
+function extractRefs(value, scope) {
+    const out = [];
+    for (const m of value.matchAll(BODY_REF_RE)) {
+        const raw = m[1];
+        if (!raw)
+            continue;
+        out.push(raw.split(".").map((key) => ({ key, array: false })));
+    }
+    for (const m of value.matchAll(STATE_REF_RE)) {
+        const asVar = m[1];
+        const subPath = m[2];
+        if (!asVar)
+            continue;
+        const sourcePath = scope.get(asVar);
+        if (!sourcePath)
+            continue;
+        const tail = subPath ? subPath.split(".").map((key) => ({ key, array: false })) : [];
+        out.push([...sourcePath, ...tail]);
+    }
+    return out;
+}
+/**
+ * Recursively scan ANY value for body references. Strings get the
+ * regex treatment. Objects and arrays are walked. Anything else is
+ * a no-op.
+ *
+ * When `markArray` is true, every top-level path collected from this
+ * value is flagged as referring to an array (used for `forEach.in`).
+ */
+function scanValueForRefs(value, scope, out, markArray) {
+    if (typeof value === "string") {
+        const refs = extractRefs(value, scope);
+        for (const ref of refs) {
+            if (markArray && ref.length > 0) {
+                // Clone + mark the LAST segment as the array. e.g. if `in`
+                // was `ctx.request.body.subscribers`, we want the
+                // `subscribers` segment marked as array — its children
+                // (added later from the forEach body) descend into the
+                // element shape.
+                const tail = ref[ref.length - 1];
+                if (tail) {
+                    const cloned = ref.map((s, i) => (i === ref.length - 1 ? { key: s.key, array: true } : s));
+                    out.push(cloned);
+                    continue;
+                }
+            }
+            out.push(ref);
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const v of value)
+            scanValueForRefs(v, scope, out, markArray);
+        return;
+    }
+    if (isPlainObject(value)) {
+        for (const v of Object.values(value))
+            scanValueForRefs(v, scope, out, markArray);
+    }
+}
+/**
+ * Look at a `forEach.in` value and return the body-path it references,
+ * so we can register that path as the source array for the `as`
+ * variable. Returns undefined if the expression doesn't resolve to a
+ * single body path (e.g. an inline literal array, a state-derived
+ * value, or a complex expression we can't statically resolve).
+ */
+function extractSinglePath(value, scope) {
+    if (typeof value !== "string")
+        return undefined;
+    const refs = extractRefs(value, scope);
+    if (refs.length !== 1)
+        return undefined;
+    return refs[0];
+}
+/**
+ * Walk a list of v2 steps + accumulate every body-path reference.
+ * Handles every v2 control-flow kind by recursing into the relevant
+ * sub-pipelines with an updated scope.
+ */
+function collectPaths(steps, scope, out) {
+    if (!Array.isArray(steps))
+        return;
+    for (const raw of steps) {
+        if (!isPlainObject(raw))
+            continue;
+        // Regular step inputs.
+        if (raw.inputs !== undefined) {
+            scanValueForRefs(raw.inputs, scope, out, false);
+        }
+        // Branch (condition + then/else).
+        if (isPlainObject(raw.branch)) {
+            const b = raw.branch;
+            if (typeof b.when === "string")
+                scanValueForRefs(b.when, scope, out, false);
+            collectPaths(b.then, scope, out);
+            collectPaths(b.else, scope, out);
+            continue;
+        }
+        // ForEach (in + as + do).
+        if (isPlainObject(raw.forEach)) {
+            const f = raw.forEach;
+            // The `in` expression — paths there are arrays.
+            scanValueForRefs(f.in, scope, out, true);
+            // Compute the source path for the `as` element scope. When the
+            // `in` expression resolves to a single body path, future
+            // `ctx.state.<asVar>.X` references inside the body get
+            // rewritten back into `<sourceArrayPath>[].X`.
+            const sourcePath = extractSinglePath(f.in, scope);
+            const innerScope = new Map(scope);
+            if (typeof f.as === "string" && sourcePath) {
+                // Mark the source path's tail as an array so descendants
+                // land inside the element shape.
+                const arrayPath = sourcePath.map((s, i) => ({
+                    key: s.key,
+                    array: i === sourcePath.length - 1 ? true : s.array,
+                }));
+                innerScope.set(f.as, arrayPath);
+            }
+            collectPaths(f.do, innerScope, out);
+            continue;
+        }
+        // Loop (while + do).
+        if (isPlainObject(raw.loop)) {
+            const l = raw.loop;
+            if (typeof l.while === "string")
+                scanValueForRefs(l.while, scope, out, false);
+            collectPaths(l.do, scope, out);
+            continue;
+        }
+        // Switch (on + cases + default).
+        if (isPlainObject(raw.switch)) {
+            const s = raw.switch;
+            scanValueForRefs(s.on, scope, out, false);
+            if (Array.isArray(s.cases)) {
+                for (const c of s.cases) {
+                    if (!isPlainObject(c))
+                        continue;
+                    scanValueForRefs(c.when, scope, out, false);
+                    collectPaths(c.do, scope, out);
+                }
+            }
+            collectPaths(s.default, scope, out);
+            continue;
+        }
+        // TryCatch (try + catch + finally). Last kind in the loop body,
+        // so no `continue` needed.
+        if (isPlainObject(raw.tryCatch)) {
+            const tc = raw.tryCatch;
+            collectPaths(tc.try, scope, out);
+            collectPaths(tc.catch, scope, out);
+            collectPaths(tc.finally, scope, out);
+        }
+    }
+}
+/**
+ * Build a nested JSON value from the collected path segments. Each
+ * path adds one branch to the tree. Array segments become `[{...}]`
+ * containers; scalar leaves become the literal string `"string"`.
+ *
+ * Merging is conservative — a path that ends at a leaf where an
+ * object already exists doesn't overwrite the object (a leaf is
+ * "we know this exists" not "this is a primitive"); a path that
+ * descends through a key currently set to `"string"` upgrades it
+ * to an object.
+ */
+function buildTreeFromPaths(paths) {
+    const root = {};
+    for (const path of paths) {
+        if (path.length === 0)
+            continue;
+        setPath(root, path);
+    }
+    return root;
+}
+function setPath(root, path) {
+    // Cursor that "node" walks. At each step it either steps into an
+    // object's key or into an array element.
+    let node = root;
+    for (let i = 0; i < path.length; i++) {
+        const seg = path[i];
+        if (!seg)
+            continue;
+        const isLast = i === path.length - 1;
+        const existing = node[seg.key];
+        if (seg.array) {
+            // The value at this key must be an array; descend into its
+            // (single) element so further segments add to the element's
+            // shape.
+            let arr;
+            if (Array.isArray(existing)) {
+                arr = existing;
+            }
+            else {
+                arr = [];
+                node[seg.key] = arr;
+            }
+            if (arr.length === 0)
+                arr.push({});
+            let elem = arr[0];
+            if (!isPlainObject(elem)) {
+                elem = {};
+                arr[0] = elem;
+            }
+            if (isLast) {
+                // `subscribers` referenced as the WHOLE array — no further
+                // segment to add. Leave the element as `{}`.
+                return;
+            }
+            node = elem;
+            continue;
+        }
+        if (isLast) {
+            if (existing === undefined) {
+                node[seg.key] = "string";
+            }
+            // Already an object/array → leave it; "string" → leave it.
+            return;
+        }
+        // Non-terminal scalar key — descend into the (possibly new) object.
+        if (existing === undefined || existing === "string") {
+            node[seg.key] = {};
+        }
+        const next = node[seg.key];
+        if (!isPlainObject(next)) {
+            // Existing value is an array or other shape we can't descend
+            // into via a scalar key — bail out for this path.
+            return;
+        }
+        node = next;
+    }
+}
+/**
+ * Infer a sample HTTP body for a workflow, or return the author's
+ * declared example. Returns `null` only when the workflow value is
+ * not a recognisable object — every other shape gets at least an
+ * `empty` result with `body: {}`.
+ *
+ * @param workflow The raw workflow JSON (the same value the
+ *   `WorkflowRegistry` stores). Accepts `unknown` because the API
+ *   surface that calls this — `TraceRouter` — keeps `definition`
+ *   typed loosely.
+ */
+export function inferSampleBody(workflow) {
+    if (!isPlainObject(workflow))
+        return null;
+    const override = readAuthorOverride(workflow);
+    if (override !== undefined) {
+        return { body: override, source: "author" };
+    }
+    const paths = [];
+    collectPaths(workflow.steps, new Map(), paths);
+    if (paths.length === 0) {
+        return { body: {}, source: "empty" };
+    }
+    return { body: buildTreeFromPaths(paths), source: "inferred" };
+}
+//# sourceMappingURL=sampleBody.js.map

package/dist/workflow/sampleBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampleBody.js","sourceRoot":"","sources":["../../src/workflow/sampleBody.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,SAAS,aAAa,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AA4BD;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,QAAiB;IAC5C,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,QAAQ,CAAC,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,WAAW,GAAG,+DAA+D,CAAC;AACpF,MAAM,YAAY,GAAG,4DAA4D,CAAC;AAElF;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,KAAa,EAAE,KAAiC;IACpE,MAAM,GAAG,GAAoB,EAAE,CAAC;IAEhC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,MAAM,IAAI,GAAkB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CACxB,KAAc,EACd,KAAiC,EACjC,GAAoB,EACpB,SAAkB;IAElB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,SAAS,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,2DAA2D;gBAC3D,kDAAkD;gBAClD,uDAAuD;gBACvD,uDAAuD;gBACvD,iBAAiB;gBACjB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACjC,IAAI,IAAI,EAAE,CAAC;oBACV,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC3F,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACjB,SAAS;gBACV,CAAC;YACF,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QACD,OAAO;IACR,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAClE,OAAO;IACR,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAClF,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,KAAc,EAAE,KAAiC;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAAc,EAAE,KAAiC,EAAE,GAAoB;IAC5F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO;IAElC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YAAE,SAAS;QAElC,uBAAuB;QACvB,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;QAED,kCAAkC;QAClC,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;YACrB,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5E,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACjC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACjC,SAAS;QACV,CAAC;QAED,0BAA0B;QAC1B,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;YACtB,gDAAgD;YAChD,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAEzC,+DAA+D;YAC/D,yDAAyD;YACzD,uDAAuD;YACvD,+CAA+C;YAC/C,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAC5C,yDAAyD;gBACzD,iCAAiC;gBACjC,MAAM,SAAS,GAAkB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC1D,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,KAAK,EAAE,CAAC,KAAK,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK;iBACnD,CAAC,CAAC,CAAC;gBACJ,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YACjC,CAAC;YACD,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;YACpC,SAAS;QACV,CAAC;QAED,qBAAqB;QACrB,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;gBAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9E,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/B,SAAS;QACV,CAAC;QAED,iCAAiC;QACjC,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;YACrB,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;wBAAE,SAAS;oBAChC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;oBAC5C,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;gBAChC,CAAC;YACF,CAAC;YACD,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACpC,SAAS;QACV,CAAC;QAED,gEAAgE;QAChE,2BAA2B;QAC3B,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC;YACxB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACjC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACnC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,kBAAkB,CAAC,KAA+B;IAC1D,MAAM,IAAI,GAAgB,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAChC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,IAAiB,EAAE,IAAmB;IACtD,iEAAiE;IACjE,yCAAyC;IACzC,IAAI,IAAI,GAAgB,IAAI,CAAC;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,MAAM,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACf,2DAA2D;YAC3D,4DAA4D;YAC5D,SAAS;YACT,IAAI,GAAc,CAAC;YACnB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,GAAG,GAAG,QAAQ,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACP,GAAG,GAAG,EAAE,CAAC;gBACT,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACrB,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,IAAI,GAAG,EAAE,CAAC;gBACV,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACf,CAAC;YACD,IAAI,MAAM,EAAE,CAAC;gBACZ,2DAA2D;gBAC3D,6CAA6C;gBAC7C,OAAO;YACR,CAAC;YACD,IAAI,GAAG,IAAmB,CAAC;YAC3B,SAAS;QACV,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YAC1B,CAAC;YACD,2DAA2D;YAC3D,OAAO;QACR,CAAC;QAED,oEAAoE;QACpE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,6DAA6D;YAC7D,kDAAkD;YAClD,OAAO;QACR,CAAC;QACD,IAAI,GAAG,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiB;IAChD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IAE/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@blokjs/runner",
-	"version": "0.4.0",
+	"version": "0.6.0",
 	"description": "",
 	"engines": {
 		"node": ">=18.0.0"
@@ -18,11 +18,6 @@
 		"sync:proto:fromroot": "mkdir -p src/adapters/grpc/proto/blok/runtime/v1 && cp ../../proto/blok/runtime/v1/runtime.proto src/adapters/grpc/proto/blok/runtime/v1/runtime.proto",
 		"test:dev": "vitest",
 		"test": "vitest run",
-		"test:integration": "vitest run --config vitest.integration.config.ts",
-		"test:integration:dev": "vitest --config vitest.integration.config.ts",
-		"test:integration:coverage": "vitest run --config vitest.integration.config.ts --coverage",
-		"test:parity": "vitest run --config vitest.integration.config.ts __tests__/integration/parity",
-		"test:all": "vitest run && vitest run --config vitest.integration.config.ts",
 		"typecheck": "tsc --noEmit --incremental"
 	},
 	"devDependencies": {
@@ -38,8 +33,8 @@
 		"vitest": "^4.0.18"
 	},
 	"dependencies": {
-		"@blokjs/helper": "^0.4.0",
-		"@blokjs/shared": "^0.4.0",
+		"@blokjs/helper": "workspace:*",
+		"@blokjs/shared": "workspace:*",
 		"@grpc/grpc-js": "^1.12.0",
 		"@grpc/proto-loader": "^0.7.13",
 		"@opentelemetry/api": "^1.9.0",

package/dist/adapters/HttpRuntimeAdapter.d.ts

@@ -1,79 +0,0 @@
-import type { Context } from "@blokjs/shared";
-import type RunnerNode from "../RunnerNode";
-import type { ExecutionResult, RuntimeAdapter, RuntimeKind } from "./RuntimeAdapter";
-/**
- * Configuration options for HttpRuntimeAdapter
- */
-export interface HttpRuntimeAdapterOptions {
-    /** Request timeout in milliseconds (default: 30000) */
-    timeoutMs?: number;
-}
-/**
- * HttpRuntimeAdapter executes nodes in pre-existing SDK containers via HTTP.
- *
- * Unlike DockerRuntimeAdapter, this adapter does NOT manage container lifecycle.
- * It connects to already-running containers (managed externally by Docker Compose,
- * Kubernetes, or any other orchestrator).
- *
- * All SDK containers implement the same HTTP contract:
- * - POST /execute  — Execute a node with the provided context
- * - GET  /health   — Return container health status
- *
- * Environment variables per language:
- *   RUNTIME_GO_HOST / RUNTIME_GO_PORT
- *   RUNTIME_RUST_HOST / RUNTIME_RUST_PORT
- *   RUNTIME_JAVA_HOST / RUNTIME_JAVA_PORT
- *   RUNTIME_CSHARP_HOST / RUNTIME_CSHARP_PORT
- *   RUNTIME_PHP_HOST / RUNTIME_PHP_PORT
- *   RUNTIME_RUBY_HOST / RUNTIME_RUBY_PORT
- *   RUNTIME_PYTHON3_HOST / RUNTIME_PYTHON3_PORT
- */
-export declare class HttpRuntimeAdapter implements RuntimeAdapter {
-    readonly kind: RuntimeKind;
-    readonly transport: "http";
-    private baseUrl;
-    private timeoutMs;
-    constructor(kind: RuntimeKind, host: string, port: number, options?: HttpRuntimeAdapterOptions);
-    /**
-     * Execute a node in the SDK container via HTTP POST /execute
-     */
-    execute(node: RunnerNode, ctx: Context): Promise<ExecutionResult>;
-    /**
-     * Create the ExecutionRequest payload for the SDK container.
-     *
-     * Sends two shapes in the same envelope so the migration to the new
-     * canonical wire format is backward-compatible:
-     *
-     *   1. **Legacy keys** — `node.config` + `context.{request,response,vars,env}`.
-     *      Existing SDK HTTP servers (Rust, Python, Go HTTP, others) read
-     *      these keys today and keep working unchanged.
-     *
-     *   2. **New canonical keys** — `step` / `inputs` / `trigger` / `state` /
-     *      `workflow`. Same field names + structure as the gRPC proto so SDK
-     *      authors who adopt the new shape get a uniform mental model across
-     *      transports. The "inputs unwrapped at the wire layer" property
-     *      (FIXES.md #3) holds for both shapes.
-     *
-     * Data flow priority for the legacy `request.body`:
-     * 1. If the node has resolved inputs (from the blueprint Mapper), use
-     *    those as `request.body` so workflows that define explicit inputs
-     *    like `"chain": "js/ctx.response.data.chain"` keep working.
-     * 2. Otherwise, fall back to `ctx.response.data` (previous step output)
-     *    enabling zero-config chaining for SDK nodes that read body fields.
-     *
-     * The new `trigger.body` always reflects the actual trigger body
-     * (`ctx.request?.body`) — separated from inputs at the wire layer.
-     *
-     * Deprecation timeline: legacy keys will be removed in the next minor
-     * version once SDK HTTP servers have all adopted the new shape.
-     */
-    private createExecutionRequest;
-    /**
-     * Check if the SDK container is healthy via GET /health
-     */
-    checkHealth(): Promise<boolean>;
-    /**
-     * Get the base URL for this adapter
-     */
-    getBaseUrl(): string;
-}

package/dist/adapters/HttpRuntimeAdapter.js

@@ -1,233 +0,0 @@
-/**
- * HttpRuntimeAdapter executes nodes in pre-existing SDK containers via HTTP.
- *
- * Unlike DockerRuntimeAdapter, this adapter does NOT manage container lifecycle.
- * It connects to already-running containers (managed externally by Docker Compose,
- * Kubernetes, or any other orchestrator).
- *
- * All SDK containers implement the same HTTP contract:
- * - POST /execute  — Execute a node with the provided context
- * - GET  /health   — Return container health status
- *
- * Environment variables per language:
- *   RUNTIME_GO_HOST / RUNTIME_GO_PORT
- *   RUNTIME_RUST_HOST / RUNTIME_RUST_PORT
- *   RUNTIME_JAVA_HOST / RUNTIME_JAVA_PORT
- *   RUNTIME_CSHARP_HOST / RUNTIME_CSHARP_PORT
- *   RUNTIME_PHP_HOST / RUNTIME_PHP_PORT
- *   RUNTIME_RUBY_HOST / RUNTIME_RUBY_PORT
- *   RUNTIME_PYTHON3_HOST / RUNTIME_PYTHON3_PORT
- */
-export class HttpRuntimeAdapter {
-    kind;
-    transport = "http";
-    baseUrl;
-    timeoutMs;
-    constructor(kind, host, port, options) {
-        this.kind = kind;
-        this.baseUrl = `http://${host}:${port}`;
-        this.timeoutMs = options?.timeoutMs ?? 30000;
-    }
-    /**
-     * Execute a node in the SDK container via HTTP POST /execute
-     */
-    async execute(node, ctx) {
-        const startTime = performance.now();
-        try {
-            const request = this.createExecutionRequest(node, ctx);
-            const response = await fetch(`${this.baseUrl}/execute`, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify(request),
-                signal: AbortSignal.timeout(this.timeoutMs),
-            });
-            if (!response.ok) {
-                // Read the error response body — SDK containers return structured error details
-                // that would otherwise be lost (e.g. validation messages, stack traces)
-                let errorDetail = "";
-                try {
-                    const errorBody = (await response.json());
-                    const errors = errorBody?.errors;
-                    errorDetail = errors?.message || JSON.stringify(errors) || "";
-                }
-                catch {
-                    try {
-                        errorDetail = await response.text();
-                    }
-                    catch {
-                        /* body not readable */
-                    }
-                }
-                throw new Error(`HTTP runtime '${this.kind}' at ${this.baseUrl} returned HTTP ${response.status}: ${response.statusText}${errorDetail ? ` — ${errorDetail}` : ""}`);
-            }
-            const result = (await response.json());
-            const duration_ms = performance.now() - startTime;
-            return {
-                success: result.success ?? true,
-                data: result.data,
-                errors: result.errors || null,
-                logs: result.logs,
-                metrics: {
-                    duration_ms,
-                    ...(result.metrics || {}),
-                },
-                vars: result.vars,
-            };
-        }
-        catch (error) {
-            const duration_ms = performance.now() - startTime;
-            return {
-                success: false,
-                data: null,
-                errors: {
-                    message: error.message,
-                    stack: error.stack,
-                    name: error.name,
-                },
-                metrics: {
-                    duration_ms,
-                },
-            };
-        }
-    }
-    /**
-     * Create the ExecutionRequest payload for the SDK container.
-     *
-     * Sends two shapes in the same envelope so the migration to the new
-     * canonical wire format is backward-compatible:
-     *
-     *   1. **Legacy keys** — `node.config` + `context.{request,response,vars,env}`.
-     *      Existing SDK HTTP servers (Rust, Python, Go HTTP, others) read
-     *      these keys today and keep working unchanged.
-     *
-     *   2. **New canonical keys** — `step` / `inputs` / `trigger` / `state` /
-     *      `workflow`. Same field names + structure as the gRPC proto so SDK
-     *      authors who adopt the new shape get a uniform mental model across
-     *      transports. The "inputs unwrapped at the wire layer" property
-     *      (FIXES.md #3) holds for both shapes.
-     *
-     * Data flow priority for the legacy `request.body`:
-     * 1. If the node has resolved inputs (from the blueprint Mapper), use
-     *    those as `request.body` so workflows that define explicit inputs
-     *    like `"chain": "js/ctx.response.data.chain"` keep working.
-     * 2. Otherwise, fall back to `ctx.response.data` (previous step output)
-     *    enabling zero-config chaining for SDK nodes that read body fields.
-     *
-     * The new `trigger.body` always reflects the actual trigger body
-     * (`ctx.request?.body`) — separated from inputs at the wire layer.
-     *
-     * Deprecation timeline: legacy keys will be removed in the next minor
-     * version once SDK HTTP servers have all adopted the new shape.
-     */
-    createExecutionRequest(node, ctx) {
-        const nodeConfig = ctx.config
-            ? ctx.config[node.name]
-            : {};
-        // Check if the Mapper has resolved inputs for this node
-        // The Mapper runs BEFORE run() in NodeBase.process(), so by now
-        // config[node.name].inputs has resolved values (not raw js/ expressions)
-        const resolvedInputs = nodeConfig?.inputs;
-        // Use resolved inputs if available, otherwise fall back to previous step data
-        const legacyRequestBody = resolvedInputs || (ctx.response?.data ?? {});
-        // Unwrap the {inputs: {...}} wrapper that comes from @blokjs/helper StepNode.
-        // SDK nodes expect config to contain the inputs directly (e.g. config.operation),
-        // not wrapped as config.inputs.operation.
-        const unwrappedConfig = resolvedInputs || nodeConfig?.inputs || nodeConfig || {};
-        const stepInfo = ctx._stepInfo;
-        const headers = ctx.request?.headers ?? {};
-        const params = ctx.request?.params ?? {};
-        const query = ctx.request?.query ?? {};
-        const cookies = ctx.request?.cookies ?? {};
-        const method = ctx.request?.method ?? "";
-        const url = ctx.request?.url ?? "";
-        const baseUrl = ctx.request?.baseUrl ?? "";
-        return {
-            // ===== Legacy keys (kept for one minor for backward compat) =====
-            node: {
-                name: node.node,
-                type: node.type,
-                version: "",
-                config: unwrappedConfig,
-            },
-            context: {
-                id: ctx.id,
-                workflow_name: ctx.workflow_name,
-                workflow_path: ctx.workflow_path,
-                request: {
-                    body: legacyRequestBody,
-                    headers,
-                    params,
-                    query,
-                    method,
-                    url,
-                    cookies,
-                    baseUrl,
-                },
-                response: {
-                    data: null,
-                    contentType: "application/json",
-                    success: true,
-                    error: null,
-                },
-                vars: ctx.vars ?? {},
-                env: ctx.env ?? {},
-            },
-            // ===== New canonical keys (mirror the gRPC proto v1 schema) =====
-            step: {
-                name: stepInfo?.name ?? node.name,
-                index: stepInfo?.index ?? 0,
-                total: stepInfo?.total ?? 1,
-                depth: stepInfo?.depth ?? 0,
-            },
-            inputs: unwrappedConfig,
-            trigger: {
-                body: ctx.request?.body ?? null,
-                headers,
-                params,
-                query,
-                cookies,
-                method,
-                url,
-                baseUrl,
-                triggerKind: "",
-            },
-            state: {
-                previousOutput: ctx.response?.data ?? null,
-                vars: ctx.vars ?? {},
-                env: ctx.env ?? {},
-            },
-            workflow: {
-                runId: ctx.id,
-                name: ctx.workflow_name ?? "",
-                path: ctx.workflow_path ?? "",
-                version: "",
-            },
-        };
-    }
-    /**
-     * Check if the SDK container is healthy via GET /health
-     */
-    async checkHealth() {
-        try {
-            const response = await fetch(`${this.baseUrl}/health`, {
-                method: "GET",
-                signal: AbortSignal.timeout(5000),
-            });
-            if (response.ok) {
-                const data = (await response.json());
-                return data.status === "healthy" || data.status === "ok";
-            }
-            return false;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Get the base URL for this adapter
-     */
-    getBaseUrl() {
-        return this.baseUrl;
-    }
-}
-//# sourceMappingURL=HttpRuntimeAdapter.js.map