@codemation/core 0.10.2 → 0.11.1

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

@@ -1,5 +1,7 @@
-import { $t as PersistedRunPolicySnapshot, Aa as TypeToken, Ai as CredentialSessionFactoryArgs, Bi as PollingTriggerLogger, Bn as BinaryStorageWriteResult, Bt as NodeDefinition, Ca as WorkflowExecutionRepository, Cr as WorkflowRepository, Fi as CredentialTypeId, Fn as BinaryBody, Ga as RunEvent, Gn as ExecutionContext, In as BinaryStorage, Ir as WorkflowActivationPolicy, It as JsonValue, Ja as TestCaseRunStatus, Jt as NodeOutputs, Ka as RunEventBus, Ki as EngineRunCounters, Kn as ExecutionContextFactory, Ln as BinaryStorageReadResult, Lr as ExecutionTelemetry, Lt as MutableRunData, Mr as WebhookTriggerMatcher, Ni as CredentialType, Nn as RetryPolicySpec, Oi as CredentialRequirement, Or as HttpMethod, Ot as ExecutionMode, Pi as CredentialTypeDefinition, Pr as WebhookTriggerRoutingDiagnostics, Qn as NodeActivationRequest, Qt as ParentExecutionRef, Rn as BinaryStorageStatResult, Rr as ExecutionTelemetryFactory, Rt as NodeActivationId, Sa as WorkflowExecutionPruneRepository, Sr as WorkflowNodeInstanceFactory, Tt as BinaryAttachment, Ua as EngineExecutionLimitsPolicy, Ui as ConnectionInvocationId, Vn as EngineDeps, Wi as ConnectionInvocationRecord, Wn as ExecutionBinaryService, Xa as TestSuiteRunId, Xn as NodeActivationContinuation, Xt as NodeSchedulerDecision, Ya as TestSuiteRunStatus, Yi as NodeExecutionSnapshot, Yr as TelemetrySpanScope, aa as PersistedWorkflowSnapshotNode, an as RunnableNodeInputJson, ar as NodeExecutionScheduler, br as TriggerSetupStateRepository, ci as CostTrackingTelemetryFactory, cr as NodeResolver, ct as Expr, da as RunExecutionOptions, dn as WorkflowDefinition, dr as PreparedNodeActivationDispatch, en as RunDataFactory, eo as NodeConnectionName, er as NodeActivationScheduler, fa as RunPruneCandidate, fi as CollectionsContext, i as WorkflowSnapshotCodec, in as RunnableNodeConfig, io as WorkflowId, ji as CredentialSessionService, jr as WebhookInvocationMatch, jt as Items, kr as TriggerInstanceId, kt as Item, ma as RunResult, na as PersistedRunSchedulingState, nn as RunId, nr as NodeExecutionContext, oi as CostTrackingTelemetry, or as NodeExecutionStatePublisher, ot as CostCatalog, pi as AnyCredentialType, qa as RunEventSubscription, qt as NodeOffloadPolicy, ra as PersistedRunState, rr as NodeExecutionRequest, sn as TriggerNodeConfig, st as CostCatalogEntry, tn as RunDataSnapshot, to as NodeId, tr as NodeBinaryAttachmentService, u as Engine, ui as CostTrackingUsageRecord, ut as ParamDeep, va as RunSummary, vi as CredentialFieldSchema, wi as CredentialJsonRecord, wt as ActivationIdFactory, xa as WorkflowExecutionListingRepository, xr as TriggerTestItemsContext, ya as RunTestContext, yi as CredentialHealth, zt as NodeConfigBase } from "./RunIntentService-CI-F8qQ7.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
 /**
@@ -101,6 +103,15 @@ interface DefineNodeOptions<TKey$1 extends string, TConfig$1 extends CredentialJ
   readonly inputSchema?: ZodType<TInputJson>;
   /** Preserve inbound `item.binary` when `execute` returns plain JSON or item-shaped results without `binary`. */
   readonly keepBinaries?: boolean;
