n8n 2.20.6 → 2.21.0

package/dist/modules/agents/integrations/agent-schedule.service.d.ts

@@ -0,0 +1,30 @@
+import { type AgentScheduleConfig } from '@n8n/api-types';
+import { ProjectRelationRepository } from '@n8n/db';
+import { Logger } from '@n8n/backend-common';
+import { GlobalConfig } from '@n8n/config';
+import { AgentsService } from '../agents.service';
+import type { Agent } from '../entities/agent.entity';
+import { AgentRepository } from '../repositories/agent.repository';
+export declare class AgentScheduleService {
+    private readonly logger;
+    private readonly globalConfig;
+    private readonly agentRepository;
+    private readonly agentsService;
+    private readonly projectRelationRepository;
+    private readonly jobs;
+    constructor(logger: Logger, globalConfig: GlobalConfig, agentRepository: AgentRepository, agentsService: AgentsService, projectRelationRepository: ProjectRelationRepository);
+    getConfig(agent: Agent): AgentScheduleConfig;
+    saveConfig(agent: Agent, cronExpression: string, wakeUpPrompt?: string): Promise<AgentScheduleConfig>;
+    activate(agent: Agent): Promise<AgentScheduleConfig>;
+    deactivate(agent: Agent): Promise<AgentScheduleConfig>;
+    reconnectAll(): Promise<void>;
+    applyConfig(agent: Agent): Promise<void>;
+    registerOrRefresh(agent: Agent): Promise<void>;
+    deregister(agentId: string): void;
+    stopAll(): void;
+    private getScheduleIntegration;
+    private saveScheduleIntegration;
+    private assertCronExpressionIsValid;
+    private runScheduled;
+    private resolveExecutionUserId;
+}

package/dist/modules/agents/integrations/agent-schedule.service.js

