n8n 2.45.3 → 2.46.0

package/dist/modules/agents/system-agents/system-agent-chat.controller.js

@@ -0,0 +1,313 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemAgentChatController = void 0;
+const api_types_1 = require("@n8n/api-types");
+const decorators_1 = require("@n8n/decorators");
+const errors_1 = require("@n8n/errors");
+const agent_chat_attachment_service_1 = require("../agent-chat-attachment.service");
+const agent_chat_execution_service_1 = require("../agent-chat-execution.service");
+const agent_chat_relay_service_1 = require("../agent-chat-relay.service");
+const agent_execution_orchestrator_service_1 = require("../agent-execution-orchestrator.service");
+const agent_message_queue_service_1 = require("../agent-message-queue.service");
+const n8n_checkpoint_storage_1 = require("../integrations/n8n-checkpoint-storage");
+const agent_thread_access_1 = require("../utils/agent-thread-access");
+const messages_envelope_1 = require("../utils/messages-envelope");
+const parse_thread_list_limit_1 = require("../utils/parse-thread-list-limit");
+const system_agent_execution_service_1 = require("./system-agent-execution.service");
+let SystemAgentChatController = class SystemAgentChatController {
+    constructor(systemAgents, chatRelay, messageQueue, chatExecutionService, orchestrator, checkpointStorage, attachments) {
+        this.systemAgents = systemAgents;
+        this.chatRelay = chatRelay;
+        this.messageQueue = messageQueue;
+        this.chatExecutionService = chatExecutionService;
+        this.orchestrator = orchestrator;
+        this.checkpointStorage = checkpointStorage;
+        this.attachments = attachments;
+    }
+    async chat(req, res, agentId, payload) {
+        const projectId = typeof req.query.projectId === 'string' ? req.query.projectId : undefined;
+        const { message, sessionId, messageId, attachments, clientContext } = payload;
+        await this.chatRelay.relayQueuedMessage(res, async () => await this.systemAgents.prepareChatMessage({
+            agentId,
+            user: req.user,
+            projectId,
+            sessionId,
+            message,
+            messageId,
+            clientContext,
+            storeAttachments: async (threadId, projectId) => await this.chatRelay.storeChatAttachments({
+                attachments,
+                agentId,
+                projectId,
+                threadId,
+                resourceId: this.systemAgents.resourceIdFor(req.user),
+                source: agent_thread_access_1.SYSTEM_CHAT_SOURCE,
+            }),
+        }));
+    }
+    async listThreads(req) {
+        const limit = (0, parse_thread_list_limit_1.parseThreadListLimit)(typeof req.query.limit === 'string' ? req.query.limit : undefined);
+        const threads = await this.systemAgents.listThreads(req.params.agentId, req.user, limit);
+        return {
+            data: threads.map((thread) => ({
+                id: thread.id,
+                title: thread.title,
+                updatedAt: thread.updatedAt.toISOString(),
+                projectId: thread.projectId,
+            })),
+        };
+    }
+    async chatResume(req, res, agentId, payload) {
+        await this.chatRelay.relayResume(res, async ({ send, onExecutionStarted }) => await this.systemAgents.resumeRun({
+            agentId,
+            user: req.user,
+            runId: payload.runId,
+            toolCallId: payload.toolCallId,
+            resumeData: payload.resumeData,
+            send,
+            onExecutionStarted,
+        }));
+    }
+    async cancelChatExecution(req, _res, agentId, threadId, executionId, payload = {}) {
+        const thread = await this.systemAgents.getThread(agentId, req.user, threadId);
+        const cancelRequested = await this.chatExecutionService.requestCancel({
+            projectId: thread.projectId,
+            agentId,
+            threadId: thread.id,
+            executionId,
+            userId: req.user.id,
+            surface: 'system',
+            ...(payload.scope ? { scope: payload.scope } : {}),
+        });
+        return { cancelRequested };
+    }
+    async cancelChatRun(req, _res, agentId, runId, payload = {}) {
+        this.systemAgents.assertRegistered(agentId);
+        const cancelled = await this.orchestrator.cancelChatRun({
+            agentId,
+            runId,
+            resourceId: this.systemAgents.resourceIdFor(req.user),
+            ...(payload.scope === 'foreground' ? { cancelBackgroundJobs: false } : {}),
+        });
+        return { cancelled };
+    }
+    async deleteChatThread(req, _res, agentId, threadId) {
+        await this.systemAgents.deleteThread(agentId, req.user, threadId);
+        return { success: true };
+    }
+    async getChatMessages(req) {
+        const { agentId, threadId } = req.params;
+        const thread = await this.systemAgents.getUsableThread(agentId, req.user, threadId);
+        const history = await this.orchestrator.getConversationHistory({
+            threadId: thread.id,
+            projectId: thread.projectId,
+            agentId,
+            userId: req.user.id,
+        });
+        const checkpoint = await this.checkpointStorage.findSuspendedForThread(agentId, thread.id);
+        return (0, messages_envelope_1.threadMessagesResponse)(history, (0, messages_envelope_1.ownCheckpoint)(checkpoint, this.systemAgents.resourceIdFor(req.user)));
+    }
+    async getChatAttachment(req, res) {
+        const { agentId, attachmentId } = req.params;
+        this.systemAgents.assertRegistered(agentId);
+        const attachment = await this.attachments.getForSystemAgent(attachmentId, {
+            agentId,
+            resourceId: this.systemAgents.resourceIdFor(req.user),
+            source: agent_thread_access_1.SYSTEM_CHAT_SOURCE,
+        });
+        if (!attachment) {
+            throw new errors_1.NotFoundError(`Attachment "${attachmentId}" not found`);
+        }
+        await this.systemAgents.getUsableThread(agentId, req.user, attachment.threadId);
+        await this.chatRelay.streamAttachment(attachment, res);
+    }
+    async getBackgroundJobs(req) {
+        await this.systemAgents.getUsableThread(req.params.agentId, req.user, req.params.threadId);
+        return { tasks: [] };
+    }
+    async getUsage(req) {
+        const thread = await this.systemAgents.getUsableThread(req.params.agentId, req.user, req.params.threadId);
+        return await this.systemAgents.getUsage(thread);
+    }
+    async getQueuedMessages(req) {
+        const thread = await this.systemAgents.getUsableThread(req.params.agentId, req.user, req.params.threadId);
+        return await this.messageQueue.listPending({
+            ...this.queueScope(req, thread.projectId),
+            kind: 'system',
+        });
+    }
+    async updateQueuedMessage(req, _res, payload) {
+        const thread = await this.usableQueueThread(req);
+        await this.messageQueue.updatePending({
+            ...this.queueScope(req, thread.projectId),
+            queueId: req.params.queueId,
+            message: payload.message,
+            kind: 'system',
+        });
+    }
+    async reorderQueuedMessage(req, _res, payload) {
+        const thread = await this.usableQueueThread(req);
+        await this.messageQueue.reorderPending({
+            ...this.queueScope(req, thread.projectId),
+            queueId: req.params.queueId,
+            targetQueueId: payload.targetQueueId,
+            expectedQueueIds: payload.expectedQueueIds,
+            kind: 'system',
+        });
+    }
+    async removeQueuedMessage(req) {
+        const thread = await this.usableQueueThread(req);
+        await this.messageQueue.removePending({
+            ...this.queueScope(req, thread.projectId),
+            queueId: req.params.queueId,
+            kind: 'system',
+        });
+        return { removed: true };
+    }
+    async steerQueuedMessage(req, _res, payload) {
+        const thread = await this.usableQueueThread(req);
+        await this.messageQueue.steer({
+            ...this.queueScope(req, thread.projectId),
+            queueId: req.params.queueId,
+            executionId: payload.executionId,
+            kind: 'system',
+        });
+    }
+    async usableQueueThread(req) {
+        if (!/^[1-9]\d*$/.test(req.params.queueId))
+            throw new errors_1.BadRequestError('Invalid queue ID');
+        return await this.systemAgents.getUsableThread(req.params.agentId, req.user, req.params.threadId);
+    }
+    queueScope(req, projectId) {
+        return {
+            projectId,
+            agentId: req.params.agentId,
+            threadId: req.params.threadId,
+            userId: req.user.id,
+        };
+    }
+};
+exports.SystemAgentChatController = SystemAgentChatController;
+__decorate([
+    (0, decorators_1.Post)('/:agentId/chat', { usesTemplates: true }),
+    __param(2, (0, decorators_1.Param)('agentId')),
+    __param(3, decorators_1.Body),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, api_types_1.AgentChatMessageDto]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "chat", null);
+__decorate([
+    (0, decorators_1.Get)('/:agentId/threads'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "listThreads", null);
+__decorate([
+    (0, decorators_1.Post)('/:agentId/chat/resume', { usesTemplates: true }),
+    __param(2, (0, decorators_1.Param)('agentId')),
+    __param(3, decorators_1.Body),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, api_types_1.AgentChatResumeDto]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "chatResume", null);
+__decorate([
+    (0, decorators_1.Delete)('/:agentId/chat/:threadId/executions/:executionId'),
+    __param(2, (0, decorators_1.Param)('agentId')),
+    __param(3, (0, decorators_1.Param)('threadId')),
+    __param(4, (0, decorators_1.Param)('executionId')),
+    __param(5, decorators_1.Query),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, String, String, api_types_1.AgentChatCancelDto]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "cancelChatExecution", null);
+__decorate([
+    (0, decorators_1.Delete)('/:agentId/chat/runs/:runId'),
+    __param(2, (0, decorators_1.Param)('agentId')),
+    __param(3, (0, decorators_1.Param)('runId')),
+    __param(4, decorators_1.Query),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, String, api_types_1.AgentChatCancelDto]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "cancelChatRun", null);
+__decorate([
+    (0, decorators_1.Delete)('/:agentId/chat/:threadId'),
+    __param(2, (0, decorators_1.Param)('agentId')),
+    __param(3, (0, decorators_1.Param)('threadId')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, String]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "deleteChatThread", null);
+__decorate([
+    (0, decorators_1.Get)('/:agentId/chat/:threadId/messages'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "getChatMessages", null);
+__decorate([
+    (0, decorators_1.Get)('/:agentId/chat/attachments/:attachmentId'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "getChatAttachment", null);
+__decorate([
+    (0, decorators_1.Get)('/:agentId/chat/:threadId/background-tasks'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "getBackgroundJobs", null);
+__decorate([
+    (0, decorators_1.Get)('/:agentId/chat/:threadId/usage'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "getUsage", null);
+__decorate([
+    (0, decorators_1.Get)('/:agentId/chat/:threadId/queue'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "getQueuedMessages", null);
+__decorate([
+    (0, decorators_1.Patch)('/:agentId/chat/:threadId/queue/:queueId'),
+    __param(2, decorators_1.Body),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, api_types_1.AgentChatQueueUpdateDto]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "updateQueuedMessage", null);
+__decorate([
+    (0, decorators_1.Post)('/:agentId/chat/:threadId/queue/:queueId/reorder'),
+    __param(2, decorators_1.Body),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, api_types_1.AgentChatQueueReorderDto]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "reorderQueuedMessage", null);
+__decorate([
+    (0, decorators_1.Delete)('/:agentId/chat/:threadId/queue/:queueId'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "removeQueuedMessage", null);
+__decorate([
+    (0, decorators_1.Post)('/:agentId/chat/:threadId/queue/:queueId/steer'),
+    __param(2, decorators_1.Body),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, api_types_1.AgentChatQueueSteerDto]),
+    __metadata("design:returntype", Promise)
+], SystemAgentChatController.prototype, "steerQueuedMessage", null);
+exports.SystemAgentChatController = SystemAgentChatController = __decorate([
+    (0, decorators_1.RestController)('/agents/system'),
+    __metadata("design:paramtypes", [system_agent_execution_service_1.SystemAgentExecutionService, agent_chat_relay_service_1.AgentChatRelayService, agent_message_queue_service_1.AgentMessageQueueService, agent_chat_execution_service_1.AgentChatExecutionService, agent_execution_orchestrator_service_1.AgentExecutionOrchestratorService, n8n_checkpoint_storage_1.N8NCheckpointStorage, agent_chat_attachment_service_1.AgentChatAttachmentService])
+], SystemAgentChatController);
+//# sourceMappingURL=system-agent-chat.controller.js.map

package/dist/modules/agents/system-agents/system-agent-chat.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-agent-chat.controller.js","sourceRoot":"","sources":["../../../../src/modules/agents/system-agents/system-agent-chat.controller.ts"],"names":[],"mappings":"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"}

package/dist/modules/agents/system-agents/system-agent-execution.service.d.ts

@@ -0,0 +1,141 @@
+import type { SerializableAgentState } from '@n8n/agents';
+import type { AgentSseEvent, AgentThreadUsageResponse } from '@n8n/api-types';
+import { Logger } from '@n8n/backend-common';
+import { TransactionRunner, type User } from '@n8n/db';
+import { AgentChatAttachmentService } from '../agent-chat-attachment.service';
+import { AgentChatExecutionService } from '../agent-chat-execution.service';
+import { AgentConversationStateService } from '../agent-conversation-state.service';
+import { AgentExecutionService } from '../agent-execution.service';
+import type { ClaimedAgentMessage } from '../agent-message-queue.service';
+import { AgentMessageQueueService } from '../agent-message-queue.service';
+import { AgentTurnExecutionService } from '../agent-turn-execution.service';
+import type { AgentExecutionThread } from '../entities/agent-execution-thread.entity';
+import { N8NCheckpointStorage } from '../integrations/n8n-checkpoint-storage';
+import { N8nMemory } from '../integrations/n8n-memory';
+import { AgentExecutionRepository } from '../repositories/agent-execution.repository';
+import { AgentExecutionThreadRepository } from '../repositories/agent-execution-thread.repository';
+import { AgentThreadGrantRepository } from '../repositories/agent-thread-grant.repository';
+import type { StoredAttachmentRef } from '../types/agent-chat-attachment';
+import { SystemAgentRegistry } from './system-agent-registry';
+import type { SystemAgentProvider, SystemAgentTurnOptions } from './system-agent.types';
+export type SystemAgentThreadStatus = 'running' | 'suspended' | 'idle';
+type SystemQueueInput = Parameters<AgentMessageQueueService['enqueue']>[0];
+interface SystemMessageInput {
+    message: string;
+    attachments?: StoredAttachmentRef[];
+    options?: SystemAgentTurnOptions;
+    messageId?: string;
+    hidden?: boolean;
+}
+interface ResumeParams {
+    agentId: string;
+    user: User;
+    threadId: string;
+    resumeData: unknown;
+    runId?: string;
+    toolCallId?: string;
+    send?: (event: AgentSseEvent) => void;
+    onExecutionStarted?: ExecutionStartedCallback;
+}
+type ExecutionStartedCallback = (executionId: string, threadId: string, inputMessageIds: string[]) => void;
+interface ResumeHandle {
+    runId: string;
+    toolCallId: string;
+    done: Promise<void>;
+}
+export declare class SystemAgentExecutionService {
+    private readonly logger;
+    private readonly registry;
+    private readonly threadRepository;
+    private readonly executionRepository;
+    private readonly executionService;
+    private readonly turnExecutionService;
+    private readonly messageQueue;
+    private readonly chatExecutionService;
+    private readonly checkpointStorage;
+    private readonly txRunner;
+    private readonly attachmentService;
+    private readonly conversationState;
+    private readonly n8nMemory;
+    private readonly threadGrants;
+    constructor(logger: Logger, registry: SystemAgentRegistry, threadRepository: AgentExecutionThreadRepository, executionRepository: AgentExecutionRepository, executionService: AgentExecutionService, turnExecutionService: AgentTurnExecutionService, messageQueue: AgentMessageQueueService, chatExecutionService: AgentChatExecutionService, checkpointStorage: N8NCheckpointStorage, txRunner: TransactionRunner, attachmentService: AgentChatAttachmentService, conversationState: AgentConversationStateService, n8nMemory: N8nMemory, threadGrants: AgentThreadGrantRepository);
+    resourceIdFor(user: Pick<User, 'id'>): string;
+    getProvider(agentId: string): SystemAgentProvider;
+    assertRegistered(agentId: string): void;
+    assertCanUse(agentId: string, user: User, projectId: string): Promise<SystemAgentProvider>;
+    getUsableThread(agentId: string, user: User, threadId: string): Promise<AgentExecutionThread>;
+    createThread(params: {
+        agentId: string;
+        user: User;
+        projectId: string;
+        threadId?: string;
+        title?: string;
+    }): Promise<AgentExecutionThread>;
+    private resolveSession;
+    listThreads(agentId: string, user: User, limit?: number): Promise<AgentExecutionThread[]>;
+    getThread(agentId: string, user: User, threadId: string): Promise<AgentExecutionThread>;
+    updateThread(agentId: string, user: User, threadId: string, changes: {
+        title?: string;
+        projectId?: string;
+    }): Promise<AgentExecutionThread>;
+    deleteThread(agentId: string, user: User, threadId: string): Promise<void>;
+    deleteThreadsOfUser(userId: string): Promise<void>;
+    private logUserSessionDeletionFailure;
+    private findDescendantSessions;
+    private stopRunningTurn;
+    private deleteWithRetry;
+    private deleteOwnedThread;
+    destroyThreadWorkspace(agentId: string, threadId: string, userId?: string): Promise<void>;
+    getStatus(thread: AgentExecutionThread): Promise<{
+        status: SystemAgentThreadStatus;
+        latestExecutionId: string | null;
+        checkpoint: SerializableAgentState | null;
+    }>;
+    private resolveStatus;
+    getUsage(thread: AgentExecutionThread): Promise<AgentThreadUsageResponse>;
+    sendMessage(params: SystemMessageInput & {
+        agentId: string;
+        user: User;
+        threadId: string;
+    }): Promise<{
+        status: 'accepted';
+        item: import("../entities/agent-message-queue.entity").AgentMessageQueue;
+    } | {
+        status: 'duplicate';
+    }>;
+    steerIntoRunningTurn(thread: AgentExecutionThread, user: User, queueId: string): Promise<boolean>;
+    consume(claim: ClaimedAgentMessage, user: User, signal: AbortSignal, send: (event: AgentSseEvent) => void): Promise<void>;
+    resume(params: ResumeParams): Promise<ResumeHandle>;
+    private startResume;
+    prepareChatMessage(params: {
+        agentId: string;
+        user: User;
+        projectId?: string;
+        sessionId?: string;
+        message: string;
+        messageId?: string;
+        clientContext?: Record<string, unknown>;
+        storeAttachments?: (threadId: string, projectId: string) => Promise<StoredAttachmentRef[] | undefined>;
+    }): Promise<SystemQueueInput>;
+    private queueInput;
+    resumeRun(params: {
+        agentId: string;
+        user: User;
+        runId: string;
+        toolCallId: string;
+        resumeData: unknown;
+        send: (event: AgentSseEvent) => void;
+        onExecutionStarted?: ExecutionStartedCallback;
+    }): Promise<void>;
+    cancel(agentId: string, user: User, threadId: string): Promise<boolean>;
+    private turnStateOf;
+    private readTurnAttachment;
+    private attachFileStore;
+    private acquireWorkspace;
+    private prepareOrRelease;
+    private createHostEventChannel;
+    private runTurn;
+    private turnErrorFormatter;
+    private formatTurnError;
+}
+export {};