@codemation/core-nodes 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @codemation/core-nodes
 
+## 0.4.0
+
+### Minor Changes
+
+- [#81](https://github.com/MadeRelevant/codemation/pull/81) [`88844f7`](https://github.com/MadeRelevant/codemation/commit/88844f75a48fe051e4cb895c710408855de14da4) Thanks [@cblokland90](https://github.com/cblokland90)! - Improve workflow DSL typing for helper-defined nodes.
+  - allow `.node(...)` and branch `.node(...)` calls to accept helper-node params that use `itemExpr(...)`
+  - preserve type safety when the current workflow item is a superset of the helper node's declared input shape
+  - remove the need for common casts around empty-config helper nodes
+
+### Patch Changes
+
+- Updated dependencies [[`88844f7`](https://github.com/MadeRelevant/codemation/commit/88844f75a48fe051e4cb895c710408855de14da4)]:
+  - @codemation/core@0.7.0
+
+## 0.3.0
+
+### Minor Changes
+
+- [#78](https://github.com/MadeRelevant/codemation/pull/78) [`f451b1b`](https://github.com/MadeRelevant/codemation/commit/f451b1b4657b59406e15ce5f50b243e487ff99ed) Thanks [@cblokland90](https://github.com/cblokland90)! - Normalize fluent workflow DSL callback helpers around the runtime item contract.
+
+  `.map(...)`, `.if(...)`, and `.switch({ resolveCaseKey })` now receive `(item, ctx)` so workflow authors can use `item.json` consistently and read prior completed outputs through `ctx.data` without dropping down to direct node configs.
+
 ## 0.2.0
 
 ### Minor Changes
@@ -17,7 +39,7 @@
 
   `WorkflowAgentOptions` now takes `messages` (the same `AgentMessageConfig` as `AIAgent`) instead of
   `prompt`. The workflow helper passes `messages` through unchanged. Docs, workflow DSL skills, and the
-  test-dev sample use `itemValue(...)` for per-item prompts; execution docs note `itemValue` on agent
+  test-dev sample use `itemExpr(...)` for per-item prompts; execution docs note `itemExpr` on agent
   `messages`.
 
 ### Patch Changes

package/dist/index.cjs

@@ -2720,9 +2720,9 @@ var AgentToolCallPortMap = class {
 //#region src/nodes/NodeBackedToolRuntime.ts
 var _ref$1, _ref2$1, _ref3$1;
 let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
-	constructor(nodeResolver, itemValueResolver, outputNormalizer, outputBehaviorResolver) {
+	constructor(nodeResolver, itemExprResolver, outputNormalizer, outputBehaviorResolver) {
 		this.nodeResolver = nodeResolver;
-		this.itemValueResolver = itemValueResolver;
+		this.itemExprResolver = itemExprResolver;
 		this.outputNormalizer = outputNormalizer;
 		this.outputBehaviorResolver = outputBehaviorResolver;
 	}
@@ -2764,7 +2764,7 @@ let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
 				item: nodeInput,
 				itemIndex: 0,
 				items,
-				ctx: await this.itemValueResolver.resolveConfigForItem(ctx, nodeInput, 0, items)
+				ctx: await this.itemExprResolver.resolveConfigForItem(ctx, nodeInput, 0, items)
 			};
 			const raw = await Promise.resolve(runnable.execute(execArgs));
 			return this.outputNormalizer.normalizeExecuteResult({
@@ -2785,12 +2785,12 @@ let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
 NodeBackedToolRuntime = __decorate([
 	(0, __codemation_core.injectable)(),
 	__decorateParam(0, (0, __codemation_core.inject)(__codemation_core.CoreTokens.NodeResolver)),
-	__decorateParam(1, (0, __codemation_core.inject)(__codemation_core.ItemValueResolver)),
+	__decorateParam(1, (0, __codemation_core.inject)(__codemation_core.ItemExprResolver)),
 	__decorateParam(2, (0, __codemation_core.inject)(__codemation_core.NodeOutputNormalizer)),
 	__decorateParam(3, (0, __codemation_core.inject)(__codemation_core.RunnableOutputBehaviorResolver)),
 	__decorateMetadata("design:paramtypes", [
 		Object,
-		typeof (_ref$1 = typeof __codemation_core.ItemValueResolver !== "undefined" && __codemation_core.ItemValueResolver) === "function" ? _ref$1 : Object,
+		typeof (_ref$1 = typeof __codemation_core.ItemExprResolver !== "undefined" && __codemation_core.ItemExprResolver) === "function" ? _ref$1 : Object,
 		typeof (_ref2$1 = typeof __codemation_core.NodeOutputNormalizer !== "undefined" && __codemation_core.NodeOutputNormalizer) === "function" ? _ref2$1 : Object,
 		typeof (_ref3$1 = typeof __codemation_core.RunnableOutputBehaviorResolver !== "undefined" && __codemation_core.RunnableOutputBehaviorResolver) === "function" ? _ref3$1 : Object
 	])
@@ -2812,7 +2812,7 @@ let AIAgentNode = class AIAgentNode$1 {
 	outputPorts = ["main"];
 	/**
 	* 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
+	* per-item **`itemExpr`** 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();
@@ -4058,7 +4058,7 @@ var WorkflowBranchBuilder = class WorkflowBranchBuilder {
 	map(nameOrMapper, mapperOrUndefined, options) {
 		const name = typeof nameOrMapper === "string" ? nameOrMapper : "Map data";
 		const mapper = typeof nameOrMapper === "string" ? mapperOrUndefined : nameOrMapper;
-		return this.then(new MapData(name, (item) => mapper(item.json), options));
+		return this.then(new MapData(name, mapper, options));
 	}
 	wait(nameOrDuration, durationOrUndefined, id) {
 		const name = typeof nameOrDuration === "string" && durationOrUndefined !== void 0 ? nameOrDuration : "Wait";
@@ -4104,7 +4104,7 @@ var WorkflowChain = class WorkflowChain {
 	map(nameOrMapper, mapperOrUndefined, options) {
 		const name = typeof nameOrMapper === "string" ? nameOrMapper : "Map data";
 		const mapper = typeof nameOrMapper === "string" ? mapperOrUndefined : nameOrMapper;
-		return this.then(new MapData(name, (item) => mapper(item.json), options));
+		return this.then(new MapData(name, mapper, options));
 	}
 	wait(nameOrDuration, durationOrUndefined, id) {
 		const name = typeof nameOrDuration === "string" && durationOrUndefined !== void 0 ? nameOrDuration : "Wait";
@@ -4136,7 +4136,7 @@ var WorkflowChain = class WorkflowChain {
 		const name = typeof nameOrPredicate === "string" ? nameOrPredicate : "If";
 		const predicate = typeof nameOrPredicate === "string" ? predicateOrBranches : nameOrPredicate;
 		const branches = typeof nameOrPredicate === "string" ? branchesOrUndefined : predicateOrBranches;
-		const cursor = this.chain.then(new If(name, (item) => predicate(item.json)));
+		const cursor = this.chain.then(new If(name, (item, _index, _items, ctx) => predicate(item, ctx)));
 		const trueSteps = branches.true?.(new WorkflowBranchBuilder()).getSteps();
 		const falseSteps = branches.false?.(new WorkflowBranchBuilder()).getSteps();
 		return new WorkflowChain(cursor.when({
@@ -4154,7 +4154,7 @@ var WorkflowChain = class WorkflowChain {
 		return this.then(new Switch(name, {
 			cases: cfg.cases,
 			defaultCase: cfg.defaultCase,
-			resolveCaseKey: (item) => cfg.resolveCaseKey(item.json)
+			resolveCaseKey: (item, _index, _items, ctx) => cfg.resolveCaseKey(item, ctx)
 		}, id)).route(cfg.branches);
 	}
 	agent(nameOrOptions, optionsOrUndefined) {