n8n 2.23.2 → 2.24.0

package/dist/modules/agents/agents.controller.d.ts

@@ -1,13 +1,14 @@
-import { AgentBuildResumeDto, AgentChatMessageDto, type AgentBuilderMessagesResponse, type AgentIntegrationStatusResponse, type AgentPersistedMessageDto, type AgentScheduleConfig, type AgentSkill, type ChatIntegrationDescriptor, CreateSlackAgentAppDto, type CreateSlackAgentAppResponse, type SlackAgentAppManifestResponse, CreateAgentDto, CreateAgentSkillDto, UpdateAgentConfigDto, UpdateAgentDto, UpdateAgentScheduleDto, UpdateAgentSkillDto, AgentDisconnectIntegrationDto, PublishAgentDto } from '@n8n/api-types';
+import { AgentBuildResumeDto, AgentChatMessageDto, type AgentBuilderMessagesResponse, type AgentIntegrationStatusResponse, type AgentPersistedMessageDto, type AgentSkill, type AgentVersionListItemDto, type ChatIntegrationDescriptor, CreateSlackAgentAppDto, type CreateSlackAgentAppResponse, type SlackAgentAppManifestResponse, CreateAgentDto, CreateAgentSkillDto, PaginationDto, UpdateAgentConfigDto, UpdateAgentDto, UpdateAgentSkillDto, AgentDisconnectIntegrationDto, PublishAgentDto, CreateAgentTaskDto, UpdateAgentTaskDto, type AgentTaskDto, RevertAgentToVersionDto } from '@n8n/api-types';
 import type { AuthenticatedRequest } from '@n8n/db';
 import type { Request, Response } from 'express';
 import { CredentialsService } from '../../credentials/credentials.service';
 import { AgentExecutionService } from './agent-execution.service';
+import { AgentKnowledgeService } from './agent-knowledge.service';
 import { type FlushableResponse } from './agent-sse-stream';
+import { AgentTaskService } from './agent-task.service';
 import { AgentsService } from './agents.service';
 import { AgentsBuilderService } from './builder/agents-builder.service';
 import { ChatIntegrationRegistry } from './integrations/agent-chat-integration';
-import { AgentScheduleService } from './integrations/agent-schedule.service';
 import { ChatIntegrationService } from './integrations/chat-integration.service';
 import { SlackAppSetupService } from './integrations/slack-app-setup.service';
 import { AgentRepository } from './repositories/agent.repository';