+  /**
+   * Static configuration summary surfaced in the workflow inspector — see
+   * {@link import("../contracts/workflowTypes").NodeConfigBase.inspectorSummary}.
+   *
+   * Receives the static config; returns 2–6 short label/value pairs (or `undefined` to skip).
+   */
+  readonly inspectorSummary?: (args: Readonly<{
+    config: TConfig$1;
+  }>) => ReadonlyArray<NodeInspectorSummaryRow> | undefined;
   execute(args: DefineNodeExecuteArgs<TConfig$1, TInputJson>, context: DefinedNodeRunContext<TConfig$1, TBindings>): MaybePromise$2<TOutputJson>;
 }
 /**
@@ -114,6 +125,9 @@ interface DefineBatchNodeOptions<TKey$1 extends string, TConfig$1 extends Creden
   readonly input?: Readonly<Record<keyof TConfig$1 & string, unknown>>;
   readonly configSchema?: z.ZodType<TConfig$1>;
   readonly credentials?: TBindings;
+  readonly inspectorSummary?: (args: Readonly<{
+    config: TConfig$1;
+  }>) => ReadonlyArray<NodeInspectorSummaryRow> | undefined;
   run(items: ReadonlyArray<TInputJson>, context: DefinedNodeRunContext<TConfig$1, TBindings>): MaybePromise$2<ReadonlyArray<TOutputJson>>;
 }
 declare function defineNode<TKey$1 extends string, TConfig$1 extends CredentialJsonRecord, TInputJson, TOutputJson, TBindings extends DefinedNodeCredentialBindings | undefined = undefined>(options: DefineNodeOptions<TKey$1, TConfig$1, TInputJson, TOutputJson, TBindings>): DefinedNode<TKey$1, TConfig$1, TInputJson, TOutputJson, TBindings>;
@@ -147,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}).
@@ -549,6 +281,15 @@ interface DefinePollingTriggerOptions<TKey$1 extends string, TConfig$1 extends C
   readonly configSchema?: ZodType<TConfig$1>;
   /** Credential bindings keyed by slot (same format as `defineNode`). */
   readonly credentials?: TBindings;
