n8n 2.42.4 → 2.43.1

package/dist/modules/agents/agent-message-steering.service.js

@@ -0,0 +1,181 @@
+"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.AgentMessageSteeringService = void 0;
+const db_1 = require("@n8n/db");
+const di_1 = require("@n8n/di");
+const n8n_workflow_1 = require("n8n-workflow");
+const agent_execution_service_1 = require("./agent-execution.service");
+const agent_execution_update_broadcaster_1 = require("./agent-execution-update-broadcaster");
+const agent_message_mapper_1 = require("./agent-message-mapper");
+const n8n_checkpoint_storage_1 = require("./integrations/n8n-checkpoint-storage");
+const agent_execution_repository_1 = require("./repositories/agent-execution.repository");
+const agent_execution_thread_repository_1 = require("./repositories/agent-execution-thread.repository");
+const agent_message_queue_repository_1 = require("./repositories/agent-message-queue.repository");
+const agent_message_repository_1 = require("./repositories/agent-message.repository");
+const agent_queued_message_1 = require("./types/agent-queued-message");
+const agent_memory_scope_1 = require("./utils/agent-memory-scope");
+let AgentMessageSteeringService = class AgentMessageSteeringService {
+    constructor(txRunner, queue, threads, executions, messages, checkpoints, executionService, updates) {
+        this.txRunner = txRunner;
+        this.queue = queue;
+        this.threads = threads;
+        this.executions = executions;
+        this.messages = messages;
+        this.checkpoints = checkpoints;
+        this.executionService = executionService;
+        this.updates = updates;
+    }
+    async findEligible(thread, ctx = {}) {
+        const execution = await this.executions.findSteerable(thread.id, ctx);
+        if (!execution)
+            return null;
+        if (await this.checkpoints.findSuspendedForThread(thread.agentId, thread.id, ctx))
+            return null;
+        return execution;
+    }
+    async close(threadId, executionId) {
+        await this.txRunner.run({}, async (ctx) => {
+            if (!(await this.threads.lockById(threadId, ctx)))
+                return;
+            await this.release(threadId, executionId, ctx);
+        });
+        this.updates.notifyQueueUpdated(threadId);
+    }
+    async release(threadId, executionId, ctx) {
+        await this.executions.closeSteering(threadId, executionId, ctx);
+        return await this.queue.releaseSteering(threadId, executionId, ctx);
+    }
+    async releaseInactive(thread, ctx) {
+        const ids = await this.queue.findSteeringExecutionIds(thread.id, ctx);
+        if (ids.length === 0)
+            return false;
+        const checkpoint = await this.checkpoints.findSuspendedForThread(thread.agentId, thread.id, ctx);
+        const suspendedExecutionId = checkpoint && (0, agent_queued_message_1.checkpointExecutionId)(checkpoint);
+        let changed = false;
+        for (const id of ids) {
+            const execution = await this.executions.findExecution(id, ctx);
+            if (execution?.status === 'running' &&
+                execution.acceptsSteering &&
+                id !== suspendedExecutionId)
+                continue;
+            changed = (await this.release(thread.id, id, ctx)) || changed;
+        }
+        return changed;
+    }
+    async consume(context, boundary, recorder, signal) {
+        signal.throwIfAborted();
+        const result = await this.executionService.withTimelineWritesPaused(context.executionId, async () => {
+            const timeline = structuredClone(recorder.getMessageRecord().timeline);
+            try {
+                const consumed = await this.txRunner.run({}, async (ctx) => await this.consumeLocked(context, boundary, timeline, signal, ctx));
+                recorder.recordInputs(inputMarkers(consumed));
+                return consumed;
+            }
+            catch (error) {
+                await this.restoreCommittedInputs(context.executionId, recorder);
+                throw error;
+            }
+        });
+        if (result.events.length || boundary.completing || !boundary.canContinue || result.stopped) {
+            this.updates.notifyQueueUpdated(context.threadId);
+            this.updates.notify(context);
+        }
+        return result;
+    }
+    async consumeLocked(context, boundary, timeline, signal, ctx) {
+        const { threadId, executionId, userId } = context;
+        const thread = await this.threads.lockById(threadId, ctx);
+        const execution = await this.executions.findExecution(executionId, ctx);
+        signal.throwIfAborted();
+        if (!thread || execution?.threadId !== threadId || execution.status !== 'running') {
+            throw new n8n_workflow_1.OperationalError('Agent execution ownership was lost');
+        }
+        if (!execution.acceptsSteering)
+            return { messages: [], events: [], stopped: true };
+        if (!boundary.canContinue) {
+            await this.release(threadId, executionId, ctx);
+            return { messages: [], events: [], stopped: false };
+        }
+        const items = await this.queue.findSteering(threadId, executionId, ctx);
+        if (items.length === 0) {
+            if (boundary.completing)
+                await this.executions.closeSteering(threadId, executionId, ctx);
+            return { messages: [], events: [], stopped: false };
+        }
+        const resourceId = (0, agent_memory_scope_1.draftChatMemoryResourceId)(userId);
+        const consumed = this.prepareInput(items, executionId, boundary.lastCreatedAt);
+        for (const { messageId } of items) {
+            await this.messages.linkExecutionInput(executionId, messageId, { threadId, resourceId }, ctx);
+        }
+        await this.messages.saveRuntimeMessages({ threadId, resourceId, executionId, messages: [...boundary.messages, ...consumed.messages] }, ctx);
+        signal.throwIfAborted();
+        if (!(await this.executions.updateTimelineIfRunning(executionId, [...timeline, ...inputMarkers(consumed)], ctx))) {
+            throw new n8n_workflow_1.OperationalError('Agent execution ownership was lost');
+        }
+        await this.queue.consumeSteering(threadId, executionId, items.map(({ id }) => id), ctx);
+        return consumed;
+    }
+    prepareInput(items, executionId, lastCreatedAt) {
+        let timestamp = Math.max(Date.now(), lastCreatedAt + 1);
+        const messages = [];
+        const events = [];
+        for (const item of items) {
+            if (item.payload.kind !== 'preview')
+                throw new n8n_workflow_1.UnexpectedError('Only Preview input can be steered');
+            const message = {
+                ...(item.message.modelContent ?? item.message.content),
+                id: item.messageId,
+                createdAt: new Date(timestamp++),
+            };
+            const dto = (0, agent_message_mapper_1.messageToDto)({
+                ...item.message.content,
+                id: item.messageId,
+                createdAt: item.message.createdAt,
+            });
+            if (dto?.role !== 'user')
+                throw new n8n_workflow_1.UnexpectedError('Steering input must be a user message');
+            messages.push(message);
+            events.push({
+                type: 'message-steered',
+                queueId: item.id,
+                executionId,
+                message: {
+                    ...dto,
+                    executionId,
+                    ...(item.message.author ? { author: item.message.author } : {}),
+                },
+            });
+        }
+        return { messages, events, stopped: false };
+    }
+    async restoreCommittedInputs(executionId, recorder) {
+        try {
+            const execution = await this.executions.findExecution(executionId);
+            recorder.recordInputs((execution?.timeline ?? []).filter((event) => event.type === 'input'));
+        }
+        catch {
+        }
+    }
+};
+exports.AgentMessageSteeringService = AgentMessageSteeringService;
+exports.AgentMessageSteeringService = AgentMessageSteeringService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [db_1.TransactionRunner, agent_message_queue_repository_1.AgentMessageQueueRepository, agent_execution_thread_repository_1.AgentExecutionThreadRepository, agent_execution_repository_1.AgentExecutionRepository, agent_message_repository_1.AgentMessageRepository, n8n_checkpoint_storage_1.N8NCheckpointStorage, agent_execution_service_1.AgentExecutionService, agent_execution_update_broadcaster_1.AgentExecutionUpdateBroadcaster])
+], AgentMessageSteeringService);
+function inputMarkers(consumed) {
+    return consumed.messages.map((message) => ({
+        type: 'input',
+        messageId: message.id,
+        timestamp: message.createdAt.getTime(),
+    }));
+}
+//# sourceMappingURL=agent-message-steering.service.js.map

