@path58/n8n-mcp 0.1.0

package/dist/mcp/tools/fixes/flow-fixes.js

@@ -0,0 +1,155 @@
+/**
+ * Fix strategies for flow/structure-related validation issues.
+ *
+ * RAG-4.2.4: suggest_fix MCP tool
+ * Handles L6 pattern issues: NO_TRIGGER, UNREACHABLE_NODE, DEAD_END, etc.
+ *
+ * @module mcp/tools/fixes/flow-fixes
+ */
+/**
+ * Strategy for NO_TRIGGER (workflow has no trigger node).
+ */
+export const noTriggerStrategy = {
+    supportedCodes: ['NO_TRIGGER', 'L6_NO_TRIGGER', 'MISSING_TRIGGER'],
+    async suggest(issueCode, context) {
+        return {
+            fixable: true,
+            fix: {
+                action: 'add',
+                target: 'nodes',
+                to: {
+                    type: 'n8n-nodes-base.manualTrigger',
+                    name: 'Manual Trigger',
+                    position: [250, 300],
+                },
+                explanation: 'Add a Manual Trigger node to start the workflow. For production, consider Schedule Trigger or Webhook Trigger.',
+                confidence: 'high',
+            },
+            documentation_url: 'https://docs.n8n.io/workflows/executions/manual-executions/',
+        };
+    },
+};
+/**
+ * Strategy for UNREACHABLE_NODE (node has no input connections).
+ */
+export const unreachableNodeStrategy = {
+    supportedCodes: ['UNREACHABLE_NODE', 'L6_UNREACHABLE_NODE', 'DISCONNECTED_NODE'],
+    async suggest(issueCode, context) {
+        const nodeName = context?.node_name || 'the node';
+        return {
+            fixable: true,
+            fix: {
+                action: 'add',
+                target: 'connections',
+                to: { from: 'previous_node', to: nodeName },
+                explanation: `Connect '${nodeName}' to a preceding node in the workflow. The node is currently isolated.`,
+                confidence: 'medium',
+            },
+            alternative: 'If this node is intentionally standalone, it may indicate a workflow design issue.',
+        };
+    },
+};
+/**
+ * Strategy for DEAD_END_NODE (node has no output connections but isn't terminal).
+ */
+export const deadEndNodeStrategy = {
+    supportedCodes: ['DEAD_END_NODE', 'L6_DEAD_END_NODE', 'NO_OUTPUT_CONNECTION'],
+    async suggest(issueCode, context) {
+        const nodeName = context?.node_name || 'the node';
+        const nodeType = context?.node_type || '';
+        // Check if it's a known terminal node type
+        const terminalTypes = [
+            'n8n-nodes-base.respondToWebhook',
+            'n8n-nodes-base.stopAndError',
+            'n8n-nodes-base.noOp',
+        ];
+        if (terminalTypes.includes(nodeType)) {
+            return {
+                fixable: false,
+                alternative: `'${nodeName}' is a terminal node type that doesn't require output connections.`,
+            };
+        }
+        return {
+            fixable: true,
+            fix: {
+                action: 'add',
+                target: 'connections',
+                to: { from: nodeName, to: 'next_node' },
+                explanation: `Connect '${nodeName}' to a following node or add a terminal node (like Respond to Webhook).`,
+                confidence: 'medium',
+            },
+            alternative: 'If this is intentionally the last node, you may ignore this warning.',
+        };
+    },
+};
+/**
+ * Strategy for MULTIPLE_TRIGGERS (workflow has more than one trigger).
+ */
+export const multipleTriggersStrategy = {
+    supportedCodes: ['MULTIPLE_TRIGGERS', 'L6_MULTIPLE_TRIGGERS'],
+    async suggest(issueCode, context) {
+        return {
+            fixable: false,
+            alternative: 'n8n workflows should have only one trigger. Remove extra triggers or split into separate workflows.',
+            documentation_url: 'https://docs.n8n.io/workflows/components/trigger/',
+        };
+    },
+};
+/**
+ * Strategy for CIRCULAR_CONNECTION (connection creates a loop).
+ */
+export const circularConnectionStrategy = {
+    supportedCodes: ['CIRCULAR_CONNECTION', 'L4_CIRCULAR_CONNECTION', 'CYCLE_DETECTED'],
+    async suggest(issueCode, context) {
+        return {
+            fixable: false,
+            alternative: 'Remove the connection that creates the loop. If you need iteration, use the Loop Over Items node instead.',
+            documentation_url: 'https://docs.n8n.io/code/cookbook/looping/',
+        };
+    },
+};
+/**
+ * Strategy for ERROR_OUTPUT_UNCONNECTED.
+ */
+export const errorOutputStrategy = {
+    supportedCodes: ['ERROR_OUTPUT_UNCONNECTED', 'L6_ERROR_OUTPUT_UNCONNECTED'],
+    async suggest(issueCode, context) {
+        const nodeName = context?.node_name || 'the node';
+        return {
+            fixable: true,
+            fix: {
+                action: 'add',
+                target: 'connections',
+                to: { from: `${nodeName}[error]`, to: 'error_handler' },
+                explanation: `Connect the error output of '${nodeName}' to an error handling node (like Stop and Error or a notification node).`,
+                confidence: 'medium',
+            },
+            documentation_url: 'https://docs.n8n.io/workflows/error-handling/',
+        };
+    },
+};
+/**
+ * Strategy for NO_RETRY_ON_HTTP (HTTP node without retry configuration).
+ */
+export const noRetryStrategy = {
+    supportedCodes: ['NO_RETRY_ON_HTTP', 'L6_NO_RETRY_ON_HTTP'],
+    async suggest(issueCode, context) {
+        return {
+            fixable: true,
+            fix: {
+                action: 'add',
+                target: 'parameters.options',
+                to: {
+                    retry: {
+                        maxTries: 3,
+                        delay: 1000,
+                    },
+                },
+                explanation: 'Add retry configuration to handle transient network failures gracefully.',
+                confidence: 'high',
+            },
+            documentation_url: 'https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/',
+        };
+    },
+};
+//# sourceMappingURL=flow-fixes.js.map

