@codemation/core 0.11.0 → 0.11.1

package/dist/executionPersistenceContracts-BgZMRsTa.d.cts

@@ -0,0 +1,275 @@
+import { Dt as JsonValue, Ii as NodeId, Jt as RunId, M as RunStatus, b as PersistedWorkflowSnapshot, f as NodeExecutionStatus, g as PersistedMutableRunState, kt as NodeActivationId, n as AgentMcpToolMap, t as AgentMcpIntegration, u as NodeExecutionError, zi as WorkflowId } from "./agentMcpTypes-ZiNbNsEi.cjs";
+
+//#region src/contracts/AgentBindError.d.ts
+
+/**
+ * Thrown at agent bind time when mcpServers declarations cannot be resolved.
+ * Causes include: unknown server id, missing credential instance, insufficient scopes,
+ * and ambiguous shorthand binding (multiple credential instances match).
+ */
+declare class AgentBindError extends Error {
+  constructor(message: string);
+}
+//#endregion
+//#region src/contracts/NoOpAgentMcpIntegration.d.ts
+/**
+ * No-op implementation of AgentMcpIntegration.
+ * Registered by the core engine runtime as a fallback when the host does not
+ * supply a real implementation (e.g. in unit tests or headless engine setups).
+ * Always returns an empty tool map so the agent runs with node-backed tools only.
+ */
+declare class NoOpAgentMcpIntegration implements AgentMcpIntegration {
+  prepareMcpTools(): Promise<AgentMcpToolMap>;
+}
+//#endregion
+//#region src/contracts/assertionTypes.d.ts
+/**
+ * One assertion emitted by an assertion-emitting node (a node whose config sets
+ * `emitsAssertions: true`). Each emitted item on `main` carries one of these as `item.json`.
+ *
+ * Pass/fail is derived from `score >= (passThreshold ?? 0.5)` — see {@link deriveAssertionPassed}.
+ * The `errored` marker is for cases where the assertion code itself threw (distinct from
+ * "the assertion was evaluated and the score was low") and is treated as a hard fail in rollups
+ * regardless of `score`.
+ */
+interface AssertionResult {
+  readonly name: string;
+  /** 0..1 score. Source of truth for pass/fail (compared against `passThreshold`). */
+  readonly score: number;
+  /** 0..1 threshold for "passed". When omitted, consumers default to 0.5. */
+  readonly passThreshold?: number;
+  /** True when evaluating the assertion threw — treated as fail regardless of `score`. */
+  readonly errored?: true;
+  /** What the assertion expected. Free-form JSON; UIs render with a JSON viewer. */
+  readonly expected?: JsonValue;
+  /** What the workflow actually produced. */
+  readonly actual?: JsonValue;
+  /** Short human-readable explanation, especially for fails / errors. */
+  readonly message?: string;
+  /** Bag of supplemental fields (e.g. judge prompt, judge raw response, comparison method). */
+  readonly details?: Readonly<Record<string, JsonValue>>;
+}
+/**
+ * Default {@link AssertionResult.passThreshold} when authors omit it. Boolean-style assertions
+ * (assertEqual / contains / etc.) emit `score: 1` or `score: 0` so this default works for them;
+ * AI-judge assertions are expected to set their own threshold.
+ */
+declare const DEFAULT_ASSERTION_PASS_THRESHOLD = 0.5;
+/**
+ * Derive whether an assertion result is considered "passing" using the score-based contract:
+ * `errored` always fails, otherwise `score >= (passThreshold ?? 0.5)`. This is the canonical
+ * derivation — UI and rollup code should call it rather than inlining the comparison so future
+ * tweaks (e.g. NaN handling) land in one place.
+ */
+declare function deriveAssertionPassed(result: {
+  readonly score: number;
+  readonly passThreshold?: number;
+  readonly errored?: true;
+}): boolean;
+/**
+ * Provenance for a persisted {@link AssertionResult}: which node produced it and where in the
+ * per-item iteration tree it landed. Filled in by the host-side persister, not the node itself.
+ */
+interface AssertionResultProvenance {
+  readonly nodeId: NodeId;
+  /** Per-item iteration id when the emitting node ran inside a per-item loop. */
+  readonly iterationId?: string;
+  /** Item index (0-based) within the activation that produced this assertion. */
+  readonly itemIndex?: number;
+}
+//#endregion
+//#region src/contracts/executionPersistenceContracts.d.ts
+/** Canonical id for persisted execution rows (activation or connection invocation). */
+type ExecutionInstanceId = string;
+/** Stable id for persisted work-queue rows. */
+type WorkItemId = string;
+/** Batch grouping for planner activations. */
+type BatchId = string;
+/** Optimistic concurrency on the run root. */
+type RunRevision = number;
+type PersistedRunWorkItemKind = "queue" | "pending";
+type WorkItemStatus = "queued" | "claimed" | "completed" | "failed" | "cancelled";
+type PersistedExecutionInstanceKind = "workflowNodeActivation" | "connectionInvocation";
+type ConnectionInvocationKind = "languageModel" | "tool" | "nestedAgent";
+type PayloadStorageKind = "inline" | "external" | "omitted";
+/**
+ * Persisted run-work-queue row (queue entry or pending activation).
+ * Serialized to {@link RunWorkItem} in Prisma; engine still uses {@link PersistedRunState} queue + pending.
+ */
+interface PersistedRunWorkItemRecord {
+  readonly workItemId: WorkItemId;
+  readonly runId: RunId;
+  readonly workflowId: WorkflowId;
+  readonly kind: PersistedRunWorkItemKind;
+  readonly orderIndex: number;
+  readonly status: WorkItemStatus;
+  readonly queueName?: string;
+  readonly claimToken?: string;
+  readonly claimedBy?: string;
+  readonly claimedAt?: string;
+  readonly availableAt: string;
+  readonly enqueuedAt: string;
+  readonly completedAt?: string;
+  readonly failedAt?: string;
+  readonly sourceInstanceId?: ExecutionInstanceId;
+  readonly parentInstanceId?: ExecutionInstanceId;
+  readonly itemsIn: number;
+  /** Queue entry when kind is queue; pending activation when kind is pending. */
+  readonly payloadJson: string;
+  readonly error?: Readonly<NodeExecutionError>;
+}
+/**
+ * Payload policy fields for large-batch externalization (optional on first rollout).
+ */
+interface ExecutionPayloadPolicyFields {
+  readonly inputStorageKind: PayloadStorageKind;
+  readonly outputStorageKind: PayloadStorageKind;
+  readonly inputBytes?: number;
+  readonly outputBytes?: number;
+  readonly inputPreviewJson?: unknown;
+  readonly outputPreviewJson?: unknown;
+  readonly inputPayloadRef?: string;
+  readonly outputPayloadRef?: string;
+  readonly inputTruncated?: boolean;
+  readonly outputTruncated?: boolean;
+}
+/**
+ * One persisted execution row (workflow node activation or connection invocation).
+ */
+interface PersistedExecutionInstanceRecord {
+  readonly instanceId: ExecutionInstanceId;
+  readonly runId: RunId;
+  readonly workflowId: WorkflowId;
+  readonly slotNodeId: NodeId;
+  readonly workflowNodeId: NodeId;
+  readonly kind: PersistedExecutionInstanceKind;
+  readonly connectionKind?: ConnectionInvocationKind;
+  readonly activationId?: NodeActivationId;
+  readonly batchId: BatchId;
+  readonly runIndex: number;
+  readonly parentInstanceId?: ExecutionInstanceId;
+  readonly parentRunId?: RunId;
+  readonly workerClaimToken?: string;
+  readonly status: NodeExecutionStatus;
+  readonly queuedAt?: string;
+  readonly startedAt?: string;
+  readonly finishedAt?: string;
+  readonly updatedAt: string;
+  readonly itemCount: number;
+  readonly inputJson?: string;
+  readonly outputJson?: string;
+  readonly errorJson?: string;
+  readonly inputItemIndicesJson?: string;
+  readonly outputItemCount?: number;
+  readonly successfulItemCount?: number;
+  readonly failedItemCount?: number;
+  readonly truncatedInputPreviewJson?: string;
+  readonly truncatedOutputPreviewJson?: string;
+  readonly inputTruncated?: boolean;
+  readonly outputTruncated?: boolean;
+  readonly usedPinnedOutput?: boolean;
+  readonly payloadPolicy?: ExecutionPayloadPolicyFields;
+}
+/**
+ * Cached slot projection for planner/debugger/UI (not canonical history).
+ */
+interface RunSlotProjectionState {
+  readonly runId: RunId;
+  readonly workflowId: WorkflowId;
+  readonly revision: RunRevision;
+  readonly slotStatesByNodeId: Record<NodeId, Readonly<{
+    latestInstanceId?: ExecutionInstanceId;
+    latestTerminalInstanceId?: ExecutionInstanceId;
+    latestRunningInstanceId?: ExecutionInstanceId;
+    latestStatus?: NodeExecutionStatus;
+    invocationCount: number;
+    runCount: number;
+  }>>;
+}
+interface PersistedRunSlotProjectionRecord {
+  readonly runId: RunId;
+  readonly workflowId: WorkflowId;
+  readonly revision: RunRevision;
+  readonly updatedAt: string;
+  readonly slotStatesJson: string;
+}
+interface WorkflowRunDetailDto {
+  readonly runId: RunId;
+  readonly workflowId: WorkflowId;
+  readonly startedAt: string;
+  readonly finishedAt?: string;
+  readonly status: RunStatus;
+  readonly workflowSnapshot?: PersistedWorkflowSnapshot;
+  readonly mutableState?: PersistedMutableRunState;
+  readonly slotStates: ReadonlyArray<SlotExecutionStateDto>;
+  readonly executionInstances: ReadonlyArray<ExecutionInstanceDto>;
+  readonly iterations?: ReadonlyArray<RunIterationDto>;
+}
+/**
+ * Per-item iteration projected from connection invocations and node activations.
+ *
+ * One iteration = one item processed by an agent within an activation. Multiple invocations
+ * (LLM rounds, tool calls) belonging to the same iteration share the iterationId.
+ */
+interface RunIterationDto {
+  readonly iterationId: string;
+  readonly agentNodeId: NodeId;
+  readonly activationId: NodeActivationId;
+  readonly itemIndex: number;
+  readonly itemSummary?: string;
+  readonly status: NodeExecutionStatus;
+  readonly startedAt?: string;
+  readonly finishedAt?: string;
+  readonly invocationIds: ReadonlyArray<string>;
+  readonly parentInvocationId?: string;
+  /** Estimated cost rolled up from telemetry cost metric points, keyed by ISO currency code (e.g. "USD"). Values are minor units (cents-of-cents per the metric's `cost.currency_scale`). */
+  readonly estimatedCostMinorByCurrency?: Readonly<Record<string, number>>;
+  /** Currency scale (denominator) per currency, when present on the metric points. Joined with `estimatedCostMinorByCurrency` to format human-readable amounts. */
+  readonly estimatedCostCurrencyScaleByCurrency?: Readonly<Record<string, number>>;
+}
+interface SlotExecutionStateDto {
+  readonly slotNodeId: NodeId;
+  readonly latestInstanceId?: ExecutionInstanceId;
+  readonly latestTerminalInstanceId?: ExecutionInstanceId;
+  readonly latestRunningInstanceId?: ExecutionInstanceId;
+  readonly status?: NodeExecutionStatus;
+  readonly invocationCount: number;
+  readonly runCount: number;
+}
+interface ExecutionInstanceDto {
+  readonly instanceId: ExecutionInstanceId;
+  readonly slotNodeId: NodeId;
+  readonly workflowNodeId: NodeId;
+  readonly parentInstanceId?: ExecutionInstanceId;
+  readonly kind: PersistedExecutionInstanceKind;
+  readonly connectionKind?: ConnectionInvocationKind;
+  readonly runIndex: number;
+  readonly batchId: BatchId;
+  readonly activationId?: NodeActivationId;
+  readonly status: NodeExecutionStatus;
+  readonly queuedAt?: string;
+  readonly startedAt?: string;
+  readonly finishedAt?: string;
+  readonly itemCount: number;
+  readonly inputJson?: JsonValue;
+  readonly outputJson?: JsonValue;
+  readonly error?: Readonly<NodeExecutionError>;
+  /** Per-item iteration that produced this instance. Set on connectionInvocation rows produced inside per-item runnable loops. */
+  readonly iterationId?: string;
+  /** Item index (0-based) of the iteration. */
+  readonly itemIndex?: number;
+  /** Parent invocation id when this instance was emitted by a sub-agent triggered by an outer LLM/tool call. */
+  readonly parentInvocationId?: string;
+  /**
+   * When this instance is a SubWorkflow node activation, the run id of the child run it spawned.
+   * Used by the UI to deep-link directly to the child execution.
+   */
+  readonly childRunId?: string;
+}
+interface WorkflowDetailSelectionState {
+  readonly selectedSlotNodeId: NodeId | null;
+  readonly selectedInstanceId: ExecutionInstanceId | null;
+}
+//#endregion
+export { deriveAssertionPassed as C, DEFAULT_ASSERTION_PASS_THRESHOLD as S, AgentBindError as T, WorkItemStatus as _, ExecutionPayloadPolicyFields as a, AssertionResult as b, PersistedExecutionInstanceRecord as c, PersistedRunWorkItemRecord as d, RunIterationDto as f, WorkItemId as g, SlotExecutionStateDto as h, ExecutionInstanceId as i, PersistedRunSlotProjectionRecord as l, RunSlotProjectionState as m, ConnectionInvocationKind as n, PayloadStorageKind as o, RunRevision as p, ExecutionInstanceDto as r, PersistedExecutionInstanceKind as s, BatchId as t, PersistedRunWorkItemKind as u, WorkflowDetailSelectionState as v, NoOpAgentMcpIntegration as w, AssertionResultProvenance as x, WorkflowRunDetailDto as y };
+//# sourceMappingURL=executionPersistenceContracts-BgZMRsTa.d.cts.map

