n8n 2.20.6 → 2.21.0

package/dist/modules/agents/agents-tools.service.js

@@ -0,0 +1,193 @@
+"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.AgentsToolsService = exports.isAgentToolNodeType = exports.isExecutableNodeType = void 0;
+const agents_1 = require("@n8n/agents");
+const backend_common_1 = require("@n8n/backend-common");
+const di_1 = require("@n8n/di");
+const workflow_sdk_1 = require("@n8n/workflow-sdk");
+const n8n_workflow_1 = require("n8n-workflow");
+const zod_1 = require("zod");
+const node_execution_1 = require("../../node-execution");
+const node_catalog_1 = require("../../node-catalog");
+const isExecutableNodeType = (nodeId) => !(0, n8n_workflow_1.isTriggerNodeType)(nodeId);
+exports.isExecutableNodeType = isExecutableNodeType;
+const isAgentToolNodeType = (nodeId) => (0, exports.isExecutableNodeType)(nodeId) &&
+    ((0, n8n_workflow_1.isToolType)(nodeId, { includeHitl: false }) || (0, node_execution_1.isAgentProviderNode)(nodeId));
+exports.isAgentToolNodeType = isAgentToolNodeType;
+const searchNodesInputSchema = zod_1.z.object({
+    queries: zod_1.z.array(zod_1.z.string()).min(1).describe('Search queries (e.g., ["gmail", "slack", "http"])'),
+});
+const nodeVersionSchema = zod_1.z.number().describe('Tool node type version from search_nodes');
+const getNodeTypesInputSchema = zod_1.z.object({
+    nodeIds: zod_1.z
+        .array(zod_1.z.union([
+        zod_1.z.string(),
+        zod_1.z.object({
+            nodeId: zod_1.z.string(),
+            version: nodeVersionSchema.optional(),
+            resource: zod_1.z.string().optional(),
+            operation: zod_1.z.string().optional(),
+            mode: zod_1.z.string().optional(),
+        }),
+    ]))
+        .min(1)
+        .describe('Tool node IDs from search_nodes (e.g., ["n8n-nodes-base.gmailTool"])'),
+});
+const listCredentialsInputSchema = zod_1.z.object({
+    types: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('Optional credential types to filter by (e.g., ["gmailOAuth2", "httpHeaderAuth"]). ' +
+        'When omitted, returns all credentials. Use the credential types declared in the ' +
+        'node schema from get_node_types to narrow the results.'),
+});
+const runNodeInputSchema = zod_1.z.object({
+    nodeType: zod_1.z.string().describe('Tool node type identifier from search_nodes'),
+    nodeTypeVersion: nodeVersionSchema,
+    nodeParameters: zod_1.z
+        .record(zod_1.z.unknown())
+        .optional()
+        .describe('Static node config. Use expressions like ={{ $json.url }} to reference inputData fields.'),
+    credentials: zod_1.z
+        .record(zod_1.z.object({ id: zod_1.z.string(), name: zod_1.z.string() }))
+        .optional()
+        .describe('Credential slot → { id, name }. Copy from list_credentials results.'),
+    inputData: zod_1.z
+        .record(zod_1.z.unknown())
+        .optional()
+        .describe('Runtime input, available as $json inside nodeParameters expressions.'),
+});
+let AgentsToolsService = class AgentsToolsService {
+    constructor(logger, nodeCatalogService, ephemeralNodeExecutor) {
+        this.logger = logger;
+        this.nodeCatalogService = nodeCatalogService;
+        this.ephemeralNodeExecutor = ephemeralNodeExecutor;
+    }
+    getSharedTools(credentialProvider, listCredentialsUsageHint) {
+        return [
+            this.buildSearchNodesTool(),
+            this.buildGetNodeTypesTool(),
+            this.buildListCredentialsTool(credentialProvider, listCredentialsUsageHint),
+        ];
+    }
+    getRuntimeTools(credentialProvider, projectId) {
+        return [
+            ...this.getSharedTools(credentialProvider, 'Call this before run_node_tool to know which credential to pass.'),
+            this.buildRunNodeTool(projectId),
+        ];
+    }
+    buildSearchNodesTool() {
+        return new agents_1.Tool('search_nodes')
+            .description('Search for n8n nodes by name or service. Use this to find nodes that can be executed. ' +
+            'Returns tool node IDs, display names, versions, and descriptions. ' +
+            'After finding a node, call get_node_types to get its parameter schema.')
+            .input(searchNodesInputSchema)
+            .handler(async ({ queries }) => {
+            const { results } = await this.nodeCatalogService.searchNodes(queries, {
+                nodeFilter: exports.isAgentToolNodeType,
+            });
+            return { results };
+        })
+            .build();
+    }
+    buildGetNodeTypesTool() {
+        return new agents_1.Tool('get_node_types')
+            .description('Get detailed parameter schema for specific n8n nodes. Use the node IDs returned ' +
+            'by search_nodes. Returns parameter definitions needed to configure a node for execution. ' +
+            'Use the tool node IDs from search_nodes. ' +
+            'You can optionally filter by resource/operation/mode.')
+            .input(getNodeTypesInputSchema)
+            .handler(async ({ nodeIds }) => {
+            const results = await this.nodeCatalogService.getNodeTypes(nodeIds.map(normalizeNodeRequestForCatalog));
+            return { results };
+        })
+            .build();
+    }
+    buildListCredentialsTool(credentialProvider, usageHint) {
+        return new agents_1.Tool('list_credentials')
+            .description('List the credentials available to the user. Returns an array of credential names and types. ' +
+            'Accepts an optional `types` filter to return only credentials matching the given types. ' +
+            usageHint)
+            .input(listCredentialsInputSchema)
+            .handler(async ({ types }) => {
+            const creds = await credentialProvider.list();
+            if (!types || types.length === 0)
+                return { credentials: creds };
+            const allowed = new Set(types);
+            return { credentials: creds.filter((c) => allowed.has(c.type)) };
+        })
+            .build();
+    }
+    buildRunNodeTool(projectId) {
+        return new agents_1.Tool('run_node_tool')
+            .description('Execute an n8n node for the current request. ' +
+            'Use the tool nodeType and nodeTypeVersion from search_nodes. ' +
+            'Call get_node_types first to understand what nodeParameters the node accepts. ' +
+            'nodeParameters holds static node config; use n8n expressions like ={{ $json.url }} to map inputData fields. ' +
+            'credentials maps slot names to { id, name } — copy from the list_credentials results. ' +
+            'inputData is the runtime payload available as $json inside expressions. ' +
+            'Parameters are validated against the node schema before execution.')
+            .input(runNodeInputSchema)
+            .handler(async ({ nodeType, nodeTypeVersion, nodeParameters, credentials, inputData }) => {
+            if (!(0, exports.isExecutableNodeType)(nodeType)) {
+                return {
+                    status: 'error',
+                    message: `Node type "${nodeType}" cannot be executed directly — trigger nodes are not supported here.`,
+                };
+            }
+            if (nodeParameters) {
+                const { valid, errors } = (0, workflow_sdk_1.validateNodeConfig)(nodeType, nodeTypeVersion, {
+                    parameters: nodeParameters,
+                }, { isToolNode: true });
+                if (!valid) {
+                    return {
+                        status: 'error',
+                        message: `Invalid nodeParameters: ${errors.map((e) => e.message).join('; ')}`,
+                    };
+                }
+            }
+            try {
+                return await this.ephemeralNodeExecutor.executeInline({
+                    nodeType,
+                    nodeTypeVersion,
+                    nodeParameters: (nodeParameters ?? {}),
+                    credentialDetails: credentials,
+                    inputData: [{ json: (inputData ?? {}) }],
+                    projectId,
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.logger.warn('run_node_tool execution failed', { nodeType, error });
+                return {
+                    status: 'error',
+                    message: `Node execution failed: ${message}`,
+                };
+            }
+        })
+            .build();
+    }
+};
+exports.AgentsToolsService = AgentsToolsService;
+exports.AgentsToolsService = AgentsToolsService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [backend_common_1.Logger,
+        node_catalog_1.NodeCatalogService,
+        node_execution_1.EphemeralNodeExecutor])
+], AgentsToolsService);
+function normalizeNodeRequestForCatalog(req) {
+    if (typeof req === 'string')
+        return req;
+    const { version, ...rest } = req;
+    return version === undefined ? rest : { ...rest, version: String(version) };
+}
+//# sourceMappingURL=agents-tools.service.js.map

