@codemation/core-nodes 0.0.15 → 0.0.18

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { AIMessage, BaseMessage, HumanMessage, SystemMessage, ToolMessage } from
 import { DynamicStructuredTool } from "@langchain/core/tools";
 import { ReadableStream } from "node:stream/web";
 import { DependencyContainer as Container, InjectionToken as TypeToken } from "tsyringe";
-import { ZodType, input, output } from "zod";
+import { ZodType, input, output, z } from "zod";
 
 //#region src/canvasIconName.d.ts
 /**
@@ -114,6 +114,68 @@ interface TriggerInstanceId {
   nodeId: NodeId;
 }
 //#endregion
+//#region ../core/src/workflow/dsl/workflowBuilderTypes.d.ts
+type AnyRunnableNodeConfig = RunnableNodeConfig<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 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 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;
+};
+//#endregion
+//#region ../core/src/workflow/dsl/WhenBuilder.d.ts
+declare class WhenBuilder<TCurrentJson> {
+  private readonly wf;
+  private readonly from;
+  private readonly branchPort;
+  constructor(wf: WorkflowBuilder, from: NodeRef, branchPort: OutputPortKey);
+  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>): this;
+  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>>;
+  build(): WorkflowDefinition;
+}
+//#endregion
+//#region ../core/src/workflow/dsl/ChainCursorResolver.d.ts
+type ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {
+  <TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined, TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined>(branches: Readonly<{
+    true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;
+    false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TFalseSteps> : never;
+  }> & BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;
+};
+declare class ChainCursor<TCurrentJson> {
+  private readonly wf;
+  private readonly cursor;
+  private readonly cursorOutput;
+  constructor(wf: WorkflowBuilder, cursor: NodeRef, cursorOutput: OutputPortKey);
+  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>>;
+  readonly when: ChainCursorWhenOverloads<TCurrentJson>;
+  build(): WorkflowDefinition;
+}
+//#endregion
+//#region ../core/src/workflow/dsl/WorkflowBuilder.d.ts
+declare class WorkflowBuilder {
+  private readonly meta;
+  private readonly options?;
+  private readonly nodes;
+  private readonly edges;
+  private seq;
+  constructor(meta: {
+    id: WorkflowId;
+    name: string;
+  }, options?: Readonly<{
+    makeMergeNode?: (name: string) => AnyRunnableNodeConfig;
+  }> | undefined);
+  private add;
+  private connect;
+  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>>;
+  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>>;
+  build(): WorkflowDefinition;
+}
+//#endregion
 //#region ../core/src/contracts/runtimeTypes.d.ts
 interface WorkflowRunnerService {
   runById(args: {
@@ -431,6 +493,28 @@ type NodeErrorHandlerSpec = TypeToken<NodeErrorHandler> | NodeErrorHandler;
 //#endregion
 //#region ../core/src/contracts/credentialTypes.d.ts
 type CredentialTypeId = string;
+type CredentialInstanceId = string;
+type CredentialMaterialSourceKind = "db" | "env" | "code";
+type CredentialSetupStatus = "draft" | "ready";
+type CredentialHealthStatus = "unknown" | "healthy" | "failing";
+type CredentialFieldSchema = Readonly<{
+  key: string;
+  label: string;
+  type: "string" | "password" | "textarea" | "json" | "boolean";
+  required?: true;
+  order?: number;
+  placeholder?: string;
+  helpText?: string;
+  /** When set, host resolves this field from process.env at runtime; env wins over stored values. */
+  envVarName?: string;
+  /**
+   * When set, the dialog shows a copy action for this exact string (e.g. a static OAuth redirect URI
+   * pattern or documentation URL). Do not use for secret values.
+   */
+  copyValue?: string;
+  /** Accessible label for the copy control (default: Copy). */
+  copyButtonLabel?: string;
+}>;
 type CredentialRequirement = Readonly<{
   slotKey: string;
   label: string;
@@ -439,6 +523,89 @@ type CredentialRequirement = Readonly<{
   helpText?: string;
   helpUrl?: string;
 }>;
+type CredentialHealth = Readonly<{
+  status: CredentialHealthStatus;
+  message?: string;
+  testedAt?: string;
+  expiresAt?: string;
+  details?: Readonly<Record<string, unknown>>;
+}>;
+type OAuth2ProviderFromPublicConfig = Readonly<{
+  authorizeUrlFieldKey: string;
+  tokenUrlFieldKey: string;
+  userInfoUrlFieldKey?: string;
+}>;
+type CredentialOAuth2AuthDefinition = Readonly<{
+  kind: "oauth2";
+  providerId: string;
+  scopes: ReadonlyArray<string>;
+  clientIdFieldKey?: string;
+  clientSecretFieldKey?: string;
+} | {
+  kind: "oauth2";
+  providerFromPublicConfig: OAuth2ProviderFromPublicConfig;
+  scopes: ReadonlyArray<string>;
+  clientIdFieldKey?: string;
+  clientSecretFieldKey?: string;
+}>;
+type CredentialAuthDefinition = CredentialOAuth2AuthDefinition;
+type CredentialTypeDefinition = Readonly<{
+  typeId: CredentialTypeId;
+  displayName: string;
+  description?: string;
+  publicFields?: ReadonlyArray<CredentialFieldSchema>;
+  secretFields?: ReadonlyArray<CredentialFieldSchema>;
+  supportedSourceKinds?: ReadonlyArray<CredentialMaterialSourceKind>;
+  auth?: CredentialAuthDefinition;
+}>;
+/**
+ * JSON-shaped credential field bag (public config, resolved secret material, etc.).
+ */
+type CredentialJsonRecord = Readonly<Record<string, unknown>>;
+/**
+ * Persisted credential instance with typed `publicConfig`.
+ * Hosts may specialize `secretRef` with a stricter union while remaining
+ * assignable here for session/test callbacks.
+ */
+type CredentialInstanceRecord<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord> = Readonly<{
+  instanceId: CredentialInstanceId;
+  typeId: CredentialTypeId;
+  displayName: string;
+  sourceKind: CredentialMaterialSourceKind;
+  publicConfig: TPublicConfig;
+  secretRef: CredentialJsonRecord;
+  tags: ReadonlyArray<string>;
+  setupStatus: CredentialSetupStatus;
+  createdAt: string;
+  updatedAt: string;
+}>;
+/**
+ * Arguments passed to `CredentialType.createSession` and `CredentialType.test`.
+ * Declare `TPublicConfig` / `TMaterial` on `CredentialType` so implementations are checked
+ * against your credential shapes (similar to `NodeExecutionContext.config` for nodes).
+ */
+type CredentialSessionFactoryArgs<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord, TMaterial extends CredentialJsonRecord = CredentialJsonRecord> = Readonly<{
+  instance: CredentialInstanceRecord<TPublicConfig>;
+  material: TMaterial;
+  publicConfig: TPublicConfig;
+}>;
+type CredentialSessionFactory<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord, TMaterial extends CredentialJsonRecord = CredentialJsonRecord, TSession = unknown> = (args: CredentialSessionFactoryArgs<TPublicConfig, TMaterial>) => Promise<TSession>;
+type CredentialHealthTester<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord, TMaterial extends CredentialJsonRecord = CredentialJsonRecord> = (args: CredentialSessionFactoryArgs<TPublicConfig, TMaterial>) => Promise<CredentialHealth>;
+/**
+ * Full credential type implementation: `definition` (UI/schema), `createSession`, and `test`.
+ * Use this at registration and config boundaries; `CredentialTypeDefinition` is only the schema slice.
+ */
+type CredentialType<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord, TMaterial extends CredentialJsonRecord = CredentialJsonRecord, TSession = unknown> = Readonly<{
+  definition: CredentialTypeDefinition;
+  createSession: CredentialSessionFactory<TPublicConfig, TMaterial, TSession>;
+  test: CredentialHealthTester<TPublicConfig, TMaterial>;
+}>;
+/**
+ * Credential type with unspecified generics — used for `CodemationConfig.credentialTypes`, the host registry,
+ * and anywhere a concrete `CredentialType<YourPublic, YourMaterial, YourSession>` is placed in a heterogeneous list.
+ * Using `any` here avoids unsafe `as` casts while keeping typed `satisfies CredentialType<…>` definitions.
+ */
+type AnyCredentialType = CredentialType<any, any, unknown>;
 interface CredentialSessionService {
   getSession<TSession = unknown>(args: Readonly<{
     workflowId: WorkflowId;
@@ -447,66 +614,25 @@ interface CredentialSessionService {
   }>): Promise<TSession>;
 }
 //#endregion
-//#region ../core/src/workflow/dsl/workflowBuilderTypes.d.ts
-type AnyRunnableNodeConfig = RunnableNodeConfig<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 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 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;
-};
-//#endregion
-//#region ../core/src/workflow/dsl/WhenBuilder.d.ts
-declare class WhenBuilder<TCurrentJson> {
-  private readonly wf;
-  private readonly from;
-  private readonly branchPort;
-  constructor(wf: WorkflowBuilder, from: NodeRef, branchPort: OutputPortKey);
-  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>): this;
-  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>>;
-  build(): WorkflowDefinition;
-}
-//#endregion
-//#region ../core/src/workflow/dsl/ChainCursorResolver.d.ts
-type ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {
-  <TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined, TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined>(branches: Readonly<{
-    true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;
-    false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TFalseSteps> : never;
-  }> & BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;
-};
-declare class ChainCursor<TCurrentJson> {
-  private readonly wf;
-  private readonly cursor;
-  private readonly cursorOutput;
-  constructor(wf: WorkflowBuilder, cursor: NodeRef, cursorOutput: OutputPortKey);
-  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>>;
-  readonly when: ChainCursorWhenOverloads<TCurrentJson>;
-  build(): WorkflowDefinition;
-}
-//#endregion
-//#region ../core/src/workflow/dsl/WorkflowBuilder.d.ts
-declare class WorkflowBuilder {
-  private readonly meta;
-  private readonly options?;
-  private readonly nodes;
-  private readonly edges;
-  private seq;
-  constructor(meta: {
-    id: WorkflowId;
-    name: string;
-  }, options?: Readonly<{
-    makeMergeNode?: (name: string) => AnyRunnableNodeConfig;
-  }> | undefined);
-  private add;
-  private connect;
-  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>>;
-  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>>;
-  build(): WorkflowDefinition;
+//#region ../core/src/authoring/defineNode.types.d.ts
+type ResolvableCredentialType = AnyCredentialType | CredentialTypeId;
+type DefinedNodeCredentialBinding = ResolvableCredentialType | Readonly<{
+  readonly type: ResolvableCredentialType | ReadonlyArray<ResolvableCredentialType>;
+  readonly label?: string;
+  readonly optional?: true;
+  readonly helpText?: string;
+  readonly helpUrl?: string;
+}>;
+type DefinedNodeCredentialBindings = Readonly<Record<string, DefinedNodeCredentialBinding>>;
+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>;
+  register(context: {
+    registerNode<TValue>(token: TypeToken<TValue>, implementation?: TypeToken<TValue>): void;
+  }): void;
 }
 //#endregion
 //#region ../core/src/ai/NodeBackedToolConfig.d.ts
@@ -1184,6 +1310,72 @@ declare function createWorkflowBuilder(meta: Readonly<{
   name: string;
 }>): WorkflowBuilder;
 //#endregion
+//#region src/workflowAuthoring/WorkflowAuthoringOptions.types.d.ts
+type WorkflowAgentPrompt<TCurrentJson> = string | ((item: TCurrentJson) => string);
+interface WorkflowAgentOptions<TCurrentJson, TOutputSchema extends z.ZodTypeAny | undefined = undefined> {
+  readonly prompt: WorkflowAgentPrompt<TCurrentJson>;
+  readonly model: string | ChatModelConfig;
+  readonly tools?: ReadonlyArray<ToolConfig>;
+  readonly outputSchema?: TOutputSchema;
+  readonly retryPolicy?: RunnableNodeConfig["retryPolicy"];
+  readonly guardrails?: AgentGuardrailConfig;
+  readonly id?: string;
+}
+//#endregion
+//#region src/workflowAuthoring/WorkflowBranchBuilder.types.d.ts
+declare class WorkflowBranchBuilder<TCurrentJson> {
+  private readonly steps;
+  constructor(steps?: ReadonlyArray<AnyRunnableNodeConfig>);
+  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(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>;
+  wait(name: string, duration: number | string, id?: string): 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>;
+  getSteps(): ReadonlyArray<AnyRunnableNodeConfig>;
+}
+//#endregion
+//#region src/workflowAuthoring/WorkflowChain.types.d.ts
+type BranchCallback<TCurrentJson, TNextJson$1> = (branch: WorkflowBranchBuilder<TCurrentJson>) => WorkflowBranchBuilder<TNextJson$1>;
+declare class WorkflowChain<TCurrentJson> {
+  private readonly chain;
+  constructor(chain: ChainCursor<TCurrentJson>);
+  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(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>;
+  wait(name: string, duration: number | string, id?: string): WorkflowChain<TCurrentJson>;
+  if<TBranchJson>(predicate: (item: TCurrentJson) => boolean, branches: Readonly<{
+    true?: BranchCallback<TCurrentJson, TBranchJson>;
+    false?: BranchCallback<TCurrentJson, TBranchJson>;
+  }>): WorkflowChain<TBranchJson>;
+  if<TBranchJson>(name: string, predicate: (item: TCurrentJson) => boolean, branches: Readonly<{
+    true?: BranchCallback<TCurrentJson, TBranchJson>;
+    false?: BranchCallback<TCurrentJson, TBranchJson>;
+  }>): WorkflowChain<TBranchJson>;
+  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>;
+  build(): WorkflowDefinition;
+}
+//#endregion
+//#region src/workflowAuthoring/WorkflowAuthoringBuilder.types.d.ts
+declare class WorkflowAuthoringBuilder {
+  private readonly id;
+  private readonly workflowName;
+  constructor(id: string, workflowName?: string);
+  name(name: string): WorkflowAuthoringBuilder;
+  manualTrigger<TOutputJson$1>(defaultItems: TOutputJson$1 | ReadonlyArray<TOutputJson$1>): WorkflowChain<TOutputJson$1>;
+  manualTrigger<TOutputJson$1>(name: string, defaultItems?: TOutputJson$1 | ReadonlyArray<TOutputJson$1>, id?: string): WorkflowChain<TOutputJson$1>;
+}
+//#endregion
+//#region src/workflowAuthoring.types.d.ts
+declare function workflow(id: string): WorkflowAuthoringBuilder;
+//#endregion
 //#region src/nodes/ConnectionCredentialNode.d.ts
 /**
  * Placeholder runnable node for connection-owned workflow nodes (LLM/tool slots).
@@ -1225,5 +1417,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, type ExecutedToolCall, 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, SubWorkflow, SubWorkflowNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes };
+export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentToolCallPortMap, Callback, CallbackHandler, CallbackNode, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, type ExecutedToolCall, 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, SubWorkflow, SubWorkflowNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,4 +1,4 @@
-import { AgentConfigInspector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, ItemsInputNormalizer, NodeBackedToolConfig, RetryPolicy, WorkflowBuilder, chatModel, inject, injectable, node } from "@codemation/core";
+import { AgentConfigInspector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, DefinedNodeRegistry, ItemsInputNormalizer, NodeBackedToolConfig, RetryPolicy, WorkflowBuilder, chatModel, inject, injectable, node } from "@codemation/core";
 import { ChatOpenAI } from "@langchain/openai";
 import { AIMessage, HumanMessage, SystemMessage, ToolMessage } from "@langchain/core/messages";
 import { DynamicStructuredTool } from "@langchain/core/tools";
@@ -1191,6 +1191,166 @@ function createWorkflowBuilder(meta) {
 	}) });
 }
 
+//#endregion
+//#region src/workflowAuthoring/WorkflowChatModelFactory.types.ts
+var WorkflowChatModelFactory = class {
+	static create(model) {
+		if (typeof model !== "string") return model;
+		const [provider, resolvedModel] = model.includes(":") ? model.split(":", 2) : ["openai", model];
+		if (provider !== "openai") throw new Error(`Unsupported workflow().agent() model provider "${provider}".`);
+		return new OpenAIChatModelConfig("OpenAI", resolvedModel);
+	}
+};
+
+//#endregion
+//#region src/workflowAuthoring/WorkflowAgentNodeFactory.types.ts
+var WorkflowAgentNodeFactory = class {
+	static create(nameOrOptions, optionsOrUndefined) {
+		const options = typeof nameOrOptions === "string" ? optionsOrUndefined : nameOrOptions;
+		const name = typeof nameOrOptions === "string" ? nameOrOptions : "AI agent";
+		const prompt = options.prompt;
+		return new AIAgent({
+			name,
+			messages: [{
+				role: "user",
+				content: typeof prompt === "function" ? ({ item }) => prompt(item.json) : prompt
+			}],
+			chatModel: WorkflowChatModelFactory.create(options.model),
+			tools: options.tools,
+			id: options.id,
+			retryPolicy: options.retryPolicy,
+			guardrails: options.guardrails
+		});
+	}
+};
+
+//#endregion
+//#region src/workflowAuthoring/WorkflowDefinedNodeResolver.types.ts
+var WorkflowDefinedNodeResolver = class {
+	static resolve(definitionOrKey) {
+		if (typeof definitionOrKey !== "string") return definitionOrKey;
+		const definition = DefinedNodeRegistry.resolve(definitionOrKey);
+		if (!definition) throw new Error(`No helper-defined node with key "${definitionOrKey}" is registered in this module graph.`);
+		return definition;
+	}
+};
+
+//#endregion
+//#region src/workflowAuthoring/WorkflowDurationParser.types.ts
+var WorkflowDurationParser = class {
+	static parse(duration) {
+		if (typeof duration === "number") return Number.isFinite(duration) && duration > 0 ? Math.floor(duration) : 0;
+		const match = duration.trim().toLowerCase().match(/^(\d+)(ms|s|m|h)$/);
+		if (!match) throw new Error(`Unsupported wait duration "${duration}". Use a number of milliseconds or values like "500ms", "2s", "5m".`);
+		const value = Number(match[1]);
+		const unit = match[2];
+		if (unit === "ms") return value;
+		if (unit === "s") return value * 1e3;
+		if (unit === "m") return value * 6e4;
+		return value * 36e5;
+	}
+};
+
+//#endregion
+//#region src/workflowAuthoring/WorkflowBranchBuilder.types.ts
+var WorkflowBranchBuilder = class WorkflowBranchBuilder {
+	constructor(steps = []) {
+		this.steps = steps;
+	}
+	then(config) {
+		return new WorkflowBranchBuilder([...this.steps, config]);
+	}
+	map(nameOrMapper, mapperOrUndefined, id) {
+		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), id));
+	}
+	wait(nameOrDuration, durationOrUndefined, id) {
+		const name = typeof nameOrDuration === "string" && durationOrUndefined !== void 0 ? nameOrDuration : "Wait";
+		const duration = durationOrUndefined ?? nameOrDuration;
+		return this.then(new Wait(name, WorkflowDurationParser.parse(duration), id));
+	}
+	agent(nameOrOptions, optionsOrUndefined) {
+		return this.then(WorkflowAgentNodeFactory.create(nameOrOptions, optionsOrUndefined));
+	}
+	node(definitionOrKey, config, name, id) {
+		const definition = WorkflowDefinedNodeResolver.resolve(definitionOrKey);
+		return this.then(definition.create(config, name, id));
+	}
+	getSteps() {
+		return this.steps;
+	}
+};
+
+//#endregion
+//#region src/workflowAuthoring/WorkflowChain.types.ts
+var WorkflowChain = class WorkflowChain {
+	constructor(chain) {
+		this.chain = chain;
+	}
+	then(config) {
+		return new WorkflowChain(this.chain.then(config));
+	}
+	map(nameOrMapper, mapperOrUndefined, id) {
+		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), id));
+	}
+	wait(nameOrDuration, durationOrUndefined, id) {
+		const name = typeof nameOrDuration === "string" && durationOrUndefined !== void 0 ? nameOrDuration : "Wait";
+		const duration = durationOrUndefined ?? nameOrDuration;
+		return this.then(new Wait(name, WorkflowDurationParser.parse(duration), id));
+	}
+	if(nameOrPredicate, predicateOrBranches, branchesOrUndefined) {
+		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 trueSteps = branches.true?.(new WorkflowBranchBuilder()).getSteps();
+		const falseSteps = branches.false?.(new WorkflowBranchBuilder()).getSteps();
+		return new WorkflowChain(cursor.when({
+			true: trueSteps,
+			false: falseSteps
+		}));
+	}
+	agent(nameOrOptions, optionsOrUndefined) {
+		return this.then(WorkflowAgentNodeFactory.create(nameOrOptions, optionsOrUndefined));
+	}
+	node(definitionOrKey, config, name, id) {
+		const definition = WorkflowDefinedNodeResolver.resolve(definitionOrKey);
+		return this.then(definition.create(config, name, id));
+	}
+	build() {
+		return this.chain.build();
+	}
+};
+
+//#endregion
+//#region src/workflowAuthoring/WorkflowAuthoringBuilder.types.ts
+var WorkflowAuthoringBuilder = class WorkflowAuthoringBuilder {
+	constructor(id, workflowName = id) {
+		this.id = id;
+		this.workflowName = workflowName;
+	}
+	name(name) {
+		return new WorkflowAuthoringBuilder(this.id, name);
+	}
+	manualTrigger(nameOrDefaultItems, defaultItemsOrUndefined, id) {
+		const builder = createWorkflowBuilder({
+			id: this.id,
+			name: this.workflowName
+		});
+		if (typeof nameOrDefaultItems === "string") return new WorkflowChain(builder.trigger(new ManualTrigger(nameOrDefaultItems, defaultItemsOrUndefined, id)));
+		return new WorkflowChain(builder.trigger(new ManualTrigger("Manual trigger", nameOrDefaultItems)));
+	}
+};
+
+//#endregion
+//#region src/workflowAuthoring.types.ts
+function workflow(id) {
+	return new WorkflowAuthoringBuilder(id);
+}
+
 //#endregion
 //#region src/workflows/AIAgentConnectionWorkflowExpander.ts
 /**
@@ -1200,18 +1360,18 @@ var AIAgentConnectionWorkflowExpander = class {
 	constructor(connectionCredentialNodeConfigFactory) {
 		this.connectionCredentialNodeConfigFactory = connectionCredentialNodeConfigFactory;
 	}
-	expand(workflow) {
+	expand(workflow$1) {
 		const existingByParentAndName = /* @__PURE__ */ new Map();
-		for (const c of workflow.connections ?? []) existingByParentAndName.set(`${c.parentNodeId}\0${c.connectionName}`, c);
+		for (const c of workflow$1.connections ?? []) existingByParentAndName.set(`${c.parentNodeId}\0${c.connectionName}`, c);
 		const extraNodes = [];
 		const extraConnections = [];
-		for (const node$1 of workflow.nodes) {
+		for (const node$1 of workflow$1.nodes) {
 			if (node$1.type !== AIAgentNode || !AgentConfigInspector.isAgentNodeConfig(node$1.config)) continue;
 			const agentId = node$1.id;
 			const agentConfig = node$1.config;
 			if (!existingByParentAndName.has(`${agentId}\0llm`)) {
 				const llmId = ConnectionNodeIdFactory.languageModelConnectionNodeId(agentId);
-				this.assertNoIdCollision(workflow, extraNodes, llmId);
+				this.assertNoIdCollision(workflow$1, extraNodes, llmId);
 				extraNodes.push({
 					id: llmId,
 					kind: "node",
@@ -1229,7 +1389,7 @@ var AIAgentConnectionWorkflowExpander = class {
 				const toolIds = [];
 				for (const tool of agentConfig.tools ?? []) {
 					const toolId = ConnectionNodeIdFactory.toolConnectionNodeId(agentId, tool.name);
-					this.assertNoIdCollision(workflow, extraNodes, toolId);
+					this.assertNoIdCollision(workflow$1, extraNodes, toolId);
 					toolIds.push(toolId);
 					extraNodes.push({
 						id: toolId,
@@ -1246,15 +1406,15 @@ var AIAgentConnectionWorkflowExpander = class {
 				});
 			}
 		}
-		if (extraNodes.length === 0) return workflow;
+		if (extraNodes.length === 0) return workflow$1;
 		return {
-			...workflow,
-			nodes: [...workflow.nodes, ...extraNodes],
-			connections: [...workflow.connections ?? [], ...extraConnections]
+			...workflow$1,
+			nodes: [...workflow$1.nodes, ...extraNodes],
+			connections: [...workflow$1.connections ?? [], ...extraConnections]
 		};
 	}
-	assertNoIdCollision(workflow, pending, id) {
-		if (workflow.nodes.some((n) => n.id === id) || pending.some((n) => n.id === id)) throw new Error(`AIAgent connection expansion: node id "${id}" already exists. Rename the conflicting node or adjust the workflow.`);
+	assertNoIdCollision(workflow$1, pending, id) {
+		if (workflow$1.nodes.some((n) => n.id === id) || pending.some((n) => n.id === id)) throw new Error(`AIAgent connection expansion: node id "${id}" already exists. Rename the conflicting node or adjust the workflow.`);
 	}
 };
 
@@ -1281,5 +1441,5 @@ var ConnectionCredentialNodeConfigFactory = class {
 };
 
 //#endregion
-export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentToolCallPortMap, Callback, CallbackNode, CallbackResultNormalizer, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, HttpRequest, HttpRequestNode, If, IfNode, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, SubWorkflow, SubWorkflowNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes };
+export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentToolCallPortMap, Callback, CallbackNode, CallbackResultNormalizer, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, HttpRequest, HttpRequestNode, If, IfNode, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, SubWorkflow, SubWorkflowNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
 //# sourceMappingURL=index.js.map