@oomol-lab/open-flow 0.1.0-beta.74 → 0.1.0-beta.75

package/dist/common/control-requests.js

@@ -12285,14 +12285,186 @@ function decisionTask(questions = [defaultDecisionQuestion()], name = "AI Decisi
 	};
 }
 //#endregion
-//#region src/openapi/common/authBindings.ts
+//#region src/http/common/authBindings.ts
 /** Never allow credentials to enter a Revision as literal node inputs. */
-function assertOpenApiAuthBindings(document) {
+function assertHttpAuthBindings(document) {
 	for (const node of Object.values(document.graph.nodes)) {
-		if (node.kind != "task" || !("executor" in node.task) || node.task.executor.kind != "openapi") continue;
-		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && mapping.kind == "value") throw new TypeError("OpenAPI authentication accepts deployment variables and upstream outputs only.");
+		if (node.kind != "task" || !("executor" in node.task) || !["openapi", "http-request"].includes(node.task.executor.kind)) continue;
+		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && mapping.kind == "value") throw new TypeError("HTTP authentication accepts deployment variables and upstream outputs only.");
 	}
 }
+//#endregion
+//#region src/flow/common/portChanges.ts
+function renamedPort(previous, next) {
+	const previousNames = new Set(previous.flatMap((port) => "handle" in port ? [port.handle] : []));
+	const nextNames = new Set(next.flatMap((port) => "handle" in port ? [port.handle] : []));
+	const removed = [...previousNames].filter((name) => !nextNames.has(name));
+	const added = [...nextNames].filter((name) => !previousNames.has(name));
+	return removed.length == 1 && added.length == 1 ? [removed[0], added[0]] : void 0;
+}
+function renameOutputMapping(mapping, nodeIds, rename) {
+	if (rename == null || mapping.kind != "sources") return mapping;
+	const sources = mapping.sources.map((source) => source.kind == "node" && !source.system && nodeIds.has(source.nodeId) && source.output == rename[0] ? {
+		...source,
+		output: rename[1]
+	} : source);
+	return sources.every((source, index) => source === mapping.sources[index]) ? mapping : {
+		kind: "sources",
+		sources
+	};
+}
+/** Carry saved mappings through a field rename and remove only fields absent from the new contract. */
+function remapInputMappings(mappings, ports, rename) {
+	const inputs = { ...mappings };
+	if (rename != null && Object.hasOwn(inputs, rename[0])) {
+		Object.defineProperty(inputs, rename[1], {
+			value: inputs[rename[0]],
+			enumerable: true,
+			configurable: true,
+			writable: true
+		});
+		delete inputs[rename[0]];
+	}
+	const names = new Set(ports.flatMap((port) => "handle" in port ? [port.handle] : []));
+	for (const name of Object.keys(inputs)) if (!names.has(name)) delete inputs[name];
+	return inputs;
+}
+//#endregion
+//#region src/http/common/httpRequest.ts
+var parameterSchema = strictObject({
+	mode: _enum(["fields", "object"]).default("fields"),
+	names: array(string()).default([])
+});
+var httpRequestConfigSchema = strictObject({
+	method: _enum([
+		"GET",
+		"POST",
+		"PUT",
+		"PATCH",
+		"DELETE",
+		"HEAD",
+		"OPTIONS"
+	]).default("GET"),
+	query: parameterSchema.default({
+		mode: "fields",
+		names: []
+	}),
+	headers: parameterSchema.default({
+		mode: "fields",
+		names: []
+	}),
+	bodyFormat: _enum([
+		"none",
+		"json",
+		"text",
+		"form"
+	]).default("none"),
+	authentication: union([
+		strictObject({ type: literal("none") }),
+		strictObject({ type: _enum(["bearer", "basic"]) }),
+		strictObject({
+			type: literal("apiKey"),
+			name: string(),
+			in: _enum(["header", "query"])
+		})
+	]).default({ type: "none" }),
+	responseFormat: _enum([
+		"auto",
+		"json",
+		"text"
+	]).default("auto"),
+	statusPolicy: _enum(["success", "all"]).default("success")
+});
+var httpRequestExecutorSchema = httpRequestConfigSchema.extend({ kind: literal("http-request") });
+var scalarSchema = { type: [
+	"string",
+	"number",
+	"boolean"
+] };
+var queryValueSchema = { anyOf: [scalarSchema, {
+	type: "array",
+	items: scalarSchema
+}] };
+var httpHeaderSchema = {
+	type: "object",
+	additionalProperties: { type: "string" }
+};
+var httpQuerySchema = {
+	type: "object",
+	additionalProperties: queryValueSchema
+};
+function httpAuthHandles(config) {
+	return config.authentication.type == "none" ? [] : config.authentication.type == "basic" ? ["auth.username", "auth.password"] : ["auth.token"];
+}
+function retain(ports, old) {
+	const remaining = new Map(ports.map((port) => [port.handle, port]));
+	return [...old.flatMap((item) => {
+		if ("group" in item) return [item];
+		const next = remaining.get(item.handle);
+		if (next == null) return [];
+		remaining.delete(item.handle);
+		return [dequal(item.jsonSchema, next.jsonSchema) && item.nullable == next.nullable ? item : next];
+	}), ...remaining.values()];
+}
+function httpRequestTask(config = httpRequestConfigSchema.parse({}), name = "HTTP Request", previous) {
+	const inputs = [{
+		handle: "url",
+		jsonSchema: { type: "string" },
+		nullable: false
+	}];
+	for (const group of ["query", "headers"]) if (config[group].mode == "object") inputs.push({
+		handle: group,
+		jsonSchema: group == "query" ? httpQuerySchema : httpHeaderSchema,
+		nullable: true
+	});
+	else for (const parameterName of config[group].names.filter((value) => value.trim())) inputs.push({
+		handle: `${group == "query" ? "query" : "header"}.${parameterName}`,
+		jsonSchema: group == "query" ? queryValueSchema : { type: "string" },
+		nullable: true
+	});
+	if (config.bodyFormat != "none") inputs.push({
+		handle: "body",
+		jsonSchema: config.bodyFormat == "json" ? {} : config.bodyFormat == "text" ? { type: "string" } : httpQuerySchema,
+		nullable: config.bodyFormat == "json"
+	});
+	inputs.push(...httpAuthHandles(config).map((handle) => ({
+		handle,
+		jsonSchema: { type: "string" },
+		nullable: false
+	})));
+	const outputs = [
+		{
+			handle: "body",
+			jsonSchema: config.responseFormat == "text" ? { type: "string" } : {},
+			nullable: true
+		},
+		{
+			handle: "statusCode",
+			jsonSchema: { type: "integer" },
+			nullable: false
+		},
+		{
+			handle: "headers",
+			jsonSchema: httpHeaderSchema,
+			nullable: false
+		}
+	];
+	return {
+		name,
+		executor: {
+			...config,
+			kind: "http-request"
+		},
+		inputs: retain(inputs, previous?.inputs ?? []),
+		outputs: retain(outputs, previous?.outputs ?? [])
+	};
+}
+/** Only a named parameter rename carries a value; changing source modes is not a rename. */
+function httpRequestInputs(mappings, previous, next) {
+	const candidate = renamedPort(previous.inputs, next.inputs);
+	const rename = candidate != null && ["query.", "header."].some((prefix) => candidate.every((name) => name.startsWith(prefix))) ? candidate : void 0;
+	return remapInputMappings(mappings, next.inputs, rename);
+}
 function checkJsonDepth(value, depth = 0) {
 	if (depth > 64) throw new TypeError("Value exceeds the maximum JSON depth.");
 	if (value != null && typeof value == "object") for (const child of Object.values(value)) checkJsonDepth(child, depth + 1);
@@ -12303,6 +12475,7 @@ var retryNodeTypes = [
 	"code",
 	"connector",
 	"openapi",
+	"http-request",
 	"llm",
 	"decision"
 ];
@@ -12602,7 +12775,8 @@ var managedFields = object$1({
 			kind: literal("workflow"),
 			flowId: text$1,
 			revisionId: text$1
-		})
+		}),
+		httpRequestExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -12902,7 +13076,7 @@ function decodeRevisionContent(value) {
 	checkJsonDepth(value);
 	const content = revision.parse(value);
 	checkModelVersion(content);
-	assertOpenApiAuthBindings(content.document);
+	assertHttpAuthBindings(content.document);
 	return content;
 }
 var shapes = {
@@ -13096,6 +13270,7 @@ function changeOperationsSchema(kind) {
 	return toJSONSchema(schema, { io: "input" });
 }
 function checkModelVersion(content) {
+	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind == "http-request")) throw new TypeError("HTTP Request requires Flow model version 11.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && ("moduleId" in candidateNode.task ? candidateNode.task.capabilities?.some((item) => item.kind == "workflow") : candidateNode.task.executor.kind == "agent" && candidateNode.task.executor.tools.some((item) => item.kind == "workflow")))) throw new TypeError("Workflow tools require Flow model version 11.");
 	if (content.modelVersion < 10 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "webhook" && (candidateNode.options?.responseBody != null || candidateNode.options?.responseStatusCodeOutput != null || candidateNode.options?.responseHeadersSource != null || candidateNode.options?.responseHeaderOutputs != null))) throw new TypeError("Dynamic Webhook responses require Flow model version 10.");
 	if (content.modelVersion < 9 && Object.values(content.document.graph.nodes).some((candidateNode) => "retry" in candidateNode && candidateNode.retry != null)) throw new TypeError("Node retries require Flow model version 9.");
