@codemation/core-nodes 0.0.22 → 0.0.24

package/dist/index.d.cts

@@ -115,17 +115,17 @@ interface TriggerInstanceId {
 }
 //#endregion
 //#region ../core/src/workflow/dsl/workflowBuilderTypes.d.ts
-type AnyRunnableNodeConfig = RunnableNodeConfig<any, any>;
+type AnyRunnableNodeConfig = RunnableNodeConfig<any, any, any>;
 type AnyTriggerNodeConfig = TriggerNodeConfig<any>;
-type ValidStepSequence<TCurrentJson, TSteps extends ReadonlyArray<AnyRunnableNodeConfig>> = TSteps extends readonly [] ? readonly [] : TSteps extends readonly [infer TFirst, ...infer TRest] ? TFirst extends RunnableNodeConfig<TCurrentJson, infer TNextJson> ? TRest extends ReadonlyArray<AnyRunnableNodeConfig> ? readonly [TFirst, ...ValidStepSequence<TNextJson, TRest>] : never : never : TSteps;
-type StepSequenceOutput<TCurrentJson, TSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined> = TSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? TSteps extends readonly [] ? TCurrentJson : TSteps extends readonly [infer TFirst, ...infer TRest] ? TFirst extends RunnableNodeConfig<TCurrentJson, infer TNextJson> ? TRest extends ReadonlyArray<AnyRunnableNodeConfig> ? StepSequenceOutput<TNextJson, TRest> : never : never : TCurrentJson : TCurrentJson;
+type ValidStepSequence<TCurrentJson, TSteps extends ReadonlyArray<AnyRunnableNodeConfig>> = TSteps extends readonly [] ? readonly [] : TSteps extends readonly [infer TFirst, ...infer TRest] ? TFirst extends RunnableNodeConfig<infer _TIn, infer TNextJson, TCurrentJson> ? TRest extends ReadonlyArray<AnyRunnableNodeConfig> ? readonly [TFirst, ...ValidStepSequence<TNextJson, TRest>] : never : never : TSteps;
+type StepSequenceOutput<TCurrentJson, TSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined> = TSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? TSteps extends readonly [] ? TCurrentJson : TSteps extends readonly [infer TFirst, ...infer TRest] ? TFirst extends RunnableNodeConfig<infer _TIn, infer TNextJson, TCurrentJson> ? TRest extends ReadonlyArray<AnyRunnableNodeConfig> ? StepSequenceOutput<TNextJson, TRest> : never : never : TCurrentJson : TCurrentJson;
 type TypesMatch<TLeft, TRight> = [TLeft] extends [TRight] ? ([TRight] extends [TLeft] ? true : false) : false;
 type BranchOutputGuard<TCurrentJson, TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined, TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined> = TypesMatch<StepSequenceOutput<TCurrentJson, TTrueSteps>, StepSequenceOutput<TCurrentJson, TFalseSteps>> extends true ? unknown : never;
 type BranchStepsArg<TCurrentJson, TSteps extends ReadonlyArray<AnyRunnableNodeConfig>> = TSteps & ValidStepSequence<TCurrentJson, TSteps>;
-type BranchMoreArgs<TCurrentJson, TFirstStep extends RunnableNodeConfig<TCurrentJson, any>, TRestSteps extends ReadonlyArray<AnyRunnableNodeConfig>> = TRestSteps & ValidStepSequence<RunnableNodeOutputJson<TFirstStep>, TRestSteps>;
+type BranchMoreArgs<TCurrentJson, TFirstStep extends RunnableNodeConfig<any, any, TCurrentJson>, TRestSteps extends ReadonlyArray<AnyRunnableNodeConfig>> = TRestSteps & ValidStepSequence<RunnableNodeOutputJson<TFirstStep>, TRestSteps>;
 type BooleanWhenOverloads<TCurrentJson, TReturn> = {
   <TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(branch: boolean, steps: BranchStepsArg<TCurrentJson, TSteps>): TReturn;
-  <TFirstStep extends RunnableNodeConfig<TCurrentJson, any>, TRestSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(branch: boolean, step: TFirstStep, ...more: BranchMoreArgs<TCurrentJson, TFirstStep, TRestSteps>): TReturn;
+  <TFirstStep extends RunnableNodeConfig<any, any, TCurrentJson>, TRestSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(branch: boolean, step: TFirstStep, ...more: BranchMoreArgs<TCurrentJson, TFirstStep, TRestSteps>): TReturn;
 };
 //#endregion
 //#region ../core/src/workflow/dsl/WhenBuilder.d.ts