package/dist/{index-Bes88mxT.d.ts → index-62Ba9f7D.d.ts}

@@ -1,5 +1,7 @@
-import { $a as CredentialTypeDefinition, $i as WebhookTriggerRoutingDiagnostics, Ai as PreparedNodeActivationDispatch, Ar as WorkflowDefinition, Bi as TriggerTestItemsContext, Cr as RunnableNodeConfig, Da as CostTrackingTelemetryFactory, Di as NodeResolver, Er as TriggerNodeConfig, Fn as RunEventBus, Ft as EngineRunCounters, Gn as Edge, Gt as PersistedRunSchedulingState, Hi as WorkflowRepository, Hn as ActivationIdFactory, In as RunEventSubscription, Ji as TriggerInstanceId, Jt as PersistedWorkflowSnapshotNode, Kn as ExecutionMode, Kt as PersistedRunState, La as CredentialFieldSchema, Ln as TestCaseRunStatus, Ma as AnyCredentialType, Mn as EngineExecutionLimitsPolicy, Mt as ConnectionInvocationId, Nt as ConnectionInvocationRecord, Pn as RunEvent, Qa as CredentialType, Qr as RetryPolicySpec, Ra as CredentialHealth, Rn as TestSuiteRunStatus, Rt as NodeExecutionSnapshot, Si as NodeExecutionRequest, Ta as CostTrackingTelemetry, Ti as NodeExecutionStatePublisher, Ua as CredentialJsonRecord, Un as BinaryAttachment, V as McpServerDeclaration, Vi as WorkflowNodeInstanceFactory, Xa as CredentialSessionService, Xi as WebhookInvocationMatch, Ya as CredentialSessionFactoryArgs, Yn as Items, Zi as WebhookTriggerMatcher, _i as NodeActivationRequest, _r as ParentExecutionRef, ai as BinaryStorageWriteResult, ao as PollingTriggerLogger, bi as NodeBinaryAttachmentService, br as RunDataSnapshot, cn as RunTestContext, co as NodeConnectionName, ct as CostCatalog, di as ExecutionContextFactory, dn as WorkflowExecutionPruneRepository, ei as BinaryBody, en as RunExecutionOptions, eo as CredentialTypeId, er as JsonValue, fn as WorkflowExecutionRepository, fo as WorkflowId, fr as NodeOffloadPolicy, ft as ParamDeep, hi as NodeActivationContinuation, hr as NodeSchedulerDecision, i as WorkflowSnapshotCodec, ir as NodeDefinition, ja as CollectionsContext, ka as CostTrackingUsageRecord, li as ExecutionBinaryService, lo as NodeId, lr as NodeInspectorSummaryRow, lt as CostCatalogEntry, ma as TelemetrySpanScope, na as ExecutionTelemetry, ni as BinaryStorageReadResult, nr as NodeActivationId, oi as EngineDeps, pr as NodeOutputs, qa as CredentialRequirement, qi as HttpMethod, qn as Item, ra as ExecutionTelemetryFactory, ri as BinaryStorageStatResult, rn as RunResult, rr as NodeConfigBase, sn as RunSummary, ta as WorkflowActivationPolicy, ti as BinaryStorage, tn as RunPruneCandidate, tr as MutableRunData, u as Engine, ui as ExecutionContext, un as WorkflowExecutionListingRepository, uo as OutputPortKey, ut as Expr, vr as PersistedRunPolicySnapshot, wi as NodeExecutionScheduler, wr as RunnableNodeInputJson, xi as NodeExecutionContext, xr as RunId, yi as NodeActivationScheduler, yn as TypeToken, yr as RunDataFactory, zi as TriggerSetupStateRepository, zn as TestSuiteRunId } from "./RunIntentService-BrEq6Jm6.js";
-import { ZodType, input, output, z } from "zod";
+import { $ as CostCatalogEntry, $a as NodeId, $n as NodeInspectorSummaryRow, $r as ExecutionBinaryService, Ai as TriggerTestItemsContext, Ba as CredentialSessionService, Bi as WebhookInvocationMatch, Ct as ConnectionInvocationRecord, Da as CredentialFieldSchema, Dn as TestCaseRunStatus, En as RunEventSubscription, Fn as Edge, Ft as PersistedRunSchedulingState, Gi as WorkflowActivationPolicy, Gn as MutableRunData, Gr as BinaryStorage, Gt as RunPruneCandidate, Ha as CredentialType, Hr as RetryPolicySpec, In as ExecutionMode, It as PersistedRunState, Jn as NodeDefinition, Ki as ExecutionTelemetry, Kn as NodeActivationId, Kr as BinaryStorageReadResult, La as CredentialRequirement, Li as HttpMethod, Ln as Item, Mi as WorkflowRepository, Mn as ActivationIdFactory, Na as CredentialJsonRecord, Nn as BinaryAttachment, Oa as CredentialHealth, On as TestSuiteRunStatus, Ot as NodeExecutionSnapshot, Q as CostCatalog, Qt as RunTestContext, Ri as TriggerInstanceId, Rt as PersistedWorkflowSnapshotNode, Sa as AnyCredentialType, Sn as EngineExecutionLimitsPolicy, St as ConnectionInvocationId, Tn as RunEventBus, Tt as EngineRunCounters, Ua as CredentialTypeDefinition, Ui as WebhookTriggerRoutingDiagnostics, Vi as WebhookTriggerMatcher, Wa as CredentialTypeId, Wn as JsonValue, Wr as BinaryBody, Wt as RunExecutionOptions, Xr as EngineDeps, Ya as PollingTriggerLogger, Yr as BinaryStorageWriteResult, Zt as RunSummary, _a as CostTrackingTelemetryFactory, _i as NodeResolver, ai as NodeActivationContinuation, ar as NodeSchedulerDecision, bi as PreparedNodeActivationDispatch, br as WorkflowDefinition, cr as PersistedRunPolicySnapshot, di as NodeExecutionContext, dr as RunId, ei as ExecutionContext, en as WorkflowExecutionListingRepository, eo as OutputPortKey, fi as NodeExecutionRequest, gr as TriggerNodeConfig, ha as CostTrackingTelemetry, hi as NodeExecutionStatePublisher, ia as TelemetrySpanScope, ji as WorkflowNodeInstanceFactory, ki as TriggerSetupStateRepository, kn as TestSuiteRunId, li as NodeActivationScheduler, ln as TypeToken, lr as RunDataFactory, mi as NodeExecutionScheduler, nn as WorkflowExecutionRepository, no as WorkflowId, nr as NodeOffloadPolicy, nt as ParamDeep, pr as RunnableNodeConfig, qi as ExecutionTelemetryFactory, qn as NodeConfigBase, qr as BinaryStorageStatResult, qt as RunResult, rr as NodeOutputs, si as NodeActivationRequest, sr as ParentExecutionRef, ti as ExecutionContextFactory, tn as WorkflowExecutionPruneRepository, ui as NodeBinaryAttachmentService, ur as RunDataSnapshot, wn as RunEvent, xa as CollectionsContext, ya as CostTrackingUsageRecord, za as CredentialSessionFactoryArgs, zn as Items } from "./index-zWGtEhrf.js";
+import { i as WorkflowSnapshotCodec, u as Engine } from "./RunIntentService-BVur7x9n.js";
+import { B as ZodSchemaAny, K as CallableToolConfig, q as CallableToolConfigOptions } from "./ItemsInputNormalizer-_Mfcd3YU.js";
+import { ZodType, z } from "zod";
 
 //#region src/orchestration/AbortControllerFactory.d.ts
 /**
@@ -159,288 +161,6 @@ declare function defineCredential<TPublicSource extends CredentialFieldMap<any>
   readonly key: string;
 };
 //#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/CallableToolConfig.d.ts
-type CallableToolExecuteHandler<TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny> = (args: ToolExecuteArgs<CallableToolConfig<TInputSchema, TOutputSchema>, input<TInputSchema>>) => Promise<output<TOutputSchema>> | output<TOutputSchema>;
-type CallableToolConfigOptions<TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny> = Readonly<{
-  name: string;
-  description?: string;
-  presentation?: AgentCanvasPresentation;
-  inputSchema: TInputSchema;
-  outputSchema: TOutputSchema;
-  /**
-   * Optional credential slots for this tool (same contract as other {@link ToolConfig} shapes).
-   */
-  credentialRequirements?: ReadonlyArray<CredentialRequirement>;
-  execute: CallableToolExecuteHandler<TInputSchema, TOutputSchema>;
-}>;
-/**
- * Inline callable agent tool: DSL sugar over {@link ToolConfig} without a separate {@link NodeResolver}-registered {@link Tool} class.
- */
-declare class CallableToolConfig<TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny> implements ToolConfig {
-  readonly name: string;
-  readonly type: TypeToken<unknown>;
-  readonly toolKind: "callable";
-  readonly description?: string;
-  readonly presentation?: AgentCanvasPresentation;
-  private readonly inputSchemaValue;
-  private readonly outputSchemaValue;
-  private readonly credentialRequirementsValue?;
-  private readonly executeHandler;
-  constructor(name: string, options: CallableToolConfigOptions<TInputSchema, TOutputSchema>);
-  getCredentialRequirements(): ReadonlyArray<CredentialRequirement>;
-  getInputSchema(): TInputSchema;
-  getOutputSchema(): TOutputSchema;
-  /**
-   * Parses tool input and output with the configured Zod schemas.
-   */
-  executeTool(args: ToolExecuteArgs<CallableToolConfig<TInputSchema, TOutputSchema>, input<TInputSchema>>): Promise<output<TOutputSchema>>;
-  private parseInput;
-  private parseOutput;
-  private decorateValidationError;
-}
-//#endregion
-//#region src/ai/CallableToolFactory.d.ts
-declare class CallableToolFactoryImpl {
-  callableTool<TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny>(options: CallableToolConfigOptions<TInputSchema, TOutputSchema>): CallableToolConfig<TInputSchema, TOutputSchema>;
-}
-declare const CallableToolFactory: CallableToolFactoryImpl;
-//#endregion
-//#region src/ai/CallableToolKindToken.d.ts
-/**
- * Shared {@link import("../di").TypeToken} marker for {@link CallableToolConfig}.
- * Callable tools are not registered in {@link NodeResolver}; this class only satisfies {@link ToolConfig#type}.
- */
-declare class CallableToolKindToken {}
-//#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>;
-  private withDefaultAgentInputMapper;
-  private mergeAgentToolInputWithCurrentItem;
-  private isMergeableRecord;
-}
-declare const AgentToolFactory: AgentToolFactoryImpl;
-//#endregion
-//#region src/ai/AgentMessageConfigNormalizerFactory.d.ts
-declare class AgentMessageConfigNormalizer {
-  /**
-   * Prefer {@code input.messages} when present (ItemNode / engine-mapped payloads); otherwise resolve from
-   * {@link AgentNodeConfig.messages} templates.
-   */
-  static resolveFromInputOrConfig<TInputJson, TOutputJson>(input: unknown, config: AgentNodeConfig<TInputJson, TOutputJson>, args: AgentMessageBuildArgs<TInputJson>): ReadonlyArray<AgentMessageDto>;
-  static normalize<TInputJson, TOutputJson>(config: AgentNodeConfig<TInputJson, TOutputJson>, args: AgentMessageBuildArgs<TInputJson>): ReadonlyArray<AgentMessageDto>;
-  private static tryMessagesFromStructuredInput;
-  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;
-  readonly icon?: TIcon;
-}
-type ZodSchemaAny = ZodType<any, any, any>;
-interface ToolConfig {
-  readonly type: TypeToken<unknown>;
-  readonly name: string;
-  readonly description?: string;
-  readonly presentation?: AgentCanvasPresentation;
-  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
-}
-type ToolExecuteArgs<TConfig$1 extends ToolConfig = ToolConfig, TInput = unknown> = Readonly<{
-  config: TConfig$1;
-  input: TInput;
-  ctx: NodeExecutionContext<any>;
-  item: Item;
-  itemIndex: number;
-  items: Items;
-  /**
-   * Optional sub-agent boundary hooks: when present, the live `agent.tool.call` span and the
-   * planned tool-call invocationId are forwarded so node-backed runtimes can re-root their child
-   * execution scope. Plain function tools may safely ignore these hooks.
-   */
-  hooks?: Readonly<{
-    parentSpan?: TelemetrySpanScope;
-    parentInvocationId?: ConnectionInvocationId;
-  }>;
-}>;
-interface Tool<TConfig$1 extends ToolConfig = ToolConfig, TInputSchema extends ZodSchemaAny = ZodSchemaAny, TOutputSchema extends ZodSchemaAny = ZodSchemaAny> {
-  readonly defaultDescription: string;
-  readonly inputSchema: TInputSchema;
-  readonly outputSchema: TOutputSchema;
-  execute(args: ToolExecuteArgs<TConfig$1, input<TInputSchema>>): Promise<output<TOutputSchema>> | output<TOutputSchema>;
-}
-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> = Expr<ReadonlyArray<AgentMessageLine<TInputJson>>, TInputJson> | 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;
-  readonly inputSchema: ZodSchemaAny;
-}
-type AgentToolCall = Readonly<{
-  id?: string;
-  name: string;
-  input: unknown;
-}>;
-type AgentToolCallPlanner<_TNodeConfig = unknown> = (item: Item, index: number, items: Items, ctx: NodeExecutionContext<any>) => ReadonlyArray<AgentToolCall>;
-interface ChatModelConfig {
-  readonly type: TypeToken<ChatModelFactory<ChatModelConfig>>;
-  readonly name: string;
-  readonly provider?: string;
-  readonly modelName?: string;
-  readonly presentation?: AgentCanvasPresentation;
-  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
-}
-/**
- * Provider-neutral chat language model wrapper returned by a {@link ChatModelFactory}.
- *
- * Thin adapter around an AI SDK `LanguageModelV2` (from `@ai-sdk/provider`) plus the call-site
- * defaults Codemation needs at every generate/stream: the provider label, the model name used for
- * pricing / telemetry, and the default invocation options (max output tokens, temperature,
- * provider-specific overrides).
- *
- * The consumer (AIAgentNode / AgentStructuredOutputRunner) passes `languageModel` directly into
- * `generateText({ model, ... })` from the `ai` package.
- */
-interface ChatLanguageModel {
-  /** AI SDK `LanguageModelV2` instance (kept `unknown` to avoid leaking the SDK type into `@codemation/core`). */
-  readonly languageModel: unknown;
-  /** Stable pricing/telemetry key — e.g. `"gpt-4.1-nano"`. */
-  readonly modelName: string;
-  /** Provider label — e.g. `"openai"`. Used for cost tracking. */
-  readonly provider?: string;
-  /** Defaults merged into every call. Consumers may override per-invocation. */
-  readonly defaultCallOptions?: ChatLanguageModelCallOptions;
-}
-interface ChatLanguageModelCallOptions {
-  readonly maxOutputTokens?: number;
-  readonly temperature?: number;
-  readonly providerOptions?: Readonly<Record<string, Readonly<Record<string, JsonValue>>>>;
-}
-/**
- * Options for a structured-output generate call. Mirrors
- * `generateText({ output: Output.object(...) })` from the `ai` package.
- */
-interface StructuredOutputOptions {
-  /** Optional schema name — used by some providers as the JSON schema name attribute. */
-  readonly schemaName?: string;
-  /** When `true`, the consumer should pass a strict-mode-compatible JSON Schema record. */
-  readonly strict?: boolean;
-}
-interface ChatModelFactory<TConfig$1 extends ChatModelConfig = ChatModelConfig> {
-  create(args: Readonly<{
-    config: TConfig$1;
-    ctx: NodeExecutionContext<any>;
-  }>): Promise<ChatLanguageModel> | ChatLanguageModel;
-}
-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 messages: AgentMessageConfig<TInputJson>;
-  readonly chatModel: ChatModelConfig;
-  readonly tools?: ReadonlyArray<ToolConfig>;
-  readonly guardrails?: AgentGuardrailConfig;
-  readonly outputSchema?: ZodType<TOutputJson>;
-}
-type AgentAttachmentRole = "languageModel" | "tool" | "nestedAgent";
-//#endregion
 //#region src/authoring/callableTool.types.d.ts
 /**
  * Workflow-facing helper for inline Zod-typed agent tools (same as {@link CallableToolFactory.callableTool}).
@@ -673,27 +393,6 @@ declare class DefinedPollingTriggerConfig<TConfig$1 extends CredentialJsonRecord
  */
 declare function definePollingTrigger<TKey$1 extends string, TConfig$1 extends CredentialJsonRecord, TItemJson, TState extends JsonValue | undefined, TBindings extends DefinedNodeCredentialBindings | undefined = undefined>(options: DefinePollingTriggerOptions<TKey$1, TConfig$1, TItemJson, TState, TBindings>): DefinedPollingTrigger<TKey$1, TConfig$1, TItemJson, TState, TBindings>;
 //#endregion