@@ -13696,6 +13871,7 @@ var authoringTypes = [
 	"llm",
 	"decision",
 	"openapi",
+	"http-request",
 	"condition",
 	"value",
 	"wait",
@@ -13822,6 +13998,7 @@ var authoringConfigurations = {
 	}),
 	"connector": authoringDefinitionSchemas.connector.omit({ outputMode: true }).strict(),
 	"openapi": authoringOpenApiSchema,
+	"http-request": httpRequestConfigSchema,
 	"agent": authoringDefinitionSchemas.agent.omit({
 		prompt: true,
 		tools: true
@@ -14070,21 +14247,21 @@ function authoringSchema(kind) {
 			"wait",
 			"approval"
 		].includes(kind),
-		guidance: kind == "webhook-response" ? "Prepare an HTTP response using fixed inputs body (any JSON, default empty text), statusCode (number, default 200) and headers (scalar-valued object, default {}). Select this node in Webhook options.responseBody as {kind: \"webhook-response\", nodeId: \"node reference\", timeoutMs: 30000}. Its first completion responds immediately while the Run continues. It has no business outputs. Multiple response nodes are allowed; each Webhook selects one reachable node." : kind == "outputs" ? "Declare output fields through config.outputDefs. Set their values through node.add.inputs or input.set. Outputs is a singleton execution sink; it waits for its predecessors and produces workflow business outputs independently of node logs. No downstream edges or data references to Outputs are allowed." : kind == "webhook" ? "Use options.responseBody: {kind: \"webhook-response\", nodeId: \"node ID or $alias\", timeoutMs: 30000} to respond on the selected node’s first completion while the Run continues. Body, statusCode and headers come exclusively from that node; clear workflow-output-only status/header references when switching. Alternatively configure options.responseBody as {kind: \"workflow-outputs\", output?: \"top-level output name\", timeoutMs?: 30000} to respond after the Run succeeds. Omit output for the complete object. Connect Webhook to Outputs. Timeout is 1000–60000 ms; HTTP timeout does not cancel the Run. Strings return text; other values return JSON. Only in this mode, options.responseStatusCodeOutput can select a numeric top-level workflow output as the HTTP status, overriding the preserved fixed responseStatusCode (default 200). Its runtime value must be an integer from 200 to 599, excluding 204, 205, 304; missing or invalid values return 500. Use responseHeaders for fixed text headers. In workflow-output mode, responseHeaderOutputs maps header names to top-level output names; values can be string, number or boolean and are converted to text. Alternatively responseHeadersSource: {kind: \"workflow-outputs\", output?: \"object field\"} replaces the entire header object (omit output for all outputs), preserving but ignoring per-header settings. Missing, null, complex or invalid header values return 500 without fallback. Header restrictions and Content-Type policy still apply. Omit responseBody for immediate responseData. Clear options.responseBody, options.responseStatusCodeOutput, options.responseHeadersSource and options.responseHeaderOutputs explicitly to switch back." : kind == "start" ? "Declare workflow inputs through config.inputDefs; read them in Start node details. REST calls and manual runs supply them as trigger.outputs. Downstream nodes bind these parameters as Start outputs. Start has no input sources or defaults; non-nullable parameters are required, and omitted nullable parameters become null." : kind == "condition" ? "Edit branch operands through config.branches. A branch can test one expression, all expressions, or any alternatives. Unmatched execution uses branch otherwise." : ["poll", "integration"].includes(kind) ? "Configure static parameters with node.add.inputs or input.set. Definitions come from the selected Trigger key; execution output and variable sources are unavailable." : kind == "llm" ? "Configure model settings, message templates and history as defaults. Input bindings with the same names override these defaults; named business inputs can be bound directly. Template strings interpolate {{name}}." : kind == "openapi" ? "Select an operation; the tool resolves its ports and authentication. Read authenticationChoices from node details. authentication is replaced as a complete choice. Bind advertised credentials through inputs." : kind == "workflow" ? "Select another workflow with config.flowId. A workflow cannot call itself, including in a disconnected node. Owned unpublished or unavailable targets may be saved as incomplete drafts. Use node.refresh to load the current published interface." : kind == "agent" ? "Tools accept Connector Actions or {kind: \"workflow\", flowId, name, description, approval, inputs}. Workflow parameter sources use model, input or value. The platform derives the interface. Refresh a workflow tool with node.refresh and tool: its name." : kind == "code" ? "Select workflows through config.capabilities: [{kind: \"workflow\", flowId, name}]. Call context.workflows.call(name, input) and await its business output. The platform derives input/output types. Refresh a selected workflow tool with node.refresh and tool: its name. Calls obey node and Run time limits." : "Supply business configuration and input data. Fixed definitions are assembled by the tool. Existing constraints and defaults are preserved on partial updates.",
+		guidance: kind == "webhook-response" ? "Prepare an HTTP response using fixed inputs body (any JSON, default empty text), statusCode (number, default 200) and headers (scalar-valued object, default {}). Select this node in Webhook options.responseBody as {kind: \"webhook-response\", nodeId: \"node reference\", timeoutMs: 30000}. Its first completion responds immediately while the Run continues. It has no business outputs. Multiple response nodes are allowed; each Webhook selects one reachable node." : kind == "outputs" ? "Declare output fields through config.outputDefs. Set their values through node.add.inputs or input.set. Outputs is a singleton execution sink; it waits for its predecessors and produces workflow business outputs independently of node logs. No downstream edges or data references to Outputs are allowed." : kind == "webhook" ? "Use options.responseBody: {kind: \"webhook-response\", nodeId: \"node ID or $alias\", timeoutMs: 30000} to respond on the selected node’s first completion while the Run continues. Body, statusCode and headers come exclusively from that node; clear workflow-output-only status/header references when switching. Alternatively configure options.responseBody as {kind: \"workflow-outputs\", output?: \"top-level output name\", timeoutMs?: 30000} to respond after the Run succeeds. Omit output for the complete object. Connect Webhook to Outputs. Timeout is 1000–60000 ms; HTTP timeout does not cancel the Run. Strings return text; other values return JSON. Only in this mode, options.responseStatusCodeOutput can select a numeric top-level workflow output as the HTTP status, overriding the preserved fixed responseStatusCode (default 200). Its runtime value must be an integer from 200 to 599, excluding 204, 205, 304; missing or invalid values return 500. Use responseHeaders for fixed text headers. In workflow-output mode, responseHeaderOutputs maps header names to top-level output names; values can be string, number or boolean and are converted to text. Alternatively responseHeadersSource: {kind: \"workflow-outputs\", output?: \"object field\"} replaces the entire header object (omit output for all outputs), preserving but ignoring per-header settings. Missing, null, complex or invalid header values return 500 without fallback. Header restrictions and Content-Type policy still apply. Omit responseBody for immediate responseData. Clear options.responseBody, options.responseStatusCodeOutput, options.responseHeadersSource and options.responseHeaderOutputs explicitly to switch back." : kind == "start" ? "Declare workflow inputs through config.inputDefs; read them in Start node details. REST calls and manual runs supply them as trigger.outputs. Downstream nodes bind these parameters as Start outputs. Start has no input sources or defaults; non-nullable parameters are required, and omitted nullable parameters become null." : kind == "condition" ? "Edit branch operands through config.branches. A branch can test one expression, all expressions, or any alternatives. Unmatched execution uses branch otherwise." : ["poll", "integration"].includes(kind) ? "Configure static parameters with node.add.inputs or input.set. Definitions come from the selected Trigger key; execution output and variable sources are unavailable." : kind == "llm" ? "Configure model settings, message templates and history as defaults. Input bindings with the same names override these defaults; named business inputs can be bound directly. Template strings interpolate {{name}}." : kind == "http-request" ? "Configure method, query/headers modes and names, bodyFormat, authentication, responseFormat and statusPolicy. Bind url, query.<name>/header.<name> or whole query/headers objects, body and auth.token (Basic: auth.username/auth.password). Credentials accept variables or upstream outputs only. Outputs: body, statusCode, headers. Authentication is replaced as a complete choice." : kind == "openapi" ? "Select an operation; the tool resolves its ports and authentication. Read authenticationChoices from node details. authentication is replaced as a complete choice. Bind advertised credentials through inputs." : kind == "workflow" ? "Select another workflow with config.flowId. A workflow cannot call itself, including in a disconnected node. Owned unpublished or unavailable targets may be saved as incomplete drafts. Use node.refresh to load the current published interface." : kind == "agent" ? "Tools accept Connector Actions or {kind: \"workflow\", flowId, name, description, approval, inputs}. Workflow parameter sources use model, input or value. The platform derives the interface. Refresh a workflow tool with node.refresh and tool: its name." : kind == "code" ? "Select workflows through config.capabilities: [{kind: \"workflow\", flowId, name}]. Call context.workflows.call(name, input) and await its business output. The platform derives input/output types. Refresh a selected workflow tool with node.refresh and tool: its name. Calls obey node and Run time limits." : "Supply business configuration and input data. Fixed definitions are assembled by the tool. Existing constraints and defaults are preserved on partial updates.",
 		example: {
 			op: "node.add",
 			as: "step",
 			type: kind,
 			name: "Step",
 			...{
-				start: { config: { inputDefs: {} } },
-				outputs: { config: { outputDefs: {} } },
-				workflow: { config: { flowId: "<Flow ID>" } },
-				connector: { config: {
+				"start": { config: { inputDefs: {} } },
+				"outputs": { config: { outputDefs: {} } },
+				"workflow": { config: { flowId: "<Flow ID>" } },
+				"connector": { config: {
 					action: "<Action ID>",
 					connectionId: "<Connection ID>"
 				} },
-				poll: { config: {
+				"poll": { config: {
 					key: "<Trigger key>",
 					schedule: [{
 						type: "every",
@@ -14092,20 +14269,27 @@ function authoringSchema(kind) {
 						value: 5
 					}]
 				} },
-				integration: { config: { key: "<Trigger key>" } },
-				openapi: { config: {
+				"integration": { config: { key: "<Trigger key>" } },
+				"http-request": {
+					config: {},
+					inputs: { url: {
+						kind: "value",
+						value: "https://example.com"
+					} }
+				},
+				"openapi": { config: {
 					sourceUrl: "https://example.com/openapi.json",
 					path: "/items",
 					method: "get"
 				} },
-				code: {
+				"code": {
 					code: "export default ({value}) => ({result:value})",
 					inputs: { value: {
 						kind: "value",
 						value: "Hello"
 					} }
 				},
-				condition: { config: {
+				"condition": { config: {
 					match: "first",
 					branches: [{
 						name: "yes",
@@ -14122,32 +14306,32 @@ function authoringSchema(kind) {
 						}
 					}]
 				} },
-				value: { config: { values: {
+				"value": { config: { values: {
 					threshold: 100,
 					region: "EU"
 				} } },
-				webhook: { config: {
+				"webhook": { config: {
 					method: "POST",
 					body: { orderId: {
 						schema: { type: "string" },
 						nullable: false
 					} }
 				} },
-				wait: {
+				"wait": {
 					prompt: "Continue processing this order?",
 					inputs: { order: {
 						kind: "value",
 						value: { orderId: "A-1" }
 					} }
 				},
-				approval: {
+				"approval": {
 					prompt: "Approve this order?",
 					inputs: { order: {
 						kind: "value",
 						value: { orderId: "A-1" }
 					} }
 				},
-				llm: {
+				"llm": {
 					config: {
 						model: { model: "deepseek-v4-flash" },
 						template: [{
@@ -14163,7 +14347,7 @@ function authoringSchema(kind) {
 						}
 					} }
 				},
-				agent: {
+				"agent": {
 					config: { model: "deepseek-v4-flash" },
 					inputs: { orders: {
 						kind: "value",
@@ -14999,7 +15183,7 @@ function applyFlowChanges(content, operations) {
 			break;
 		}
 	}
-	assertOpenApiAuthBindings(document);
+	assertHttpAuthBindings(document);
 	return upgradeDecodedRevisionContent({
 		document,
 		modelVersion: 11,
@@ -15266,42 +15450,6 @@ async function imports(source) {
 	}
 }
 //#endregion
-//#region src/flow/common/portChanges.ts
-function renamedPort(previous, next) {
-	const previousNames = new Set(previous.flatMap((port) => "handle" in port ? [port.handle] : []));
-	const nextNames = new Set(next.flatMap((port) => "handle" in port ? [port.handle] : []));
-	const removed = [...previousNames].filter((name) => !nextNames.has(name));
-	const added = [...nextNames].filter((name) => !previousNames.has(name));
-	return removed.length == 1 && added.length == 1 ? [removed[0], added[0]] : void 0;
-}
-function renameOutputMapping(mapping, nodeIds, rename) {
-	if (rename == null || mapping.kind != "sources") return mapping;
-	const sources = mapping.sources.map((source) => source.kind == "node" && !source.system && nodeIds.has(source.nodeId) && source.output == rename[0] ? {
-		...source,
-		output: rename[1]
-	} : source);
-	return sources.every((source, index) => source === mapping.sources[index]) ? mapping : {
-		kind: "sources",
-		sources
-	};
-}
-/** Carry saved mappings through a field rename and remove only fields absent from the new contract. */
-function remapInputMappings(mappings, ports, rename) {
-	const inputs = { ...mappings };
-	if (rename != null && Object.hasOwn(inputs, rename[0])) {
-		Object.defineProperty(inputs, rename[1], {
-			value: inputs[rename[0]],
-			enumerable: true,
-			configurable: true,
-			writable: true
-		});
-		delete inputs[rename[0]];
-	}
-	const names = new Set(ports.flatMap((port) => "handle" in port ? [port.handle] : []));
-	for (const name of Object.keys(inputs)) if (!names.has(name)) delete inputs[name];
-	return inputs;
-}
-//#endregion
 //#region src/flow/common/nodeChanges.ts
 var codeTaskTemplate = `export default async function (inputs, context) {
   return { result: inputs.value }
@@ -16263,7 +16411,10 @@ function authoringNode(content, ref) {
 			inputs: fieldsView([...task.inputs, ...node.kind == "task" ? node.additionalInputs ?? [] : []].filter((port) => !("handle" in port) || !llmReservedInputs.includes(port.handle)))
 		};
 		else if (task.executor.kind == "workflow") config = { flowId: task.executor.flowId };
-		else if (task.executor.kind == "openapi") config = { ...openApiConfigView(task.executor) };
+		else if (task.executor.kind == "http-request") {
+			const { kind: _kind, ...settings } = task.executor;
+			config = settings;
+		} else if (task.executor.kind == "openapi") config = { ...openApiConfigView(task.executor) };
 	} else if (node.kind == "task" && "moduleId" in node.task) {
 		config = {
 			inputs: fieldsView([...node.task.inputs, ...node.additionalInputs ?? []]),
@@ -16564,7 +16715,7 @@ async function compileAuthoring(base, request, host) {
 			const timing = record(record(patch.config).autoContinue);
 			if (Object.hasOwn(timing, "kind") && timing.kind != record(record(view.config).autoContinue).kind) record(update.config).autoContinue = timing;
 		}
-		if (type == "openapi" && Object.hasOwn(record(patch.config), "authentication")) record(update.config).authentication = record(patch.config).authentication;
+		if ((type == "openapi" || type == "http-request") && Object.hasOwn(record(patch.config), "authentication")) record(update.config).authentication = record(patch.config).authentication;
 		for (const path of clear) clearPath(update, path);
 		if (typeof update.name != "string") fail("node.name-required", "Node name cannot be cleared.");
 		const config = authoringConfigurations[type].parse(update.config);
@@ -16650,7 +16801,13 @@ async function compileAuthoring(base, request, host) {
 					};
 				} else task = await connectorTask(config, String(update.name));
 			} else if (type == "decision") task = decisionTask(config.questions, String(update.name));
-			else if (type == "openapi") task = await prepareOpenApiTask(config, before, (url) => host.openapi(url), String(update.name), {
+			else if (type == "http-request") {
+				task = httpRequestTask(httpRequestConfigSchema.parse(config), String(update.name), before);
+				next = {
+					...next,
+					inputs: httpRequestInputs(node.inputs, before, task)
+				};
+			} else if (type == "openapi") task = await prepareOpenApiTask(config, before, (url) => host.openapi(url), String(update.name), {
 				authentication: explicit("authentication"),
 				serverUrl: explicit("serverUrl")
 			});
@@ -16991,6 +17148,9 @@ async function compileAuthoring(base, request, host) {
 						case "connector":
 							changes = createManagedTask(identity, await connectorTask(config, name));
 							break;
+						case "http-request":
+							changes = createManagedTask(identity, httpRequestTask(httpRequestConfigSchema.parse(config), name));
+							break;
 						case "openapi":
 							changes = createManagedTask(identity, await prepareOpenApiTask(authoringConfigurations.openapi.parse(config), void 0, (url) => host.openapi(url), name));
 							break;
@@ -17209,6 +17369,7 @@ var descriptions = {
 	"poll": "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection.",
 	"integration": "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.",
 	"decision": "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running.",
+	"http-request": "A single HTTP request. Bind url and request inputs; outputs are body, statusCode and headers.",
 	"openapi": "A fixed JSON API operation. Replace the example document and URL before running.",
 	"connector": "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show. Set connectionId to an empty string to defer account configuration; execution will require an account.",
 	"code": "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions.",
@@ -17252,6 +17413,17 @@ function authoringExample(name) {
 				instructions: "Does the customer need support?"
 			}]);
 			break;
+		case "http-request":
+			operations = [...createManagedTask({ nodeId: "http" }, httpRequestTask()), {
+				kind: "graph.node.input.set",
+				nodeId: "http",
+				handle: "url",
+				value: {
+					kind: "value",
+					value: "https://example.com"
+				}
+			}];
+			break;
 		case "openapi":
 			operations = createManagedTask({ nodeId: "api" }, openApiTask(selectOperation({
 				openapi: "3.1.0",

package/dist/common/engine-contract.d.ts

@@ -6,6 +6,7 @@ export interface EngineContract {
     readonly waitAutoContinue?: boolean;
     readonly webhookResponses?: boolean;
     readonly workflowTools?: boolean;
+    readonly httpRequests?: boolean;
 }
 export declare const currentEngineContract = "open-flow-engine/v8";
 export declare const nodejsEngineContract = "open-flow-engine/v8/nodejs-compat-v1";

package/dist/common/flow-authoring.js

@@ -3009,12 +3009,12 @@ function decisionTask(questions = [defaultDecisionQuestion()], name = "AI Decisi
 	};
 }
 //#endregion
-//#region src/openapi/common/authBindings.ts
+//#region src/http/common/authBindings.ts
 /** Never allow credentials to enter a Revision as literal node inputs. */
-function assertOpenApiAuthBindings(document) {
+function assertHttpAuthBindings(document) {
 	for (const node of Object.values(document.graph.nodes)) {
-		if (node.kind != "task" || !("executor" in node.task) || node.task.executor.kind != "openapi") continue;
-		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && mapping.kind == "value") throw new TypeError("OpenAPI authentication accepts deployment variables and upstream outputs only.");
+		if (node.kind != "task" || !("executor" in node.task) || !["openapi", "http-request"].includes(node.task.executor.kind)) continue;
+		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && mapping.kind == "value") throw new TypeError("HTTP authentication accepts deployment variables and upstream outputs only.");
 	}
 }
 //#endregion
@@ -8706,6 +8706,52 @@ function preprocess(fn, schema) {
 function datetime(params) {
 	return /* @__PURE__ */ _isoDateTime(ZodISODateTime, params);
 }
+//#endregion
+//#region src/http/common/httpRequest.ts
+var parameterSchema = strictObject({
+	mode: _enum(["fields", "object"]).default("fields"),
+	names: array(string()).default([])
+});
+var httpRequestExecutorSchema = strictObject({
+	method: _enum([
+		"GET",
+		"POST",
+		"PUT",
+		"PATCH",
+		"DELETE",
+		"HEAD",
+		"OPTIONS"
+	]).default("GET"),
+	query: parameterSchema.default({
+		mode: "fields",
+		names: []
+	}),
+	headers: parameterSchema.default({
+		mode: "fields",
+		names: []
+	}),
+	bodyFormat: _enum([
+		"none",
+		"json",
+		"text",
+		"form"
+	]).default("none"),
+	authentication: union([
+		strictObject({ type: literal("none") }),
+		strictObject({ type: _enum(["bearer", "basic"]) }),
+		strictObject({
+			type: literal("apiKey"),
+			name: string(),
+			in: _enum(["header", "query"])
+		})
+	]).default({ type: "none" }),
+	responseFormat: _enum([
+		"auto",
+		"json",
+		"text"
+	]).default("auto"),
+	statusPolicy: _enum(["success", "all"]).default("success")
+}).extend({ kind: literal("http-request") });
 function checkJsonDepth(value, depth = 0) {
 	if (depth > 64) throw new TypeError("Value exceeds the maximum JSON depth.");
 	if (value != null && typeof value == "object") for (const child of Object.values(value)) checkJsonDepth(child, depth + 1);
@@ -8716,6 +8762,7 @@ var retryNodeTypes = [
 	"code",
 	"connector",
 	"openapi",
+	"http-request",
 	"llm",
 	"decision"
 ];
@@ -8992,7 +9039,8 @@ var managedFields = object({
 			kind: literal("workflow"),
 			flowId: text,
 			revisionId: text
-		})
+		}),
+		httpRequestExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -9292,7 +9340,7 @@ function decodeRevisionContent(value) {
 	checkJsonDepth(value);
 	const content = revision.parse(value);
 	checkModelVersion(content);
-	assertOpenApiAuthBindings(content.document);
+	assertHttpAuthBindings(content.document);
 	return content;
 }
 var shapes = {
@@ -9462,6 +9510,7 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	...shape
 })])).values()])).min(1);
 function checkModelVersion(content) {
+	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind == "http-request")) throw new TypeError("HTTP Request requires Flow model version 11.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && ("moduleId" in candidateNode.task ? candidateNode.task.capabilities?.some((item) => item.kind == "workflow") : candidateNode.task.executor.kind == "agent" && candidateNode.task.executor.tools.some((item) => item.kind == "workflow")))) throw new TypeError("Workflow tools require Flow model version 11.");
 	if (content.modelVersion < 10 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "webhook" && (candidateNode.options?.responseBody != null || candidateNode.options?.responseStatusCodeOutput != null || candidateNode.options?.responseHeadersSource != null || candidateNode.options?.responseHeaderOutputs != null))) throw new TypeError("Dynamic Webhook responses require Flow model version 10.");
 	if (content.modelVersion < 9 && Object.values(content.document.graph.nodes).some((candidateNode) => "retry" in candidateNode && candidateNode.retry != null)) throw new TypeError("Node retries require Flow model version 9.");
@@ -10167,7 +10216,7 @@ function applyFlowChanges(content, operations) {
 			break;
 		}
 	}
-	assertOpenApiAuthBindings(document);
+	assertHttpAuthBindings(document);
 	return upgradeDecodedRevisionContent({
 		document,
 		modelVersion: 11,

package/dist/common/flow-change.d.ts

@@ -113,7 +113,7 @@ export interface ConditionNode extends GraphNodeBase {
     readonly matchMode: 'first' | 'all';
     readonly kind: 'condition';
 }
-export type ManagedTaskExecutor = import('./workflow.js').WorkflowExecutor | import('./decision.js').DecisionExecutor | import('./openapi.js').OpenApiExecutor | {
+export type ManagedTaskExecutor = import('./http-request.js').HttpRequestExecutor | import('./workflow.js').WorkflowExecutor | import('./decision.js').DecisionExecutor | import('./openapi.js').OpenApiExecutor | {
     readonly kind: 'connector';
     readonly action: string;
     readonly connectionId?: string;