n8n-mcp 2.65.2 → 2.66.0

package/dist/services/node-groups.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeGroupInputSchema = exports.GROUP_DESCRIPTION_MAX_LENGTH = void 0;
+exports.parseNodeGroupsInput = parseNodeGroupsInput;
+exports.toWorkflowNodeGroup = toWorkflowNodeGroup;
+exports.nodeGroupsField = nodeGroupsField;
+exports.sanitizeGroupsForApi = sanitizeGroupsForApi;
+exports.repairNodeGroups = repairNodeGroups;
+exports.checkNodeGroups = checkNodeGroups;
+exports.dropRejectedGroup = dropRejectedGroup;
+exports.classifyGroupError = classifyGroupError;
+const zod_1 = require("zod");
+const uuid_1 = require("uuid");
+const mcp_input_normalizer_1 = require("../utils/mcp-input-normalizer");
+exports.GROUP_DESCRIPTION_MAX_LENGTH = 155;
+exports.nodeGroupInputSchema = zod_1.z.object({
+    id: zod_1.z.string().trim().min(1).optional(),
+    name: zod_1.z.string().trim().min(1),
+    nodeIds: zod_1.z.array(zod_1.z.string().trim().min(1)).min(1),
+    description: zod_1.z.string().trim().max(exports.GROUP_DESCRIPTION_MAX_LENGTH).optional()
+});
+function parseNodeGroupsInput(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    const groups = zod_1.z.array(exports.nodeGroupInputSchema).parse((0, mcp_input_normalizer_1.normalizeMcpJsonValue)(value));
+    return groups.map(toWorkflowNodeGroup);
+}
+function toWorkflowNodeGroup(group) {
+    const normalized = {
+        id: group.id?.trim() || (0, uuid_1.v4)(),
+        name: group.name.trim(),
+        nodeIds: group.nodeIds
+    };
+    const description = typeof group.description === 'string' ? group.description.trim() : '';
+    if (description)
+        normalized.description = description;
+    return normalized;
+}
+function isGroupLike(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const group = value;
+    return typeof group.id === 'string' && typeof group.name === 'string' && Array.isArray(group.nodeIds);
+}
+function groupLabel(group) {
+    return group.name?.trim() ? group.name : group.id;
+}
+function nodeGroupsField(groups) {
+    return Array.isArray(groups) && groups.length > 0 ? { nodeGroups: groups } : {};
+}
+function sanitizeGroupsForApi(groups, options) {
+    if (!Array.isArray(groups))
+        return [];
+    return groups.filter(isGroupLike).map(group => {
+        const sanitized = {
+            id: group.id,
+            name: group.name,
+            nodeIds: group.nodeIds.filter(id => typeof id === 'string')
+        };
+        if (options.includeDescription && typeof group.description === 'string') {
+            const description = group.description.trim();
+            if (description)
+                sanitized.description = description;
+        }
+        return sanitized;
+    });
+}
+function repairNodeGroups(workflow, options = {}) {
+    const groups = workflow.nodeGroups;
+    if (!Array.isArray(groups) || groups.length === 0) {
+        return { nodeGroups: groups, issues: [] };
+    }
+    const knownIds = new Set((workflow.nodes ?? []).map(node => node?.id).filter((id) => typeof id === 'string'));
+    const authored = options.authoredGroups ?? new Set();
+    const issues = [];
+    const repaired = [];
+    const errors = [];
+    let changed = false;
+    for (const group of groups) {
+        if (!isGroupLike(group)) {
+            changed = true;
+            issues.push({
+                code: 'group-malformed',
+                group: 'unknown',
+                message: 'A canvas group was dropped because it is missing an id, a name, or its member list.'
+            });
+            continue;
+        }
+        const label = groupLabel(group);
+        const keptIds = group.nodeIds.filter(id => typeof id === 'string' && knownIds.has(id));
+        const removedCount = group.nodeIds.length - keptIds.length;
+        if (removedCount > 0 && authored.has(group.name)) {
+            const missing = group.nodeIds.filter(id => !keptIds.includes(id));
+            errors.push(`Node group "${label}" references ${missing.length === 1 ? 'node' : 'nodes'} ${missing
+                .map(id => `"${id}"`)
+                .join(', ')} that ${missing.length === 1 ? 'is' : 'are'} not in the workflow.`);
+            repaired.push(group);
+            continue;
+        }
+        if (keptIds.length === 0) {
+            changed = true;
+            issues.push({
+                code: 'group-empty',
+                group: label,
+                message: `Node group "${label}" was removed because none of its nodes are left in the workflow.`
+            });
+            continue;
+        }
+        if (removedCount > 0) {
+            changed = true;
+            issues.push({
+                code: 'group-member-removed',
+                group: label,
+                message: `Node group "${label}" lost ${removedCount} member${removedCount === 1 ? '' : 's'} that no longer exist in the workflow; the group was kept with its remaining ${keptIds.length} node${keptIds.length === 1 ? '' : 's'}.`
+            });
+            repaired.push({ ...group, nodeIds: keptIds });
+            continue;
+        }
+        repaired.push(group);
+    }
+    return {
+        nodeGroups: changed ? repaired : groups,
+        issues,
+        errors: errors.length > 0 ? errors : undefined
+    };
+}
+function checkNodeGroups(workflow, options = {}) {
+    const groups = workflow.nodeGroups;
+    if (!Array.isArray(groups) || groups.length === 0)
+        return [];
+    const issues = [];
+    const nodesById = new Map();
+    for (const node of workflow.nodes ?? []) {
+        if (node?.id)
+            nodesById.set(node.id, node);
+    }
+    const seenNames = new Set();
+    const groupByNodeId = new Map();
+    for (const group of groups) {
+        if (!isGroupLike(group))
+            continue;
+        const label = groupLabel(group);
+        if (seenNames.has(group.name)) {
+            issues.push({
+                code: 'group-duplicate-name',
+                group: label,
+                message: `Two node groups are named "${group.name}"; n8n requires group names to be unique.`
+            });
+        }
+        seenNames.add(group.name);
+        if (group.nodeIds.length === 0) {
+            issues.push({
+                code: 'group-empty',
+                group: label,
+                message: `Node group "${label}" has no members; n8n rejects empty groups.`
+            });
+        }
+        for (const nodeId of group.nodeIds) {
+            const node = nodesById.get(nodeId);
+            if (!node) {
+                issues.push({
+                    code: 'group-member-removed',
+                    group: label,
+                    message: `Node group "${label}" references node ID "${nodeId}", which is not in the workflow.`
+                });
+                continue;
+            }
+            const owner = groupByNodeId.get(nodeId);
+            if (owner) {
+                issues.push({
+                    code: 'group-node-in-multiple-groups',
+                    group: label,
+                    message: `Node "${node.name}" is in both "${owner}" and "${label}"; a node can only belong to one group.`
+                });
+            }
+            else {
+                groupByNodeId.set(nodeId, label);
+            }
+            if (options.isTrigger?.(node)) {
+                issues.push({
+                    code: 'group-contains-trigger',
+                    group: label,
+                    message: `Node group "${label}" contains trigger node "${node.name}"; n8n does not allow triggers inside a group.`
+                });
+            }
+        }
+    }
+    return issues;
+}
+function dropRejectedGroup(groups, target) {
+    const byId = target.groupId ? groups.findIndex(group => group.id === target.groupId) : -1;
+    const index = byId !== -1
+        ? byId
+        : target.groupName
+            ? groups.findIndex(group => group.name === target.groupName)
+            : -1;
+    if (index === -1)
+        return { groups, dropped: null };
+    return { groups: groups.filter((_, i) => i !== index), dropped: groups[index] };
+}
+function classifyGroupError(error) {
+    const apiError = error;
+    const message = typeof apiError?.message === 'string' ? apiError.message : '';
+    if (!apiError || apiError.statusCode !== 400) {
+        return { kind: 'unrelated', message };
+    }
+    let detailsText = '';
+    try {
+        detailsText = apiError.details === undefined ? '' : JSON.stringify(apiError.details);
+    }
+    catch {
+        detailsText = '';
+    }
+    const haystack = `${message} ${detailsText}`;
+    if (/must NOT have additional propert/i.test(haystack)) {
+        const nested = /request\/body\/([A-Za-z0-9_]+)/.exec(haystack);
+        if (nested) {
+            return nested[1] === 'nodeGroups'
+                ? { kind: 'schema-description', message }
+                : { kind: 'unrelated', message };
+        }
+        return { kind: 'schema-field', message };
+    }
+    const identified = /(?:node group|group)\s+"(.+?)"\s*\(([^)]+)\)/i.exec(haystack);
+    if (identified) {
+        return { kind: 'semantic', groupName: identified[1], groupId: identified[2], message };
+    }
+    const named = /(?:node group|group)\s+"([^"]+)"/i.exec(haystack);
+    if (named) {
+        return { kind: 'semantic', groupName: named[1], message };
+    }
+    if (/nodeGroups/.test(haystack)) {
+        return { kind: 'semantic', message };
+    }
+    return { kind: 'unrelated', message };
+}
+//# sourceMappingURL=node-groups.js.map

