n8n 2.26.3 → 2.27.0

package/dist/modules/mcp/tools/workflow-builder/create-workflow-from-code.tool.js

@@ -48,6 +48,18 @@ const mcp_constants_1 = require("../../mcp.constants");
 const workflow_validation_utils_1 = require("../workflow-validation.utils");
 const not_found_error_1 = require("../../../../errors/response-errors/not-found.error");
 const workflow_helpers_1 = require("../../../../workflow-helpers");
+const MAX_WORKFLOW_DESCRIPTION_LENGTH = 255;
+function normalizeWorkflowDescription(description) {
+    if (!description)
+        return { description: undefined, truncated: false };
+    if (description.length <= MAX_WORKFLOW_DESCRIPTION_LENGTH) {
+        return { description, truncated: false };
+    }
+    return {
+        description: description.slice(0, MAX_WORKFLOW_DESCRIPTION_LENGTH),
+        truncated: true,
+    };
+}
 const inputSchema = {
     code: zod_1.default
         .string()
@@ -63,9 +75,8 @@ const inputSchema = {
         .describe('Optional workflow name. If not provided, uses the name from the code.'),
     description: zod_1.default
         .string()
-        .max(255)
         .optional()
-        .describe('Short workflow description summarizing what it does (1-2 sentences, max 255 chars).'),
+        .describe('Workflow description. Longer text is shortened to 255 chars before saving.'),
     projectId: zod_1.default
         .string()
         .optional()
@@ -150,13 +161,14 @@ const createCreateWorkflowFromCodeTool = (user, workflowCreationService, workflo
             const strippedCode = stripImportStatements(code);
             const result = await handler.parseAndValidate(strippedCode);
             const workflowJson = result.workflow;
+            const { description: workflowDescription, truncated: descriptionTruncated } = normalizeWorkflowDescription(description);
             const invalidToolSourceResponse = (0, connection_structure_check_1.buildInvalidAiToolSourceErrorResponse)(workflowJson, nodeTypes, (errorMessage) => ({ error: errorMessage }), telemetryPayload, telemetry);
             if (invalidToolSourceResponse)
                 return invalidToolSourceResponse;
             newWorkflow = new db_1.WorkflowEntity();
             Object.assign(newWorkflow, {
                 name: name ?? workflowJson.name ?? 'Untitled Workflow',
-                ...(description ? { description } : {}),
+                ...(workflowDescription ? { description: workflowDescription } : {}),
                 nodes: workflowJson.nodes,
                 connections: workflowJson.connections,
                 settings: { ...workflowJson.settings, executionOrder: 'v1', availableInMCP: true },
@@ -192,6 +204,14 @@ const createCreateWorkflowFromCodeTool = (user, workflowCreationService, workflo
                 },
             };
             telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            const notes = [
+                descriptionTruncated
+                    ? `Workflow description was shortened to ${MAX_WORKFLOW_DESCRIPTION_LENGTH} characters.`
+                    : undefined,
+                skippedHttpNodes.length
+                    ? `HTTP Request nodes (${skippedHttpNodes.join(', ')}) were skipped during credential auto-assignment. Their credentials must be configured manually.`
+                    : undefined,
+            ].filter((note) => note !== undefined);
             const output = {
                 workflowId: savedWorkflow.id,
                 name: savedWorkflow.name,
@@ -203,9 +223,7 @@ const createCreateWorkflowFromCodeTool = (user, workflowCreationService, workflo
                     name: landingProject.name,
                     type: landingProject.type,
                 },
-                note: skippedHttpNodes.length
-                    ? `HTTP Request nodes (${skippedHttpNodes.join(', ')}) were skipped during credential auto-assignment. Their credentials must be configured manually.`
-                    : undefined,
+                note: notes.length ? notes.join(' ') : undefined,
             };
             return {
                 content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],

package/dist/modules/mcp/tools/workflow-builder/create-workflow-from-code.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-workflow-from-code.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/create-workflow-from-code.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-workflow-from-code.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/create-workflow-from-code.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/mcp/tools/workflow-builder/explore-node-resources.tool.d.ts

@@ -0,0 +1,18 @@
+import type { User } from '@n8n/db';
+import z from 'zod';
+import type { ToolDefinition } from '../../mcp.types';
+import type { NodeResourceExplorerService } from '../../../../services/node-resource-explorer.service';
+import type { Telemetry } from '../../../../telemetry';
+declare const inputSchema: {
+    nodeType: z.ZodString;
+    version: z.ZodNumber;
+    methodName: z.ZodString;
+    methodType: z.ZodEnum<["listSearch", "loadOptions"]>;
+    credentialType: z.ZodString;
+    credentialId: z.ZodString;
+    filter: z.ZodOptional<z.ZodString>;
+    paginationToken: z.ZodOptional<z.ZodString>;
+    currentNodeParameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+};
+export declare const createExploreNodeResourcesTool: (user: User, nodeResourceExplorerService: NodeResourceExplorerService, telemetry: Telemetry) => ToolDefinition<typeof inputSchema>;
+export {};

package/dist/modules/mcp/tools/workflow-builder/explore-node-resources.tool.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExploreNodeResourcesTool = void 0;
+const zod_1 = __importDefault(require("zod"));
+const constants_1 = require("./constants");
+const mcp_constants_1 = require("../../mcp.constants");
+const inputSchema = {
+    nodeType: zod_1.default
+        .string()
+        .describe('Fully-qualified node type ID from search_nodes / get_node_types, e.g. "n8n-nodes-base.slack".'),
+    version: zod_1.default
+        .number()
+        .describe('Node version, e.g. 4.7. Must match a version returned by search_nodes.'),
+    methodName: zod_1.default
+        .string()
+        .describe("The exact method name from the node's `@searchListMethod` or `@loadOptionsMethod` annotation in the type definition. " +
+        'Call get_node_types first to read the real method name. Do not invent or guess.'),
+    methodType: zod_1.default
+        .enum(['listSearch', 'loadOptions'])
+        .describe('"listSearch" for `@searchListMethod` annotations (supports filter/pagination); ' +
+        '"loadOptions" for `@loadOptionsMethod` annotations.'),
+    credentialType: zod_1.default
+        .string()
+        .describe('Credential type key for the node, e.g. "slackApi" or "googleSheetsOAuth2Api".'),
+    credentialId: zod_1.default
+        .string()
+        .describe('ID of a credential the user can access, obtained from list_credentials.'),
+    filter: zod_1.default.string().optional().describe('Optional search/filter text to narrow results.'),
+    paginationToken: zod_1.default
+        .string()
+        .optional()
+        .describe('Pagination token from a previous call to fetch the next page (listSearch only).'),
+    currentNodeParameters: zod_1.default
+        .record(zod_1.default.unknown())
+        .optional()
+        .describe('Current node parameters for dependent lookups. Some methods require prior selections — ' +
+        'e.g. listing sheets within a spreadsheet needs `{ documentId: { __rl: true, mode: "id", value: "<spreadsheetId>" } }`. ' +
+        "Check the type definition's displayOptions to know which parameters a method depends on."),
+};
+const outputSchema = {
+    results: zod_1.default
+        .array(zod_1.default.object({
+        name: zod_1.default.string(),
+        value: zod_1.default.union([zod_1.default.string(), zod_1.default.number(), zod_1.default.boolean()]),
+        url: zod_1.default.string().optional(),
+        description: zod_1.default.string().optional(),
+    }))
+        .describe('Resources returned by the node method. `value` is the id to use in workflow code.'),
+    paginationToken: zod_1.default
+        .string()
+        .optional()
+        .describe('Pass back as `paginationToken` to fetch the next page. Absent if no more results.'),
+    builderHint: zod_1.default
+        .string()
+        .optional()
+        .describe("Selection guidance from the node's @builderHint annotation, when present."),
+};
+const createExploreNodeResourcesTool = (user, nodeResourceExplorerService, telemetry) => ({
+    name: constants_1.MCP_EXPLORE_NODE_RESOURCES_TOOL.toolName,
+    config: {
+        description: "Resolve the real values behind a node's resource locator or load-options dropdown (e.g. Slack channels, Google Sheets tabs, OpenAI models). " +
+            'Use this after get_node_types so you ground RLC and load-options parameters in real IDs instead of inventing them. ' +
+            'Requires a credential ID from list_credentials — the call runs as the current user with that credential.',
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: constants_1.MCP_EXPLORE_NODE_RESOURCES_TOOL.displayTitle,
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    handler: async (params) => {
+        const telemetryPayload = {
+            user_id: user.id,
+            tool_name: constants_1.MCP_EXPLORE_NODE_RESOURCES_TOOL.toolName,
+            parameters: {
+                nodeType: params.nodeType,
+                version: params.version,
+                methodName: params.methodName,
+                methodType: params.methodType,
+                credentialType: params.credentialType,
+                hasFilter: params.filter !== undefined,
+                hasPaginationToken: params.paginationToken !== undefined,
+                hasCurrentNodeParameters: params.currentNodeParameters !== undefined,
+            },
+        };
+        try {
+            const result = await nodeResourceExplorerService.exploreResources(user, params);
+            telemetryPayload.results = {
+                success: true,
+                data: {
+                    resultCount: result.results.length,
+                    hasPaginationToken: result.paginationToken !== undefined,
+                    hasBuilderHint: result.builderHint !== undefined,
+                },
+            };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+                structuredContent: { ...result },
+            };
+        }
+        catch (error) {
+            telemetryPayload.results = {
+                success: false,
+                error: error instanceof Error ? error.name : 'UnknownError',
+            };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            throw error;
+        }
+    },
+});
+exports.createExploreNodeResourcesTool = createExploreNodeResourcesTool;
+//# sourceMappingURL=explore-node-resources.tool.js.map

package/dist/modules/mcp/tools/workflow-builder/explore-node-resources.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-node-resources.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/explore-node-resources.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.d.ts

@@ -4,7 +4,7 @@ import type { ToolDefinition } from '../../mcp.types';
 import type { NodeCatalogService } from '../../../../node-catalog';
 import type { Telemetry } from '../../../../telemetry';
 declare const inputSchema: {
-    nodeIds: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    nodeIds: z.ZodArray<z.ZodObject<{
         nodeId: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         resource: z.ZodOptional<z.ZodString>;
@@ -22,7 +22,7 @@ declare const inputSchema: {
         operation?: string | undefined;
         version?: string | undefined;
         mode?: string | undefined;
-    }>]>, "many">;
+    }>, "many">;
 };
 export declare const createGetWorkflowNodeTypesTool: (user: User, nodeCatalogService: NodeCatalogService, telemetry: Telemetry) => ToolDefinition<typeof inputSchema>;
 export {};

package/dist/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.js

@@ -7,7 +7,7 @@ exports.createGetWorkflowNodeTypesTool = void 0;
 const zod_1 = __importDefault(require("zod"));
 const mcp_constants_1 = require("../../mcp.constants");
 const constants_1 = require("./constants");
-const nodeIdWithDiscriminators = zod_1.default.object({
+const nodeRequestSchema = zod_1.default.object({
     nodeId: zod_1.default.string().describe('The node type ID (e.g. "n8n-nodes-base.gmail")'),
     version: zod_1.default.string().optional().describe('Specific version (e.g. "2.1")'),
     resource: zod_1.default.string().optional().describe('Resource discriminator (e.g. "message")'),
@@ -16,9 +16,9 @@ const nodeIdWithDiscriminators = zod_1.default.object({
 });
 const inputSchema = {
     nodeIds: zod_1.default
-        .array(zod_1.default.union([zod_1.default.string(), nodeIdWithDiscriminators]))
+        .array(nodeRequestSchema)
         .min(1)
-        .describe('Node IDs to get type definitions for. Use plain strings for simple nodes, or objects with discriminators from search results.'),
+        .describe('Node type requests to get definitions for. Always pass an array of objects, even for a single node. Include discriminators from search_nodes results when available.'),
 };
 const outputSchema = {
     definitions: zod_1.default.string().describe('TypeScript type definitions for the requested nodes'),
@@ -26,7 +26,7 @@ const outputSchema = {
 const createGetWorkflowNodeTypesTool = (user, nodeCatalogService, telemetry) => ({
     name: constants_1.CODE_BUILDER_GET_NODE_TYPES_TOOL.toolName,
     config: {
-        description: 'Get TypeScript type definitions for n8n nodes. Returns exact parameter names and structures. MUST be called before writing workflow code — guessing parameter names creates invalid workflows. Include discriminators (resource/operation/mode) from search results.',
+        description: 'Get TypeScript type definitions for n8n nodes. Returns exact parameter names and structures. MUST be called before writing workflow code — guessing parameter names creates invalid workflows. Pass nodeIds as an array of objects like { nodeId: "n8n-nodes-base.gmail" }. Include discriminators (resource/operation/mode) from search_nodes results.',
         inputSchema,
         outputSchema,
         annotations: {

package/dist/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-workflow-node-types.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.ts"],"names":[],"mappings":";;;;;;AACA,8CAAoB;AAEpB,uDAAiE;AAMjE,2CAA+D;AAE/D,MAAM,wBAAwB,GAAG,aAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC7E,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACxE,QAAQ,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACnF,SAAS,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAClF,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG;IACnB,OAAO,EAAE,aAAC;SACR,KAAK,CAAC,aAAC,CAAC,KAAK,CAAC,CAAC,aAAC,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,+HAA+H,CAC/H;CACsB,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,WAAW,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;CAC/D,CAAC;AAgBnB,MAAM,8BAA8B,GAAG,CAC7C,IAAU,EACV,kBAAsC,EACtC,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,4CAAgC,CAAC,QAAQ;IAC/C,MAAM,EAAE;QACP,WAAW,EACV,sQAAsQ;QACvQ,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,4CAAgC,CAAC,YAAY;YACpD,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAA8B,EAAE,EAAE;QAC1D,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,4CAAgC,CAAC,QAAQ;YACpD,UAAU,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE;SAC3C,CAAC;QAEF,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAE9D,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACpF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAE9D,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,iBAAiB,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;aAC1C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AA7CU,QAAA,8BAA8B,kCA6CxC"}
+{"version":3,"file":"get-workflow-node-types.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.ts"],"names":[],"mappings":";;;;;;AACA,8CAAoB;AAEpB,uDAAiE;AAMjE,2CAA+D;AAE/D,MAAM,iBAAiB,GAAG,aAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC7E,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACxE,QAAQ,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACnF,SAAS,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAClF,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG;IACnB,OAAO,EAAE,aAAC;SACR,KAAK,CAAC,iBAAiB,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,sKAAsK,CACtK;CACsB,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,WAAW,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;CAC/D,CAAC;AAQnB,MAAM,8BAA8B,GAAG,CAC7C,IAAU,EACV,kBAAsC,EACtC,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,4CAAgC,CAAC,QAAQ;IAC/C,MAAM,EAAE;QACP,WAAW,EACV,yVAAyV;QAC1V,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,4CAAgC,CAAC,YAAY;YACpD,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAA8B,EAAE,EAAE;QAC1D,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,4CAAgC,CAAC,QAAQ;YACpD,UAAU,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE;SAC3C,CAAC;QAEF,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAE9D,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACpF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAE9D,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,iBAAiB,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;aAC1C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AA7CU,QAAA,8BAA8B,kCA6CxC"}

package/dist/modules/mcp/tools/workflow-builder/mcp-instructions.js

@@ -16,17 +16,19 @@ To build n8n workflows, follow these steps in order:
 
 4. Get type definitions: Call ${constants_1.CODE_BUILDER_GET_NODE_TYPES_TOOL.toolName} with ALL node IDs you plan to use, including discriminators from search results. This returns the exact TypeScript parameter definitions. DO NOT skip this — guessing parameter names creates invalid workflows.
 
-5. Write the workflow code using the SDK patterns from the reference and the exact parameter names from the type definitions. Follow the coding guidelines and design guidance sections of the SDK reference (retrieve them with ${constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName} using sections "guidelines" and "design").
+5. Ground resource locator and load-options values: For any parameter whose type definition shows a \`@searchListMethod\` or \`@loadOptionsMethod\` annotation (e.g. Slack channel pickers, Google Sheets tabs, OpenAI model lists), call ${constants_1.MCP_EXPLORE_NODE_RESOURCES_TOOL.toolName} with the method name, methodType, and a credentialId from list_credentials. Use a real returned \`value\` in your workflow code instead of inventing IDs.
 
-6. Spot-check as you go: after configuring each node, call ${constants_1.CODE_BUILDER_VALIDATE_NODE_TOOL.toolName} on it before wiring it into the rest of the workflow. Catches param, type, and discriminator errors per-node with a clean signal, before they're buried inside a full-graph ${constants_1.CODE_BUILDER_VALIDATE_TOOL.toolName} run. Can check several candidate configs in one call so you wire only the one that passes.
+6. Write the workflow code using the SDK patterns from the reference and the exact parameter names from the type definitions. Follow the coding guidelines and design guidance sections of the SDK reference (retrieve them with ${constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName} using sections "guidelines" and "design").
 
-7. Validate: Call ${constants_1.CODE_BUILDER_VALIDATE_TOOL.toolName} with your full code. Fix any errors and re-validate until valid.
+7. Spot-check as you go: after configuring each node, call ${constants_1.CODE_BUILDER_VALIDATE_NODE_TOOL.toolName} on it before wiring it into the rest of the workflow. Catches param, type, and discriminator errors per-node with a clean signal, before they're buried inside a full-graph ${constants_1.CODE_BUILDER_VALIDATE_TOOL.toolName} run. Can check several candidate configs in one call so you wire only the one that passes.
 
-8. Create: Call ${constants_1.MCP_CREATE_WORKFLOW_FROM_CODE_TOOL.toolName} with the validated code to save the workflow to n8n. Include a short \`description\` (1-2 sentences) summarizing what the workflow does — this helps users find and understand their workflows.
+8. Validate: Call ${constants_1.CODE_BUILDER_VALIDATE_TOOL.toolName} with your full code. Fix any errors and re-validate until valid.
 
-9. Update: Call ${constants_1.MCP_UPDATE_WORKFLOW_TOOL.toolName} with the workflow ID and a list of operations (addNode, removeNode, updateNodeParameters, setNodeParameter, renameNode, addConnection, removeConnection, setNodeCredential, setNodePosition, setNodeDisabled, setNodeSettings, setWorkflowMetadata). The whole batch is atomic: if any op fails the workflow is unchanged. To modify an existing node's configuration, use updateNodeParameters or setNodeParameter — do NOT use removeNode followed by addNode for the same node, as this disconnects any attached sub-nodes (LLM models, memory, tools) and they will not be re-attached automatically. Use setNodeSettings to change a node's execution behavior (onError, retryOnFail, maxTries, waitBetweenTries, alwaysOutputData, executeOnce); for sub-nodes (LLM model, memory, tools) this is the only way to set onError, because the canvas UI does not expose that setting for them.
+9. Create: Call ${constants_1.MCP_CREATE_WORKFLOW_FROM_CODE_TOOL.toolName} with the validated code to save the workflow to n8n. Include a short \`description\` (1-2 sentences, max 255 chars) summarizing what the workflow does — this helps users find and understand their workflows.
 
-10. Archive: Call ${constants_1.MCP_ARCHIVE_WORKFLOW_TOOL.toolName} with the workflow ID.`;
+10. Update: Call ${constants_1.MCP_UPDATE_WORKFLOW_TOOL.toolName} with the workflow ID and a list of operations (addNode, removeNode, updateNodeParameters, setNodeParameter, renameNode, addConnection, removeConnection, setNodeCredential, setNodePosition, setNodeDisabled, setNodeSettings, setWorkflowMetadata). The whole batch is atomic: if any op fails the workflow is unchanged. To modify an existing node's configuration, use updateNodeParameters or setNodeParameter — do NOT use removeNode followed by addNode for the same node, as this disconnects any attached sub-nodes (LLM models, memory, tools) and they will not be re-attached automatically. Use setNodeSettings to change a node's execution behavior (onError, retryOnFail, maxTries, waitBetweenTries, alwaysOutputData, executeOnce); for sub-nodes (LLM model, memory, tools) this is the only way to set onError, because the canvas UI does not expose that setting for them.
+
+11. Archive: Call ${constants_1.MCP_ARCHIVE_WORKFLOW_TOOL.toolName} with the workflow ID.`;
     return isBuilderEnabled ? `${INTRO}\n\n${BUILDER_INSTRUCTIONS}` : INTRO;
 }
 //# sourceMappingURL=mcp-instructions.js.map

package/dist/modules/mcp/tools/workflow-builder/mcp-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-instructions.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/mcp-instructions.ts"],"names":[],"mappings":";;AAoBA,gDA4BC;AAxCD,2CAUqB;AAErB,SAAgB,kBAAkB,CAAC,gBAAyB;IAC3D,MAAM,KAAK,GAAG,0EAA0E,CAAC;IAEzF,MAAM,oBAAoB,GAAG;;;;2CAIa,sCAA0B,CAAC,QAAQ;;gDAE9B,gDAAoC,CAAC,QAAQ;;0BAEnE,0CAA8B,CAAC,QAAQ;;gCAEjC,4CAAgC,CAAC,QAAQ;;mOAE0J,sCAA0B,CAAC,QAAQ;;6DAEzM,2CAA+B,CAAC,QAAQ,gLAAgL,sCAA0B,CAAC,QAAQ;;oBAEpS,sCAA0B,CAAC,QAAQ;;kBAErC,8CAAkC,CAAC,QAAQ;;kBAE3C,oCAAwB,CAAC,QAAQ;;oBAE/B,qCAAyB,CAAC,QAAQ,wBAAwB,CAAC;IAE9E,OAAO,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,oBAAoB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACzE,CAAC"}
+{"version":3,"file":"mcp-instructions.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/mcp-instructions.ts"],"names":[],"mappings":";;AAqBA,gDA8BC;AA3CD,2CAWqB;AAErB,SAAgB,kBAAkB,CAAC,gBAAyB;IAC3D,MAAM,KAAK,GAAG,0EAA0E,CAAC;IAEzF,MAAM,oBAAoB,GAAG;;;;2CAIa,sCAA0B,CAAC,QAAQ;;gDAE9B,gDAAoC,CAAC,QAAQ;;0BAEnE,0CAA8B,CAAC,QAAQ;;gCAEjC,4CAAgC,CAAC,QAAQ;;4OAEmK,2CAA+B,CAAC,QAAQ;;mOAEjD,sCAA0B,CAAC,QAAQ;;6DAEzM,2CAA+B,CAAC,QAAQ,gLAAgL,sCAA0B,CAAC,QAAQ;;oBAEpS,sCAA0B,CAAC,QAAQ;;kBAErC,8CAAkC,CAAC,QAAQ;;mBAE1C,oCAAwB,CAAC,QAAQ;;oBAEhC,qCAAyB,CAAC,QAAQ,wBAAwB,CAAC;IAE9E,OAAO,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,oBAAoB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACzE,CAAC"}

package/dist/modules/mcp/tools/workflow-builder/search-workflow-nodes.tool.js

@@ -21,7 +21,7 @@ const outputSchema = {
 const createSearchWorkflowNodesTool = (user, nodeCatalogService, telemetry) => ({
     name: constants_1.CODE_BUILDER_SEARCH_NODES_TOOL.toolName,
     config: {
-        description: 'Search for n8n nodes by service name, trigger type, or utility function. Returns node IDs, discriminators (resource/operation/mode), and related nodes needed for get_workflow_node_types.',
+        description: 'Search for n8n nodes by service name, trigger type, or utility function. Returns node IDs, discriminators (resource/operation/mode), and related nodes needed for get_node_types.',
         inputSchema,
         outputSchema,
         annotations: {

package/dist/modules/mcp/tools/workflow-builder/search-workflow-nodes.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-workflow-nodes.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/search-workflow-nodes.tool.ts"],"names":[],"mappings":";;;;;;AACA,8CAAoB;AAEpB,uDAAiE;AAMjE,2CAA6D;AAE7D,MAAM,WAAW,GAAG;IACnB,OAAO,EAAE,aAAC;SACR,KAAK,CAAC,aAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,gLAAgL,CAChL;CACsB,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,OAAO,EAAE,aAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,0EAA0E,CAAC;CAC9D,CAAC;AAMnB,MAAM,6BAA6B,GAAG,CAC5C,IAAU,EACV,kBAAsC,EACtC,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,0CAA8B,CAAC,QAAQ;IAC7C,MAAM,EAAE;QACP,WAAW,EACV,4LAA4L;QAC7L,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,0CAA8B,CAAC,YAAY;YAClD,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAyB,EAAE,EAAE;QACrD,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,0CAA8B,CAAC,QAAQ;YAClD,UAAU,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC;QAEF,IAAI,CAAC;YACJ,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAExF,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACL,UAAU,EAAE,OAAO,CAAC,MAAM;oBAC1B,kBAAkB,EAAE,oBAAoB,CAAC,MAAM;oBAC/C,oBAAoB;iBACpB;aACD,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAE9D,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,iBAAiB,EAAE,EAAE,OAAO,EAAE;aAC9B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AApDU,QAAA,6BAA6B,iCAoDvC"}
+{"version":3,"file":"search-workflow-nodes.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/search-workflow-nodes.tool.ts"],"names":[],"mappings":";;;;;;AACA,8CAAoB;AAEpB,uDAAiE;AAMjE,2CAA6D;AAE7D,MAAM,WAAW,GAAG;IACnB,OAAO,EAAE,aAAC;SACR,KAAK,CAAC,aAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,gLAAgL,CAChL;CACsB,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,OAAO,EAAE,aAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,0EAA0E,CAAC;CAC9D,CAAC;AAMnB,MAAM,6BAA6B,GAAG,CAC5C,IAAU,EACV,kBAAsC,EACtC,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,0CAA8B,CAAC,QAAQ;IAC7C,MAAM,EAAE;QACP,WAAW,EACV,mLAAmL;QACpL,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,0CAA8B,CAAC,YAAY;YAClD,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAyB,EAAE,EAAE;QACrD,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,0CAA8B,CAAC,QAAQ;YAClD,UAAU,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC;QAEF,IAAI,CAAC;YACJ,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAExF,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACL,UAAU,EAAE,OAAO,CAAC,MAAM;oBAC1B,kBAAkB,EAAE,oBAAoB,CAAC,MAAM;oBAC/C,oBAAoB;iBACpB;aACD,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAE9D,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,iBAAiB,EAAE,EAAE,OAAO,EAAE;aAC9B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AApDU,QAAA,6BAA6B,iCAoDvC"}