@codemation/core 0.0.14 → 0.0.15

package/dist/bootstrap/index.d.ts

@@ -1,5 +1,5 @@
 import { Jn as WebhookTriggerRoutingDiagnostics, Kn as WebhookTriggerMatcher, Lr as TypeToken, Mr as DependencyContainer, Nt as WorkflowDefinition, Xr as EngineExecutionLimitsPolicy, Yr as ENGINE_EXECUTION_LIMITS_DEFAULTS, Zr as EngineExecutionLimitsPolicyConfig, jn as TriggerRuntimeDiagnostics, t as InMemoryLiveWorkflowRepository, xt as PersistedTokenId } from "../InMemoryLiveWorkflowRepository-DxoualoC.js";
-import { $ as NodeInstanceFactory, _ as EngineExecutionLimitsPolicyFactory, a as ConfigDrivenOffloadPolicy, at as CredentialResolverFactory, c as EngineWorkflowRunnerService, ct as EngineFactory, d as InMemoryRunDataFactory, et as NodeExecutor, f as InMemoryBinaryStorage, g as RunPolicySnapshotFactory, h as WorkflowStoragePolicyEvaluator, i as InlineDrivingScheduler, it as AsyncSleeper, l as RunSummaryMapper, lt as Engine, m as RunTerminalPersistenceCoordinator, n as HintOnlyOffloadPolicy, nt as DefaultExecutionContextFactory, o as WorkflowRepositoryWebhookTriggerMatcher, p as WorkflowPolicyErrorServices, r as DefaultDrivingScheduler, rt as DefaultAsyncSleeper, s as RunIntentService, st as EngineCompositionDeps, t as LocalOnlyScheduler, tt as InProcessRetryRunner, u as InMemoryWorkflowExecutionRepository, v as DefaultExecutionBinaryService, y as UnavailableBinaryStorage } from "../index-CTjfVHJh.js";
+import { Ct as AsyncSleeper, Dt as EngineFactory, Et as EngineCompositionDeps, Ot as Engine, St as DefaultAsyncSleeper, _ as EngineExecutionLimitsPolicyFactory, a as ConfigDrivenOffloadPolicy, bt as InProcessRetryRunner, c as EngineWorkflowRunnerService, d as InMemoryRunDataFactory, f as InMemoryBinaryStorage, g as RunPolicySnapshotFactory, h as WorkflowStoragePolicyEvaluator, i as InlineDrivingScheduler, l as RunSummaryMapper, m as RunTerminalPersistenceCoordinator, n as HintOnlyOffloadPolicy, o as WorkflowRepositoryWebhookTriggerMatcher, p as WorkflowPolicyErrorServices, r as DefaultDrivingScheduler, s as RunIntentService, t as LocalOnlyScheduler, u as InMemoryWorkflowExecutionRepository, v as DefaultExecutionBinaryService, vt as NodeInstanceFactory, wt as CredentialResolverFactory, xt as DefaultExecutionContextFactory, y as UnavailableBinaryStorage, yt as NodeExecutor } from "../index-k0hwnJyT.js";
 
 //#region src/bootstrap/runtime/EngineRuntimeRegistration.types.d.ts
 

package/dist/{index-CTjfVHJh.d.ts → index-k0hwnJyT.d.ts}

@@ -1,4 +1,4 @@
-import { $r as RunEventBus, $t as BinaryBody, Ar as WorkflowExecutionRepository, Cn as NodeExecutionScheduler, Ct as RunDataSnapshot, Dr as WebhookRunResult, En as NodeResolver, Er as RunSummary, Et as RunnableNodeConfig, Ft as WorkflowErrorHandler, G as BinaryAttachment, Gn as WebhookInvocationMatch, Hn as HttpMethod, I as CredentialSessionService, In as WorkflowNodeInstanceFactory, It as WorkflowErrorHandlerSpec, J as ExecutionMode, Jn as WebhookTriggerRoutingDiagnostics, Kn as WebhookTriggerMatcher, Ln as WorkflowRepository, Lr as TypeToken, N as CredentialRequirement, Nt as WorkflowDefinition, Or as WorkflowExecutionListingRepository, Q as Items, Qr as RunEvent, Sn as NodeExecutionRequestHandler, Sr as RunResult, St as RunDataFactory, Tr as RunStopCondition, Ut as WorkflowStoragePolicyDecisionArgs, Vn as WorkflowSnapshotResolver, Vt as WorkflowPolicyRuntimeDefaults, X as Item, Xn as WorkflowActivationPolicy, Xr as EngineExecutionLimitsPolicy, Zr as EngineExecutionLimitsPolicyConfig, _r as RunCurrentState, an as EngineDeps, at as NodeConfigBase, bn as NodeExecutionContext, br as RunPruneCandidate, bt as PersistedRunPolicySnapshot, cn as ExecutionBinaryService, ct as NodeErrorHandler, dn as LiveWorkflowRepository, dr as PersistedRunState, dt as NodeId, ei as RunEventSubscription, en as BinaryStorage, er as CurrentStateExecutionRequest, gn as NodeActivationRequest, gt as NodeSchedulerDecision, hn as NodeActivationReceipt, in as BinaryStorageWriteResult, ir as NodeExecutionSnapshot, it as NodeActivationId, kr as WorkflowExecutionPruneRepository, ln as ExecutionContext, mn as NodeActivationContinuation, mr as PersistedWorkflowTokenRegistryLike, mt as NodeOutputs, n as WorkflowSnapshotCodec, nn as BinaryStorageStatResult, or as NodeInputsByPort, pr as PersistedWorkflowSnapshotNode, pt as NodeOffloadPolicy, qn as WebhookTriggerResolution, rt as MutableRunData, si as RetryPolicySpec, st as NodeDefinition, tn as BinaryStorageReadResult, tr as EngineRunCounters, un as ExecutionContextFactory, ut as NodeErrorHandlerSpec, vn as NodeActivationScheduler, wn as NodeExecutionStatePublisher, wt as RunId, xn as NodeExecutionRequest, yn as NodeBinaryAttachmentService, yr as RunExecutionOptions, yt as ParentExecutionRef, zt as WorkflowId } from "./InMemoryLiveWorkflowRepository-DxoualoC.js";
+import { $r as RunEventBus, $t as BinaryBody, Ar as WorkflowExecutionRepository, Cn as NodeExecutionScheduler, Ct as RunDataSnapshot, Dr as WebhookRunResult, Dt as RunnableNodeInputJson, En as NodeResolver, Er as RunSummary, Et as RunnableNodeConfig, Ft as WorkflowErrorHandler, G as BinaryAttachment, Gn as WebhookInvocationMatch, Hn as HttpMethod, I as CredentialSessionService, In as WorkflowNodeInstanceFactory, It as WorkflowErrorHandlerSpec, J as ExecutionMode, Jn as WebhookTriggerRoutingDiagnostics, Kn as WebhookTriggerMatcher, Ln as WorkflowRepository, Lr as TypeToken, N as CredentialRequirement, Nt as WorkflowDefinition, Or as WorkflowExecutionListingRepository, Q as Items, Qr as RunEvent, Sn as NodeExecutionRequestHandler, Sr as RunResult, St as RunDataFactory, Tr as RunStopCondition, Ut as WorkflowStoragePolicyDecisionArgs, Vn as WorkflowSnapshotResolver, Vt as WorkflowPolicyRuntimeDefaults, X as Item, Xn as WorkflowActivationPolicy, Xr as EngineExecutionLimitsPolicy, Zr as EngineExecutionLimitsPolicyConfig, _r as RunCurrentState, an as EngineDeps, at as NodeConfigBase, bn as NodeExecutionContext, br as RunPruneCandidate, bt as PersistedRunPolicySnapshot, cn as ExecutionBinaryService, ct as NodeErrorHandler, dn as LiveWorkflowRepository, dr as PersistedRunState, dt as NodeId, ei as RunEventSubscription, en as BinaryStorage, er as CurrentStateExecutionRequest, gn as NodeActivationRequest, gt as NodeSchedulerDecision, hn as NodeActivationReceipt, in as BinaryStorageWriteResult, ir as NodeExecutionSnapshot, it as NodeActivationId, kr as WorkflowExecutionPruneRepository, ln as ExecutionContext, mn as NodeActivationContinuation, mr as PersistedWorkflowTokenRegistryLike, mt as NodeOutputs, n as WorkflowSnapshotCodec, nn as BinaryStorageStatResult, nt as JsonValue, or as NodeInputsByPort, pr as PersistedWorkflowSnapshotNode, pt as NodeOffloadPolicy, qn as WebhookTriggerResolution, rt as MutableRunData, si as RetryPolicySpec, st as NodeDefinition, tn as BinaryStorageReadResult, tr as EngineRunCounters, un as ExecutionContextFactory, ut as NodeErrorHandlerSpec, vn as NodeActivationScheduler, wn as NodeExecutionStatePublisher, wt as RunId, xn as NodeExecutionRequest, yn as NodeBinaryAttachmentService, yr as RunExecutionOptions, yt as ParentExecutionRef, zt as WorkflowId } from "./InMemoryLiveWorkflowRepository-DxoualoC.js";
 import { ZodType, input, output } from "zod";
 
 //#region src/orchestration/Engine.d.ts
@@ -243,6 +243,49 @@ declare class SystemClock implements Clock {
   now(): Date;
 }
 //#endregion
