@openapi-flow/n8n 0.0.0-stage → 0.3.0

package/dist/nodes/request/runtime/request-runtime.bundle.js

@@ -0,0 +1,24 @@
+/*! MIT License
+
+Copyright (c) 2026 carefreelife98
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+ */
+var OpenApiFlowRequestRuntime;
+(()=>{function b(e){if(e==="")return[];if(!e.startsWith("/")||/~(?![01])/u.test(e))throw new Error(`Invalid JSON Pointer: ${e}`);return e.slice(1).split("/").map(t=>t.replaceAll("~1","/").replaceAll("~0","~"))}function A(e,t){let r=e;for(let i of b(t)){if(r===null||typeof r!="object"||!Object.hasOwn(r,i))return;r=Reflect.get(r,i)}return r}function H(e,t){return A(e,t)!==void 0}function y(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function x(e){if(e.includes(!1))return!1;let t=e.filter(r=>r!==!0);return t.length?t.length===1?t[0]:{allOf:t}:!0}function M(e){if(e.includes(!0))return!0;let t=e.filter(r=>r!==!1);return t.length?t.length===1?t[0]:{anyOf:t}:!1}function q(e,t){if(typeof e=="boolean")return e;if(e.type!==void 0&&!(Array.isArray(e.type)?e.type:[e.type]).includes(t))return!1;for(let r of["allOf","anyOf","oneOf"]){if(!Array.isArray(e[r]))continue;let i=e[r].map(o=>(typeof o=="boolean"||y(o))&&q(o,t));if(r==="allOf"?!i.every(Boolean):!i.some(Boolean))return!1}return!0}function B(e,t,r){let i=new Map;function o(n,a,s=["object","array"]){if(typeof n=="boolean")return n;if(!a.length)return r?r.reference(n):n;if(r&&typeof n.$ref=="string"){let p=JSON.stringify([a,s]),u=i.get(n)??new Set;if(u.has(p))throw new Error(`Native pointer projection has a non-progressing reference cycle at ${t}`);u.add(p),i.set(n,u);let m={...n};delete m.$ref;try{return x([o(r.resolve(n),a,s),o(m,a,s)])}finally{u.delete(p)}}let[f,...l]=a,d=s.filter(p=>q(n,p)),j=[];if(d.includes("object")){let p=[];if(y(n.properties)&&Object.hasOwn(n.properties,f)){let u=n.properties[f];(typeof u=="boolean"||y(u))&&p.push(o(u,l))}if(y(n.patternProperties))for(let[u,m]of Object.entries(n.patternProperties))new RegExp(u).test(f)&&(typeof m=="boolean"||y(m))&&p.push(o(m,l));if(!p.length){let u=n.additionalProperties;p.push(u===void 0?!0:typeof u=="boolean"||y(u)?o(u,l):!1)}j.push(x(p))}if(d.includes("array")&&/^(0|[1-9][0-9]*)$/.test(f)){let p=Number(f),u=Array.isArray(n.prefixItems)?n.prefixItems:[],m=p<u.length?u[p]:n.items;j.push(typeof n.maxItems=="number"&&p>=n.maxItems?!1:m===void 0?!0:typeof m=="boolean"||y(m)?o(m,l):!1)}let R=[M(j)];for(let p of["allOf","anyOf","oneOf"]){if(!Array.isArray(n[p]))continue;let u=n[p].map(m=>typeof m=="boolean"||y(m)?o(m,a,d):!1);R.push(p==="allOf"?x(u):M(u))}return x(R)}let c=o(e,b(t));return c===!1?[]:[c]}function w(e,t){if(e===null||typeof e!="object"||Array.isArray(e))throw new Error(`${t} must be an object`);return e}function I(e,t){let r=w(e,t);if(r.$ref!==void 0)throw new Error(`${t} has an unresolved $ref`);return r}function U(e,t){if(e.operation.requestBody===void 0){if(t!==void 0)throw new Error(`${e.key.operationRef} has no requestBody for ${t}`);return}let r=w(e.operation.requestBody,`${e.key.operationRef}.requestBody`),i=w(r.content,`${e.key.operationRef}.requestBody.content`),o=Object.keys(i),c=t===void 0&&o.length===1?o[0]:t;if(c===void 0)throw new Error(`${e.key.operationRef}.requestMediaType must explicitly select one of ${o.join(", ")}`);if(!Object.hasOwn(i,c))throw new Error(`${e.key.operationRef}.requestBody.content has no ${c}`);let n=w(i[c],`${e.key.operationRef}.requestBody.content.${c}`);return n.schema===void 0?!0:typeof n.schema=="boolean"?n.schema:w(n.schema,`${c}.schema`)}function v(e,t){if(e.schema!==void 0)return typeof e.schema=="boolean"?e.schema:w(e.schema,`${t}.schema`);let r=w(e.content,`${t}.content`),i=Object.keys(r);if(i.length!==1)throw new Error(`${t}.content must have one media type`);let o=w(r[i[0]],`${t}.content.${i[0]}`);return o.schema===void 0?!0:typeof o.schema=="boolean"?o.schema:w(o.schema,`${t}.schema`)}function D(e,t){let[r,i,...o]=b(t);if(r==="body"){let s=U(e.operation,e.requestMediaType);return s===void 0?[]:B(s,t.slice(5))}let c=e.operation.effective.parameters.find(s=>s.in===r&&s.name===i);if(!c)return[];let n=v(c,t),a=o.length?"/"+o.map(s=>s.replaceAll("~","~0").replaceAll("/","~1")).join("/"):"";return B(n,a)}function P(e,t){if(["/path","/query","/header","/cookie","/querystring"].includes(t))return"object";let r=new Set;for(let i of D(e,t))q(i,"object")&&r.add("object"),q(i,"array")&&r.add("array");if(r.size!==1)throw new Error(`Request ${e.callId}${t} needs an explicit literal container: OAS does not determine object versus array`);return r.has("array")?"array":"object"}function C(e,t,r,i){function o(n){if(Array.isArray(n))return n.map(o);if(n===null||typeof n!="object")return n;let a=Object.create(null);for(let[s,f]of Object.entries(n))a[s]=o(f);return a}let c=o(JSON.parse(JSON.stringify(e)));for(let n of t){if(!Object.hasOwn(r,n.sourceNodeId))throw new Error(`Missing response node ${n.sourceNodeId}`);let a=A(r[n.sourceNodeId],n.sourcePointer);if(a===void 0)throw new Error(`Missing response pointer ${n.sourceNodeId}${n.sourcePointer}`);let s=b(n.targetPointer);if(!s.length)throw new Error("binding target must identify a request field");let f=c;for(let[l,d]of s.entries())if(l===s.length-1){if(Object.hasOwn(f,d))throw new Error(`Literal conflicts with binding ${n.targetPointer}`);if(Array.isArray(f)&&!/^(0|[1-9][0-9]*)$/.test(d))throw new Error(`Binding array index is invalid ${n.targetPointer}`);Reflect.set(f,d,o(a))}else{if(!Object.hasOwn(f,d)){let R="/"+s.slice(0,l+1).map(u=>u.replaceAll("~","~0").replaceAll("/","~1")).join("/"),p=P(i,R)==="array"?[]:Object.create(null);Reflect.set(f,d,p)}let j=Reflect.get(f,d);if(!j||typeof j!="object")throw new Error(`Binding traverses non-container ${n.targetPointer}`);f=j}}return JSON.parse(JSON.stringify(c))}var h=class extends Error{operationRef;constructor(t,r){super(r),this.name="UnsupportedOperationError",this.operationRef=t}};function g(e,t,r){throw new h(t,`operationRef ${t} parameter ${e.in}.${e.name} ${r}`)}function z(e,t,r){return typeof r=="string"||typeof r=="boolean"||typeof r=="number"&&Number.isFinite(r)?r:g(e,t,"requires a scalar value")}function $(e,t){let r=encodeURIComponent(String(e)).replace(/[!'()*]/g,i=>"%"+i.charCodeAt(0).toString(16).toUpperCase());return t?r.replace(/%(3A|2F|3F|23|5B|5D|40|21|24|26|27|28|29|2A|2B|2C|3B|3D)/gi,i=>String.fromCharCode(Number.parseInt(i.slice(1),16))):r}function S(e,t,r,i){return Array.isArray(r)?r.map(o=>i(z(e,t,o))):y(r)?Object.entries(r).flatMap(([o,c])=>[i(o),i(z(e,t,c))]):[i(z(e,t,r))]}function J(e,t,r){if(e.contentMediaType!=="application/json")return g(e,t,"has no content mapping");let i=JSON.stringify(r);return i===void 0?g(e,t,"cannot be JSON serialized"):i}function L(e,t,r){if(e.contentMediaType)return $(J(e,t,r),!1);let o=S(e,t,r,n=>$(n,e.allowReserved)),c=y(r);if(e.style==="simple")return!c||!e.explode?o.join(","):o.flatMap((n,a)=>a%2===0?[n+"="+o[a+1]]:[]).join(",");if(e.style==="label")return!c||!e.explode?"."+o.join(e.explode?".":","):"."+o.flatMap((n,a)=>a%2===0?[n+"="+o[a+1]]:[]).join(".");if(e.style==="matrix"){let n=$(e.name,!1);return e.explode?c?o.flatMap((a,s)=>s%2===0?[";"+a+"="+o[s+1]]:[]).join(""):o.map(a=>";"+n+"="+a).join(""):";"+n+"="+o.join(",")}return g(e,t,`style ${e.style} is not a path style`)}function N(e,t,r){let i=$(e.name,!1);if(e.contentMediaType)return[i+"="+$(J(e,t,r),!1)];let c=S(e,t,r,a=>$(a,e.allowReserved)),n=y(r);return e.style==="deepObject"?n?c.flatMap((a,s)=>s%2===0?[i+"%5B"+a+"%5D="+c[s+1]]:[]):g(e,t,"deepObject requires an object"):e.style==="form"?e.explode?n?c.flatMap((a,s)=>s%2===0?[a+"="+c[s+1]]:[]):c.map(a=>i+"="+a):[i+"="+c.join(",")]:(e.style==="spaceDelimited"||e.style==="pipeDelimited")&&!e.explode&&(n||Array.isArray(r))?[i+"="+c.join(e.style==="spaceDelimited"?"%20":"%7C")]:g(e,t,`style ${e.style} is not mapped for query`)}function K(e,t,r){if(e.contentMediaType)return J(e,t,r);if(e.style!=="simple")return g(e,t,`style ${e.style} is not a header style`);let i=S(e,t,r,String),o=y(r)&&e.explode?i.flatMap((c,n)=>n%2===0?[c+"="+i[n+1]]:[]).join(","):i.join(",");if(/[\r\n]/.test(o))throw new Error(`plan.inputs.header.${e.name} must not contain a newline`);return o}function Q(e,t,r){if(e.contentMediaType)return g(e,t,"cookie content needs a declared escaping strategy");if(e.style!=="form"&&e.style!=="cookie")return g(e,t,`style ${e.style} is not a cookie style`);let i=e.style==="cookie"?a=>String(a):a=>$(a,e.allowReserved),o=S(e,t,r,i),c=i(e.name);if(!e.explode&&(y(r)||Array.isArray(r)))return g(e,t,"explode:false produces invalid Cookie syntax");let n=y(r)?o.flatMap((a,s)=>s%2===0?[a+"="+o[s+1]]:[]):o.map(a=>c+"="+a);return n.some(a=>[...a].some(s=>{let f=s.charCodeAt(0);return f<=32||f===34||f===44||f===59||f===92||f===127}))?g(e,t,"value is not valid Cookie syntax"):n}function k(e){return encodeURIComponent(e.toWellFormed()).replace(/[!'()~]/g,t=>"%"+t.charCodeAt(0).toString(16).toUpperCase()).replaceAll("%20","+")}function Y(e){let t=e.type==="array"&&y(e.items)?e.items.type:e.type;if(t==="object"||t==="array")return"application/json";if(["string","number","integer","boolean"].includes(String(t)))return"text/plain"}function Z(e,t,r,i,o){if(i!=="application/json"&&i!=="text/plain")throw new h(o,`operationRef ${o}.requestBody field ${e} contentType ${i} has no form mapping`);let c=Array.isArray(t)?t:[t];if(c.length===0)return[];let n=[];for(let a of c){if(i==="text/plain"&&typeof a=="object")throw new h(o,`operationRef ${o}.requestBody field ${e} cannot use text/plain for a complex value`);i==="application/json"?n.push(k(e)+"="+k(JSON.stringify(a))):n.push(k(e)+"="+k(String(a)))}if(r.contentEncoding!==void 0)throw new h(o,`operationRef ${o}.requestBody field ${e} contentEncoding requires explicit binary serialization`);return n}function _(e,t,r){let i=`operationRef ${e}.requestBody.schema.properties.${r}`,o=t.properties[r];if(o!==void 0){if(typeof o=="boolean")throw new h(e,`${i} does not define a form encoding type`);return I(o,i)}if(y(t.schema)&&t.schema.additionalProperties!==void 0&&typeof t.schema.additionalProperties!="boolean")return I(t.schema.additionalProperties,`operationRef ${e}.requestBody.schema.additionalProperties`);throw new h(e,`operationRef ${e}.requestBody field ${r} has no schema to determine form encoding`)}function T(e,t,r){let i=[];for(let[o,c]of Object.entries(r)){let n=_(e,t,o),a=t.encoding?.[o],s=a===void 0?void 0:I(a,`operationRef ${e}.requestBody.encoding.${o}`);if(s?.encoding!==void 0||s?.prefixEncoding!==void 0||s?.itemEncoding!==void 0)throw new h(e,`operationRef ${e}.requestBody field ${o} needs nested encoding`);if(s?.style!==void 0||s?.explode!==void 0||s?.allowReserved!==void 0){let d=typeof s?.style=="string"?s.style:"form",j={name:o,in:"query",required:!1,schema:n,style:d,explode:typeof s?.explode=="boolean"?s.explode:d==="form",allowReserved:s?.allowReserved===!0};i.push(...N(j,e,c));continue}let l=typeof s?.contentType=="string"?s.contentType:Y(n);if(l===void 0)throw new h(e,`operationRef ${e}.requestBody field ${o} has no form content mapping`);i.push(...Z(o,c,n,l,e))}return i.join("&")}function V(e){if(!e||!Number.isInteger(e.statusCode))throw new Error("API response.statusCode is required");if(!e.headers||typeof e.headers!="object"||Array.isArray(e.headers))throw new Error("API response.headers is required");let t=Object.entries(e.headers).filter(([i])=>i.toLowerCase()==="content-type");if(t.length>1)throw new Error("API response.headers has ambiguous Content-Type");let r={statusCode:e.statusCode};if(t.length){if(typeof t[0][1]!="string")throw new Error("API response Content-Type must be a string");r.mediaType=t[0][1].split(";")[0].trim().toLowerCase()}return Object.hasOwn(e,"body")&&(r.body=e.body),r}function E(e){if(b(e.rootPointer),e.requestedInputs===void 0)return[];if(!Array.isArray(e.requestedInputs))throw new Error(`${e.source}.requestedInputs must be an array`);let t=new Set;return e.requestedInputs.filter(r=>{if(typeof r!="string"||!b(r).length||t.has(r))throw new Error(`${e.source}.requestedInputs must contain distinct non-root JSON Pointers`);if(t.add(r),r!==e.rootPointer&&!r.startsWith(e.rootPointer+"/"))throw new Error(`${e.source}.requestedInputs contains ${r} outside ${e.rootPointer}`);return!H(e.value,r.slice(e.rootPointer.length))})}function O(e){if(Array.isArray(e))return e.map(O);if(e===null||typeof e!="object")return e;let t=Object.create(null);for(let[r,i]of Object.entries(e))t[r]=O(i);return t}function F(e,t,r,i){let o=b(t);if(!o.length||!["path","query","header","cookie","querystring","body"].includes(o[0]))throw new Error("confirmed input must identify a request field");let c=O(JSON.parse(JSON.stringify(e))),n=c;for(let[a,s]of o.entries()){if(Array.isArray(n)&&(!/^(0|[1-9][0-9]*)$/.test(s)||Number(s)>n.length))throw new Error(`confirmed input ${t} requires an explicit complete array prefix`);if(a===o.length-1){if(Object.hasOwn(n,s))throw new Error(`Request value conflicts with confirmed input ${t}`);Reflect.set(n,s,O(r))}else{if(!Object.hasOwn(n,s)){let l="/"+o.slice(0,a+1).map(d=>d.replaceAll("~","~0").replaceAll("/","~1")).join("/");Reflect.set(n,s,P(i,l)==="array"?[]:Object.create(null))}let f=Reflect.get(n,s);if(f===null||typeof f!="object")throw new Error(`confirmed input traverses non-container ${t}`);n=f}}return JSON.parse(JSON.stringify(c))}function W(e){return/(token|secret|password|authorization|api.?key)/i.test(e)}function G(e,t,r,i){let o=t,c=[],n=[],a=[];for(let l of e.parameters){let d=r[l.in]?.[l.name];if(d!==void 0)switch(l.in){case"path":o=o.replace(encodeURIComponent("{"+l.name+"}"),L(l,e.operationRef,d));break;case"query":c.push(...N(l,e.operationRef,d));break;case"header":n.push({name:l.name,value:K(l,e.operationRef,d)});break;case"cookie":a.push(...Q(l,e.operationRef,d));break}}if(c.length&&(o+="?"+c.join("&")),a.length&&n.push({name:"Cookie",value:a.join("; ")}),r.body===void 0)return{url:o,headers:n};if(!e.body)throw new Error(`${e.operationRef} has no request body`);let s=Object.keys(e.body.mediaTypes),f=i??(s.length===1?s[0]:void 0);if(!f||!Object.hasOwn(e.body.mediaTypes,f))throw new Error(`${e.operationRef}: requestMediaType must select a declared body media type`);if(n.push({name:"Content-Type",value:f}),r.body!==null&&typeof r.body=="object"&&!Array.isArray(r.body)){for(let l of Object.keys(r.body))if(W(l))throw new Error(`body.${l} looks like a credential; use credentialBindings`)}if(f==="application/json")return{url:o,headers:n,body:{contentType:"json",value:JSON.stringify(r.body)}};if(f!=="application/x-www-form-urlencoded")throw new h(e.operationRef,`requestBody media type ${f} has no n8n mapping`);if(!r.body||typeof r.body!="object"||Array.isArray(r.body))throw new Error("form-urlencoded body must be an object");return{url:o,headers:n,body:{contentType:"form-urlencoded",value:T(e.operationRef,e.body.mediaTypes[f],r.body)}}}function X(e,t,r,i){let o=JSON.parse(JSON.stringify(e.arguments.values));for(let s of e.deferredInputs?.slots??[]){if(!i||!Object.hasOwn(i,s.id))throw new Error(`Missing runtime input ${s.id} for ${s.callId}${s.targetPointer}`);o=F(o,s.targetPointer,i[s.id],{callId:e.arguments.callId,operation:e.contract,requestMediaType:e.arguments.requestMediaType})}let c=C(o,e.arguments.bindings,t,{callId:e.arguments.callId,operation:e.contract,requestMediaType:e.arguments.requestMediaType});if(!r(c))throw new Error(`Runtime request ${e.arguments.callId} does not match the OAS schema: ${JSON.stringify(r.errors)}`);let n=E({source:`Runtime request ${e.arguments.callId}`,rootPointer:"",value:c,requestedInputs:e.arguments.requestedInputs});if(n.length)throw new Error(`Runtime request ${e.arguments.callId} omits scenario-requested inputs: ${n.join(", ")}`);let a=G(e.operation,e.templateUrl,c,e.arguments.requestMediaType);return{...a,headersJson:JSON.stringify(Object.fromEntries(a.headers.map(s=>[s.name,s.value])))}}OpenApiFlowRequestRuntime={materializeHttpRequest:X,apiResponseValidationValue:V,pointerValue:A,listMissingRequestedApiInputs:E};})();

package/dist/nodes/request/serialization/create-serialized-http-request-node.d.ts

@@ -0,0 +1,3 @@
+import type { SerializedHttpRequestNodeInput } from '../../../types/serialized-http-request.js';
+/** File response mode disables n8n JSON transport encoding, so send serialized text. */
+export declare function createSerializedHttpRequestNode(input: SerializedHttpRequestNodeInput): import("@n8n/workflow-sdk").NodeInstance<string, `${number}`, unknown>;

package/dist/nodes/request/serialization/create-serialized-http-request-node.js

@@ -0,0 +1,17 @@
+import { httpRequestNode } from '../../../legacy/workflow/request/http-request-node.js';
+/** File response mode disables n8n JSON transport encoding, so send serialized text. */
+export function createSerializedHttpRequestNode(input) {
+    const request = httpRequestNode(input);
+    if (input.body === undefined || input.body.contentType !== 'json')
+        return request;
+    // JSON Body is itself a JSON-encoded node parameter. n8n parses this envelope
+    // into the serializer's wire text, then sends that text with json=false.
+    // Keep JSON mode: unlike Raw mode, it also sends DELETE request bodies.
+    request.config.parameters = {
+        ...request.config.parameters,
+        jsonBody: input.bodySource === 'literal'
+            ? JSON.stringify(input.body.value)
+            : '={{ JSON.stringify($json.body.value) }}',
+    };
+    return request;
+}

package/dist/nodes/request/serialization/serialize-http-request.d.ts

@@ -0,0 +1,5 @@
+import type { ApiArgumentValues } from '@openapi-flow/core';
+import type { Operation } from '@openapi-flow/core/internal';
+import type { MaterializedHttpRequest } from '../../../types/request-materialization.js';
+/** Pure transport mapping, shared by literal and runtime-bound requests. */
+export declare function serializeHttpRequest(operation: Operation, templateUrl: string, values: ApiArgumentValues, requestMediaType?: string): MaterializedHttpRequest;

package/dist/nodes/request/serialization/serialize-http-request.js

@@ -0,0 +1,70 @@
+import { serializePathParameter, serializeQueryParameter, serializeHeaderParameter, serializeCookieParameter, serializeFormBody, UnsupportedOperationError, } from '@openapi-flow/core/runtime';
+import { looksLikeCredential } from '../authentication/credential-field-name.js';
+/** Pure transport mapping, shared by literal and runtime-bound requests. */
+export function serializeHttpRequest(operation, templateUrl, values, requestMediaType) {
+    let url = templateUrl;
+    const query = [];
+    const headers = [];
+    const cookies = [];
+    for (const parameter of operation.parameters) {
+        const value = values[parameter.in]?.[parameter.name];
+        if (value === undefined)
+            continue;
+        switch (parameter.in) {
+            case 'path':
+                url = url.replace(encodeURIComponent('{' + parameter.name + '}'), serializePathParameter(parameter, operation.operationRef, value));
+                break;
+            case 'query':
+                query.push(...serializeQueryParameter(parameter, operation.operationRef, value));
+                break;
+            case 'header':
+                headers.push({
+                    name: parameter.name,
+                    value: serializeHeaderParameter(parameter, operation.operationRef, value),
+                });
+                break;
+            case 'cookie':
+                cookies.push(...serializeCookieParameter(parameter, operation.operationRef, value));
+                break;
+        }
+    }
+    if (query.length)
+        url += '?' + query.join('&');
+    if (cookies.length)
+        headers.push({ name: 'Cookie', value: cookies.join('; ') });
+    if (values.body === undefined)
+        return { url, headers };
+    if (!operation.body)
+        throw new Error(`${operation.operationRef} has no request body`);
+    const declared = Object.keys(operation.body.mediaTypes);
+    const mediaType = requestMediaType ?? (declared.length === 1 ? declared[0] : undefined);
+    if (!mediaType || !Object.hasOwn(operation.body.mediaTypes, mediaType))
+        throw new Error(`${operation.operationRef}: requestMediaType must select a declared body media type`);
+    headers.push({ name: 'Content-Type', value: mediaType });
+    if (values.body !== null &&
+        typeof values.body === 'object' &&
+        !Array.isArray(values.body))
+        for (const name of Object.keys(values.body))
+            if (looksLikeCredential(name))
+                throw new Error(`body.${name} looks like a credential; use credentialBindings`);
+    if (mediaType === 'application/json')
+        return {
+            url,
+            headers,
+            body: { contentType: 'json', value: JSON.stringify(values.body) },
+        };
+    if (mediaType !== 'application/x-www-form-urlencoded')
+        throw new UnsupportedOperationError(operation.operationRef, `requestBody media type ${mediaType} has no n8n mapping`);
+    if (!values.body ||
+        typeof values.body !== 'object' ||
+        Array.isArray(values.body))
+        throw new Error('form-urlencoded body must be an object');
+    return {
+        url,
+        headers,
+        body: {
+            contentType: 'form-urlencoded',
+            value: serializeFormBody(operation.operationRef, operation.body.mediaTypes[mediaType], values.body),
+        },
+    };
+}

package/dist/public-api.d.ts

@@ -0,0 +1,43 @@
+export { compileInboundWorkflow } from './legacy/workflow/inbound/compile-inbound-workflow.js';
+export type * from './types/legacy/inbound-workflow.js';
+export { createHttpRequestNode } from './nodes/request/create-http-request-node.js';
+export { assembleN8nWorkflow } from './workflow/assemble-n8n-workflow.js';
+export type * from './types/node-fragment.js';
+export type * from './types/request-deployment.js';
+export { httpRequestDeploymentOptionsSchema } from './schemas/request-deployment-schema.js';
+export type * from './types/workflow-compilation.js';
+export { compileReviewableN8nWorkflow } from './workflow/compile-reviewable-n8n-workflow.js';
+export type * from './types/reviewable-workflow.js';
+export { createN8nNativeCapabilities } from './nodes/native/create-native-capabilities.js';
+export { resolveN8nNativeFeatures } from './nodes/native/registry/resolve-n8n-native-features.js';
+export { resolveN8nNativePlanningFeatures } from './nodes/native/registry/resolve-n8n-native-planning-features.js';
+export { N8nNativeFeature } from './types/native-feature-registry.js';
+export type { N8nNativeFeatureContext, ResolveN8nNativeFeaturesInput, ReadyN8nNativeFeature, PendingN8nNativeFeature, N8nNativeFeatureRegistration, N8nNativeFeatureRegistry, N8nNativePlanningFeatureRegistry, N8nNativeFeaturePlanningDefinition, N8nNativeArrayContextRequirement, N8nNativeJsonOutputContextRequirement, N8nNativeFeatureContextRequirement, } from './types/native-feature-registry.js';
+export { createJsonOutputCapability } from './nodes/native/create-json-output-capability.js';
+export { createPassThroughCapability } from './nodes/native/create-pass-through-capability.js';
+export { createExclusiveBranchMergeCapability } from './nodes/native/create-exclusive-branch-merge-capability.js';
+export { createN8nNativeOutputSources } from './workflow/create-n8n-native-output-sources.js';
+export type * from './types/output-binding-source.js';
+export { compilePlannedN8nWorkflow } from './workflow/compile-planned-n8n-workflow.js';
+export { n8nNativeInputConfigurationSchema } from './schemas/native-runtime-input-schema.js';
+export { compileN8nWorkflowTemplate } from './workflow/templates/compile-n8n-workflow-template.js';
+export type { CompileN8nWorkflowTemplateInput, N8nTemplateContext, N8nTemplateDeployment, N8nTemplateInputSlot, N8nTemplateNodeMapping, N8nTemplateDeploymentRequirement, N8nWorkflowTemplateResult, } from './types/workflow-template.js';
+export type * from './types/native-capability.js';
+export type { N8nNativeRuntimeInput, PrependNativeParameterGuardInput, N8nNativeInputConfiguration, N8nNativeInputSlot, N8nNativeInputTemplate, } from './types/native-runtime-parameters.js';
+export { prependNativeParameterGuard } from './nodes/native/inputs/prepend-native-parameter-guard.js';
+export { resolveHttpRequestAuthentication } from './nodes/request/authentication/resolve-http-request-authentication.js';
+export type * from './types/authentication.js';
+export { createResponseArrayCapability } from './nodes/native/create-response-array-capability.js';
+export type * from './types/array-iteration.js';
+export { createNativeArrayCapability } from './nodes/native/arrays/create-native-array-capability.js';
+export type * from './types/native-array.js';
+export { createResponseCollectionCapability } from './nodes/native/create-response-collection-capability.js';
+export type * from './types/response-collection.js';
+export { createItemJoinCapability } from './nodes/native/item-join/create-item-join-capability.js';
+export type * from './types/item-join.js';
+export { compileBatchedN8nWorkflow } from './workflow/batch/compile-batched-n8n-workflow.js';
+export type { N8nBatchExecutionScope, CompileBatchedN8nWorkflowInput, } from './types/batch-execution.js';
+export { describeN8nManualTrigger } from './workflow/entrypoint/manual-trigger.js';
+export { selectN8nTemplateDeployments } from './workflow/templates/select-n8n-template-deployments.js';
+export { resolveN8nNativeMaterials } from './workflow/resolve-n8n-native-materials.js';
+export type { ResolveN8nNativeMaterialsInput, ResolvedN8nNativeMaterials, } from './types/native-material-binding.js';

package/dist/public-api.js

@@ -0,0 +1,26 @@
+export { compileInboundWorkflow } from './legacy/workflow/inbound/compile-inbound-workflow.js';
+export { createHttpRequestNode } from './nodes/request/create-http-request-node.js';
+export { assembleN8nWorkflow } from './workflow/assemble-n8n-workflow.js';
+export { httpRequestDeploymentOptionsSchema } from './schemas/request-deployment-schema.js';
+export { compileReviewableN8nWorkflow } from './workflow/compile-reviewable-n8n-workflow.js';
+export { createN8nNativeCapabilities } from './nodes/native/create-native-capabilities.js';
+export { resolveN8nNativeFeatures } from './nodes/native/registry/resolve-n8n-native-features.js';
+export { resolveN8nNativePlanningFeatures } from './nodes/native/registry/resolve-n8n-native-planning-features.js';
+export { N8nNativeFeature } from './types/native-feature-registry.js';
+export { createJsonOutputCapability } from './nodes/native/create-json-output-capability.js';
+export { createPassThroughCapability } from './nodes/native/create-pass-through-capability.js';
+export { createExclusiveBranchMergeCapability } from './nodes/native/create-exclusive-branch-merge-capability.js';
+export { createN8nNativeOutputSources } from './workflow/create-n8n-native-output-sources.js';
+export { compilePlannedN8nWorkflow } from './workflow/compile-planned-n8n-workflow.js';
+export { n8nNativeInputConfigurationSchema } from './schemas/native-runtime-input-schema.js';
+export { compileN8nWorkflowTemplate } from './workflow/templates/compile-n8n-workflow-template.js';
+export { prependNativeParameterGuard } from './nodes/native/inputs/prepend-native-parameter-guard.js';
+export { resolveHttpRequestAuthentication } from './nodes/request/authentication/resolve-http-request-authentication.js';
+export { createResponseArrayCapability } from './nodes/native/create-response-array-capability.js';
+export { createNativeArrayCapability } from './nodes/native/arrays/create-native-array-capability.js';
+export { createResponseCollectionCapability } from './nodes/native/create-response-collection-capability.js';
+export { createItemJoinCapability } from './nodes/native/item-join/create-item-join-capability.js';
+export { compileBatchedN8nWorkflow } from './workflow/batch/compile-batched-n8n-workflow.js';
+export { describeN8nManualTrigger } from './workflow/entrypoint/manual-trigger.js';
+export { selectN8nTemplateDeployments } from './workflow/templates/select-n8n-template-deployments.js';
+export { resolveN8nNativeMaterials } from './workflow/resolve-n8n-native-materials.js';

package/dist/schemas/batch-execution-schema.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const batchExecutionScopeSchema: z.ZodObject<{
+    id: z.ZodString;
+    batchSize: z.ZodNumber;
+    nodeIds: z.ZodArray<z.ZodString>;
+    entryNodeId: z.ZodString;
+    exitNodeId: z.ZodString;
+}, z.core.$strict>;
+export declare const batchExecutionScopesSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    batchSize: z.ZodNumber;
+    nodeIds: z.ZodArray<z.ZodString>;
+    entryNodeId: z.ZodString;
+    exitNodeId: z.ZodString;
+}, z.core.$strict>>;