@@ -17,18 +18,20 @@ export declare class AgentsController {
     private readonly agentsBuilderService;
     private readonly credentialsService;
     private readonly chatIntegrationService;
-    private readonly agentScheduleService;
     private readonly agentRepository;
     private readonly agentExecutionService;
     private readonly chatIntegrationRegistry;
     private readonly slackAppSetupService;
-    constructor(agentsService: AgentsService, agentsBuilderService: AgentsBuilderService, credentialsService: CredentialsService, chatIntegrationService: ChatIntegrationService, agentScheduleService: AgentScheduleService, agentRepository: AgentRepository, agentExecutionService: AgentExecutionService, chatIntegrationRegistry: ChatIntegrationRegistry, slackAppSetupService: SlackAppSetupService);
+    private readonly agentTaskService;
+    private readonly agentKnowledgeService;
+    constructor(agentsService: AgentsService, agentsBuilderService: AgentsBuilderService, credentialsService: CredentialsService, chatIntegrationService: ChatIntegrationService, agentRepository: AgentRepository, agentExecutionService: AgentExecutionService, chatIntegrationRegistry: ChatIntegrationRegistry, slackAppSetupService: SlackAppSetupService, agentTaskService: AgentTaskService, agentKnowledgeService: AgentKnowledgeService);
     private validateIntegration;
     private withRunnableState;
     create(req: AuthenticatedRequest<{
         projectId: string;
     }>, _res: Response, payload: CreateAgentDto): Promise<Agent & {
         isRunnable: boolean;
+        hasPublishHistory: boolean;
     }>;
     list(req: AuthenticatedRequest<{
         projectId: string;
@@ -44,10 +47,35 @@ export declare class AgentsController {
         instructions: string;
         description?: string | undefined;
         credential?: string | undefined;
+        tools?: ({
+            type: "custom";
+            id: string;
+            requireApproval?: boolean | undefined;
+        } | {
+            type: "workflow";
+            workflow: string;
+            description?: string | undefined;
+            name?: string | undefined;
+            requireApproval?: boolean | undefined;
+            allOutputs?: boolean | undefined;
+        } | {
+            type: "node";
+            name: string;
+            node: {
+                nodeType: string;
+                nodeTypeVersion: number;
+                nodeParameters: Record<string, unknown>;
+                credentials?: Record<string, {
+                    id: string;
+                    name: string;
+                }> | undefined;
+            };
+            description?: string | undefined;
+            requireApproval?: boolean | undefined;
+        })[] | undefined;
         memory?: {
             enabled: boolean;
             storage: "n8n";
-            lastMessages?: number | undefined;
             semanticRecall?: {
                 topK: number;
                 scope?: "thread" | "resource" | undefined;
@@ -59,6 +87,14 @@ export declare class AgentsController {
             } | undefined;
             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;
@@ -68,49 +104,31 @@ export declare class AgentsController {
             episodicMemory?: {
                 enabled: false;
             } | {
-                enabled: true;
                 credential: string;
+                enabled: true;
                 topK?: number | undefined;
+                reflectorModel?: {
+                    model: string;
+                    credential: string;
+                } | undefined;
+                extractorModel?: {
+                    model: string;
+                    credential: string;
+                } | undefined;
                 maxEntriesPerRun?: number | undefined;
             } | undefined;
         } | undefined;
-        tools?: ({
-            type: "custom";
-            id: string;
-            requireApproval?: boolean | undefined;
-        } | {
-            type: "workflow";
-            workflow: string;
-            description?: string | undefined;
-            name?: string | undefined;
-            requireApproval?: boolean | undefined;
-            allOutputs?: boolean | undefined;
-        } | {
-            type: "node";
-            name: string;
-            node: {
-                nodeType: string;
-                nodeTypeVersion: number;
-                nodeParameters: Record<string, unknown>;
-                credentials?: Record<string, {
-                    id: string;
-                    name: string;
-                }> | undefined;
-            };
-            description?: string | undefined;
-            requireApproval?: boolean | undefined;
-        })[] | undefined;
         skills?: {
             type: "skill";
             id: string;
         }[] | undefined;
+        tasks?: {
+            type: "task";
+            enabled: boolean;
+            id: string;
+        }[] | undefined;
         providerTools?: Record<string, Record<string, unknown>> | undefined;
         integrations?: ({
-            type: "schedule";
-            active: boolean;
-            cronExpression: string;
-            wakeUpPrompt: string;
-        } | {
             type: "telegram";
             credentialId: string;
             settings?: {
@@ -124,12 +142,42 @@ export declare class AgentsController {
             type: "linear";
             credentialId: string;
         })[] | undefined;
+        mcpServers?: {
+            name: string;
+            url: string;
+            transport: "sse" | "streamableHttp";
+            authentication: string;
+            description?: string | undefined;
+            credential?: string | undefined;
+            metadata?: {
+                nodeTypeName?: string | undefined;
+            } | undefined;
+            toolFilter?: {
+                mode: "allow";
+                tools: string[];
+            } | {
+                mode: "exclude";
+                tools: string[];
+            } | undefined;
+            approval?: {
+                mode: "global";
+            } | {
+                mode: "selected";
+                tools: string[];
+            } | undefined;
+            connectionTimeoutMs?: number | undefined;
+        }[] | undefined;
         config?: {
             thinking?: {
                 provider: "anthropic" | "openai";
                 budgetTokens?: number | undefined;
                 reasoningEffort?: string | undefined;
             } | undefined;
+            webSearch?: {
+                enabled: boolean;
+                provider?: "auto" | "native" | "brave" | "searxng" | undefined;
+                credential?: string | undefined;
+            } | undefined;
             toolCallConcurrency?: number | undefined;
             maxIterations?: number | undefined;
             nodeTools?: {
@@ -205,11 +253,28 @@ export declare class AgentsController {
         projectId: string;
     }>, _res: Response, agentId: string): Promise<Agent & {
         isRunnable: boolean;
+        hasPublishHistory: boolean;
     }>;
     update(req: AuthenticatedRequest<{
         projectId: string;
     }>, _res: Response, agentId: string, payload: UpdateAgentDto): Promise<Agent & {
         isRunnable: boolean;
+        hasPublishHistory: boolean;
+    }>;
+    private assertKnowledgeBaseEnabled;
+    listFiles(_req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, projectId: string, agentId: string): Promise<import("@n8n/api-types").AgentFileDto[]>;
+    uploadFiles(req: AuthenticatedRequest<{
+        projectId: string;
+    }> & {
+        files?: Express.Multer.File[];
+        fileUploadError?: Error;
+    }, _res: Response, projectId: string, agentId: string): Promise<import("@n8n/api-types").AgentFileDto[]>;
+    deleteFile(_req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, projectId: string, agentId: string, fileId: string): Promise<{
+        success: boolean;
     }>;
     delete(req: AuthenticatedRequest<{
         projectId: string;
@@ -220,17 +285,30 @@ export declare class AgentsController {
         projectId: string;
     }>, _res: Response, agentId: string, payload: PublishAgentDto): Promise<Agent & {
         isRunnable: boolean;
+        hasPublishHistory: boolean;
     }>;
     unpublish(req: AuthenticatedRequest<{
         projectId: string;
     }>, _res: Response, agentId: string): Promise<Agent & {
         isRunnable: boolean;
+        hasPublishHistory: boolean;
     }>;
     revertToPublished(req: AuthenticatedRequest<{
         projectId: string;
     }>, _res: Response, agentId: string): Promise<Agent & {
         isRunnable: boolean;
+        hasPublishHistory: boolean;
     }>;
+    revertToVersion(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string, payload: RevertAgentToVersionDto): Promise<Agent & {
+        isRunnable: boolean;
+        hasPublishHistory: boolean;
+    }>;
+    listVersions(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>, _res: Response, agentId: string, query: PaginationDto): Promise<AgentVersionListItemDto[]>;
     chat(req: AuthenticatedRequest<{
         projectId: string;
     }>, res: FlushableResponse, agentId: string, payload: AgentChatMessageDto): Promise<void>;
@@ -269,6 +347,13 @@ export declare class AgentsController {
         projectId: string;
     }>, _res: Response, agentId: string): Promise<{
         status: string;
+        agent: Agent & {
+            isRunnable: boolean;
+            hasPublishHistory: boolean;
+        };
+    } | {
+        status: string;
+        agent?: undefined;
     }>;
     createSlackApp(req: AuthenticatedRequest<{
         projectId: string;
@@ -290,18 +375,26 @@ export declare class AgentsController {
     }>, _res: Response, agentId: string, payload: AgentDisconnectIntegrationDto): Promise<{
         status: string;
     }>;
-    getScheduleIntegration(req: AuthenticatedRequest<{
+    private getAgentOrThrow;
+    listTasks(req: AuthenticatedRequest<{
         projectId: string;
-    }>, _res: Response, agentId: string): Promise<AgentScheduleConfig>;
-    updateScheduleIntegration(req: AuthenticatedRequest<{
+    }>, _res: Response, agentId: string): Promise<AgentTaskDto[]>;
+    createTask(req: AuthenticatedRequest<{
         projectId: string;
-    }>, _res: Response, agentId: string, payload: UpdateAgentScheduleDto): Promise<AgentScheduleConfig>;
-    activateScheduleIntegration(req: AuthenticatedRequest<{
+    }>, _res: Response, agentId: string, payload: CreateAgentTaskDto): Promise<AgentTaskDto>;
+    updateTask(req: AuthenticatedRequest<{
         projectId: string;
-    }>, _res: Response, agentId: string): Promise<AgentScheduleConfig>;
-    deactivateScheduleIntegration(req: AuthenticatedRequest<{
+    }>, _res: Response, agentId: string, taskId: string, payload: UpdateAgentTaskDto): Promise<AgentTaskDto>;
+    deleteTask(req: AuthenticatedRequest<{
         projectId: string;
-    }>, _res: Response, agentId: string): Promise<AgentScheduleConfig>;
+    }>, _res: Response, agentId: string, taskId: string): Promise<{
+        success: true;
+    }>;
+    runTaskNow(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string, taskId: string): Promise<{
+        success: true;
+    }>;
     integrationStatus(req: AuthenticatedRequest<{
         projectId: string;
     }>, _res: Response, agentId: string): Promise<AgentIntegrationStatusResponse>;