-//#region src/ai/AgentConnectionNodeCollector.d.ts
-type AgentConnectionNodeRole = "languageModel" | "tool" | "nestedAgent";
-type AgentConnectionCredentialSource = Readonly<{
-  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
-}>;
-type AgentConnectionNodeDescriptor = Readonly<{
-  nodeId: NodeId;
-  parentNodeId: NodeId;
-  connectionName: NodeConnectionName;
-  role: AgentConnectionNodeRole;
-  name: string;
-  typeName: string;
-  icon?: string;
-  credentialSource: AgentConnectionCredentialSource;
-}>;
-type McpServerResolver = (id: string) => McpServerDeclaration | undefined;
-type AgentConnectionNodeCollectorApi = Readonly<{
-  collect(parentNodeId: NodeId, agentConfig: AgentNodeConfig<any, any>, mcpServerResolver?: McpServerResolver): ReadonlyArray<AgentConnectionNodeDescriptor>;
-}>;
-declare const AgentConnectionNodeCollector: AgentConnectionNodeCollectorApi;
-//#endregion
 //#region src/events/ConnectionInvocationEventPublisher.d.ts
 /**
  * Publishes per-invocation lifecycle records onto the run {@link RunEventBus}.
@@ -801,18 +500,6 @@ declare function tool(options?: PersistedRuntimeTypeDecoratorOptions): ClassDeco
 /** Marks a class as a persisted chat-model runtime type and an injectable tsyringe service. */
 declare function chatModel(options?: PersistedRuntimeTypeDecoratorOptions): ClassDecorator;
 //#endregion