@@ -151,7 +151,7 @@ declare class ChainCursor<TCurrentJson> {
   private readonly cursor;
   private readonly cursorOutput;
   constructor(wf: WorkflowBuilder, cursor: NodeRef, cursorOutput: OutputPortKey);
-  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>>;
+  then<TInputJson$1, TOutputJson$1, TConfig extends RunnableNodeConfig<TInputJson$1, TOutputJson$1, TCurrentJson>>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>>;
   readonly when: ChainCursorWhenOverloads<TCurrentJson>;
   build(): WorkflowDefinition;
 }
@@ -279,6 +279,23 @@ interface Node<TConfig extends NodeConfigBase = NodeConfigBase> {
   outputPorts: ReadonlyArray<OutputPortKey>;
   execute(items: Items, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
 }
+/**
+ * Single-input runnable node with per-item execution on `main` only (1→1 default).
+ * Engine applies {@link RunnableNodeConfig.mapInput} (if any) + `inputSchema.parse` before `executeOne`.
+ */
+interface ItemNode<TConfig extends NodeConfigBase = NodeConfigBase, TInputJson$1 = unknown, TOutputJson$1 = unknown> {
+  readonly kind: "node";
+  readonly outputPorts: readonly ["main"];
+  /** When omitted, engine uses {@link RunnableNodeConfig.inputSchema} or `z.unknown()`. */
+  readonly inputSchema?: ZodType<TInputJson$1>;
+  executeOne(args: Readonly<{
+    input: TInputJson$1;
+    item: Item;
+    itemIndex: number;
+    items: Items;
+    ctx: NodeExecutionContext<TConfig>;
+  }>): Promise<TOutputJson$1> | TOutputJson$1;
+}
 interface MultiInputNode<TConfig extends NodeConfigBase = NodeConfigBase> {
   kind: "node";
   outputPorts: ReadonlyArray<OutputPortKey>;
@@ -372,11 +389,61 @@ interface NodeConfigBase {
 }
 declare const runnableNodeInputType: unique symbol;
 declare const runnableNodeOutputType: unique symbol;
+/** Phantom: JSON shape on the wire from upstream before {@link RunnableNodeConfig.mapInput}. */
+declare const runnableNodeWireType: unique symbol;
 declare const triggerNodeOutputType: unique symbol;
-interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> extends NodeConfigBase {
+/**
+ * Read-only execution slice passed to {@link RunnableNodeConfig.mapInput} (aligned with the engine’s
+ * node execution context for `runId`, `data`, etc.). Use **`ctx.data`** to read **any completed** upstream
+ * node’s outputs in this run (e.g. `ctx.data.getOutputItems(nodeIdA, "main")` while mapping at D), not only
+ * the immediate predecessor’s {@link ItemInputMapperArgs.item}.
+ */
+interface ItemInputMapperContext {
+  readonly runId: RunId;
+  readonly workflowId: WorkflowId;
+  /** Node whose activation is being prepared (the consumer of `mapInput`). */
+  readonly nodeId: NodeId;
+  readonly activationId: NodeActivationId;
+  readonly parent?: ParentExecutionRef;
+  readonly data: RunDataSnapshot;
+}
+/**
+ * Arguments for optional per-item input mapping applied by the engine before Zod validation.
+ */
+interface ItemInputMapperArgs<TWireJson$1 = unknown> {
+  readonly item: Item<TWireJson$1>;
+  readonly itemIndex: number;
+  readonly items: Items<TWireJson$1>;
+  readonly ctx: ItemInputMapperContext;
+}
+/**
+ * Per-item mapper before Zod validation. Uses a **bivariant** method signature so concrete
+ * `ItemInputMapper<SpecificWire, TIn>` remains assignable to `RunnableNodeConfig` fields typed as
+ * `ItemInputMapper<unknown, unknown>` (same pattern as React-style callbacks).
+ */
+type ItemInputMapper<TWireJson$1 = unknown, TInputJson$1 = unknown> = {
+  bivarianceHack(args: ItemInputMapperArgs<TWireJson$1>): TInputJson$1 | Promise<TInputJson$1>;
+}["bivarianceHack"];
+/**
+ * Runnable node: **`TInputJson`** is the payload after `mapInput` (if any) + Zod validation — what {@link ItemNode}
+ * `executeOne` receives. **`TOutputJson`** is emitted `item.json` on outputs. **`TWireJson`** is `item.json` from
+ * upstream **before** `mapInput`; it defaults to **`TInputJson`** when there is no mapper or wire differs from execute input.
+ */
+interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown, TWireJson$1 = TInputJson$1> extends NodeConfigBase {
   readonly kind: "node";
   readonly [runnableNodeInputType]?: TInputJson$1;
   readonly [runnableNodeOutputType]?: TOutputJson$1;
+  readonly [runnableNodeWireType]?: TWireJson$1;
+  /**
+   * Optional Zod input contract for {@link ItemNode} when not set on the node class.
+   * Resolution order: node instance `inputSchema`, then config `inputSchema`, then `z.unknown()`.
+   */
+  readonly inputSchema?: ZodType<TInputJson$1>;
+  /**
+   * Optional per-item mapper: engine applies it before validating against the node’s `inputSchema`.
+   * When omitted, the engine validates `item.json` directly.
+   */
+  readonly mapInput?: ItemInputMapper<TWireJson$1, TInputJson$1>;
 }
 declare const triggerNodeSetupStateType: unique symbol;
 interface TriggerNodeConfig<TOutputJson$1 = unknown, TSetupState$1 extends JsonValue | undefined = undefined> extends NodeConfigBase {
@@ -384,8 +451,8 @@ interface TriggerNodeConfig<TOutputJson$1 = unknown, TSetupState$1 extends JsonV
   readonly [triggerNodeOutputType]?: TOutputJson$1;
   readonly [triggerNodeSetupStateType]?: TSetupState$1;
 }
-type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any>> = TConfig extends RunnableNodeConfig<infer TInputJson, any> ? TInputJson : never;
-type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any>> = TConfig extends RunnableNodeConfig<any, infer TOutputJson> ? TOutputJson : never;
+type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any, any>> = TConfig extends RunnableNodeConfig<infer TInputJson, any, any> ? TInputJson : never;
+type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any, any>> = TConfig extends RunnableNodeConfig<any, infer TOutputJson, any> ? TOutputJson : never;
 type TriggerNodeOutputJson<TConfig extends TriggerNodeConfig<any, any>> = TConfig extends TriggerNodeConfig<infer TOutputJson, any> ? TOutputJson : never;
 type TriggerNodeSetupState<TConfig extends TriggerNodeConfig<any, any>> = TConfig extends TriggerNodeConfig<any, infer TSetupState> ? TSetupState : never;
 interface NodeDefinition {
@@ -637,7 +704,7 @@ interface DefinedNode<TKey$1 extends string, TConfig extends CredentialJsonRecor
 }
 //#endregion
 //#region ../core/src/ai/NodeBackedToolConfig.d.ts
-declare class NodeBackedToolConfig<TNodeConfig extends RunnableNodeConfig<any, any>, TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny> implements ToolConfig {
+declare class NodeBackedToolConfig<TNodeConfig extends RunnableNodeConfig<any, any, any>, TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny> implements ToolConfig {
   readonly name: string;
   readonly node: TNodeConfig;
   readonly type: TypeToken<unknown>;
@@ -736,7 +803,7 @@ interface ChatModelFactory<TConfig extends ChatModelConfig = ChatModelConfig> {
     ctx: NodeExecutionContext<any>;
   }>): Promise<LangChainChatModelLike> | LangChainChatModelLike;
 }
-type NodeBackedToolInputMapperArgs<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown> = Readonly<{
+type NodeBackedToolInputMapperArgs<TNodeConfig extends RunnableNodeConfig<any, any, any>, TToolInput = unknown> = Readonly<{
   input: TToolInput;
   item: Item;
   itemIndex: number;
@@ -744,7 +811,7 @@ type NodeBackedToolInputMapperArgs<TNodeConfig extends RunnableNodeConfig<any, a
   ctx: NodeExecutionContext<any>;
   node: TNodeConfig;
 }>;
-type NodeBackedToolOutputMapperArgs<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown> = Readonly<{
+type NodeBackedToolOutputMapperArgs<TNodeConfig extends RunnableNodeConfig<any, any, any>, TToolInput = unknown> = Readonly<{
   input: TToolInput;
   item: Item;
   itemIndex: number;
@@ -753,9 +820,9 @@ type NodeBackedToolOutputMapperArgs<TNodeConfig extends RunnableNodeConfig<any,
   node: TNodeConfig;
   outputs: NodeOutputs;
 }>;
-type NodeBackedToolInputMapper<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown> = (args: NodeBackedToolInputMapperArgs<TNodeConfig, TToolInput>) => Item<RunnableNodeInputJson<TNodeConfig>> | RunnableNodeInputJson<TNodeConfig>;
-type NodeBackedToolOutputMapper<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown, TToolOutput = unknown> = (args: NodeBackedToolOutputMapperArgs<TNodeConfig, TToolInput>) => TToolOutput;
-type NodeBackedToolConfigOptions<TNodeConfig extends RunnableNodeConfig<any, any>, TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny> = Readonly<{
+type NodeBackedToolInputMapper<TNodeConfig extends RunnableNodeConfig<any, any, any>, TToolInput = unknown> = (args: NodeBackedToolInputMapperArgs<TNodeConfig, TToolInput>) => Item<RunnableNodeInputJson<TNodeConfig>> | RunnableNodeInputJson<TNodeConfig>;
+type NodeBackedToolOutputMapper<TNodeConfig extends RunnableNodeConfig<any, any, any>, TToolInput = unknown, TToolOutput = unknown> = (args: NodeBackedToolOutputMapperArgs<TNodeConfig, TToolInput>) => TToolOutput;
+type NodeBackedToolConfigOptions<TNodeConfig extends RunnableNodeConfig<any, any, any>, TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny> = Readonly<{
   description?: string;
   presentation?: AgentCanvasPresentation;
   inputSchema: TInputSchema;
@@ -763,7 +830,7 @@ type NodeBackedToolConfigOptions<TNodeConfig extends RunnableNodeConfig<any, any
   mapInput?: NodeBackedToolInputMapper<TNodeConfig, input<TInputSchema>>;
   mapOutput?: NodeBackedToolOutputMapper<TNodeConfig, input<TInputSchema>, output<TOutputSchema>>;
 }>;
-interface AgentNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> extends RunnableNodeConfig<TInputJson$1, TOutputJson$1> {
+interface AgentNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown, TWireJson$1 = TInputJson$1> extends RunnableNodeConfig<TInputJson$1, TOutputJson$1, TWireJson$1> {
   readonly messages: AgentMessageConfig<TInputJson$1>;
   readonly chatModel: ChatModelConfig;
   readonly tools?: ReadonlyArray<ToolConfig>;
@@ -841,7 +908,7 @@ declare class AgentToolCallPortMap {
 }
 //#endregion
 //#region src/nodes/AIAgentConfig.d.ts
-interface AIAgentOptions<TInputJson$1 = unknown, _TOutputJson = unknown> {
+interface AIAgentOptions<TInputJson$1 = unknown, _TOutputJson = unknown, TWireJson$1 = TInputJson$1> {
   readonly name: string;
   readonly messages: AgentMessageConfig<TInputJson$1>;
   readonly chatModel: ChatModelConfig;
@@ -849,12 +916,16 @@ interface AIAgentOptions<TInputJson$1 = unknown, _TOutputJson = unknown> {
   readonly id?: string;
   readonly retryPolicy?: RetryPolicySpec;
   readonly guardrails?: AgentGuardrailConfig;
+  /** Engine applies with {@link RunnableNodeConfig.inputSchema} before {@link AIAgentNode.executeOne}. */
+  readonly inputSchema?: ZodType<TInputJson$1>;
+  /** Per-item mapper before validation; use with {@link inputSchema} so persisted run inputs show the prompt payload. */
+  readonly mapInput?: ItemInputMapper<TWireJson$1, TInputJson$1>;
 }
 /**
  * AI agent: credential bindings are keyed to connection-owned LLM/tool node ids (ConnectionNodeIdFactory),
  * not to the agent workflow node id.
  */
-declare class AIAgent<TInputJson$1 = unknown, TOutputJson$1 = unknown> implements RunnableNodeConfig<TInputJson$1, TOutputJson$1>, AgentNodeConfig<TInputJson$1, TOutputJson$1> {
+declare class AIAgent<TInputJson$1 = unknown, TOutputJson$1 = unknown, TWireJson$1 = TInputJson$1> implements RunnableNodeConfig<TInputJson$1, TOutputJson$1, TWireJson$1>, AgentNodeConfig<TInputJson$1, TOutputJson$1, TWireJson$1> {
   readonly kind: "node";
   readonly type: TypeToken<unknown>;
   readonly execution: {
@@ -868,7 +939,9 @@ declare class AIAgent<TInputJson$1 = unknown, TOutputJson$1 = unknown> implement
   readonly id?: string;
   readonly retryPolicy: RetryPolicySpec;
   readonly guardrails?: AgentGuardrailConfig;
-  constructor(options: AIAgentOptions<TInputJson$1, TOutputJson$1>);
+  readonly inputSchema?: ZodType<TInputJson$1>;
+  readonly mapInput?: ItemInputMapper<TWireJson$1, TInputJson$1>;
+  constructor(options: AIAgentOptions<TInputJson$1, TOutputJson$1, TWireJson$1>);
 }
 //#endregion
 //#region src/nodes/ConnectionCredentialExecutionContextFactory.d.ts
@@ -949,17 +1022,31 @@ declare class NodeBackedToolRuntime {
 }
 //#endregion
 //#region src/nodes/AIAgentNode.d.ts
-declare class AIAgentNode implements Node<AIAgent<any, any>> {
+declare class AIAgentNode implements ItemNode<AIAgent<any, any>, unknown, unknown> {
   private readonly nodeResolver;
   private readonly nodeBackedToolRuntime;
   private readonly executionHelpers;
   kind: "node";
   outputPorts: readonly ["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.
+   */
+  readonly inputSchema: z.ZodUnknown;
   private readonly connectionCredentialExecutionContextFactory;
+  /** One resolved model/tools bundle per activation context (same ctx across items in a batch). */
+  private readonly preparedByExecutionContext;
   constructor(nodeResolver: NodeResolver, credentialSessions: CredentialSessionService, nodeBackedToolRuntime: NodeBackedToolRuntime, executionHelpers: AIAgentExecutionHelpersFactory);
-  execute(items: Items, ctx: NodeExecutionContext<AIAgent<any, any>>): Promise<NodeOutputs>;
+  executeOne(args: {
+    input: unknown;
+    item: Item;
+    itemIndex: number;
+    items: Items;
+    ctx: NodeExecutionContext<AIAgent<any, any>>;
+  }): Promise<unknown>;
+  private getOrPrepareExecution;
   /**
-   * Resolves the chat model and tools once, then returns shared state for every item in the batch.
+   * Resolves the chat model and tools once per activation, then reuses for every item in the batch.
    */
   private prepareExecution;
   /**
@@ -1084,6 +1171,48 @@ declare class HttpRequest<TInputJson$1 = Readonly<{
   get downloadMode(): HttpRequestDownloadMode;
 }
 //#endregion
+//#region src/nodes/AggregateNode.d.ts
+declare class AggregateNode implements Node<Aggregate<any, any>> {
+  kind: "node";
+  outputPorts: readonly ["main"];
+  execute(items: Items, ctx: NodeExecutionContext<Aggregate<any, any>>): Promise<NodeOutputs>;
+}
+//#endregion
+//#region src/nodes/aggregate.d.ts
+declare class Aggregate<TIn = unknown, TOut = unknown> implements RunnableNodeConfig<TIn, TOut> {
+  readonly name: string;
+  readonly aggregate: (items: Items<TIn>, ctx: NodeExecutionContext<Aggregate<TIn, TOut>>) => TOut | Promise<TOut>;
+  readonly id?: string | undefined;
+  readonly kind: "node";
+  readonly type: TypeToken<unknown>;
+  readonly execution: {
+    readonly hint: "local";
+  };
+  readonly icon: "lucide:layers";
+  constructor(name: string, aggregate: (items: Items<TIn>, ctx: NodeExecutionContext<Aggregate<TIn, TOut>>) => TOut | Promise<TOut>, id?: string | undefined);
+}
+//#endregion
+//#region src/nodes/FilterNode.d.ts
+declare class FilterNode implements Node<Filter<any>> {
+  kind: "node";
+  outputPorts: readonly ["main"];
+  execute(items: Items, ctx: NodeExecutionContext<Filter<any>>): Promise<NodeOutputs>;
+}
+//#endregion
+//#region src/nodes/filter.d.ts
+declare class Filter<TIn = unknown> implements RunnableNodeConfig<TIn, TIn> {
+  readonly name: string;
+  readonly predicate: (item: Item<TIn>, index: number, items: Items<TIn>, ctx: NodeExecutionContext<Filter<TIn>>) => boolean;
+  readonly id?: string | undefined;
+  readonly kind: "node";
+  readonly type: TypeToken<unknown>;
+  readonly execution: {
+    readonly hint: "local";
+  };
+  readonly icon: "lucide:filter";
+  constructor(name: string, predicate: (item: Item<TIn>, index: number, items: Items<TIn>, ctx: NodeExecutionContext<Filter<TIn>>) => boolean, id?: string | undefined);
+}
+//#endregion
 //#region src/nodes/IfNode.d.ts
 declare class IfNode implements Node<If<any>> {
   kind: "node";
@@ -1105,6 +1234,32 @@ declare class If<TInputJson$1 = unknown> implements RunnableNodeConfig<TInputJso
   constructor(name: string, predicate: (item: Item<TInputJson$1>, index: number, items: Items<TInputJson$1>, ctx: NodeExecutionContext<If<TInputJson$1>>) => boolean, id?: string | undefined);
 }
 //#endregion
+//#region src/nodes/SplitNode.d.ts
+declare class SplitNode implements Node<Split<any, any>> {
+  kind: "node";
+  outputPorts: readonly ["main"];
+  execute(items: Items, ctx: NodeExecutionContext<Split<any, any>>): Promise<NodeOutputs>;
+}
+//#endregion
+//#region src/nodes/split.d.ts
+declare class Split<TIn = unknown, TElem = unknown> implements RunnableNodeConfig<TIn, TElem> {
+  readonly name: string;
+  readonly getElements: (item: Item<TIn>, ctx: NodeExecutionContext<Split<TIn, TElem>>) => readonly TElem[];
+  readonly id?: string | undefined;
+  readonly kind: "node";
+  readonly type: TypeToken<unknown>;
+  readonly execution: {
+    readonly hint: "local";
+  };
+  /**
+   * 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.
+   */
+  readonly continueWhenEmptyOutput: true;
+  readonly icon: "lucide:ungroup";
+  constructor(name: string, getElements: (item: Item<TIn>, ctx: NodeExecutionContext<Split<TIn, TElem>>) => readonly TElem[], id?: string | undefined);
+}
+//#endregion
 //#region src/nodes/ManualTriggerNode.d.ts
 /**
  * Setup is intentionally a no-op: the engine host can run workflows manually
@@ -1138,10 +1293,17 @@ declare class ManualTrigger<TOutputJson$1 = unknown> implements TriggerNodeConfi
 }
 //#endregion
 //#region src/nodes/MapDataNode.d.ts
-declare class MapDataNode implements Node<MapData<any, any>> {
+declare class MapDataNode implements ItemNode<MapData<any, any>, unknown, unknown> {
   kind: "node";
   outputPorts: readonly ["main"];
-  execute(items: Items, ctx: NodeExecutionContext<MapData<any, any>>): Promise<NodeOutputs>;
+  readonly inputSchema: z.ZodUnknown;
+  executeOne(args: {
+    input: unknown;
+    item: Item;
+    itemIndex: number;
+    items: Items;
+    ctx: NodeExecutionContext<MapData<any, any>>;
+  }): Promise<unknown>;
 }
 //#endregion
 //#region src/nodes/mapData.d.ts
@@ -1346,7 +1508,7 @@ interface WorkflowAgentOptions<TCurrentJson, TOutputSchema extends z.ZodTypeAny
 declare class WorkflowBranchBuilder<TCurrentJson> {
   private readonly steps;
   constructor(steps?: ReadonlyArray<AnyRunnableNodeConfig>);
-  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(config: TConfig): WorkflowBranchBuilder<RunnableNodeOutputJson<TConfig>>;
+  then<TInputJson$1, TOutputJson$1, TConfig extends RunnableNodeConfig<TInputJson$1, TOutputJson$1, TCurrentJson>>(config: TConfig): WorkflowBranchBuilder<RunnableNodeOutputJson<TConfig>>;
   map<TNextJson$1>(mapper: (item: TCurrentJson) => TNextJson$1): WorkflowBranchBuilder<TNextJson$1>;
   map<TNextJson$1>(name: string, mapper: (item: TCurrentJson) => TNextJson$1, id?: string): WorkflowBranchBuilder<TNextJson$1>;
   wait(duration: number | string): WorkflowBranchBuilder<TCurrentJson>;
@@ -1363,7 +1525,7 @@ type BranchCallback<TCurrentJson, TNextJson$1> = (branch: WorkflowBranchBuilder<
 declare class WorkflowChain<TCurrentJson> {
   private readonly chain;
   constructor(chain: ChainCursor<TCurrentJson>);
-  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(config: TConfig): WorkflowChain<RunnableNodeOutputJson<TConfig>>;
+  then<TInputJson$1, TOutputJson$1, TConfig extends RunnableNodeConfig<TInputJson$1, TOutputJson$1, TCurrentJson>>(config: TConfig): WorkflowChain<RunnableNodeOutputJson<TConfig>>;
   map<TNextJson$1>(mapper: (item: TCurrentJson) => TNextJson$1): WorkflowChain<TNextJson$1>;
   map<TNextJson$1>(name: string, mapper: (item: TCurrentJson) => TNextJson$1, id?: string): WorkflowChain<TNextJson$1>;
   wait(duration: number | string): WorkflowChain<TCurrentJson>;
@@ -1440,5 +1602,5 @@ declare class AIAgentConnectionWorkflowExpander {
   private assertNoIdCollision;
 }
 //#endregion
-export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentToolCallPortMap, Callback, CallbackHandler, CallbackNode, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, ExecutedToolCall, HttpRequest, HttpRequestDownloadMode, HttpRequestNode, HttpRequestOutputJson, If, IfNode, ItemScopedToolBinding, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeMode, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, OpenAiCredentialSession, PlannedToolCall, ResolvedTool, SubWorkflow, SubWorkflowNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
+export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentToolCallPortMap, Aggregate, AggregateNode, Callback, CallbackHandler, CallbackNode, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, ExecutedToolCall, Filter, FilterNode, HttpRequest, HttpRequestDownloadMode, HttpRequestNode, HttpRequestOutputJson, If, IfNode, ItemScopedToolBinding, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeMode, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, OpenAiCredentialSession, PlannedToolCall, ResolvedTool, Split, SplitNode, SubWorkflow, SubWorkflowNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
 //# sourceMappingURL=index.d.cts.map