@codemation/core 0.13.2 → 0.14.0

package/dist/{runtime-CWPdvJpC.js → runtime-CSunvf7A.js}

@@ -1,4 +1,4 @@
-import { E as ConnectionNodeIdFactory, _ as CredentialUnboundError, a as injectable, g as SuspensionRequest, h as BINARY_DEFAULT_MAX_BYTES, v as NodeIterationIdFactory, w as resolveItemExprsForExecution, x as AgentConfigInspector, y as AgentConnectionNodeCollector } from "./di-tom0pM2h.js";
+import { E as ConnectionNodeIdFactory, _ as CredentialUnboundError, a as injectable, g as SuspensionRequest, h as BINARY_DEFAULT_MAX_BYTES, v as NodeIterationIdFactory, w as resolveItemExprsForExecution, x as AgentConfigInspector, y as AgentConnectionNodeCollector } from "./di-CEV6wTc4.js";
 import { ZodError, z } from "zod";
 import { ReadableStream } from "node:stream/web";
 import { createHash } from "node:crypto";
@@ -206,9 +206,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;
@@ -224,8 +228,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);
@@ -255,9 +259,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;
@@ -273,8 +281,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);
@@ -441,10 +449,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 = [];
@@ -465,20 +476,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 {
@@ -496,6 +571,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");
@@ -2085,10 +2169,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 } : {}
@@ -2100,11 +2190,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
@@ -2643,6 +2739,7 @@ var WorkflowSnapshotCodec = class {
 				name: config.name,
 				id: config.id,
 				icon: config.icon,
+				description: config.description,
 				execution: config.execution
 			};
 			this.injectTokenIds(fallback, config);
@@ -6582,5 +6679,5 @@ var WorkflowRepositoryWebhookTriggerMatcherFactory = class {
 };
 
 //#endregion
