n8n-mcp 2.7.15 → 2.7.20

package/dist/mcp/tool-docs/templates/list-node-templates.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const listNodeTemplatesDoc: ToolDocumentation;
+//# sourceMappingURL=list-node-templates.d.ts.map

package/dist/mcp/tool-docs/templates/list-node-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-node-templates.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/list-node-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,oBAAoB,EAAE,iBA2ElC,CAAC"}

package/dist/mcp/tool-docs/templates/list-node-templates.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listNodeTemplatesDoc = void 0;
+exports.listNodeTemplatesDoc = {
+    name: 'list_node_templates',
+    category: 'templates',
+    essentials: {
+        description: 'Find templates using specific nodes. 399 community workflows. Use FULL types: "n8n-nodes-base.httpRequest".',
+        keyParameters: ['nodeTypes', 'limit'],
+        example: 'list_node_templates({nodeTypes: ["n8n-nodes-base.slack"]})',
+        performance: 'Fast (<100ms) - indexed node search',
+        tips: [
+            'Must use FULL node type with package prefix: "n8n-nodes-base.slack"',
+            'Can search for multiple nodes to find workflows using all of them',
+            'Returns templates sorted by popularity (view count)'
+        ]
+    },
+    full: {
+        description: `Finds workflow templates that use specific n8n nodes. This is the best way to discover how particular nodes are used in real workflows. Search the community library of 399+ templates by specifying which nodes you want to see in action. Templates are sorted by popularity to show the most useful examples first.`,
+        parameters: {
+            nodeTypes: {
+                type: 'array',
+                required: true,
+                description: 'Array of node types to search for. Must use full type names with package prefix (e.g., ["n8n-nodes-base.httpRequest", "n8n-nodes-base.openAi"])'
+            },
+            limit: {
+                type: 'number',
+                required: false,
+                description: 'Maximum number of templates to return. Default 10, max 100'
+            }
+        },
+        returns: `Returns an object containing:
+- templates: Array of matching templates
+  - id: Template ID for retrieval
+  - name: Template name
+  - description: What the workflow does
+  - author: Creator details (name, username, verified)
+  - nodes: Complete list of nodes used
+  - views: View count (popularity metric)
+  - created: Creation date
+  - url: Link to template on n8n.io
+- totalFound: Total number of matching templates
+- tip: Usage hints if no results`,
+        examples: [
+            'list_node_templates({nodeTypes: ["n8n-nodes-base.slack"]}) - Find all Slack workflows',
+            'list_node_templates({nodeTypes: ["n8n-nodes-base.httpRequest", "n8n-nodes-base.postgres"]}) - Find workflows using both HTTP and Postgres',
+            'list_node_templates({nodeTypes: ["@n8n/n8n-nodes-langchain.openAi"], limit: 20}) - Find AI workflows with OpenAI',
+            'list_node_templates({nodeTypes: ["n8n-nodes-base.webhook", "n8n-nodes-base.respondToWebhook"]}) - Find webhook examples'
+        ],
+        useCases: [
+            'Learn how to use specific nodes through examples',
+            'Find workflows combining particular integrations',
+            'Discover patterns for node combinations',
+            'See real-world usage of complex nodes',
+            'Find templates for your exact tech stack'
+        ],
+        performance: `Optimized for node-based searches:
+- Indexed by node type for fast lookups
+- Query time: <50ms for single node
+- Multiple nodes: <100ms (uses AND logic)
+- Returns pre-sorted by popularity
+- No full-text search needed`,
+        bestPractices: [
+            'Always use full node type with package prefix',
+            'Search for core nodes that define the workflow purpose',
+            'Start with single node searches, then refine',
+            'Check node types with list_nodes if unsure of names',
+            'Review multiple templates to learn different approaches'
+        ],
+        pitfalls: [
+            'Node types must match exactly - no partial matches',
+            'Package prefix required: "slack" won\'t work, use "n8n-nodes-base.slack"',
+            'Some nodes have version numbers: "n8n-nodes-base.httpRequestV3"',
+            'Templates may use old node versions not in current n8n',
+            'AND logic means all specified nodes must be present'
+        ],
+        relatedTools: ['get_template', 'search_templates', 'get_templates_for_task', 'list_nodes']
+    }
+};
+//# sourceMappingURL=list-node-templates.js.map

