n8n 2.41.3 → 2.42.0

package/dist/modules/agents/agent-runtime-reconstruction.service.d.ts

@@ -1,5 +1,5 @@
-import { type Agent as RuntimeAgent, CredentialProvider, ToolDescriptor } from '@n8n/agents';
-import { type AgentIntegrationConfig, type AgentJsonConfig, type AgentSkill, type SubAgentSource } from '@n8n/api-types';
+import { type Agent as RuntimeAgent, type CreateDelegateSubAgentToolOptions, CredentialProvider } from '@n8n/agents';
+import { type AgentIntegrationConfig, type AgentJsonConfig, type SubAgentSource } from '@n8n/api-types';
 import { Logger } from '@n8n/backend-common';
 import { OutboundHttp } from '@n8n/backend-network';
 import type { User } from '@n8n/db';
@@ -24,25 +24,24 @@ import { N8nMemory } from './integrations/n8n-memory';
 import { AgentFileRepository } from './repositories/agent-file.repository';
 import { AgentRepository } from './repositories/agent.repository';
 import { AgentSecureRuntime } from './runtime/agent-secure-runtime';
-import { type ToolRegistry } from './tool-registry';
+import { type ReferencedToolKind, type ToolRegistry } from './tool-registry';
 import type { WorkflowToolExecutionMode } from './tools/workflow-tool-factory';
+import { type AgentRuntimeAssets } from './utils/agent-runtime-assets';
 export type AgentRuntimeProfile = 'top-level' | 'sub-agent' | 'inline';
+export interface ReconstructedAgentRuntime {
+    agent: RuntimeAgent;
+    toolRegistry: ToolRegistry;
+    mcpServerAttributions: Map<string, string>;
+}
 export interface SubAgentDelegationConfig {
     sourcesById: Record<string, SubAgentSource>;
-    availableSubAgents: Array<{
-        id: string;
-        name: string;
-        useWhen?: string;
-    }>;
+    availableSubAgents: NonNullable<CreateDelegateSubAgentToolOptions['availableSubAgents']>;
 }
-export interface ReconstructAgentRuntimeParams {
+export interface ReconstructAgentRuntimeParams extends AgentRuntimeAssets {
     config: AgentJsonConfig;
     memoryOwnerAgentId: string;
     projectId: string;
     credentialProvider: CredentialProvider;
-    toolDescriptors: Record<string, ToolDescriptor>;
-    toolCodeByName: Record<string, string>;
-    skills: Record<string, AgentSkill>;
     runtimeProfile: AgentRuntimeProfile;
     runType: AgentRunTelemetryType;
     workflowToolExecutionMode?: WorkflowToolExecutionMode;
@@ -50,6 +49,7 @@ export interface ReconstructAgentRuntimeParams {
     integrationType?: string;
     credentialIntegrations?: AgentIntegrationConfig[];
     user?: User;
+    attributionUserId?: string;
     instrumentation?: AgentRuntimeInstrumentation;
     sandboxPrincipalHash?: AgentSandboxPrincipalHash;
     parentWorkspace?: {
@@ -63,7 +63,7 @@ export interface UserToolAccessSnapshot {
 }
 export interface UnavailableTool {
     toolName: string;
-    toolType: 'workflow' | 'node';
+    toolType: ReferencedToolKind;
     reason: 'not_found' | 'not_published' | 'incompatible' | 'no_access';
     message: string;
 }
@@ -88,29 +88,34 @@ export declare class AgentRuntimeReconstructionService {
     private readonly workflowFinderService;
     private readonly agentChatAttachmentService;
     constructor(logger: Logger, agentRepository: AgentRepository, agentFileRepository: AgentFileRepository, activeExecutions: ActiveExecutions, workflowRepository: WorkflowRepository, n8nCheckpointStorage: N8NCheckpointStorage, secureRuntime: AgentSecureRuntime, ephemeralNodeExecutor: EphemeralNodeExecutor, n8nMemory: N8nMemory, oauthService: OauthService, mcpRegistryService: McpRegistryService, agentSandboxRuntimeService: AgentSandboxRuntimeService, aiService: AiService, outboundHttp: OutboundHttp, agentWorkspaceService: AgentWorkspaceService, agentKnowledgeMirrorService: AgentKnowledgeMirrorService, credentialsFinderService: CredentialsFinderService, workflowFinderService: WorkflowFinderService, agentChatAttachmentService: AgentChatAttachmentService);
-    reconstructFromAgentEntity(agentEntity: Agent, credentialProvider: CredentialProvider, runType: AgentRunTelemetryType, integrationType?: string, user?: User, instrumentation?: AgentRuntimeInstrumentation, workflowToolExecutionMode?: WorkflowToolExecutionMode, sandboxPrincipalHash?: AgentSandboxPrincipalHash, { supportsHitl, previewChat, allowBackgroundTasks, }?: {
+    reconstructFromAgentEntity(agentEntity: Agent, credentialProvider: CredentialProvider, runType: AgentRunTelemetryType, integrationType?: string, user?: User, instrumentation?: AgentRuntimeInstrumentation, workflowToolExecutionMode?: WorkflowToolExecutionMode, sandboxPrincipalHash?: AgentSandboxPrincipalHash, { supportsHitl, previewChat, allowBackgroundTasks, attributionUserId, }?: {
         supportsHitl?: boolean;
         previewChat?: boolean;
         allowBackgroundTasks?: boolean;
-    }): Promise<{
-        agent: RuntimeAgent;
-        toolRegistry: ToolRegistry;
-        mcpServerAttributions: Map<string, string>;
+        attributionUserId?: string;
+    }): Promise<ReconstructedAgentRuntime & {
         userToolAccessSnapshot?: UserToolAccessSnapshot;
     }>;
     private filterToolsForUser;
+    private checkToolAccess;
     userStillHasToolAccess(snapshot: UserToolAccessSnapshot, projectId: string, user: User): Promise<boolean>;
-    reconstructFromResolvedSource(params: ReconstructAgentRuntimeParams): Promise<{
-        agent: RuntimeAgent;
-        toolRegistry: ToolRegistry;
-        mcpServerAttributions: Map<string, string>;
-    }>;
+    reconstructFromResolvedSource(params: ReconstructAgentRuntimeParams): Promise<ReconstructedAgentRuntime>;
     private reconstructRuntime;
+    private buildConfiguredRuntime;
+    private createRuntimeToolResolver;
+    private makeMcpClientFactory;
     createSubAgentDelegationConfig(config: AgentJsonConfig, projectId: string): Promise<SubAgentDelegationConfig>;
     private getMemoryFactory;
     private resolveManagedEmbeddingProviderOptions;
     private makeToolResolver;
+    private resolveWorkflowTool;
     private injectRuntimeDependencies;
+    private attachWorkspaceAndKnowledge;
+    private attachWorkspace;
+    private attachIntegrationTools;
+    private createIntegrationDescriptors;
+    private createN8nChatDescriptor;
+    private attachTopLevelTools;
     private attachSubAgentDelegationTool;
     private resolveInlineSubAgentModelsByDifficulty;
     private attachWriteTodosTool;