-export { CostTrackingTelemetryAttributeNames as $, PersistedWorkflowTokenRegistry as A, node as At, CatalogBackedCostTrackingTelemetryFactory as B, HumanTaskStoreToken as Bt, DefaultDrivingScheduler as C, WhenBuilder as Ct, NodeInstanceFactoryFactory as D, defineNode as Dt, StaticCostCatalog as E, defineBatchNode as Et, InProcessRetryRunnerFactory as F, PersistedRuntimeTypeNameResolver as Ft, AllWorkflowsActiveWorkflowActivationPolicy as G, CodemationTelemetryMetricNames as H, RunnableOutputBehaviorResolver as I, DefinedNodeRegistry as It, NoOpNodeExecutionTelemetry as J, NoOpExecutionTelemetryFactory as K, NodeOutputNormalizer as L, HitlResumeTokenSignerToken as Lt, NodeExecutorFactory as M, InjectableRuntimeDecoratorComposer as Mt, NodeExecutor as N, PersistedRuntimeTypeMetadataStore as Nt, NodeInstanceFactory as O, chatModel as Ot, RunSuspendedError as P, StackTraceCallSitePathResolver as Pt, NoOpCostTrackingTelemetry as Q, ItemExprResolver as R, HitlTimeoutJobSchedulerToken as Rt, HintOnlyOffloadPolicy as S, ChainCursor as St, RunPolicySnapshotFactory as T, isHumanApprovalNode as Tt, GenAiTelemetryAttributeNames as U, DefaultExecutionContextFactory as V, CodemationTelemetryAttributeNames as W, NoOpTelemetryArtifactReference as X, NoOpTelemetrySpanScope as Y, NoOpCostTrackingTelemetryFactory as Z, RunTerminalPersistenceCoordinator as _, WorkflowExecutableNodeClassifier as _t, InMemoryLiveWorkflowRepository as a, isPortsEmission as at, LocalOnlyScheduler as b, WorkflowDefinitionError as bt, EngineFactory as c, CredentialResolverFactory as ct, PollingTriggerRuntime as d, DefaultExecutionBinaryService as dt, CostTrackingTelemetryMetricNames as et, PollingTriggerDedupWindow as f, UnavailableBinaryStorage as ft, WorkflowPolicyErrorServices as g, WorkflowExecutableNodeClassifierFactory as gt, WorkflowStoragePolicyEvaluator as h, DefaultWorkflowGraphFactory as ht, RunIntentService as i, emitPorts as it, MissingRuntimeTriggerToken as j, tool as jt, WorkflowSnapshotCodec as k, getPersistedRuntimeTypeMetadata as kt, Engine as l, getOriginIndexFromItem as lt, InMemoryBinaryStorage as m, ConnectionInvocationEventPublisher as mt, WorkflowRepositoryWebhookTriggerMatcher as n, RetryPolicy as nt, EngineWorkflowRunnerServiceFactory as o, isUnbrandedPortsEmissionShape as ot, InMemoryRunDataFactory as p, NodeEventPublisher as pt, NoOpExecutionTelemetry as q, RunIntentServiceFactory as r, NoRetryPolicy as rt, EngineWorkflowRunnerService as s, DefaultAsyncSleeper as st, WorkflowRepositoryWebhookTriggerMatcherFactory as t, ExpRetryPolicy as tt, NoOpPollingTriggerLogger as u, ChildExecutionScopeFactory as ut, ENGINE_EXECUTION_LIMITS_DEFAULTS as v, ConnectionInvocationIdFactory as vt, ConfigDrivenOffloadPolicy as w, defineHumanApprovalNode as wt, InlineDrivingScheduler as x, NodeIdSlugifier as xt, EngineExecutionLimitsPolicy as y, WorkflowBuilder as yt, InProcessRetryRunner as z, HitlWorkspaceIdToken as zt };
-//# sourceMappingURL=runtime-CWPdvJpC.js.map
+export { CostTrackingTelemetryAttributeNames as $, PersistedWorkflowTokenRegistry as A, getPersistedRuntimeTypeMetadata as At, CatalogBackedCostTrackingTelemetryFactory as B, HitlWorkspaceIdToken as Bt, DefaultDrivingScheduler as C, mergeForward as Ct, NodeInstanceFactoryFactory as D, defineBatchNode as Dt, StaticCostCatalog as E, isHumanApprovalNode as Et, InProcessRetryRunnerFactory as F, StackTraceCallSitePathResolver as Ft, AllWorkflowsActiveWorkflowActivationPolicy as G, CodemationTelemetryMetricNames as H, RunnableOutputBehaviorResolver as I, PersistedRuntimeTypeNameResolver as It, NoOpNodeExecutionTelemetry as J, NoOpExecutionTelemetryFactory as K, NodeOutputNormalizer as L, DefinedNodeRegistry as Lt, NodeExecutorFactory as M, tool as Mt, NodeExecutor as N, InjectableRuntimeDecoratorComposer as Nt, NodeInstanceFactory as O, defineNode as Ot, RunSuspendedError as P, PersistedRuntimeTypeMetadataStore as Pt, NoOpCostTrackingTelemetry as Q, ItemExprResolver as R, HitlResumeTokenSignerToken as Rt, HintOnlyOffloadPolicy as S, ChainCursor as St, RunPolicySnapshotFactory as T, defineHumanApprovalNode as Tt, GenAiTelemetryAttributeNames as U, DefaultExecutionContextFactory as V, HumanTaskStoreToken as Vt, CodemationTelemetryAttributeNames as W, NoOpTelemetryArtifactReference as X, NoOpTelemetrySpanScope as Y, NoOpCostTrackingTelemetryFactory as Z, RunTerminalPersistenceCoordinator as _, WorkflowExecutableNodeClassifier as _t, InMemoryLiveWorkflowRepository as a, isPortsEmission as at, LocalOnlyScheduler as b, WorkflowDefinitionError as bt, EngineFactory as c, CredentialResolverFactory as ct, PollingTriggerRuntime as d, DefaultExecutionBinaryService as dt, CostTrackingTelemetryMetricNames as et, PollingTriggerDedupWindow as f, UnavailableBinaryStorage as ft, WorkflowPolicyErrorServices as g, WorkflowExecutableNodeClassifierFactory as gt, WorkflowStoragePolicyEvaluator as h, DefaultWorkflowGraphFactory as ht, RunIntentService as i, emitPorts as it, MissingRuntimeTriggerToken as j, node as jt, WorkflowSnapshotCodec as k, chatModel as kt, Engine as l, getOriginIndexFromItem as lt, InMemoryBinaryStorage as m, ConnectionInvocationEventPublisher as mt, WorkflowRepositoryWebhookTriggerMatcher as n, RetryPolicy as nt, EngineWorkflowRunnerServiceFactory as o, isUnbrandedPortsEmissionShape as ot, InMemoryRunDataFactory as p, NodeEventPublisher as pt, NoOpExecutionTelemetry as q, RunIntentServiceFactory as r, NoRetryPolicy as rt, EngineWorkflowRunnerService as s, DefaultAsyncSleeper as st, WorkflowRepositoryWebhookTriggerMatcherFactory as t, ExpRetryPolicy as tt, NoOpPollingTriggerLogger as u, ChildExecutionScopeFactory as ut, ENGINE_EXECUTION_LIMITS_DEFAULTS as v, ConnectionInvocationIdFactory as vt, ConfigDrivenOffloadPolicy as w, WhenBuilder as wt, InlineDrivingScheduler as x, NodeIdSlugifier as xt, EngineExecutionLimitsPolicy as y, WorkflowBuilder as yt, InProcessRetryRunner as z, HitlTimeoutJobSchedulerToken as zt };
+//# sourceMappingURL=runtime-CSunvf7A.js.map