package/dist/modules/agents/agent-message-steering.service.js.map

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

package/dist/modules/agents/agent-modification-telemetry.service.d.ts

@@ -23,6 +23,7 @@ interface AgentModificationEvent {
 export declare function captureAgentMutation(agent: Agent): {
     schema: {
         name: string;
+        description?: string | undefined;
         model: string;
         credential?: string | undefined;
         modelDeploymentName?: string | undefined;
@@ -74,6 +75,7 @@ export declare function captureAgentMutation(agent: Agent): {
             agents?: {
                 agentId: string;
                 useWhen?: string | undefined;
+                enabled?: boolean | undefined;
             }[] | undefined;
             modelsByDifficulty?: {
                 low?: {
@@ -92,10 +94,12 @@ export declare function captureAgentMutation(agent: Agent): {
         } | 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;
@@ -110,6 +114,7 @@ export declare function captureAgentMutation(agent: Agent): {
             }> | undefined;
         } | {
             type: "node";
+            enabled?: boolean | undefined;
             name: string;
             description?: string | undefined;
             inputSchema?: undefined;
@@ -130,6 +135,7 @@ export declare function captureAgentMutation(agent: Agent): {
         })[] | undefined;
         skills?: {
             type: "skill";
+            enabled?: boolean | undefined;
             id: string;
         }[] | undefined;
         tasks?: {
@@ -294,6 +300,14 @@ export declare function captureAgentMutation(agent: Agent): {
             } | undefined;
             toolCallConcurrency?: number | undefined;
             maxIterations?: number | undefined;
+            guardrails?: {
+                budget?: {
+                    enabled: boolean;
+                    monthlyBudgetUsd?: number | undefined;
+                    alertThresholdPercent?: number | undefined;
+                    sessionCostCapUsd?: number | undefined;
+                } | undefined;
+            } | undefined;
         } | undefined;
     } | null;
     integrations: ({

package/dist/modules/agents/agent-plan.service.d.ts

@@ -0,0 +1,260 @@
+import type { OperationContext } from '@n8n/db';
+import { type AgentPlanDocument } from './plans/agent-plan.schema';
+import { type AgentPlanReadiness } from './plans/agent-plan.validation';
+import { AgentPlanRepository, type AgentPlanRecord, type AgentPlanRevision } from './repositories/agent-plan.repository';
+type PlanDocumentInput = {
+    data: unknown;
+    formatVersion: number;
+};
+type PlanWrite = {
+    threadId: string;
+    planId: string;
+    expectedRevision: number;
+};
+export type AgentPlanSnapshot = Omit<AgentPlanRecord, 'data'> & {
+    data: AgentPlanDocument;
+    readiness: AgentPlanReadiness;
+};
+export declare class AgentPlanService {
+    private readonly repository;
+    constructor(repository: AgentPlanRepository);
+    createActivePlan(input: PlanDocumentInput & {
+        id: string;
+        threadId: string;
+    }, ctx: OperationContext): Promise<AgentPlanRecord & {
+        data: {
+            title: string;
+            description: string;
+            presentation?: {
+                label: string;
+                detail?: string | undefined;
+            } | undefined;
+            items: ({
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "task";
+                fallbackFor?: string | undefined;
+            } | {
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "group";
+                tasks: {
+                    id: string;
+                    title: string;
+                    description: string;
+                    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                    dependsOn: string[];
+                    resultSummary?: string | undefined;
+                    startedAt: string | null;
+                    endedAt: string | null;
+                    kind: "task";
+                    fallbackFor?: string | undefined;
+                }[];
+            })[];
+        };
+        readiness: AgentPlanReadiness;
+    }>;
+    findActivePlan(threadId: string, ctx: OperationContext): Promise<AgentPlanSnapshot | null>;
+    findPlan(threadId: string, planId: string, ctx: OperationContext): Promise<(AgentPlanRecord & {
+        data: {
+            title: string;
+            description: string;
+            presentation?: {
+                label: string;
+                detail?: string | undefined;
+            } | undefined;
+            items: ({
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "task";
+                fallbackFor?: string | undefined;
+            } | {
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "group";
+                tasks: {
+                    id: string;
+                    title: string;
+                    description: string;
+                    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                    dependsOn: string[];
+                    resultSummary?: string | undefined;
+                    startedAt: string | null;
+                    endedAt: string | null;
+                    kind: "task";
+                    fallbackFor?: string | undefined;
+                }[];
+            })[];
+        };
+        readiness: AgentPlanReadiness;
+    }) | null>;
+    findRevision(threadId: string, planId: string, revision: number, ctx: OperationContext): Promise<(AgentPlanRevision & {
+        data: {
+            title: string;
+            description: string;
+            presentation?: {
+                label: string;
+                detail?: string | undefined;
+            } | undefined;
+            items: ({
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "task";
+                fallbackFor?: string | undefined;
+            } | {
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "group";
+                tasks: {
+                    id: string;
+                    title: string;
+                    description: string;
+                    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                    dependsOn: string[];
+                    resultSummary?: string | undefined;
+                    startedAt: string | null;
+                    endedAt: string | null;
+                    kind: "task";
+                    fallbackFor?: string | undefined;
+                }[];
+            })[];
+        };
+        readiness: AgentPlanReadiness;
+    }) | null>;
+    listHistory(threadId: string, planId: string, options: {
+        afterRevision?: number;
+        limit?: number;
+    }, ctx: OperationContext): Promise<{
+        items: import("./repositories/agent-plan.repository").AgentPlanRevisionMetadata[];
+        nextCursor: number | null;
+    }>;
+    replacePlan(input: PlanWrite & PlanDocumentInput, ctx: OperationContext): Promise<AgentPlanRecord & {
+        data: {
+            title: string;
+            description: string;
+            presentation?: {
+                label: string;
+                detail?: string | undefined;
+            } | undefined;
+            items: ({
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "task";
+                fallbackFor?: string | undefined;
+            } | {
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "group";
+                tasks: {
+                    id: string;
+                    title: string;
+                    description: string;
+                    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                    dependsOn: string[];
+                    resultSummary?: string | undefined;
+                    startedAt: string | null;
+                    endedAt: string | null;
+                    kind: "task";
+                    fallbackFor?: string | undefined;
+                }[];
+            })[];
+        };
+        readiness: AgentPlanReadiness;
+    }>;
+    closePlan(input: PlanWrite, ctx: OperationContext): Promise<AgentPlanRecord & {
+        data: {
+            title: string;
+            description: string;
+            presentation?: {
+                label: string;
+                detail?: string | undefined;
+            } | undefined;
+            items: ({
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "task";
+                fallbackFor?: string | undefined;
+            } | {
+                id: string;
+                title: string;
+                description: string;
+                status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                dependsOn: string[];
+                resultSummary?: string | undefined;
+                startedAt: string | null;
+                endedAt: string | null;
+                kind: "group";
+                tasks: {
+                    id: string;
+                    title: string;
+                    description: string;
+                    status: "cancelled" | "done" | "failed" | "in_progress" | "pending";
+                    dependsOn: string[];
+                    resultSummary?: string | undefined;
+                    startedAt: string | null;
+                    endedAt: string | null;
+                    kind: "task";
+                    fallbackFor?: string | undefined;
+                }[];
+            })[];
+        };
+        readiness: AgentPlanReadiness;
+    }>;
+    private loadForWrite;
+    private decode;
+}
+export {};

package/dist/modules/agents/agent-plan.service.js

@@ -0,0 +1,67 @@
+"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.AgentPlanService = void 0;
+const di_1 = require("@n8n/di");
+const agent_plan_schema_1 = require("./plans/agent-plan.schema");
+const agent_plan_validation_1 = require("./plans/agent-plan.validation");
+const agent_plan_repository_1 = require("./repositories/agent-plan.repository");
+let AgentPlanService = class AgentPlanService {
+    constructor(repository) {
+        this.repository = repository;
+    }
+    async createActivePlan(input, ctx) {
+        const data = (0, agent_plan_validation_1.prepareAgentPlan)(input.data, input.formatVersion, null, new Date());
+        return this.decode(await this.repository.createActivePlan({ ...input, data }, ctx));
+    }
+    async findActivePlan(threadId, ctx) {
+        const plan = await this.repository.findActivePlan(threadId, ctx);
+        return plan ? this.decode(plan) : null;
+    }
+    async findPlan(threadId, planId, ctx) {
+        const plan = await this.repository.findPlan(threadId, planId, ctx);
+        return plan ? this.decode(plan) : null;
+    }
+    async findRevision(threadId, planId, revision, ctx) {
+        const plan = await this.repository.findRevision(threadId, planId, revision, ctx);
+        return plan ? this.decode(plan) : null;
+    }
+    async listHistory(threadId, planId, options, ctx) {
+        return await this.repository.listHistory(threadId, planId, options, ctx);
+    }
+    async replacePlan(input, ctx) {
+        const current = await this.loadForWrite(input, ctx);
+        const data = (0, agent_plan_validation_1.prepareAgentPlan)(input.data, input.formatVersion, current.data, new Date());
+        return this.decode(await this.repository.replacePlan({ ...input, data }, ctx));
+    }
+    async closePlan(input, ctx) {
+        await this.loadForWrite(input, ctx);
+        return this.decode(await this.repository.closePlan(input, ctx));
+    }
+    async loadForWrite(input, ctx) {
+        const current = await this.repository.findPlan(input.threadId, input.planId, ctx);
+        if (!current || current.closedAt !== null || current.revision !== input.expectedRevision) {
+            throw new agent_plan_repository_1.AgentPlanWriteConflictError();
+        }
+        return this.decode(current);
+    }
+    decode(record) {
+        const data = (0, agent_plan_schema_1.parseAgentPlan)(record.data, record.formatVersion);
+        const readiness = (0, agent_plan_validation_1.getAgentPlanReadiness)(data);
+        return { ...record, data, readiness: record.closedAt ? { ready: [], blocked: [] } : readiness };
+    }
+};
+exports.AgentPlanService = AgentPlanService;
+exports.AgentPlanService = AgentPlanService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [agent_plan_repository_1.AgentPlanRepository])
+], AgentPlanService);
+//# sourceMappingURL=agent-plan.service.js.map

package/dist/modules/agents/agent-plan.service.js.map

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

package/dist/modules/agents/agent-publish.service.d.ts

@@ -1,8 +1,8 @@
 import { type AgentConfigValidationResponse, type AgentVersionListItemDto } from '@n8n/api-types';
 import { Logger } from '@n8n/backend-common';
+import { EventService } from '@n8n/backend-services';
 import { type User } from '@n8n/db';
 import { CredentialsService } from '../../credentials/credentials.service';
-import { EventService } from '../../events/event.service';
 import { Telemetry } from '../../telemetry';
 import { AgentCustomToolsService } from './agent-custom-tools.service';
 import { AgentModificationTelemetryService, type AgentActor } from './agent-modification-telemetry.service';