@@ -0,0 +1,327 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentScheduleService = void 0;
+const api_types_1 = require("@n8n/api-types");
+const db_1 = require("@n8n/db");
+const backend_common_1 = require("@n8n/backend-common");
+const config_1 = require("@n8n/config");
+const decorators_1 = require("@n8n/decorators");
+const di_1 = require("@n8n/di");
+const cron_1 = require("cron");
+const crypto_1 = require("crypto");
+const luxon_1 = require("luxon");
+const bad_request_error_1 = require("../../../errors/response-errors/bad-request.error");
+const conflict_error_1 = require("../../../errors/response-errors/conflict.error");
+const agents_service_1 = require("../agents.service");
+const agent_repository_1 = require("../repositories/agent.repository");
+const cron_validation_1 = require("./cron-validation");
+let AgentScheduleService = class AgentScheduleService {
+    constructor(logger, globalConfig, agentRepository, agentsService, projectRelationRepository) {
+        this.logger = logger;
+        this.globalConfig = globalConfig;
+        this.agentRepository = agentRepository;
+        this.agentsService = agentsService;
+        this.projectRelationRepository = projectRelationRepository;
+        this.jobs = new Map();
+    }
+    getConfig(agent) {
+        const integration = this.getScheduleIntegration(agent);
+        return {
+            active: integration?.active ?? false,
+            cronExpression: integration?.cronExpression ?? '',
+            wakeUpPrompt: integration?.wakeUpPrompt ?? api_types_1.DEFAULT_AGENT_SCHEDULE_WAKE_UP_PROMPT,
+        };
+    }
+    async saveConfig(agent, cronExpression, wakeUpPrompt) {
+        const existing = this.getScheduleIntegration(agent);
+        const normalizedCronExpression = cronExpression.trim();
+        const nextWakeUpPrompt = wakeUpPrompt ?? existing?.wakeUpPrompt ?? api_types_1.DEFAULT_AGENT_SCHEDULE_WAKE_UP_PROMPT;
+        if (normalizedCronExpression !== '') {
+            this.assertCronExpressionIsValid(normalizedCronExpression);
+        }
+        else if (existing?.active) {
+            throw new bad_request_error_1.BadRequestError('Cron expression is required while the schedule is active');
+        }
+        const saved = await this.saveScheduleIntegration(agent, {
+            type: api_types_1.AGENT_SCHEDULE_TRIGGER_TYPE,
+            active: existing?.active ?? false,
+            cronExpression: normalizedCronExpression,
+            wakeUpPrompt: nextWakeUpPrompt,
+        });
+        if (this.getScheduleIntegration(saved)?.active) {
+            await this.registerOrRefresh(saved);
+        }
+        this.logger.debug('[AgentScheduleService] Saved schedule config', {
+            agentId: agent.id,
+            projectId: agent.projectId,
+            active: saved.integrations.find(api_types_1.isAgentScheduleIntegration)?.active ?? false,
+            cronExpression: normalizedCronExpression || null,
+        });
+        return this.getConfig(saved);
+    }
+    async activate(agent) {
+        if (!agent.publishedVersion) {
+            throw new conflict_error_1.ConflictError(`Agent "${agent.id}" must be published before activating the schedule trigger`);
+        }
+        const existing = this.getScheduleIntegration(agent);
+        const cronExpression = existing?.cronExpression.trim() ?? '';
+        if (cronExpression === '') {
+            throw new bad_request_error_1.BadRequestError('Cron expression is required before activation');
+        }
+        this.assertCronExpressionIsValid(cronExpression);
+        const saved = await this.saveScheduleIntegration(agent, {
+            type: api_types_1.AGENT_SCHEDULE_TRIGGER_TYPE,
+            active: true,
+            cronExpression,
+            wakeUpPrompt: existing?.wakeUpPrompt ?? api_types_1.DEFAULT_AGENT_SCHEDULE_WAKE_UP_PROMPT,
+        });
+        await this.registerOrRefresh(saved);
+        this.logger.info('[AgentScheduleService] Activated schedule trigger', {
+            agentId: agent.id,
+            projectId: agent.projectId,
+            cronExpression,
+        });
+        return this.getConfig(saved);
+    }
+    async deactivate(agent) {
+        const existing = this.getScheduleIntegration(agent);
+        if (!existing) {
+            this.deregister(agent.id);
+            return this.getConfig(agent);
+        }
+        const saved = await this.saveScheduleIntegration(agent, {
+            ...existing,
+            active: false,
+        });
+        this.deregister(agent.id);
+        this.logger.info('[AgentScheduleService] Deactivated schedule trigger', {
+            agentId: agent.id,
+            projectId: agent.projectId,
+        });
+        return this.getConfig(saved);
+    }
+    async reconnectAll() {
+        const agents = await this.agentRepository.findPublished();
+        this.logger.debug('[AgentScheduleService] Reconnecting active schedules', {
+            publishedAgentCount: agents.length,
+        });
+        for (const agent of agents) {
+            const schedule = this.getScheduleIntegration(agent);
+            if (!schedule?.active) {
+                continue;
+            }
+            try {
+                await this.registerOrRefresh(agent);
+            }
+            catch (error) {
+                this.logger.error('[AgentScheduleService] Failed to reconnect agent schedule', {
+                    agentId: agent.id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    async applyConfig(agent) {
+        const schedule = this.getScheduleIntegration(agent);
+        if (schedule?.active) {
+            await this.registerOrRefresh(agent);
+        }
+        else {
+            this.deregister(agent.id);
+        }
+    }
+    async registerOrRefresh(agent) {
+        const schedule = this.getScheduleIntegration(agent);
+        if (!schedule?.active) {
+            this.logger.debug('[AgentScheduleService] Skipping schedule registration for inactive agent', {
+                agentId: agent.id,
+                projectId: agent.projectId,
+            });
+            this.deregister(agent.id);
+            return;
+        }
+        if (!agent.publishedVersion) {
+            this.logger.warn('[AgentScheduleService] Skipping schedule registration for unpublished agent', {
+                agentId: agent.id,
+                projectId: agent.projectId,
+            });
+            this.deregister(agent.id);
+            return;
+        }
+        this.assertCronExpressionIsValid(schedule.cronExpression);
+        this.deregister(agent.id);
+        const timezone = this.globalConfig.generic.timezone;
+        const job = new cron_1.CronJob(schedule.cronExpression, () => {
+            void this.runScheduled(agent.id);
+        }, null, false, timezone);
+        job.start();
+        this.jobs.set(agent.id, job);
+        this.logger.info('[AgentScheduleService] Registered schedule trigger', {
+            agentId: agent.id,
+            projectId: agent.projectId,
+            cronExpression: schedule.cronExpression,
+            timezone,
+        });
+    }
+    deregister(agentId) {
+        const existing = this.jobs.get(agentId);
+        if (!existing) {
+            return;
+        }
+        void existing.stop();
+        this.jobs.delete(agentId);
+        this.logger.info('[AgentScheduleService] Deregistered schedule trigger', { agentId });
+    }
+    stopAll() {
+        for (const [agentId] of this.jobs) {
+            this.deregister(agentId);
+        }
+    }
+    getScheduleIntegration(agent) {
+        return (agent.integrations ?? []).find(api_types_1.isAgentScheduleIntegration);
+    }
+    async saveScheduleIntegration(agent, schedule) {
+        agent.integrations = [
+            ...(agent.integrations ?? []).filter((integration) => !(0, api_types_1.isAgentScheduleIntegration)(integration)),
+            schedule,
+        ];
+        return await this.agentRepository.save(agent);
+    }
+    assertCronExpressionIsValid(cronExpression) {
+        if (!(0, cron_validation_1.isValidCronExpression)(cronExpression)) {
+            throw new bad_request_error_1.BadRequestError('Invalid cron expression');
+        }
+    }
+    async runScheduled(agentId) {
+        let projectId;
+        let threadId;
+        let cronExpression;
+        const startedAt = Date.now();
+        try {
+            const agent = await this.agentRepository.findOne({
+                where: { id: agentId },
+                relations: { publishedVersion: true },
+            });
+            if (!agent) {
+                this.logger.warn('[AgentScheduleService] Scheduled trigger fired for missing agent', {
+                    agentId,
+                });
+                this.deregister(agentId);
+                return;
+            }
+            projectId = agent.projectId;
+            const schedule = this.getScheduleIntegration(agent);
+            cronExpression = schedule?.cronExpression;
+            if (!agent.publishedVersion) {
+                this.logger.warn('[AgentScheduleService] Scheduled trigger fired for unpublished agent', {
+                    agentId,
+                    projectId,
+                });
+                this.deregister(agentId);
+                return;
+            }
+            if (!schedule?.active) {
+                this.logger.warn('[AgentScheduleService] Scheduled trigger fired for inactive agent', {
+                    agentId,
+                    projectId,
+                });
+                this.deregister(agentId);
+                return;
+            }
+            const executionUserId = await this.resolveExecutionUserId(agent);
+            if (!executionUserId) {
+                this.logger.warn('[AgentScheduleService] No project member available for scheduled run', {
+                    agentId,
+                    projectId: agent.projectId,
+                });
+                return;
+            }
+            threadId = `schedule-${agentId}-${(0, crypto_1.randomUUID)()}`;
+            const timezone = this.globalConfig.generic.timezone;
+            const timestamp = luxon_1.DateTime.now().setZone(timezone).toISO() ?? new Date().toISOString();
+            const message = `${schedule.wakeUpPrompt}\n\nCurrent date and time: ${timestamp} (timezone: ${timezone})`;
+            this.logger.info('[AgentScheduleService] Scheduled trigger fired', {
+                agentId,
+                projectId,
+                threadId,
+                cronExpression: schedule.cronExpression,
+                timezone,
+            });
+            this.logger.debug('[AgentScheduleService] Starting scheduled agent run', {
+                agentId,
+                projectId,
+                threadId,
+                messageLength: message.length,
+            });
+            let chunkCount = 0;
+            for await (const _chunk of this.agentsService.executeForSchedulePublished({
+                agentId: agent.id,
+                projectId: agent.projectId,
+                message,
+                memory: { threadId, resourceId: executionUserId },
+            })) {
+                chunkCount += 1;
+            }
+            this.logger.info('[AgentScheduleService] Scheduled agent run completed', {
+                agentId,
+                projectId,
+                threadId,
+                chunkCount,
+                durationMs: Date.now() - startedAt,
+            });
+        }
+        catch (error) {
+            this.logger.error('[AgentScheduleService] Scheduled agent run failed', {
+                agentId,
+                projectId,
+                threadId,
+                cronExpression,
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+        }
+    }
+    async resolveExecutionUserId(agent) {
+        const userIds = await this.projectRelationRepository.findUserIdsByProjectId(agent.projectId);
+        if (userIds.length === 0) {
+            return undefined;
+        }
+        const publishedById = agent.publishedVersion?.publishedById;
+        if (publishedById && userIds.includes(publishedById)) {
+            return publishedById;
+        }
+        return undefined;
+    }
+};
+exports.AgentScheduleService = AgentScheduleService;
+__decorate([
+    (0, decorators_1.OnLeaderTakeover)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AgentScheduleService.prototype, "reconnectAll", null);
+__decorate([
+    (0, decorators_1.OnLeaderStepdown)(),
+    (0, decorators_1.OnShutdown)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], AgentScheduleService.prototype, "stopAll", null);
+exports.AgentScheduleService = AgentScheduleService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [backend_common_1.Logger,
+        config_1.GlobalConfig,
+        agent_repository_1.AgentRepository,
+        agents_service_1.AgentsService,
+        db_1.ProjectRelationRepository])
+], AgentScheduleService);
+//# sourceMappingURL=agent-schedule.service.js.map

package/dist/modules/agents/integrations/agent-schedule.service.js.map

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

package/dist/modules/agents/integrations/callback-store.d.ts

@@ -0,0 +1,11 @@
+export interface CallbackPayload {
+    actionId: string;
+    value: string;
+}
+export declare class CallbackStore {
+    private readonly entries;
+    constructor(ttlMs?: number);
+    store(actionId: string, value: string): Promise<string>;
+    resolve(key: string): Promise<CallbackPayload | undefined>;
+    dispose(): void;
+}

package/dist/modules/agents/integrations/callback-store.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallbackStore = void 0;
+const node_crypto_1 = require("node:crypto");
+const ttl_map_1 = require("../../../utils/ttl-map");
+class CallbackStore {
+    constructor(ttlMs = 60 * 60 * 1000) {
+        this.entries = new ttl_map_1.TtlMap(ttlMs);
+    }
+    async store(actionId, value) {
+        let key;
+        do {
+            key = (0, node_crypto_1.randomBytes)(4).toString('hex');
+        } while (this.entries.has(key));
+        this.entries.set(key, { actionId, value });
+        return key;
+    }
+    async resolve(key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return undefined;
+        this.entries.delete(key);
+        return entry;
+    }
+    dispose() {
+        this.entries.dispose();
+    }
+}
+exports.CallbackStore = CallbackStore;
+//# sourceMappingURL=callback-store.js.map

package/dist/modules/agents/integrations/callback-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-store.js","sourceRoot":"","sources":["../../../../src/modules/agents/integrations/callback-store.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,6CAAyC;AAezC,MAAa,aAAa;IAGzB,YAAY,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAM,CAA0B,KAAK,CAAC,CAAC;IAC3D,CAAC;IAGD,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,KAAa;QAC1C,IAAI,GAAW,CAAC;QAChB,GAAG,CAAC;YACH,GAAG,GAAG,IAAA,yBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,OAAO,GAAG,CAAC;IACZ,CAAC;IAGD,KAAK,CAAC,OAAO,CAAC,GAAW;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,KAAK,CAAC;IACd,CAAC;IAGD,OAAO;QACN,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACD;AA7BD,sCA6BC"}

package/dist/modules/agents/integrations/chat-integration.service.d.ts

@@ -0,0 +1,58 @@
+import { type AgentCredentialIntegration, type AgentIntegrationStatusResponse } from '@n8n/api-types';
+import { Logger } from '@n8n/backend-common';
+import { GlobalConfig } from '@n8n/config';
+import { InstanceSettings } from 'n8n-core';
+import { CredentialsFinderService } from '../../../credentials/credentials-finder.service';
+import { CredentialsService } from '../../../credentials/credentials.service';
+import type { PubSubCommandMap } from '../../../scaling/pubsub/pubsub.event-map';
+import { Publisher } from '../../../scaling/pubsub/publisher.service';
+import { UrlService } from '../../../services/url.service';
+import { ChatIntegrationRegistry } from './agent-chat-integration';
+import type { Agent } from '../entities/agent.entity';
+import { AgentRepository } from '../repositories/agent.repository';
+type WebhookHandler = (request: Request, options?: {
+    waitUntil?: (task: Promise<unknown>) => void;
+}) => Promise<Response>;
+interface ChatInstance {
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    webhooks: Record<string, WebhookHandler>;
+    onNewMention: (handler: unknown) => void;
+    onSubscribedMessage: (handler: unknown) => void;
+    onAction: (handler: unknown) => void;
+}
+export declare class ChatIntegrationService {
+    private readonly logger;
+    private readonly agentRepository;
+    private readonly credentialsService;
+    private readonly credentialsFinderService;
+    private readonly urlService;
+    private readonly integrationRegistry;
+    private readonly instanceSettings;
+    private readonly publisher;
+    private readonly globalConfig;
+    private readonly connections;
+    constructor(logger: Logger, agentRepository: AgentRepository, credentialsService: CredentialsService, credentialsFinderService: CredentialsFinderService, urlService: UrlService, integrationRegistry: ChatIntegrationRegistry, instanceSettings: InstanceSettings, publisher: Publisher, globalConfig: GlobalConfig);
+    broadcastIntegrationChange(agentId: string, type: string, credentialId: string, action: 'connect' | 'disconnect'): Promise<void>;
+    private connectionKey;
+    private connectionTypeFromKey;
+    connect(agentId: string, credentialId: string, integrationType: string, userId: string, projectId: string, options?: {
+        skipExternalHooks?: boolean;
+    }): Promise<void>;
+    disconnect(agentId: string, type?: string, credentialId?: string): Promise<void>;
+    disconnectAll(): Promise<void>;
+    disconnectLeaderOnlyIntegrations(): Promise<void>;
+    syncToConfig(agent: Agent, previous: AgentCredentialIntegration[], next: AgentCredentialIntegration[]): Promise<void>;
+    getStatus(agentId: string): AgentIntegrationStatusResponse & {
+        connections: number;
+    };
+    getChatInstance(agentId: string): ChatInstance | undefined;
+    getWebhookHandler(agentId: string, platform: string): WebhookHandler | undefined;
+    reconnectAll(): Promise<void>;
+    handleIntegrationChanged(payload: PubSubCommandMap['agent-chat-integration-changed']): Promise<void>;
+    private disconnectOne;
+    private resolveUser;
+    private decryptCredential;
+    private buildWebhookUrl;
+}
+export {};