@codemation/core-nodes 0.0.24 → 0.1.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { AgentConfigInspector, AgentConnectionNodeCollector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, DefinedNodeRegistry, ItemsInputNormalizer, NodeBackedToolConfig, RetryPolicy, WorkflowBuilder, chatModel, inject, injectable, node } from "@codemation/core";
+import { AgentConfigInspector, AgentConnectionNodeCollector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, DefinedNodeRegistry, ItemValueResolver, ItemsInputNormalizer, NodeBackedToolConfig, NodeOutputNormalizer, RetryPolicy, WorkflowBuilder, chatModel, emitPorts, getOriginIndexFromItem, inject, injectable, isPortsEmission, node } from "@codemation/core";
 import { ChatOpenAI } from "@langchain/openai";
 import { AIMessage, HumanMessage, SystemMessage, ToolMessage } from "@langchain/core/messages";
 import { isInteropZodSchema } from "@langchain/core/utils/types";
@@ -2491,9 +2491,12 @@ function __decorateParam(paramIndex, decorator) {
 
 //#endregion
 //#region src/nodes/NodeBackedToolRuntime.ts
+var _ref$1, _ref2$1;
 let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
-	constructor(nodeResolver) {
+	constructor(nodeResolver, itemValueResolver, outputNormalizer) {
 		this.nodeResolver = nodeResolver;
+		this.itemValueResolver = itemValueResolver;
+		this.outputNormalizer = outputNormalizer;
 	}
 	async execute(config$1, args) {
 		const nodeInput = config$1.toNodeItem({
@@ -2522,11 +2525,30 @@ let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
 	}
 	async executeResolvedNode(resolvedNode, nodeInput, ctx) {
 		if (this.isMultiInputNode(resolvedNode)) return await resolvedNode.executeMulti({ in: [nodeInput] }, ctx);
-		if (this.isNode(resolvedNode)) return await resolvedNode.execute([nodeInput], ctx);
+		if (this.isRunnableNode(resolvedNode)) {
+			const runnable = resolvedNode;
+			const runnableConfig = ctx.config;
+			const carry = runnableConfig.lineageCarry ?? "emitOnly";
+			const parsed = (runnable.inputSchema ?? runnableConfig.inputSchema ?? unknown()).parse(nodeInput.json);
+			const items = [nodeInput];
+			const execArgs = {
+				input: parsed,
+				item: nodeInput,
+				itemIndex: 0,
+				items,
+				ctx: await this.itemValueResolver.resolveConfigForItem(ctx, nodeInput, 0, items)
+			};
+			const raw = await Promise.resolve(runnable.execute(execArgs));
+			return this.outputNormalizer.normalizeExecuteResult({
+				baseItem: nodeInput,
+				raw,
+				carry
+			});
+		}
 		throw new Error(`Node-backed tool expected a runnable node instance for "${ctx.config.name ?? ctx.nodeId}".`);
 	}
-	isNode(value) {
-		return typeof value === "object" && value !== null && "execute" in value;
+	isRunnableNode(value) {
+		return typeof value === "object" && value !== null && value.kind === "node" && typeof value.execute === "function" && typeof value.executeMulti !== "function";
 	}
 	isMultiInputNode(value) {
 		return typeof value === "object" && value !== null && "executeMulti" in value;
@@ -2535,7 +2557,13 @@ let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
 NodeBackedToolRuntime = __decorate([
 	injectable(),
 	__decorateParam(0, inject(CoreTokens.NodeResolver)),
-	__decorateMetadata("design:paramtypes", [Object])
+	__decorateParam(1, inject(ItemValueResolver)),
+	__decorateParam(2, inject(NodeOutputNormalizer)),
+	__decorateMetadata("design:paramtypes", [
+		Object,
+		typeof (_ref$1 = typeof ItemValueResolver !== "undefined" && ItemValueResolver) === "function" ? _ref$1 : Object,
+		typeof (_ref2$1 = typeof NodeOutputNormalizer !== "undefined" && NodeOutputNormalizer) === "function" ? _ref2$1 : Object
+	])
 ], NodeBackedToolRuntime);
 
 //#endregion
@@ -2553,8 +2581,9 @@ let AIAgentNode = class AIAgentNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
 	/**
-	* Engine applies {@link RunnableNodeConfig.mapInput} + parse before {@link #executeOne}. Prefer modeling
-	* prompts as {@code { messages: [{ role, content }, ...] }} so persisted inputs are visible in the UI.
+	* Engine validates {@link RunnableNodeConfig.inputSchema} (Zod) on {@code item.json} before enqueue, then resolves
+	* per-item **`itemValue`** leaves on config before {@link #execute}. Prefer modeling prompts as
+	* {@code { messages: [{ role, content }, ...] }} (on input or config) so persisted inputs are visible in the UI.
 	*/
 	inputSchema = unknown();
 	connectionCredentialExecutionContextFactory;
@@ -2566,7 +2595,7 @@ let AIAgentNode = class AIAgentNode$1 {
 		this.executionHelpers = executionHelpers;
 		this.connectionCredentialExecutionContextFactory = this.executionHelpers.createConnectionCredentialExecutionContextFactory(credentialSessions);
 	}
-	async executeOne(args) {
+	async execute(args) {
 		const prepared = await this.getOrPrepareExecution(args.ctx);
 		const itemWithMappedJson = {
 			...args.item,
@@ -2914,7 +2943,6 @@ var AIAgent = class {
 	retryPolicy;
 	guardrails;
 	inputSchema;
-	mapInput;
 	constructor(options) {
 		this.name = options.name;
 		this.messages = options.messages;
@@ -2924,15 +2952,15 @@ var AIAgent = class {
 		this.retryPolicy = options.retryPolicy ?? RetryPolicy.defaultForAiAgent;
 		this.guardrails = options.guardrails;
 		this.inputSchema = options.inputSchema;
-		this.mapInput = options.mapInput;
 	}
 };
 
 //#endregion
 //#region src/nodes/CallbackResultNormalizerFactory.ts
 var CallbackResultNormalizer = class {
-	static toNodeOutputs(result, items) {
-		return { main: result ?? items };
+	static toPortsEmission(result, items) {
+		if (isPortsEmission(result)) return result;
+		return emitPorts({ main: result ?? items });
 	}
 };
 
@@ -2941,9 +2969,18 @@ var CallbackResultNormalizer = class {
 let CallbackNode = class CallbackNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
-	async execute(items, ctx) {
-		const result = await ctx.config.callback(items, ctx);
-		return CallbackResultNormalizer.toNodeOutputs(result, items);
+	async execute(args) {
+		const items = args.items ?? [];
+		const ctx = args.ctx;
+		const config$1 = ctx.config;
+		if (config$1 == null) throw new Error("CallbackNode: missing ctx.config (engine should always pass runnable config)");
+		if (items.length === 0) {
+			const result$1 = await config$1.callback(items, ctx);
+			return CallbackResultNormalizer.toPortsEmission(result$1, items);
+		}
+		if (args.itemIndex !== items.length - 1) return [];
+		const result = await config$1.callback(items, ctx);
+		return CallbackResultNormalizer.toPortsEmission(result, items);
 	}
 };
 CallbackNode = __decorate([node({ packageName: "@codemation/core-nodes" })], CallbackNode);
@@ -2955,10 +2992,22 @@ var Callback = class Callback {
 	type = CallbackNode;
 	execution = { hint: "local" };
 	icon = "lucide:braces";
-	constructor(name = "Callback", callback = Callback.defaultCallback, id) {
+	emptyBatchExecution = "runOnce";
+	id;
+	retryPolicy;
+	nodeErrorHandler;
+	declaredOutputPorts;
+	constructor(name = "Callback", callback = Callback.defaultCallback, idOrOptions, options) {
 		this.name = name;
 		this.callback = callback;
-		this.id = id;
+		const resolvedOptions = typeof idOrOptions === "string" ? {
+			...options,
+			id: idOrOptions
+		} : idOrOptions;
+		this.id = resolvedOptions?.id;
+		this.retryPolicy = resolvedOptions?.retryPolicy;
+		this.nodeErrorHandler = resolvedOptions?.nodeErrorHandler;
+		this.declaredOutputPorts = resolvedOptions?.declaredOutputPorts;
 	}
 	static defaultCallback(items) {
 		return items;
@@ -2970,10 +3019,8 @@ var Callback = class Callback {
 let HttpRequestNode = class HttpRequestNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
-	async execute(items, ctx) {
-		const output = [];
-		for (const item of items) output.push(await this.executeItem(item, ctx));
-		return { main: output };
+	async execute(args) {
+		return await this.executeItem(args.item, args.ctx);
 	}
 	async executeItem(item, ctx) {
 		const url = this.resolveUrl(item, ctx);
@@ -3080,9 +3127,9 @@ var HttpRequest = class {
 let AggregateNode = class AggregateNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
-	async execute(items, ctx) {
-		if (items.length === 0) return { main: [] };
-		return { main: [{ json: await Promise.resolve(ctx.config.aggregate(items, ctx)) }] };
+	async execute(args) {
+		if (args.itemIndex !== args.items.length - 1) return [];
+		return Promise.resolve(args.ctx.config.aggregate(args.items, args.ctx));
 	}
 };
 AggregateNode = __decorate([node({ packageName: "@codemation/core-nodes" })], AggregateNode);
@@ -3106,13 +3153,9 @@ var Aggregate = class {
 let FilterNode = class FilterNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
-	async execute(items, ctx) {
-		const out = [];
-		for (let i = 0; i < items.length; i++) {
-			const item = items[i];
-			if (ctx.config.predicate(item, i, items, ctx)) out.push(item);
-		}
-		return { main: out };
+	execute(args) {
+		if (args.ctx.config.predicate(args.item, args.itemIndex, args.items, args.ctx)) return args.item;
+		return [];
 	}
 };
 FilterNode = __decorate([node({ packageName: "@codemation/core-nodes" })], FilterNode);
@@ -3131,40 +3174,57 @@ var Filter = class {
 	}
 };
 
+//#endregion
+//#region src/nodes/mergeExecutionUtils.types.ts
+function getOriginIndex(item) {
+	return getOriginIndexFromItem(item);
+}
+/**
+* Tags items routed to fan-in merge-by-origin (same contract as {@link IfNode} / {@link SwitchNode}).
+*/
+function tagItemForRouterFanIn(args) {
+	const { item, itemIndex, nodeId, inputPortLabel = "$in" } = args;
+	const metaBase = item.meta && typeof item.meta === "object" ? item.meta : {};
+	const cmBase = metaBase._cm && typeof metaBase._cm === "object" ? metaBase._cm : {};
+	const originIndex = typeof cmBase.originIndex === "number" ? cmBase.originIndex : itemIndex;
+	return {
+		...item,
+		meta: {
+			...metaBase,
+			_cm: {
+				...cmBase,
+				originIndex
+			}
+		},
+		paired: [{
+			nodeId,
+			output: inputPortLabel,
+			itemIndex: originIndex
+		}, ...item.paired ?? []]
+	};
+}
+function orderedInputs(inputsByPort, prefer) {
+	const keys = Object.keys(inputsByPort);
+	const preferred = (prefer ?? []).filter((k) => keys.includes(k));
+	const rest = keys.filter((k) => !preferred.includes(k)).sort();
+	return [...preferred, ...rest];
+}
+
 //#endregion
 //#region src/nodes/IfNode.ts
 let IfNode = class IfNode$1 {
 	kind = "node";
-	outputPorts = ["true", "false"];
-	async execute(items, ctx) {
-		const t = [];
-		const f = [];
-		for (let i = 0; i < items.length; i++) {
-			const item = items[i];
-			const metaBase = item.meta && typeof item.meta === "object" ? item.meta : {};
-			const cmBase = metaBase._cm && typeof metaBase._cm === "object" ? metaBase._cm : {};
-			const originIndex = typeof cmBase.originIndex === "number" ? cmBase.originIndex : i;
-			const tagged = {
-				...item,
-				meta: {
-					...metaBase,
-					_cm: {
-						...cmBase,
-						originIndex
-					}
-				},
-				paired: [{
-					nodeId: ctx.nodeId,
-					output: "$in",
-					itemIndex: originIndex
-				}, ...item.paired ?? []]
-			};
-			(ctx.config.predicate(item, i, items, ctx) ? t : f).push(tagged);
-		}
-		return {
-			true: t,
-			false: f
-		};
+	execute(args) {
+		const tagged = tagItemForRouterFanIn({
+			item: args.item,
+			itemIndex: args.itemIndex,
+			nodeId: args.ctx.nodeId
+		});
+		const ok = args.ctx.config.predicate(args.item, args.itemIndex, args.items, args.ctx);
+		return emitPorts({
+			true: ok ? [tagged] : [],
+			false: ok ? [] : [tagged]
+		});
 	}
 };
 IfNode = __decorate([node({ packageName: "@codemation/core-nodes" })], IfNode);
@@ -3176,6 +3236,7 @@ var If = class {
 	type = IfNode;
 	execution = { hint: "local" };
 	icon = "lucide:split";
+	declaredOutputPorts = ["true", "false"];
 	constructor(name, predicate, id) {
 		this.name = name;
 		this.predicate = predicate;
@@ -3183,22 +3244,47 @@ var If = class {
 	}
 };
 
+//#endregion
+//#region src/nodes/SwitchNode.ts
+let SwitchNode = class SwitchNode$1 {
+	kind = "node";
+	async execute(args) {
+		const tagged = tagItemForRouterFanIn({
+			item: args.item,
+			itemIndex: args.itemIndex,
+			nodeId: args.ctx.nodeId
+		});
+		const key = await Promise.resolve(args.ctx.config.cfg.resolveCaseKey(args.item, args.itemIndex, args.items, args.ctx));
+		const { cases, defaultCase } = args.ctx.config.cfg;
+		return emitPorts({ [cases.includes(key) ? key : defaultCase]: [tagged] });
+	}
+};
+SwitchNode = __decorate([node({ packageName: "@codemation/core-nodes" })], SwitchNode);
+
+//#endregion
+//#region src/nodes/switch.ts
+var Switch = class {
+	kind = "node";
+	type = SwitchNode;
+	execution = { hint: "local" };
+	icon = "lucide:git-branch-plus";
+	lineageCarry = "carryThrough";
+	declaredOutputPorts;
+	constructor(name, cfg, id) {
+		this.name = name;
+		this.cfg = cfg;
+		this.id = id;
+		this.declaredOutputPorts = [...new Set([...cfg.cases, cfg.defaultCase])].sort();
+	}
+};
+
 //#endregion
 //#region src/nodes/SplitNode.ts
 let SplitNode = class SplitNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
-	async execute(items, ctx) {
-		const out = [];
-		for (let i = 0; i < items.length; i++) {
-			const item = items[i];
-			const elements = ctx.config.getElements(item, ctx);
-			for (let j = 0; j < elements.length; j++) out.push({
-				...item,
-				json: elements[j]
-			});
-		}
-		return { main: out };
+	execute(args) {
+		return args.ctx.config.getElements(args.item, args.ctx);
 	}
 };
 SplitNode = __decorate([node({ packageName: "@codemation/core-nodes" })], SplitNode);
@@ -3271,7 +3357,7 @@ let MapDataNode = class MapDataNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
 	inputSchema = unknown();
-	async executeOne(args) {
+	async execute(args) {
 		return args.ctx.config.map(args.item, args.ctx);
 	}
 };
@@ -3292,19 +3378,6 @@ var MapData = class {
 	}
 };
 
-//#endregion
-//#region src/nodes/mergeExecutionUtils.types.ts
-function getOriginIndex(item) {
-	const v = (item.meta?._cm)?.originIndex;
-	return typeof v === "number" && Number.isFinite(v) ? v : void 0;
-}
-function orderedInputs(inputsByPort, prefer) {
-	const keys = Object.keys(inputsByPort);
-	const preferred = (prefer ?? []).filter((k) => keys.includes(k));
-	const rest = keys.filter((k) => !preferred.includes(k)).sort();
-	return [...preferred, ...rest];
-}
-
 //#endregion
 //#region src/nodes/MergeNode.ts
 let MergeNode = class MergeNode$1 {
@@ -3375,8 +3448,8 @@ var Merge = class {
 let NoOpNode = class NoOpNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
-	async execute(items, _ctx) {
-		return { main: items };
+	execute(args) {
+		return args.item;
 	}
 };
 NoOpNode = __decorate([node({ packageName: "@codemation/core-nodes" })], NoOpNode);
@@ -3401,44 +3474,42 @@ let SubWorkflowNode = class SubWorkflowNode$1 {
 	constructor(workflows) {
 		this.workflows = workflows;
 	}
-	async execute(items, ctx) {
+	async execute(args) {
+		const current = args.item;
+		const metaBase = current.meta && typeof current.meta === "object" ? current.meta : {};
+		const cmBase = metaBase._cm && typeof metaBase._cm === "object" ? metaBase._cm : {};
+		const originIndex = typeof cmBase.originIndex === "number" ? cmBase.originIndex : void 0;
+		const result = await this.workflows.runById({
+			workflowId: args.ctx.config.workflowId,
+			startAt: args.ctx.config.startAt,
+			items: [current],
+			parent: {
+				runId: args.ctx.runId,
+				workflowId: args.ctx.workflowId,
+				nodeId: args.ctx.nodeId,
+				subworkflowDepth: args.ctx.subworkflowDepth,
+				engineMaxNodeActivations: args.ctx.engineMaxNodeActivations,
+				engineMaxSubworkflowDepth: args.ctx.engineMaxSubworkflowDepth
+			}
+		});
+		if (result.status !== "completed") throw new Error(`Subworkflow ${args.ctx.config.workflowId} did not complete (status=${result.status})`);
 		const out = [];
-		for (let i = 0; i < items.length; i++) {
-			const current = items[i];
-			const metaBase = current.meta && typeof current.meta === "object" ? current.meta : {};
-			const cmBase = metaBase._cm && typeof metaBase._cm === "object" ? metaBase._cm : {};
-			const originIndex = typeof cmBase.originIndex === "number" ? cmBase.originIndex : void 0;
-			const result = await this.workflows.runById({
-				workflowId: ctx.config.workflowId,
-				startAt: ctx.config.startAt,
-				items: [current],
-				parent: {
-					runId: ctx.runId,
-					workflowId: ctx.workflowId,
-					nodeId: ctx.nodeId,
-					subworkflowDepth: ctx.subworkflowDepth,
-					engineMaxNodeActivations: ctx.engineMaxNodeActivations,
-					engineMaxSubworkflowDepth: ctx.engineMaxSubworkflowDepth
-				}
+		for (const produced of result.outputs) {
+			const childMetaBase = produced.meta && typeof produced.meta === "object" ? produced.meta : {};
+			const childCmBase = childMetaBase._cm && typeof childMetaBase._cm === "object" ? childMetaBase._cm : {};
+			out.push({
+				...produced,
+				meta: originIndex === void 0 ? childMetaBase : {
+					...childMetaBase,
+					_cm: {
+						...childCmBase,
+						originIndex
+					}
+				},
+				paired: current.paired ?? produced.paired
 			});
-			if (result.status !== "completed") throw new Error(`Subworkflow ${ctx.config.workflowId} did not complete (status=${result.status})`);
-			for (const produced of result.outputs) {
-				const childMetaBase = produced.meta && typeof produced.meta === "object" ? produced.meta : {};
-				const childCmBase = childMetaBase._cm && typeof childMetaBase._cm === "object" ? childMetaBase._cm : {};
-				out.push({
-					...produced,
-					meta: originIndex === void 0 ? childMetaBase : {
-						...childMetaBase,
-						_cm: {
-							...childCmBase,
-							originIndex
-						}
-					},
-					paired: current.paired ?? produced.paired
-				});
-			}
 		}
-		return { main: out };
+		return emitPorts({ main: out });
 	}
 };
 SubWorkflowNode = __decorate([
@@ -3474,12 +3545,14 @@ var WaitDuration = class {
 let WaitNode = class WaitNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
-	async execute(items, ctx) {
-		const milliseconds = WaitDuration.normalize(ctx.config.milliseconds);
-		if (milliseconds > 0) await new Promise((resolve) => {
-			setTimeout(resolve, milliseconds);
-		});
-		return { main: items };
+	async execute(args) {
+		if (args.itemIndex === 0) {
+			const milliseconds = WaitDuration.normalize(args.ctx.config.milliseconds);
+			if (milliseconds > 0) await new Promise((resolve) => {
+				setTimeout(resolve, milliseconds);
+			});
+		}
+		return args.item;
 	}
 };
 WaitNode = __decorate([node({ packageName: "@codemation/core-nodes" })], WaitNode);
@@ -3572,8 +3645,8 @@ var WebhookTrigger = class WebhookTrigger {
 let ConnectionCredentialNode = class ConnectionCredentialNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
-	async execute(_items, _ctx) {
-		return { main: [] };
+	execute(_args) {
+		return [];
 	}
 };
 ConnectionCredentialNode = __decorate([node({ packageName: "@codemation/core-nodes" })], ConnectionCredentialNode);
@@ -3590,10 +3663,7 @@ function registerCoreNodes(container) {}
 //#endregion
 //#region src/workflowBuilder.types.ts
 function createWorkflowBuilder(meta$2) {
-	return new WorkflowBuilder(meta$2, { makeMergeNode: (name) => new Merge(name, {
-		mode: "passThrough",
-		prefer: ["true", "false"]
-	}) });
+	return new WorkflowBuilder(meta$2);
 }
 
 //#endregion
@@ -3675,6 +3745,21 @@ var WorkflowBranchBuilder = class WorkflowBranchBuilder {
 		const duration = durationOrUndefined ?? nameOrDuration;
 		return this.then(new Wait(name, WorkflowDurationParser.parse(duration), id));
 	}
+	split(nameOrGetter, getElementsOrUndefined, id) {
+		const name = typeof nameOrGetter === "string" ? nameOrGetter : "Split";
+		const getElements = typeof nameOrGetter === "string" ? getElementsOrUndefined : nameOrGetter;
+		return this.then(new Split(name, getElements, id));
+	}
+	filter(nameOrPredicate, predicateOrUndefined, id) {
+		const name = typeof nameOrPredicate === "string" ? nameOrPredicate : "Filter";
+		const predicate = typeof nameOrPredicate === "string" ? predicateOrUndefined : nameOrPredicate;
+		return this.then(new Filter(name, predicate, id));
+	}
+	aggregate(nameOrFn, aggregateFnOrUndefined, id) {
+		const name = typeof nameOrFn === "string" ? nameOrFn : "Aggregate";
+		const aggregateFn = typeof nameOrFn === "string" ? aggregateFnOrUndefined : nameOrFn;
+		return this.then(new Aggregate(name, aggregateFn, id));
+	}
 	agent(nameOrOptions, optionsOrUndefined) {
 		return this.then(WorkflowAgentNodeFactory.create(nameOrOptions, optionsOrUndefined));
 	}
@@ -3706,6 +3791,27 @@ var WorkflowChain = class WorkflowChain {
 		const duration = durationOrUndefined ?? nameOrDuration;
 		return this.then(new Wait(name, WorkflowDurationParser.parse(duration), id));
 	}
+	split(nameOrGetter, getElementsOrUndefined, id) {
+		const name = typeof nameOrGetter === "string" ? nameOrGetter : "Split";
+		const getElements = typeof nameOrGetter === "string" ? getElementsOrUndefined : nameOrGetter;
+		return this.then(new Split(name, getElements, id));
+	}
+	filter(nameOrPredicate, predicateOrUndefined, id) {
+		const name = typeof nameOrPredicate === "string" ? nameOrPredicate : "Filter";
+		const predicate = typeof nameOrPredicate === "string" ? predicateOrUndefined : nameOrPredicate;
+		return this.then(new Filter(name, predicate, id));
+	}
+	aggregate(nameOrFn, aggregateFnOrUndefined, id) {
+		const name = typeof nameOrFn === "string" ? nameOrFn : "Aggregate";
+		const aggregateFn = typeof nameOrFn === "string" ? aggregateFnOrUndefined : nameOrFn;
+		return this.then(new Aggregate(name, aggregateFn, id));
+	}
+	merge(nameOrCfg, cfgOrId, id) {
+		const name = typeof nameOrCfg === "string" ? nameOrCfg : "Merge";
+		const cfg = typeof nameOrCfg === "string" ? (typeof cfgOrId === "string" ? void 0 : cfgOrId) ?? { mode: "passThrough" } : nameOrCfg ?? { mode: "passThrough" };
+		const mergeId = typeof cfgOrId === "string" ? cfgOrId : id;
+		return new WorkflowChain(this.chain.thenIntoInputHints(new Merge(name, cfg, mergeId)));
+	}
 	if(nameOrPredicate, predicateOrBranches, branchesOrUndefined) {
 		const name = typeof nameOrPredicate === "string" ? nameOrPredicate : "If";
 		const predicate = typeof nameOrPredicate === "string" ? predicateOrBranches : nameOrPredicate;
@@ -3718,6 +3824,19 @@ var WorkflowChain = class WorkflowChain {
 			false: falseSteps
 		}));
 	}
+	route(branches) {
+		const mappedBranches = Object.fromEntries(Object.entries(branches).map(([port, branchFactory]) => [port, branchFactory ? (branch) => branchFactory(new WorkflowChain(branch)).chain : void 0]));
+		return new WorkflowChain(this.chain.route(mappedBranches));
+	}
+	switch(nameOrCfg, cfgOrUndefined, id) {
+		const name = typeof nameOrCfg === "string" ? nameOrCfg : "Switch";
+		const cfg = typeof nameOrCfg === "string" ? cfgOrUndefined : nameOrCfg;
+		return this.then(new Switch(name, {
+			cases: cfg.cases,
+			defaultCase: cfg.defaultCase,
+			resolveCaseKey: (item) => cfg.resolveCaseKey(item.json)
+		}, id)).route(cfg.branches);
+	}
 	agent(nameOrOptions, optionsOrUndefined) {
 		return this.then(WorkflowAgentNodeFactory.create(nameOrOptions, optionsOrUndefined));
 	}
@@ -3852,5 +3971,5 @@ var ConnectionCredentialNodeConfigFactory = class {
 };
 
 //#endregion
-export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentToolCallPortMap, Aggregate, AggregateNode, Callback, CallbackNode, CallbackResultNormalizer, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, Filter, FilterNode, HttpRequest, HttpRequestNode, If, IfNode, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, Split, SplitNode, SubWorkflow, SubWorkflowNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
+export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentToolCallPortMap, Aggregate, AggregateNode, Callback, CallbackNode, CallbackResultNormalizer, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, Filter, FilterNode, HttpRequest, HttpRequestNode, If, IfNode, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, Split, SplitNode, SubWorkflow, SubWorkflowNode, Switch, SwitchNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
 //# sourceMappingURL=index.js.map