@codemation/core 0.13.2 → 0.15.0

package/dist/{ItemsInputNormalizer-Bi8m-Ijs.d.cts → ItemsInputNormalizer-A5txcOWX.d.cts}

@@ -1,48 +1,28 @@
-import { $t as RunnableNodeConfig, At as JsonValue, Ct as Item, Ki as NodeConnectionName, Nt as NodeConfigBase, Qr as TelemetrySpanScope, Tt as Items, Ut as NodeOutputs, Y as TypeToken, a as ConnectionInvocationId, b as PersistedRunState, en as RunnableNodeInputJson, ji as CredentialRequirement, qi as NodeId, rr as NodeExecutionContext } from "./agentMcpTypes-DGIwk6Ue.cjs";
-import { t as Expr } from "./params-DRUr0F5v.cjs";
+import { Et as Items, Ii as CredentialRequirement, Pt as NodeConfigBase, Qi as NodeId, Wt as NodeOutputs, Y as TypeToken, Zi as NodeConnectionName, a as ConnectionInvocationId, ar as NodeExecutionContext, b as PersistedRunState, jt as JsonValue, nn as RunnableNodeInputJson, ti as TelemetrySpanScope, tn as RunnableNodeConfig, wt as Item } from "./agentMcpTypes-BHX4RQCC.cjs";
+import { t as Expr } from "./params-CrK4iuG1.cjs";
 import { ZodType, input, output } from "zod";
 
 //#region src/contracts/mcpTypes.d.ts
 type McpServerTransport = "http";
 interface McpServerDeclaration {
-  /** Globally unique slug, e.g. "gmail". Workflow authors reference this. */
   id: string;
   displayName: string;
   description: string;
   transport: McpServerTransport;
   url: string;
-  /**
-   * Credential types accepted by this MCP server, matching CredentialRequirement.acceptedTypes.
-   * Absent or empty means no credential is required.
-   */
   acceptedCredentialTypes?: ReadonlyArray<string>;
-  /**
-   * Documentation only in MVP. The bind-time validator checks
-   * requiredScopes ⊆ CredentialInstance.scopesGranted.
-   */
   requiredScopes?: string[];
-  /** Non-secret static headers merged onto every MCP request. */
   staticHeaders?: Record<string, string>;
-  /**
-   * Overrides for tool descriptions advertised by the MCP server.
-   * Applied by the connection pool after tools/list.
-   * Key: exact tool name as returned by the server.
-   */
   toolDescriptionOverrides?: Record<string, string>;
 }
 //#endregion
 //#region src/contracts/runFinishedAtFactory.d.ts
 type RunFinishedAtSource = Pick<PersistedRunState, "status" | "nodeSnapshotsByNodeId" | "finishedAt">;
-/** Derives workflow end time from persisted run root or node snapshots for run listings. */
 declare class RunFinishedAtFactory {
   static resolveIso(state: RunFinishedAtSource): string | undefined;
 }
 //#endregion
 //#region src/workflow/definition/ConnectionNodeIdFactory.d.ts
-/**
- * Deterministic ids for workflow connection-owned child nodes (LLM slot, tools, etc.).
- * These are stable across loads.
- */
 declare class ConnectionNodeIdFactory {
   static readonly connectionSegment: "__conn__";
   static languageModelConnectionNodeId(parentNodeId: NodeId): NodeId;
@@ -62,29 +42,14 @@ declare class ConnectionNodeIdFactory {
     parentNodeId: NodeId;
     normalizedToolName: string;
   }> | undefined;
-  /** True when `nodeId` is a connection-owned child of `parentNodeId` (LLM or tool slot). */
   static isConnectionOwnedDescendantOf(parentNodeId: NodeId, nodeId: NodeId): boolean;
-  /** Normalizes a tool display name to a stable id segment. */
   static normalizeToolName(toolName: string): string;
 }
 //#endregion
 //#region src/workflow/definition/NodeIterationIdFactory.d.ts
