@codemation/core-nodes 0.1.1 → 0.3.0

package/dist/index.d.ts

@@ -311,8 +311,10 @@ interface TriggerCleanupHandle {
   stop(): Promise<void> | void;
 }
 /**
- * Per-item runnable node: return JSON, an array to fan-out on `main`, or {@link emitPorts} for multi-port emission.
- * Engine applies `inputSchema.parse(item.json)` and passes the result as `args.input` (wire `item.json` is unchanged).
+ * Per-item runnable node: return JSON, an array to fan-out on `main`, an explicit `Item`, or {@link emitPorts}
+ * for multi-port emission. Engine applies `inputSchema.parse(item.json)` and passes the result as `args.input`
+ * (wire `item.json` is unchanged). Transform helpers may opt into binary preservation, while routers and
+ * pass-through nodes should return explicit items when they need to preserve full item state.
  */
 interface RunnableNodeExecuteArgs<TConfig extends RunnableNodeConfig<any, any> = RunnableNodeConfig<any, any>, TInputJson$1 = unknown> {
   readonly input: TInputJson$1;
@@ -442,7 +444,6 @@ interface NodeConfigBase {
 declare const runnableNodeInputType: unique symbol;
 declare const runnableNodeOutputType: unique symbol;
 declare const triggerNodeOutputType: unique symbol;
-type LineageCarryPolicy = "emitOnly" | "carryThrough";
 /**
  * Runnable node: **`TInputJson`** is what **`inputSchema`** validates on **`item.json`** (the wire payload).
  * **`TOutputJson`** is emitted `item.json` on outputs.
@@ -456,11 +457,6 @@ interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> ex
    * Resolution order: node instance `inputSchema`, then config `inputSchema`, then `z.unknown()`.
    */
   readonly inputSchema?: ZodType<TInputJson$1>;
-  /**
-   * Overrides default lineage propagation for `execute` outputs (binary/meta/paired).
-   * Routers with multiple {@link RunnableNode#outputPorts} default to **`carryThrough`**; others default to **`emitOnly`**.
-   */
-  readonly lineageCarry?: LineageCarryPolicy;
   /**
    * When an activation receives **zero** input items, the engine normally runs `execute` zero times.
    * Set to **`runOnce`** to run `execute` once with an empty `items` batch (and a synthetic wire item for schema parsing).
@@ -594,6 +590,12 @@ type CredentialFieldSchema = Readonly<{
   type: "string" | "password" | "textarea" | "json" | "boolean";
   required?: true;
   order?: number;
+  /**
+   * Where this field appears in the credential dialog. Use `"advanced"` for optional or
+   * power-user fields; they render inside a collapsible section (see `CredentialTypeDefinition.advancedSection`).
+   * Defaults to `"default"` when omitted.
+   */
+  visibility?: "default" | "advanced";
   placeholder?: string;
   helpText?: string;
   /** When set, host resolves this field from process.env at runtime; env wins over stored values. */
@@ -648,12 +650,25 @@ type CredentialOAuth2AuthDefinition = Readonly<{
   clientSecretFieldKey?: string;
 }>;
 type CredentialAuthDefinition = CredentialOAuth2AuthDefinition;
+type CredentialAdvancedSectionPresentation = Readonly<{
+  /** Collapsible section title (default: "Advanced"). */
+  title?: string;
+  /** Optional short helper text shown inside the section (above the fields). */
+  description?: string;
+  /** When true, the advanced section starts expanded. Default: false (collapsed). */
+  defaultOpen?: boolean;
+}>;
 type CredentialTypeDefinition = Readonly<{
   typeId: CredentialTypeId;
   displayName: string;
   description?: string;
   publicFields?: ReadonlyArray<CredentialFieldSchema>;
   secretFields?: ReadonlyArray<CredentialFieldSchema>;
+  /**
+   * Optional labels for the collapsible block that contains every field with `visibility: "advanced"`.
+   * If omitted, the UI still shows that block with defaults (title "Advanced", collapsed).
+   */
+  advancedSection?: CredentialAdvancedSectionPresentation;
   supportedSourceKinds?: ReadonlyArray<CredentialMaterialSourceKind>;
   auth?: CredentialAuthDefinition;
 }>;
@@ -827,6 +842,16 @@ interface ChatModelConfig {
 interface LangChainChatModelLike {
   invoke(input: unknown, options?: unknown): Promise<unknown>;
   bindTools?(tools: ReadonlyArray<unknown>): LangChainChatModelLike;
+  withStructuredOutput?(outputSchema: ZodSchemaAny, config?: ChatModelStructuredOutputOptions): LangChainStructuredOutputModelLike;
+}
+interface LangChainStructuredOutputModelLike {
+  invoke(input: unknown, options?: unknown): Promise<unknown>;
+}
+interface ChatModelStructuredOutputOptions {
+  readonly method?: "jsonSchema" | "functionCalling" | "jsonMode";
+  readonly strict?: boolean;
+  readonly includeRaw?: boolean;
+  readonly tools?: ReadonlyArray<unknown>;
 }
 interface ChatModelFactory<TConfig extends ChatModelConfig = ChatModelConfig> {
   create(args: Readonly<{
@@ -866,6 +891,7 @@ interface AgentNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> exten
   readonly chatModel: ChatModelConfig;
   readonly tools?: ReadonlyArray<ToolConfig>;
   readonly guardrails?: AgentGuardrailConfig;
+  readonly outputSchema?: ZodType<TOutputJson$1>;
 }
 //#endregion
 //#region ../core/src/execution/ItemValueResolver.d.ts
@@ -876,18 +902,27 @@ declare class ItemValueResolver {
   resolveConfigForItem<TConfig extends RunnableNodeConfig<any, any>>(ctx: NodeExecutionContext<TConfig>, item: Item, itemIndex: number, items: ReadonlyArray<Item>): Promise<NodeExecutionContext<TConfig>>;
 }
 //#endregion
+//#region ../core/src/execution/RunnableOutputBehaviorResolver.d.ts
+type RunnableOutputBehavior = Readonly<{
+  keepBinaries: boolean;
+}>;
+declare class RunnableOutputBehaviorResolver {
+  resolve(config: RunnableNodeConfig): RunnableOutputBehavior;
+  private isKeepBinariesEnabled;
+}
+//#endregion
 //#region ../core/src/execution/NodeOutputNormalizer.d.ts
 declare class NodeOutputNormalizer {
   normalizeExecuteResult(args: Readonly<{
     baseItem: Item;
     raw: unknown;
-    carry: LineageCarryPolicy;
+    behavior: RunnableOutputBehavior;
   }>): NodeOutputs;
   private arrayFanOutToMain;
   private emitPortsToOutputs;
   private normalizePortPayload;
   private isItemLike;
-  private applyLineage;
+  private applyOutput;
 }
 //#endregion
 //#region src/chatModels/openAiChatModelConfig.d.ts
@@ -916,6 +951,15 @@ declare class OpenAIChatModelFactory implements ChatModelFactory<OpenAIChatModel
   }>): Promise<LangChainChatModelLike>;
 }
 //#endregion
+//#region src/chatModels/OpenAIStructuredOutputMethodFactory.d.ts
+declare class OpenAIStructuredOutputMethodFactory {
+  private static readonly isoDatePattern;
+  create(chatModelConfig: ChatModelConfig): ChatModelStructuredOutputOptions | undefined;
+  private readModelName;
+  private supportsJsonSchema;
+  private supportsSnapshotAtOrAfter;
+}
+//#endregion
 //#region src/chatModels/OpenAiCredentialSession.d.ts
 /** Resolved credential session for OpenAI-compatible chat models (API key + optional custom base URL). */
 type OpenAiCredentialSession = Readonly<{
@@ -955,45 +999,6 @@ declare class AgentOutputFactory {
   static fromAgentContent(content: string): unknown;
 }
 //#endregion
-//#region src/nodes/AgentToolCallPortMapFactory.d.ts
-declare class AgentToolCallPortMap {
-  static fromInput(input: unknown): NodeInputsByPort;
-}
-//#endregion
-//#region src/nodes/AIAgentConfig.d.ts
-interface AIAgentOptions<TInputJson$1 = unknown, _TOutputJson = unknown> {
-  readonly name: string;
-  readonly messages: AgentMessageConfig<TInputJson$1>;
-  readonly chatModel: ChatModelConfig;
-  readonly tools?: ReadonlyArray<ToolConfig>;
-  readonly id?: string;
-  readonly retryPolicy?: RetryPolicySpec;
-  readonly guardrails?: AgentGuardrailConfig;
-  /** Engine applies with {@link RunnableNodeConfig.inputSchema} before {@link AIAgentNode.execute}. */
-  readonly inputSchema?: ZodType<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> {
-  readonly kind: "node";
-  readonly type: TypeToken<unknown>;
-  readonly execution: {
-    readonly hint: "local";
-  };
-  readonly icon: "lucide:bot";
-  readonly name: string;
-  readonly messages: AgentMessageConfig<TInputJson$1>;
-  readonly chatModel: ChatModelConfig;
-  readonly tools: ReadonlyArray<ToolConfig>;
-  readonly id?: string;
-  readonly retryPolicy: RetryPolicySpec;
-  readonly guardrails?: AgentGuardrailConfig;
-  readonly inputSchema?: ZodType<TInputJson$1>;
-  constructor(options: AIAgentOptions<TInputJson$1, TOutputJson$1>);
-}
-//#endregion
 //#region src/nodes/ConnectionCredentialExecutionContextFactory.d.ts
 /**
  * Builds a {@link NodeExecutionContext} whose identity for credential binding and `getCredential`
@@ -1054,19 +1059,106 @@ declare class AIAgentExecutionHelpersFactory {
    *   (duplicate `zod` copies), fall back to Zod `toJSONSchema` with draft-07.
    * - Strip root `$schema` for OpenAI; normalize invalid `required` keywords for cfworker; ensure `properties`.
    */
-  private normalizeToolInputSchemaForOpenAiDynamicStructuredTool;
+  createJsonSchemaRecord(inputSchema: ZodSchemaAny, options: Readonly<{
+    schemaName: string;
+    requireObjectRoot: boolean;
+  }>): Record<string, unknown>;
   /**
    * `@cfworker/json-schema` iterates `schema.required` with `for...of`; it must be a string array or absent.
    */
   private sanitizeJsonSchemaRequiredKeywordsForCfworker;
 }
 //#endregion
+//#region src/nodes/AgentStructuredOutputRepairPromptFactory.d.ts
+declare class AgentStructuredOutputRepairPromptFactory {
+  private readonly executionHelpers;
+  private static readonly maxSchemaLength;
+  private static readonly maxInvalidContentLength;
+  private static readonly maxValidationErrorLength;
+  constructor(executionHelpers: AIAgentExecutionHelpersFactory);
+  create(args: Readonly<{
+    schema: ZodSchemaAny;
+    invalidContent: string;
+    validationError: string;
+  }>): ReadonlyArray<AgentMessageDto>;
+  private truncate;
+}
+//#endregion
+//#region src/nodes/AgentStructuredOutputRunner.d.ts
+declare class AgentStructuredOutputRunner {
+  private readonly repairPromptFactory;
+  private readonly openAiStructuredOutputMethodFactory;
+  private static readonly repairAttemptCount;
+  constructor(repairPromptFactory: AgentStructuredOutputRepairPromptFactory, openAiStructuredOutputMethodFactory: OpenAIStructuredOutputMethodFactory);
+  resolve<TOutput>(args: Readonly<{
+    model: LangChainChatModelLike;
+    chatModelConfig: ChatModelConfig;
+    schema: ZodSchemaAny;
+    conversation: ReadonlyArray<BaseMessage>;
+    rawFinalResponse?: AIMessage;
+    agentName: string;
+    nodeId: string;
+    invokeTextModel: (messages: ReadonlyArray<BaseMessage>) => Promise<AIMessage>;
+    invokeStructuredModel: (model: LangChainStructuredOutputModelLike, messages: ReadonlyArray<BaseMessage>) => Promise<unknown>;
+  }>): Promise<TOutput>;
+  private retryWithRepairPrompt;
+  private createStructuredOutputModel;
+  private getStructuredOutputOptions;
+  private supportsNativeStructuredOutput;
+  private tryParseAndValidate;
+  private tryValidateStructuredValue;
+  private summarizeError;
+  private toJson;
+}
+//#endregion
+//#region src/nodes/AgentToolCallPortMapFactory.d.ts
+declare class AgentToolCallPortMap {
+  static fromInput(input: unknown): NodeInputsByPort;
+}
+//#endregion
+//#region src/nodes/AIAgentConfig.d.ts
+interface AIAgentOptions<TInputJson$1 = unknown, _TOutputJson = unknown> {
+  readonly name: string;
+  readonly messages: AgentMessageConfig<TInputJson$1>;
+  readonly chatModel: ChatModelConfig;
+  readonly tools?: ReadonlyArray<ToolConfig>;
+  readonly id?: string;
+  readonly retryPolicy?: RetryPolicySpec;
+  readonly guardrails?: AgentGuardrailConfig;
+  /** Engine applies with {@link RunnableNodeConfig.inputSchema} before {@link AIAgentNode.execute}. */
+  readonly inputSchema?: ZodType<TInputJson$1>;
+  readonly outputSchema?: ZodType<_TOutputJson>;
+}
+/**
+ * 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> {
+  readonly kind: "node";
+  readonly type: TypeToken<unknown>;
+  readonly execution: {
+    readonly hint: "local";
+  };
+  readonly icon: "lucide:bot";
+  readonly name: string;
+  readonly messages: AgentMessageConfig<TInputJson$1>;
+  readonly chatModel: ChatModelConfig;
+  readonly tools: ReadonlyArray<ToolConfig>;
+  readonly id?: string;
+  readonly retryPolicy: RetryPolicySpec;
+  readonly guardrails?: AgentGuardrailConfig;
+  readonly inputSchema?: ZodType<TInputJson$1>;
+  readonly outputSchema?: ZodType<TOutputJson$1>;
+  constructor(options: AIAgentOptions<TInputJson$1, TOutputJson$1>);
+}
+//#endregion
 //#region src/nodes/NodeBackedToolRuntime.d.ts
 declare class NodeBackedToolRuntime {
   private readonly nodeResolver;
   private readonly itemValueResolver;
   private readonly outputNormalizer;
-  constructor(nodeResolver: NodeResolver, itemValueResolver: ItemValueResolver, outputNormalizer: NodeOutputNormalizer);
+  private readonly outputBehaviorResolver;
+  constructor(nodeResolver: NodeResolver, itemValueResolver: ItemValueResolver, outputNormalizer: NodeOutputNormalizer, outputBehaviorResolver: RunnableOutputBehaviorResolver);
   execute(config: NodeBackedToolConfig<any, ZodSchemaAny, ZodSchemaAny>, args: ToolExecuteArgs): Promise<unknown>;
   private executeResolvedNode;
   private isRunnableNode;
@@ -1078,6 +1170,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private readonly nodeResolver;
   private readonly nodeBackedToolRuntime;
   private readonly executionHelpers;
+  private readonly structuredOutputRunner;
   kind: "node";
   outputPorts: readonly ["main"];
   /**
@@ -1089,7 +1182,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   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);
+  constructor(nodeResolver: NodeResolver, credentialSessions: CredentialSessionService, nodeBackedToolRuntime: NodeBackedToolRuntime, executionHelpers: AIAgentExecutionHelpersFactory, structuredOutputRunner: AgentStructuredOutputRunner);
   execute(args: RunnableNodeExecuteArgs<AIAgent<any, any>>): Promise<unknown>;
   private getOrPrepareExecution;
   /**
@@ -1107,11 +1200,13 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private cannotExecuteAnotherToolRound;
   private finishOrThrowWhenTurnCapHitWithToolCalls;
   private appendAssistantAndToolMessages;
+  private resolveFinalOutputJson;
   private buildOutputItem;
   private bindToolsToModel;
   private resolveTools;
   private createItemScopedTools;
   private invokeModel;
+  private invokeStructuredModel;
   private markQueuedTools;
   private executeToolCalls;
   private planToolCalls;
@@ -1128,7 +1223,12 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
    * json-schema validation). {@link NodeBackedToolConfig#toolKind} is stable across copies.
    */
   private isNodeBackedToolConfig;
+  /**
+   * Callable tools use {@link CallableToolConfig#toolKind} for cross-package / JSON round-trip safety.
+   */
+  private isCallableToolConfig;
   private resolveGuardrails;
+  private getAgentDisplayName;
 }
 //#endregion
 //#region src/nodes/CallbackNode.d.ts
@@ -1316,7 +1416,6 @@ declare class Switch<TInputJson$1 = unknown> implements RunnableNodeConfig<TInpu
     readonly hint: "local";
   };
   readonly icon: "lucide:git-branch-plus";
-  readonly lineageCarry: "carryThrough";
   readonly declaredOutputPorts: ReadonlyArray<string>;
   constructor(name: string, cfg: Readonly<{
     cases: readonly string[];
@@ -1392,10 +1491,14 @@ declare class MapDataNode implements RunnableNode<MapData<any, any>> {
 }
 //#endregion
 //#region src/nodes/mapData.d.ts
+interface MapDataOptions {
+  readonly id?: string;
+  readonly keepBinaries?: boolean;
+}
 declare class MapData<TInputJson$1 = unknown, TOutputJson$1 = unknown> implements RunnableNodeConfig<TInputJson$1, TOutputJson$1> {
   readonly name: string;
   readonly map: (item: Item<TInputJson$1>, ctx: NodeExecutionContext<MapData<TInputJson$1, TOutputJson$1>>) => TOutputJson$1;
-  readonly id?: string | undefined;
+  private readonly options;
   readonly kind: "node";
   readonly type: TypeToken<unknown>;
   readonly execution: {
@@ -1403,7 +1506,9 @@ declare class MapData<TInputJson$1 = unknown, TOutputJson$1 = unknown> implement
   };
   /** Zero mapped items should still allow downstream nodes to run. */
   readonly continueWhenEmptyOutput: true;
-  constructor(name: string, map: (item: Item<TInputJson$1>, ctx: NodeExecutionContext<MapData<TInputJson$1, TOutputJson$1>>) => TOutputJson$1, id?: string | undefined);
+  readonly keepBinaries: boolean;
+  constructor(name: string, map: (item: Item<TInputJson$1>, ctx: NodeExecutionContext<MapData<TInputJson$1, TOutputJson$1>>) => TOutputJson$1, options?: MapDataOptions);
+  get id(): string | undefined;
 }
 //#endregion
 //#region src/nodes/MergeNode.d.ts
@@ -1578,9 +1683,9 @@ declare function createWorkflowBuilder(meta: Readonly<{
 }>): WorkflowBuilder;
 //#endregion
 //#region src/workflowAuthoring/WorkflowAuthoringOptions.types.d.ts
-type WorkflowAgentPrompt<TCurrentJson> = string | ((item: TCurrentJson) => string);
+type WorkflowAgentMessages<TCurrentJson> = AgentMessageConfig<TCurrentJson>;
 interface WorkflowAgentOptions<TCurrentJson, TOutputSchema extends z.ZodTypeAny | undefined = undefined> {
-  readonly prompt: WorkflowAgentPrompt<TCurrentJson>;
+  readonly messages: WorkflowAgentMessages<TCurrentJson>;
   readonly model: string | ChatModelConfig;
   readonly tools?: ReadonlyArray<ToolConfig>;
   readonly outputSchema?: TOutputSchema;
@@ -1590,12 +1695,13 @@ interface WorkflowAgentOptions<TCurrentJson, TOutputSchema extends z.ZodTypeAny
 }
 //#endregion
 //#region src/workflowAuthoring/WorkflowBranchBuilder.types.d.ts
+type WorkflowMapCallback$1<TCurrentJson, TNextJson$1> = (item: Item<TCurrentJson>, ctx: NodeExecutionContext<MapData<TCurrentJson, TNextJson$1>>) => TNextJson$1;
 declare class WorkflowBranchBuilder<TCurrentJson> {
   private readonly steps;
   constructor(steps?: ReadonlyArray<AnyRunnableNodeConfig>);
   then<TOutputJson$1, TConfig extends RunnableNodeConfig<TCurrentJson, TOutputJson$1>>(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>;
+  map<TNextJson$1>(mapper: WorkflowMapCallback$1<TCurrentJson, TNextJson$1>): WorkflowBranchBuilder<TNextJson$1>;
+  map<TNextJson$1>(name: string, mapper: WorkflowMapCallback$1<TCurrentJson, TNextJson$1>, options?: MapDataOptions): WorkflowBranchBuilder<TNextJson$1>;
   wait(duration: number | string): WorkflowBranchBuilder<TCurrentJson>;
   wait(name: string, duration: number | string, id?: string): WorkflowBranchBuilder<TCurrentJson>;
   split<TElem>(getElements: (item: Item<TCurrentJson>, ctx: NodeExecutionContext<Split<TCurrentJson, TElem>>) => readonly TElem[]): WorkflowBranchBuilder<TElem>;
@@ -1614,12 +1720,15 @@ declare class WorkflowBranchBuilder<TCurrentJson> {
 //#region src/workflowAuthoring/WorkflowChain.types.d.ts
 type BranchCallback<TCurrentJson, TNextJson$1> = (branch: WorkflowBranchBuilder<TCurrentJson>) => WorkflowBranchBuilder<TNextJson$1>;
 type RouteBranchCallback<TCurrentJson, TNextJson$1> = (branch: WorkflowChain<TCurrentJson>) => WorkflowChain<TNextJson$1>;
+type WorkflowMapCallback<TCurrentJson, TNextJson$1> = (item: Item<TCurrentJson>, ctx: NodeExecutionContext<MapData<TCurrentJson, TNextJson$1>>) => TNextJson$1;
+type WorkflowIfPredicate<TCurrentJson> = (item: Item<TCurrentJson>, ctx: NodeExecutionContext<If<TCurrentJson>>) => boolean;
+type WorkflowSwitchCaseKeyResolver<TCurrentJson> = (item: Item<TCurrentJson>, ctx: NodeExecutionContext<Switch<TCurrentJson>>) => string | Promise<string>;
 declare class WorkflowChain<TCurrentJson> {
   private readonly chain;
   constructor(chain: ChainCursor<TCurrentJson>);
   then<TOutputJson$1, TConfig extends RunnableNodeConfig<TCurrentJson, TOutputJson$1>>(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>;
+  map<TNextJson$1>(mapper: WorkflowMapCallback<TCurrentJson, TNextJson$1>): WorkflowChain<TNextJson$1>;
+  map<TNextJson$1>(name: string, mapper: WorkflowMapCallback<TCurrentJson, TNextJson$1>, options?: MapDataOptions): WorkflowChain<TNextJson$1>;
   wait(duration: number | string): WorkflowChain<TCurrentJson>;
   wait(name: string, duration: number | string, id?: string): WorkflowChain<TCurrentJson>;
   split<TElem>(getElements: (item: Item<TCurrentJson>, ctx: NodeExecutionContext<Split<TCurrentJson, TElem>>) => readonly TElem[]): WorkflowChain<TElem>;
@@ -1637,11 +1746,11 @@ declare class WorkflowChain<TCurrentJson> {
     mode: MergeMode;
     prefer?: ReadonlyArray<string>;
   }>, id?: string): WorkflowChain<TCurrentJson>;
-  if<TBranchJson>(predicate: (item: TCurrentJson) => boolean, branches: Readonly<{
+  if<TBranchJson>(predicate: WorkflowIfPredicate<TCurrentJson>, branches: Readonly<{
     true?: BranchCallback<TCurrentJson, TBranchJson>;
     false?: BranchCallback<TCurrentJson, TBranchJson>;
   }>): WorkflowChain<TBranchJson>;
-  if<TBranchJson>(name: string, predicate: (item: TCurrentJson) => boolean, branches: Readonly<{
+  if<TBranchJson>(name: string, predicate: WorkflowIfPredicate<TCurrentJson>, branches: Readonly<{
     true?: BranchCallback<TCurrentJson, TBranchJson>;
     false?: BranchCallback<TCurrentJson, TBranchJson>;
   }>): WorkflowChain<TBranchJson>;
@@ -1649,13 +1758,13 @@ declare class WorkflowChain<TCurrentJson> {
   switch<TBranchJson>(cfg: Readonly<{
     cases: readonly string[];
     defaultCase: string;
-    resolveCaseKey: (item: TCurrentJson) => string | Promise<string>;
+    resolveCaseKey: WorkflowSwitchCaseKeyResolver<TCurrentJson>;
     branches: Readonly<Record<string, RouteBranchCallback<TCurrentJson, TBranchJson> | undefined>>;
   }>): WorkflowChain<TBranchJson>;
   switch<TBranchJson>(name: string, cfg: Readonly<{
     cases: readonly string[];
     defaultCase: string;
-    resolveCaseKey: (item: TCurrentJson) => string | Promise<string>;
+    resolveCaseKey: WorkflowSwitchCaseKeyResolver<TCurrentJson>;
     branches: Readonly<Record<string, RouteBranchCallback<TCurrentJson, TBranchJson> | undefined>>;
   }>, id?: string): WorkflowChain<TBranchJson>;
   agent<TOutputSchema extends z.ZodTypeAny>(options: WorkflowAgentOptions<TCurrentJson, TOutputSchema>): WorkflowChain<z.output<TOutputSchema>>;
@@ -1722,5 +1831,5 @@ declare class AIAgentConnectionWorkflowExpander {
   private assertNoIdCollision;
 }
 //#endregion
-export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentToolCallPortMap, Aggregate, AggregateNode, Callback, CallbackHandler, CallbackNode, CallbackOptions, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, type ExecutedToolCall, Filter, FilterNode, HttpRequest, HttpRequestDownloadMode, HttpRequestNode, HttpRequestOutputJson, If, IfNode, type ItemScopedToolBinding, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeMode, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, OpenAiCredentialSession, type PlannedToolCall, type ResolvedTool, Split, SplitNode, SubWorkflow, SubWorkflowNode, Switch, SwitchCaseKeyResolver, SwitchNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
+export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentStructuredOutputRepairPromptFactory, AgentStructuredOutputRunner, AgentToolCallPortMap, Aggregate, AggregateNode, Callback, CallbackHandler, CallbackNode, CallbackOptions, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, type ExecutedToolCall, Filter, FilterNode, HttpRequest, HttpRequestDownloadMode, HttpRequestNode, HttpRequestOutputJson, If, IfNode, type ItemScopedToolBinding, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, MapDataOptions, Merge, MergeMode, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAIStructuredOutputMethodFactory, OpenAiChatModelPresets, OpenAiCredentialSession, type PlannedToolCall, type ResolvedTool, Split, SplitNode, SubWorkflow, SubWorkflowNode, Switch, SwitchCaseKeyResolver, SwitchNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentMessages, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
 //# sourceMappingURL=index.d.ts.map