import { type AgentJsonConfig } from '@n8n/api-types'; import { WorkflowRepository, type User } from '@n8n/db'; import { CredentialsFinderService } from '@n8n/backend-services'; import { CredentialsService } from '../../credentials/credentials.service'; import type { PolicyActor } from '../../policy/policy-enforcement-backend'; import { type AgentConfigPart, type AgentConfigSetting } from './agent-modification-telemetry.service'; import { AgentPolicyService } from './agent-policy.service'; import { AgentSkillRefsService } from './agent-skill-refs.service'; import type { Agent, ProjectAgent } from './entities/agent.entity'; import { type AgentSkillRefs } from './json-config/agent-document'; import { AgentRepository } from './repositories/agent.repository'; import { AgentTaskRepository } from './repositories/agent-task.repository'; import { NodeToolAiGatewayService } from './json-config/node-tool-ai-gateway.service'; import { type CompleteAgentDefinition, type PlannedAgentDestinations } from './utils/agent-definition'; export interface ConfigReplacement { nextSchema: AgentJsonConfig; nextIntegrations: NonNullable; previousIntegrations: NonNullable; changedParts: AgentConfigPart[]; changedSettings: AgentConfigSetting[]; } export declare class AgentConfigPreparationService { private readonly credentialsService; private readonly workflowRepository; private readonly nodeToolAiGatewayService; private readonly agentRepository; private readonly agentTaskRepository; private readonly agentSkillRefs; private readonly agentPolicyService; private readonly credentialsFinderService; constructor(credentialsService: CredentialsService, workflowRepository: WorkflowRepository, nodeToolAiGatewayService: NodeToolAiGatewayService, agentRepository: AgentRepository, agentTaskRepository: AgentTaskRepository, agentSkillRefs: AgentSkillRefsService, agentPolicyService: AgentPolicyService, credentialsFinderService: CredentialsFinderService); prepareForSave(entity: ProjectAgent, rawConfig: unknown, user: User, { previousSkillRefs, clearOmitted, isNew, actor, }: { previousSkillRefs: AgentSkillRefs; clearOmitted?: boolean; isNew?: boolean; actor?: PolicyActor; }): Promise<{ validatedConfig: { name: string; description?: string | undefined; model: string; credential?: string | undefined; instructions: string; personalisation?: { icon: string; gradient: { from: string; to: string; angle: number; fromStop: number; toStop: number; }; } | undefined; memory?: { enabled: boolean; storage: "n8n"; observationalMemory?: { enabled?: boolean | undefined; observerModel?: { model: string; credential: string; } | undefined; reflectorModel?: { model: string; credential: string; } | undefined; observerThresholdTokens?: number | undefined; reflectorThresholdTokens?: number | undefined; renderTokenBudget?: number | undefined; observationLogTailLimit?: number | undefined; lockTtlMs?: number | undefined; } | undefined; episodicMemory?: { enabled: false; } | { enabled: true; credential: string; reflectorModel?: { model: string; credential: string; } | undefined; topK?: number | undefined; maxEntriesPerRun?: number | undefined; guidance?: { include?: string[] | undefined; exclude?: string[] | undefined; } | undefined; } | undefined; } | undefined; subAgents?: { maxChildren?: number | undefined; agents?: { agentId: string; useWhen?: string | undefined; enabled?: boolean | undefined; }[] | undefined; modelsByDifficulty?: { low?: { model: string; credential: string; } | undefined; medium?: { model: string; credential: string; } | undefined; high?: { model: string; credential: string; } | undefined; } | undefined; } | undefined; tools?: ({ type: "custom"; enabled?: boolean | undefined; id: string; requireApproval?: boolean | undefined; } | { type: "workflow"; enabled?: boolean | undefined; workflowId?: string | undefined; workflow: string; name?: string | undefined; description?: string | undefined; requireApproval?: boolean | undefined; allOutputs?: boolean | undefined; inputs?: Record | undefined; } | { type: "node"; enabled?: boolean | undefined; name: string; description?: string | undefined; inputSchema?: undefined; node: { nodeType: string; nodeTypeVersion: number; nodeParameters: Record; credentials?: Record | undefined; }; requireApproval?: boolean | undefined; })[] | undefined; skills?: { type: "skill"; versionId?: string | undefined; id: string; }[] | undefined; tasks?: { type: "task"; id: string; enabled: boolean; }[] | undefined; providerTools?: Record> | undefined; integrations?: ({ type: "telegram"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { accessMode: "private" | "public"; allowedUsers: string[]; sessionIdleTimeoutMinutes?: number | null | undefined; } | undefined; } | { type: "slack"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { messagingExperience: "agent" | "assistant"; onlyRespondWhenMentioned?: boolean | undefined; sessionIdleTimeoutMinutes?: number | null | undefined; } | undefined; } | { type: "linear"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { sessionIdleTimeoutMinutes?: number | null | undefined; } | undefined; } | { type: "discord"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { sessionIdleTimeoutMinutes?: number | null | undefined; } | undefined; } | { type: "whatsapp"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { sessionIdleTimeoutMinutes?: number | null | undefined; typingIndicator?: boolean | undefined; downloadMedia?: boolean | undefined; mediaRetentionDays?: number | undefined; } | undefined; } | { type: "teams"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { sessionIdleTimeoutMinutes?: number | null | undefined; displayName?: string | undefined; description?: string | undefined; teamChannels?: boolean | undefined; groupChats?: boolean | undefined; readAllChannelMessages?: boolean | undefined; readAllGroupMessages?: boolean | undefined; } | undefined; } | { type: "n8n_chat"; credentialId: ""; })[] | undefined; mcpServers?: { name: string; description?: string | undefined; url: string; transport: "sse" | "streamableHttp"; authentication: string; credential?: string | undefined; metadata?: { nodeTypeName?: string | undefined; } | undefined; toolPermissions?: { categories: { read: "always_allow" | "blocked" | "require_approval"; write: "always_allow" | "blocked" | "require_approval"; }; tools?: Record | undefined; } | undefined; connectionTimeoutMs?: number | undefined; }[] | undefined; vectorStores?: ({ name: string; credential: string; useWhen: string; embedding: { model: string; credential: string; }; provider: "pinecone"; indexName: string; namespace?: string | undefined; } | { name: string; credential: string; useWhen: string; embedding: { model: string; credential: string; }; provider: "qdrant"; collectionName: string; } | { name: string; credential: string; useWhen: string; embedding: { model: string; credential: string; }; provider: "supabase"; tableName: string; queryName?: string | undefined; } | { name: string; credential: string; useWhen: string; embedding: { model: string; credential: string; }; provider: "postgres"; tableName: string; })[] | undefined; config?: { reasoning?: "high" | "low" | "medium" | undefined; promptCaching?: { enabled: boolean; anthropic?: { ttl?: "1h" | "5m" | undefined; } | undefined; } | undefined; webSearch?: { enabled: boolean; provider?: "auto" | "brave" | "native" | "searxng" | undefined; credential?: string | undefined; } | undefined; toolCallConcurrency?: number | undefined; maxIterations?: number | undefined; guardrails?: { budget?: { enabled: boolean; monthlyBudgetUsd?: number | undefined; alertThresholdPercent?: number | undefined; sessionCostCapUsd?: number | undefined; } | undefined; } | undefined; } | undefined; }; credentialProvider: import("./adapters/agents-credential-provider").AgentsCredentialProvider; replacement: ConfigReplacement; existingTaskIds: string[]; }>; assertCanSaveDefinition(projectId: string, user: User, action: 'create' | 'update'): Promise; validateDefinition(agentId: string, definition: CompleteAgentDefinition): Promise; prepareDefinition(agentId: string, definition: CompleteAgentDefinition, projectId: string, user: User, planned?: PlannedAgentDestinations, previousConfig?: AgentJsonConfig | null): Promise<{ definition: CompleteAgentDefinition; credentialProvider: import("./adapters/agents-credential-provider").AgentsCredentialProvider; }>; private validateAgentDestinations; private validateWorkflowDestinations; private assertUsableCredentialChanges; filterUsableCredentialIds(credentialIds: Iterable, user: User): Promise>; prepareConfig(config: unknown, projectId: string, user: User): Promise<{ validatedConfig: { name: string; description?: string | undefined; model: string; credential?: string | undefined; instructions: string; personalisation?: { icon: string; gradient: { from: string; to: string; angle: number; fromStop: number; toStop: number; }; } | undefined; memory?: { enabled: boolean; storage: "n8n"; observationalMemory?: { enabled?: boolean | undefined; observerModel?: { model: string; credential: string; } | undefined; reflectorModel?: { model: string; credential: string; } | undefined; observerThresholdTokens?: number | undefined; reflectorThresholdTokens?: number | undefined; renderTokenBudget?: number | undefined; observationLogTailLimit?: number | undefined; lockTtlMs?: number | undefined; } | undefined; episodicMemory?: { enabled: false; } | { enabled: true; credential: string; reflectorModel?: { model: string; credential: string; } | undefined; topK?: number | undefined; maxEntriesPerRun?: number | undefined; guidance?: { include?: string[] | undefined; exclude?: string[] | undefined; } | undefined; } | undefined; } | undefined; subAgents?: { maxChildren?: number | undefined; agents?: { agentId: string; useWhen?: string | undefined; enabled?: boolean | undefined; }[] | undefined; modelsByDifficulty?: { low?: { model: string; credential: string; } | undefined; medium?: { model: string; credential: string; } | undefined; high?: { model: string; credential: string; } | undefined; } | undefined; } | undefined; tools?: ({ type: "custom"; enabled?: boolean | undefined; id: string; requireApproval?: boolean | undefined; } | { type: "workflow"; enabled?: boolean | undefined; workflowId?: string | undefined; workflow: string; name?: string | undefined; description?: string | undefined; requireApproval?: boolean | undefined; allOutputs?: boolean | undefined; inputs?: Record | undefined; } | { type: "node"; enabled?: boolean | undefined; name: string; description?: string | undefined; inputSchema?: undefined; node: { nodeType: string; nodeTypeVersion: number; nodeParameters: Record; credentials?: Record | undefined; }; requireApproval?: boolean | undefined; })[] | undefined; skills?: { type: "skill"; versionId?: string | undefined; id: string; }[] | undefined; tasks?: { type: "task"; id: string; enabled: boolean; }[] | undefined; providerTools?: Record> | undefined; integrations?: ({ type: "telegram"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { accessMode: "private" | "public"; allowedUsers: string[]; sessionIdleTimeoutMinutes?: number | null | undefined; } | undefined; } | { type: "slack"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { messagingExperience: "agent" | "assistant"; onlyRespondWhenMentioned?: boolean | undefined; sessionIdleTimeoutMinutes?: number | null | undefined; } | undefined; } | { type: "linear"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { sessionIdleTimeoutMinutes?: number | null | undefined; } | undefined; } | { type: "discord"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { sessionIdleTimeoutMinutes?: number | null | undefined; } | undefined; } | { type: "whatsapp"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { sessionIdleTimeoutMinutes?: number | null | undefined; typingIndicator?: boolean | undefined; downloadMedia?: boolean | undefined; mediaRetentionDays?: number | undefined; } | undefined; } | { type: "teams"; credentialId: string; approval?: { mode: "global"; } | { mode: "selected"; tools: string[]; } | undefined; settings?: { sessionIdleTimeoutMinutes?: number | null | undefined; displayName?: string | undefined; description?: string | undefined; teamChannels?: boolean | undefined; groupChats?: boolean | undefined; readAllChannelMessages?: boolean | undefined; readAllGroupMessages?: boolean | undefined; } | undefined; } | { type: "n8n_chat"; credentialId: ""; })[] | undefined; mcpServers?: { name: string; description?: string | undefined; url: string; transport: "sse" | "streamableHttp"; authentication: string; credential?: string | undefined; metadata?: { nodeTypeName?: string | undefined; } | undefined; toolPermissions?: { categories: { read: "always_allow" | "blocked" | "require_approval"; write: "always_allow" | "blocked" | "require_approval"; }; tools?: Record | undefined; } | undefined; connectionTimeoutMs?: number | undefined; }[] | undefined; vectorStores?: ({ name: string; credential: string; useWhen: string; embedding: { model: string; credential: string; }; provider: "pinecone"; indexName: string; namespace?: string | undefined; } | { name: string; credential: string; useWhen: string; embedding: { model: string; credential: string; }; provider: "qdrant"; collectionName: string; } | { name: string; credential: string; useWhen: string; embedding: { model: string; credential: string; }; provider: "supabase"; tableName: string; queryName?: string | undefined; } | { name: string; credential: string; useWhen: string; embedding: { model: string; credential: string; }; provider: "postgres"; tableName: string; })[] | undefined; config?: { reasoning?: "high" | "low" | "medium" | undefined; promptCaching?: { enabled: boolean; anthropic?: { ttl?: "1h" | "5m" | undefined; } | undefined; } | undefined; webSearch?: { enabled: boolean; provider?: "auto" | "brave" | "native" | "searxng" | undefined; credential?: string | undefined; } | undefined; toolCallConcurrency?: number | undefined; maxIterations?: number | undefined; guardrails?: { budget?: { enabled: boolean; monthlyBudgetUsd?: number | undefined; alertThresholdPercent?: number | undefined; sessionCostCapUsd?: number | undefined; } | undefined; } | undefined; } | undefined; }; credentialProvider: import("./adapters/agents-credential-provider").AgentsCredentialProvider; }>; validateConfig(raw: unknown): Promise<{ valid: true; config: AgentJsonConfig; } | { valid: false; error: string; }>; private buildConfigReplacement; private mergeConfigSchema; private reconcileConfigReferences; private reconcileSubAgentReferences; validateSubAgentRefs(resolvedSubAgents: Array<{ agentId: string; }>, ownerAgentId: string): void; } export declare function writesField(config: AgentJsonConfig, field: keyof AgentJsonConfig, clearOmitted: boolean): boolean;