+  /**
+   * Static configuration summary surfaced in the workflow inspector — see
+   * {@link import("../contracts/workflowTypes").NodeConfigBase.inspectorSummary}.
+   *
+   * Receives the static config; returns 2–6 short label/value pairs (or `undefined` to skip).
+   */
+  readonly inspectorSummary?: (args: Readonly<{
+    config: TConfig$1;
+  }>) => ReadonlyArray<NodeInspectorSummaryRow> | undefined;
   /**
    * Called once when the trigger arms (or re-arms after a server restart) to provide the
    * initial value for `state` when no persisted state exists.
@@ -618,11 +359,15 @@ declare class DefinedPollingTriggerConfig<TConfig$1 extends CredentialJsonRecord
   readonly cfg: TConfig$1;
   private readonly credentialRequirements;
   readonly id?: string | undefined;
+  private readonly inspectorSummaryFn?;
   readonly kind: "trigger";
   readonly type: TypeToken<unknown>;
   readonly icon: string | undefined;
-  constructor(name: string, cfg: TConfig$1, typeToken: TypeToken<unknown>, icon: string | undefined, credentialRequirements: ReadonlyArray<CredentialRequirement>, id?: string | undefined);
+  constructor(name: string, cfg: TConfig$1, typeToken: TypeToken<unknown>, icon: string | undefined, credentialRequirements: ReadonlyArray<CredentialRequirement>, id?: string | undefined, inspectorSummaryFn?: ((args: Readonly<{
+    config: TConfig$1;
+  }>) => ReadonlyArray<NodeInspectorSummaryRow> | undefined) | undefined);
   getCredentialRequirements(): ReadonlyArray<CredentialRequirement>;
+  inspectorSummary(): ReadonlyArray<NodeInspectorSummaryRow> | undefined;
 }
 /**
  * Declarative helper for authoring polling triggers.
@@ -648,26 +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 AgentConnectionNodeCollectorApi = Readonly<{
-  collect(parentNodeId: NodeId, agentConfig: AgentNodeConfig<any, any>): ReadonlyArray<AgentConnectionNodeDescriptor>;
-}>;
-declare const AgentConnectionNodeCollector: AgentConnectionNodeCollectorApi;
-//#endregion
 //#region src/events/ConnectionInvocationEventPublisher.d.ts
 /**
  * Publishes per-invocation lifecycle records onto the run {@link RunEventBus}.
@@ -775,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";
@@ -796,6 +509,8 @@ declare class UnavailableBinaryStorage implements BinaryStorage {
     exists: false;
   }>;
   delete(): Promise<void>;
+  deleteMany(): Promise<void>;
+  listByPrefix(): Promise<ReadonlyArray<string>>;
 }
 //#endregion
 //#region src/binaries/DefaultExecutionBinaryServiceFactory.d.ts
@@ -886,9 +601,10 @@ declare class CatalogBackedCostTrackingTelemetryFactory implements CostTrackingT
 declare class InProcessRetryRunner {
   private readonly sleeper;
   constructor(sleeper: AsyncSleeper);
-  run<T>(policy: RetryPolicySpec | undefined, work: () => Promise<T>): Promise<T>;
+  run<T>(policy: RetryPolicySpec | undefined, work: () => Promise<T>, shouldRetry?: (error: unknown) => boolean, warn?: (message: string) => void): Promise<T>;
   private static delayAfterFailureMs;
   private static normalizePolicy;
+  private static clampMaxAttempts;
   private static assertPositiveInt;
   private static assertNonNegativeFinite;
   private static assertMultiplier;
@@ -935,6 +651,8 @@ declare class NodeExecutor {
   private readonly outputBehaviorResolver;
   constructor(nodeInstanceFactory: WorkflowNodeInstanceFactory, retryRunner: InProcessRetryRunner, itemExprResolver?: ItemExprResolver, outputBehaviorResolver?: RunnableOutputBehaviorResolver);
   execute(request: NodeActivationRequest): Promise<NodeOutputs>;
+  private assertRequiredCredentialsBound;
+  private isCredentialError;
   private executeMultiInputActivation;
   private executeSingleInputNode;
   private isTriggerNode;
@@ -1043,6 +761,8 @@ declare class InMemoryBinaryStorage implements BinaryStorage {
   openReadStream(storageKey: string): Promise<BinaryStorageReadResult | undefined>;
   stat(storageKey: string): Promise<BinaryStorageStatResult>;
   delete(storageKey: string): Promise<void>;
+  deleteMany(storageKeys: ReadonlyArray<string>): Promise<void>;
+  listByPrefix(prefix: string): Promise<ReadonlyArray<string>>;
 }
 //#endregion
 //#region src/runStorage/InMemoryRunDataFactory.d.ts
@@ -1174,6 +894,80 @@ declare class PollingTriggerRuntime {
   private logError;
 }
 //#endregion
+//#region src/validation/WorkflowEdgePortError.types.d.ts
+interface WorkflowEdgePortError {
+  readonly edge: Edge;
+  readonly sourceNodeId: NodeId;
+  readonly sourceNodeName: string | undefined;
+  readonly sourceNodeKind: string | undefined;
+  readonly badPort: OutputPortKey;
+  readonly allowedPorts: ReadonlyArray<string>;
+  readonly message: string;
+}
+interface WorkflowEdgePortValidationResult {
+  readonly valid: boolean;
+  readonly errors: ReadonlyArray<WorkflowEdgePortError>;
+}
+//#endregion
+//#region src/validation/WorkflowEdgePortValidator.d.ts
+declare class WorkflowEdgePortValidator {
+  validate(workflow: {
+    nodes: ReadonlyArray<NodeDefinition>;
+    edges: ReadonlyArray<Edge>;
+  }): WorkflowEdgePortValidationResult;
+  /**
+   * Returns the declared output ports for a node, or null if the node is
+   * unknown / has no declared ports (legacy nodes — treat as unconstrained).
+   */
+  private allowedOutputPorts;
+}
+//#endregion
+//#region src/credentials/OAuthFlowExecutor.types.d.ts
+/**
+ * Four-concept model for credentials (see docs/design/credentials-oauth-unification.md):
+ *   1. CredentialType — schema for stored material (e.g. "oauth.google.gmail").
+ *   2. Credential slot requirement — which types a node or MCP server accepts.
+ *   3. CredentialInstance — a stored, usable token row in the host's credential store.
+ *   4. OAuthFlowExecutor (this file) — the only concept that differs between deployment
+ *      modes. DI selects one implementation at boot; the rest of the system programs
+ *      against this interface alone.
+ */
+interface OAuthFlowStartArgs {
+  readonly typeId: string;
+  readonly scopes: ReadonlyArray<string>;
+  readonly redirectUri: string;
+  readonly instanceId?: string;
+}
+interface OAuthFlowStartResult {
+  readonly consentUrl: string;
+  readonly stateToken: string;
+}
+interface OAuthFlowCallbackArgs {
+  readonly stateToken: string;
+  readonly code: string;
+}
+interface OAuthMaterial {
+  readonly accessToken: string;
+  readonly refreshToken?: string;
+  readonly expiresAt?: string;
+  readonly grantedScopes: ReadonlyArray<string>;
+}
+interface OAuthFlowExecutor {
+  start(args: OAuthFlowStartArgs): Promise<OAuthFlowStartResult>;
+  /**
+   * Returns the instanceId associated with a pending stateToken without consuming it.
+   * Used by callback routes to identify the target instance before calling completeCallback.
+   * Returns undefined when the stateToken is unknown or already consumed.
+   */
+  lookupInstanceId(stateToken: string): string | undefined;
+  completeCallback(args: OAuthFlowCallbackArgs): Promise<OAuthMaterial>;
+  refresh(args: {
+    typeId: string;
+    instanceId: string;
+    material: OAuthMaterial;
+  }): Promise<OAuthMaterial>;
+}
+//#endregion
 //#region src/orchestration/TestSuiteRunIdFactory.d.ts
 /**
  * Mints unique TestSuiteRun identifiers. Separated from {@link import("../types").RunIdFactory}
@@ -1242,5 +1036,5 @@ declare class TestSuiteOrchestrator {
   private publish;
 }
 //#endregion
-export { AgentConnectionNodeCollector as $, ZodSchemaAny as $t, CatalogBackedCostTrackingTelemetryFactory as A, AgentMessageTemplateContent as At, node as B, ChatLanguageModel as Bt, StaticCostCatalog as C, Clock as Cn, AgentGuardrailDefaults as Ct, RunnableOutputBehaviorResolver as D, AbortControllerFactory as Dn, AgentMessageLine as Dt, NodeOutputNormalizer as E, CredentialResolverFactory as En, AgentMessageDto as Et, DefaultExecutionBinaryService as F, AgentToolCallPlanner as Ft, InjectableRuntimeDecoratorComposer as G, NodeBackedToolInputMapper as Gt, StackTraceCallSitePathResolver as H, ChatModelConfig as Ht, UnavailableBinaryStorage as I, AgentToolDefinition as It, PersistedRuntimeTypeMetadata as J, NodeBackedToolOutputMapperArgs as Jt, PersistedRuntimeTypeDecoratorOptions as K, NodeBackedToolInputMapperArgs as Kt, ItemsInputNormalizer as L, AgentToolExecuteArgs as Lt, DefaultAsyncSleeper as M, AgentNodeConfig as Mt, AsyncSleeper as N, AgentTool as Nt, ItemExprResolver as O, AgentMessageRole as Ot, ChildExecutionScopeFactory as P, AgentToolCall as Pt, AgentConnectionCredentialSource as Q, ToolExecuteArgs as Qt, chatModel as R, AgentToolToken as Rt, ConfigDrivenOffloadPolicy as S, defineNode as Sn, AgentGuardrailConfig as St, NodeExecutor as T, NodeEventPublisher as Tn, AgentMessageConfig as Tt, PersistedRuntimeTypeNameResolver as U, ChatModelFactory as Ut, tool as V, ChatLanguageModelCallOptions as Vt, PersistedRuntimeTypeMetadataStore as W, NodeBackedToolConfigOptions as Wt, InMemoryRunEventBus as X, Tool as Xt, EventPublishingWorkflowExecutionRepository as Y, StructuredOutputOptions as Yt, ConnectionInvocationEventPublisher as Z, ToolConfig as Zt, InMemoryBinaryStorage as _, DefinedNodeCredentialAccessors as _n, c as _t, TestSuiteRunResult as a, CallableToolConfig as an, DefinePollingTriggerPollResult as at, DefaultDrivingScheduler as b, DefinedNodeRunContext as bn, AgentAttachmentRole as bt, PollingRunCycleResult as c, NodeBackedToolConfig as cn, DefinedPollingTriggerConfig as ct, WorkflowRepositoryWebhookTriggerMatcher as d, DefinedNodeRegistry as dn, CollectionColumnBuilder as dt, AgentConfigInspector as en, AgentConnectionNodeDescriptor as et, EngineCompositionDeps as f, DefineBatchNodeOptions as fn, CollectionDefinition as ft, InMemoryRunDataFactory as g, DefinedNodeConfigInput as gn, DefinedCollection as gt, InMemoryWorkflowExecutionRepository as h, DefinedNode as hn, DefineCollectionOptions as ht, TestSuiteOrchestratorEngine as i, CallableToolFactory as in, DefinePollingTriggerPollContext as it, DefaultExecutionContextFactory as j, AgentModelInvocationOptions as jt, InProcessRetryRunner as k, AgentMessageTemplate as kt, PollingTriggerRuntime as l, DefineCredentialOptions as ln, definePollingTrigger as lt, RunSummaryMapper as m, DefineNodeOptions as mn, CollectionIndexDefinition as mt, TestSuiteCaseOutcome as n, AgentToolFactory as nn, DefinePollingTriggerExecuteContext as nt, TestSuiteRunIdFactory as o, CallableToolConfigOptions as on, DefinePollingTriggerTestItemsContext as ot, EngineFactory as p, DefineNodeExecuteArgs as pn, CollectionFieldDefinition as pt, PersistedRuntimeTypeKind as q, NodeBackedToolOutputMapper as qt, TestSuiteOrchestrator as r, CallableToolKindToken as rn, DefinePollingTriggerOptions as rt, PollingRunCycleArgs as s, CallableToolExecuteHandler as sn, DefinedPollingTrigger as st, RunTestSuiteArgs as t, AgentMessageConfigNormalizer as tn, AgentConnectionNodeRole as tt, PollingTriggerStartArgs as u, defineCredential as un, DefinedCollectionRegistry as ut, LocalOnlyScheduler as v, DefinedNodeCredentialBinding as vn, defineCollection as vt, NodeInstanceFactory as w, SystemClock as wn, AgentMessageBuildArgs as wt, InlineDrivingScheduler as x, defineBatchNode as xn, AgentCanvasPresentation as xt, HintOnlyOffloadPolicy as y, DefinedNodeCredentialBindings as yn, callableTool as yt, getPersistedRuntimeTypeMetadata as z, AgentTurnLimitBehavior as zt };
-//# sourceMappingURL=index-CJQtTY_M.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