-//#region src/serialization/ItemsInputNormalizer.d.ts
-/**
- * Normalizes external inputs into the engine's canonical `Items` shape.
- * Used at host and builder boundaries where callers may provide either a raw value,
- * a single item-like object, or an array of item-like values.
- */
-declare class ItemsInputNormalizer {
-  normalize(raw: unknown): Items;
-  private normalizeItem;
-  private isItem;
-}
-//#endregion
 //#region src/binaries/UnavailableBinaryStorage.d.ts
 declare class UnavailableBinaryStorage implements BinaryStorage {
   readonly driverName = "unavailable";
@@ -1349,5 +1036,5 @@ declare class TestSuiteOrchestrator {
   private publish;
 }
 //#endregion
-export { InjectableRuntimeDecoratorComposer as $, NodeBackedToolConfigOptions as $t, ConfigDrivenOffloadPolicy as A, defineBatchNode as An, AgentCanvasPresentation as At, DefaultAsyncSleeper as B, AgentModelInvocationOptions as Bt, InMemoryWorkflowExecutionRepository as C, DefineNodeOptions as Cn, CollectionIndexDefinition as Ct, HintOnlyOffloadPolicy as D, DefinedNodeCredentialBinding as Dn, defineCollection as Dt, LocalOnlyScheduler as E, DefinedNodeCredentialAccessors as En, c as Et, RunnableOutputBehaviorResolver as F, CredentialResolverFactory as Fn, AgentMessageDto as Ft, ItemsInputNormalizer as G, AgentToolDefinition as Gt, ChildExecutionScopeFactory as H, AgentTool as Ht, ItemExprResolver as I, AbortControllerFactory as In, AgentMessageLine as It, node as J, AgentTurnLimitBehavior as Jt, chatModel as K, AgentToolExecuteArgs as Kt, InProcessRetryRunner as L, AgentMessageRole as Lt, NodeInstanceFactory as M, Clock as Mn, AgentGuardrailDefaults as Mt, NodeExecutor as N, SystemClock as Nn, AgentMessageBuildArgs as Nt, DefaultDrivingScheduler as O, DefinedNodeCredentialBindings as On, callableTool as Ot, NodeOutputNormalizer as P, NodeEventPublisher as Pn, AgentMessageConfig as Pt, PersistedRuntimeTypeMetadataStore as Q, ChatModelFactory as Qt, CatalogBackedCostTrackingTelemetryFactory as R, AgentMessageTemplate as Rt, RunSummaryMapper as S, DefineNodeExecuteArgs as Sn, CollectionFieldDefinition as St, InMemoryBinaryStorage as T, DefinedNodeConfigInput as Tn, DefinedCollection as Tt, DefaultExecutionBinaryService as U, AgentToolCall as Ut, AsyncSleeper as V, AgentNodeConfig as Vt, UnavailableBinaryStorage as W, AgentToolCallPlanner as Wt, StackTraceCallSitePathResolver as X, ChatLanguageModelCallOptions as Xt, tool as Y, ChatLanguageModel as Yt, PersistedRuntimeTypeNameResolver as Z, ChatModelConfig as Zt, PollingTriggerRuntime as _, NodeBackedToolConfig as _n, DefinedPollingTriggerConfig as _t, TestSuiteRunResult as a, Tool as an, ConnectionInvocationEventPublisher as at, EngineCompositionDeps as b, DefinedNodeRegistry as bn, CollectionColumnBuilder as bt, OAuthFlowExecutor as c, ZodSchemaAny as cn, AgentConnectionNodeDescriptor as ct, OAuthMaterial as d, AgentToolFactory as dn, DefinePollingTriggerExecuteContext as dt, NodeBackedToolInputMapper as en, PersistedRuntimeTypeDecoratorOptions as et, WorkflowEdgePortValidator as f, CallableToolKindToken as fn, DefinePollingTriggerOptions as ft, PollingRunCycleResult as g, CallableToolExecuteHandler as gn, DefinedPollingTrigger as gt, PollingRunCycleArgs as h, CallableToolConfigOptions as hn, DefinePollingTriggerTestItemsContext as ht, TestSuiteOrchestratorEngine as i, StructuredOutputOptions as in, InMemoryRunEventBus as it, StaticCostCatalog as j, defineNode as jn, AgentGuardrailConfig as jt, InlineDrivingScheduler as k, DefinedNodeRunContext as kn, AgentAttachmentRole as kt, OAuthFlowStartArgs as l, AgentConfigInspector as ln, AgentConnectionNodeRole as lt, WorkflowEdgePortValidationResult as m, CallableToolConfig as mn, DefinePollingTriggerPollResult as mt, TestSuiteCaseOutcome as n, NodeBackedToolOutputMapper as nn, PersistedRuntimeTypeMetadata as nt, TestSuiteRunIdFactory as o, ToolConfig as on, AgentConnectionCredentialSource as ot, WorkflowEdgePortError as p, CallableToolFactory as pn, DefinePollingTriggerPollContext as pt, getPersistedRuntimeTypeMetadata as q, AgentToolToken as qt, TestSuiteOrchestrator as r, NodeBackedToolOutputMapperArgs as rn, EventPublishingWorkflowExecutionRepository as rt, OAuthFlowCallbackArgs as s, ToolExecuteArgs as sn, AgentConnectionNodeCollector as st, RunTestSuiteArgs as t, NodeBackedToolInputMapperArgs as tn, PersistedRuntimeTypeKind as tt, OAuthFlowStartResult as u, AgentMessageConfigNormalizer as un, McpServerResolver as ut, PollingTriggerStartArgs as v, DefineCredentialOptions as vn, definePollingTrigger as vt, InMemoryRunDataFactory as w, DefinedNode as wn, DefineCollectionOptions as wt, EngineFactory as x, DefineBatchNodeOptions as xn, CollectionDefinition as xt, WorkflowRepositoryWebhookTriggerMatcher as y, defineCredential as yn, DefinedCollectionRegistry as yt, DefaultExecutionContextFactory as z, AgentMessageTemplateContent as zt };
-//# sourceMappingURL=index-Bes88mxT.d.ts.map
+export { PersistedRuntimeTypeDecoratorOptions as $, ConfigDrivenOffloadPolicy as A, DefinedNodeConfigInput as At, DefaultAsyncSleeper as B, CredentialResolverFactory as Bt, InMemoryWorkflowExecutionRepository as C, DefineCredentialOptions as Ct, HintOnlyOffloadPolicy as D, DefineNodeExecuteArgs as Dt, LocalOnlyScheduler as E, DefineBatchNodeOptions as Et, RunnableOutputBehaviorResolver as F, defineBatchNode as Ft, chatModel as G, ChildExecutionScopeFactory as H, ItemExprResolver as I, defineNode as It, tool as J, getPersistedRuntimeTypeMetadata as K, InProcessRetryRunner as L, Clock as Lt, NodeInstanceFactory as M, DefinedNodeCredentialBinding as Mt, NodeExecutor as N, DefinedNodeCredentialBindings as Nt, DefaultDrivingScheduler as O, DefineNodeOptions as Ot, NodeOutputNormalizer as P, DefinedNodeRunContext as Pt, InjectableRuntimeDecoratorComposer as Q, CatalogBackedCostTrackingTelemetryFactory as R, SystemClock as Rt, RunSummaryMapper as S, callableTool as St, InMemoryBinaryStorage as T, DefinedNodeRegistry as Tt, DefaultExecutionBinaryService as U, AsyncSleeper as V, AbortControllerFactory as Vt, UnavailableBinaryStorage as W, PersistedRuntimeTypeNameResolver as X, StackTraceCallSitePathResolver as Y, PersistedRuntimeTypeMetadataStore as Z, PollingTriggerRuntime as _, CollectionIndexDefinition as _t, TestSuiteRunResult as a, DefinePollingTriggerExecuteContext as at, EngineCompositionDeps as b, c as bt, OAuthFlowExecutor as c, DefinePollingTriggerPollResult as ct, OAuthMaterial as d, DefinedPollingTriggerConfig as dt, PersistedRuntimeTypeKind as et, WorkflowEdgePortValidator as f, definePollingTrigger as ft, PollingRunCycleResult as g, CollectionFieldDefinition as gt, PollingRunCycleArgs as h, CollectionDefinition as ht, TestSuiteOrchestratorEngine as i, ConnectionInvocationEventPublisher as it, StaticCostCatalog as j, DefinedNodeCredentialAccessors as jt, InlineDrivingScheduler as k, DefinedNode as kt, OAuthFlowStartArgs as l, DefinePollingTriggerTestItemsContext as lt, WorkflowEdgePortValidationResult as m, CollectionColumnBuilder as mt, TestSuiteCaseOutcome as n, EventPublishingWorkflowExecutionRepository as nt, TestSuiteRunIdFactory as o, DefinePollingTriggerOptions as ot, WorkflowEdgePortError as p, DefinedCollectionRegistry as pt, node as q, TestSuiteOrchestrator as r, InMemoryRunEventBus as rt, OAuthFlowCallbackArgs as s, DefinePollingTriggerPollContext as st, RunTestSuiteArgs as t, PersistedRuntimeTypeMetadata as tt, OAuthFlowStartResult as u, DefinedPollingTrigger as ut, PollingTriggerStartArgs as v, DefineCollectionOptions as vt, InMemoryRunDataFactory as w, defineCredential as wt, EngineFactory as x, defineCollection as xt, WorkflowRepositoryWebhookTriggerMatcher as y, DefinedCollection as yt, DefaultExecutionContextFactory as z, NodeEventPublisher as zt };
+//# sourceMappingURL=index-62Ba9f7D.d.ts.map