@codemation/core-nodes 0.4.1 → 0.4.3

package/dist/index.d.cts

@@ -78,6 +78,98 @@ interface ExponentialRetryPolicySpec {
   readonly jitter?: boolean;
 }
 //#endregion
+//#region ../core/src/contracts/telemetryTypes.d.ts
+type TelemetryAttributePrimitive = string | number | boolean | null;
+interface TelemetryAttributes {
+  readonly [key: string]: TelemetryAttributePrimitive | undefined;
+}
+interface TelemetryMetricRecord {
+  readonly name: string;
+  readonly value: number;
+  readonly unit?: string;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetrySpanEventRecord {
+  readonly name: string;
+  readonly occurredAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryArtifactAttachment {
+  readonly kind: string;
+  readonly contentType: string;
+  readonly previewText?: string;
+  readonly previewJson?: JsonValue;
+  readonly payloadText?: string;
+  readonly payloadJson?: JsonValue;
+  readonly bytes?: number;
+  readonly truncated?: boolean;
+  readonly expiresAt?: Date;
+}
+interface TelemetryArtifactReference {
+  readonly artifactId: string;
+  readonly traceId?: string;
+  readonly spanId?: string;
+}
+interface TelemetrySpanEnd {
+  readonly status?: "ok" | "error";
+  readonly statusMessage?: string;
+  readonly endedAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryChildSpanStart {
+  readonly name: string;
+  readonly kind?: "internal" | "client";
+  readonly startedAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryScope {
+  readonly traceId?: string;
+  readonly spanId?: string;
+  readonly costTracking?: CostTrackingTelemetry;
+  addSpanEvent(args: TelemetrySpanEventRecord): Promise<void> | void;
+  recordMetric(args: TelemetryMetricRecord): Promise<void> | void;
+  attachArtifact(args: TelemetryArtifactAttachment): Promise<TelemetryArtifactReference> | TelemetryArtifactReference;
+}
+interface TelemetrySpanScope extends TelemetryScope {
+  readonly traceId: string;
+  readonly spanId: string;
+  end(args?: TelemetrySpanEnd): Promise<void> | void;
+}
+interface NodeExecutionTelemetry extends ExecutionTelemetry, TelemetrySpanScope {
+  startChildSpan(args: TelemetryChildSpanStart): TelemetrySpanScope;
+}
+interface ExecutionTelemetry extends TelemetryScope {
+  readonly traceId: string;
+  readonly spanId: string;
+  forNode(args: Readonly<{
+    nodeId: NodeId;
+    activationId: NodeActivationId;
+  }>): NodeExecutionTelemetry;
+}
+//#endregion
+//#region ../core/src/contracts/CostTrackingTelemetryContract.d.ts
+type CostTrackingComponent = "chat" | "ocr" | "rag";
+interface CostTrackingUsageRecord {
+  readonly component: CostTrackingComponent;
+  readonly provider: string;
+  readonly operation: string;
+  readonly pricingKey: string;
+  readonly usageUnit: string;
+  readonly quantity: number;
+  readonly modelName?: string;
+  readonly attributes?: TelemetryAttributes;
+}
+interface CostTrackingPriceQuote {
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly estimatedAmountMinor: number;
+  readonly estimateKind: "catalog";
+}
+interface CostTrackingTelemetry {
+  captureUsage(args: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
+  forScope(scope: TelemetryScope): CostTrackingTelemetry;
+}
+//#endregion
 //#region ../core/src/contracts/runTypes.d.ts
 type NodeInputsByPort = Readonly<Record<InputPortKey, Items>>;
 type NodeExecutionStatus = "pending" | "queued" | "running" | "completed" | "failed" | "skipped";
@@ -85,6 +177,7 @@ interface NodeExecutionError {
   message: string;
   name?: string;
   stack?: string;
+  details?: JsonValue;
 }
 /** Stable id for a single connection invocation row in {@link ConnectionInvocationRecord}. */
 type ConnectionInvocationId = string;
@@ -289,6 +382,7 @@ interface ExecutionContext {
   now: () => Date;
   data: RunDataSnapshot;
   nodeState?: NodeExecutionStatePublisher;
+  telemetry: ExecutionTelemetry;
   binary: ExecutionBinaryService;
   getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
 }
@@ -296,6 +390,7 @@ interface NodeExecutionContext<TConfig extends NodeConfigBase = NodeConfigBase>
   nodeId: NodeId;
   activationId: NodeActivationId;
   config: TConfig;
+  telemetry: NodeExecutionTelemetry;
   binary: NodeBinaryAttachmentService;
 }
 interface TriggerSetupContext<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>, TSetupState$1 extends JsonValue | undefined = TriggerNodeSetupState<TConfig>> extends ExecutionContext {
@@ -559,6 +654,9 @@ interface WorkflowStoragePolicyDecisionArgs {
 interface WorkflowPrunePolicySpec {
   readonly runDataRetentionSeconds?: number;
   readonly binaryRetentionSeconds?: number;
+  readonly telemetrySpanRetentionSeconds?: number;
+  readonly telemetryArtifactRetentionSeconds?: number;
+  readonly telemetryMetricRetentionSeconds?: number;
 }
 interface WorkflowErrorHandler {
   onError(ctx: WorkflowErrorContext): void | Promise<void>;
@@ -844,6 +942,8 @@ type AgentToolCall = Readonly<{
 interface ChatModelConfig {
   readonly type: TypeToken<ChatModelFactory<ChatModelConfig>>;
   readonly name: string;
+  readonly provider?: string;
+  readonly modelName?: string;
   readonly presentation?: AgentCanvasPresentation;
   getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
 }
@@ -944,6 +1044,8 @@ declare class OpenAIChatModelConfig implements ChatModelConfig {
   }> | undefined;
   readonly type: typeof OpenAIChatModelFactory;
   readonly presentation: AgentCanvasPresentation<CanvasIconName>;
+  readonly provider = "openai";
+  readonly modelName: string;
   constructor(name: string, model: string, credentialSlotKey?: string, presentationIn?: AgentCanvasPresentation<CanvasIconName>, options?: Readonly<{
     temperature?: number;
     maxTokens?: number;
@@ -1124,6 +1226,43 @@ declare class AgentToolCallPortMap {
   static fromInput(input: unknown): NodeInputsByPort;
 }
 //#endregion
+//#region src/nodes/AgentToolRepair.types.d.ts
+type AgentToolFailureKind = "repairable_validation_error" | "transient_execution_error" | "non_repairable_error";
+type AgentToolRepairNextAction = "model_retry_with_tool_error_message" | "fail_agent_run";
+interface AgentToolValidationIssue {
+  readonly path: ReadonlyArray<string | number>;
+  readonly code: string;
+  readonly message: string;
+  readonly expected?: string;
+  readonly received?: string;
+}
+interface AgentToolRepairDecision {
+  readonly attempt: number;
+  readonly maxAttempts: number;
+  readonly nextAction: AgentToolRepairNextAction;
+}
+interface AgentToolFailureClassification {
+  readonly kind: AgentToolFailureKind;
+  readonly effectiveError: Error;
+  readonly issues?: ReadonlyArray<AgentToolValidationIssue>;
+  readonly requiredSchemaReminder?: JsonValue;
+}
+//#endregion
+//#region src/nodes/AgentToolErrorClassifier.d.ts
+declare class AgentToolErrorClassifier {
+  classify(args: Readonly<{
+    error: unknown;
+    toolName: string;
+    schema?: unknown;
+  }>): AgentToolFailureClassification;
+  private isRepairableValidationError;
+  private extractIssues;
+  private isTransientExecutionError;
+  private toError;
+  private toJsonValue;
+  private toOptionalString;
+}
+//#endregion
 //#region src/nodes/AIAgentConfig.d.ts
 interface AIAgentOptions<TInputJson$1 = unknown, _TOutputJson = unknown> {
   readonly name: string;
@@ -1160,6 +1299,48 @@ declare class AIAgent<TInputJson$1 = unknown, TOutputJson$1 = unknown> implement
   constructor(options: AIAgentOptions<TInputJson$1, TOutputJson$1>);
 }
 //#endregion
+//#region src/nodes/AgentToolRepairPolicy.d.ts
+declare class AgentToolRepairPolicy {
+  private static readonly maxRepairAttemptsPerTool;
+  createDecision(toolName: string, attemptsByToolName: Map<string, number>): AgentToolRepairDecision;
+}
+//#endregion
+//#region src/nodes/AgentToolExecutionCoordinator.d.ts
+declare class AgentToolExecutionCoordinator {
+  private readonly errorClassifier;
+  private readonly repairPolicy;
+  constructor(errorClassifier: AgentToolErrorClassifier, repairPolicy: AgentToolRepairPolicy);
+  execute(args: Readonly<{
+    plannedToolCalls: ReadonlyArray<PlannedToolCall>;
+    ctx: NodeExecutionContext<AIAgent<any, any>>;
+    agentName: string;
+    repairAttemptsByToolName: Map<string, number>;
+  }>): Promise<ReadonlyArray<ExecutedToolCall>>;
+  private executePlannedToolCall;
+  private recordFailedInvocation;
+  private createRepairPayload;
+  private createRepairDetails;
+  private createValidationMessage;
+  private parseToolOutput;
+  private toJsonValue;
+  private extractErrorDetails;
+  private serializeIssue;
+}
+//#endregion
+//#region src/nodes/AgentToolRepairExhaustedError.d.ts
+declare class AgentToolRepairExhaustedError extends Error {
+  readonly details: JsonValue;
+  constructor(args: Readonly<{
+    agentName: string;
+    nodeId: string;
+    toolName: string;
+    maxAttempts: number;
+    lastManagedInput?: JsonValue;
+    lastValidationIssues?: ReadonlyArray<AgentToolValidationIssue>;
+  }>);
+  private serializeIssue;
+}
+//#endregion
 //#region src/nodes/NodeBackedToolRuntime.d.ts
 declare class NodeBackedToolRuntime {
   private readonly nodeResolver;
@@ -1179,6 +1360,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private readonly nodeBackedToolRuntime;
   private readonly executionHelpers;
   private readonly structuredOutputRunner;
+  private readonly toolExecutionCoordinator;
   kind: "node";
   outputPorts: readonly ["main"];
   /**
@@ -1190,7 +1372,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private readonly connectionCredentialExecutionContextFactory;
   /** One resolved model/tools bundle per activation context (same ctx across items in a batch). */
   private readonly preparedByExecutionContext;
-  constructor(nodeResolver: NodeResolver, credentialSessions: CredentialSessionService, nodeBackedToolRuntime: NodeBackedToolRuntime, executionHelpers: AIAgentExecutionHelpersFactory, structuredOutputRunner: AgentStructuredOutputRunner);
+  constructor(nodeResolver: NodeResolver, credentialSessions: CredentialSessionService, nodeBackedToolRuntime: NodeBackedToolRuntime, executionHelpers: AIAgentExecutionHelpersFactory, structuredOutputRunner: AgentStructuredOutputRunner, toolExecutionCoordinator: AgentToolExecutionCoordinator);
   execute(args: RunnableNodeExecuteArgs<AIAgent<any, any>>): Promise<unknown>;
   private getOrPrepareExecution;
   /**
@@ -1215,13 +1397,19 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private createItemScopedTools;
   private invokeModel;
   private invokeStructuredModel;
+  private createModelInvocationSpan;
+  private recordModelUsageMetrics;
+  private captureCostTrackingUsage;
+  private resolveChatModelName;
+  private extractModelUsageMetrics;
+  private extractUsageObject;
+  private readUsageNumber;
+  private readNestedUsageValue;
+  private isRecord;
   private markQueuedTools;
-  private executeToolCalls;
   private planToolCalls;
-  private parseToolOutput;
   private failTrackedNodeInvocation;
   private summarizeLlmMessages;
-  private toolCallInputToJson;
   private resultToJsonValue;
   private createPromptMessages;
   private resolveToolRuntime;
@@ -1237,6 +1425,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private isCallableToolConfig;
   private resolveGuardrails;
   private getAgentDisplayName;
+  private extractErrorDetails;
 }
 //#endregion
 //#region src/nodes/CallbackNode.d.ts
@@ -1841,5 +2030,5 @@ declare class AIAgentConnectionWorkflowExpander {
   private assertNoIdCollision;
 }
 //#endregion
-export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentStructuredOutputRepairPromptFactory, AgentStructuredOutputRunner, AgentToolCallPortMap, Aggregate, AggregateNode, Callback, CallbackHandler, CallbackNode, CallbackOptions, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, ExecutedToolCall, Filter, FilterNode, HttpRequest, HttpRequestDownloadMode, HttpRequestNode, HttpRequestOutputJson, If, IfNode, ItemScopedToolBinding, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, MapDataOptions, Merge, MergeMode, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAIStructuredOutputMethodFactory, OpenAiChatModelPresets, OpenAiCredentialSession, PlannedToolCall, ResolvedTool, Split, SplitNode, SubWorkflow, SubWorkflowNode, Switch, SwitchCaseKeyResolver, SwitchNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentMessages, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
+export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentStructuredOutputRepairPromptFactory, AgentStructuredOutputRunner, AgentToolCallPortMap, AgentToolErrorClassifier, AgentToolExecutionCoordinator, AgentToolRepairExhaustedError, AgentToolRepairPolicy, Aggregate, AggregateNode, Callback, CallbackHandler, CallbackNode, CallbackOptions, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, ExecutedToolCall, Filter, FilterNode, HttpRequest, HttpRequestDownloadMode, HttpRequestNode, HttpRequestOutputJson, If, IfNode, ItemScopedToolBinding, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, MapDataOptions, Merge, MergeMode, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAIStructuredOutputMethodFactory, OpenAiChatModelPresets, OpenAiCredentialSession, PlannedToolCall, ResolvedTool, Split, SplitNode, SubWorkflow, SubWorkflowNode, Switch, SwitchCaseKeyResolver, SwitchNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentMessages, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -78,6 +78,98 @@ interface ExponentialRetryPolicySpec {
   readonly jitter?: boolean;
 }
 //#endregion
+//#region ../core/src/contracts/telemetryTypes.d.ts
+type TelemetryAttributePrimitive = string | number | boolean | null;
+interface TelemetryAttributes {
+  readonly [key: string]: TelemetryAttributePrimitive | undefined;
+}
+interface TelemetryMetricRecord {
+  readonly name: string;
+  readonly value: number;
+  readonly unit?: string;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetrySpanEventRecord {
+  readonly name: string;
+  readonly occurredAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryArtifactAttachment {
+  readonly kind: string;
+  readonly contentType: string;
+  readonly previewText?: string;
+  readonly previewJson?: JsonValue;
+  readonly payloadText?: string;
+  readonly payloadJson?: JsonValue;
+  readonly bytes?: number;
+  readonly truncated?: boolean;
+  readonly expiresAt?: Date;
+}
+interface TelemetryArtifactReference {
+  readonly artifactId: string;
+  readonly traceId?: string;
+  readonly spanId?: string;
+}
+interface TelemetrySpanEnd {
+  readonly status?: "ok" | "error";
+  readonly statusMessage?: string;
+  readonly endedAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryChildSpanStart {
+  readonly name: string;
+  readonly kind?: "internal" | "client";
+  readonly startedAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryScope {
+  readonly traceId?: string;
+  readonly spanId?: string;
+  readonly costTracking?: CostTrackingTelemetry;
+  addSpanEvent(args: TelemetrySpanEventRecord): Promise<void> | void;
+  recordMetric(args: TelemetryMetricRecord): Promise<void> | void;
+  attachArtifact(args: TelemetryArtifactAttachment): Promise<TelemetryArtifactReference> | TelemetryArtifactReference;
+}
+interface TelemetrySpanScope extends TelemetryScope {
+  readonly traceId: string;
+  readonly spanId: string;
+  end(args?: TelemetrySpanEnd): Promise<void> | void;
+}
+interface NodeExecutionTelemetry extends ExecutionTelemetry, TelemetrySpanScope {
+  startChildSpan(args: TelemetryChildSpanStart): TelemetrySpanScope;
+}
+interface ExecutionTelemetry extends TelemetryScope {
+  readonly traceId: string;
+  readonly spanId: string;
+  forNode(args: Readonly<{
+    nodeId: NodeId;
+    activationId: NodeActivationId;
+  }>): NodeExecutionTelemetry;
+}
+//#endregion
+//#region ../core/src/contracts/CostTrackingTelemetryContract.d.ts
+type CostTrackingComponent = "chat" | "ocr" | "rag";
+interface CostTrackingUsageRecord {
+  readonly component: CostTrackingComponent;
+  readonly provider: string;
+  readonly operation: string;
+  readonly pricingKey: string;
+  readonly usageUnit: string;
+  readonly quantity: number;
+  readonly modelName?: string;
+  readonly attributes?: TelemetryAttributes;
+}
+interface CostTrackingPriceQuote {
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly estimatedAmountMinor: number;
+  readonly estimateKind: "catalog";
+}
+interface CostTrackingTelemetry {
+  captureUsage(args: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
+  forScope(scope: TelemetryScope): CostTrackingTelemetry;
+}
+//#endregion
 //#region ../core/src/contracts/runTypes.d.ts
 type NodeInputsByPort = Readonly<Record<InputPortKey, Items>>;
 type NodeExecutionStatus = "pending" | "queued" | "running" | "completed" | "failed" | "skipped";
@@ -85,6 +177,7 @@ interface NodeExecutionError {
   message: string;
   name?: string;
   stack?: string;
+  details?: JsonValue;
 }
 /** Stable id for a single connection invocation row in {@link ConnectionInvocationRecord}. */
 type ConnectionInvocationId = string;
@@ -289,6 +382,7 @@ interface ExecutionContext {
   now: () => Date;
   data: RunDataSnapshot;
   nodeState?: NodeExecutionStatePublisher;
+  telemetry: ExecutionTelemetry;
   binary: ExecutionBinaryService;
   getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
 }
@@ -296,6 +390,7 @@ interface NodeExecutionContext<TConfig extends NodeConfigBase = NodeConfigBase>
   nodeId: NodeId;
   activationId: NodeActivationId;
   config: TConfig;
+  telemetry: NodeExecutionTelemetry;
   binary: NodeBinaryAttachmentService;
 }
 interface TriggerSetupContext<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>, TSetupState$1 extends JsonValue | undefined = TriggerNodeSetupState<TConfig>> extends ExecutionContext {
@@ -559,6 +654,9 @@ interface WorkflowStoragePolicyDecisionArgs {
 interface WorkflowPrunePolicySpec {
   readonly runDataRetentionSeconds?: number;
   readonly binaryRetentionSeconds?: number;
+  readonly telemetrySpanRetentionSeconds?: number;
+  readonly telemetryArtifactRetentionSeconds?: number;
+  readonly telemetryMetricRetentionSeconds?: number;
 }
 interface WorkflowErrorHandler {
   onError(ctx: WorkflowErrorContext): void | Promise<void>;
@@ -844,6 +942,8 @@ type AgentToolCall = Readonly<{
 interface ChatModelConfig {
   readonly type: TypeToken<ChatModelFactory<ChatModelConfig>>;
   readonly name: string;
+  readonly provider?: string;
+  readonly modelName?: string;
   readonly presentation?: AgentCanvasPresentation;
   getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
 }
@@ -944,6 +1044,8 @@ declare class OpenAIChatModelConfig implements ChatModelConfig {
   }> | undefined;
   readonly type: typeof OpenAIChatModelFactory;
   readonly presentation: AgentCanvasPresentation<CanvasIconName>;
+  readonly provider = "openai";
+  readonly modelName: string;
   constructor(name: string, model: string, credentialSlotKey?: string, presentationIn?: AgentCanvasPresentation<CanvasIconName>, options?: Readonly<{
     temperature?: number;
     maxTokens?: number;
@@ -1124,6 +1226,43 @@ declare class AgentToolCallPortMap {
   static fromInput(input: unknown): NodeInputsByPort;
 }
 //#endregion
+//#region src/nodes/AgentToolRepair.types.d.ts
+type AgentToolFailureKind = "repairable_validation_error" | "transient_execution_error" | "non_repairable_error";
+type AgentToolRepairNextAction = "model_retry_with_tool_error_message" | "fail_agent_run";
+interface AgentToolValidationIssue {
+  readonly path: ReadonlyArray<string | number>;
+  readonly code: string;
+  readonly message: string;
+  readonly expected?: string;
+  readonly received?: string;
+}
+interface AgentToolRepairDecision {
+  readonly attempt: number;
+  readonly maxAttempts: number;
+  readonly nextAction: AgentToolRepairNextAction;
+}
+interface AgentToolFailureClassification {
+  readonly kind: AgentToolFailureKind;
+  readonly effectiveError: Error;
+  readonly issues?: ReadonlyArray<AgentToolValidationIssue>;
+  readonly requiredSchemaReminder?: JsonValue;
+}
+//#endregion
+//#region src/nodes/AgentToolErrorClassifier.d.ts
+declare class AgentToolErrorClassifier {
+  classify(args: Readonly<{
+    error: unknown;
+    toolName: string;
+    schema?: unknown;
+  }>): AgentToolFailureClassification;
+  private isRepairableValidationError;
+  private extractIssues;
+  private isTransientExecutionError;
+  private toError;
+  private toJsonValue;
+  private toOptionalString;
+}
+//#endregion
 //#region src/nodes/AIAgentConfig.d.ts
 interface AIAgentOptions<TInputJson$1 = unknown, _TOutputJson = unknown> {
   readonly name: string;
@@ -1160,6 +1299,48 @@ declare class AIAgent<TInputJson$1 = unknown, TOutputJson$1 = unknown> implement
   constructor(options: AIAgentOptions<TInputJson$1, TOutputJson$1>);
 }
 //#endregion
+//#region src/nodes/AgentToolRepairPolicy.d.ts
+declare class AgentToolRepairPolicy {
+  private static readonly maxRepairAttemptsPerTool;
+  createDecision(toolName: string, attemptsByToolName: Map<string, number>): AgentToolRepairDecision;
+}
+//#endregion
+//#region src/nodes/AgentToolExecutionCoordinator.d.ts
+declare class AgentToolExecutionCoordinator {
+  private readonly errorClassifier;
+  private readonly repairPolicy;
+  constructor(errorClassifier: AgentToolErrorClassifier, repairPolicy: AgentToolRepairPolicy);
+  execute(args: Readonly<{
+    plannedToolCalls: ReadonlyArray<PlannedToolCall>;
+    ctx: NodeExecutionContext<AIAgent<any, any>>;
+    agentName: string;
+    repairAttemptsByToolName: Map<string, number>;
+  }>): Promise<ReadonlyArray<ExecutedToolCall>>;
+  private executePlannedToolCall;
+  private recordFailedInvocation;
+  private createRepairPayload;
+  private createRepairDetails;
+  private createValidationMessage;
+  private parseToolOutput;
+  private toJsonValue;
+  private extractErrorDetails;
+  private serializeIssue;
+}
+//#endregion
+//#region src/nodes/AgentToolRepairExhaustedError.d.ts
+declare class AgentToolRepairExhaustedError extends Error {
+  readonly details: JsonValue;
+  constructor(args: Readonly<{
+    agentName: string;
+    nodeId: string;
+    toolName: string;
+    maxAttempts: number;
+    lastManagedInput?: JsonValue;
+    lastValidationIssues?: ReadonlyArray<AgentToolValidationIssue>;
+  }>);
+  private serializeIssue;
+}
+//#endregion
 //#region src/nodes/NodeBackedToolRuntime.d.ts
 declare class NodeBackedToolRuntime {
   private readonly nodeResolver;
@@ -1179,6 +1360,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private readonly nodeBackedToolRuntime;
   private readonly executionHelpers;
   private readonly structuredOutputRunner;
+  private readonly toolExecutionCoordinator;
   kind: "node";
   outputPorts: readonly ["main"];
   /**
@@ -1190,7 +1372,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private readonly connectionCredentialExecutionContextFactory;
   /** One resolved model/tools bundle per activation context (same ctx across items in a batch). */
   private readonly preparedByExecutionContext;
-  constructor(nodeResolver: NodeResolver, credentialSessions: CredentialSessionService, nodeBackedToolRuntime: NodeBackedToolRuntime, executionHelpers: AIAgentExecutionHelpersFactory, structuredOutputRunner: AgentStructuredOutputRunner);
+  constructor(nodeResolver: NodeResolver, credentialSessions: CredentialSessionService, nodeBackedToolRuntime: NodeBackedToolRuntime, executionHelpers: AIAgentExecutionHelpersFactory, structuredOutputRunner: AgentStructuredOutputRunner, toolExecutionCoordinator: AgentToolExecutionCoordinator);
   execute(args: RunnableNodeExecuteArgs<AIAgent<any, any>>): Promise<unknown>;
   private getOrPrepareExecution;
   /**
@@ -1215,13 +1397,19 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private createItemScopedTools;
   private invokeModel;
   private invokeStructuredModel;
+  private createModelInvocationSpan;
+  private recordModelUsageMetrics;
+  private captureCostTrackingUsage;
+  private resolveChatModelName;
+  private extractModelUsageMetrics;
+  private extractUsageObject;
+  private readUsageNumber;
+  private readNestedUsageValue;
+  private isRecord;
   private markQueuedTools;
-  private executeToolCalls;
   private planToolCalls;
-  private parseToolOutput;
   private failTrackedNodeInvocation;
   private summarizeLlmMessages;
-  private toolCallInputToJson;
   private resultToJsonValue;
   private createPromptMessages;
   private resolveToolRuntime;
@@ -1237,6 +1425,7 @@ declare class AIAgentNode implements RunnableNode<AIAgent<any, any>> {
   private isCallableToolConfig;
   private resolveGuardrails;
   private getAgentDisplayName;
+  private extractErrorDetails;
 }
 //#endregion
 //#region src/nodes/CallbackNode.d.ts
@@ -1841,5 +2030,5 @@ declare class AIAgentConnectionWorkflowExpander {
   private assertNoIdCollision;
 }
 //#endregion
-export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentStructuredOutputRepairPromptFactory, AgentStructuredOutputRunner, AgentToolCallPortMap, Aggregate, AggregateNode, Callback, CallbackHandler, CallbackNode, CallbackOptions, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, type ExecutedToolCall, Filter, FilterNode, HttpRequest, HttpRequestDownloadMode, HttpRequestNode, HttpRequestOutputJson, If, IfNode, type ItemScopedToolBinding, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, MapDataOptions, Merge, MergeMode, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAIStructuredOutputMethodFactory, OpenAiChatModelPresets, OpenAiCredentialSession, type PlannedToolCall, type ResolvedTool, Split, SplitNode, SubWorkflow, SubWorkflowNode, Switch, SwitchCaseKeyResolver, SwitchNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentMessages, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
+export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentStructuredOutputRepairPromptFactory, AgentStructuredOutputRunner, AgentToolCallPortMap, AgentToolErrorClassifier, AgentToolExecutionCoordinator, AgentToolRepairExhaustedError, AgentToolRepairPolicy, Aggregate, AggregateNode, Callback, CallbackHandler, CallbackNode, CallbackOptions, CallbackResultNormalizer, CanvasIconName, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, type ExecutedToolCall, Filter, FilterNode, HttpRequest, HttpRequestDownloadMode, HttpRequestNode, HttpRequestOutputJson, If, IfNode, type ItemScopedToolBinding, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, MapDataOptions, Merge, MergeMode, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAIStructuredOutputMethodFactory, OpenAiChatModelPresets, OpenAiCredentialSession, type PlannedToolCall, type ResolvedTool, Split, SplitNode, SubWorkflow, SubWorkflowNode, Switch, SwitchCaseKeyResolver, SwitchNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, type WorkflowAgentMessages, type WorkflowAgentOptions, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, createWorkflowBuilder, openAiChatModelPresets, registerCoreNodes, workflow };
 //# sourceMappingURL=index.d.ts.map