package/dist/mcp/tools/fixes/flow-fixes.js.map

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

package/dist/mcp/tools/fixes/index.js

@@ -0,0 +1,91 @@
+/**
+ * Fix strategy registry for suggest_fix MCP tool.
+ *
+ * RAG-4.2.4: suggest_fix MCP tool
+ * Central registry for all fix strategies, organized by issue category.
+ *
+ * @module mcp/tools/fixes
+ */
+import { invalidParameterStrategy, missingParameterStrategy, wrongTypeStrategy, } from './parameter-fixes.js';
+import { unknownNodeStrategy, unknownOperationStrategy, deprecatedNodeStrategy, } from './node-fixes.js';
+import { noTriggerStrategy, unreachableNodeStrategy, deadEndNodeStrategy, multipleTriggersStrategy, circularConnectionStrategy, errorOutputStrategy, noRetryStrategy, } from './flow-fixes.js';
+import { unbalancedBracesStrategy, invalidExpressionStrategy, undefinedReferenceStrategy, hardcodedSecretStrategy, hardcodedUrlStrategy, } from './expression-fixes.js';
+/**
+ * All registered fix strategies.
+ */
+const strategies = [
+    // Parameter fixes
+    invalidParameterStrategy,
+    missingParameterStrategy,
+    wrongTypeStrategy,
+    // Node fixes
+    unknownNodeStrategy,
+    unknownOperationStrategy,
+    deprecatedNodeStrategy,
+    // Flow fixes
+    noTriggerStrategy,
+    unreachableNodeStrategy,
+    deadEndNodeStrategy,
+    multipleTriggersStrategy,
+    circularConnectionStrategy,
+    errorOutputStrategy,
+    noRetryStrategy,
+    // Expression fixes
+    unbalancedBracesStrategy,
+    invalidExpressionStrategy,
+    undefinedReferenceStrategy,
+    hardcodedSecretStrategy,
+    hardcodedUrlStrategy,
+];
+/**
+ * Map of issue codes to their handling strategies.
+ * Built from the strategies array for O(1) lookup.
+ */
+const strategyMap = new Map();
+// Populate the map
+for (const strategy of strategies) {
+    for (const code of strategy.supportedCodes) {
+        strategyMap.set(code.toUpperCase(), strategy);
+    }
+}
+/**
+ * Find a strategy that can handle the given issue code.
+ *
+ * @param issueCode - The validation issue code
+ * @returns The strategy or undefined if not found
+ */
+export function findStrategy(issueCode) {
+    return strategyMap.get(issueCode.toUpperCase());
+}
+/**
+ * Get a fix suggestion for a validation issue.
+ *
+ * @param issueCode - The validation issue code
+ * @param context - Optional context for targeted suggestions
+ * @returns Fix suggestion response
+ */
+export async function suggestFix(issueCode, context) {
+    const strategy = findStrategy(issueCode);
+    if (!strategy) {
+        return {
+            fixable: false,
+            alternative: `No automatic fix available for issue code '${issueCode}'. Please review the issue manually.`,
+        };
+    }
+    return strategy.suggest(issueCode, context);
+}
+/**
+ * Get all supported issue codes.
+ */
+export function getSupportedIssueCodes() {
+    return Array.from(strategyMap.keys());
+}
+/**
+ * Check if an issue code has a fix strategy.
+ */
+export function hasFixStrategy(issueCode) {
+    return strategyMap.has(issueCode.toUpperCase());
+}
+// Export individual strategies for testing
+export { invalidParameterStrategy, missingParameterStrategy, wrongTypeStrategy, unknownNodeStrategy, unknownOperationStrategy, deprecatedNodeStrategy, noTriggerStrategy, unreachableNodeStrategy, deadEndNodeStrategy, multipleTriggersStrategy, circularConnectionStrategy, errorOutputStrategy, noRetryStrategy, unbalancedBracesStrategy, invalidExpressionStrategy, undefinedReferenceStrategy, hardcodedSecretStrategy, hardcodedUrlStrategy, };
+//# sourceMappingURL=index.js.map