package/dist/mcp/tool-docs/templates/list-node-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-node-templates.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/list-node-templates.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,6GAA6G;QAC1H,aAAa,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;QACrC,OAAO,EAAE,4DAA4D;QACrE,WAAW,EAAE,qCAAqC;QAClD,IAAI,EAAE;YACJ,qEAAqE;YACrE,mEAAmE;YACnE,qDAAqD;SACtD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,wTAAwT;QACrU,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,iJAAiJ;aAC/J;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,4DAA4D;aAC1E;SACF;QACD,OAAO,EAAE;;;;;;;;;;;iCAWoB;QAC7B,QAAQ,EAAE;YACR,uFAAuF;YACvF,2IAA2I;YAC3I,kHAAkH;YAClH,yHAAyH;SAC1H;QACD,QAAQ,EAAE;YACR,kDAAkD;YAClD,kDAAkD;YAClD,yCAAyC;YACzC,uCAAuC;YACvC,0CAA0C;SAC3C;QACD,WAAW,EAAE;;;;;6BAKY;QACzB,aAAa,EAAE;YACb,+CAA+C;YAC/C,wDAAwD;YACxD,8CAA8C;YAC9C,qDAAqD;YACrD,yDAAyD;SAC1D;QACD,QAAQ,EAAE;YACR,oDAAoD;YACpD,0EAA0E;YAC1E,iEAAiE;YACjE,wDAAwD;YACxD,qDAAqD;SACtD;QACD,YAAY,EAAE,CAAC,cAAc,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,YAAY,CAAC;KAC3F;CACF,CAAC"}

package/dist/mcp/tool-docs/templates/list-tasks.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const listTasksDoc: ToolDocumentation;
+//# sourceMappingURL=list-tasks.d.ts.map

package/dist/mcp/tool-docs/templates/list-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tasks.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/list-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,YAAY,EAAE,iBA2C1B,CAAC"}

package/dist/mcp/tool-docs/templates/list-tasks.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listTasksDoc = void 0;
+exports.listTasksDoc = {
+    name: 'list_tasks',
+    category: 'templates',
+    essentials: {
+        description: 'List task templates by category: HTTP/API, Webhooks, Database, AI, Data Processing, Communication.',
+        keyParameters: ['category'],
+        example: 'list_tasks({category: "HTTP/API"})',
+        performance: 'Instant',
+        tips: [
+            'Categories: HTTP/API, Webhooks, Database, AI',
+            'Shows pre-configured node settings',
+            'Use get_node_for_task for details'
+        ]
+    },
+    full: {
+        description: 'Lists available task templates organized by category. Each task represents a common automation pattern with pre-configured node settings. Categories include HTTP/API, Webhooks, Database, AI, Data Processing, and Communication.',
+        parameters: {
+            category: { type: 'string', description: 'Filter by category (optional)' }
+        },
+        returns: 'Array of tasks with name, category, description, nodeType',
+        examples: [
+            'list_tasks() - Get all task templates',
+            'list_tasks({category: "Database"}) - Database-related tasks',
+            'list_tasks({category: "AI"}) - AI automation tasks'
+        ],
+        useCases: [
+            'Discover common automation patterns',
+            'Find pre-configured solutions',
+            'Learn node usage patterns',
+            'Quick workflow setup'
+        ],
+        performance: 'Instant - Static task list',
+        bestPractices: [
+            'Browse all categories first',
+            'Use get_node_for_task for config',
+            'Combine multiple tasks in workflows'
+        ],
+        pitfalls: [
+            'Tasks are templates, customize as needed',
+            'Not all nodes have task templates'
+        ],
+        relatedTools: ['get_node_for_task', 'search_templates', 'get_templates_for_task']
+    }
+};
+//# sourceMappingURL=list-tasks.js.map

