n8n 2.32.5 → 2.33.0

package/dist/modules/mcp/tools/workflow-builder/get-workflow-best-practices.tool.d.ts

@@ -23,5 +23,7 @@ declare const inputSchema: {
         readonly WEB_APP: 'web_app';
     }>, z.ZodLiteral<"list">]>;
 };
-export declare const createGetWorkflowBestPracticesTool: (user: User, telemetry: Telemetry) => ToolDefinition<typeof inputSchema>;
+export declare const createGetWorkflowBestPracticesTool: (user: User, telemetry: Telemetry, { canvasGroupsEnabled }: {
+    canvasGroupsEnabled: boolean;
+}) => ToolDefinition<typeof inputSchema>;
 export {};

package/dist/modules/mcp/tools/workflow-builder/get-workflow-best-practices.tool.js

@@ -9,6 +9,16 @@ const zod_1 = __importDefault(require("zod"));
 const constants_1 = require("./constants");
 const mcp_constants_1 = require("../../mcp.constants");
 const LIST_SENTINEL = 'list';
+const GROUPING_GUIDANCE = `## Grouping
+
+Organise larger workflows into named node groups — visual frames drawn on the canvas — so the result is readable the first time the user sees it.
+
+- **When to group:** larger workflows that split into clear stages (e.g. ingest → transform → deliver). Give each stage its own group. Small workflows don't need groups — a group there is just noise.
+- **Groups vs sub-workflows:** a group is cosmetic organisation *inside* one workflow; a sub-workflow is a separately-executed, reusable unit. Group to make one canvas readable; extract a sub-workflow to reuse logic or isolate execution.
+- **Naming:** short, outcome-first titles ("Fetch new recordings", not "HTTP + Drive").
+- Groups are created collapsed by default, so the name is what the user sees first — make it descriptive.
+
+Fetch the "groups" section of the SDK reference for the exact rules before creating groups.`;
 const inputSchema = {
     technique: zod_1.default
         .union([zod_1.default.nativeEnum(best_practices_1.WorkflowTechnique), zod_1.default.literal(LIST_SENTINEL)])
@@ -33,7 +43,7 @@ const outputSchema = {
         .optional()
         .describe('All available techniques, returned when "list" was requested.'),
 };
-function buildListResponse() {
+function buildListResponse(canvasGroupsEnabled) {
     const availableTechniques = Object.entries(best_practices_1.TechniqueDescription).map(([key, description]) => ({
         technique: key,
         description,
@@ -45,6 +55,7 @@ function buildListResponse() {
         message,
         '',
         ...availableTechniques.map((t) => `- ${t.technique}${t.hasDocumentation ? '' : ' (no detailed documentation yet)'} — ${t.description}`),
+        ...(canvasGroupsEnabled ? ['', GROUPING_GUIDANCE] : []),
     ].join('\n');
     return {
         text,
@@ -74,7 +85,7 @@ function buildTechniqueResponse(technique) {
     const message = `Technique "${technique}" (${description}) does not have detailed best-practices documentation yet — proceed with general n8n knowledge.`;
     return { text: message, hasDocumentation: false, structured: { technique, message } };
 }
-const createGetWorkflowBestPracticesTool = (user, telemetry) => ({
+const createGetWorkflowBestPracticesTool = (user, telemetry, { canvasGroupsEnabled }) => ({
     name: constants_1.MCP_GET_WORKFLOW_BEST_PRACTICES_TOOL.toolName,
     config: {
         description: 'Required workflow-planning step. Get best-practices guidance (recommended nodes, patterns, and common pitfalls) for a specific workflow technique before searching for nodes or writing code. Call once per relevant technique. Use technique="list" first if unsure which techniques apply.',
@@ -95,7 +106,9 @@ const createGetWorkflowBestPracticesTool = (user, telemetry) => ({
             parameters: { technique },
         };
         try {
-            const response = technique === LIST_SENTINEL ? buildListResponse() : buildTechniqueResponse(technique);
+            const response = technique === LIST_SENTINEL
+                ? buildListResponse(canvasGroupsEnabled)
+                : buildTechniqueResponse(technique);
             telemetryPayload.results = {
                 success: true,
                 data: {

package/dist/modules/mcp/tools/workflow-builder/get-workflow-best-practices.tool.js.map

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

package/dist/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.d.ts

@@ -2,8 +2,11 @@ import type { User } from '@n8n/db';
 import z from 'zod';
 import type { Telemetry } from '../../../../telemetry';
 import type { ToolDefinition } from '../../mcp.types';
-declare const inputSchema: {
+declare const buildInputSchema: (canvasGroupsEnabled: boolean) => {
     section: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
 };
-export declare const createGetWorkflowSdkReferenceTool: (user: User, telemetry: Telemetry) => ToolDefinition<typeof inputSchema>;
+type SdkReferenceInputSchema = ReturnType<typeof buildInputSchema>;
+export declare const createGetWorkflowSdkReferenceTool: (user: User, telemetry: Telemetry, { canvasGroupsEnabled }: {
+    canvasGroupsEnabled: boolean;
+}) => ToolDefinition<SdkReferenceInputSchema>;
 export {};

package/dist/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.js

@@ -8,7 +8,7 @@ const zod_1 = __importDefault(require("zod"));
 const constants_1 = require("./constants");
 const sdk_reference_content_1 = require("./sdk-reference-content");
 const mcp_constants_1 = require("../../mcp.constants");
-const VALID_SECTIONS = [
+const BASE_SECTIONS = [
     'patterns',
     'patterns_detailed',
     'expressions',
@@ -19,20 +19,25 @@ const VALID_SECTIONS = [
     'design',
     'all',
 ];
-const inputSchema = {
-    section: zod_1.default
-        .enum(VALID_SECTIONS)
-        .optional()
-        .describe('Optional section to retrieve. Omit this for the full reference, or use a section for targeted lookup.'),
+const buildInputSchema = (canvasGroupsEnabled) => {
+    const validSections = canvasGroupsEnabled
+        ? [...BASE_SECTIONS, 'groups']
+        : BASE_SECTIONS;
+    return {
+        section: zod_1.default
+            .enum(validSections)
+            .optional()
+            .describe('Optional section to retrieve. Omit this for the full reference, or use a section for targeted lookup.'),
+    };
 };
 const outputSchema = {
     reference: zod_1.default.string().describe('SDK reference documentation content for the requested section'),
 };
-const createGetWorkflowSdkReferenceTool = (user, telemetry) => ({
+const createGetWorkflowSdkReferenceTool = (user, telemetry, { canvasGroupsEnabled }) => ({
     name: constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName,
     config: {
         description: 'Required reference for building n8n Workflow SDK code. Call this BEFORE writing workflow code to learn workflow(), trigger()/node(), .add()/.to(), expr(), and credential patterns.',
-        inputSchema,
+        inputSchema: buildInputSchema(canvasGroupsEnabled),
         outputSchema,
         annotations: {
             title: constants_1.MCP_GET_SDK_REFERENCE_TOOL.displayTitle,
@@ -42,13 +47,15 @@ const createGetWorkflowSdkReferenceTool = (user, telemetry) => ({
             openWorldHint: false,
         },
     },
-    handler: async ({ section }) => {
+    handler: ({ section }) => {
         const telemetryPayload = {
             user_id: user.id,
             tool_name: constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName,
             parameters: { section },
         };
-        const content = (0, sdk_reference_content_1.getSdkReferenceContent)(section);
+        const content = (0, sdk_reference_content_1.getSdkReferenceContent)(section, {
+            includeGroups: canvasGroupsEnabled,
+        });
         telemetryPayload.results = { success: true };
         telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
         return {

package/dist/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-workflow-sdk-reference.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.ts"],"names":[],"mappings":";;;;;;AACA,8CAAoB;AAIpB,2CAAyD;AACzD,mEAA2F;AAC3F,uDAAiE;AAGjE,MAAM,cAAc,GAA0B;IAC7C,UAAU;IACV,mBAAmB;IACnB,aAAa;IACb,WAAW;IACX,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,KAAK;CACL,CAAC;AAEF,MAAM,WAAW,GAAG;IACnB,OAAO,EAAE,aAAC;SACR,IAAI,CAAC,cAAuC,CAAC;SAC7C,QAAQ,EAAE;SACV,QAAQ,CACR,uGAAuG,CACvG;CACsB,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,SAAS,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACvE,CAAC;AAMnB,MAAM,iCAAiC,GAAG,CAChD,IAAU,EACV,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,sCAA0B,CAAC,QAAQ;IACzC,MAAM,EAAE;QACP,WAAW,EACV,qLAAqL;QACtL,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,sCAA0B,CAAC,YAAY;YAC9C,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAwB,EAAE,EAAE;QACpD,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,sCAA0B,CAAC,QAAQ;YAC9C,UAAU,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAA,8CAAsB,EAAC,OAA0C,CAAC,CAAC;QAEnF,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7C,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;QAE9D,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC1C,iBAAiB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;SACzC,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAnCU,QAAA,iCAAiC,GAAjC,iCAAiC,CAmC3C"}
+{"version":3,"file":"get-workflow-sdk-reference.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.ts"],"names":[],"mappings":";;;;;;AACA,8CAAoB;AAIpB,2CAAyD;AACzD,mEAA2F;AAC3F,uDAAiE;AAGjE,MAAM,aAAa,GAA0B;IAC5C,UAAU;IACV,mBAAmB;IACnB,aAAa;IACb,WAAW;IACX,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,KAAK;CACL,CAAC;AAKF,MAAM,gBAAgB,GAAG,CAAC,mBAA4B,EAAE,EAAE;IACzD,MAAM,aAAa,GAA0B,mBAAmB;QAC/D,CAAC,CAAC,CAAC,GAAG,aAAa,EAAE,QAAQ,CAAC;QAC9B,CAAC,CAAC,aAAa,CAAC;IAEjB,OAAO;QACN,OAAO,EAAE,aAAC;aACR,IAAI,CAAC,aAAsC,CAAC;aAC5C,QAAQ,EAAE;aACV,QAAQ,CACR,uGAAuG,CACvG;KACsB,CAAC;AAC3B,CAAC,CAAC;AAIF,MAAM,YAAY,GAAG;IACpB,SAAS,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACvE,CAAC;AAMnB,MAAM,iCAAiC,GAAG,CAChD,IAAU,EACV,SAAoB,EACpB,EAAE,mBAAmB,EAAoC,EACf,EAAE,CAAC,CAAC;IAC9C,IAAI,EAAE,sCAA0B,CAAC,QAAQ;IACzC,MAAM,EAAE;QACP,WAAW,EACV,qLAAqL;QACtL,WAAW,EAAE,gBAAgB,CAAC,mBAAmB,CAAC;QAClD,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,sCAA0B,CAAC,YAAY;YAC9C,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAwB,EAAE,EAAE;QAC9C,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,sCAA0B,CAAC,QAAQ;YAC9C,UAAU,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAA,8CAAsB,EAAC,OAA0C,EAAE;YAClF,aAAa,EAAE,mBAAmB;SAClC,CAAC,CAAC;QAEH,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7C,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;QAE9D,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC1C,iBAAiB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;SACzC,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAtCU,QAAA,iCAAiC,GAAjC,iCAAiC,CAsC3C"}

package/dist/modules/mcp/tools/workflow-builder/mcp-instructions.d.ts

@@ -1 +1,6 @@
-export declare function getMcpInstructions(isBuilderEnabled: boolean, isN8nConnectAvailable?: boolean): string;
+export type McpInstructionsOptions = {
+    isBuilderEnabled: boolean;
+    isN8nConnectAvailable?: boolean;
+    canvasGroupsEnabled?: boolean;
+};
+export declare function getMcpInstructions(options: McpInstructionsOptions): string;

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

@@ -3,8 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMcpInstructions = getMcpInstructions;
 const constants_1 = require("./constants");
 const mcp_constants_1 = require("../../mcp.constants");
-function getMcpInstructions(isBuilderEnabled, isN8nConnectAvailable = false) {
+function getMcpInstructions(options) {
+    const { isBuilderEnabled, isN8nConnectAvailable = false, canvasGroupsEnabled = false } = options;
     const INTRO = 'This is the official MCP server for n8n, a workflow automation platform.';
+    const GROUPS_HINT = canvasGroupsEnabled
+        ? `
+
+Node groups: when a workflow has several distinct stages, organise it into named groups so it is readable on the canvas. Before creating groups, call ${constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName} with section "groups" for the rules, and ${constants_1.MCP_GET_WORKFLOW_BEST_PRACTICES_TOOL.toolName} (technique "list") for when to group.`
+        : '';
     const N8N_CONNECT_HINT = isN8nConnectAvailable
         ? `
 
@@ -36,7 +42,7 @@ To build n8n workflows, follow these steps in order:
 
 11. Archive: Call ${constants_1.MCP_ARCHIVE_WORKFLOW_TOOL.toolName} with the workflow ID.
 
-Error handling has two complementary layers. (1) Per-node: set onError ("continueRegularOutput" / "continueErrorOutput"), retryOnFail, and maxTries via setNodeSettings on ${constants_1.MCP_UPDATE_WORKFLOW_TOOL.toolName}. (2) Failure notifications via an Error Trigger node, which can be wired two ways: (a) Dedicated/shared error workflow — point settings.errorWorkflow (via the setWorkflowSettings operation) at a SEPARATE workflow whose first node is an Error Trigger; this is the common best practice and lets one handler cover many workflows. (b) Same-workflow — add an Error Trigger node (→ a notification node such as Send Email or Slack) INTO this workflow; n8n runs it automatically when the workflow fails, with no settings change needed. Caveats: both fire only for production executions (not manual/test runs), and a configured settings.errorWorkflow takes precedence over a same-workflow Error Trigger for the failing run. When a user asks to "add error handling", "get notified on failure", or "make this reliable", briefly explain both patterns — most users do not know Error Triggers exist — and ask which they prefer before setting one up; do not enable error handling silently. For the shared pattern, reuse an existing handler (find its ID with search_workflows) or create a new one — but a dedicated error workflow must be PUBLISHED before it can be linked, in this order: (1) create it (${constants_1.MCP_CREATE_WORKFLOW_FROM_CODE_TOOL.toolName}, first node = Error Trigger → a notification node), (2) publish it (publish_workflow), (3) set settings.errorWorkflow via ${constants_1.MCP_UPDATE_WORKFLOW_TOOL.toolName}. Setting settings.errorWorkflow is rejected if the target has no published version, or no Error Trigger in that published version.`;
+Error handling has two complementary layers. (1) Per-node: set onError ("continueRegularOutput" / "continueErrorOutput"), retryOnFail, and maxTries via setNodeSettings on ${constants_1.MCP_UPDATE_WORKFLOW_TOOL.toolName}. (2) Failure notifications via an Error Trigger node, which can be wired two ways: (a) Dedicated/shared error workflow — point settings.errorWorkflow (via the setWorkflowSettings operation) at a SEPARATE workflow whose first node is an Error Trigger; this is the common best practice and lets one handler cover many workflows. (b) Same-workflow — add an Error Trigger node (→ a notification node such as Send Email or Slack) INTO this workflow; n8n runs it automatically when the workflow fails, with no settings change needed. Caveats: both fire only for production executions (not manual/test runs), and a configured settings.errorWorkflow takes precedence over a same-workflow Error Trigger for the failing run. When a user asks to "add error handling", "get notified on failure", or "make this reliable", briefly explain both patterns — most users do not know Error Triggers exist — and ask which they prefer before setting one up; do not enable error handling silently. For the shared pattern, reuse an existing handler (find its ID with search_workflows) or create a new one — but a dedicated error workflow must be PUBLISHED before it can be linked, in this order: (1) create it (${constants_1.MCP_CREATE_WORKFLOW_FROM_CODE_TOOL.toolName}, first node = Error Trigger → a notification node), (2) publish it (publish_workflow), (3) set settings.errorWorkflow via ${constants_1.MCP_UPDATE_WORKFLOW_TOOL.toolName}. Setting settings.errorWorkflow is rejected if the target has no published version, or no Error Trigger in that published version.${GROUPS_HINT}`;
     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":";;;AAQA,2CAWqB;AACrB,uDAA0E;AAE1E,4BACC,gBAAyB,EACzB,qBAAqB,GAAG,KAAK;IAE7B,MAAM,KAAK,GAAG,0EAA0E,CAAC;IAEzF,MAAM,gBAAgB,GAAG,qBAAqB;QAC7C,CAAC,CAAC;;mQAE+P,0CAA8B,CAAC,QAAQ,KAAK,4CAAgC,CAAC,QAAQ,0XAA0X,mDAAmC,4GAA4G;QAC/1B,CAAC,CAAC,EAAE,CAAC;IAEN,MAAM,oBAAoB,GAAG;;;;2CAIa,sCAA0B,CAAC,QAAQ;;gDAE9B,gDAAoC,CAAC,QAAQ;;0BAEnE,0CAA8B,CAAC,QAAQ,mPAAmP,gBAAgB;;gCAEpS,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;;6KAEuH,oCAAwB,CAAC,QAAQ,uqCAAuqC,8CAAkC,CAAC,QAAQ,8HAA8H,oCAAwB,CAAC,QAAQ,qIAAqI,CAAC;IAEpsD,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":";;;AAQA,2CAWqB;AACrB,uDAA0E;AAqB1E,4BAAmC,OAA+B;IACjE,MAAM,EAAE,gBAAgB,EAAE,qBAAqB,GAAG,KAAK,EAAE,mBAAmB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACjG,MAAM,KAAK,GAAG,0EAA0E,CAAC;IAGzF,MAAM,WAAW,GAAG,mBAAmB;QACtC,CAAC,CAAC;;wJAEoJ,sCAA0B,CAAC,QAAQ,6CAA6C,gDAAoC,CAAC,QAAQ,wCAAwC;QAC3T,CAAC,CAAC,EAAE,CAAC;IAEN,MAAM,gBAAgB,GAAG,qBAAqB;QAC7C,CAAC,CAAC;;mQAE+P,0CAA8B,CAAC,QAAQ,KAAK,4CAAgC,CAAC,QAAQ,0XAA0X,mDAAmC,4GAA4G;QAC/1B,CAAC,CAAC,EAAE,CAAC;IAEN,MAAM,oBAAoB,GAAG;;;;2CAIa,sCAA0B,CAAC,QAAQ;;gDAE9B,gDAAoC,CAAC,QAAQ;;0BAEnE,0CAA8B,CAAC,QAAQ,mPAAmP,gBAAgB;;gCAEpS,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;;6KAEuH,oCAAwB,CAAC,QAAQ,uqCAAuqC,8CAAkC,CAAC,QAAQ,8HAA8H,oCAAwB,CAAC,QAAQ,sIAAsI,WAAW,EAAE,CAAC;IAEltD,OAAO,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,oBAAoB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACzE,CAAC"}

package/dist/modules/mcp/tools/workflow-builder/sdk-reference-content.d.ts

@@ -1,2 +1,4 @@
-export type SdkReferenceSection = 'patterns' | 'patterns_detailed' | 'expressions' | 'functions' | 'rules' | 'import' | 'guidelines' | 'design' | 'all';
-export declare function getSdkReferenceContent(section?: SdkReferenceSection): string;
+export type SdkReferenceSection = 'patterns' | 'patterns_detailed' | 'expressions' | 'functions' | 'rules' | 'import' | 'guidelines' | 'design' | 'groups' | 'all';
+export declare function getSdkReferenceContent(section?: SdkReferenceSection, options?: {
+    includeGroups?: boolean;
+}): string;

package/dist/modules/mcp/tools/workflow-builder/sdk-reference-content.js

@@ -32,6 +32,7 @@ const WORKFLOW_PATTERNS_SECTION = `## Workflow Patterns\n\n${sdk_reference_1.WOR
 const WORKFLOW_PATTERNS_DETAILED_SECTION = `## Workflow Patterns Detailed\n\n${sdk_reference_1.WORKFLOW_PATTERNS_DETAILED}`;
 const CODING_GUIDELINES_SECTION = `## Coding Guidelines\n\n${CODING_GUIDELINES}`;
 const DESIGN_GUIDANCE_SECTION = `## Design Guidance\n\n${DESIGN_GUIDANCE}`;
+const GROUPS_SECTION = sdk_reference_1.NODE_GROUPS_REFERENCE;
 const SECTIONS = {
     import: SDK_IMPORT_SECTION,
     patterns: WORKFLOW_PATTERNS_SECTION,
@@ -41,8 +42,13 @@ const SECTIONS = {
     rules: sdk_reference_1.WORKFLOW_RULES,
     guidelines: CODING_GUIDELINES_SECTION,
     design: DESIGN_GUIDANCE_SECTION,
+    groups: GROUPS_SECTION,
 };
-function getSdkReferenceContent(section) {
+function getSdkReferenceContent(section, options = {}) {
+    const { includeGroups = false } = options;
+    if (section === 'groups') {
+        return includeGroups ? SECTIONS.groups : '';
+    }
     if (section && section !== 'all' && section in SECTIONS) {
         return SECTIONS[section];
     }
@@ -64,6 +70,7 @@ function getSdkReferenceContent(section) {
         SECTIONS.guidelines,
         '',
         SECTIONS.design,
+        ...(includeGroups ? ['', SECTIONS.groups] : []),
     ].join('\n');
 }
 //# sourceMappingURL=sdk-reference-content.js.map

package/dist/modules/mcp/tools/workflow-builder/sdk-reference-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-reference-content.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/sdk-reference-content.ts"],"names":[],"mappings":";;;AAQA,kEAAgE;AAChE,2EAMiD;AAMjD,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;mHAgByF,CAAC;AAEpH,MAAM,eAAe,GAAG;;;;;;wJAMgI,CAAC;AAgBzJ,MAAM,kBAAkB,GAAG,gDAAgD,0CAAoB,UAAU,CAAC;AAE1G,MAAM,yBAAyB,GAAG,2BAA2B,qCAAqB,EAAE,CAAC;AAErF,MAAM,kCAAkC,GAAG,oCAAoC,0CAA0B,EAAE,CAAC;AAE5G,MAAM,yBAAyB,GAAG,2BAA2B,iBAAiB,EAAE,CAAC;AAEjF,MAAM,uBAAuB,GAAG,yBAAyB,eAAe,EAAE,CAAC;AAE3E,MAAM,QAAQ,GAAwD;IACrE,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,yBAAyB;IACnC,iBAAiB,EAAE,kCAAkC;IACrD,WAAW,EAAE,oCAAoB;IACjC,SAAS,EAAE,oCAAoB;IAC/B,KAAK,EAAE,8BAAc;IACrB,UAAU,EAAE,yBAAyB;IACrC,MAAM,EAAE,uBAAuB;CAC/B,CAAC;AAKF,gCAAuC,OAA6B;IACnE,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACN,8BAA8B;QAC9B,EAAE;QACF,QAAQ,CAAC,MAAM;QACf,EAAE;QACF,QAAQ,CAAC,QAAQ;QACjB,EAAE;QACF,QAAQ,CAAC,iBAAiB;QAC1B,EAAE;QACF,QAAQ,CAAC,WAAW;QACpB,EAAE;QACF,QAAQ,CAAC,SAAS;QAClB,EAAE;QACF,QAAQ,CAAC,KAAK;QACd,EAAE;QACF,QAAQ,CAAC,UAAU;QACnB,EAAE;QACF,QAAQ,CAAC,MAAM;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}
+{"version":3,"file":"sdk-reference-content.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/sdk-reference-content.ts"],"names":[],"mappings":";;;AAQA,kEAAgE;AAChE,2EAOiD;AAMjD,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;mHAgByF,CAAC;AAEpH,MAAM,eAAe,GAAG;;;;;;wJAMgI,CAAC;AAiBzJ,MAAM,kBAAkB,GAAG,gDAAgD,0CAAoB,UAAU,CAAC;AAE1G,MAAM,yBAAyB,GAAG,2BAA2B,qCAAqB,EAAE,CAAC;AAErF,MAAM,kCAAkC,GAAG,oCAAoC,0CAA0B,EAAE,CAAC;AAE5G,MAAM,yBAAyB,GAAG,2BAA2B,iBAAiB,EAAE,CAAC;AAEjF,MAAM,uBAAuB,GAAG,yBAAyB,eAAe,EAAE,CAAC;AAI3E,MAAM,cAAc,GAAG,qCAAqB,CAAC;AAE7C,MAAM,QAAQ,GAAwD;IACrE,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,yBAAyB;IACnC,iBAAiB,EAAE,kCAAkC;IACrD,WAAW,EAAE,oCAAoB;IACjC,SAAS,EAAE,oCAAoB;IAC/B,KAAK,EAAE,8BAAc;IACrB,UAAU,EAAE,yBAAyB;IACrC,MAAM,EAAE,uBAAuB;IAC/B,MAAM,EAAE,cAAc;CACtB,CAAC;AASF,gCACC,OAA6B,EAC7B,OAAO,GAAgC,EAAE;IAEzC,MAAM,EAAE,aAAa,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAI1C,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACN,8BAA8B;QAC9B,EAAE;QACF,QAAQ,CAAC,MAAM;QACf,EAAE;QACF,QAAQ,CAAC,QAAQ;QACjB,EAAE;QACF,QAAQ,CAAC,iBAAiB;QAC1B,EAAE;QACF,QAAQ,CAAC,WAAW;QACpB,EAAE;QACF,QAAQ,CAAC,SAAS;QAClB,EAAE;QACF,QAAQ,CAAC,KAAK;QACd,EAAE;QACF,QAAQ,CAAC,UAAU;QACnB,EAAE;QACF,QAAQ,CAAC,MAAM;QACf,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/modules/mcp/tools/workflow-builder/update-workflow.tool.d.ts

@@ -14,6 +14,284 @@ import type { UrlService } from '../../../../services/url.service';
 import type { Telemetry } from '../../../../telemetry';
 import type { WorkflowFinderService } from '../../../../workflows/workflow-finder.service';
 import type { WorkflowService } from '../../../../workflows/workflow.service';
-declare const inputSchema: z.ZodRawShape;
-export declare const createUpdateWorkflowTool: (user: User, workflowFinderService: WorkflowFinderService, workflowService: WorkflowService, urlService: UrlService, telemetry: Telemetry, nodeTypes: NodeTypes, credentialsService: CredentialsService, sharedWorkflowRepository: SharedWorkflowRepository, collaborationService: CollaborationService, dataTableOps: DataTableUserOperations, tagService: TagService, globalConfig: GlobalConfig, subworkflowPolicyChecker: SubworkflowPolicyChecker, workflowPublishedDataService: WorkflowPublishedDataService, aiGatewayService: AiGatewayService) => ToolDefinition<typeof inputSchema>;
+declare const buildInputSchema: (canvasGroupsEnabled: boolean) => {
+    workflowId: z.ZodString;
+    skillsUsed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    operations: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["updateNodeParameters", "setNodeParameter", "addNode", "removeNode", "renameNode", "addConnection", "removeConnection", "setNodeCredential", "setNodePosition", "setNodeDisabled", "setNodeSettings", "setWorkflowMetadata", "setWorkflowSettings", "addTags", "removeTags", "setNodeGroups"]> | z.ZodEnum<["updateNodeParameters", "setNodeParameter", "addNode", "removeNode", "renameNode", "addConnection", "removeConnection", "setNodeCredential", "setNodePosition", "setNodeDisabled", "setNodeSettings", "setWorkflowMetadata", "setWorkflowSettings", "addTags", "removeTags", "setNodeGroups", "addNodeGroup", "removeNodeGroup", "updateNodeGroup"]>;
+        nodeName: z.ZodOptional<z.ZodString>;
+        node: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            typeVersion: z.ZodNumber;
+            parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            position: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id?: string | undefined;
+                name: string;
+            }, {
+                id?: string | undefined;
+                name: string;
+            }>>>;
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            notes: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type: string;
+            typeVersion: number;
+            parameters?: Record<string, unknown> | undefined;
+            position?: number[] | undefined;
+            credentials?: Record<string, {
+                id?: string | undefined;
+                name: string;
+            }> | undefined;
+            disabled?: boolean | undefined;
+            notes?: string | undefined;
+            id?: string | undefined;
+        }, {
+            name: string;
+            type: string;
+            typeVersion: number;
+            parameters?: Record<string, unknown> | undefined;
+            position?: number[] | undefined;
+            credentials?: Record<string, {
+                id?: string | undefined;
+                name: string;
+            }> | undefined;
+            disabled?: boolean | undefined;
+            notes?: string | undefined;
+            id?: string | undefined;
+        }>>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        replace: z.ZodOptional<z.ZodBoolean>;
+        path: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodUnknown>;
+        oldName: z.ZodOptional<z.ZodString>;
+        newName: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        target: z.ZodOptional<z.ZodString>;
+        sourceIndex: z.ZodOptional<z.ZodNumber>;
+        targetIndex: z.ZodOptional<z.ZodNumber>;
+        connectionType: z.ZodOptional<z.ZodString>;
+        credentialKey: z.ZodOptional<z.ZodString>;
+        credentialId: z.ZodOptional<z.ZodString>;
+        credentialName: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        settings: z.ZodOptional<z.ZodObject<{
+            errorWorkflow: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            executionOrder: z.ZodOptional<z.ZodEnum<["v0", "v1"]>>;
+            saveExecutionProgress: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"DEFAULT">]>>;
+            saveManualExecutions: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"DEFAULT">]>>;
+            saveDataErrorExecution: z.ZodOptional<z.ZodEnum<["DEFAULT", "all", "none"]>>;
+            saveDataSuccessExecution: z.ZodOptional<z.ZodEnum<["DEFAULT", "all", "none"]>>;
+            executionTimeout: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, number>>;
+            timeSavedPerExecution: z.ZodOptional<z.ZodNumber>;
+            callerPolicy: z.ZodOptional<z.ZodEnum<["any", "none", "workflowsFromAList", "workflowsFromSameOwner"]>>;
+            callerIds: z.ZodOptional<z.ZodString>;
+            onError: z.ZodOptional<z.ZodEnum<["stopWorkflow", "continueRegularOutput", "continueErrorOutput"]>>;
+            retryOnFail: z.ZodOptional<z.ZodBoolean>;
+            maxTries: z.ZodOptional<z.ZodNumber>;
+            waitBetweenTries: z.ZodOptional<z.ZodNumber>;
+            alwaysOutputData: z.ZodOptional<z.ZodBoolean>;
+            executeOnce: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            errorWorkflow?: string | undefined;
+            timezone?: string | undefined;
+            executionOrder?: "v0" | "v1" | undefined;
+            saveExecutionProgress?: "DEFAULT" | boolean | undefined;
+            saveManualExecutions?: "DEFAULT" | boolean | undefined;
+            saveDataErrorExecution?: "DEFAULT" | "all" | "none" | undefined;
+            saveDataSuccessExecution?: "DEFAULT" | "all" | "none" | undefined;
+            executionTimeout?: number | undefined;
+            timeSavedPerExecution?: number | undefined;
+            callerPolicy?: "any" | "none" | "workflowsFromAList" | "workflowsFromSameOwner" | undefined;
+            callerIds?: string | undefined;
+            onError?: "continueErrorOutput" | "continueRegularOutput" | "stopWorkflow" | undefined;
+            retryOnFail?: boolean | undefined;
+            maxTries?: number | undefined;
+            waitBetweenTries?: number | undefined;
+            alwaysOutputData?: boolean | undefined;
+            executeOnce?: boolean | undefined;
+        }, {
+            errorWorkflow?: string | undefined;
+            timezone?: string | undefined;
+            executionOrder?: "v0" | "v1" | undefined;
+            saveExecutionProgress?: "DEFAULT" | boolean | undefined;
+            saveManualExecutions?: "DEFAULT" | boolean | undefined;
+            saveDataErrorExecution?: "DEFAULT" | "all" | "none" | undefined;
+            saveDataSuccessExecution?: "DEFAULT" | "all" | "none" | undefined;
+            executionTimeout?: number | undefined;
+            timeSavedPerExecution?: number | undefined;
+            callerPolicy?: "any" | "none" | "workflowsFromAList" | "workflowsFromSameOwner" | undefined;
+            callerIds?: string | undefined;
+            onError?: "continueErrorOutput" | "continueRegularOutput" | "stopWorkflow" | undefined;
+            retryOnFail?: boolean | undefined;
+            maxTries?: number | undefined;
+            waitBetweenTries?: number | undefined;
+            alwaysOutputData?: boolean | undefined;
+            executeOnce?: boolean | undefined;
+        }>>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        names: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        nodeGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            nodeNames: z.ZodArray<z.ZodString, "many">;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id?: string | undefined;
+            name: string;
+            nodeNames: string[];
+            description?: string | undefined;
+        }, {
+            id?: string | undefined;
+            name: string;
+            nodeNames: string[];
+            description?: string | undefined;
+        }>, "many">>;
+        groupName?: z.ZodOptional<z.ZodString> | undefined;
+        nodeNames?: z.ZodOptional<z.ZodArray<z.ZodString, "many">> | undefined;
+        id?: z.ZodOptional<z.ZodString> | undefined;
+    }, "strip", z.ZodTypeAny, {
+        type: "addConnection" | "addNode" | "addNodeGroup" | "addTags" | "removeConnection" | "removeNode" | "removeNodeGroup" | "removeTags" | "renameNode" | "setNodeCredential" | "setNodeDisabled" | "setNodeGroups" | "setNodeParameter" | "setNodePosition" | "setNodeSettings" | "setWorkflowMetadata" | "setWorkflowSettings" | "updateNodeGroup" | "updateNodeParameters";
+        nodeName?: string | undefined;
+        node?: {
+            name: string;
+            type: string;
+            typeVersion: number;
+            parameters?: Record<string, unknown> | undefined;
+            position?: number[] | undefined;
+            credentials?: Record<string, {
+                id?: string | undefined;
+                name: string;
+            }> | undefined;
+            disabled?: boolean | undefined;
+            notes?: string | undefined;
+            id?: string | undefined;
+        } | undefined;
+        parameters?: Record<string, unknown> | undefined;
+        replace?: boolean | undefined;
+        path?: string | undefined;
+        value?: unknown;
+        oldName?: string | undefined;
+        newName?: string | undefined;
+        source?: string | undefined;
+        target?: string | undefined;
+        sourceIndex?: number | undefined;
+        targetIndex?: number | undefined;
+        connectionType?: string | undefined;
+        credentialKey?: string | undefined;
+        credentialId?: string | undefined;
+        credentialName?: string | undefined;
+        position?: number[] | undefined;
+        disabled?: boolean | undefined;
+        settings?: {
+            errorWorkflow?: string | undefined;
+            timezone?: string | undefined;
+            executionOrder?: "v0" | "v1" | undefined;
+            saveExecutionProgress?: "DEFAULT" | boolean | undefined;
+            saveManualExecutions?: "DEFAULT" | boolean | undefined;
+            saveDataErrorExecution?: "DEFAULT" | "all" | "none" | undefined;
+            saveDataSuccessExecution?: "DEFAULT" | "all" | "none" | undefined;
+            executionTimeout?: number | undefined;
+            timeSavedPerExecution?: number | undefined;
+            callerPolicy?: "any" | "none" | "workflowsFromAList" | "workflowsFromSameOwner" | undefined;
+            callerIds?: string | undefined;
+            onError?: "continueErrorOutput" | "continueRegularOutput" | "stopWorkflow" | undefined;
+            retryOnFail?: boolean | undefined;
+            maxTries?: number | undefined;
+            waitBetweenTries?: number | undefined;
+            alwaysOutputData?: boolean | undefined;
+            executeOnce?: boolean | undefined;
+        } | undefined;
+        name?: string | undefined;
+        description?: string | undefined;
+        names?: string[] | undefined;
+        nodeGroups?: {
+            id?: string | undefined;
+            name: string;
+            nodeNames: string[];
+            description?: string | undefined;
+        }[] | undefined;
+        groupName?: unknown;
+        nodeNames?: unknown;
+        id?: unknown;
+    }, {
+        type: "addConnection" | "addNode" | "addNodeGroup" | "addTags" | "removeConnection" | "removeNode" | "removeNodeGroup" | "removeTags" | "renameNode" | "setNodeCredential" | "setNodeDisabled" | "setNodeGroups" | "setNodeParameter" | "setNodePosition" | "setNodeSettings" | "setWorkflowMetadata" | "setWorkflowSettings" | "updateNodeGroup" | "updateNodeParameters";
+        nodeName?: string | undefined;
+        node?: {
+            name: string;
+            type: string;
+            typeVersion: number;
+            parameters?: Record<string, unknown> | undefined;
+            position?: number[] | undefined;
+            credentials?: Record<string, {
+                id?: string | undefined;
+                name: string;
+            }> | undefined;
+            disabled?: boolean | undefined;
+            notes?: string | undefined;
+            id?: string | undefined;
+        } | undefined;
+        parameters?: Record<string, unknown> | undefined;
+        replace?: boolean | undefined;
+        path?: string | undefined;
+        value?: unknown;
+        oldName?: string | undefined;
+        newName?: string | undefined;
+        source?: string | undefined;
+        target?: string | undefined;
+        sourceIndex?: number | undefined;
+        targetIndex?: number | undefined;
+        connectionType?: string | undefined;
+        credentialKey?: string | undefined;
+        credentialId?: string | undefined;
+        credentialName?: string | undefined;
+        position?: number[] | undefined;
+        disabled?: boolean | undefined;
+        settings?: {
+            errorWorkflow?: string | undefined;
+            timezone?: string | undefined;
+            executionOrder?: "v0" | "v1" | undefined;
+            saveExecutionProgress?: "DEFAULT" | boolean | undefined;
+            saveManualExecutions?: "DEFAULT" | boolean | undefined;
+            saveDataErrorExecution?: "DEFAULT" | "all" | "none" | undefined;
+            saveDataSuccessExecution?: "DEFAULT" | "all" | "none" | undefined;
+            executionTimeout?: number | undefined;
+            timeSavedPerExecution?: number | undefined;
+            callerPolicy?: "any" | "none" | "workflowsFromAList" | "workflowsFromSameOwner" | undefined;
+            callerIds?: string | undefined;
+            onError?: "continueErrorOutput" | "continueRegularOutput" | "stopWorkflow" | undefined;
+            retryOnFail?: boolean | undefined;
+            maxTries?: number | undefined;
+            waitBetweenTries?: number | undefined;
+            alwaysOutputData?: boolean | undefined;
+            executeOnce?: boolean | undefined;
+        } | undefined;
+        name?: string | undefined;
+        description?: string | undefined;
+        names?: string[] | undefined;
+        nodeGroups?: {
+            id?: string | undefined;
+            name: string;
+            nodeNames: string[];
+            description?: string | undefined;
+        }[] | undefined;
+        groupName?: unknown;
+        nodeNames?: unknown;
+        id?: unknown;
+    }>, "many">;
+    versionName: z.ZodOptional<z.ZodString>;
+    versionDescription: z.ZodOptional<z.ZodString>;
+};
+export declare const createUpdateWorkflowTool: (user: User, workflowFinderService: WorkflowFinderService, workflowService: WorkflowService, urlService: UrlService, telemetry: Telemetry, nodeTypes: NodeTypes, credentialsService: CredentialsService, sharedWorkflowRepository: SharedWorkflowRepository, collaborationService: CollaborationService, dataTableOps: DataTableUserOperations, tagService: TagService, globalConfig: GlobalConfig, subworkflowPolicyChecker: SubworkflowPolicyChecker, workflowPublishedDataService: WorkflowPublishedDataService, aiGatewayService: AiGatewayService, options?: {
+    canvasGroupsEnabled?: boolean;
+}) => ToolDefinition<ReturnType<typeof buildInputSchema>>;
 export {};