+//#region src/ai/NodeBackedToolConfig.d.ts
+declare class NodeBackedToolConfig<TNodeConfig extends RunnableNodeConfig<any, any>, TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny> implements ToolConfig {
+  readonly name: string;
+  readonly node: TNodeConfig;
+  readonly type: TypeToken<unknown>;
+  readonly toolKind: "nodeBacked";
+  readonly description?: string;
+  readonly presentation?: AgentCanvasPresentation;
+  private readonly inputSchemaValue;
+  private readonly outputSchemaValue;
+  private readonly mapInputValue?;
+  private readonly mapOutputValue?;
+  constructor(name: string, node: TNodeConfig, options: NodeBackedToolConfigOptions<TNodeConfig, TInputSchema, TOutputSchema>);
+  getCredentialRequirements(): ReadonlyArray<CredentialRequirement>;
+  getInputSchema(): TInputSchema;
+  getOutputSchema(): TOutputSchema;
+  toNodeItem(args: NodeBackedToolInputMapperArgs<TNodeConfig, input<TInputSchema>>): Item<RunnableNodeInputJson<TNodeConfig>>;
+  toToolOutput(args: NodeBackedToolOutputMapperArgs<TNodeConfig, input<TInputSchema>>): output<TOutputSchema>;
+  private readDefaultToolOutput;
+  private isItem;
+}
+//#endregion
+//#region src/ai/AgentToolFactory.d.ts
+declare class AgentToolFactoryImpl {
+  asTool<TNodeConfig extends RunnableNodeConfig<any, any>, TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny>(node: TNodeConfig, options: Readonly<{
+    name?: string;
+  } & NodeBackedToolConfigOptions<TNodeConfig, TInputSchema, TOutputSchema>>): NodeBackedToolConfig<TNodeConfig, TInputSchema, TOutputSchema>;
+}
+declare const AgentToolFactory: AgentToolFactoryImpl;
+//#endregion
+//#region src/ai/AgentMessageConfigNormalizerFactory.d.ts
+declare class AgentMessageConfigNormalizer {
+  static normalize<TInputJson, TOutputJson>(config: AgentNodeConfig<TInputJson, TOutputJson>, args: AgentMessageBuildArgs<TInputJson>): ReadonlyArray<AgentMessageDto>;
+  private static normalizeRichMessages;
+  private static lineToDto;
+}
+//#endregion
+//#region src/ai/AgentConfigInspectorFactory.d.ts
+declare class AgentConfigInspector {
+  static isAgentNodeConfig(config: NodeConfigBase | undefined): config is AgentNodeConfig<any, any>;
+  private static hasCompatibleMessageConfiguration;
+}
+//#endregion
 //#region src/ai/AiHost.d.ts
 interface AgentCanvasPresentation<TIcon extends string = string> {
   readonly label?: string;
@@ -250,7 +293,7 @@ interface AgentCanvasPresentation<TIcon extends string = string> {
 }
 type ZodSchemaAny = ZodType<any, any, any>;
 interface ToolConfig {
-  readonly type: TypeToken<Tool<ToolConfig, ZodSchemaAny, ZodSchemaAny>>;
+  readonly type: TypeToken<unknown>;
   readonly name: string;
   readonly description?: string;
   readonly presentation?: AgentCanvasPresentation;
@@ -273,6 +316,47 @@ interface Tool<TConfig extends ToolConfig = ToolConfig, TInputSchema extends Zod
 type AgentTool<TInputSchema extends ZodSchemaAny = ZodSchemaAny, TOutputSchema extends ZodSchemaAny = ZodSchemaAny> = Tool<ToolConfig, TInputSchema, TOutputSchema>;
 type AgentToolExecuteArgs<TInput = unknown> = ToolExecuteArgs<ToolConfig, TInput>;
 type AgentToolToken = TypeToken<Tool<ToolConfig, ZodSchemaAny, ZodSchemaAny>>;
+type AgentMessageRole = "system" | "user" | "assistant";
+type AgentMessageBuildArgs<TInputJson = unknown> = Readonly<{
+  item: Item<TInputJson>;
+  itemIndex: number;
+  items: Items<TInputJson>;
+  ctx: NodeExecutionContext<any>;
+}>;
+interface AgentMessageDto {
+  readonly role: AgentMessageRole;
+  readonly content: string;
+}
+type AgentMessageTemplateContent<TInputJson = unknown> = string | ((args: AgentMessageBuildArgs<TInputJson>) => string);
+interface AgentMessageTemplate<TInputJson = unknown> {
+  readonly role: AgentMessageRole;
+  readonly content: AgentMessageTemplateContent<TInputJson>;
+}
+/** A single prompt line: fixed DTO or template with optional function `content`. */
+type AgentMessageLine<TInputJson = unknown> = AgentMessageDto | AgentMessageTemplate<TInputJson>;
+/**
+ * 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 = unknown> = ReadonlyArray<AgentMessageLine<TInputJson>> | {
+  readonly prompt?: ReadonlyArray<AgentMessageLine<TInputJson>>;
+  readonly buildMessages?: (args: AgentMessageBuildArgs<TInputJson>) => ReadonlyArray<AgentMessageDto>;
+};
+type AgentTurnLimitBehavior = "error" | "respondWithLastMessage";
+interface AgentModelInvocationOptions {
+  readonly maxTokens?: number;
+  readonly providerOptions?: Readonly<Record<string, JsonValue>>;
+}
+interface AgentGuardrailConfig {
+  readonly maxTurns?: number;
+  readonly onTurnLimitReached?: AgentTurnLimitBehavior;
+  readonly modelInvocationOptions?: AgentModelInvocationOptions;
+}
+/** Defaults aligned with common tool-agent iteration limits (many products use ~10 max rounds). */
+declare const AgentGuardrailDefaults: {
+  readonly maxTurns: 10;
+  readonly onTurnLimitReached: AgentTurnLimitBehavior;
+};
 interface AgentToolDefinition {
   readonly name: string;
   readonly description: string;
@@ -300,14 +384,38 @@ interface ChatModelFactory<TConfig extends ChatModelConfig = ChatModelConfig> {
     ctx: NodeExecutionContext<any>;
   }>): Promise<LangChainChatModelLike> | LangChainChatModelLike;
 }
+type NodeBackedToolInputMapperArgs<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown> = Readonly<{
+  input: TToolInput;
+  item: Item;
+  itemIndex: number;
+  items: Items;
+  ctx: NodeExecutionContext<any>;
+  node: TNodeConfig;
+}>;
+type NodeBackedToolOutputMapperArgs<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown> = Readonly<{
+  input: TToolInput;
+  item: Item;
+  itemIndex: number;
+  items: Items;
+  ctx: NodeExecutionContext<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<{
+  description?: string;
+  presentation?: AgentCanvasPresentation;
+  inputSchema: TInputSchema;
+  outputSchema: TOutputSchema;
+  mapInput?: NodeBackedToolInputMapper<TNodeConfig, input<TInputSchema>>;
+  mapOutput?: NodeBackedToolOutputMapper<TNodeConfig, input<TInputSchema>, output<TOutputSchema>>;
+}>;
 interface AgentNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends RunnableNodeConfig<TInputJson, TOutputJson> {
-  readonly systemMessage: string;
-  readonly userMessageFormatter: (item: Item<TInputJson>, index: number, items: Items<TInputJson>, ctx: NodeExecutionContext<any>) => string;
+  readonly messages: AgentMessageConfig<TInputJson>;
   readonly chatModel: ChatModelConfig;
   readonly tools?: ReadonlyArray<ToolConfig>;
-}
-declare class AgentConfigInspector {
-  static isAgentNodeConfig(config: NodeConfigBase | undefined): config is AgentNodeConfig<any, any>;
+  readonly guardrails?: AgentGuardrailConfig;
 }
 type AgentAttachmentRole = "languageModel" | "tool";
 //#endregion
@@ -690,5 +798,5 @@ declare class LocalOnlyScheduler implements NodeExecutionScheduler {
   }>;
 }
 //#endregion
-export { NodeInstanceFactory as $, PersistedRuntimeTypeKind as A, AgentToolCallPlanner as B, node as C, PersistedRuntimeTypeMetadataStore as D, PersistedRuntimeTypeNameResolver as E, AgentCanvasPresentation as F, ChatModelFactory as G, AgentToolExecuteArgs as H, AgentConfigInspector as I, ToolConfig as J, LangChainChatModelLike as K, AgentNodeConfig as L, EventPublishingWorkflowExecutionRepository as M, InMemoryRunEventBus as N, InjectableRuntimeDecoratorComposer as O, AgentAttachmentRole as P, SystemClock as Q, AgentTool as R, getPersistedRuntimeTypeMetadata as S, StackTraceCallSitePathResolver as T, AgentToolToken as U, AgentToolDefinition as V, ChatModelConfig as W, ZodSchemaAny as X, ToolExecuteArgs as Y, Clock as Z, EngineExecutionLimitsPolicyFactory as _, ConfigDrivenOffloadPolicy as a, CredentialResolverFactory as at, ItemsInputNormalizer as b, EngineWorkflowRunnerService as c, EngineFactory as ct, InMemoryRunDataFactory as d, NodeExecutor as et, InMemoryBinaryStorage as f, RunPolicySnapshotFactory as g, WorkflowStoragePolicyEvaluator as h, InlineDrivingScheduler as i, AsyncSleeper as it, PersistedRuntimeTypeMetadata as j, PersistedRuntimeTypeDecoratorOptions as k, RunSummaryMapper as l, Engine as lt, RunTerminalPersistenceCoordinator as m, HintOnlyOffloadPolicy as n, DefaultExecutionContextFactory as nt, WorkflowRepositoryWebhookTriggerMatcher as o, NodeEventPublisher as ot, WorkflowPolicyErrorServices as p, Tool as q, DefaultDrivingScheduler as r, DefaultAsyncSleeper as rt, RunIntentService as s, EngineCompositionDeps as st, LocalOnlyScheduler as t, InProcessRetryRunner as tt, InMemoryWorkflowExecutionRepository as u, DefaultExecutionBinaryService as v, tool as w, chatModel as x, UnavailableBinaryStorage as y, AgentToolCall as z };
-//# sourceMappingURL=index-CTjfVHJh.d.ts.map
+export { AgentTurnLimitBehavior as $, PersistedRuntimeTypeKind as A, AgentMessageDto as B, node as C, AsyncSleeper as Ct, PersistedRuntimeTypeMetadataStore as D, EngineFactory as Dt, PersistedRuntimeTypeNameResolver as E, EngineCompositionDeps as Et, AgentCanvasPresentation as F, AgentModelInvocationOptions as G, AgentMessageRole as H, AgentGuardrailConfig as I, AgentToolCall as J, AgentNodeConfig as K, AgentGuardrailDefaults as L, EventPublishingWorkflowExecutionRepository as M, InMemoryRunEventBus as N, InjectableRuntimeDecoratorComposer as O, Engine as Ot, AgentAttachmentRole as P, AgentToolToken as Q, AgentMessageBuildArgs as R, getPersistedRuntimeTypeMetadata as S, DefaultAsyncSleeper as St, StackTraceCallSitePathResolver as T, NodeEventPublisher as Tt, AgentMessageTemplate as U, AgentMessageLine as V, AgentMessageTemplateContent as W, AgentToolDefinition as X, AgentToolCallPlanner as Y, AgentToolExecuteArgs as Z, EngineExecutionLimitsPolicyFactory as _, SystemClock as _t, ConfigDrivenOffloadPolicy as a, NodeBackedToolInputMapperArgs as at, ItemsInputNormalizer as b, InProcessRetryRunner as bt, EngineWorkflowRunnerService as c, Tool as ct, InMemoryRunDataFactory as d, ZodSchemaAny as dt, ChatModelConfig as et, InMemoryBinaryStorage as f, AgentConfigInspector as ft, RunPolicySnapshotFactory as g, Clock as gt, WorkflowStoragePolicyEvaluator as h, NodeBackedToolConfig as ht, InlineDrivingScheduler as i, NodeBackedToolInputMapper as it, PersistedRuntimeTypeMetadata as j, PersistedRuntimeTypeDecoratorOptions as k, RunSummaryMapper as l, ToolConfig as lt, RunTerminalPersistenceCoordinator as m, AgentToolFactory as mt, HintOnlyOffloadPolicy as n, LangChainChatModelLike as nt, WorkflowRepositoryWebhookTriggerMatcher as o, NodeBackedToolOutputMapper as ot, WorkflowPolicyErrorServices as p, AgentMessageConfigNormalizer as pt, AgentTool as q, DefaultDrivingScheduler as r, NodeBackedToolConfigOptions as rt, RunIntentService as s, NodeBackedToolOutputMapperArgs as st, LocalOnlyScheduler as t, ChatModelFactory as tt, InMemoryWorkflowExecutionRepository as u, ToolExecuteArgs as ut, DefaultExecutionBinaryService as v, NodeInstanceFactory as vt, tool as w, CredentialResolverFactory as wt, chatModel as x, DefaultExecutionContextFactory as xt, UnavailableBinaryStorage as y, NodeExecutor as yt, AgentMessageConfig as z };
+//# sourceMappingURL=index-k0hwnJyT.d.ts.map

package/dist/index.cjs

@@ -13,15 +13,117 @@ var SystemClock = class {
 };
 
 //#endregion
-//#region src/ai/AiHost.ts
+//#region src/ai/NodeBackedToolConfig.ts
+var NodeBackedToolConfig = class {
+	type;
+	toolKind = "nodeBacked";
+	description;
+	presentation;
+	inputSchemaValue;
+	outputSchemaValue;
+	mapInputValue;
+	mapOutputValue;
+	constructor(name, node$1, options) {
+		this.name = name;
+		this.node = node$1;
+		this.type = node$1.type;
+		this.description = options.description;
+		this.presentation = options.presentation;
+		this.inputSchemaValue = options.inputSchema;
+		this.outputSchemaValue = options.outputSchema;
+		this.mapInputValue = options.mapInput;
+		this.mapOutputValue = options.mapOutput;
+	}
+	getCredentialRequirements() {
+		return this.node.getCredentialRequirements?.() ?? [];
+	}
+	getInputSchema() {
+		return this.inputSchemaValue;
+	}
+	getOutputSchema() {
+		return this.outputSchemaValue;
+	}
+	toNodeItem(args) {
+		const mapped = this.mapInputValue?.(args) ?? args.input;
+		if (this.isItem(mapped)) return mapped;
+		return { json: mapped };
+	}
+	toToolOutput(args) {
+		const raw = this.mapOutputValue?.(args) ?? this.readDefaultToolOutput(args.outputs);
+		return this.outputSchemaValue.parse(raw);
+	}
+	readDefaultToolOutput(outputs) {
+		const firstMainItem = outputs.main?.[0];
+		if (!firstMainItem) throw new Error(`Node-backed tool "${this.name}" did not produce a main output item.`);
+		return firstMainItem.json;
+	}
+	isItem(value) {
+		return typeof value === "object" && value !== null && "json" in value;
+	}
+};
+
+//#endregion
+//#region src/ai/AgentToolFactory.ts
+var AgentToolFactoryImpl = class {
+	asTool(node$1, options) {
+		return new NodeBackedToolConfig(options.name ?? node$1.name ?? "tool", node$1, options);
+	}
+};
+const AgentToolFactory = new AgentToolFactoryImpl();
+
+//#endregion
+//#region src/ai/AgentMessageConfigNormalizerFactory.ts
+var AgentMessageConfigNormalizer = class {
+	static normalize(config, args) {
+		const fromMessages = this.normalizeRichMessages(config.messages, args);
+		if (fromMessages.length > 0) return fromMessages;
+		throw new Error("AIAgent messages must be a non-empty array, or an object with a non-empty prompt array and/or buildMessages that returns messages.");
+	}
+	static normalizeRichMessages(config, args) {
+		if (Array.isArray(config)) return config.map((line) => this.lineToDto(line, args));
+		const structured = config;
+		const messages = [];
+		for (const line of structured.prompt ?? []) messages.push(this.lineToDto(line, args));
+		for (const message of structured.buildMessages?.(args) ?? []) messages.push(message);
+		return messages;
+	}
+	static lineToDto(line, args) {
+		const content = typeof line.content === "function" ? line.content(args) : line.content;
+		return {
+			role: line.role,
+			content
+		};
+	}
+};
+
+//#endregion
+//#region src/ai/AgentConfigInspectorFactory.ts
 var AgentConfigInspector = class {
 	static isAgentNodeConfig(config) {
 		if (!config) return false;
 		const candidate = config;
-		return typeof candidate.systemMessage === "string" && typeof candidate.userMessageFormatter === "function" && !!candidate.chatModel;
+		return !!candidate.chatModel && this.hasCompatibleMessageConfiguration(candidate);
+	}
+	static hasCompatibleMessageConfiguration(candidate) {
+		const messages = candidate.messages;
+		if (messages === void 0 || messages === null) return false;
+		if (Array.isArray(messages)) return messages.length > 0;
+		if (typeof messages === "object") {
+			const o = messages;
+			return Array.isArray(o.prompt) && o.prompt.length > 0 || typeof o.buildMessages === "function";
+		}
+		return false;
 	}
 };
 
+//#endregion
+//#region src/ai/AiHost.ts
+/** Defaults aligned with common tool-agent iteration limits (many products use ~10 max rounds). */
+const AgentGuardrailDefaults = {
+	maxTurns: 10,
+	onTurnLimitReached: "error"
+};
+
 //#endregion
 //#region src/workflow/dsl/WhenBuilder.ts
 var WhenBuilder = class WhenBuilder {
@@ -412,6 +514,9 @@ var AllWorkflowsActiveWorkflowActivationPolicy = class {
 
 //#endregion
 exports.AgentConfigInspector = AgentConfigInspector;
+exports.AgentGuardrailDefaults = AgentGuardrailDefaults;
+exports.AgentMessageConfigNormalizer = AgentMessageConfigNormalizer;
+exports.AgentToolFactory = AgentToolFactory;
 exports.AllWorkflowsActiveWorkflowActivationPolicy = AllWorkflowsActiveWorkflowActivationPolicy;
 exports.ChainCursor = ChainCursor;
 exports.ConnectionInvocationIdFactory = ConnectionInvocationIdFactory;
@@ -439,6 +544,7 @@ Object.defineProperty(exports, 'ItemsInputNormalizer', {
   }
 });
 exports.NoRetryPolicy = NoRetryPolicy;
+exports.NodeBackedToolConfig = NodeBackedToolConfig;
 exports.NodeEventPublisher = require_RunIntentService.NodeEventPublisher;
 exports.PersistedRuntimeTypeMetadataStore = require_RunIntentService.PersistedRuntimeTypeMetadataStore;
 exports.PersistedRuntimeTypeNameResolver = require_RunIntentService.PersistedRuntimeTypeNameResolver;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","cursor: NodeRef","cursorOutput: OutputPortKey","port: OutputPortKey","prev: NodeRef | null","meta: { id: WorkflowId; name: string }","options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>","onClose: () => void","inner: WorkflowExecutionRepository","eventBus: RunEventBus","now: () => Date","ItemsInputNormalizer","maxAttempts: number","delayMs: number","maxAttempts: number","initialDelayMs: number","multiplier: number","maxDelayMs?: number","jitter?: boolean","bindingKey: CredentialBindingKey","acceptedTypes: ReadonlyArray<CredentialTypeId>"],"sources":["../src/contracts/Clock.ts","../src/ai/AiHost.ts","../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/workflow/definition/ConnectionInvocationIdFactory.ts","../src/workflow/graph/ExecutableGraph.ts","../src/workflow/graph/DefaultWorkflowGraphFactory.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts","../src/events/EventPublishingWorkflowExecutionRepository.ts","../src/serialization/ItemsInputNormalizer.ts","../src/contracts/NoRetryPolicy.ts","../src/contracts/RetryPolicy.ts","../src/contracts/ExpRetryPolicy.ts","../src/contracts/credentialTypes.ts","../src/contracts/workflowTypes.ts","../src/contracts/workflowActivationPolicy.ts"],"sourcesContent":["/** Port for time; inject `SystemClock` in production and a fake/test clock in tests. */\nexport interface Clock {\n  now(): Date;\n}\n\nexport class SystemClock implements Clock {\n  now(): Date {\n    return new Date();\n  }\n}\n","import type { TypeToken } from \"../di\";\n\nimport type { CredentialRequirement } from \"../contracts/credentialTypes\";\n\nimport type { Item, Items, NodeConfigBase, NodeExecutionContext, RunnableNodeConfig } from \"../types\";\n\nimport type { input as ZodInput, output as ZodOutput, ZodType } from \"zod\";\n\nexport interface AgentCanvasPresentation<TIcon extends string = string> {\n  readonly label?: string;\n  readonly icon?: TIcon;\n}\n\nexport type ZodSchemaAny = ZodType<any, any, any>;\n\nexport interface ToolConfig {\n  readonly type: TypeToken<Tool<ToolConfig, ZodSchemaAny, ZodSchemaAny>>;\n  readonly name: string;\n  readonly description?: string;\n  readonly presentation?: AgentCanvasPresentation;\n  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;\n}\n\nexport type ToolExecuteArgs<TConfig extends ToolConfig = ToolConfig, TInput = unknown> = Readonly<{\n  config: TConfig;\n  input: TInput;\n  ctx: NodeExecutionContext<any>;\n  item: Item;\n  itemIndex: number;\n  items: Items;\n}>;\n\nexport interface Tool<\n  TConfig extends ToolConfig = ToolConfig,\n  TInputSchema extends ZodSchemaAny = ZodSchemaAny,\n  TOutputSchema extends ZodSchemaAny = ZodSchemaAny,\n> {\n  readonly defaultDescription: string;\n  readonly inputSchema: TInputSchema;\n  readonly outputSchema: TOutputSchema;\n  execute(\n    args: ToolExecuteArgs<TConfig, ZodInput<TInputSchema>>,\n  ): Promise<ZodOutput<TOutputSchema>> | ZodOutput<TOutputSchema>;\n}\n\nexport type AgentTool<\n  TInputSchema extends ZodSchemaAny = ZodSchemaAny,\n  TOutputSchema extends ZodSchemaAny = ZodSchemaAny,\n> = Tool<ToolConfig, TInputSchema, TOutputSchema>;\n\nexport type AgentToolExecuteArgs<TInput = unknown> = ToolExecuteArgs<ToolConfig, TInput>;\n\nexport type AgentToolToken = TypeToken<Tool<ToolConfig, ZodSchemaAny, ZodSchemaAny>>;\n\nexport interface AgentToolDefinition {\n  readonly name: string;\n  readonly description: string;\n  readonly inputSchema: ZodSchemaAny;\n}\n\nexport type AgentToolCall = Readonly<{ id?: string; name: string; input: unknown }>;\n\nexport type AgentToolCallPlanner<_TNodeConfig = unknown> = (\n  item: Item,\n  index: number,\n  items: Items,\n  ctx: NodeExecutionContext<any>,\n) => ReadonlyArray<AgentToolCall>;\n\nexport interface ChatModelConfig {\n  readonly type: TypeToken<ChatModelFactory<ChatModelConfig>>;\n  readonly name: string;\n  readonly presentation?: AgentCanvasPresentation;\n  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;\n}\n\nexport interface LangChainChatModelLike {\n  invoke(input: unknown, options?: unknown): Promise<unknown>;\n  bindTools?(tools: ReadonlyArray<unknown>): LangChainChatModelLike;\n}\n\nexport interface ChatModelFactory<TConfig extends ChatModelConfig = ChatModelConfig> {\n  create(\n    args: Readonly<{ config: TConfig; ctx: NodeExecutionContext<any> }>,\n  ): Promise<LangChainChatModelLike> | LangChainChatModelLike;\n}\n\nexport interface AgentNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends RunnableNodeConfig<\n  TInputJson,\n  TOutputJson\n> {\n  readonly systemMessage: string;\n  readonly userMessageFormatter: (\n    item: Item<TInputJson>,\n    index: number,\n    items: Items<TInputJson>,\n    ctx: NodeExecutionContext<any>,\n  ) => string;\n  readonly chatModel: ChatModelConfig;\n  readonly tools?: ReadonlyArray<ToolConfig>;\n}\n\nexport class AgentConfigInspector {\n  static isAgentNodeConfig(config: NodeConfigBase | undefined): config is AgentNodeConfig<any, any> {\n    if (!config) return false;\n    const candidate = config as Partial<AgentNodeConfig<any, any>>;\n    return (\n      typeof candidate.systemMessage === \"string\" &&\n      typeof candidate.userMessageFormatter === \"function\" &&\n      !!candidate.chatModel\n    );\n  }\n}\n\nexport type AgentAttachmentRole = \"languageModel\" | \"tool\";\n","import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly cursor: NodeRef,\n    private readonly cursorOutput: OutputPortKey,\n  ) {}\n\n  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    (this.wf as any).connect(this.cursor, next, this.cursorOutput);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, next, \"main\");\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, this.cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const makeMerge = (this.wf as any).options?.makeMergeNode as ((name: string) => AnyRunnableNodeConfig) | undefined;\n    if (!makeMerge) {\n      throw new Error(\n        'WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".',\n      );\n    }\n\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(this.cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: this.cursor, endOutput: port };\n      return { end: prev, endOutput: \"main\" };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n\n    const merge = wfAny.add(makeMerge(\"Merge (auto)\")) as NodeRef;\n    wfAny.connect(t.end, merge, t.endOutput, \"true\");\n    wfAny.connect(f.end, merge, f.endOutput, \"false\");\n\n    return new ChainCursor<TCurrentJson>(this.wf, merge, \"main\");\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import { randomUUID } from \"node:crypto\";\n\nimport type { NodeId } from \"../../types\";\n\n/**\n * Unique ids for persisted connection invocation history rows (LLM/tool calls under an owning node).\n */\nexport class ConnectionInvocationIdFactory {\n  static create(): string {\n    return `cinv_${randomUUID()}`;\n  }\n\n  /** Deterministic id for tests when a stable sequence is needed. */\n  static createForTest(runId: string, connectionNodeId: NodeId, sequence: number): string {\n    return `cinv_${runId}_${connectionNodeId}_${sequence}`;\n  }\n}\n","import type { InputPortKey, NodeId, OutputPortKey, WorkflowDefinition, WorkflowGraph } from \"../../types\";\n\nexport class ExecutableGraph implements WorkflowGraph {\n  private readonly outgoingByNodeAndPort = new Map<\n    NodeId,\n    Map<OutputPortKey, Array<Readonly<{ nodeId: NodeId; input: InputPortKey }>>>\n  >();\n\n  constructor(def: WorkflowDefinition) {\n    for (const e of def.edges) {\n      const byPort =\n        this.outgoingByNodeAndPort.get(e.from.nodeId) ??\n        new Map<OutputPortKey, Array<Readonly<{ nodeId: NodeId; input: InputPortKey }>>>();\n      const next = byPort.get(e.from.output) ?? [];\n      next.push({ nodeId: e.to.nodeId, input: e.to.input });\n      byPort.set(e.from.output, next);\n      this.outgoingByNodeAndPort.set(e.from.nodeId, byPort);\n    }\n  }\n\n  next(nodeId: NodeId, output: OutputPortKey): Array<Readonly<{ nodeId: NodeId; input: InputPortKey }>> {\n    return this.outgoingByNodeAndPort.get(nodeId)?.get(output) ?? [];\n  }\n}\n","import type { WorkflowDefinition, WorkflowGraph, WorkflowGraphFactory } from \"../../types\";\nimport { ExecutableGraph } from \"./ExecutableGraph\";\n\nexport class DefaultWorkflowGraphFactory implements WorkflowGraphFactory {\n  create(def: WorkflowDefinition): WorkflowGraph {\n    return new ExecutableGraph(def);\n  }\n}\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n","import type {\n  PersistedRunState,\n  RunId,\n  RunPruneCandidate,\n  RunSummary,\n  WorkflowExecutionListingRepository,\n  WorkflowExecutionPruneRepository,\n  WorkflowExecutionRepository,\n  WorkflowId,\n} from \"../types\";\nimport type { RunEventBus } from \"./runEvents\";\n\nexport class EventPublishingWorkflowExecutionRepository\n  implements WorkflowExecutionRepository, WorkflowExecutionListingRepository, WorkflowExecutionPruneRepository\n{\n  constructor(\n    private readonly inner: WorkflowExecutionRepository,\n    private readonly eventBus: RunEventBus,\n    private readonly now: () => Date = () => new Date(),\n  ) {}\n\n  async createRun(args: Parameters<WorkflowExecutionRepository[\"createRun\"]>[0]): Promise<void> {\n    await this.inner.createRun(args);\n    await this.eventBus.publish({\n      kind: \"runCreated\",\n      runId: args.runId,\n      workflowId: args.workflowId,\n      parent: args.parent,\n      at: this.now().toISOString(),\n    });\n  }\n\n  async load(runId: RunId): Promise<PersistedRunState | undefined> {\n    return await this.inner.load(runId);\n  }\n\n  async save(state: PersistedRunState): Promise<void> {\n    await this.inner.save(state);\n    await this.eventBus.publish({\n      kind: \"runSaved\",\n      runId: state.runId,\n      workflowId: state.workflowId,\n      parent: state.parent,\n      at: this.now().toISOString(),\n      state,\n    });\n  }\n\n  async deleteRun(runId: RunId): Promise<void> {\n    if (!this.inner.deleteRun) return;\n    await this.inner.deleteRun(runId);\n  }\n\n  async listRuns(args?: Readonly<{ workflowId?: WorkflowId; limit?: number }>): Promise<ReadonlyArray<RunSummary>> {\n    const listingRepository = this.inner as unknown as Partial<WorkflowExecutionListingRepository>;\n    if (!listingRepository.listRuns) return [];\n    return await listingRepository.listRuns(args);\n  }\n\n  async listRunsOlderThan(\n    args: Readonly<{ beforeIso: string; limit?: number }>,\n  ): Promise<ReadonlyArray<RunPruneCandidate>> {\n    const pruneRepository = this.inner as unknown as Partial<WorkflowExecutionPruneRepository>;\n    if (!pruneRepository.listRunsOlderThan) return [];\n    return await pruneRepository.listRunsOlderThan(args);\n  }\n}\n","import type { Item, Items } from \"../contracts/workflowTypes\";\nimport { injectable } from \"../di\";\n\n/**\n * Normalizes external inputs into the engine's canonical `Items` shape.\n * Used at host and builder boundaries where callers may provide either a raw value,\n * a single item-like object, or an array of item-like values.\n */\n@injectable()\nexport class ItemsInputNormalizer {\n  normalize(raw: unknown): Items {\n    if (raw === undefined || raw === null) {\n      return [];\n    }\n    if (Array.isArray(raw)) {\n      return raw.map((value) => this.normalizeItem(value));\n    }\n    return [this.normalizeItem(raw)];\n  }\n\n  private normalizeItem(raw: unknown): Item {\n    if (!this.isItem(raw)) {\n      return { json: raw };\n    }\n    return {\n      json: raw.json,\n      ...(raw.binary === undefined ? {} : { binary: raw.binary }),\n      ...(raw.meta === undefined ? {} : { meta: raw.meta }),\n      ...(raw.paired === undefined ? {} : { paired: raw.paired }),\n    };\n  }\n\n  private isItem(raw: unknown): raw is Item {\n    return typeof raw === \"object\" && raw !== null && Object.prototype.hasOwnProperty.call(raw, \"json\");\n  }\n}\n","import type { NoneRetryPolicySpec } from \"./retryPolicySpec.types\";\n\nexport class NoRetryPolicy implements NoneRetryPolicySpec {\n  readonly kind = \"none\" as const;\n}\n","import type { FixedRetryPolicySpec } from \"./retryPolicySpec.types\";\n\nexport class RetryPolicy implements FixedRetryPolicySpec {\n  readonly kind = \"fixed\" as const;\n\n  constructor(\n    public readonly maxAttempts: number,\n    public readonly delayMs: number,\n  ) {\n    if (!Number.isFinite(maxAttempts) || maxAttempts < 1 || !Number.isInteger(maxAttempts)) {\n      throw new Error(`RetryPolicy.maxAttempts must be a positive integer, got ${maxAttempts}`);\n    }\n    if (!Number.isFinite(delayMs) || delayMs < 0) {\n      throw new Error(`RetryPolicy.delayMs must be a non-negative finite number, got ${delayMs}`);\n    }\n  }\n\n  /** Default for HTTP-style transient failures: 3 tries, 1s between attempts. */\n  static readonly defaultForHttp: FixedRetryPolicySpec = { kind: \"fixed\", maxAttempts: 3, delayMs: 1000 };\n\n  /** Default for LLM / agent calls: 3 tries, 2s fixed backoff. */\n  static readonly defaultForAiAgent: FixedRetryPolicySpec = { kind: \"fixed\", maxAttempts: 3, delayMs: 2000 };\n}\n","import type { ExponentialRetryPolicySpec } from \"./retryPolicySpec.types\";\n\nexport class ExpRetryPolicy implements ExponentialRetryPolicySpec {\n  readonly kind = \"exponential\" as const;\n\n  constructor(\n    public readonly maxAttempts: number,\n    public readonly initialDelayMs: number,\n    public readonly multiplier: number,\n    public readonly maxDelayMs?: number,\n    public readonly jitter?: boolean,\n  ) {\n    if (!Number.isFinite(maxAttempts) || maxAttempts < 1 || !Number.isInteger(maxAttempts)) {\n      throw new Error(`ExpRetryPolicy.maxAttempts must be a positive integer, got ${maxAttempts}`);\n    }\n    if (!Number.isFinite(initialDelayMs) || initialDelayMs < 0) {\n      throw new Error(`ExpRetryPolicy.initialDelayMs must be a non-negative finite number, got ${initialDelayMs}`);\n    }\n    if (!Number.isFinite(multiplier) || multiplier < 1) {\n      throw new Error(`ExpRetryPolicy.multiplier must be >= 1, got ${multiplier}`);\n    }\n  }\n}\n","import type { NodeId, WorkflowId } from \"./workflowTypes\";\n\nexport type CredentialTypeId = string;\nexport type CredentialInstanceId = string;\n\nexport type CredentialMaterialSourceKind = \"db\" | \"env\" | \"code\";\nexport type CredentialSetupStatus = \"draft\" | \"ready\";\nexport type CredentialHealthStatus = \"unknown\" | \"healthy\" | \"failing\";\n\nexport type CredentialFieldSchema = Readonly<{\n  key: string;\n  label: string;\n  type: \"string\" | \"password\" | \"textarea\" | \"json\" | \"boolean\";\n  required?: true;\n  order?: number;\n  placeholder?: string;\n  helpText?: string;\n  /** When set, host resolves this field from process.env at runtime; env wins over stored values. */\n  envVarName?: string;\n  /**\n   * When set, the dialog shows a copy action for this exact string (e.g. a static OAuth redirect URI\n   * pattern or documentation URL). Do not use for secret values.\n   */\n  copyValue?: string;\n  /** Accessible label for the copy control (default: Copy). */\n  copyButtonLabel?: string;\n}>;\n\nexport type CredentialRequirement = Readonly<{\n  slotKey: string;\n  label: string;\n  acceptedTypes: ReadonlyArray<CredentialTypeId>;\n  optional?: true;\n  helpText?: string;\n  helpUrl?: string;\n}>;\n\nexport type CredentialBindingKey = Readonly<{\n  workflowId: WorkflowId;\n  nodeId: NodeId;\n  slotKey: string;\n}>;\n\nexport type CredentialBinding = Readonly<{\n  key: CredentialBindingKey;\n  instanceId: CredentialInstanceId;\n  updatedAt: string;\n}>;\n\nexport type CredentialHealth = Readonly<{\n  status: CredentialHealthStatus;\n  message?: string;\n  testedAt?: string;\n  expiresAt?: string;\n  details?: Readonly<Record<string, unknown>>;\n}>;\n\nexport type OAuth2ProviderFromPublicConfig = Readonly<{\n  authorizeUrlFieldKey: string;\n  tokenUrlFieldKey: string;\n  userInfoUrlFieldKey?: string;\n}>;\n\nexport type CredentialOAuth2AuthDefinition = Readonly<\n  | {\n      kind: \"oauth2\";\n      providerId: string;\n      scopes: ReadonlyArray<string>;\n      clientIdFieldKey?: string;\n      clientSecretFieldKey?: string;\n    }\n  | {\n      kind: \"oauth2\";\n      providerFromPublicConfig: OAuth2ProviderFromPublicConfig;\n      scopes: ReadonlyArray<string>;\n      clientIdFieldKey?: string;\n      clientSecretFieldKey?: string;\n    }\n>;\n\nexport type CredentialAuthDefinition = CredentialOAuth2AuthDefinition;\n\nexport type CredentialTypeDefinition = Readonly<{\n  typeId: CredentialTypeId;\n  displayName: string;\n  description?: string;\n  publicFields?: ReadonlyArray<CredentialFieldSchema>;\n  secretFields?: ReadonlyArray<CredentialFieldSchema>;\n  supportedSourceKinds?: ReadonlyArray<CredentialMaterialSourceKind>;\n  auth?: CredentialAuthDefinition;\n}>;\n\n/**\n * JSON-shaped credential field bag (public config, resolved secret material, etc.).\n */\nexport type CredentialJsonRecord = Readonly<Record<string, unknown>>;\n\n/**\n * Persisted credential instance with typed `publicConfig`.\n * Hosts may specialize `secretRef` with a stricter union while remaining\n * assignable here for session/test callbacks.\n */\nexport type CredentialInstanceRecord<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord> = Readonly<{\n  instanceId: CredentialInstanceId;\n  typeId: CredentialTypeId;\n  displayName: string;\n  sourceKind: CredentialMaterialSourceKind;\n  publicConfig: TPublicConfig;\n  secretRef: CredentialJsonRecord;\n  tags: ReadonlyArray<string>;\n  setupStatus: CredentialSetupStatus;\n  createdAt: string;\n  updatedAt: string;\n}>;\n\n/**\n * Arguments passed to `CredentialType.createSession` and `CredentialType.test`.\n * Declare `TPublicConfig` / `TMaterial` on `CredentialType` so implementations are checked\n * against your credential shapes (similar to `NodeExecutionContext.config` for nodes).\n */\nexport type CredentialSessionFactoryArgs<\n  TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord,\n  TMaterial extends CredentialJsonRecord = CredentialJsonRecord,\n> = Readonly<{\n  instance: CredentialInstanceRecord<TPublicConfig>;\n  material: TMaterial;\n  publicConfig: TPublicConfig;\n}>;\n\nexport type CredentialSessionFactory<\n  TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord,\n  TMaterial extends CredentialJsonRecord = CredentialJsonRecord,\n  TSession = unknown,\n> = (args: CredentialSessionFactoryArgs<TPublicConfig, TMaterial>) => Promise<TSession>;\n\nexport type CredentialHealthTester<\n  TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord,\n  TMaterial extends CredentialJsonRecord = CredentialJsonRecord,\n> = (args: CredentialSessionFactoryArgs<TPublicConfig, TMaterial>) => Promise<CredentialHealth>;\n\n/**\n * Full credential type implementation: `definition` (UI/schema), `createSession`, and `test`.\n * Use this at registration and config boundaries; `CredentialTypeDefinition` is only the schema slice.\n */\nexport type CredentialType<\n  TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord,\n  TMaterial extends CredentialJsonRecord = CredentialJsonRecord,\n  TSession = unknown,\n> = Readonly<{\n  definition: CredentialTypeDefinition;\n  createSession: CredentialSessionFactory<TPublicConfig, TMaterial, TSession>;\n  test: CredentialHealthTester<TPublicConfig, TMaterial>;\n}>;\n\n/**\n * Credential type with unspecified generics — used for `CodemationConfig.credentialTypes`, the host registry,\n * and anywhere a concrete `CredentialType<YourPublic, YourMaterial, YourSession>` is placed in a heterogeneous list.\n * Using `any` here avoids unsafe `as` casts while keeping typed `satisfies CredentialType<…>` definitions.\n */\nexport type AnyCredentialType = CredentialType<any, any, unknown>;\n\nexport interface CredentialSessionService {\n  getSession<TSession = unknown>(\n    args: Readonly<{\n      workflowId: WorkflowId;\n      nodeId: NodeId;\n      slotKey: string;\n    }>,\n  ): Promise<TSession>;\n}\n\nexport interface CredentialTypeRegistry {\n  listTypes(): ReadonlyArray<CredentialTypeDefinition>;\n  getType(typeId: CredentialTypeId): CredentialTypeDefinition | undefined;\n}\n\nexport class CredentialUnboundError extends Error {\n  constructor(\n    public readonly bindingKey: CredentialBindingKey,\n    public readonly acceptedTypes: ReadonlyArray<CredentialTypeId> = [],\n  ) {\n    super(CredentialUnboundError.createMessage(bindingKey, acceptedTypes));\n    this.name = \"CredentialUnboundError\";\n  }\n\n  private static createMessage(\n    bindingKey: CredentialBindingKey,\n    acceptedTypes: ReadonlyArray<CredentialTypeId>,\n  ): string {\n    const acceptedTypesSuffix =\n      acceptedTypes.length > 0 ? ` Accepted credential types: ${acceptedTypes.join(\", \")}.` : \"\";\n    return `Credential slot \"${bindingKey.slotKey}\" is not bound for workflow ${bindingKey.workflowId} node ${bindingKey.nodeId}.${acceptedTypesSuffix}`;\n  }\n}\n","import type { TypeToken } from \"../di\";\nimport type { CredentialRequirement } from \"./credentialTypes\";\nimport type { RetryPolicySpec } from \"./retryPolicySpec.types\";\n\nexport type WorkflowId = string;\nexport type NodeId = string;\nexport type OutputPortKey = string;\nexport type InputPortKey = string;\nexport type PersistedTokenId = string;\n\nexport type NodeKind = \"trigger\" | \"node\";\nexport type JsonPrimitive = string | number | boolean | null;\nexport interface JsonObject {\n  readonly [key: string]: JsonValue;\n}\nexport type JsonValue = JsonPrimitive | JsonObject | JsonArray;\nexport type JsonArray = ReadonlyArray<JsonValue>;\n\nexport interface Edge {\n  from: { nodeId: NodeId; output: OutputPortKey };\n  to: { nodeId: NodeId; input: InputPortKey };\n}\n\nexport type NodeConnectionName = string;\n\n/**\n * Named connection from an executable parent node to child nodes that exist in {@link WorkflowDefinition.nodes}\n * but are not traversed by the main execution graph.\n */\nexport interface WorkflowNodeConnection {\n  readonly parentNodeId: NodeId;\n  readonly connectionName: NodeConnectionName;\n  readonly childNodeIds: ReadonlyArray<NodeId>;\n}\n\nexport interface WorkflowDefinition {\n  id: WorkflowId;\n  name: string;\n  nodes: NodeDefinition[];\n  edges: Edge[];\n  /**\n   * Optional metadata: which nodes are connection-owned children (e.g. AI agent `llm` / `tools` slots).\n   * When omitted, all nodes in {@link nodes} are treated as executable for topology.\n   */\n  readonly connections?: ReadonlyArray<WorkflowNodeConnection>;\n  /** Directory + file-stem path under a workflow discovery root (for UI grouping only). */\n  discoveryPathSegments?: readonly string[];\n  /** Retention for run JSON and binaries (seconds). Host/env may supply defaults when omitted. */\n  readonly prunePolicy?: WorkflowPrunePolicySpec;\n  /** Whether to keep run data after completion. Host/env may supply defaults when omitted. */\n  readonly storagePolicy?: WorkflowStoragePolicySpec;\n  /** Invoked after a node fails permanently (retries exhausted) and node error handler did not recover. */\n  readonly workflowErrorHandler?: WorkflowErrorHandlerSpec;\n}\n\nexport interface WorkflowGraph {\n  next(nodeId: NodeId, output: OutputPortKey): ReadonlyArray<Readonly<{ nodeId: NodeId; input: InputPortKey }>>;\n}\n\nexport interface WorkflowGraphFactory {\n  create(def: WorkflowDefinition): WorkflowGraph;\n}\n\nexport interface NodeConfigBase {\n  readonly kind: NodeKind;\n  readonly type: TypeToken<unknown>;\n  readonly name?: string;\n  readonly id?: NodeId;\n  readonly icon?: string;\n  readonly execution?: Readonly<{ hint?: \"local\" | \"worker\"; queue?: string }>;\n  /** In-process execute retries (runnable nodes). Triggers typically omit this. */\n  readonly retryPolicy?: RetryPolicySpec;\n  /** Recover from execute failures; return outputs to continue, or rethrow to fail the node. */\n  readonly nodeErrorHandler?: NodeErrorHandlerSpec;\n  /**\n   * When true, edges carrying zero items on an output port still schedule single-input downstream nodes.\n   * Decided from the **source** node that produced the (empty) output. Default (false/undefined): empty\n   * main batches skip downstream execution and propagate the empty path.\n   */\n  readonly continueWhenEmptyOutput?: boolean;\n  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;\n}\n\nexport declare const runnableNodeInputType: unique symbol;\nexport declare const runnableNodeOutputType: unique symbol;\nexport declare const triggerNodeOutputType: unique symbol;\n\nexport interface RunnableNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends NodeConfigBase {\n  readonly kind: \"node\";\n  readonly [runnableNodeInputType]?: TInputJson;\n  readonly [runnableNodeOutputType]?: TOutputJson;\n}\n\nexport declare const triggerNodeSetupStateType: unique symbol;\n\nexport interface TriggerNodeConfig<\n  TOutputJson = unknown,\n  TSetupState extends JsonValue | undefined = undefined,\n> extends NodeConfigBase {\n  readonly kind: \"trigger\";\n  readonly [triggerNodeOutputType]?: TOutputJson;\n  readonly [triggerNodeSetupStateType]?: TSetupState;\n}\n\nexport type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any>> =\n  TConfig extends RunnableNodeConfig<infer TInputJson, any> ? TInputJson : never;\n\nexport type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any>> =\n  TConfig extends RunnableNodeConfig<any, infer TOutputJson> ? TOutputJson : never;\n\nexport type TriggerNodeOutputJson<TConfig extends TriggerNodeConfig<any, any>> =\n  TConfig extends TriggerNodeConfig<infer TOutputJson, any> ? TOutputJson : never;\n\nexport type TriggerNodeSetupState<TConfig extends TriggerNodeConfig<any, any>> =\n  TConfig extends TriggerNodeConfig<any, infer TSetupState> ? TSetupState : never;\n\nexport interface NodeDefinition {\n  id: NodeId;\n  kind: NodeKind;\n  type: TypeToken<unknown>;\n  name?: string;\n  config: NodeConfigBase;\n}\n\nexport interface NodeRef {\n  id: NodeId;\n  kind: NodeKind;\n  name?: string;\n}\n\nexport type PairedItemRef = Readonly<{ nodeId: NodeId; output: OutputPortKey; itemIndex: number }>;\n\nexport type BinaryPreviewKind = \"image\" | \"audio\" | \"video\" | \"download\";\n\nexport type BinaryAttachment = Readonly<{\n  id: string;\n  storageKey: string;\n  mimeType: string;\n  size: number;\n  storageDriver: string;\n  previewKind: BinaryPreviewKind;\n  createdAt: string;\n  runId: RunId;\n  workflowId: WorkflowId;\n  nodeId: NodeId;\n  activationId: NodeActivationId;\n  filename?: string;\n  sha256?: string;\n}>;\n\nexport type ItemBinary = Readonly<Record<string, BinaryAttachment>>;\n\nexport type Item<TJson = unknown> = Readonly<{\n  json: TJson;\n  binary?: ItemBinary;\n  meta?: Readonly<Record<string, unknown>>;\n  paired?: ReadonlyArray<PairedItemRef>;\n}>;\n\nexport type Items<TJson = unknown> = ReadonlyArray<Item<TJson>>;\n\nexport type NodeOutputs = Partial<Record<OutputPortKey, Items>>;\n\nexport type RunId = string;\nexport type NodeActivationId = string;\n\nexport interface ParentExecutionRef {\n  runId: RunId;\n  workflowId: WorkflowId;\n  nodeId: NodeId;\n  /** Subworkflow depth of the **spawning** run (0 = root). Passed when starting a child run. */\n  subworkflowDepth?: number;\n  /** Effective max node activations from the parent run (propagated to child policy merge). */\n  engineMaxNodeActivations?: number;\n  /** Effective max subworkflow depth from the parent run (propagated to child policy merge). */\n  engineMaxSubworkflowDepth?: number;\n}\n\nexport interface RunDataSnapshot {\n  getOutputs(nodeId: NodeId): NodeOutputs | undefined;\n  getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;\n  getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;\n}\n\nexport interface MutableRunData extends RunDataSnapshot {\n  setOutputs(nodeId: NodeId, outputs: NodeOutputs): void;\n  dump(): Record<NodeId, NodeOutputs>;\n}\n\nexport interface RunDataFactory {\n  create(initial?: Record<NodeId, NodeOutputs>): MutableRunData;\n}\n\nexport interface RunIdFactory {\n  makeRunId(): RunId;\n}\n\nexport interface ActivationIdFactory {\n  makeActivationId(): NodeActivationId;\n}\n\nexport type UpstreamRefPlaceholder = `$${number}`;\nexport const branchRef = (index: number) => `$${index}` as UpstreamRefPlaceholder;\n\nexport type ExecutionMode = \"local\" | \"worker\";\n\nexport interface NodeSchedulerDecision {\n  mode: ExecutionMode;\n  queue?: string;\n}\n\nexport interface NodeOffloadPolicy {\n  decide(args: { workflowId: WorkflowId; nodeId: NodeId; config: NodeConfigBase }): NodeSchedulerDecision;\n}\n\n/** Whether to persist run execution data after the workflow finishes. */\nexport type WorkflowStoragePolicyMode = \"ALL\" | \"SUCCESS\" | \"ERROR\" | \"NEVER\";\n\nexport type WorkflowStoragePolicySpec = WorkflowStoragePolicyMode | TypeToken<WorkflowStoragePolicyResolver>;\n\nexport interface WorkflowStoragePolicyResolver {\n  shouldPersist(args: WorkflowStoragePolicyDecisionArgs): boolean | Promise<boolean>;\n}\n\nexport interface WorkflowStoragePolicyDecisionArgs {\n  readonly runId: RunId;\n  readonly workflowId: WorkflowId;\n  readonly workflow: WorkflowDefinition;\n  readonly finalStatus: \"completed\" | \"failed\";\n  readonly startedAt: string;\n  readonly finishedAt: string;\n}\n\nexport interface WorkflowPrunePolicySpec {\n  readonly runDataRetentionSeconds?: number;\n  readonly binaryRetentionSeconds?: number;\n}\n\nexport interface PersistedRunPolicySnapshot {\n  readonly retentionSeconds?: number;\n  readonly binaryRetentionSeconds?: number;\n  readonly storagePolicy: WorkflowStoragePolicyMode;\n}\n\nexport interface WorkflowErrorHandler {\n  onError(ctx: WorkflowErrorContext): void | Promise<void>;\n}\n\nexport interface WorkflowErrorContext {\n  readonly runId: RunId;\n  readonly workflowId: WorkflowId;\n  readonly workflow: WorkflowDefinition;\n  readonly failedNodeId: NodeId;\n  readonly error: Error;\n  readonly startedAt: string;\n  readonly finishedAt: string;\n}\n\nexport type WorkflowErrorHandlerSpec = TypeToken<WorkflowErrorHandler> | WorkflowErrorHandler;\n\nexport interface NodeErrorHandlerArgs<TConfig extends NodeConfigBase = NodeConfigBase> {\n  readonly kind: \"single\" | \"multi\";\n  readonly items: Items;\n  readonly inputsByPort: Readonly<Record<InputPortKey, Items>> | undefined;\n  readonly ctx: import(\"./runtimeTypes\").NodeExecutionContext<TConfig>;\n  readonly error: Error;\n}\n\nexport interface NodeErrorHandler {\n  handle<TConfig extends NodeConfigBase>(args: NodeErrorHandlerArgs<TConfig>): Promise<NodeOutputs>;\n}\n\nexport type NodeErrorHandlerSpec = TypeToken<NodeErrorHandler> | NodeErrorHandler;\n\n/** Runtime defaults when workflow omits prune/storage fields (typically from host env). */\nexport interface WorkflowPolicyRuntimeDefaults {\n  readonly retentionSeconds?: number;\n  readonly binaryRetentionSeconds?: number;\n  readonly storagePolicy?: WorkflowStoragePolicyMode;\n}\n","import type { WorkflowId } from \"./workflowTypes\";\n\n/**\n * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes\n * for that workflow are not registered (see engine trigger runtime + webhook matcher).\n */\nexport interface WorkflowActivationPolicy {\n  isActive(workflowId: WorkflowId): boolean;\n}\n\n/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */\nexport class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {\n  isActive(_workflowId: WorkflowId): boolean {\n    return true;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["name: string","node: TNodeConfig","node","node","messages: AgentMessageDto[]","wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","cursor: NodeRef","cursorOutput: OutputPortKey","port: OutputPortKey","prev: NodeRef | null","meta: { id: WorkflowId; name: string }","options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>","onClose: () => void","inner: WorkflowExecutionRepository","eventBus: RunEventBus","now: () => Date","ItemsInputNormalizer","maxAttempts: number","delayMs: number","maxAttempts: number","initialDelayMs: number","multiplier: number","maxDelayMs?: number","jitter?: boolean","bindingKey: CredentialBindingKey","acceptedTypes: ReadonlyArray<CredentialTypeId>"],"sources":["../src/contracts/Clock.ts","../src/ai/NodeBackedToolConfig.ts","../src/ai/AgentToolFactory.ts","../src/ai/AgentMessageConfigNormalizerFactory.ts","../src/ai/AgentConfigInspectorFactory.ts","../src/ai/AiHost.ts","../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/workflow/definition/ConnectionInvocationIdFactory.ts","../src/workflow/graph/ExecutableGraph.ts","../src/workflow/graph/DefaultWorkflowGraphFactory.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts","../src/events/EventPublishingWorkflowExecutionRepository.ts","../src/serialization/ItemsInputNormalizer.ts","../src/contracts/NoRetryPolicy.ts","../src/contracts/RetryPolicy.ts","../src/contracts/ExpRetryPolicy.ts","../src/contracts/credentialTypes.ts","../src/contracts/workflowTypes.ts","../src/contracts/workflowActivationPolicy.ts"],"sourcesContent":["/** Port for time; inject `SystemClock` in production and a fake/test clock in tests. */\nexport interface Clock {\n  now(): Date;\n}\n\nexport class SystemClock implements Clock {\n  now(): Date {\n    return new Date();\n  }\n}\n","import type { CredentialRequirement } from \"../contracts/credentialTypes\";\nimport type { TypeToken } from \"../di\";\nimport type { Item, NodeOutputs, RunnableNodeConfig, RunnableNodeInputJson } from \"../types\";\nimport type { input as ZodInput, output as ZodOutput } from \"zod\";\nimport type {\n  AgentCanvasPresentation,\n  NodeBackedToolConfigOptions,\n  NodeBackedToolInputMapper,\n  NodeBackedToolInputMapperArgs,\n  NodeBackedToolOutputMapper,\n  NodeBackedToolOutputMapperArgs,\n  ToolConfig,\n  ZodSchemaAny,\n} from \"./AiHost\";\n\nexport class NodeBackedToolConfig<\n  TNodeConfig extends RunnableNodeConfig<any, any>,\n  TInputSchema extends ZodSchemaAny,\n  TOutputSchema extends ZodSchemaAny,\n> implements ToolConfig {\n  readonly type: TypeToken<unknown>;\n  readonly toolKind = \"nodeBacked\" as const;\n  readonly description?: string;\n  readonly presentation?: AgentCanvasPresentation;\n  private readonly inputSchemaValue: TInputSchema;\n  private readonly outputSchemaValue: TOutputSchema;\n  private readonly mapInputValue?: NodeBackedToolInputMapper<TNodeConfig, ZodInput<TInputSchema>>;\n  private readonly mapOutputValue?: NodeBackedToolOutputMapper<\n    TNodeConfig,\n    ZodInput<TInputSchema>,\n    ZodOutput<TOutputSchema>\n  >;\n\n  constructor(\n    public readonly name: string,\n    public readonly node: TNodeConfig,\n    options: NodeBackedToolConfigOptions<TNodeConfig, TInputSchema, TOutputSchema>,\n  ) {\n    this.type = node.type;\n    this.description = options.description;\n    this.presentation = options.presentation;\n    this.inputSchemaValue = options.inputSchema;\n    this.outputSchemaValue = options.outputSchema;\n    this.mapInputValue = options.mapInput;\n    this.mapOutputValue = options.mapOutput;\n  }\n\n  getCredentialRequirements(): ReadonlyArray<CredentialRequirement> {\n    return this.node.getCredentialRequirements?.() ?? [];\n  }\n\n  getInputSchema(): TInputSchema {\n    return this.inputSchemaValue;\n  }\n\n  getOutputSchema(): TOutputSchema {\n    return this.outputSchemaValue;\n  }\n\n  toNodeItem(\n    args: NodeBackedToolInputMapperArgs<TNodeConfig, ZodInput<TInputSchema>>,\n  ): Item<RunnableNodeInputJson<TNodeConfig>> {\n    const mapped = this.mapInputValue?.(args) ?? (args.input as RunnableNodeInputJson<TNodeConfig>);\n    if (this.isItem(mapped)) {\n      return mapped;\n    }\n    return { json: mapped };\n  }\n\n  toToolOutput(args: NodeBackedToolOutputMapperArgs<TNodeConfig, ZodInput<TInputSchema>>): ZodOutput<TOutputSchema> {\n    const raw = this.mapOutputValue?.(args) ?? this.readDefaultToolOutput(args.outputs);\n    return this.outputSchemaValue.parse(raw) as ZodOutput<TOutputSchema>;\n  }\n\n  private readDefaultToolOutput(outputs: NodeOutputs): unknown {\n    const firstMainItem = outputs.main?.[0];\n    if (!firstMainItem) {\n      throw new Error(`Node-backed tool \"${this.name}\" did not produce a main output item.`);\n    }\n    return firstMainItem.json;\n  }\n\n  private isItem(value: unknown): value is Item {\n    return typeof value === \"object\" && value !== null && \"json\" in value;\n  }\n}\n","import type { RunnableNodeConfig } from \"../types\";\nimport type { NodeBackedToolConfigOptions, ZodSchemaAny } from \"./AiHost\";\nimport { NodeBackedToolConfig } from \"./NodeBackedToolConfig\";\n\nclass AgentToolFactoryImpl {\n  asTool<\n    TNodeConfig extends RunnableNodeConfig<any, any>,\n    TInputSchema extends ZodSchemaAny,\n    TOutputSchema extends ZodSchemaAny,\n  >(\n    node: TNodeConfig,\n    options: Readonly<{ name?: string } & NodeBackedToolConfigOptions<TNodeConfig, TInputSchema, TOutputSchema>>,\n  ): NodeBackedToolConfig<TNodeConfig, TInputSchema, TOutputSchema> {\n    return new NodeBackedToolConfig(options.name ?? node.name ?? \"tool\", node, options);\n  }\n}\n\nexport const AgentToolFactory = new AgentToolFactoryImpl();\n","import type {\n  AgentMessageBuildArgs,\n  AgentMessageConfig,\n  AgentMessageDto,\n  AgentMessageLine,\n  AgentNodeConfig,\n} from \"./AiHost\";\n\nexport class AgentMessageConfigNormalizer {\n  static normalize<TInputJson, TOutputJson>(\n    config: AgentNodeConfig<TInputJson, TOutputJson>,\n    args: AgentMessageBuildArgs<TInputJson>,\n  ): ReadonlyArray<AgentMessageDto> {\n    const fromMessages = this.normalizeRichMessages(config.messages, args);\n    if (fromMessages.length > 0) {\n      return fromMessages;\n    }\n    throw new Error(\n      \"AIAgent messages must be a non-empty array, or an object with a non-empty prompt array and/or buildMessages that returns messages.\",\n    );\n  }\n\n  private static normalizeRichMessages<TInputJson>(\n    config: AgentMessageConfig<TInputJson>,\n    args: AgentMessageBuildArgs<TInputJson>,\n  ): ReadonlyArray<AgentMessageDto> {\n    if (Array.isArray(config)) {\n      return config.map((line) => this.lineToDto(line, args));\n    }\n    const structured = config as {\n      readonly prompt?: ReadonlyArray<AgentMessageLine<TInputJson>>;\n      readonly buildMessages?: (a: AgentMessageBuildArgs<TInputJson>) => ReadonlyArray<AgentMessageDto>;\n    };\n    const messages: AgentMessageDto[] = [];\n    for (const line of structured.prompt ?? []) {\n      messages.push(this.lineToDto(line, args));\n    }\n    for (const message of structured.buildMessages?.(args) ?? []) {\n      messages.push(message);\n    }\n    return messages;\n  }\n\n  private static lineToDto<TInputJson>(\n    line: AgentMessageLine<TInputJson>,\n    args: AgentMessageBuildArgs<TInputJson>,\n  ): AgentMessageDto {\n    const content = typeof line.content === \"function\" ? line.content(args) : line.content;\n    return { role: line.role, content };\n  }\n}\n","import type { NodeConfigBase } from \"../types\";\nimport type { AgentNodeConfig } from \"./AiHost\";\n\nexport class AgentConfigInspector {\n  static isAgentNodeConfig(config: NodeConfigBase | undefined): config is AgentNodeConfig<any, any> {\n    if (!config) return false;\n    const candidate = config as Partial<AgentNodeConfig<any, any>>;\n    return !!candidate.chatModel && this.hasCompatibleMessageConfiguration(candidate);\n  }\n\n  private static hasCompatibleMessageConfiguration(candidate: Partial<AgentNodeConfig<any, any>>): boolean {\n    const messages = candidate.messages;\n    if (messages === undefined || messages === null) {\n      return false;\n    }\n    if (Array.isArray(messages)) {\n      return messages.length > 0;\n    }\n    if (typeof messages === \"object\") {\n      const o = messages as { prompt?: unknown; buildMessages?: unknown };\n      return (Array.isArray(o.prompt) && o.prompt.length > 0) || typeof o.buildMessages === \"function\";\n    }\n    return false;\n  }\n}\n","import type { TypeToken } from \"../di\";\n\nimport type { CredentialRequirement } from \"../contracts/credentialTypes\";\n\nimport type {\n  Item,\n  Items,\n  JsonValue,\n  NodeExecutionContext,\n  NodeOutputs,\n  RunnableNodeConfig,\n  RunnableNodeInputJson,\n} from \"../types\";\n\nimport type { input as ZodInput, output as ZodOutput, ZodType } from \"zod\";\n\nexport interface AgentCanvasPresentation<TIcon extends string = string> {\n  readonly label?: string;\n  readonly icon?: TIcon;\n}\n\nexport type ZodSchemaAny = ZodType<any, any, any>;\n\nexport interface ToolConfig {\n  readonly type: TypeToken<unknown>;\n  readonly name: string;\n  readonly description?: string;\n  readonly presentation?: AgentCanvasPresentation;\n  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;\n}\n\nexport type ToolExecuteArgs<TConfig extends ToolConfig = ToolConfig, TInput = unknown> = Readonly<{\n  config: TConfig;\n  input: TInput;\n  ctx: NodeExecutionContext<any>;\n  item: Item;\n  itemIndex: number;\n  items: Items;\n}>;\n\nexport interface Tool<\n  TConfig extends ToolConfig = ToolConfig,\n  TInputSchema extends ZodSchemaAny = ZodSchemaAny,\n  TOutputSchema extends ZodSchemaAny = ZodSchemaAny,\n> {\n  readonly defaultDescription: string;\n  readonly inputSchema: TInputSchema;\n  readonly outputSchema: TOutputSchema;\n  execute(\n    args: ToolExecuteArgs<TConfig, ZodInput<TInputSchema>>,\n  ): Promise<ZodOutput<TOutputSchema>> | ZodOutput<TOutputSchema>;\n}\n\nexport type AgentTool<\n  TInputSchema extends ZodSchemaAny = ZodSchemaAny,\n  TOutputSchema extends ZodSchemaAny = ZodSchemaAny,\n> = Tool<ToolConfig, TInputSchema, TOutputSchema>;\n\nexport type AgentToolExecuteArgs<TInput = unknown> = ToolExecuteArgs<ToolConfig, TInput>;\n\nexport type AgentToolToken = TypeToken<Tool<ToolConfig, ZodSchemaAny, ZodSchemaAny>>;\n\nexport type AgentMessageRole = \"system\" | \"user\" | \"assistant\";\n\nexport type AgentMessageBuildArgs<TInputJson = unknown> = Readonly<{\n  item: Item<TInputJson>;\n  itemIndex: number;\n  items: Items<TInputJson>;\n  ctx: NodeExecutionContext<any>;\n}>;\n\nexport interface AgentMessageDto {\n  readonly role: AgentMessageRole;\n  readonly content: string;\n}\n\nexport type AgentMessageTemplateContent<TInputJson = unknown> =\n  | string\n  | ((args: AgentMessageBuildArgs<TInputJson>) => string);\n\nexport interface AgentMessageTemplate<TInputJson = unknown> {\n  readonly role: AgentMessageRole;\n  readonly content: AgentMessageTemplateContent<TInputJson>;\n}\n\n/** A single prompt line: fixed DTO or template with optional function `content`. */\nexport type AgentMessageLine<TInputJson = unknown> = AgentMessageDto | AgentMessageTemplate<TInputJson>;\n\n/**\n * Message list for an agent. Prefer a **plain array** of `{ role, content }` (optionally with function `content` for templates).\n * Use the object form only when you need `buildMessages` to append messages after optional `prompt` lines.\n */\nexport type AgentMessageConfig<TInputJson = unknown> =\n  | ReadonlyArray<AgentMessageLine<TInputJson>>\n  | {\n      readonly prompt?: ReadonlyArray<AgentMessageLine<TInputJson>>;\n      readonly buildMessages?: (args: AgentMessageBuildArgs<TInputJson>) => ReadonlyArray<AgentMessageDto>;\n    };\n\nexport type AgentTurnLimitBehavior = \"error\" | \"respondWithLastMessage\";\n\nexport interface AgentModelInvocationOptions {\n  readonly maxTokens?: number;\n  readonly providerOptions?: Readonly<Record<string, JsonValue>>;\n}\n\nexport interface AgentGuardrailConfig {\n  readonly maxTurns?: number;\n  readonly onTurnLimitReached?: AgentTurnLimitBehavior;\n  readonly modelInvocationOptions?: AgentModelInvocationOptions;\n}\n\n/** Defaults aligned with common tool-agent iteration limits (many products use ~10 max rounds). */\nexport const AgentGuardrailDefaults = {\n  maxTurns: 10,\n  onTurnLimitReached: \"error\" as AgentTurnLimitBehavior,\n} as const;\n\nexport interface AgentToolDefinition {\n  readonly name: string;\n  readonly description: string;\n  readonly inputSchema: ZodSchemaAny;\n}\n\nexport type AgentToolCall = Readonly<{ id?: string; name: string; input: unknown }>;\n\nexport type AgentToolCallPlanner<_TNodeConfig = unknown> = (\n  item: Item,\n  index: number,\n  items: Items,\n  ctx: NodeExecutionContext<any>,\n) => ReadonlyArray<AgentToolCall>;\n\nexport interface ChatModelConfig {\n  readonly type: TypeToken<ChatModelFactory<ChatModelConfig>>;\n  readonly name: string;\n  readonly presentation?: AgentCanvasPresentation;\n  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;\n}\n\nexport interface LangChainChatModelLike {\n  invoke(input: unknown, options?: unknown): Promise<unknown>;\n  bindTools?(tools: ReadonlyArray<unknown>): LangChainChatModelLike;\n}\n\nexport interface ChatModelFactory<TConfig extends ChatModelConfig = ChatModelConfig> {\n  create(\n    args: Readonly<{ config: TConfig; ctx: NodeExecutionContext<any> }>,\n  ): Promise<LangChainChatModelLike> | LangChainChatModelLike;\n}\n\nexport type NodeBackedToolInputMapperArgs<\n  TNodeConfig extends RunnableNodeConfig<any, any>,\n  TToolInput = unknown,\n> = Readonly<{\n  input: TToolInput;\n  item: Item;\n  itemIndex: number;\n  items: Items;\n  ctx: NodeExecutionContext<any>;\n  node: TNodeConfig;\n}>;\n\nexport type NodeBackedToolOutputMapperArgs<\n  TNodeConfig extends RunnableNodeConfig<any, any>,\n  TToolInput = unknown,\n> = Readonly<{\n  input: TToolInput;\n  item: Item;\n  itemIndex: number;\n  items: Items;\n  ctx: NodeExecutionContext<any>;\n  node: TNodeConfig;\n  outputs: NodeOutputs;\n}>;\n\nexport type NodeBackedToolInputMapper<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown> = (\n  args: NodeBackedToolInputMapperArgs<TNodeConfig, TToolInput>,\n) => Item<RunnableNodeInputJson<TNodeConfig>> | RunnableNodeInputJson<TNodeConfig>;\n\nexport type NodeBackedToolOutputMapper<\n  TNodeConfig extends RunnableNodeConfig<any, any>,\n  TToolInput = unknown,\n  TToolOutput = unknown,\n> = (args: NodeBackedToolOutputMapperArgs<TNodeConfig, TToolInput>) => TToolOutput;\n\nexport type NodeBackedToolConfigOptions<\n  TNodeConfig extends RunnableNodeConfig<any, any>,\n  TInputSchema extends ZodSchemaAny,\n  TOutputSchema extends ZodSchemaAny,\n> = Readonly<{\n  description?: string;\n  presentation?: AgentCanvasPresentation;\n  inputSchema: TInputSchema;\n  outputSchema: TOutputSchema;\n  mapInput?: NodeBackedToolInputMapper<TNodeConfig, ZodInput<TInputSchema>>;\n  mapOutput?: NodeBackedToolOutputMapper<TNodeConfig, ZodInput<TInputSchema>, ZodOutput<TOutputSchema>>;\n}>;\n\nexport interface AgentNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends RunnableNodeConfig<\n  TInputJson,\n  TOutputJson\n> {\n  readonly messages: AgentMessageConfig<TInputJson>;\n  readonly chatModel: ChatModelConfig;\n  readonly tools?: ReadonlyArray<ToolConfig>;\n  readonly guardrails?: AgentGuardrailConfig;\n}\n\nexport type AgentAttachmentRole = \"languageModel\" | \"tool\";\n\nexport { NodeBackedToolConfig } from \"./NodeBackedToolConfig\";\nexport { AgentToolFactory } from \"./AgentToolFactory\";\nexport { AgentMessageConfigNormalizer } from \"./AgentMessageConfigNormalizerFactory\";\nexport { AgentConfigInspector } from \"./AgentConfigInspectorFactory\";\n","import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly cursor: NodeRef,\n    private readonly cursorOutput: OutputPortKey,\n  ) {}\n\n  then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    (this.wf as any).connect(this.cursor, next, this.cursorOutput);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, next, \"main\");\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, this.cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const makeMerge = (this.wf as any).options?.makeMergeNode as ((name: string) => AnyRunnableNodeConfig) | undefined;\n    if (!makeMerge) {\n      throw new Error(\n        'WorkflowBuilder is missing options.makeMergeNode (required for when({true,false}). Use createWorkflowBuilder from \"@codemation/core-nodes\".',\n      );\n    }\n\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(this.cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: this.cursor, endOutput: port };\n      return { end: prev, endOutput: \"main\" };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n\n    const merge = wfAny.add(makeMerge(\"Merge (auto)\")) as NodeRef;\n    wfAny.connect(t.end, merge, t.endOutput, \"true\");\n    wfAny.connect(f.end, merge, f.endOutput, \"false\");\n\n    return new ChainCursor<TCurrentJson>(this.wf, merge, \"main\");\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<{\n      makeMergeNode?: (name: string) => AnyRunnableNodeConfig;\n    }>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, ref, \"main\");\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import { randomUUID } from \"node:crypto\";\n\nimport type { NodeId } from \"../../types\";\n\n/**\n * Unique ids for persisted connection invocation history rows (LLM/tool calls under an owning node).\n */\nexport class ConnectionInvocationIdFactory {\n  static create(): string {\n    return `cinv_${randomUUID()}`;\n  }\n\n  /** Deterministic id for tests when a stable sequence is needed. */\n  static createForTest(runId: string, connectionNodeId: NodeId, sequence: number): string {\n    return `cinv_${runId}_${connectionNodeId}_${sequence}`;\n  }\n}\n","import type { InputPortKey, NodeId, OutputPortKey, WorkflowDefinition, WorkflowGraph } from \"../../types\";\n\nexport class ExecutableGraph implements WorkflowGraph {\n  private readonly outgoingByNodeAndPort = new Map<\n    NodeId,\n    Map<OutputPortKey, Array<Readonly<{ nodeId: NodeId; input: InputPortKey }>>>\n  >();\n\n  constructor(def: WorkflowDefinition) {\n    for (const e of def.edges) {\n      const byPort =\n        this.outgoingByNodeAndPort.get(e.from.nodeId) ??\n        new Map<OutputPortKey, Array<Readonly<{ nodeId: NodeId; input: InputPortKey }>>>();\n      const next = byPort.get(e.from.output) ?? [];\n      next.push({ nodeId: e.to.nodeId, input: e.to.input });\n      byPort.set(e.from.output, next);\n      this.outgoingByNodeAndPort.set(e.from.nodeId, byPort);\n    }\n  }\n\n  next(nodeId: NodeId, output: OutputPortKey): Array<Readonly<{ nodeId: NodeId; input: InputPortKey }>> {\n    return this.outgoingByNodeAndPort.get(nodeId)?.get(output) ?? [];\n  }\n}\n","import type { WorkflowDefinition, WorkflowGraph, WorkflowGraphFactory } from \"../../types\";\nimport { ExecutableGraph } from \"./ExecutableGraph\";\n\nexport class DefaultWorkflowGraphFactory implements WorkflowGraphFactory {\n  create(def: WorkflowDefinition): WorkflowGraph {\n    return new ExecutableGraph(def);\n  }\n}\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n","import type {\n  PersistedRunState,\n  RunId,\n  RunPruneCandidate,\n  RunSummary,\n  WorkflowExecutionListingRepository,\n  WorkflowExecutionPruneRepository,\n  WorkflowExecutionRepository,\n  WorkflowId,\n} from \"../types\";\nimport type { RunEventBus } from \"./runEvents\";\n\nexport class EventPublishingWorkflowExecutionRepository\n  implements WorkflowExecutionRepository, WorkflowExecutionListingRepository, WorkflowExecutionPruneRepository\n{\n  constructor(\n    private readonly inner: WorkflowExecutionRepository,\n    private readonly eventBus: RunEventBus,\n    private readonly now: () => Date = () => new Date(),\n  ) {}\n\n  async createRun(args: Parameters<WorkflowExecutionRepository[\"createRun\"]>[0]): Promise<void> {\n    await this.inner.createRun(args);\n    await this.eventBus.publish({\n      kind: \"runCreated\",\n      runId: args.runId,\n      workflowId: args.workflowId,\n      parent: args.parent,\n      at: this.now().toISOString(),\n    });\n  }\n\n  async load(runId: RunId): Promise<PersistedRunState | undefined> {\n    return await this.inner.load(runId);\n  }\n\n  async save(state: PersistedRunState): Promise<void> {\n    await this.inner.save(state);\n    await this.eventBus.publish({\n      kind: \"runSaved\",\n      runId: state.runId,\n      workflowId: state.workflowId,\n      parent: state.parent,\n      at: this.now().toISOString(),\n      state,\n    });\n  }\n\n  async deleteRun(runId: RunId): Promise<void> {\n    if (!this.inner.deleteRun) return;\n    await this.inner.deleteRun(runId);\n  }\n\n  async listRuns(args?: Readonly<{ workflowId?: WorkflowId; limit?: number }>): Promise<ReadonlyArray<RunSummary>> {\n    const listingRepository = this.inner as unknown as Partial<WorkflowExecutionListingRepository>;\n    if (!listingRepository.listRuns) return [];\n    return await listingRepository.listRuns(args);\n  }\n\n  async listRunsOlderThan(\n    args: Readonly<{ beforeIso: string; limit?: number }>,\n  ): Promise<ReadonlyArray<RunPruneCandidate>> {\n    const pruneRepository = this.inner as unknown as Partial<WorkflowExecutionPruneRepository>;\n    if (!pruneRepository.listRunsOlderThan) return [];\n    return await pruneRepository.listRunsOlderThan(args);\n  }\n}\n","import type { Item, Items } from \"../contracts/workflowTypes\";\nimport { injectable } from \"../di\";\n\n/**\n * Normalizes external inputs into the engine's canonical `Items` shape.\n * Used at host and builder boundaries where callers may provide either a raw value,\n * a single item-like object, or an array of item-like values.\n */\n@injectable()\nexport class ItemsInputNormalizer {\n  normalize(raw: unknown): Items {\n    if (raw === undefined || raw === null) {\n      return [];\n    }\n    if (Array.isArray(raw)) {\n      return raw.map((value) => this.normalizeItem(value));\n    }\n    return [this.normalizeItem(raw)];\n  }\n\n  private normalizeItem(raw: unknown): Item {\n    if (!this.isItem(raw)) {\n      return { json: raw };\n    }\n    return {\n      json: raw.json,\n      ...(raw.binary === undefined ? {} : { binary: raw.binary }),\n      ...(raw.meta === undefined ? {} : { meta: raw.meta }),\n      ...(raw.paired === undefined ? {} : { paired: raw.paired }),\n    };\n  }\n\n  private isItem(raw: unknown): raw is Item {\n    return typeof raw === \"object\" && raw !== null && Object.prototype.hasOwnProperty.call(raw, \"json\");\n  }\n}\n","import type { NoneRetryPolicySpec } from \"./retryPolicySpec.types\";\n\nexport class NoRetryPolicy implements NoneRetryPolicySpec {\n  readonly kind = \"none\" as const;\n}\n","import type { FixedRetryPolicySpec } from \"./retryPolicySpec.types\";\n\nexport class RetryPolicy implements FixedRetryPolicySpec {\n  readonly kind = \"fixed\" as const;\n\n  constructor(\n    public readonly maxAttempts: number,\n    public readonly delayMs: number,\n  ) {\n    if (!Number.isFinite(maxAttempts) || maxAttempts < 1 || !Number.isInteger(maxAttempts)) {\n      throw new Error(`RetryPolicy.maxAttempts must be a positive integer, got ${maxAttempts}`);\n    }\n    if (!Number.isFinite(delayMs) || delayMs < 0) {\n      throw new Error(`RetryPolicy.delayMs must be a non-negative finite number, got ${delayMs}`);\n    }\n  }\n\n  /** Default for HTTP-style transient failures: 3 tries, 1s between attempts. */\n  static readonly defaultForHttp: FixedRetryPolicySpec = { kind: \"fixed\", maxAttempts: 3, delayMs: 1000 };\n\n  /** Default for LLM / agent calls: 3 tries, 2s fixed backoff. */\n  static readonly defaultForAiAgent: FixedRetryPolicySpec = { kind: \"fixed\", maxAttempts: 3, delayMs: 2000 };\n}\n","import type { ExponentialRetryPolicySpec } from \"./retryPolicySpec.types\";\n\nexport class ExpRetryPolicy implements ExponentialRetryPolicySpec {\n  readonly kind = \"exponential\" as const;\n\n  constructor(\n    public readonly maxAttempts: number,\n    public readonly initialDelayMs: number,\n    public readonly multiplier: number,\n    public readonly maxDelayMs?: number,\n    public readonly jitter?: boolean,\n  ) {\n    if (!Number.isFinite(maxAttempts) || maxAttempts < 1 || !Number.isInteger(maxAttempts)) {\n      throw new Error(`ExpRetryPolicy.maxAttempts must be a positive integer, got ${maxAttempts}`);\n    }\n    if (!Number.isFinite(initialDelayMs) || initialDelayMs < 0) {\n      throw new Error(`ExpRetryPolicy.initialDelayMs must be a non-negative finite number, got ${initialDelayMs}`);\n    }\n    if (!Number.isFinite(multiplier) || multiplier < 1) {\n      throw new Error(`ExpRetryPolicy.multiplier must be >= 1, got ${multiplier}`);\n    }\n  }\n}\n","import type { NodeId, WorkflowId } from \"./workflowTypes\";\n\nexport type CredentialTypeId = string;\nexport type CredentialInstanceId = string;\n\nexport type CredentialMaterialSourceKind = \"db\" | \"env\" | \"code\";\nexport type CredentialSetupStatus = \"draft\" | \"ready\";\nexport type CredentialHealthStatus = \"unknown\" | \"healthy\" | \"failing\";\n\nexport type CredentialFieldSchema = Readonly<{\n  key: string;\n  label: string;\n  type: \"string\" | \"password\" | \"textarea\" | \"json\" | \"boolean\";\n  required?: true;\n  order?: number;\n  placeholder?: string;\n  helpText?: string;\n  /** When set, host resolves this field from process.env at runtime; env wins over stored values. */\n  envVarName?: string;\n  /**\n   * When set, the dialog shows a copy action for this exact string (e.g. a static OAuth redirect URI\n   * pattern or documentation URL). Do not use for secret values.\n   */\n  copyValue?: string;\n  /** Accessible label for the copy control (default: Copy). */\n  copyButtonLabel?: string;\n}>;\n\nexport type CredentialRequirement = Readonly<{\n  slotKey: string;\n  label: string;\n  acceptedTypes: ReadonlyArray<CredentialTypeId>;\n  optional?: true;\n  helpText?: string;\n  helpUrl?: string;\n}>;\n\nexport type CredentialBindingKey = Readonly<{\n  workflowId: WorkflowId;\n  nodeId: NodeId;\n  slotKey: string;\n}>;\n\nexport type CredentialBinding = Readonly<{\n  key: CredentialBindingKey;\n  instanceId: CredentialInstanceId;\n  updatedAt: string;\n}>;\n\nexport type CredentialHealth = Readonly<{\n  status: CredentialHealthStatus;\n  message?: string;\n  testedAt?: string;\n  expiresAt?: string;\n  details?: Readonly<Record<string, unknown>>;\n}>;\n\nexport type OAuth2ProviderFromPublicConfig = Readonly<{\n  authorizeUrlFieldKey: string;\n  tokenUrlFieldKey: string;\n  userInfoUrlFieldKey?: string;\n}>;\n\nexport type CredentialOAuth2AuthDefinition = Readonly<\n  | {\n      kind: \"oauth2\";\n      providerId: string;\n      scopes: ReadonlyArray<string>;\n      clientIdFieldKey?: string;\n      clientSecretFieldKey?: string;\n    }\n  | {\n      kind: \"oauth2\";\n      providerFromPublicConfig: OAuth2ProviderFromPublicConfig;\n      scopes: ReadonlyArray<string>;\n      clientIdFieldKey?: string;\n      clientSecretFieldKey?: string;\n    }\n>;\n\nexport type CredentialAuthDefinition = CredentialOAuth2AuthDefinition;\n\nexport type CredentialTypeDefinition = Readonly<{\n  typeId: CredentialTypeId;\n  displayName: string;\n  description?: string;\n  publicFields?: ReadonlyArray<CredentialFieldSchema>;\n  secretFields?: ReadonlyArray<CredentialFieldSchema>;\n  supportedSourceKinds?: ReadonlyArray<CredentialMaterialSourceKind>;\n  auth?: CredentialAuthDefinition;\n}>;\n\n/**\n * JSON-shaped credential field bag (public config, resolved secret material, etc.).\n */\nexport type CredentialJsonRecord = Readonly<Record<string, unknown>>;\n\n/**\n * Persisted credential instance with typed `publicConfig`.\n * Hosts may specialize `secretRef` with a stricter union while remaining\n * assignable here for session/test callbacks.\n */\nexport type CredentialInstanceRecord<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord> = Readonly<{\n  instanceId: CredentialInstanceId;\n  typeId: CredentialTypeId;\n  displayName: string;\n  sourceKind: CredentialMaterialSourceKind;\n  publicConfig: TPublicConfig;\n  secretRef: CredentialJsonRecord;\n  tags: ReadonlyArray<string>;\n  setupStatus: CredentialSetupStatus;\n  createdAt: string;\n  updatedAt: string;\n}>;\n\n/**\n * Arguments passed to `CredentialType.createSession` and `CredentialType.test`.\n * Declare `TPublicConfig` / `TMaterial` on `CredentialType` so implementations are checked\n * against your credential shapes (similar to `NodeExecutionContext.config` for nodes).\n */\nexport type CredentialSessionFactoryArgs<\n  TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord,\n  TMaterial extends CredentialJsonRecord = CredentialJsonRecord,\n> = Readonly<{\n  instance: CredentialInstanceRecord<TPublicConfig>;\n  material: TMaterial;\n  publicConfig: TPublicConfig;\n}>;\n\nexport type CredentialSessionFactory<\n  TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord,\n  TMaterial extends CredentialJsonRecord = CredentialJsonRecord,\n  TSession = unknown,\n> = (args: CredentialSessionFactoryArgs<TPublicConfig, TMaterial>) => Promise<TSession>;\n\nexport type CredentialHealthTester<\n  TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord,\n  TMaterial extends CredentialJsonRecord = CredentialJsonRecord,\n> = (args: CredentialSessionFactoryArgs<TPublicConfig, TMaterial>) => Promise<CredentialHealth>;\n\n/**\n * Full credential type implementation: `definition` (UI/schema), `createSession`, and `test`.\n * Use this at registration and config boundaries; `CredentialTypeDefinition` is only the schema slice.\n */\nexport type CredentialType<\n  TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord,\n  TMaterial extends CredentialJsonRecord = CredentialJsonRecord,\n  TSession = unknown,\n> = Readonly<{\n  definition: CredentialTypeDefinition;\n  createSession: CredentialSessionFactory<TPublicConfig, TMaterial, TSession>;\n  test: CredentialHealthTester<TPublicConfig, TMaterial>;\n}>;\n\n/**\n * Credential type with unspecified generics — used for `CodemationConfig.credentialTypes`, the host registry,\n * and anywhere a concrete `CredentialType<YourPublic, YourMaterial, YourSession>` is placed in a heterogeneous list.\n * Using `any` here avoids unsafe `as` casts while keeping typed `satisfies CredentialType<…>` definitions.\n */\nexport type AnyCredentialType = CredentialType<any, any, unknown>;\n\nexport interface CredentialSessionService {\n  getSession<TSession = unknown>(\n    args: Readonly<{\n      workflowId: WorkflowId;\n      nodeId: NodeId;\n      slotKey: string;\n    }>,\n  ): Promise<TSession>;\n}\n\nexport interface CredentialTypeRegistry {\n  listTypes(): ReadonlyArray<CredentialTypeDefinition>;\n  getType(typeId: CredentialTypeId): CredentialTypeDefinition | undefined;\n}\n\nexport class CredentialUnboundError extends Error {\n  constructor(\n    public readonly bindingKey: CredentialBindingKey,\n    public readonly acceptedTypes: ReadonlyArray<CredentialTypeId> = [],\n  ) {\n    super(CredentialUnboundError.createMessage(bindingKey, acceptedTypes));\n    this.name = \"CredentialUnboundError\";\n  }\n\n  private static createMessage(\n    bindingKey: CredentialBindingKey,\n    acceptedTypes: ReadonlyArray<CredentialTypeId>,\n  ): string {\n    const acceptedTypesSuffix =\n      acceptedTypes.length > 0 ? ` Accepted credential types: ${acceptedTypes.join(\", \")}.` : \"\";\n    return `Credential slot \"${bindingKey.slotKey}\" is not bound for workflow ${bindingKey.workflowId} node ${bindingKey.nodeId}.${acceptedTypesSuffix}`;\n  }\n}\n","import type { TypeToken } from \"../di\";\nimport type { CredentialRequirement } from \"./credentialTypes\";\nimport type { RetryPolicySpec } from \"./retryPolicySpec.types\";\n\nexport type WorkflowId = string;\nexport type NodeId = string;\nexport type OutputPortKey = string;\nexport type InputPortKey = string;\nexport type PersistedTokenId = string;\n\nexport type NodeKind = \"trigger\" | \"node\";\nexport type JsonPrimitive = string | number | boolean | null;\nexport interface JsonObject {\n  readonly [key: string]: JsonValue;\n}\nexport type JsonValue = JsonPrimitive | JsonObject | JsonArray;\nexport type JsonArray = ReadonlyArray<JsonValue>;\n\nexport interface Edge {\n  from: { nodeId: NodeId; output: OutputPortKey };\n  to: { nodeId: NodeId; input: InputPortKey };\n}\n\nexport type NodeConnectionName = string;\n\n/**\n * Named connection from an executable parent node to child nodes that exist in {@link WorkflowDefinition.nodes}\n * but are not traversed by the main execution graph.\n */\nexport interface WorkflowNodeConnection {\n  readonly parentNodeId: NodeId;\n  readonly connectionName: NodeConnectionName;\n  readonly childNodeIds: ReadonlyArray<NodeId>;\n}\n\nexport interface WorkflowDefinition {\n  id: WorkflowId;\n  name: string;\n  nodes: NodeDefinition[];\n  edges: Edge[];\n  /**\n   * Optional metadata: which nodes are connection-owned children (e.g. AI agent `llm` / `tools` slots).\n   * When omitted, all nodes in {@link nodes} are treated as executable for topology.\n   */\n  readonly connections?: ReadonlyArray<WorkflowNodeConnection>;\n  /** Directory + file-stem path under a workflow discovery root (for UI grouping only). */\n  discoveryPathSegments?: readonly string[];\n  /** Retention for run JSON and binaries (seconds). Host/env may supply defaults when omitted. */\n  readonly prunePolicy?: WorkflowPrunePolicySpec;\n  /** Whether to keep run data after completion. Host/env may supply defaults when omitted. */\n  readonly storagePolicy?: WorkflowStoragePolicySpec;\n  /** Invoked after a node fails permanently (retries exhausted) and node error handler did not recover. */\n  readonly workflowErrorHandler?: WorkflowErrorHandlerSpec;\n}\n\nexport interface WorkflowGraph {\n  next(nodeId: NodeId, output: OutputPortKey): ReadonlyArray<Readonly<{ nodeId: NodeId; input: InputPortKey }>>;\n}\n\nexport interface WorkflowGraphFactory {\n  create(def: WorkflowDefinition): WorkflowGraph;\n}\n\nexport interface NodeConfigBase {\n  readonly kind: NodeKind;\n  readonly type: TypeToken<unknown>;\n  readonly name?: string;\n  readonly id?: NodeId;\n  readonly icon?: string;\n  readonly execution?: Readonly<{ hint?: \"local\" | \"worker\"; queue?: string }>;\n  /** In-process execute retries (runnable nodes). Triggers typically omit this. */\n  readonly retryPolicy?: RetryPolicySpec;\n  /** Recover from execute failures; return outputs to continue, or rethrow to fail the node. */\n  readonly nodeErrorHandler?: NodeErrorHandlerSpec;\n  /**\n   * When true, edges carrying zero items on an output port still schedule single-input downstream nodes.\n   * Decided from the **source** node that produced the (empty) output. Default (false/undefined): empty\n   * main batches skip downstream execution and propagate the empty path.\n   */\n  readonly continueWhenEmptyOutput?: boolean;\n  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;\n}\n\nexport declare const runnableNodeInputType: unique symbol;\nexport declare const runnableNodeOutputType: unique symbol;\nexport declare const triggerNodeOutputType: unique symbol;\n\nexport interface RunnableNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends NodeConfigBase {\n  readonly kind: \"node\";\n  readonly [runnableNodeInputType]?: TInputJson;\n  readonly [runnableNodeOutputType]?: TOutputJson;\n}\n\nexport declare const triggerNodeSetupStateType: unique symbol;\n\nexport interface TriggerNodeConfig<\n  TOutputJson = unknown,\n  TSetupState extends JsonValue | undefined = undefined,\n> extends NodeConfigBase {\n  readonly kind: \"trigger\";\n  readonly [triggerNodeOutputType]?: TOutputJson;\n  readonly [triggerNodeSetupStateType]?: TSetupState;\n}\n\nexport type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any>> =\n  TConfig extends RunnableNodeConfig<infer TInputJson, any> ? TInputJson : never;\n\nexport type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any>> =\n  TConfig extends RunnableNodeConfig<any, infer TOutputJson> ? TOutputJson : never;\n\nexport type TriggerNodeOutputJson<TConfig extends TriggerNodeConfig<any, any>> =\n  TConfig extends TriggerNodeConfig<infer TOutputJson, any> ? TOutputJson : never;\n\nexport type TriggerNodeSetupState<TConfig extends TriggerNodeConfig<any, any>> =\n  TConfig extends TriggerNodeConfig<any, infer TSetupState> ? TSetupState : never;\n\nexport interface NodeDefinition {\n  id: NodeId;\n  kind: NodeKind;\n  type: TypeToken<unknown>;\n  name?: string;\n  config: NodeConfigBase;\n}\n\nexport interface NodeRef {\n  id: NodeId;\n  kind: NodeKind;\n  name?: string;\n}\n\nexport type PairedItemRef = Readonly<{ nodeId: NodeId; output: OutputPortKey; itemIndex: number }>;\n\nexport type BinaryPreviewKind = \"image\" | \"audio\" | \"video\" | \"download\";\n\nexport type BinaryAttachment = Readonly<{\n  id: string;\n  storageKey: string;\n  mimeType: string;\n  size: number;\n  storageDriver: string;\n  previewKind: BinaryPreviewKind;\n  createdAt: string;\n  runId: RunId;\n  workflowId: WorkflowId;\n  nodeId: NodeId;\n  activationId: NodeActivationId;\n  filename?: string;\n  sha256?: string;\n}>;\n\nexport type ItemBinary = Readonly<Record<string, BinaryAttachment>>;\n\nexport type Item<TJson = unknown> = Readonly<{\n  json: TJson;\n  binary?: ItemBinary;\n  meta?: Readonly<Record<string, unknown>>;\n  paired?: ReadonlyArray<PairedItemRef>;\n}>;\n\nexport type Items<TJson = unknown> = ReadonlyArray<Item<TJson>>;\n\nexport type NodeOutputs = Partial<Record<OutputPortKey, Items>>;\n\nexport type RunId = string;\nexport type NodeActivationId = string;\n\nexport interface ParentExecutionRef {\n  runId: RunId;\n  workflowId: WorkflowId;\n  nodeId: NodeId;\n  /** Subworkflow depth of the **spawning** run (0 = root). Passed when starting a child run. */\n  subworkflowDepth?: number;\n  /** Effective max node activations from the parent run (propagated to child policy merge). */\n  engineMaxNodeActivations?: number;\n  /** Effective max subworkflow depth from the parent run (propagated to child policy merge). */\n  engineMaxSubworkflowDepth?: number;\n}\n\nexport interface RunDataSnapshot {\n  getOutputs(nodeId: NodeId): NodeOutputs | undefined;\n  getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;\n  getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;\n}\n\nexport interface MutableRunData extends RunDataSnapshot {\n  setOutputs(nodeId: NodeId, outputs: NodeOutputs): void;\n  dump(): Record<NodeId, NodeOutputs>;\n}\n\nexport interface RunDataFactory {\n  create(initial?: Record<NodeId, NodeOutputs>): MutableRunData;\n}\n\nexport interface RunIdFactory {\n  makeRunId(): RunId;\n}\n\nexport interface ActivationIdFactory {\n  makeActivationId(): NodeActivationId;\n}\n\nexport type UpstreamRefPlaceholder = `$${number}`;\nexport const branchRef = (index: number) => `$${index}` as UpstreamRefPlaceholder;\n\nexport type ExecutionMode = \"local\" | \"worker\";\n\nexport interface NodeSchedulerDecision {\n  mode: ExecutionMode;\n  queue?: string;\n}\n\nexport interface NodeOffloadPolicy {\n  decide(args: { workflowId: WorkflowId; nodeId: NodeId; config: NodeConfigBase }): NodeSchedulerDecision;\n}\n\n/** Whether to persist run execution data after the workflow finishes. */\nexport type WorkflowStoragePolicyMode = \"ALL\" | \"SUCCESS\" | \"ERROR\" | \"NEVER\";\n\nexport type WorkflowStoragePolicySpec = WorkflowStoragePolicyMode | TypeToken<WorkflowStoragePolicyResolver>;\n\nexport interface WorkflowStoragePolicyResolver {\n  shouldPersist(args: WorkflowStoragePolicyDecisionArgs): boolean | Promise<boolean>;\n}\n\nexport interface WorkflowStoragePolicyDecisionArgs {\n  readonly runId: RunId;\n  readonly workflowId: WorkflowId;\n  readonly workflow: WorkflowDefinition;\n  readonly finalStatus: \"completed\" | \"failed\";\n  readonly startedAt: string;\n  readonly finishedAt: string;\n}\n\nexport interface WorkflowPrunePolicySpec {\n  readonly runDataRetentionSeconds?: number;\n  readonly binaryRetentionSeconds?: number;\n}\n\nexport interface PersistedRunPolicySnapshot {\n  readonly retentionSeconds?: number;\n  readonly binaryRetentionSeconds?: number;\n  readonly storagePolicy: WorkflowStoragePolicyMode;\n}\n\nexport interface WorkflowErrorHandler {\n  onError(ctx: WorkflowErrorContext): void | Promise<void>;\n}\n\nexport interface WorkflowErrorContext {\n  readonly runId: RunId;\n  readonly workflowId: WorkflowId;\n  readonly workflow: WorkflowDefinition;\n  readonly failedNodeId: NodeId;\n  readonly error: Error;\n  readonly startedAt: string;\n  readonly finishedAt: string;\n}\n\nexport type WorkflowErrorHandlerSpec = TypeToken<WorkflowErrorHandler> | WorkflowErrorHandler;\n\nexport interface NodeErrorHandlerArgs<TConfig extends NodeConfigBase = NodeConfigBase> {\n  readonly kind: \"single\" | \"multi\";\n  readonly items: Items;\n  readonly inputsByPort: Readonly<Record<InputPortKey, Items>> | undefined;\n  readonly ctx: import(\"./runtimeTypes\").NodeExecutionContext<TConfig>;\n  readonly error: Error;\n}\n\nexport interface NodeErrorHandler {\n  handle<TConfig extends NodeConfigBase>(args: NodeErrorHandlerArgs<TConfig>): Promise<NodeOutputs>;\n}\n\nexport type NodeErrorHandlerSpec = TypeToken<NodeErrorHandler> | NodeErrorHandler;\n\n/** Runtime defaults when workflow omits prune/storage fields (typically from host env). */\nexport interface WorkflowPolicyRuntimeDefaults {\n  readonly retentionSeconds?: number;\n  readonly binaryRetentionSeconds?: number;\n  readonly storagePolicy?: WorkflowStoragePolicyMode;\n}\n","import type { WorkflowId } from \"./workflowTypes\";\n\n/**\n * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes\n * for that workflow are not registered (see engine trigger runtime + webhook matcher).\n */\nexport interface WorkflowActivationPolicy {\n  isActive(workflowId: WorkflowId): boolean;\n}\n\n/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */\nexport class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {\n  isActive(_workflowId: WorkflowId): boolean {\n    return true;\n  }\n}\n"],"mappings":"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"}