@codemation/core 0.13.2 → 0.14.0

package/dist/{runtime-_VdHwGkJ.cjs → runtime-n2tqRwaf.cjs}

@@ -1,4 +1,4 @@
-const require_di = require('./di-LP2qSHkY.cjs');
+const require_di = require('./di-DhwtDRgs.cjs');
 let zod = require("zod");
 zod = require_di.__toESM(zod);
 let node_stream_web = require("node:stream/web");
@@ -211,9 +211,13 @@ function defineNode(options) {
 		icon = options.icon;
 		inputSchema = options.inputSchema;
 		keepBinaries = options.keepBinaries ?? false;
-		constructor(name, config, id) {
+		id;
+		description;
+		constructor(name, config, idOrOptions) {
 			this.name = name;
-			this.id = id;
+			const resolved = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+			this.id = resolved?.id;
+			this.description = resolved?.description;
 			this.config = config;
 		}
 		config;
@@ -229,8 +233,8 @@ function defineNode(options) {
 		key: options.key,
 		title: options.title,
 		description: options.description,
-		create(config, name = options.title, id) {
-			return new DefinedRunnableNodeConfig(name, config, id);
+		create(config, name = options.title, idOrOptions) {
+			return new DefinedRunnableNodeConfig(name, config, idOrOptions);
 		},
 		register(context) {
 			context.registerNode(DefinedNodeRuntime);
@@ -260,9 +264,13 @@ function defineBatchNode(options) {
 		kind = "node";
 		type = DefinedNodeRuntime;
 		icon = options.icon;
-		constructor(name, config, id) {
+		id;
+		description;
+		constructor(name, config, idOrOptions) {
 			this.name = name;
-			this.id = id;
+			const resolved = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+			this.id = resolved?.id;
+			this.description = resolved?.description;
 			this.config = config;
 		}
 		config;
@@ -278,8 +286,8 @@ function defineBatchNode(options) {
 		key: options.key,
 		title: options.title,
 		description: options.description,
-		create(config, name = options.title, id) {
-			return new DefinedRunnableNodeConfig(name, config, id);
+		create(config, name = options.title, idOrOptions) {
+			return new DefinedRunnableNodeConfig(name, config, idOrOptions);
 		},
 		register(context) {
 			context.registerNode(DefinedNodeRuntime);
@@ -446,10 +454,13 @@ async function handleResume(item, resumeContext, decisionSchema, resolvedPredica
 //#endregion
 //#region src/workflow/dsl/WhenBuilder.ts
 var WhenBuilder = class WhenBuilder {
-	constructor(wf, from, branchPort) {
+	/** Tail endpoint of the arm this builder added (set by addBranch). */
+	armEndpoint;
+	constructor(wf, from, branchPort, priorEndpoints = []) {
 		this.wf = wf;
 		this.from = from;
 		this.branchPort = branchPort;
+		this.priorEndpoints = priorEndpoints;
 	}
 	addBranch(steps) {
 		const created = [];
@@ -470,20 +481,84 @@ var WhenBuilder = class WhenBuilder {
 				return nodeId ? { nodeId } : { nodeId: r };
 			});
 		}
+		this.armEndpoint = prev ? {
+			node: prev,
+			output: "main",
+			inputPortHint: this.branchPort
+		} : {
+			node: this.from,
+			output: this.branchPort,
+			inputPortHint: this.branchPort
+		};
 		return this;
 	}
 	when = (branch, steps, ...more) => {
 		const list = Array.isArray(steps) ? steps : [steps, ...more];
 		const port = branch ? "true" : "false";
-		const b = new WhenBuilder(this.wf, this.from, port);
+		const b = new WhenBuilder(this.wf, this.from, port, this.accumulatedEndpoints);
 		b.addBranch(list);
 		return b;
 	};
+	/**
+	* Continue the trunk after a boolean `.when(...)` branch chain, auto-merging EVERY branch
+	* tail accumulated across the chain into the next node — the same fan-in the object form
+	* produces. Typed as `ChainCursor<TCurrentJson>` (the pre-branch item type): boolean arms
+	* carry no output guard so the merged item type is underdetermined — use the object form
+	* `.when({ true: [...], false: [...] })` when you need a precise merged type inline.
+	*/
+	then(config) {
+		return this.toCursor().then(config);
+	}
+	/**
+	* Chainable human-approval step after a boolean `.when(...)` branch chain — merges every
+	* branch tail into the approval node. Mirrors `ChainCursor.humanApproval`.
+	*/
+	humanApproval(node$1, config, metadata) {
+		return this.toCursor().humanApproval(node$1, config, metadata);
+	}
 	build() {
 		return this.wf.build();
 	}
+	/** Endpoints of every arm added so far in this chain (prior arms + this one). */
+	get accumulatedEndpoints() {
+		return this.armEndpoint ? [...this.priorEndpoints, this.armEndpoint] : this.priorEndpoints;
+	}
+	toCursor() {
+		return new ChainCursor(this.wf, this.accumulatedEndpoints);
+	}
 };
 
+//#endregion
+//#region src/workflow/dsl/workflowBuilderTypes.ts
+/**
+* Flags a node's config so its output is MERGED onto `item.json` (shallow, output-wins) instead of
+* replacing it — the config-level twin of {@link ChainCursor.thenMerge}.
+*
+* Unlike `.thenMerge` (a cursor method that only works on the trunk), `mergeForward` operates on a
+* bare config, so it is usable in ANY position — including inside a `.when({ true: [...] })` branch
+* arm, where the steps are a flat array of configs (not a cursor). Wrap a payload-REPLACING node
+* (e.g. an extractor) in `mergeForward(node.create(...))` so prior fields survive into the next step.
+*
+* The OUTPUT type becomes `TIn & TOut` (the intersection), mirroring `.thenMerge`'s return type at
+* the config level — so the next step in the branch array sees both the prior fields and the node's
+* output. The INPUT type stays `TIn` (the node still receives the pre-merge item).
+*
+* @example
+* ```ts
+* workflow
+*   .trigger(...)
+*   .when({
+*     true: [mergeForward(extractor.create(...))], // output merges onto item.json; { a } survives
+*     false: [...],
+*   })
+*   .build();
+* ```
+*/
+function mergeForward(config) {
+	config.mergeJson = true;
+	return config;
+}
+
 //#endregion
 //#region src/workflow/dsl/ChainCursorResolver.ts
 var ChainCursor = class ChainCursor {
@@ -501,6 +576,15 @@ var ChainCursor = class ChainCursor {
 			...inputPortHint ? { inputPortHint } : {}
 		}]);
 	}
+	/**
+	* Append a step whose output is MERGED onto `item.json` (shallow, output-wins) instead of
+	* replacing it — so earlier fields (e.g. trigger metadata) survive a transform/OCR/extraction
+	* node. Use for any node in a pipeline where you need data from before it.
+	*/
+	thenMerge(config) {
+		mergeForward(config);
+		return this.then(config);
+	}
 	thenIntoInputHints(config) {
 		const next = this.wf.add(config);
 		for (const e of this.endpoints) this.wf.connect(e.node, next, e.output, e.inputPortHint ?? "in");
@@ -2090,10 +2174,16 @@ var NodeOutputNormalizer = class {
 	isItemLike(value) {
 		return typeof value === "object" && value !== null && "json" in value;
 	}
+	isPlainJsonObject(value) {
+		return typeof value === "object" && value !== null && !Array.isArray(value);
+	}
 	applyOutput(baseItem, next, behavior) {
 		const explicitBinary = next.binary;
 		return {
-			json: next.json,
+			json: behavior.mergeJson && this.isPlainJsonObject(baseItem.json) && this.isPlainJsonObject(next.json) ? {
+				...baseItem.json,
+				...next.json
+			} : next.json,
 			...explicitBinary !== void 0 ? { binary: explicitBinary } : behavior.keepBinaries && baseItem.binary ? { binary: baseItem.binary } : {},
 			...next.meta ? { meta: next.meta } : {},
 			...next.paired ? { paired: next.paired } : {}
@@ -2105,11 +2195,17 @@ var NodeOutputNormalizer = class {
 //#region src/execution/RunnableOutputBehaviorResolver.ts
 var RunnableOutputBehaviorResolver = class {
 	resolve(config) {
-		return { keepBinaries: this.isKeepBinariesEnabled(config) };
+		return {
+			keepBinaries: this.isKeepBinariesEnabled(config),
+			mergeJson: this.isMergeJsonEnabled(config)
+		};
 	}
 	isKeepBinariesEnabled(config) {
 		return config.keepBinaries === true;
 	}
+	isMergeJsonEnabled(config) {
+		return config.mergeJson === true;
+	}
 };
 
 //#endregion
@@ -2648,6 +2744,7 @@ var WorkflowSnapshotCodec = class {
 				name: config.name,
 				id: config.id,
 				icon: config.icon,
+				description: config.description,
 				execution: config.execution
 			};
 			this.injectTokenIds(fallback, config);
@@ -7139,6 +7236,12 @@ Object.defineProperty(exports, 'isUnbrandedPortsEmissionShape', {
     return isUnbrandedPortsEmissionShape;
   }
 });
+Object.defineProperty(exports, 'mergeForward', {
+  enumerable: true,
+  get: function () {
+    return mergeForward;
+  }
+});
 Object.defineProperty(exports, 'node', {
   enumerable: true,
   get: function () {
@@ -7151,4 +7254,4 @@ Object.defineProperty(exports, 'tool', {
     return tool;
   }
 });
-//# sourceMappingURL=runtime-_VdHwGkJ.cjs.map
+//# sourceMappingURL=runtime-n2tqRwaf.cjs.map