package/dist/modules/agents/agents-tools.service.js.map

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

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

@@ -0,0 +1,260 @@
+import { type AgentBuilderMessagesResponse, type AgentIntegrationStatusResponse, type AgentPersistedMessageDto, type AgentSkill, type AgentScheduleConfig, type ChatIntegrationDescriptor, AgentBuildResumeDto, AgentChatMessageDto, CreateAgentSkillDto, AgentIntegrationDto, CreateAgentDto, UpdateAgentSkillDto, UpdateAgentConfigDto, UpdateAgentScheduleDto, UpdateAgentDto } from '@n8n/api-types';
+import { AuthenticatedRequest } from '@n8n/db';
+import type { Request, Response } from 'express';
+import { CredentialsService } from '../../credentials/credentials.service';
+import { AgentExecutionService } from './agent-execution.service';
+import { type FlushableResponse } from './agent-sse-stream';
+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 { AgentRepository } from './repositories/agent.repository';
+export declare class AgentsController {
+    private readonly agentsService;
+    private readonly agentsBuilderService;
+    private readonly credentialsService;
+    private readonly chatIntegrationService;
+    private readonly agentScheduleService;
+    private readonly agentRepository;
+    private readonly agentExecutionService;
+    private readonly chatIntegrationRegistry;
+    constructor(agentsService: AgentsService, agentsBuilderService: AgentsBuilderService, credentialsService: CredentialsService, chatIntegrationService: ChatIntegrationService, agentScheduleService: AgentScheduleService, agentRepository: AgentRepository, agentExecutionService: AgentExecutionService, chatIntegrationRegistry: ChatIntegrationRegistry);
+    create(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, payload: CreateAgentDto): Promise<import("./entities/agent.entity").Agent>;
+    list(req: AuthenticatedRequest<{
+        projectId: string;
+    }, unknown, unknown, {
+        all?: string;
+    }>): Promise<import("./entities/agent.entity").Agent[]>;
+    getConfig(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>): Promise<{
+        name: string;
+        instructions: string;
+        model: string;
+        description?: string | undefined;
+        credential?: string | undefined;
+        memory?: {
+            enabled: boolean;
+            storage: "n8n" | "sqlite" | "postgres";
+            connection?: Record<string, unknown> | undefined;
+            lastMessages?: number | undefined;
+            semanticRecall?: {
+                topK: number;
+                scope?: "resource" | "thread" | undefined;
+                messageRange?: {
+                    before: number;
+                    after: number;
+                } | undefined;
+                embedder?: string | undefined;
+            } | undefined;
+        } | undefined;
+        config?: {
+            thinking?: {
+                provider: "anthropic" | "openai";
+                budgetTokens?: number | undefined;
+                reasoningEffort?: string | undefined;
+            } | undefined;
+            toolCallConcurrency?: number | undefined;
+            nodeTools?: {
+                enabled: boolean;
+            } | undefined;
+        } | undefined;
+        tools?: ({
+            id: string;
+            type: "custom";
+            requireApproval?: boolean | undefined;
+        } | {
+            type: "workflow";
+            workflow: string;
+            description?: string | undefined;
+            name?: string | undefined;
+            requireApproval?: boolean | undefined;
+            allOutputs?: boolean | undefined;
+        } | {
+            name: string;
+            type: "node";
+            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?: {
+            id: string;
+            type: "skill";
+        }[] | undefined;
+        providerTools?: Record<string, Record<string, unknown>> | undefined;
+        integrations?: ({
+            active: boolean;
+            type: "schedule";
+            cronExpression: string;
+            wakeUpPrompt: string;
+        } | {
+            type: string;
+            credentialName: string;
+            credentialId: string;
+        })[] | undefined;
+    }>;
+    putConfig(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>, _res: Response, agentId: string, payload: UpdateAgentConfigDto): Promise<{
+        config: import("./json-config/agent-json-config").AgentJsonConfig;
+        updatedAt: string;
+        versionId: string | null;
+    }>;
+    deleteTool(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+        toolId: string;
+    }>, _res: Response, agentId: string, toolId: string): Promise<{
+        ok: boolean;
+    }>;
+    listSkills(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>): Promise<Record<string, AgentSkill>>;
+    getSkill(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+        skillId: string;
+    }>, _res: Response, agentId: string, skillId: string): Promise<AgentSkill>;
+    createSkill(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>, _res: Response, agentId: string, payload: CreateAgentSkillDto): Promise<import("@n8n/api-types").AgentSkillMutationResponse>;
+    updateSkill(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+        skillId: string;
+    }>, _res: Response, agentId: string, skillId: string, payload: UpdateAgentSkillDto): Promise<import("@n8n/api-types").AgentSkillMutationResponse>;
+    deleteSkill(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+        skillId: string;
+    }>, _res: Response, agentId: string, skillId: string): Promise<{
+        ok: boolean;
+    }>;
+    listCredentials(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>): Promise<import("@n8n/agents").CredentialListItem[]>;
+    getModelCatalog(): Promise<import("@n8n/agents").ProviderCatalog>;
+    listIntegrations(): ChatIntegrationDescriptor[];
+    listThreads(req: AuthenticatedRequest<{
+        projectId: string;
+    }, {}, {}, {
+        cursor?: string;
+        limit?: string;
+        agentId?: string;
+    }>): Promise<{
+        threads: import("./agent-execution.service").ThreadListItem[];
+        nextCursor: string | null;
+    }>;
+    getThread(req: AuthenticatedRequest<{
+        projectId: string;
+        threadId: string;
+    }, {}, {}, {
+        agentId?: string;
+    }>): Promise<import("./agent-execution.service").ThreadDetail>;
+    deleteThread(req: AuthenticatedRequest<{
+        projectId: string;
+        threadId: string;
+    }>): Promise<{
+        success: boolean;
+    }>;
+    get(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<import("./entities/agent.entity").Agent>;
+    update(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string, payload: UpdateAgentDto): Promise<import("./entities/agent.entity").Agent | null>;
+    delete(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<{
+        success: boolean;
+    }>;
+    publish(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<import("./entities/agent.entity").Agent>;
+    unpublish(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<import("./entities/agent.entity").Agent>;
+    revertToPublished(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<import("./entities/agent.entity").Agent>;
+    chat(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, res: FlushableResponse, agentId: string, payload: AgentChatMessageDto): Promise<void>;
+    getChatMessages(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+        threadId: string;
+    }>): Promise<import("@n8n/agents").AgentDbMessage[]>;
+    getBuilderMessages(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>): Promise<AgentBuilderMessagesResponse>;
+    clearBuilderMessages(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>): Promise<{
+        ok: boolean;
+    }>;
+    getTestChatMessages(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>): Promise<AgentPersistedMessageDto[]>;
+    clearTestChatMessages(req: AuthenticatedRequest<{
+        projectId: string;
+        agentId: string;
+    }>): Promise<{
+        ok: boolean;
+    }>;
+    build(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, res: FlushableResponse, agentId: string, payload: AgentChatMessageDto): Promise<void>;
+    buildResume(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, res: FlushableResponse, agentId: string, payload: AgentBuildResumeDto): Promise<void>;
+    connectIntegration(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string, payload: AgentIntegrationDto): Promise<{
+        status: string;
+    }>;
+    disconnectIntegration(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string, payload: AgentIntegrationDto): Promise<{
+        status: string;
+    }>;
+    getScheduleIntegration(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<AgentScheduleConfig>;
+    updateScheduleIntegration(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string, payload: UpdateAgentScheduleDto): Promise<AgentScheduleConfig>;
+    activateScheduleIntegration(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<AgentScheduleConfig>;
+    deactivateScheduleIntegration(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<AgentScheduleConfig>;
+    integrationStatus(req: AuthenticatedRequest<{
+        projectId: string;
+    }>, _res: Response, agentId: string): Promise<AgentIntegrationStatusResponse>;
+    handleWebhook(req: Request<{
+        projectId: string;
+        agentId: string;
+        platform: string;
+    }>, res: Response): Promise<void>;
+}