package/dist/mcp/tool-docs/templates/list-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tasks.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/list-tasks.ts"],"names":[],"mappings":";;;AAEa,QAAA,YAAY,GAAsB;IAC7C,IAAI,EAAE,YAAY;IAClB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,oGAAoG;QACjH,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,oCAAoC;QAC7C,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE;YACJ,8CAA8C;YAC9C,oCAAoC;YACpC,mCAAmC;SACpC;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,oOAAoO;QACjP,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;SAC3E;QACD,OAAO,EAAE,2DAA2D;QACpE,QAAQ,EAAE;YACR,uCAAuC;YACvC,6DAA6D;YAC7D,oDAAoD;SACrD;QACD,QAAQ,EAAE;YACR,qCAAqC;YACrC,+BAA+B;YAC/B,2BAA2B;YAC3B,sBAAsB;SACvB;QACD,WAAW,EAAE,4BAA4B;QACzC,aAAa,EAAE;YACb,6BAA6B;YAC7B,kCAAkC;YAClC,qCAAqC;SACtC;QACD,QAAQ,EAAE;YACR,0CAA0C;YAC1C,mCAAmC;SACpC;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,wBAAwB,CAAC;KAClF;CACF,CAAC"}

package/dist/mcp/tool-docs/templates/search-templates.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const searchTemplatesDoc: ToolDocumentation;
+//# sourceMappingURL=search-templates.d.ts.map

package/dist/mcp/tool-docs/templates/search-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-templates.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/search-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,kBAAkB,EAAE,iBA8EhC,CAAC"}

package/dist/mcp/tool-docs/templates/search-templates.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchTemplatesDoc = void 0;
+exports.searchTemplatesDoc = {
+    name: 'search_templates',
+    category: 'templates',
+    essentials: {
+        description: 'Search templates by name/description keywords. NOT for node types! For nodes use list_node_templates. Example: "chatbot".',
+        keyParameters: ['query', 'limit'],
+        example: 'search_templates({query: "chatbot"})',
+        performance: 'Fast (<100ms) - FTS5 full-text search',
+        tips: [
+            'Searches template names and descriptions, NOT node types',
+            'Use keywords like "automation", "sync", "notification"',
+            'For node-specific search, use list_node_templates instead'
+        ]
+    },
+    full: {
+        description: `Performs full-text search across workflow template names and descriptions. This tool is ideal for finding workflows based on their purpose or functionality rather than specific nodes used. It searches through the community library of 399+ templates using SQLite FTS5 for fast, fuzzy matching.`,
+        parameters: {
+            query: {
+                type: 'string',
+                required: true,
+                description: 'Search query for template names/descriptions. NOT for node types! Examples: "chatbot", "automation", "social media", "webhook". For node-based search use list_node_templates instead.'
+            },
+            limit: {
+                type: 'number',
+                required: false,
+                description: 'Maximum number of results. Default 20, max 100'
+            }
+        },
+        returns: `Returns an object containing:
+- templates: Array of matching templates sorted by relevance
+  - id: Template ID for retrieval
+  - name: Template name (with match highlights)
+  - description: What the workflow does
+  - author: Creator information
+  - nodes: Array of all nodes used
+  - views: Popularity metric
+  - created: Creation date
+  - url: Link to template
+  - relevanceScore: Search match score
+- totalFound: Total matching templates
+- searchQuery: The processed search query
+- tip: Helpful hints if no results`,
+        examples: [
+            'search_templates({query: "chatbot"}) - Find chatbot and conversational AI workflows',
+            'search_templates({query: "email notification"}) - Find email alert workflows',
+            'search_templates({query: "data sync"}) - Find data synchronization workflows',
+            'search_templates({query: "webhook automation", limit: 30}) - Find webhook-based automations',
+            'search_templates({query: "social media scheduler"}) - Find social posting workflows'
+        ],
+        useCases: [
+            'Find workflows by business purpose',
+            'Discover automations for specific use cases',
+            'Search by workflow functionality',
+            'Find templates by problem they solve',
+            'Explore workflows by industry or domain'
+        ],
+        performance: `Excellent performance with FTS5 indexing:
+- Full-text search: <50ms for most queries
+- Fuzzy matching enabled for typos
+- Relevance-based sorting included
+- Searches both title and description
+- Returns highlighted matches`,
+        bestPractices: [
+            'Use descriptive keywords about the workflow purpose',
+            'Try multiple related terms if first search has few results',
+            'Combine terms for more specific results',
+            'Check both name and description in results',
+            'Use quotes for exact phrase matching'
+        ],
+        pitfalls: [
+            'Does NOT search by node types - use list_node_templates',
+            'Search is case-insensitive but not semantic',
+            'Very specific terms may return no results',
+            'Descriptions may be brief - check full template',
+            'Relevance scoring may not match your expectations'
+        ],
+        relatedTools: ['list_node_templates', 'get_templates_for_task', 'get_template', 'search_nodes']
+    }
+};
+//# sourceMappingURL=search-templates.js.map

