@codemation/core-nodes 0.3.0 → 0.4.1

package/dist/index.d.cts

@@ -21,9 +21,9 @@ type PortsEmission = Readonly<{
   readonly ports: Readonly<Partial<Record<OutputPortKey, Items | ReadonlyArray<JsonNonArray>>>>;
 }>;
 //#endregion
-//#region ../core/src/contracts/itemValue.d.ts
-declare const ITEM_VALUE_BRAND: unique symbol;
-type ItemValueResolvedContext = Readonly<{
+//#region ../core/src/contracts/itemExpr.d.ts
+declare const ITEM_EXPR_BRAND: unique symbol;
+type ItemExprResolvedContext = Readonly<{
   runId: RunId;
   workflowId: WorkflowId;
   nodeId: NodeId;
@@ -33,19 +33,23 @@ type ItemValueResolvedContext = Readonly<{
 /**
  * Context aligned with former {@link ItemInputMapperContext} — use **`data`** to read any completed upstream node.
  */
-type ItemValueContext = ItemValueResolvedContext;
-type ItemValueArgs<TItemJson = unknown> = Readonly<{
+type ItemExprContext = ItemExprResolvedContext;
+type ItemExprArgs<TItemJson = unknown> = Readonly<{
   item: Item<TItemJson>;
   itemIndex: number;
   items: Items<TItemJson>;
-  ctx: ItemValueContext;
+  ctx: ItemExprContext;
 }>;
-type ItemValueCallback<T, TItemJson = unknown> = (args: ItemValueArgs<TItemJson>) => T | Promise<T>;
-type ItemValue<T, TItemJson = unknown> = Readonly<{
-  readonly [ITEM_VALUE_BRAND]: true;
-  readonly fn: ItemValueCallback<T, TItemJson>;
+type ItemExprCallback<T, TItemJson = unknown> = (args: ItemExprArgs<TItemJson>) => T | Promise<T>;
+type ItemExpr<T, TItemJson = unknown> = Readonly<{
+  readonly [ITEM_EXPR_BRAND]: true;
+  readonly fn: ItemExprCallback<T, TItemJson>;
 }>;
 //#endregion
+//#region ../core/src/contracts/params.d.ts
+type Expr<T, TItemJson = unknown> = ItemExpr<T, TItemJson>;
+type ParamDeep<T, TItemJson = unknown> = Expr<T, TItemJson> | (T extends readonly (infer U)[] ? ReadonlyArray<ParamDeep<U, TItemJson>> : never) | (T extends object ? { [K in keyof T]: ParamDeep<T[K], TItemJson> } : T);
+//#endregion
 //#region ../core/src/contracts/retryPolicySpec.types.d.ts
 /**
  * In-process retry policy for runnable nodes. Serialized configs use the same
@@ -362,6 +366,9 @@ type ExecutableTriggerNode<TConfig extends TriggerNodeConfig<any, any> = Trigger
 //#region ../core/src/contracts/workflowTypes.d.ts
 type WorkflowId = string;
 type NodeId = string;
+type NodeIdRef<TJson = unknown> = NodeId & Readonly<{
+  __codemationNodeJson?: TJson;
+}>;
 type OutputPortKey = string;
 type InputPortKey = string;
 type NodeKind = "trigger" | "node";
@@ -531,8 +538,8 @@ interface ParentExecutionRef {
 }
 interface RunDataSnapshot {
   getOutputs(nodeId: NodeId): NodeOutputs | undefined;
-  getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;
-  getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;
+  getOutputItems<TJson = unknown>(nodeId: NodeId | NodeIdRef<TJson>, output?: OutputPortKey): Items<TJson>;
+  getOutputItem<TJson = unknown>(nodeId: NodeId | NodeIdRef<TJson>, itemIndex: number, output?: OutputPortKey): Item<TJson> | undefined;
 }
 type UpstreamRefPlaceholder = `$${number}`;
 /** Whether to persist run execution data after the workflow finishes. */
@@ -738,12 +745,13 @@ type DefinedNodeCredentialBinding = ResolvableCredentialType | Readonly<{
   readonly helpUrl?: string;
 }>;
 type DefinedNodeCredentialBindings = Readonly<Record<string, DefinedNodeCredentialBinding>>;
+type DefinedNodeConfigInput<TConfigResolved extends CredentialJsonRecord, TItemJson> = ParamDeep<TConfigResolved, TItemJson>;
 interface DefinedNode<TKey$1 extends string, TConfig extends CredentialJsonRecord, TInputJson$1, TOutputJson$1, _TBindings extends DefinedNodeCredentialBindings | undefined = undefined> {
   readonly kind: "defined-node";
   readonly key: TKey$1;
   readonly title: string;
   readonly description?: string;
-  create(config: TConfig, name?: string, id?: string): RunnableNodeConfig<TInputJson$1, TOutputJson$1>;
+  create<TConfigItemJson = TInputJson$1>(config: DefinedNodeConfigInput<TConfig, TConfigItemJson>, name?: string, id?: string): RunnableNodeConfig<TInputJson$1, TOutputJson$1>;
   register(context: {
     registerNode<TValue>(token: TypeToken<TValue>, implementation?: TypeToken<TValue>): void;
   }): void;
@@ -814,7 +822,7 @@ type AgentMessageLine<TInputJson$1 = unknown> = AgentMessageDto | AgentMessageTe
  * Message list for an agent. Prefer a **plain array** of `{ role, content }` (optionally with function `content` for templates).
  * Use the object form only when you need `buildMessages` to append messages after optional `prompt` lines.
  */
-type AgentMessageConfig<TInputJson$1 = unknown> = ItemValue<ReadonlyArray<AgentMessageLine<TInputJson$1>>, TInputJson$1> | ReadonlyArray<AgentMessageLine<TInputJson$1>> | {
+type AgentMessageConfig<TInputJson$1 = unknown> = Expr<ReadonlyArray<AgentMessageLine<TInputJson$1>>, TInputJson$1> | ReadonlyArray<AgentMessageLine<TInputJson$1>> | {
   readonly prompt?: ReadonlyArray<AgentMessageLine<TInputJson$1>>;
   readonly buildMessages?: (args: AgentMessageBuildArgs<TInputJson$1>) => ReadonlyArray<AgentMessageDto>;
 };
@@ -894,11 +902,11 @@ interface AgentNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> exten
   readonly outputSchema?: ZodType<TOutputJson$1>;
 }
 //#endregion
-//#region ../core/src/execution/ItemValueResolver.d.ts
+//#region ../core/src/execution/ItemExprResolver.d.ts
 /**
- * Resolves {@link import("../contracts/itemValue").ItemValue} leaves on runnable config before {@link RunnableNode.execute}.
+ * Resolves {@link import("../contracts/itemExpr").ItemExpr} leaves on runnable config before {@link RunnableNode.execute}.
  */
-declare class ItemValueResolver {
+declare class ItemExprResolver {
   resolveConfigForItem<TConfig extends RunnableNodeConfig<any, any>>(ctx: NodeExecutionContext<TConfig>, item: Item, itemIndex: number, items: ReadonlyArray<Item>): Promise<NodeExecutionContext<TConfig>>;
 }
 //#endregion
@@ -1155,10 +1163,10 @@ declare class AIAgent<TInputJson$1 = unknown, TOutputJson$1 = unknown> implement
 //#region src/nodes/NodeBackedToolRuntime.d.ts
 declare class NodeBackedToolRuntime {
   private readonly nodeResolver;
-  private readonly itemValueResolver;
+  private readonly itemExprResolver;
   private readonly outputNormalizer;
   private readonly outputBehaviorResolver;
-  constructor(nodeResolver: NodeResolver, itemValueResolver: ItemValueResolver, outputNormalizer: NodeOutputNormalizer, outputBehaviorResolver: RunnableOutputBehaviorResolver);
+  constructor(nodeResolver: NodeResolver, itemExprResolver: ItemExprResolver, outputNormalizer: NodeOutputNormalizer, outputBehaviorResolver: RunnableOutputBehaviorResolver);
   execute(config: NodeBackedToolConfig<any, ZodSchemaAny, ZodSchemaAny>, args: ToolExecuteArgs): Promise<unknown>;
   private executeResolvedNode;
   private isRunnableNode;
@@ -1175,7 +1183,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   outputPorts: readonly ["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.
    */
   readonly inputSchema: z.ZodUnknown;
@@ -1345,6 +1353,7 @@ declare class Aggregate<TIn = unknown, TOut = unknown> implements RunnableNodeCo
   readonly execution: {
     readonly hint: "local";
   };
+  readonly keepBinaries: true;
   readonly icon: "lucide:layers";
   constructor(name: string, aggregate: (items: Items<TIn>, ctx: NodeExecutionContext<Aggregate<TIn, TOut>>) => TOut | Promise<TOut>, id?: string | undefined);
 }
@@ -1441,6 +1450,7 @@ declare class Split<TIn = unknown, TElem = unknown> implements RunnableNodeConfi
   readonly execution: {
     readonly hint: "local";
   };
+  readonly keepBinaries: true;
   /**
    * When splitting yields zero items for a batch, downstream single-input nodes still run once with an empty batch.
    * Mirrors {@link MapData}'s empty-output behavior.
@@ -1713,7 +1723,7 @@ declare class WorkflowBranchBuilder<TCurrentJson> {
   agent<TOutputSchema extends z.ZodTypeAny>(options: WorkflowAgentOptions<TCurrentJson, TOutputSchema>): WorkflowBranchBuilder<z.output<TOutputSchema>>;
   agent(options: WorkflowAgentOptions<TCurrentJson, undefined>): WorkflowBranchBuilder<Record<string, unknown>>;
   agent<TOutputSchema extends z.ZodTypeAny>(name: string, options: WorkflowAgentOptions<TCurrentJson, TOutputSchema | undefined>): WorkflowBranchBuilder<TOutputSchema extends z.ZodTypeAny ? z.output<TOutputSchema> : Record<string, unknown>>;
-  node<TConfig extends Record<string, unknown>, TOutputJson$1>(definitionOrKey: DefinedNode<string, TConfig, TCurrentJson, TOutputJson$1> | string, config: TConfig, name?: string, id?: string): WorkflowBranchBuilder<TOutputJson$1>;
+  node<TConfig extends CredentialJsonRecord, TInputJson$1, TOutputJson$1>(definitionOrKey: DefinedNode<string, TConfig, TInputJson$1, TOutputJson$1> | string, config: DefinedNodeConfigInput<TConfig, TCurrentJson>, name?: string, id?: string): TCurrentJson extends TInputJson$1 ? WorkflowBranchBuilder<TOutputJson$1> : never;
   getSteps(): ReadonlyArray<AnyRunnableNodeConfig>;
 }
 //#endregion
@@ -1770,7 +1780,7 @@ declare class WorkflowChain<TCurrentJson> {
   agent<TOutputSchema extends z.ZodTypeAny>(options: WorkflowAgentOptions<TCurrentJson, TOutputSchema>): WorkflowChain<z.output<TOutputSchema>>;
   agent(options: WorkflowAgentOptions<TCurrentJson, undefined>): WorkflowChain<Record<string, unknown>>;
   agent<TOutputSchema extends z.ZodTypeAny>(name: string, options: WorkflowAgentOptions<TCurrentJson, TOutputSchema | undefined>): WorkflowChain<TOutputSchema extends z.ZodTypeAny ? z.output<TOutputSchema> : Record<string, unknown>>;
-  node<TConfig extends Record<string, unknown>, TOutputJson$1>(definitionOrKey: DefinedNode<string, TConfig, TCurrentJson, TOutputJson$1> | string, config: TConfig, name?: string, id?: string): WorkflowChain<TOutputJson$1>;
+  node<TConfig extends CredentialJsonRecord, TInputJson$1, TOutputJson$1>(definitionOrKey: DefinedNode<string, TConfig, TInputJson$1, TOutputJson$1> | string, config: DefinedNodeConfigInput<TConfig, TCurrentJson>, name?: string, id?: string): TCurrentJson extends TInputJson$1 ? WorkflowChain<TOutputJson$1> : never;
   build(): WorkflowDefinition;
 }
 //#endregion

package/dist/index.d.ts

@@ -21,9 +21,9 @@ type PortsEmission = Readonly<{
   readonly ports: Readonly<Partial<Record<OutputPortKey, Items | ReadonlyArray<JsonNonArray>>>>;
 }>;
 //#endregion
-//#region ../core/src/contracts/itemValue.d.ts
-declare const ITEM_VALUE_BRAND: unique symbol;
-type ItemValueResolvedContext = Readonly<{
+//#region ../core/src/contracts/itemExpr.d.ts
+declare const ITEM_EXPR_BRAND: unique symbol;
+type ItemExprResolvedContext = Readonly<{
   runId: RunId;
   workflowId: WorkflowId;
   nodeId: NodeId;
@@ -33,19 +33,23 @@ type ItemValueResolvedContext = Readonly<{
 /**
  * Context aligned with former {@link ItemInputMapperContext} — use **`data`** to read any completed upstream node.
  */
-type ItemValueContext = ItemValueResolvedContext;
-type ItemValueArgs<TItemJson = unknown> = Readonly<{
+type ItemExprContext = ItemExprResolvedContext;
+type ItemExprArgs<TItemJson = unknown> = Readonly<{
   item: Item<TItemJson>;
   itemIndex: number;
   items: Items<TItemJson>;
-  ctx: ItemValueContext;
+  ctx: ItemExprContext;
 }>;
-type ItemValueCallback<T, TItemJson = unknown> = (args: ItemValueArgs<TItemJson>) => T | Promise<T>;
-type ItemValue<T, TItemJson = unknown> = Readonly<{
-  readonly [ITEM_VALUE_BRAND]: true;
-  readonly fn: ItemValueCallback<T, TItemJson>;
+type ItemExprCallback<T, TItemJson = unknown> = (args: ItemExprArgs<TItemJson>) => T | Promise<T>;
+type ItemExpr<T, TItemJson = unknown> = Readonly<{
+  readonly [ITEM_EXPR_BRAND]: true;
+  readonly fn: ItemExprCallback<T, TItemJson>;
 }>;
 //#endregion
+//#region ../core/src/contracts/params.d.ts
+type Expr<T, TItemJson = unknown> = ItemExpr<T, TItemJson>;
+type ParamDeep<T, TItemJson = unknown> = Expr<T, TItemJson> | (T extends readonly (infer U)[] ? ReadonlyArray<ParamDeep<U, TItemJson>> : never) | (T extends object ? { [K in keyof T]: ParamDeep<T[K], TItemJson> } : T);
+//#endregion
 //#region ../core/src/contracts/retryPolicySpec.types.d.ts
 /**
  * In-process retry policy for runnable nodes. Serialized configs use the same
@@ -362,6 +366,9 @@ type ExecutableTriggerNode<TConfig extends TriggerNodeConfig<any, any> = Trigger
 //#region ../core/src/contracts/workflowTypes.d.ts
 type WorkflowId = string;
 type NodeId = string;
+type NodeIdRef<TJson = unknown> = NodeId & Readonly<{
+  __codemationNodeJson?: TJson;
+}>;
 type OutputPortKey = string;
 type InputPortKey = string;
 type NodeKind = "trigger" | "node";
@@ -531,8 +538,8 @@ interface ParentExecutionRef {
 }
 interface RunDataSnapshot {
   getOutputs(nodeId: NodeId): NodeOutputs | undefined;
-  getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;
-  getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;
+  getOutputItems<TJson = unknown>(nodeId: NodeId | NodeIdRef<TJson>, output?: OutputPortKey): Items<TJson>;
+  getOutputItem<TJson = unknown>(nodeId: NodeId | NodeIdRef<TJson>, itemIndex: number, output?: OutputPortKey): Item<TJson> | undefined;
 }
 type UpstreamRefPlaceholder = `$${number}`;
 /** Whether to persist run execution data after the workflow finishes. */
@@ -738,12 +745,13 @@ type DefinedNodeCredentialBinding = ResolvableCredentialType | Readonly<{
   readonly helpUrl?: string;
 }>;
 type DefinedNodeCredentialBindings = Readonly<Record<string, DefinedNodeCredentialBinding>>;
+type DefinedNodeConfigInput<TConfigResolved extends CredentialJsonRecord, TItemJson> = ParamDeep<TConfigResolved, TItemJson>;
 interface DefinedNode<TKey$1 extends string, TConfig extends CredentialJsonRecord, TInputJson$1, TOutputJson$1, _TBindings extends DefinedNodeCredentialBindings | undefined = undefined> {
   readonly kind: "defined-node";
   readonly key: TKey$1;
   readonly title: string;
   readonly description?: string;
-  create(config: TConfig, name?: string, id?: string): RunnableNodeConfig<TInputJson$1, TOutputJson$1>;
+  create<TConfigItemJson = TInputJson$1>(config: DefinedNodeConfigInput<TConfig, TConfigItemJson>, name?: string, id?: string): RunnableNodeConfig<TInputJson$1, TOutputJson$1>;
   register(context: {
     registerNode<TValue>(token: TypeToken<TValue>, implementation?: TypeToken<TValue>): void;
   }): void;
@@ -814,7 +822,7 @@ type AgentMessageLine<TInputJson$1 = unknown> = AgentMessageDto | AgentMessageTe
  * Message list for an agent. Prefer a **plain array** of `{ role, content }` (optionally with function `content` for templates).
  * Use the object form only when you need `buildMessages` to append messages after optional `prompt` lines.
  */
-type AgentMessageConfig<TInputJson$1 = unknown> = ItemValue<ReadonlyArray<AgentMessageLine<TInputJson$1>>, TInputJson$1> | ReadonlyArray<AgentMessageLine<TInputJson$1>> | {
+type AgentMessageConfig<TInputJson$1 = unknown> = Expr<ReadonlyArray<AgentMessageLine<TInputJson$1>>, TInputJson$1> | ReadonlyArray<AgentMessageLine<TInputJson$1>> | {
   readonly prompt?: ReadonlyArray<AgentMessageLine<TInputJson$1>>;
   readonly buildMessages?: (args: AgentMessageBuildArgs<TInputJson$1>) => ReadonlyArray<AgentMessageDto>;
 };
@@ -894,11 +902,11 @@ interface AgentNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> exten
   readonly outputSchema?: ZodType<TOutputJson$1>;
 }
 //#endregion
-//#region ../core/src/execution/ItemValueResolver.d.ts
+//#region ../core/src/execution/ItemExprResolver.d.ts
 /**
- * Resolves {@link import("../contracts/itemValue").ItemValue} leaves on runnable config before {@link RunnableNode.execute}.
+ * Resolves {@link import("../contracts/itemExpr").ItemExpr} leaves on runnable config before {@link RunnableNode.execute}.
  */
-declare class ItemValueResolver {
+declare class ItemExprResolver {
   resolveConfigForItem<TConfig extends RunnableNodeConfig<any, any>>(ctx: NodeExecutionContext<TConfig>, item: Item, itemIndex: number, items: ReadonlyArray<Item>): Promise<NodeExecutionContext<TConfig>>;
 }
 //#endregion
@@ -1155,10 +1163,10 @@ declare class AIAgent<TInputJson$1 = unknown, TOutputJson$1 = unknown> implement
 //#region src/nodes/NodeBackedToolRuntime.d.ts
 declare class NodeBackedToolRuntime {
   private readonly nodeResolver;
-  private readonly itemValueResolver;
+  private readonly itemExprResolver;
   private readonly outputNormalizer;
   private readonly outputBehaviorResolver;
-  constructor(nodeResolver: NodeResolver, itemValueResolver: ItemValueResolver, outputNormalizer: NodeOutputNormalizer, outputBehaviorResolver: RunnableOutputBehaviorResolver);
+  constructor(nodeResolver: NodeResolver, itemExprResolver: ItemExprResolver, outputNormalizer: NodeOutputNormalizer, outputBehaviorResolver: RunnableOutputBehaviorResolver);
   execute(config: NodeBackedToolConfig<any, ZodSchemaAny, ZodSchemaAny>, args: ToolExecuteArgs): Promise<unknown>;
   private executeResolvedNode;
   private isRunnableNode;
@@ -1175,7 +1183,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   outputPorts: readonly ["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.
    */
   readonly inputSchema: z.ZodUnknown;
@@ -1345,6 +1353,7 @@ declare class Aggregate<TIn = unknown, TOut = unknown> implements RunnableNodeCo
   readonly execution: {
     readonly hint: "local";
   };
+  readonly keepBinaries: true;
   readonly icon: "lucide:layers";
   constructor(name: string, aggregate: (items: Items<TIn>, ctx: NodeExecutionContext<Aggregate<TIn, TOut>>) => TOut | Promise<TOut>, id?: string | undefined);
 }
@@ -1441,6 +1450,7 @@ declare class Split<TIn = unknown, TElem = unknown> implements RunnableNodeConfi
   readonly execution: {
     readonly hint: "local";
   };
+  readonly keepBinaries: true;
   /**
    * When splitting yields zero items for a batch, downstream single-input nodes still run once with an empty batch.
    * Mirrors {@link MapData}'s empty-output behavior.
@@ -1713,7 +1723,7 @@ declare class WorkflowBranchBuilder<TCurrentJson> {
   agent<TOutputSchema extends z.ZodTypeAny>(options: WorkflowAgentOptions<TCurrentJson, TOutputSchema>): WorkflowBranchBuilder<z.output<TOutputSchema>>;
   agent(options: WorkflowAgentOptions<TCurrentJson, undefined>): WorkflowBranchBuilder<Record<string, unknown>>;
   agent<TOutputSchema extends z.ZodTypeAny>(name: string, options: WorkflowAgentOptions<TCurrentJson, TOutputSchema | undefined>): WorkflowBranchBuilder<TOutputSchema extends z.ZodTypeAny ? z.output<TOutputSchema> : Record<string, unknown>>;
-  node<TConfig extends Record<string, unknown>, TOutputJson$1>(definitionOrKey: DefinedNode<string, TConfig, TCurrentJson, TOutputJson$1> | string, config: TConfig, name?: string, id?: string): WorkflowBranchBuilder<TOutputJson$1>;
+  node<TConfig extends CredentialJsonRecord, TInputJson$1, TOutputJson$1>(definitionOrKey: DefinedNode<string, TConfig, TInputJson$1, TOutputJson$1> | string, config: DefinedNodeConfigInput<TConfig, TCurrentJson>, name?: string, id?: string): TCurrentJson extends TInputJson$1 ? WorkflowBranchBuilder<TOutputJson$1> : never;
   getSteps(): ReadonlyArray<AnyRunnableNodeConfig>;
 }
 //#endregion
@@ -1770,7 +1780,7 @@ declare class WorkflowChain<TCurrentJson> {
   agent<TOutputSchema extends z.ZodTypeAny>(options: WorkflowAgentOptions<TCurrentJson, TOutputSchema>): WorkflowChain<z.output<TOutputSchema>>;
   agent(options: WorkflowAgentOptions<TCurrentJson, undefined>): WorkflowChain<Record<string, unknown>>;
   agent<TOutputSchema extends z.ZodTypeAny>(name: string, options: WorkflowAgentOptions<TCurrentJson, TOutputSchema | undefined>): WorkflowChain<TOutputSchema extends z.ZodTypeAny ? z.output<TOutputSchema> : Record<string, unknown>>;
-  node<TConfig extends Record<string, unknown>, TOutputJson$1>(definitionOrKey: DefinedNode<string, TConfig, TCurrentJson, TOutputJson$1> | string, config: TConfig, name?: string, id?: string): WorkflowChain<TOutputJson$1>;
+  node<TConfig extends CredentialJsonRecord, TInputJson$1, TOutputJson$1>(definitionOrKey: DefinedNode<string, TConfig, TInputJson$1, TOutputJson$1> | string, config: DefinedNodeConfigInput<TConfig, TCurrentJson>, name?: string, id?: string): TCurrentJson extends TInputJson$1 ? WorkflowChain<TOutputJson$1> : never;
   build(): WorkflowDefinition;
 }
 //#endregion

package/dist/index.js

@@ -1,4 +1,4 @@
-import { AgentConfigInspector, AgentConnectionNodeCollector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, CallableToolConfig, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, DefinedNodeRegistry, ItemValueResolver, ItemsInputNormalizer, NodeBackedToolConfig, NodeOutputNormalizer, RetryPolicy, RunnableOutputBehaviorResolver, WorkflowBuilder, chatModel, emitPorts, getOriginIndexFromItem, inject, injectable, isPortsEmission, node } from "@codemation/core";
+import { AgentConfigInspector, AgentConnectionNodeCollector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, CallableToolConfig, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, DefinedNodeRegistry, ItemExprResolver, ItemsInputNormalizer, NodeBackedToolConfig, NodeOutputNormalizer, RetryPolicy, RunnableOutputBehaviorResolver, 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";
@@ -2690,9 +2690,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;
 	}
@@ -2734,7 +2734,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({
@@ -2755,12 +2755,12 @@ let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
 NodeBackedToolRuntime = __decorate([
 	injectable(),
 	__decorateParam(0, inject(CoreTokens.NodeResolver)),
-	__decorateParam(1, inject(ItemValueResolver)),
+	__decorateParam(1, inject(ItemExprResolver)),
 	__decorateParam(2, inject(NodeOutputNormalizer)),
 	__decorateParam(3, inject(RunnableOutputBehaviorResolver)),
 	__decorateMetadata("design:paramtypes", [
 		Object,
-		typeof (_ref$1 = typeof ItemValueResolver !== "undefined" && ItemValueResolver) === "function" ? _ref$1 : Object,
+		typeof (_ref$1 = typeof ItemExprResolver !== "undefined" && ItemExprResolver) === "function" ? _ref$1 : Object,
 		typeof (_ref2$1 = typeof NodeOutputNormalizer !== "undefined" && NodeOutputNormalizer) === "function" ? _ref2$1 : Object,
 		typeof (_ref3$1 = typeof RunnableOutputBehaviorResolver !== "undefined" && RunnableOutputBehaviorResolver) === "function" ? _ref3$1 : Object
 	])
@@ -2782,7 +2782,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();
@@ -3428,6 +3428,7 @@ var Aggregate = class {
 	kind = "node";
 	type = AggregateNode;
 	execution = { hint: "local" };
+	keepBinaries = true;
 	icon = "lucide:layers";
 	constructor(name, aggregate, id) {
 		this.name = name;
@@ -3582,6 +3583,7 @@ var Split = class {
 	kind = "node";
 	type = SplitNode;
 	execution = { hint: "local" };
+	keepBinaries = true;
 	/**
 	* When splitting yields zero items for a batch, downstream single-input nodes still run once with an empty batch.
 	* Mirrors {@link MapData}'s empty-output behavior.