@codemation/core-nodes 0.0.25 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @codemation/core-nodes
 
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [[`056c045`](https://github.com/MadeRelevant/codemation/commit/056c045d7813e7e6b749f0dc03bb43855ff7f58c)]:
+  - @codemation/core@0.5.0
+
+## 0.1.0
+
+### Minor Changes
+
+- [#54](https://github.com/MadeRelevant/codemation/pull/54) [`35b78bb`](https://github.com/MadeRelevant/codemation/commit/35b78bb4d8c7ee2998a8b8e51e5ffc3fd901e4c7) Thanks [@cblokland90](https://github.com/cblokland90)! - **Breaking change:** `defineNode(...)` now follows the per-item pipeline: implement **`execute(args, context)`** (optional **`inputSchema`**, **`mapInput`**, and **`TWireJson`** on the generated runnable config). Add **`defineBatchNode(...)`** with **`run(items, context)`** for plugin nodes that still require batch **`run`** semantics.
+
+  Built-in nodes and workflow DSL (`split` / `filter` / `aggregate` on the fluent chain, Switch routing, execution normalization) align with the unified runnable model.
+
+  Align documentation (site guides, repo **`AGENTS.md`**, **`strict-oop-di`** skill, **`packages/core/docs/item-node-execution.md`**) and the **plugin** starter **`AGENTS.md`** with **config** for static wiring (credentials, retry, presentation) vs **inputs** / wire JSON for per-item behavior.
+
+- [#56](https://github.com/MadeRelevant/codemation/pull/56) [`eb97e53`](https://github.com/MadeRelevant/codemation/commit/eb97e5376f4f620099c32c14d7797ed3039bf7bb) Thanks [@cblokland90](https://github.com/cblokland90)! - Add fluent workflow authoring support for port routing and core nodes.
+  - `workflow()` DSL: add `route(...)`, `merge(...)`, and `switch(...)` helpers so multi-port graphs can be expressed without manual `edges`.
+  - `Callback`: allow returning `emitPorts(...)` and configuring declared output ports and error handling options.
+  - Next host: fix execution inspector tree nesting by preferring `snapshot.parent.nodeId` when available (nested agent/tool invocations).
+
+### Patch Changes
+
+- Updated dependencies [[`35b78bb`](https://github.com/MadeRelevant/codemation/commit/35b78bb4d8c7ee2998a8b8e51e5ffc3fd901e4c7), [`eb97e53`](https://github.com/MadeRelevant/codemation/commit/eb97e5376f4f620099c32c14d7797ed3039bf7bb)]:
+  - @codemation/core@0.4.0
+
 ## 0.0.25
 
 ### Patch Changes

package/dist/index.cjs

@@ -2475,9 +2475,9 @@ let AIAgentExecutionHelpersFactory = class AIAgentExecutionHelpersFactory$1 {
 	/**
 	* `@cfworker/json-schema` iterates `schema.required` with `for...of`; it must be a string array or absent.
 	*/
-	sanitizeJsonSchemaRequiredKeywordsForCfworker(node$15) {
-		if (!node$15 || typeof node$15 !== "object" || Array.isArray(node$15)) return;
-		const o = node$15;
+	sanitizeJsonSchemaRequiredKeywordsForCfworker(node$16) {
+		if (!node$16 || typeof node$16 !== "object" || Array.isArray(node$16)) return;
+		const o = node$16;
 		const req = o.required;
 		if (req !== void 0 && !Array.isArray(req)) delete o.required;
 		else if (Array.isArray(req)) {
@@ -2521,9 +2521,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({
@@ -2552,11 +2555,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;
@@ -2565,7 +2587,13 @@ let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
 NodeBackedToolRuntime = __decorate([
 	(0, __codemation_core.injectable)(),
 	__decorateParam(0, (0, __codemation_core.inject)(__codemation_core.CoreTokens.NodeResolver)),
-	__decorateMetadata("design:paramtypes", [Object])
+	__decorateParam(1, (0, __codemation_core.inject)(__codemation_core.ItemValueResolver)),
+	__decorateParam(2, (0, __codemation_core.inject)(__codemation_core.NodeOutputNormalizer)),
+	__decorateMetadata("design:paramtypes", [
+		Object,
+		typeof (_ref$1 = typeof __codemation_core.ItemValueResolver !== "undefined" && __codemation_core.ItemValueResolver) === "function" ? _ref$1 : Object,
+		typeof (_ref2$1 = typeof __codemation_core.NodeOutputNormalizer !== "undefined" && __codemation_core.NodeOutputNormalizer) === "function" ? _ref2$1 : Object
+	])
 ], NodeBackedToolRuntime);
 
 //#endregion
@@ -2583,8 +2611,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;
@@ -2596,7 +2625,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,
@@ -2944,7 +2973,6 @@ var AIAgent = class {
 	retryPolicy;
 	guardrails;
 	inputSchema;
-	mapInput;
 	constructor(options) {
 		this.name = options.name;
 		this.messages = options.messages;
@@ -2954,15 +2982,15 @@ var AIAgent = class {
 		this.retryPolicy = options.retryPolicy ?? __codemation_core.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 ((0, __codemation_core.isPortsEmission)(result)) return result;
+		return (0, __codemation_core.emitPorts)({ main: result ?? items });
 	}
 };
 
@@ -2971,9 +2999,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([(0, __codemation_core.node)({ packageName: "@codemation/core-nodes" })], CallbackNode);
@@ -2985,10 +3022,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;
@@ -3000,10 +3049,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);
@@ -3110,9 +3157,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([(0, __codemation_core.node)({ packageName: "@codemation/core-nodes" })], AggregateNode);
@@ -3136,13 +3183,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([(0, __codemation_core.node)({ packageName: "@codemation/core-nodes" })], FilterNode);
@@ -3161,40 +3204,57 @@ var Filter = class {
 	}
 };
 
+//#endregion
+//#region src/nodes/mergeExecutionUtils.types.ts
+function getOriginIndex(item) {
+	return (0, __codemation_core.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 (0, __codemation_core.emitPorts)({
+			true: ok ? [tagged] : [],
+			false: ok ? [] : [tagged]
+		});
 	}
 };
 IfNode = __decorate([(0, __codemation_core.node)({ packageName: "@codemation/core-nodes" })], IfNode);
@@ -3206,6 +3266,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;
@@ -3213,22 +3274,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 (0, __codemation_core.emitPorts)({ [cases.includes(key) ? key : defaultCase]: [tagged] });
+	}
+};
+SwitchNode = __decorate([(0, __codemation_core.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([(0, __codemation_core.node)({ packageName: "@codemation/core-nodes" })], SplitNode);
@@ -3301,7 +3387,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);
 	}
 };
@@ -3322,19 +3408,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 {
@@ -3405,8 +3478,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([(0, __codemation_core.node)({ packageName: "@codemation/core-nodes" })], NoOpNode);
@@ -3431,44 +3504,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 (0, __codemation_core.emitPorts)({ main: out });
 	}
 };
 SubWorkflowNode = __decorate([
@@ -3504,12 +3575,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([(0, __codemation_core.node)({ packageName: "@codemation/core-nodes" })], WaitNode);
@@ -3602,8 +3675,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([(0, __codemation_core.node)({ packageName: "@codemation/core-nodes" })], ConnectionCredentialNode);
@@ -3620,10 +3693,7 @@ function registerCoreNodes(container) {}
 //#endregion
 //#region src/workflowBuilder.types.ts
 function createWorkflowBuilder(meta$2) {
-	return new __codemation_core.WorkflowBuilder(meta$2, { makeMergeNode: (name) => new Merge(name, {
-		mode: "passThrough",
-		prefer: ["true", "false"]
-	}) });
+	return new __codemation_core.WorkflowBuilder(meta$2);
 }
 
 //#endregion
@@ -3705,6 +3775,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));
 	}
@@ -3736,6 +3821,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;
@@ -3748,6 +3854,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));
 	}
@@ -3800,9 +3919,9 @@ var AIAgentConnectionWorkflowExpander = class {
 		const connectionsByParentAndName = this.createConnectionsByParentAndName(workflow$1);
 		const extraNodes = [];
 		let connectionsChanged = false;
-		for (const node$15 of workflow$1.nodes) {
-			if (node$15.type !== AIAgentNode || !__codemation_core.AgentConfigInspector.isAgentNodeConfig(node$15.config)) continue;
-			for (const connectionNode of __codemation_core.AgentConnectionNodeCollector.collect(node$15.id, node$15.config)) {
+		for (const node$16 of workflow$1.nodes) {
+			if (node$16.type !== AIAgentNode || !__codemation_core.AgentConfigInspector.isAgentNodeConfig(node$16.config)) continue;
+			for (const connectionNode of __codemation_core.AgentConnectionNodeCollector.collect(node$16.id, node$16.config)) {
 				if (!existingChildIds.has(connectionNode.nodeId)) {
 					this.assertNoIdCollision(workflow$1, extraNodes, existingChildIds, connectionNode.nodeId);
 					extraNodes.push({
@@ -3995,6 +4114,13 @@ Object.defineProperty(exports, 'SubWorkflowNode', {
     return SubWorkflowNode;
   }
 });
+exports.Switch = Switch;
+Object.defineProperty(exports, 'SwitchNode', {
+  enumerable: true,
+  get: function () {
+    return SwitchNode;
+  }
+});
 exports.Wait = Wait;
 exports.WaitDuration = WaitDuration;
 Object.defineProperty(exports, 'WaitNode', {