package/dist/services/node-groups.js.map

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

package/dist/services/workflow-diff-engine.d.ts

@@ -8,6 +8,7 @@ export declare class WorkflowDiffEngine {
     private tagsToAdd;
     private tagsToRemove;
     private transferToProjectId;
+    private authoredGroupNames;
     applyDiff(workflow: Workflow, request: WorkflowDiffRequest): Promise<WorkflowDiffResult>;
     private validateOperation;
     private applyOperation;
@@ -33,6 +34,11 @@ export declare class WorkflowDiffEngine {
     private applyRewireConnection;
     private applyUpdateSettings;
     private applyUpdateName;
+    private validateSetNodeGroups;
+    private resolveGroupMembers;
+    private applySetNodeGroups;
+    private authoredGroupNamesOrUndefined;
+    private finalizeNodeGroups;
     private applyAddTag;
     private applyRemoveTag;
     private validateActivateWorkflow;

package/dist/services/workflow-diff-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-diff-engine.d.ts","sourceRoot":"","sources":["../../src/services/workflow-diff-engine.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,mBAAmB,EACnB,kBAAkB,EAwBnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAoC,MAAM,kBAAkB,CAAC;AAuH9E,qBAAa,kBAAkB;IAE7B,OAAO,CAAC,SAAS,CAAkC;IAEnD,OAAO,CAAC,QAAQ,CAAqC;IAErD,OAAO,CAAC,eAAe,CAAqB;IAE5C,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,YAAY,CAAgB;IAEpC,OAAO,CAAC,mBAAmB,CAAqB;IAK1C,SAAS,CACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAqL9B,OAAO,CAAC,iBAAiB;IA4CzB,OAAO,CAAC,cAAc;IA+DtB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,kBAAkB;IA6D1B,OAAO,CAAC,sBAAsB;IAuE9B,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,qBAAqB;IAqD7B,OAAO,CAAC,wBAAwB;IA6ChC,OAAO,CAAC,wBAAwB;IA4DhC,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,eAAe;IAsDvB,OAAO,CAAC,mBAAmB;IAgE3B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,sBAAsB;IA6D9B,OAAO,CAAC,kBAAkB;IAiD1B,OAAO,CAAC,qBAAqB;IAuC7B,OAAO,CAAC,qBAAqB;IAkF7B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,0BAA0B;IAMlC,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,6BAA6B;IAKrC,OAAO,CAAC,0BAA0B;IA0BlC,OAAO,CAAC,0BAA0B;IA+ElC,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,0BAA0B;IAmElC,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,QAAQ;IAsChB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;CA0C1B"}
+{"version":3,"file":"workflow-diff-engine.d.ts","sourceRoot":"","sources":["../../src/services/workflow-diff-engine.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,mBAAmB,EACnB,kBAAkB,EAyBnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAuD,MAAM,kBAAkB,CAAC;AAwHjG,qBAAa,kBAAkB;IAE7B,OAAO,CAAC,SAAS,CAAkC;IAEnD,OAAO,CAAC,QAAQ,CAAqC;IAErD,OAAO,CAAC,eAAe,CAAqB;IAE5C,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,YAAY,CAAgB;IAEpC,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,kBAAkB,CAAqB;IAKzC,SAAS,CACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IA+L9B,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,cAAc;IAkEtB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,kBAAkB;IAmE1B,OAAO,CAAC,sBAAsB;IA8E9B,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,qBAAqB;IAqD7B,OAAO,CAAC,wBAAwB;IA6ChC,OAAO,CAAC,wBAAwB;IA4DhC,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,eAAe;IAsDvB,OAAO,CAAC,mBAAmB;IAgE3B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,sBAAsB;IA6D9B,OAAO,CAAC,kBAAkB;IAiD1B,OAAO,CAAC,qBAAqB;IAuC7B,OAAO,CAAC,qBAAqB;IAkF7B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,qBAAqB;IA+E7B,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,6BAA6B;IAWrC,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,0BAA0B;IAMlC,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,6BAA6B;IAKrC,OAAO,CAAC,0BAA0B;IA0BlC,OAAO,CAAC,0BAA0B;IA+ElC,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,0BAA0B;IAmElC,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,QAAQ;IAsChB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;CA0C1B"}

package/dist/services/workflow-diff-engine.js

@@ -4,6 +4,7 @@ exports.WorkflowDiffEngine = void 0;
 const uuid_1 = require("uuid");
 const workflow_diff_1 = require("../types/workflow-diff");
 const logger_1 = require("../utils/logger");
+const node_groups_1 = require("./node-groups");
 const node_sanitizer_1 = require("./node-sanitizer");
 const node_type_utils_1 = require("../utils/node-type-utils");
 const logger = new logger_1.Logger({ prefix: '[WorkflowDiffEngine]' });
@@ -82,6 +83,7 @@ class WorkflowDiffEngine {
         this.removedNodeNames = new Set();
         this.tagsToAdd = [];
         this.tagsToRemove = [];
+        this.authoredGroupNames = new Set();
     }
     async applyDiff(workflow, request) {
         try {
@@ -92,6 +94,7 @@ class WorkflowDiffEngine {
             this.tagsToAdd = [];
             this.tagsToRemove = [];
             this.transferToProjectId = undefined;
+            this.authoredGroupNames.clear();
             const workflowCopy = JSON.parse(JSON.stringify(workflow));
             const operationEntries = buildExecutionEntries(request.operations);
             const nodeOperationCount = request.operations.filter(workflow_diff_1.isNodeOperation).length;
@@ -126,6 +129,7 @@ class WorkflowDiffEngine {
                         failedIndices.push(index);
                     }
                 }
+                this.finalizeNodeGroups(workflowCopy);
                 if (request.validateOnly) {
                     return {
                         success: errors.length === 0,
@@ -136,7 +140,8 @@ class WorkflowDiffEngine {
                         errors: errors.length > 0 ? errors : undefined,
                         warnings: this.warnings.length > 0 ? this.warnings : undefined,
                         applied: appliedIndices,
-                        failed: failedIndices
+                        failed: failedIndices,
+                        authoredGroupNames: this.authoredGroupNamesOrUndefined()
                     };
                 }
                 const shouldActivate = workflowCopy._shouldActivate === true;
@@ -157,7 +162,8 @@ class WorkflowDiffEngine {
                     shouldDeactivate: shouldDeactivate || undefined,
                     tagsToAdd: this.tagsToAdd.length > 0 ? this.tagsToAdd : undefined,
                     tagsToRemove: this.tagsToRemove.length > 0 ? this.tagsToRemove : undefined,
-                    transferToProjectId: this.transferToProjectId || undefined
+                    transferToProjectId: this.transferToProjectId || undefined,
+                    authoredGroupNames: this.authoredGroupNamesOrUndefined()
                 };
             }
             else {
@@ -197,11 +203,14 @@ class WorkflowDiffEngine {
                     });
                     logger.debug(`Sanitized ${this.modifiedNodeIds.size} modified nodes`);
                 }
+                this.finalizeNodeGroups(workflowCopy);
                 if (request.validateOnly) {
                     return {
                         success: true,
                         workflow: workflowCopy,
-                        message: 'Validation successful. Operations are valid but not applied.'
+                        message: 'Validation successful. Operations are valid but not applied.',
+                        warnings: this.warnings.length > 0 ? this.warnings : undefined,
+                        authoredGroupNames: this.authoredGroupNamesOrUndefined()
                     };
                 }
                 const operationsApplied = request.operations.length;
@@ -219,7 +228,8 @@ class WorkflowDiffEngine {
                     shouldDeactivate: shouldDeactivate || undefined,
                     tagsToAdd: this.tagsToAdd.length > 0 ? this.tagsToAdd : undefined,
                     tagsToRemove: this.tagsToRemove.length > 0 ? this.tagsToRemove : undefined,
-                    transferToProjectId: this.transferToProjectId || undefined
+                    transferToProjectId: this.transferToProjectId || undefined,
+                    authoredGroupNames: this.authoredGroupNamesOrUndefined()
                 };
             }
         }
@@ -260,6 +270,8 @@ class WorkflowDiffEngine {
             case 'addTag':
             case 'removeTag':
                 return null;
+            case 'setNodeGroups':
+                return this.validateSetNodeGroups(workflow, operation);
             case 'transferWorkflow':
                 return this.validateTransferWorkflow(workflow, operation);
             case 'activateWorkflow':
@@ -312,6 +324,9 @@ class WorkflowDiffEngine {
             case 'updateName':
                 this.applyUpdateName(workflow, operation);
                 break;
+            case 'setNodeGroups':
+                this.applySetNodeGroups(workflow, operation);
+                break;
             case 'addTag':
                 this.applyAddTag(workflow, operation);
                 break;
@@ -375,6 +390,9 @@ class WorkflowDiffEngine {
         if (!node) {
             return this.formatNodeNotFoundError(workflow, operation.nodeId || operation.nodeName || '', 'updateNode');
         }
+        if ('id' in operation.updates && operation.updates.id !== node.id) {
+            return `Cannot change the id of node "${node.name}": node IDs are immutable because canvas groups and pinned data reference them. Remove and re-add the node instead.`;
+        }
         if (operation.updates.name && operation.updates.name !== node.name) {
             const normalizedNewName = this.normalizeNodeName(operation.updates.name);
             const normalizedCurrentName = this.normalizeNodeName(node.name);
@@ -420,6 +438,9 @@ class WorkflowDiffEngine {
         if (pathSegments.some(k => DANGEROUS_PATH_KEYS.has(k))) {
             return `patchNodeField: fieldPath "${operation.fieldPath}" contains a forbidden key (__proto__, constructor, or prototype)`;
         }
+        if (pathSegments[0] === 'id') {
+            return `Cannot patch the id of a node: node IDs are immutable because canvas groups and pinned data reference them. Remove and re-add the node instead.`;
+        }
         if (!Array.isArray(operation.patches) || operation.patches.length === 0) {
             return `patchNodeField requires a non-empty "patches" array of {find, replace} objects`;
         }
@@ -904,6 +925,113 @@ class WorkflowDiffEngine {
     applyUpdateName(workflow, operation) {
         workflow.name = operation.name;
     }
+    validateSetNodeGroups(workflow, operation) {
+        const groups = operation.nodeGroups;
+        if (!Array.isArray(groups)) {
+            return `setNodeGroups requires a "nodeGroups" array. Pass every group you want to keep, or [] to ungroup everything. Example: {type: "setNodeGroups", nodeGroups: [{name: "Enrich lead", nodeNames: ["Fetch company", "Score lead"]}]}`;
+        }
+        const seenNames = new Set();
+        const claimedNodes = new Map();
+        for (const group of groups) {
+            if (!group || typeof group !== 'object') {
+                return `setNodeGroups: every entry must be an object like {name: "Enrich lead", nodeNames: ["Fetch company", "Score lead"]}`;
+            }
+            const name = typeof group.name === 'string' ? group.name.trim() : '';
+            if (!name) {
+                return `setNodeGroups: every group needs a non-empty "name"`;
+            }
+            if (seenNames.has(name)) {
+                return `setNodeGroups: duplicate group name "${name}". n8n requires group names to be unique.`;
+            }
+            seenNames.add(name);
+            if (group.id !== undefined && (typeof group.id !== 'string' || !group.id.trim())) {
+                return `setNodeGroups: group "${name}" has a non-string "id". Omit it to have one generated.`;
+            }
+            if (group.description !== undefined) {
+                if (typeof group.description !== 'string') {
+                    return `setNodeGroups: group "${name}" has a non-string "description"`;
+                }
+                if (group.description.trim().length > node_groups_1.GROUP_DESCRIPTION_MAX_LENGTH) {
+                    return `setNodeGroups: group "${name}" has a description of ${group.description.trim().length} characters; n8n allows at most ${node_groups_1.GROUP_DESCRIPTION_MAX_LENGTH}.`;
+                }
+            }
+            const hasNames = Array.isArray(group.nodeNames) && group.nodeNames.length > 0;
+            const hasIds = Array.isArray(group.nodeIds) && group.nodeIds.length > 0;
+            if (hasNames === hasIds) {
+                return hasNames
+                    ? `setNodeGroups: group "${name}" sets both "nodeNames" and "nodeIds" — use one or the other`
+                    : `setNodeGroups: group "${name}" needs members in "nodeNames" (or "nodeIds")`;
+            }
+            const members = hasIds ? group.nodeIds : group.nodeNames;
+            const badIndex = members.findIndex(member => typeof member !== 'string' || !member.trim());
+            if (badIndex !== -1) {
+                return `setNodeGroups: group "${name}" has a member that is not a node ${hasIds ? 'ID' : 'name'} (${JSON.stringify(members[badIndex])})`;
+            }
+            const resolvedMembers = this.resolveGroupMembers(workflow, group);
+            if (typeof resolvedMembers === 'string')
+                return resolvedMembers;
+            for (const node of resolvedMembers) {
+                const owner = claimedNodes.get(node.id);
+                if (owner && owner !== name) {
+                    return `setNodeGroups: node "${node.name}" is in both "${owner}" and "${name}" — a node can only belong to one group`;
+                }
+                claimedNodes.set(node.id, name);
+            }
+        }
+        return null;
+    }
+    resolveGroupMembers(workflow, group) {
+        const label = group.name?.trim() || group.id || 'unnamed group';
+        const resolved = [];
+        if (Array.isArray(group.nodeIds) && group.nodeIds.length > 0) {
+            for (const nodeId of group.nodeIds) {
+                const node = workflow.nodes.find(n => n.id === nodeId);
+                if (!node) {
+                    return `setNodeGroups: group "${label}" references node ID "${nodeId}", which is not in the workflow. ${this.formatNodeNotFoundError(workflow, nodeId, 'setNodeGroups')}`;
+                }
+                resolved.push(node);
+            }
+            return resolved;
+        }
+        for (const nodeName of group.nodeNames ?? []) {
+            const normalized = this.normalizeNodeName(nodeName);
+            const node = workflow.nodes.find(n => this.normalizeNodeName(n.name) === normalized);
+            if (!node) {
+                return `setNodeGroups: group "${label}" references node "${nodeName}", which is not in the workflow. ${this.formatNodeNotFoundError(workflow, nodeName, 'setNodeGroups')}`;
+            }
+            resolved.push(node);
+        }
+        return resolved;
+    }
+    applySetNodeGroups(workflow, operation) {
+        const groups = [];
+        for (const group of operation.nodeGroups) {
+            const members = this.resolveGroupMembers(workflow, group);
+            if (typeof members === 'string')
+                throw new Error(members);
+            const resolved = (0, node_groups_1.toWorkflowNodeGroup)({
+                id: group.id,
+                name: group.name,
+                nodeIds: [...new Set(members.map(node => node.id))],
+                description: group.description
+            });
+            groups.push(resolved);
+            this.authoredGroupNames.add(resolved.name);
+        }
+        workflow.nodeGroups = groups;
+    }
+    authoredGroupNamesOrUndefined() {
+        return this.authoredGroupNames.size > 0 ? [...this.authoredGroupNames] : undefined;
+    }
+    finalizeNodeGroups(workflow) {
+        if (!Array.isArray(workflow.nodeGroups) || workflow.nodeGroups.length === 0)
+            return;
+        const { nodeGroups, issues } = (0, node_groups_1.repairNodeGroups)(workflow);
+        workflow.nodeGroups = nodeGroups;
+        for (const issue of issues) {
+            this.warnings.push({ operation: -1, message: issue.message });
+        }
+    }
     applyAddTag(workflow, operation) {
         const removeIdx = this.tagsToRemove.indexOf(operation.tag);
         if (removeIdx !== -1) {