package/dist/mcp/tools/fixes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tools/fixes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAM/B;;GAEG;AACH,MAAM,UAAU,GAAkB;IAChC,kBAAkB;IAClB,wBAAwB;IACxB,wBAAwB;IACxB,iBAAiB;IAEjB,aAAa;IACb,mBAAmB;IACnB,wBAAwB;IACxB,sBAAsB;IAEtB,aAAa;IACb,iBAAiB;IACjB,uBAAuB;IACvB,mBAAmB;IACnB,wBAAwB;IACxB,0BAA0B;IAC1B,mBAAmB;IACnB,eAAe;IAEf,mBAAmB;IACnB,wBAAwB;IACxB,yBAAyB;IACzB,0BAA0B;IAC1B,uBAAuB;IACvB,oBAAoB;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,GAA6B,IAAI,GAAG,EAAE,CAAC;AAExD,mBAAmB;AACnB,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC3C,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,SAAiB,EACjB,OAAsB;IAEtB,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAEzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,8CAA8C,SAAS,sCAAsC;SAC3G,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,2CAA2C;AAC3C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,GACrB,CAAC"}

package/dist/mcp/tools/fixes/node-fixes.js

@@ -0,0 +1,233 @@
+/**
+ * Fix strategies for node-related validation issues.
+ *
+ * RAG-4.2.4: suggest_fix MCP tool
+ * Handles UNKNOWN_NODE, UNKNOWN_OPERATION, DEPRECATED_NODE
+ *
+ * @module mcp/tools/fixes/node-fixes
+ */
+import { getCatalogAdapter } from '../../adapters/index.js';
+/** Common node type corrections (package prefix issues) */
+const NODE_TYPE_CORRECTIONS = {
+    // Missing package prefix
+    slack: 'n8n-nodes-base.slack',
+    discord: 'n8n-nodes-base.discord',
+    telegram: 'n8n-nodes-base.telegram',
+    httpRequest: 'n8n-nodes-base.httpRequest',
+    webhook: 'n8n-nodes-base.webhook',
+    code: 'n8n-nodes-base.code',
+    'set': 'n8n-nodes-base.set',
+    'if': 'n8n-nodes-base.if',
+    'switch': 'n8n-nodes-base.switch',
+    merge: 'n8n-nodes-base.merge',
+    'function': 'n8n-nodes-base.function',
+    // Old/deprecated names
+    'n8n-nodes-base.spreadsheetFile': 'n8n-nodes-base.spreadsheet',
+    'n8n-nodes-base.googleSheet': 'n8n-nodes-base.googleSheets',
+    'n8n-nodes-base.mailSend': 'n8n-nodes-base.emailSend',
+};
+/** Common operation name corrections */
+const OPERATION_CORRECTIONS = {
+    'n8n-nodes-base.slack': {
+        sendMessage: 'postMessage',
+        send: 'postMessage',
+        createMessage: 'postMessage',
+        getMessages: 'getAll',
+        listChannels: 'getAll',
+    },
+    'n8n-nodes-base.googleSheets': {
+        read: 'read',
+        get: 'read',
+        write: 'append',
+        add: 'append',
+        update: 'update',
+    },
+    'n8n-nodes-base.httpRequest': {
+        request: 'GET',
+        fetch: 'GET',
+        post: 'POST',
+        put: 'PUT',
+        'delete': 'DELETE',
+    },
+};
+/**
+ * Calculate Levenshtein distance for typo detection.
+ */
+function levenshteinDistance(str1, str2) {
+    const s1 = str1.toLowerCase();
+    const s2 = str2.toLowerCase();
+    if (s1 === s2)
+        return 0;
+    if (s1.length === 0)
+        return s2.length;
+    if (s2.length === 0)
+        return s1.length;
+    let prevRow = Array.from({ length: s1.length + 1 }, (_, i) => i);
+    let currRow = new Array(s1.length + 1);
+    for (let i = 1; i <= s2.length; i++) {
+        currRow[0] = i;
+        for (let j = 1; j <= s1.length; j++) {
+            const cost = s2.charAt(i - 1) === s1.charAt(j - 1) ? 0 : 1;
+            currRow[j] = Math.min(prevRow[j] + 1, currRow[j - 1] + 1, prevRow[j - 1] + cost);
+        }
+        [prevRow, currRow] = [currRow, prevRow];
+    }
+    return prevRow[s1.length];
+}
+/**
+ * Find similar operations from catalog.
+ */
+async function findSimilarOperation(nodeType, invalidOperation) {
+    try {
+        const adapter = await getCatalogAdapter();
+        const operations = await adapter.listOperations(nodeType);
+        let bestMatch;
+        const maxDistance = 3;
+        for (const op of operations) {
+            const distance = levenshteinDistance(invalidOperation, op.operation_name);
+            if (distance <= maxDistance && (!bestMatch || distance < bestMatch.distance)) {
+                bestMatch = { name: op.operation_name, distance };
+            }
+        }
+        return bestMatch;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Strategy for UNKNOWN_NODE (node type doesn't exist).
+ */
+export const unknownNodeStrategy = {
+    supportedCodes: ['UNKNOWN_NODE', 'L2_UNKNOWN_NODE', 'L2_UNKNOWN_NODE_TYPE', 'UNKNOWN_NODE_TYPE'],
+    async suggest(issueCode, context) {
+        const nodeType = context?.node_type || '';
+        if (!nodeType) {
+            return {
+                fixable: false,
+                alternative: 'Provide the node type to get a fix suggestion.',
+            };
+        }
+        // Check for direct corrections
+        const correctedType = NODE_TYPE_CORRECTIONS[nodeType] || NODE_TYPE_CORRECTIONS[nodeType.toLowerCase()];
+        if (correctedType) {
+            return {
+                fixable: true,
+                fix: {
+                    action: 'replace_node',
+                    target: 'node.type',
+                    from: nodeType,
+                    to: correctedType,
+                    explanation: `Replace '${nodeType}' with '${correctedType}'. The node type was missing the package prefix or using an old name.`,
+                    confidence: 'high',
+                },
+            };
+        }
+        // Check if missing package prefix
+        if (!nodeType.includes('.')) {
+            const guessedType = `n8n-nodes-base.${nodeType}`;
+            return {
+                fixable: true,
+                fix: {
+                    action: 'replace_node',
+                    target: 'node.type',
+                    from: nodeType,
+                    to: guessedType,
+                    explanation: `Add package prefix 'n8n-nodes-base.' to the node type. n8n requires the full type identifier.`,
+                    confidence: 'medium',
+                },
+                documentation_url: 'https://docs.n8n.io/integrations/builtin/',
+            };
+        }
+        return {
+            fixable: false,
+            alternative: `The node type '${nodeType}' does not exist in the catalog. Check available nodes at https://n8n.io/integrations/`,
+            documentation_url: 'https://docs.n8n.io/integrations/builtin/',
+        };
+    },
+};
+/**
+ * Strategy for UNKNOWN_OPERATION (operation doesn't exist for node).
+ */
+export const unknownOperationStrategy = {
+    supportedCodes: ['UNKNOWN_OPERATION', 'L5_UNKNOWN_OPERATION', 'INVALID_OPERATION'],
+    async suggest(issueCode, context) {
+        const nodeType = context?.node_type || '';
+        const operation = context?.operation || '';
+        if (!operation) {
+            return {
+                fixable: false,
+                alternative: 'Provide the operation name to get a fix suggestion.',
+            };
+        }
+        // Check for known corrections
+        const nodeCorrections = OPERATION_CORRECTIONS[nodeType];
+        if (nodeCorrections?.[operation] || nodeCorrections?.[operation.toLowerCase()]) {
+            const correctedOp = nodeCorrections[operation] || nodeCorrections[operation.toLowerCase()];
+            return {
+                fixable: true,
+                fix: {
+                    action: 'change_value',
+                    target: 'parameters.operation',
+                    from: operation,
+                    to: correctedOp,
+                    explanation: `Change '${operation}' to '${correctedOp}'. This is the correct operation name for this node.`,
+                    confidence: 'high',
+                },
+            };
+        }
+        // Try fuzzy matching against catalog
+        if (nodeType) {
+            const match = await findSimilarOperation(nodeType, operation);
+            if (match) {
+                const confidence = match.distance === 1 ? 'high' : match.distance === 2 ? 'medium' : 'low';
+                return {
+                    fixable: true,
+                    fix: {
+                        action: 'change_value',
+                        target: 'parameters.operation',
+                        from: operation,
+                        to: match.name,
+                        explanation: `'${operation}' is not a valid operation. Did you mean '${match.name}'?`,
+                        confidence,
+                    },
+                };
+            }
+        }
+        return {
+            fixable: false,
+            alternative: `The operation '${operation}' does not exist for this node. Check the node documentation for available operations.`,
+            documentation_url: 'https://docs.n8n.io/integrations/builtin/',
+        };
+    },
+};
+/**
+ * Strategy for DEPRECATED_NODE.
+ */
+export const deprecatedNodeStrategy = {
+    supportedCodes: ['DEPRECATED_NODE', 'L2_DEPRECATED_NODE', 'DEPRECATED_NODE_TYPE'],
+    async suggest(issueCode, context) {
+        const nodeType = context?.node_type || '';
+        // Check for known replacements
+        const replacement = NODE_TYPE_CORRECTIONS[nodeType];
+        if (replacement) {
+            return {
+                fixable: true,
+                fix: {
+                    action: 'replace_node',
+                    target: 'node.type',
+                    from: nodeType,
+                    to: replacement,
+                    explanation: `The node '${nodeType}' is deprecated. Replace with '${replacement}'.`,
+                    confidence: 'high',
+                },
+            };
+        }
+        return {
+            fixable: false,
+            alternative: `The node '${nodeType}' is deprecated but no automatic replacement is available. Check the n8n changelog for migration guidance.`,
+            documentation_url: 'https://docs.n8n.io/breaking-changes/',
+        };
+    },
+};
+//# sourceMappingURL=node-fixes.js.map

package/dist/mcp/tools/fixes/node-fixes.js.map

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