package/dist/mcp/tool-docs/templates/search-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-templates.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/search-templates.ts"],"names":[],"mappings":";;;AAEa,QAAA,kBAAkB,GAAsB;IACnD,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,2HAA2H;QACxI,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;QACjC,OAAO,EAAE,sCAAsC;QAC/C,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE;YACJ,0DAA0D;YAC1D,wDAAwD;YACxD,2DAA2D;SAC5D;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,sSAAsS;QACnT,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,wLAAwL;aACtM;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,OAAO,EAAE;;;;;;;;;;;;;mCAasB;QAC/B,QAAQ,EAAE;YACR,qFAAqF;YACrF,8EAA8E;YAC9E,8EAA8E;YAC9E,6FAA6F;YAC7F,qFAAqF;SACtF;QACD,QAAQ,EAAE;YACR,oCAAoC;YACpC,6CAA6C;YAC7C,kCAAkC;YAClC,sCAAsC;YACtC,yCAAyC;SAC1C;QACD,WAAW,EAAE;;;;;8BAKa;QAC1B,aAAa,EAAE;YACb,qDAAqD;YACrD,4DAA4D;YAC5D,yCAAyC;YACzC,4CAA4C;YAC5C,sCAAsC;SACvC;QACD,QAAQ,EAAE;YACR,yDAAyD;YACzD,6CAA6C;YAC7C,2CAA2C;YAC3C,iDAAiD;YACjD,mDAAmD;SACpD;QACD,YAAY,EAAE,CAAC,qBAAqB,EAAE,wBAAwB,EAAE,cAAc,EAAE,cAAc,CAAC;KAChG;CACF,CAAC"}

package/dist/mcp/tool-docs/types.d.ts

