import type { Agent, FetchFn, McpToolCallSettledEvent } from '@n8n/agents'; import type { IWorkflowExecuteAdditionalData } from 'n8n-workflow'; import type { AgentJsonConfig } from '@n8n/api-types'; import type { ReferencedToolKind } from '../tool-registry'; export interface AgentEvaluationSkippedFeature { feature: string; reason: string; } export interface AgentEvaluationToolSummary { name: string; kind: 'node' | 'workflow' | 'custom' | 'mcp' | 'other'; description?: string; nodeType?: string; } export interface AgentEvaluationPreparation { config: AgentJsonConfig; tools: AgentEvaluationToolSummary[]; skippedFeatures: AgentEvaluationSkippedFeature[]; buildRuntime(instrumentation: Omit, abortSignal?: AbortSignal): Promise; } export type AgentEvaluationPreparationResult = { preparation: AgentEvaluationPreparation; error?: never; } | { error: string; preparation?: never; }; export interface AgentToolInstrumentationContext { toolName: string; toolKind: ReferencedToolKind; } export interface AgentMcpToolCallSettledContext extends McpToolCallSettledEvent { serverName: string; } export interface AgentRuntimeInstrumentation { modelFetch?: FetchFn; mcpFetch?: FetchFn; onMcpToolCallSettled?: (event: AgentMcpToolCallSettledContext) => void | Promise; webSearch?: (args: { query: string; maxResults?: number; includeDomains?: string[]; excludeDomains?: string[]; }) => Promise; configureToolAdditionalData?: (additionalData: IWorkflowExecuteAdditionalData, context: AgentToolInstrumentationContext) => void; transformDelegatedAgentConfig?: (config: AgentJsonConfig, context: { subAgentId: string; }) => AgentJsonConfig; } export type InstrumentToolAdditionalData = NonNullable; export type PrepareWorkflowAgentForEval = (config: AgentJsonConfig, context?: { hasChatIntegrations?: boolean; }) => Promise<{ config: AgentJsonConfig; instrumentation: AgentRuntimeInstrumentation; }>;