-/**
- * Unique ids for one per-item iteration of a runnable node's execute loop.
- *
- * Activations are per-batch (one scheduled execution of a node, possibly with N items).
- * Iterations refine that to one identifier per item-index inside the batch loop, so per-item
- * connection invocations and telemetry can be grouped without time-window heuristics.
- *
- * Uses Web Crypto's `randomUUID` (Node 19+ and all modern browsers) so this module is safe
- * to include in the browser entry. Importing `node:crypto` here previously leaked into the
- * canvas client bundle through `browser.ts` and OOM'd consumers' Turbopack builds.
- */
 declare class NodeIterationIdFactory {
   static create(): string;
-  /** Deterministic id for tests when a stable sequence is needed. */
   static createForTest(seed: string, sequence: number): string;
-  /** Deterministic id derived from a connection node id (for sub-agent / tool-call scopes). */
   static createForConnection(connectionNodeId: NodeId, sequence: number): string;
 }
 //#endregion
@@ -119,15 +84,9 @@ type CallableToolConfigOptions<TInputSchema extends ZodSchemaAny, TOutputSchema
   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>;
@@ -142,9 +101,6 @@ declare class CallableToolConfig<TInputSchema extends ZodSchemaAny, TOutputSchem
   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;
@@ -158,10 +114,6 @@ declare class CallableToolFactoryImpl {
 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
@@ -177,10 +129,6 @@ 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;
@@ -214,11 +162,6 @@ type ToolExecuteArgs<TConfig extends ToolConfig = ToolConfig, TInput = unknown>
   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;
@@ -249,12 +192,7 @@ 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>;
@@ -269,7 +207,6 @@ interface AgentGuardrailConfig {
   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;
@@ -293,25 +230,10 @@ interface ChatModelConfig {
   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 {
@@ -319,14 +241,8 @@ interface ChatLanguageModelCallOptions {
   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 extends ChatModelConfig = ChatModelConfig> {
@@ -361,12 +277,6 @@ type NodeBackedToolConfigOptions<TNodeConfig extends RunnableNodeConfig<any, any
   outputSchema: TOutputSchema;
   mapInput?: NodeBackedToolInputMapper<TNodeConfig, input<TInputSchema>>;
   mapOutput?: NodeBackedToolOutputMapper<TNodeConfig, input<TInputSchema>, output<TOutputSchema>>;
-  /**
-   * Marks THIS tool binding as human-in-the-loop and sets the behavior when a human rejects the
-   * approval: `"return"` feeds the rejection back to the agent as a tool result, `"halt"` stops the
-   * run. Set per binding, so two tools backed by the same node can reject differently. When set, it
-   * takes precedence over any `humanApprovalToolBehavior` marker carried by the backing node.
-   */
   onRejected?: "halt" | "return";
 }>;
 interface AgentNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends RunnableNodeConfig<TInputJson, TOutputJson> {
@@ -400,11 +310,6 @@ type AgentConnectionNodeCollectorApi = Readonly<{
 declare const AgentConnectionNodeCollector: AgentConnectionNodeCollectorApi;
 //#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;
@@ -412,4 +317,4 @@ declare class ItemsInputNormalizer {
 }
 //#endregion
 export { McpServerDeclaration as $, ChatModelFactory as A, ZodSchemaAny as B, AgentToolDefinition as C, ChatLanguageModel as D, AgentTurnLimitBehavior as E, NodeBackedToolOutputMapperArgs as F, CallableToolFactory as G, AgentMessageConfigNormalizer as H, StructuredOutputOptions as I, CallableToolExecuteHandler as J, CallableToolConfig as K, Tool as L, NodeBackedToolInputMapper as M, NodeBackedToolInputMapperArgs as N, ChatLanguageModelCallOptions as O, NodeBackedToolOutputMapper as P, RunFinishedAtFactory as Q, ToolConfig as R, AgentToolCallPlanner as S, AgentToolToken as T, AgentToolFactory as U, AgentConfigInspector as V, CallableToolKindToken as W, NodeIterationIdFactory as X, NodeBackedToolConfig as Y, ConnectionNodeIdFactory as Z, AgentMessageTemplateContent as _, AgentConnectionNodeRole as a, AgentTool as b, AgentCanvasPresentation as c, AgentMessageBuildArgs as d, McpServerTransport as et, AgentMessageConfig as f, AgentMessageTemplate as g, AgentMessageRole as h, AgentConnectionNodeDescriptor as i, NodeBackedToolConfigOptions as j, ChatModelConfig as k, AgentGuardrailConfig as l, AgentMessageLine as m, AgentConnectionCredentialSource as n, McpServerResolver as o, AgentMessageDto as p, CallableToolConfigOptions as q, AgentConnectionNodeCollector as r, AgentAttachmentRole as s, ItemsInputNormalizer as t, AgentGuardrailDefaults as u, AgentModelInvocationOptions as v, AgentToolExecuteArgs as w, AgentToolCall as x, AgentNodeConfig as y, ToolExecuteArgs as z };
-//# sourceMappingURL=ItemsInputNormalizer-Bi8m-Ijs.d.cts.map
+//# sourceMappingURL=ItemsInputNormalizer-A5txcOWX.d.cts.map

package/dist/{ItemsInputNormalizer-BbQTSEkZ.cjs → ItemsInputNormalizer-C1fv3sMW.cjs}

@@ -1,4 +1,4 @@
-const require_di = require('./di-LP2qSHkY.cjs');
+const require_di = require('./di-C6Ubf9o5.cjs');
 let tsyringe = require("tsyringe");
 tsyringe = require_di.__toESM(tsyringe);
 
@@ -40,4 +40,4 @@ Object.defineProperty(exports, 'ItemsInputNormalizer', {
     return ItemsInputNormalizer;
   }
 });
-//# sourceMappingURL=ItemsInputNormalizer-BbQTSEkZ.cjs.map
+//# sourceMappingURL=ItemsInputNormalizer-C1fv3sMW.cjs.map

package/dist/ItemsInputNormalizer-C1fv3sMW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemsInputNormalizer-C1fv3sMW.cjs","names":["ItemsInputNormalizer"],"sources":["../src/serialization/ItemsInputNormalizer.ts"],"sourcesContent":["import type { Item, Items } from \"../contracts/workflowTypes\";\nimport { injectable } from \"../di\";\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"],"mappings":";;;;;;;;;;;;;;AAIO,iCAAMA,uBAAqB;CAChC,UAAU,KAAqB;AAC7B,MAAI,QAAQ,UAAa,QAAQ,KAC/B,QAAO,EAAE;AAEX,MAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAK,UAAU,KAAK,cAAc,MAAM,CAAC;AAEtD,SAAO,CAAC,KAAK,cAAc,IAAI,CAAC;;CAGlC,AAAQ,cAAc,KAAoB;AACxC,MAAI,CAAC,KAAK,OAAO,IAAI,CACnB,QAAO,EAAE,MAAM,KAAK;AAEtB,SAAO;GACL,MAAM,IAAI;GACV,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC1D,GAAI,IAAI,SAAS,SAAY,EAAE,GAAG,EAAE,MAAM,IAAI,MAAM;GACpD,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC3D;;CAGH,AAAQ,OAAO,KAA2B;AACxC,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,OAAO,UAAU,eAAe,KAAK,KAAK,OAAO;;;6DAzB1F"}

package/dist/{ItemsInputNormalizer-BYljnXU0.d.ts → ItemsInputNormalizer-D2vrMrX1.d.ts}

@@ -1,4 +1,4 @@
-import { Eo as NodeId, Ii as NodeExecutionContext, Mr as RunnableNodeConfig, Nr as RunnableNodeInputJson, On as TypeToken, Rt as ConnectionInvocationId, Sr as NodeOutputs, To as NodeConnectionName, fr as NodeConfigBase, gt as Expr, ir as Items, ja as TelemetrySpanScope, lr as JsonValue, nr as Item, q as McpServerDeclaration, uo as CredentialRequirement } from "./index-rllWL4r-.js";
+import { $i as NodeExecutionContext, $t as ConnectionInvocationId, Ao as CredentialRequirement, Et as Expr, Go as NodeConnectionName, Ko as NodeId, Or as NodeConfigBase, Rr as NodeOutputs, Tr as JsonValue, Un as TypeToken, Xr as RunnableNodeInputJson, Y as McpServerDeclaration, Ya as TelemetrySpanScope, Yr as RunnableNodeConfig, br as Items, vr as Item } from "./index-CRv3_pY3.js";
 import { ZodType, input, output } from "zod";
 
 //#region src/ai/NodeBackedToolConfig.d.ts
@@ -33,15 +33,9 @@ type CallableToolConfigOptions<TInputSchema extends ZodSchemaAny, TOutputSchema
   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>;
@@ -56,9 +50,6 @@ declare class CallableToolConfig<TInputSchema extends ZodSchemaAny, TOutputSchem
   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;
@@ -72,10 +63,6 @@ declare class CallableToolFactoryImpl {
 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
@@ -91,10 +78,6 @@ 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;
@@ -128,11 +111,6 @@ type ToolExecuteArgs<TConfig extends ToolConfig = ToolConfig, TInput = unknown>
   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;
@@ -163,12 +141,7 @@ 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>;
@@ -183,7 +156,6 @@ interface AgentGuardrailConfig {
   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;
@@ -207,25 +179,10 @@ interface ChatModelConfig {
   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 {
@@ -233,14 +190,8 @@ interface ChatLanguageModelCallOptions {
   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 extends ChatModelConfig = ChatModelConfig> {
@@ -275,12 +226,6 @@ type NodeBackedToolConfigOptions<TNodeConfig extends RunnableNodeConfig<any, any
   outputSchema: TOutputSchema;
   mapInput?: NodeBackedToolInputMapper<TNodeConfig, input<TInputSchema>>;
   mapOutput?: NodeBackedToolOutputMapper<TNodeConfig, input<TInputSchema>, output<TOutputSchema>>;
-  /**
-   * Marks THIS tool binding as human-in-the-loop and sets the behavior when a human rejects the
-   * approval: `"return"` feeds the rejection back to the agent as a tool result, `"halt"` stops the
-   * run. Set per binding, so two tools backed by the same node can reject differently. When set, it
-   * takes precedence over any `humanApprovalToolBehavior` marker carried by the backing node.
-   */
   onRejected?: "halt" | "return";
 }>;
 interface AgentNodeConfig<TInputJson = unknown, TOutputJson = unknown> extends RunnableNodeConfig<TInputJson, TOutputJson> {
@@ -314,11 +259,6 @@ type AgentConnectionNodeCollectorApi = Readonly<{
 declare const AgentConnectionNodeCollector: AgentConnectionNodeCollectorApi;
 //#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;
@@ -326,4 +266,4 @@ declare class ItemsInputNormalizer {
 }
 //#endregion
 export { ChatModelFactory as A, ZodSchemaAny as B, AgentToolDefinition as C, ChatLanguageModel as D, AgentTurnLimitBehavior as E, NodeBackedToolOutputMapperArgs as F, CallableToolFactory as G, AgentMessageConfigNormalizer as H, StructuredOutputOptions as I, CallableToolExecuteHandler as J, CallableToolConfig as K, Tool as L, NodeBackedToolInputMapper as M, NodeBackedToolInputMapperArgs as N, ChatLanguageModelCallOptions as O, NodeBackedToolOutputMapper as P, ToolConfig as R, AgentToolCallPlanner as S, AgentToolToken as T, AgentToolFactory as U, AgentConfigInspector as V, CallableToolKindToken as W, NodeBackedToolConfig as Y, AgentMessageTemplateContent as _, AgentConnectionNodeRole as a, AgentTool as b, AgentCanvasPresentation as c, AgentMessageBuildArgs as d, AgentMessageConfig as f, AgentMessageTemplate as g, AgentMessageRole as h, AgentConnectionNodeDescriptor as i, NodeBackedToolConfigOptions as j, ChatModelConfig as k, AgentGuardrailConfig as l, AgentMessageLine as m, AgentConnectionCredentialSource as n, McpServerResolver as o, AgentMessageDto as p, CallableToolConfigOptions as q, AgentConnectionNodeCollector as r, AgentAttachmentRole as s, ItemsInputNormalizer as t, AgentGuardrailDefaults as u, AgentModelInvocationOptions as v, AgentToolExecuteArgs as w, AgentToolCall as x, AgentNodeConfig as y, ToolExecuteArgs as z };
-//# sourceMappingURL=ItemsInputNormalizer-BYljnXU0.d.ts.map
+//# sourceMappingURL=ItemsInputNormalizer-D2vrMrX1.d.ts.map

package/dist/{ItemsInputNormalizer-CSZGMgl3.js → ItemsInputNormalizer-fUYo4GLV.js}

@@ -1,4 +1,4 @@
-import { a as injectable } from "./di-tom0pM2h.js";
+import { a as injectable } from "./di-Cjiil7U-.js";
 
 //#region \0@oxc-project+runtime@0.95.0/helpers/decorate.js
 function __decorate(decorators, target, key, desc) {
@@ -33,4 +33,4 @@ ItemsInputNormalizer = __decorate([injectable()], ItemsInputNormalizer);
 
 //#endregion
 export { ItemsInputNormalizer as t };
-//# sourceMappingURL=ItemsInputNormalizer-CSZGMgl3.js.map
+//# sourceMappingURL=ItemsInputNormalizer-fUYo4GLV.js.map

package/dist/ItemsInputNormalizer-fUYo4GLV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemsInputNormalizer-fUYo4GLV.js","names":["ItemsInputNormalizer"],"sources":["../src/serialization/ItemsInputNormalizer.ts"],"sourcesContent":["import type { Item, Items } from \"../contracts/workflowTypes\";\nimport { injectable } from \"../di\";\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"],"mappings":";;;;;;;;;;;;AAIO,iCAAMA,uBAAqB;CAChC,UAAU,KAAqB;AAC7B,MAAI,QAAQ,UAAa,QAAQ,KAC/B,QAAO,EAAE;AAEX,MAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAK,UAAU,KAAK,cAAc,MAAM,CAAC;AAEtD,SAAO,CAAC,KAAK,cAAc,IAAI,CAAC;;CAGlC,AAAQ,cAAc,KAAoB;AACxC,MAAI,CAAC,KAAK,OAAO,IAAI,CACnB,QAAO,EAAE,MAAM,KAAK;AAEtB,SAAO;GACL,MAAM,IAAI;GACV,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC1D,GAAI,IAAI,SAAS,SAAY,EAAE,GAAG,EAAE,MAAM,IAAI,MAAM;GACpD,GAAI,IAAI,WAAW,SAAY,EAAE,GAAG,EAAE,QAAQ,IAAI,QAAQ;GAC3D;;CAGH,AAAQ,OAAO,KAA2B;AACxC,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,OAAO,UAAU,eAAe,KAAK,KAAK,OAAO;;;mCAzBtG,YAAY"}

package/dist/{RunIntentService-BitgkKaT.d.cts → RunIntentService-DKxuHTUz.d.cts}

@@ -1,4 +1,4 @@
-import { Ar as WorkflowSnapshotResolver, D as RunCurrentState, Er as WorkflowRepository, Fr as WebhookTriggerMatcher, H as WorkflowExecutionRepository, I as RunStopCondition, Ir as WebhookTriggerResolution, Mt as NodeActivationId, N as RunResult, Pr as WebhookInvocationMatch, Tt as Items, Ut as NodeOutputs, Xi as WorkflowId, Yn as LiveWorkflowRepository, Zn as NodeActivationContinuation, Zt as RunId, ar as NodeExecutionRequestHandler, ir as NodeExecutionRequest, jr as HttpMethod, k as RunExecutionOptions, on as WorkflowDefinition, p as NodeInputsByPort, pr as ResumeContext, qi as NodeId, qt as ParentExecutionRef, s as CurrentStateExecutionRequest, w as PersistedWorkflowTokenRegistryLike, z as WebhookRunResult } from "./agentMcpTypes-DGIwk6Ue.cjs";
+import { $n as NodeActivationContinuation, $t as RunId, D as RunCurrentState, Et as Items, H as WorkflowExecutionRepository, I as RunStopCondition, Jt as ParentExecutionRef, Lr as WebhookInvocationMatch, N as RunResult, Nr as WorkflowSnapshotResolver, Nt as NodeActivationId, Pr as HttpMethod, Qi as NodeId, Rr as WebhookTriggerMatcher, Wt as NodeOutputs, Zn as LiveWorkflowRepository, cn as WorkflowDefinition, hr as ResumeContext, k as RunExecutionOptions, kr as WorkflowRepository, or as NodeExecutionRequest, p as NodeInputsByPort, s as CurrentStateExecutionRequest, sr as NodeExecutionRequestHandler, ta as WorkflowId, w as PersistedWorkflowTokenRegistryLike, z as WebhookRunResult, zr as WebhookTriggerResolution } from "./agentMcpTypes-BHX4RQCC.cjs";
 
 //#region src/orchestration/Engine.d.ts
 interface EngineTriggerRuntime {
@@ -71,11 +71,6 @@ interface EngineFacadeDeps {
   runContinuationService: EngineRunContinuationService;
   nodeExecutionRequestHandler: EngineNodeExecutionRequestHandler;
 }
-/**
- * Runtime facade for orchestration, continuation, triggers, and webhook routing.
- * Prefer {@link import("../intents/RunIntentService").RunIntentService} for host/HTTP invocation boundaries.
- * The class token is exported from `@codemation/core/bootstrap` (not the main `@codemation/core` barrel).
- */
 declare class Engine implements NodeActivationContinuation, NodeExecutionRequestHandler {
   private readonly deps;
   constructor(deps: EngineFacadeDeps);
@@ -136,10 +131,6 @@ declare class Engine implements NodeActivationContinuation, NodeExecutionRequest
     status: "completed" | "failed" | "halted";
   }>>;
   waitForWebhookResponse(runId: RunId): Promise<WebhookRunResult>;
-  /**
-   * Re-activate a suspended run item with a human decision (HITL).
-   * The HTTP resume endpoint calls this; this method exposes the engine primitive.
-   */
   resumeRun(args: {
     runId: RunId;
     taskId: string;
@@ -209,12 +200,8 @@ declare class RunIntentService {
   }): WebhookTriggerResolution;
   runMatchedWebhook(args: MatchedWebhookRunIntent): Promise<WebhookRunResult>;
   runWebhookMatch(args: WebhookMatchRunIntent): Promise<WebhookRunResult>;
-  /**
-   * Webhook-triggered runs always force inline execution first.
-   * This is the highest-precedence scheduler override: it wins over node hints and container defaults.
-   */
   private createWebhookExecutionOptions;
 }
 //#endregion
 export { InMemoryLiveWorkflowRepository as n, Engine as r, RunIntentService as t };
-//# sourceMappingURL=RunIntentService-BitgkKaT.d.cts.map
+//# sourceMappingURL=RunIntentService-DKxuHTUz.d.cts.map

package/dist/{RunIntentService-DYpqfu6D.d.ts → RunIntentService-DrpKli2k.d.ts}

@@ -1,4 +1,4 @@
-import { $t as PersistedRunState, Ai as NodeActivationContinuation, Ar as RunId, Bt as CurrentStateExecutionRequest, Dr as PersistedRunPolicySnapshot, Eo as NodeId, Er as ParentExecutionRef, Hi as NodeResolver, Hn as EngineExecutionLimitsPolicyConfig, Hr as WorkflowErrorHandlerSpec, Jr as WorkflowStoragePolicyDecisionArgs, Ki as ResumeContext, Kr as WorkflowPolicyRuntimeDefaults, Kt as NodeInputsByPort, Li as NodeExecutionRequest, Oi as LiveWorkflowRepository, Ri as NodeExecutionRequestHandler, Sr as NodeOutputs, Vn as EngineExecutionLimitsPolicy, Vr as WorkflowErrorHandler, aa as WorkflowRepository, cn as RunExecutionOptions, dr as NodeActivationId, fn as RunResult, fr as NodeConfigBase, gr as NodeErrorHandlerSpec, ha as WebhookTriggerResolution, hn as RunStopCondition, ir as Items, ko as WorkflowId, la as WorkflowSnapshotResolver, ma as WebhookTriggerMatcher, mr as NodeErrorHandler, nn as PersistedWorkflowSnapshotNode, on as RunCurrentState, pa as WebhookInvocationMatch, rn as PersistedWorkflowTokenRegistryLike, tn as PersistedWorkflowSnapshot, ua as HttpMethod, vn as WebhookRunResult, xn as WorkflowExecutionRepository, zr as WorkflowDefinition } from "./index-rllWL4r-.js";
+import { An as RunStopCondition, Ar as NodeErrorHandler, Ca as WorkflowRepository, Cn as RunExecutionOptions, Da as WorkflowSnapshotResolver, Dn as RunResult, Dr as NodeActivationId, Gi as LiveWorkflowRepository, Hr as ParentExecutionRef, In as WorkflowExecutionRepository, Ko as NodeId, Ma as WebhookTriggerMatcher, Mr as NodeErrorHandlerSpec, Na as WebhookTriggerResolution, Nn as WebhookRunResult, Oa as HttpMethod, Or as NodeConfigBase, Rr as NodeOutputs, Ur as PersistedRunPolicySnapshot, Yo as WorkflowId, _n as PersistedWorkflowSnapshotNode, aa as NodeResolver, ai as WorkflowErrorHandlerSpec, br as Items, di as WorkflowStoragePolicyDecisionArgs, ea as NodeExecutionRequest, gn as PersistedWorkflowSnapshot, ii as WorkflowErrorHandler, ir as EngineExecutionLimitsPolicyConfig, ja as WebhookInvocationMatch, la as ResumeContext, li as WorkflowPolicyRuntimeDefaults, mn as PersistedRunState, ni as WorkflowDefinition, qi as NodeActivationContinuation, qr as RunId, rr as EngineExecutionLimitsPolicy, sn as NodeInputsByPort, ta as NodeExecutionRequestHandler, tn as CurrentStateExecutionRequest, vn as PersistedWorkflowTokenRegistryLike, xn as RunCurrentState } from "./index-CRv3_pY3.js";
 
 //#region src/orchestration/Engine.d.ts
 interface EngineTriggerRuntime {
@@ -71,11 +71,6 @@ interface EngineFacadeDeps {
   runContinuationService: EngineRunContinuationService;
   nodeExecutionRequestHandler: EngineNodeExecutionRequestHandler;
 }
-/**
- * Runtime facade for orchestration, continuation, triggers, and webhook routing.
- * Prefer {@link import("../intents/RunIntentService").RunIntentService} for host/HTTP invocation boundaries.
- * The class token is exported from `@codemation/core/bootstrap` (not the main `@codemation/core` barrel).
- */
 declare class Engine implements NodeActivationContinuation, NodeExecutionRequestHandler {
   private readonly deps;
   constructor(deps: EngineFacadeDeps);
@@ -136,10 +131,6 @@ declare class Engine implements NodeActivationContinuation, NodeExecutionRequest
     status: "completed" | "failed" | "halted";
   }>>;
   waitForWebhookResponse(runId: RunId): Promise<WebhookRunResult>;
-  /**
-   * Re-activate a suspended run item with a human decision (HITL).
-   * The HTTP resume endpoint calls this; this method exposes the engine primitive.
-   */
   resumeRun(args: {
     runId: RunId;
     taskId: string;
@@ -178,9 +169,6 @@ declare class WorkflowPolicyErrorServices {
 }
 //#endregion
 //#region src/policies/executionLimits/EngineExecutionLimitsPolicyFactory.d.ts
-/**
- * Builds {@link EngineExecutionLimitsPolicy} by merging {@link ENGINE_EXECUTION_LIMITS_DEFAULTS} with optional `overrides` (e.g. host `runtime.engineExecutionLimits`).
- */
 declare class EngineExecutionLimitsPolicyFactory {
   create(overrides?: Partial<EngineExecutionLimitsPolicyConfig>): EngineExecutionLimitsPolicy;
 }
@@ -197,10 +185,6 @@ declare class WorkflowSnapshotCodec {
   create(workflow: WorkflowDefinition): PersistedWorkflowSnapshot;
   hydrate(snapshotNode: PersistedWorkflowSnapshotNode, liveConfig: NodeConfigBase): NodeConfigBase;
   private serializeConfig;
-  /**
-   * Safely call `config.inspectorSummary()` and return a plain JSON-safe array, or undefined.
-   * Returns undefined if the method is absent, throws, or produces no valid rows.
-   */
   private safeInspectorSummary;
   private injectTokenIds;
   private mergeValue;
@@ -288,12 +272,8 @@ declare class RunIntentService {
   }): WebhookTriggerResolution;
   runMatchedWebhook(args: MatchedWebhookRunIntent): Promise<WebhookRunResult>;
   runWebhookMatch(args: WebhookMatchRunIntent): Promise<WebhookRunResult>;
-  /**
-   * Webhook-triggered runs always force inline execution first.
-   * This is the highest-precedence scheduler override: it wins over node hints and container defaults.
-   */
   private createWebhookExecutionOptions;
 }
 //#endregion
 export { RunPolicySnapshotFactory as a, RunTerminalPersistenceCoordinator as c, WorkflowSnapshotCodec as i, WorkflowStoragePolicyEvaluator as l, InMemoryLiveWorkflowRepository as n, EngineExecutionLimitsPolicyFactory as o, EngineWorkflowRunnerService as r, WorkflowPolicyErrorServices as s, RunIntentService as t, Engine as u };
-//# sourceMappingURL=RunIntentService-DYpqfu6D.d.ts.map
+//# sourceMappingURL=RunIntentService-DrpKli2k.d.ts.map