@@ -0,0 +1,30 @@
+export interface ToolDocumentation {
+    name: string;
+    category: string;
+    essentials: {
+        description: string;
+        keyParameters: string[];
+        example: string;
+        performance: string;
+        tips: string[];
+    };
+    full: {
+        description: string;
+        parameters: Record<string, {
+            type: string;
+            description: string;
+            required?: boolean;
+            default?: any;
+            examples?: string[];
+            enum?: string[];
+        }>;
+        returns: string;
+        examples: string[];
+        useCases: string[];
+        performance: string;
+        bestPractices: string[];
+        pitfalls: string[];
+        relatedTools: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/tool-docs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp/tool-docs/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YACzB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,GAAG,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH"}

package/dist/mcp/tool-docs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/mcp/tool-docs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp/tool-docs/types.ts"],"names":[],"mappings":""}

package/dist/mcp/tool-docs/validation/index.d.ts

@@ -0,0 +1,6 @@
+export { validateNodeMinimalDoc } from './validate-node-minimal';
+export { validateNodeOperationDoc } from './validate-node-operation';
+export { validateWorkflowDoc } from './validate-workflow';
+export { validateWorkflowConnectionsDoc } from './validate-workflow-connections';
+export { validateWorkflowExpressionsDoc } from './validate-workflow-expressions';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/tool-docs/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/mcp/tool-docs/validation/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWorkflowExpressionsDoc = exports.validateWorkflowConnectionsDoc = exports.validateWorkflowDoc = exports.validateNodeOperationDoc = exports.validateNodeMinimalDoc = void 0;
+var validate_node_minimal_1 = require("./validate-node-minimal");
+Object.defineProperty(exports, "validateNodeMinimalDoc", { enumerable: true, get: function () { return validate_node_minimal_1.validateNodeMinimalDoc; } });
+var validate_node_operation_1 = require("./validate-node-operation");
+Object.defineProperty(exports, "validateNodeOperationDoc", { enumerable: true, get: function () { return validate_node_operation_1.validateNodeOperationDoc; } });
+var validate_workflow_1 = require("./validate-workflow");
+Object.defineProperty(exports, "validateWorkflowDoc", { enumerable: true, get: function () { return validate_workflow_1.validateWorkflowDoc; } });
+var validate_workflow_connections_1 = require("./validate-workflow-connections");
+Object.defineProperty(exports, "validateWorkflowConnectionsDoc", { enumerable: true, get: function () { return validate_workflow_connections_1.validateWorkflowConnectionsDoc; } });
+var validate_workflow_expressions_1 = require("./validate-workflow-expressions");
+Object.defineProperty(exports, "validateWorkflowExpressionsDoc", { enumerable: true, get: function () { return validate_workflow_expressions_1.validateWorkflowExpressionsDoc; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/tool-docs/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/index.ts"],"names":[],"mappings":";;;AAAA,iEAAiE;AAAxD,+HAAA,sBAAsB,OAAA;AAC/B,qEAAqE;AAA5D,mIAAA,wBAAwB,OAAA;AACjC,yDAA0D;AAAjD,wHAAA,mBAAmB,OAAA;AAC5B,iFAAiF;AAAxE,+IAAA,8BAA8B,OAAA;AACvC,iFAAiF;AAAxE,+IAAA,8BAA8B,OAAA"}

package/dist/mcp/tool-docs/validation/validate-node-minimal.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const validateNodeMinimalDoc: ToolDocumentation;
+//# sourceMappingURL=validate-node-minimal.d.ts.map

package/dist/mcp/tool-docs/validation/validate-node-minimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-node-minimal.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-node-minimal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,sBAAsB,EAAE,iBA4CpC,CAAC"}

package/dist/mcp/tool-docs/validation/validate-node-minimal.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNodeMinimalDoc = void 0;
+exports.validateNodeMinimalDoc = {
+    name: 'validate_node_minimal',
+    category: 'validation',
+    essentials: {
+        description: 'Fast check for missing required fields only. No warnings/suggestions. Returns: list of missing fields.',
+        keyParameters: ['nodeType', 'config'],
+        example: 'validate_node_minimal("nodes-base.slack", {resource: "message"})',
+        performance: 'Instant',
+        tips: [
+            'Returns only missing required fields',
+            'No warnings or suggestions',
+            'Perfect for real-time validation'
+        ]
+    },
+    full: {
+        description: 'Minimal validation that only checks for missing required fields. Returns array of missing field names without any warnings or suggestions. Ideal for quick validation during node configuration.',
+        parameters: {
+            nodeType: { type: 'string', required: true, description: 'Node type with prefix (e.g., "nodes-base.slack")' },
+            config: { type: 'object', required: true, description: 'Node configuration to validate' }
+        },
+        returns: 'Array of missing required field names (empty if valid)',
+        examples: [
+            'validate_node_minimal("nodes-base.slack", {resource: "message", operation: "post"}) - Check Slack config',
+            'validate_node_minimal("nodes-base.httpRequest", {method: "GET"}) - Check HTTP config'
+        ],
+        useCases: [
+            'Real-time form validation',
+            'Quick configuration checks',
+            'Pre-deployment validation',
+            'Interactive configuration builders'
+        ],
+        performance: 'Instant - Simple field checking without complex validation',
+        bestPractices: [
+            'Use for quick feedback loops',
+            'Follow with validate_node_operation for thorough check',
+            'Check return array length for validity'
+        ],
+        pitfalls: [
+            'Only checks required fields',
+            'No type validation',
+            'No operation-specific validation'
+        ],
+        relatedTools: ['validate_node_operation', 'get_node_essentials', 'get_property_dependencies']
+    }
+};
+//# sourceMappingURL=validate-node-minimal.js.map

package/dist/mcp/tool-docs/validation/validate-node-minimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-node-minimal.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-node-minimal.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAsB;IACvD,IAAI,EAAE,uBAAuB;IAC7B,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE;QACV,WAAW,EAAE,wGAAwG;QACrH,aAAa,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;QACrC,OAAO,EAAE,kEAAkE;QAC3E,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE;YACJ,sCAAsC;YACtC,4BAA4B;YAC5B,kCAAkC;SACnC;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,kMAAkM;QAC/M,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kDAAkD,EAAE;YAC7G,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC1F;QACD,OAAO,EAAE,wDAAwD;QACjE,QAAQ,EAAE;YACR,0GAA0G;YAC1G,sFAAsF;SACvF;QACD,QAAQ,EAAE;YACR,2BAA2B;YAC3B,4BAA4B;YAC5B,2BAA2B;YAC3B,oCAAoC;SACrC;QACD,WAAW,EAAE,4DAA4D;QACzE,aAAa,EAAE;YACb,8BAA8B;YAC9B,wDAAwD;YACxD,wCAAwC;SACzC;QACD,QAAQ,EAAE;YACR,6BAA6B;YAC7B,oBAAoB;YACpB,kCAAkC;SACnC;QACD,YAAY,EAAE,CAAC,yBAAyB,EAAE,qBAAqB,EAAE,2BAA2B,CAAC;KAC9F;CACF,CAAC"}

package/dist/mcp/tool-docs/validation/validate-node-operation.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const validateNodeOperationDoc: ToolDocumentation;
+//# sourceMappingURL=validate-node-operation.d.ts.map

package/dist/mcp/tool-docs/validation/validate-node-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-node-operation.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-node-operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBAyFtC,CAAC"}

package/dist/mcp/tool-docs/validation/validate-node-operation.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNodeOperationDoc = void 0;
+exports.validateNodeOperationDoc = {
+    name: 'validate_node_operation',
+    category: 'validation',
+    essentials: {
+        description: 'Validates node configuration with operation awareness. Checks required fields, data types, and operation-specific rules. Returns specific errors with automated fix suggestions. Different profiles for different validation needs.',
+        keyParameters: ['nodeType', 'config', 'profile'],
+        example: 'validate_node_operation({nodeType: "nodes-base.slack", config: {resource: "message", operation: "post", text: "Hi"}})',
+        performance: '<100ms',
+        tips: [
+            'Profile choices: minimal (editing), runtime (execution), ai-friendly (balanced), strict (deployment)',
+            'Returns fixes you can apply directly',
+            'Operation-aware - knows Slack post needs text'
+        ]
+    },
+    full: {
+        description: 'Comprehensive node configuration validation that understands operation context. For example, it knows Slack message posting requires text field, while channel listing doesn\'t. Provides different validation profiles for different stages of workflow development.',
+        parameters: {
+            nodeType: { type: 'string', required: true, description: 'Full node type with prefix: "nodes-base.slack", "nodes-base.httpRequest"' },
+            config: { type: 'object', required: true, description: 'Node configuration. Must include operation fields (resource/operation/action) if the node has multiple operations' },
+            profile: { type: 'string', required: false, description: 'Validation profile - controls what\'s checked. Default: "ai-friendly"' }
+        },
+        returns: `Object containing:
+{
+  "isValid": false,
+  "errors": [
+    {
+      "field": "channel",
+      "message": "Required field 'channel' is missing",
+      "severity": "error",
+      "fix": "#general"
+    }
+  ],
+  "warnings": [
+    {
+      "field": "retryOnFail", 
+      "message": "Consider enabling retry for reliability",
+      "severity": "warning",
+      "fix": true
+    }
+  ],
+  "suggestions": [
+    {
+      "field": "timeout",
+      "message": "Set timeout to prevent hanging",
+      "fix": 30000
+    }
+  ],
+  "fixes": {
+    "channel": "#general",
+    "retryOnFail": true,
+    "timeout": 30000
+  }
+}`,
+        examples: [
+            '// Missing required field',
+            'validate_node_operation({nodeType: "nodes-base.slack", config: {resource: "message", operation: "post"}})',
+            '// Returns: {isValid: false, errors: [{field: "text", message: "Required field missing"}], fixes: {text: "Message text"}}',
+            '',
+            '// Validate with strict profile for production',
+            'validate_node_operation({nodeType: "nodes-base.httpRequest", config: {method: "POST", url: "https://api.example.com"}, profile: "strict"})',
+            '',
+            '// Apply fixes automatically',
+            'const result = validate_node_operation({nodeType: "nodes-base.slack", config: myConfig});',
+            'if (!result.isValid) {',
+            '  myConfig = {...myConfig, ...result.fixes};',
+            '}'
+        ],
+        useCases: [
+            'Validate configuration before workflow execution',
+            'Debug why a node isn\'t working as expected',
+            'Generate configuration fixes automatically',
+            'Different validation for editing vs production'
+        ],
+        performance: '<100ms for most nodes, <200ms for complex nodes with many conditions',
+        bestPractices: [
+            'Use "minimal" profile during user editing for fast feedback',
+            'Use "runtime" profile (default) before execution',
+            'Use "ai-friendly" when AI configures nodes',
+            'Use "strict" profile before production deployment',
+            'Always include operation fields (resource/operation) in config',
+            'Apply suggested fixes to resolve issues quickly'
+        ],
+        pitfalls: [
+            'Must include operation fields for multi-operation nodes',
+            'Fixes are suggestions - review before applying',
+            'Profile affects what\'s validated - minimal skips many checks'
+        ],
+        relatedTools: ['validate_node_minimal for quick checks', 'get_node_essentials for valid examples', 'validate_workflow for complete workflow validation']
+    }
+};
+//# sourceMappingURL=validate-node-operation.js.map

package/dist/mcp/tool-docs/validation/validate-node-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-node-operation.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-node-operation.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,IAAI,EAAE,yBAAyB;IAC/B,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE;QACV,WAAW,EAAE,qOAAqO;QAClP,aAAa,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;QAChD,OAAO,EAAE,uHAAuH;QAChI,WAAW,EAAE,QAAQ;QACrB,IAAI,EAAE;YACJ,sGAAsG;YACtG,sCAAsC;YACtC,+CAA+C;SAChD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,uQAAuQ;QACpR,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0EAA0E,EAAE;YACrI,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mHAAmH,EAAE;YAC5K,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,uEAAuE,EAAE;SACnI;QACD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BX;QACE,QAAQ,EAAE;YACR,2BAA2B;YAC3B,2GAA2G;YAC3G,2HAA2H;YAC3H,EAAE;YACF,gDAAgD;YAChD,4IAA4I;YAC5I,EAAE;YACF,8BAA8B;YAC9B,2FAA2F;YAC3F,wBAAwB;YACxB,8CAA8C;YAC9C,GAAG;SACJ;QACD,QAAQ,EAAE;YACR,kDAAkD;YAClD,6CAA6C;YAC7C,4CAA4C;YAC5C,gDAAgD;SACjD;QACD,WAAW,EAAE,sEAAsE;QACnF,aAAa,EAAE;YACb,6DAA6D;YAC7D,kDAAkD;YAClD,4CAA4C;YAC5C,mDAAmD;YACnD,gEAAgE;YAChE,iDAAiD;SAClD;QACD,QAAQ,EAAE;YACR,yDAAyD;YACzD,gDAAgD;YAChD,+DAA+D;SAChE;QACD,YAAY,EAAE,CAAC,wCAAwC,EAAE,wCAAwC,EAAE,oDAAoD,CAAC;KACzJ;CACF,CAAC"}

package/dist/mcp/tool-docs/validation/validate-workflow-connections.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const validateWorkflowConnectionsDoc: ToolDocumentation;
+//# sourceMappingURL=validate-workflow-connections.d.ts.map

package/dist/mcp/tool-docs/validation/validate-workflow-connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow-connections.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow-connections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,8BAA8B,EAAE,iBAqD5C,CAAC"}

package/dist/mcp/tool-docs/validation/validate-workflow-connections.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWorkflowConnectionsDoc = void 0;
+exports.validateWorkflowConnectionsDoc = {
+    name: 'validate_workflow_connections',
+    category: 'validation',
+    essentials: {
+        description: 'Check workflow connections only: valid nodes, no cycles, proper triggers, AI tool links. Fast structure validation.',
+        keyParameters: ['workflow'],
+        example: 'validate_workflow_connections({workflow: {nodes: [...], connections: {...}}})',
+        performance: 'Fast (<100ms)',
+        tips: [
+            'Use for quick structure checks when editing connections',
+            'Detects orphaned nodes and circular dependencies',
+            'Validates AI Agent tool connections to ensure proper node references'
+        ]
+    },
+    full: {
+        description: 'Validates only the connection structure of a workflow without checking node configurations or expressions. This focused validation checks that all referenced nodes exist, detects circular dependencies, ensures proper trigger node placement, validates AI tool connections, and identifies orphaned or unreachable nodes.',
+        parameters: {
+            workflow: {
+                type: 'object',
+                required: true,
+                description: 'The workflow JSON with nodes array and connections object.'
+            }
+        },
+        returns: 'Object with valid (boolean), errors (array), warnings (array), and statistics about connections',
+        examples: [
+            'validate_workflow_connections({workflow: myWorkflow}) - Check all connections',
+            'validate_workflow_connections({workflow: {nodes: [...], connections: {...}}}) - Validate structure only'
+        ],
+        useCases: [
+            'Quick validation when modifying workflow connections',
+            'Ensure all node references in connections are valid',
+            'Detect circular dependencies that would cause infinite loops',
+            'Validate AI Agent nodes have proper tool connections',
+            'Check workflow has at least one trigger node',
+            'Find orphaned nodes not connected to any flow'
+        ],
+        performance: 'Fast (<100ms). Only validates structure, not node content. Scales linearly with connection count.',
+        bestPractices: [
+            'Run after adding or removing connections',
+            'Use before validate_workflow for quick structural checks',
+            'Check for warnings about orphaned nodes',
+            'Ensure trigger nodes are properly positioned',
+            'Validate after using n8n_update_partial_workflow with connection operations'
+        ],
+        pitfalls: [
+            'Does not validate node configurations - use validate_workflow for full validation',
+            'Cannot detect logical errors in connection flow',
+            'Some valid workflows may have intentionally disconnected nodes',
+            'Circular dependency detection only catches direct loops',
+            'Does not validate connection types match node capabilities'
+        ],
+        relatedTools: ['validate_workflow', 'validate_workflow_expressions', 'n8n_update_partial_workflow']
+    }
+};
+//# sourceMappingURL=validate-workflow-connections.js.map

package/dist/mcp/tool-docs/validation/validate-workflow-connections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow-connections.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow-connections.ts"],"names":[],"mappings":";;;AAEa,QAAA,8BAA8B,GAAsB;IAC/D,IAAI,EAAE,+BAA+B;IACrC,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE;QACV,WAAW,EAAE,qHAAqH;QAClI,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,+EAA+E;QACxF,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE;YACJ,yDAAyD;YACzD,kDAAkD;YAClD,sEAAsE;SACvE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,+TAA+T;QAC5U,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4DAA4D;aAC1E;SACF;QACD,OAAO,EAAE,iGAAiG;QAC1G,QAAQ,EAAE;YACR,+EAA+E;YAC/E,yGAAyG;SAC1G;QACD,QAAQ,EAAE;YACR,sDAAsD;YACtD,qDAAqD;YACrD,8DAA8D;YAC9D,sDAAsD;YACtD,8CAA8C;YAC9C,+CAA+C;SAChD;QACD,WAAW,EAAE,mGAAmG;QAChH,aAAa,EAAE;YACb,0CAA0C;YAC1C,0DAA0D;YAC1D,yCAAyC;YACzC,8CAA8C;YAC9C,6EAA6E;SAC9E;QACD,QAAQ,EAAE;YACR,mFAAmF;YACnF,iDAAiD;YACjD,gEAAgE;YAChE,yDAAyD;YACzD,4DAA4D;SAC7D;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,+BAA+B,EAAE,6BAA6B,CAAC;KACpG;CACF,CAAC"}

package/dist/mcp/tool-docs/validation/validate-workflow-expressions.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const validateWorkflowExpressionsDoc: ToolDocumentation;
+//# sourceMappingURL=validate-workflow-expressions.d.ts.map

package/dist/mcp/tool-docs/validation/validate-workflow-expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow-expressions.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow-expressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,8BAA8B,EAAE,iBAqD5C,CAAC"}