package/dist/schemas/batch-execution-schema.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const batchExecutionScopeSchema = z.strictObject({
+    id: z
+        .string()
+        .min(1)
+        .regex(/\S/, 'batch id must not contain only whitespace'),
+    batchSize: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+    nodeIds: z.array(z.string().min(1)).min(1),
+    entryNodeId: z.string().min(1),
+    exitNodeId: z.string().min(1),
+});
+export const batchExecutionScopesSchema = z
+    .array(batchExecutionScopeSchema)
+    .min(1);

package/dist/schemas/create-native-comparison-planning-schema.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import type { WorkflowCapabilityPlanningContext } from '@openapi-flow/core';
+export declare function createIfPlanningParametersSchema(context: WorkflowCapabilityPlanningContext): z.ZodObject<{
+    combinator: z.ZodEnum<{
+        and: "and";
+        or: "or";
+    }>;
+    conditions: z.ZodArray<z.ZodObject<{
+        operator: z.ZodEnum<{
+            equals: "equals";
+            notEquals: "notEquals";
+            greaterThan: "greaterThan";
+            lessThan: "lessThan";
+            keysEqual: "keysEqual";
+        }>;
+        left: z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodLiteral<"response">;
+            pointer: z.ZodString;
+            nodeId: z.ZodEnum<{
+                [x: string]: string;
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>]>;
+        right: z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodLiteral<"response">;
+            pointer: z.ZodString;
+            nodeId: z.ZodEnum<{
+                [x: string]: string;
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare function createAssertionPlanningParametersSchema(context: WorkflowCapabilityPlanningContext): z.ZodObject<{
+    checks: z.ZodArray<z.ZodObject<{
+        operator: z.ZodEnum<{
+            equals: "equals";
+            notEquals: "notEquals";
+            greaterThan: "greaterThan";
+            lessThan: "lessThan";
+            keysEqual: "keysEqual";
+        }>;
+        message: z.ZodString;
+        left: z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodLiteral<"response">;
+            pointer: z.ZodString;
+            nodeId: z.ZodEnum<{
+                [x: string]: string;
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>]>;
+        right: z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodLiteral<"response">;
+            pointer: z.ZodString;
+            nodeId: z.ZodEnum<{
+                [x: string]: string;
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;

package/dist/schemas/create-native-comparison-planning-schema.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { nativeOperandSchema, nativeCheckSchema, ifParametersSchema, assertionParametersSchema, } from './native-capability-schemas.js';
+function createPlanningCheckSchema({ apiCallIds, }) {
+    const literal = nativeOperandSchema.options[1];
+    const operand = apiCallIds.length === 0
+        ? literal
+        : z.union([
+            nativeOperandSchema.options[0].extend({
+                nodeId: z
+                    .enum(apiCallIds)
+                    .describe('Exact supplied API callId; choose a response source, never create an ID.'),
+            }),
+            literal,
+        ]);
+    return nativeCheckSchema.extend({ left: operand, right: operand });
+}
+export function createIfPlanningParametersSchema(context) {
+    return ifParametersSchema.extend({
+        conditions: z
+            .array(createPlanningCheckSchema(context))
+            .min(1)
+            .describe('Only conditions required by the scenario, with supplied API callIds and OAS-derived response pointers.'),
+    });
+}
+export function createAssertionPlanningParametersSchema(context) {
+    const check = createPlanningCheckSchema(context);
+    return assertionParametersSchema.extend({
+        checks: z
+            .array(assertionParametersSchema.shape.checks.element.extend({
+            left: check.shape.left,
+            right: check.shape.right,
+        }))
+            .min(1)
+            .describe('Declarative assertions over supplied API responses. Exact API callIds only; no invented references or model-written JavaScript.'),
+    });
+}

package/dist/schemas/exclusive-branch-merge-schema.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const exclusiveBranchMergeParametersSchema: z.ZodObject<{
+    sourceNodeId: z.ZodString;
+}, z.core.$strict>;

package/dist/schemas/exclusive-branch-merge-schema.js

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export const exclusiveBranchMergeParametersSchema = z.strictObject({
+    sourceNodeId: z
+        .string()
+        .min(1)
+        .describe('Existing IF instance whose true and false paths both reach this merge. Do not merge independent branches or discard an alternative.'),
+});

package/dist/schemas/item-join-schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const itemJoinParametersSchema: z.ZodObject<{
+    scopeNodeId: z.ZodString;
+    sourceCallIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare function createItemJoinParametersSchema(scopeIds: string[], callIds: string[]): z.ZodObject<{
+    scopeNodeId: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    sourceCallIds: z.ZodArray<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+}, z.core.$strict>;

package/dist/schemas/item-join-schema.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export const itemJoinParametersSchema = z.strictObject({
+    scopeNodeId: z
+        .string()
+        .min(1)
+        .describe('The supplied native item scope shared by every API branch.'),
+    sourceCallIds: z
+        .array(z.string().min(1))
+        .min(2)
+        .refine((ids) => new Set(ids).size === ids.length, 'sourceCallIds must be unique')
+        .describe('API call IDs in input-port order. Each participating scope item requires exactly one response from every call. Never business IDs or array-position matching.'),
+});
+export function createItemJoinParametersSchema(scopeIds, callIds) {
+    if (!scopeIds.length || callIds.length < 2)
+        throw new Error('item join requires supplied scopes and at least two API calls');
+    return itemJoinParametersSchema.extend({
+        scopeNodeId: z
+            .enum(scopeIds)
+            .describe('Only a supplied native scope, resolved through n8n item ancestry.'),
+        sourceCallIds: z
+            .array(z.enum(callIds))
+            .min(2)
+            .refine((ids) => new Set(ids).size === ids.length, 'sourceCallIds must be unique')
+            .describe('Existing API call IDs. input1 receives the first call, input2 the second, and so on. Code derives OAS contracts and linking metadata.'),
+    });
+}

package/dist/schemas/native-array-schema.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const nativeArrayParametersSchema: z.ZodObject<{
+    sourceNodeId: z.ZodString;
+    pointer: z.ZodString;
+}, z.core.$strict>;
+export declare function createNativeArrayParametersSchema(nodeIds: string[]): z.ZodObject<{
+    pointer: z.ZodString;
+    sourceNodeId: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+}, z.core.$strict>;

package/dist/schemas/native-array-schema.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export const nativeArrayParametersSchema = z.strictObject({
+    sourceNodeId: z
+        .string()
+        .min(1)
+        .describe('Existing native node ID with a declared JSON output contract containing the scenario-required array.'),
+    pointer: z
+        .string()
+        .describe('RFC 6901 pointer into the native JSON root selecting an array. Do not use an HTTP body prefix, flatten values or select a first element.'),
+});
+export function createNativeArrayParametersSchema(nodeIds) {
+    if (!nodeIds.length)
+        throw new Error('native array parameters require source node IDs');
+    return nativeArrayParametersSchema.extend({
+        sourceNodeId: z
+            .enum(nodeIds)
+            .describe('Only a supplied native node ID; code derives and validates its original output contract.'),
+    });
+}

package/dist/schemas/native-capability-schemas.d.ts

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+export declare const nativeOperandSchema: z.ZodUnion<readonly [z.ZodObject<{
+    source: z.ZodLiteral<"response">;
+    nodeId: z.ZodString;
+    pointer: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<"literal">;
+    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+}, z.core.$strict>]>;
+export declare const nativeCheckSchema: z.ZodObject<{
+    left: z.ZodUnion<readonly [z.ZodObject<{
+        source: z.ZodLiteral<"response">;
+        nodeId: z.ZodString;
+        pointer: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        source: z.ZodLiteral<"literal">;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    }, z.core.$strict>]>;
+    operator: z.ZodEnum<{
+        equals: "equals";
+        notEquals: "notEquals";
+        greaterThan: "greaterThan";
+        lessThan: "lessThan";
+        keysEqual: "keysEqual";
+    }>;
+    right: z.ZodUnion<readonly [z.ZodObject<{
+        source: z.ZodLiteral<"response">;
+        nodeId: z.ZodString;
+        pointer: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        source: z.ZodLiteral<"literal">;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export declare const ifParametersSchema: z.ZodObject<{
+    combinator: z.ZodEnum<{
+        and: "and";
+        or: "or";
+    }>;
+    conditions: z.ZodArray<z.ZodObject<{
+        left: z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodLiteral<"response">;
+            nodeId: z.ZodString;
+            pointer: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>]>;
+        operator: z.ZodEnum<{
+            equals: "equals";
+            notEquals: "notEquals";
+            greaterThan: "greaterThan";
+            lessThan: "lessThan";
+            keysEqual: "keysEqual";
+        }>;
+        right: z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodLiteral<"response">;
+            nodeId: z.ZodString;
+            pointer: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const mergeParametersSchema: z.ZodObject<{
+    numberInputs: z.ZodNumber;
+}, z.core.$strict>;
+export declare const assertionParametersSchema: z.ZodObject<{
+    checks: z.ZodArray<z.ZodObject<{
+        left: z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodLiteral<"response">;
+            nodeId: z.ZodString;
+            pointer: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>]>;
+        operator: z.ZodEnum<{
+            equals: "equals";
+            notEquals: "notEquals";
+            greaterThan: "greaterThan";
+            lessThan: "lessThan";
+            keysEqual: "keysEqual";
+        }>;
+        right: z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodLiteral<"response">;
+            nodeId: z.ZodString;
+            pointer: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            source: z.ZodLiteral<"literal">;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, z.core.$strict>]>;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const stopParametersSchema: z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const passThroughParametersSchema: z.ZodObject<{}, z.core.$strict>;

package/dist/schemas/native-capability-schemas.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+// Disjoint source literals retain the same validation contract with anyOf.
+// OpenAI-compatible strict tools reject the oneOf emitted by discriminatedUnion.
+export const nativeOperandSchema = z.union([
+    z.strictObject({
+        source: z.literal('response'),
+        nodeId: z
+            .string()
+            .min(1)
+            .describe('API callId whose response is guaranteed to have executed.'),
+        pointer: z
+            .string()
+            .describe('RFC 6901 pointer into the response body. Empty string means the whole body.'),
+    }),
+    z.strictObject({
+        source: z.literal('literal'),
+        value: z
+            .union([z.string(), z.number(), z.boolean(), z.null()])
+            .describe('An explicitly requested scalar comparison value; no expressions or code.'),
+    }),
+]);
+export const nativeCheckSchema = z.strictObject({
+    left: nativeOperandSchema,
+    operator: z
+        .enum(['equals', 'notEquals', 'greaterThan', 'lessThan', 'keysEqual'])
+        .describe('equals is deep, type-strict JSON equality. keysEqual compares object key sets. Numeric operators require numbers.'),
+    right: nativeOperandSchema,
+});
+export const ifParametersSchema = z.strictObject({
+    combinator: z
+        .enum(['and', 'or'])
+        .describe('Combine all conditions. Outputs: true, false; input: main.'),
+    conditions: z
+        .array(nativeCheckSchema)
+        .min(1)
+        .describe('Only conditions required by the scenario, with OAS-derived response pointers.'),
+});
+export const mergeParametersSchema = z.strictObject({
+    numberInputs: z
+        .number()
+        .int()
+        .min(2)
+        .describe('Append waits for ALL inputs named input1..inputN. Output: main. Never join mutually exclusive branches.'),
+});
+export const assertionParametersSchema = z.strictObject({
+    checks: z
+        .array(nativeCheckSchema.extend({
+        message: z
+            .string()
+            .min(1)
+            .describe('Actionable failure message for this scenario assertion.'),
+    }))
+        .min(1)
+        .describe('Declarative assertions over API responses; compiled to Code by the library, never model-written JavaScript. Input/output: main.'),
+});
+export const stopParametersSchema = z.strictObject({
+    message: z
+        .string()
+        .min(1)
+        .describe('StopAndError message when this branch executes. Input: main; no output.'),
+});
+export const passThroughParametersSchema = z.strictObject({});