n8n-atom-mcp 0.0.1

package/dist/mcp/tools-file-operations.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { N8nApiClient } from '../services/n8n-api-client';
+export declare const n8n_import_workflow_file: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        fileContent: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        activate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        fileContent: string;
+        activate: boolean;
+        name?: string | undefined;
+    }, {
+        fileContent: string;
+        name?: string | undefined;
+        activate?: boolean | undefined;
+    }>;
+};
+export declare function handleImportWorkflowFile(args: z.infer<typeof n8n_import_workflow_file.inputSchema>, apiClient: N8nApiClient): Promise<{
+    workflowId: string | undefined;
+    name: string;
+    nodes: number;
+    credentialsRequired: string[];
+    active: boolean | undefined;
+    message: string;
+}>;
+export declare const n8n_export_workflow_file: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        workflowId: z.ZodString;
+        includeCredentials: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["json", "pretty"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        workflowId: string;
+        includeCredentials: boolean;
+        format: "json" | "pretty";
+    }, {
+        workflowId: string;
+        includeCredentials?: boolean | undefined;
+        format?: "json" | "pretty" | undefined;
+    }>;
+};
+export declare function handleExportWorkflowFile(args: z.infer<typeof n8n_export_workflow_file.inputSchema>, apiClient: N8nApiClient): Promise<{
+    fileContent: string;
+    workflow: {
+        id: string | undefined;
+        name: string;
+        nodes: number;
+        active: boolean | undefined;
+    };
+    metadata: {
+        exportedAt: string;
+        fileSize: number;
+        credentialsIncluded: boolean;
+    };
+}>;
+export declare const n8n_sync_workflow: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        workflowId: z.ZodString;
+        fileContent: z.ZodString;
+        direction: z.ZodEnum<["file_to_server", "server_to_file", "compare"]>;
+    }, "strip", z.ZodTypeAny, {
+        workflowId: string;
+        fileContent: string;
+        direction: "file_to_server" | "server_to_file" | "compare";
+    }, {
+        workflowId: string;
+        fileContent: string;
+        direction: "file_to_server" | "server_to_file" | "compare";
+    }>;
+};
+export declare function handleSyncWorkflow(args: z.infer<typeof n8n_sync_workflow.inputSchema>, apiClient: N8nApiClient): Promise<{
+    workflowId: string;
+    direction: string;
+    changes: import("../types/workflow-comparison").WorkflowChange[];
+    summary: {
+        nodesAdded: number;
+        nodesRemoved: number;
+        nodesModified: number;
+        connectionChanges: number;
+        hasConflicts: boolean;
+    };
+    lastModified: {
+        server: string | undefined;
+        file: string;
+    };
+    synced?: undefined;
+    workflow?: undefined;
+    message?: undefined;
+    fileContent?: undefined;
+} | {
+    workflowId: string;
+    direction: string;
+    synced: boolean;
+    workflow: {
+        id: string | undefined;
+        name: string;
+        nodes: number;
+        updatedAt: string | undefined;
+    };
+    message: string;
+    changes?: undefined;
+    summary?: undefined;
+    lastModified?: undefined;
+    fileContent?: undefined;
+} | {
+    workflowId: string;
+    direction: string;
+    synced: boolean;
+    fileContent: string;
+    workflow: {
+        id: string | undefined;
+        name: string;
+        nodes: number;
+        updatedAt: string | undefined;
+    };
+    message: string;
+    changes?: undefined;
+    summary?: undefined;
+    lastModified?: undefined;
+}>;
+export declare const n8n_validate_workflow_file: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        fileContent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        fileContent: string;
+    }, {
+        fileContent: string;
+    }>;
+};
+export declare function handleValidateWorkflowFile(args: z.infer<typeof n8n_validate_workflow_file.inputSchema>): Promise<{
+    valid: boolean;
+    error: string;
+    workflow?: undefined;
+    warnings?: undefined;
+    version?: undefined;
+} | {
+    valid: boolean;
+    workflow: {
+        name: string;
+        nodes: number;
+        connections: number;
+    };
+    warnings: string[];
+    version: string;
+    error?: undefined;
+}>;
+//# sourceMappingURL=tools-file-operations.d.ts.map

package/dist/mcp/tools-file-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-file-operations.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-file-operations.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAW1D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;CAQpC,CAAC;AAEF,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,WAAW,CAAC,EAC1D,SAAS,EAAE,YAAY;;;;;;;GAwC1B;AAMD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;CAQpC,CAAC;AAEF,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,WAAW,CAAC,EAC1D,SAAS,EAAE,YAAY;;;;;;;;;;;;;GAmC1B;AAMD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;CAU7B,CAAC;AAEF,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,WAAW,CAAC,EACnD,SAAS,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuF1B;AAMD,eAAO,MAAM,0BAA0B;;;;;;;;;;CAMtC,CAAC;AAEF,wBAAsB,0BAA0B,CAC5C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;GAuC/D"}

package/dist/mcp/tools-file-operations.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8n_validate_workflow_file = exports.n8n_sync_workflow = exports.n8n_export_workflow_file = exports.n8n_import_workflow_file = void 0;
+exports.handleImportWorkflowFile = handleImportWorkflowFile;
+exports.handleExportWorkflowFile = handleExportWorkflowFile;
+exports.handleSyncWorkflow = handleSyncWorkflow;
+exports.handleValidateWorkflowFile = handleValidateWorkflowFile;
+const zod_1 = require("zod");
+const n8n_file_format_1 = require("../services/n8n-file-format");
+const logger_1 = require("../utils/logger");
+const workflow_comparison_1 = require("../services/workflow-comparison");
+const logger = new logger_1.Logger({ prefix: '[FileOperations]' });
+exports.n8n_import_workflow_file = {
+    name: 'n8n_import_workflow_file',
+    description: 'Import a workflow from .n8n file content. The file will be parsed and uploaded to the n8n instance.',
+    inputSchema: zod_1.z.object({
+        fileContent: zod_1.z.string().describe('Raw .n8n file content (JSON string)'),
+        name: zod_1.z.string().optional().describe('Override workflow name'),
+        activate: zod_1.z.boolean().optional().default(false).describe('Activate workflow after import'),
+    }),
+};
+async function handleImportWorkflowFile(args, apiClient) {
+    try {
+        const { fileContent, name, activate } = args;
+        const workflow = n8n_file_format_1.N8nFileFormatService.importWorkflow(fileContent, {
+            name,
+            activate,
+        });
+        const createdWorkflow = await apiClient.createWorkflow(workflow);
+        const credentialsRequired = new Set();
+        for (const node of workflow.nodes) {
+            if (node.credentials) {
+                for (const credType of Object.keys(node.credentials)) {
+                    credentialsRequired.add(credType);
+                }
+            }
+        }
+        logger.info(`Imported workflow: ${createdWorkflow.id} (${workflow.nodes.length} nodes)`);
+        return {
+            workflowId: createdWorkflow.id,
+            name: createdWorkflow.name,
+            nodes: workflow.nodes.length,
+            credentialsRequired: Array.from(credentialsRequired),
+            active: createdWorkflow.active,
+            message: credentialsRequired.size > 0
+                ? `Workflow imported successfully. Configure ${credentialsRequired.size} credential(s) before activating: ${Array.from(credentialsRequired).join(', ')}`
+                : 'Workflow imported successfully',
+        };
+    }
+    catch (error) {
+        logger.error('Error importing workflow file:', error);
+        throw error;
+    }
+}
+exports.n8n_export_workflow_file = {
+    name: 'n8n_export_workflow_file',
+    description: 'Export a workflow as .n8n file content. Returns the file content as a string ready to save.',
+    inputSchema: zod_1.z.object({
+        workflowId: zod_1.z.string().describe('ID of the workflow to export'),
+        includeCredentials: zod_1.z.boolean().optional().default(false).describe('Include credential references (default: false for security)'),
+        format: zod_1.z.enum(['json', 'pretty']).optional().default('pretty').describe('Output format: json (minified) or pretty (formatted)'),
+    }),
+};
+async function handleExportWorkflowFile(args, apiClient) {
+    try {
+        const { workflowId, includeCredentials, format } = args;
+        const workflow = await apiClient.getWorkflow(workflowId);
+        const fileContent = n8n_file_format_1.N8nFileFormatService.exportWorkflow(workflow, {
+            includeCredentials,
+            prettyPrint: format === 'pretty',
+            includeMetadata: true,
+        });
+        logger.info(`Exported workflow ${workflowId}: ${workflow.nodes.length} nodes`);
+        return {
+            fileContent,
+            workflow: {
+                id: workflow.id,
+                name: workflow.name,
+                nodes: workflow.nodes.length,
+                active: workflow.active,
+            },
+            metadata: {
+                exportedAt: new Date().toISOString(),
+                fileSize: fileContent.length,
+                credentialsIncluded: includeCredentials,
+            },
+        };
+    }
+    catch (error) {
+        logger.error('Error exporting workflow file:', error);
+        throw error;
+    }
+}
+exports.n8n_sync_workflow = {
+    name: 'n8n_sync_workflow',
+    description: 'Synchronize a workflow between .n8n file and n8n server. Supports compare, file-to-server, and server-to-file directions.',
+    inputSchema: zod_1.z.object({
+        workflowId: zod_1.z.string().describe('ID of the workflow on n8n server'),
+        fileContent: zod_1.z.string().describe('Current .n8n file content'),
+        direction: zod_1.z.enum(['file_to_server', 'server_to_file', 'compare']).describe('Sync direction: file_to_server (update server), server_to_file (update file), compare (show differences)'),
+    }),
+};
+async function handleSyncWorkflow(args, apiClient) {
+    try {
+        const { workflowId, fileContent, direction } = args;
+        const parseResult = n8n_file_format_1.N8nFileFormatService.parse(fileContent);
+        const fileWorkflow = parseResult.workflow;
+        const serverWorkflow = await apiClient.getWorkflow(workflowId);
+        if (direction === 'compare') {
+            const comparison = workflow_comparison_1.WorkflowComparisonService.compareWorkflows(serverWorkflow, fileWorkflow, {
+                compareMetadata: false,
+                ignorePositions: true
+            });
+            logger.info(`Compared workflow ${workflowId}: ${comparison.changes.length} changes`);
+            return {
+                workflowId,
+                direction: 'compare',
+                changes: comparison.changes,
+                summary: comparison.summary,
+                lastModified: {
+                    server: serverWorkflow.updatedAt,
+                    file: parseResult.version
+                }
+            };
+        }
+        else if (direction === 'file_to_server') {
+            const updatedWorkflow = await apiClient.updateWorkflow(workflowId, {
+                ...fileWorkflow,
+                id: workflowId,
+            });
+            logger.info(`Synced file to server: ${workflowId}`);
+            return {
+                workflowId,
+                direction: 'file_to_server',
+                synced: true,
+                workflow: {
+                    id: updatedWorkflow.id,
+                    name: updatedWorkflow.name,
+                    nodes: updatedWorkflow.nodes.length,
+                    updatedAt: updatedWorkflow.updatedAt,
+                },
+                message: 'Workflow updated on server successfully',
+            };
+        }
+        else if (direction === 'server_to_file') {
+            const newFileContent = n8n_file_format_1.N8nFileFormatService.exportWorkflow(serverWorkflow, {
+                includeCredentials: false,
+                prettyPrint: true,
+            });
+            logger.info(`Synced server to file: ${workflowId}`);
+            return {
+                workflowId,
+                direction: 'server_to_file',
+                synced: true,
+                fileContent: newFileContent,
+                workflow: {
+                    id: serverWorkflow.id,
+                    name: serverWorkflow.name,
+                    nodes: serverWorkflow.nodes.length,
+                    updatedAt: serverWorkflow.updatedAt,
+                },
+                message: 'File content updated from server successfully',
+            };
+        }
+        throw new Error(`Invalid sync direction: ${direction}`);
+    }
+    catch (error) {
+        logger.error('Error syncing workflow:', error);
+        throw error;
+    }
+}
+exports.n8n_validate_workflow_file = {
+    name: 'n8n_validate_workflow_file',
+    description: 'Validate .n8n file format and workflow structure without importing to server.',
+    inputSchema: zod_1.z.object({
+        fileContent: zod_1.z.string().describe('Raw .n8n file content (JSON string)'),
+    }),
+};
+async function handleValidateWorkflowFile(args) {
+    try {
+        const { fileContent } = args;
+        const isValid = n8n_file_format_1.N8nFileFormatService.isValidN8nFile(fileContent);
+        if (!isValid) {
+            return {
+                valid: false,
+                error: 'Invalid .n8n file format',
+            };
+        }
+        const result = n8n_file_format_1.N8nFileFormatService.parse(fileContent, {
+            validate: true,
+            preserveCredentials: false,
+        });
+        logger.info(`Validated .n8n file: ${result.workflow.nodes.length} nodes`);
+        return {
+            valid: true,
+            workflow: {
+                name: result.workflow.name,
+                nodes: result.workflow.nodes.length,
+                connections: Object.keys(result.workflow.connections).length,
+            },
+            warnings: result.warnings || [],
+            version: result.version,
+        };
+    }
+    catch (error) {
+        logger.error('Error validating workflow file:', error);
+        return {
+            valid: false,
+            error: error instanceof Error ? error.message : 'Unknown validation error',
+        };
+    }
+}
+//# sourceMappingURL=tools-file-operations.js.map

package/dist/mcp/tools-file-operations.js.map

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

package/dist/mcp/tools-n8n-friendly.d.ts

@@ -0,0 +1,6 @@
+export declare const n8nFriendlyDescriptions: Record<string, {
+    description: string;
+    params: Record<string, string>;
+}>;
+export declare function makeToolsN8nFriendly(tools: any[]): any[];
+//# sourceMappingURL=tools-n8n-friendly.d.ts.map

package/dist/mcp/tools-n8n-friendly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-n8n-friendly.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-n8n-friendly.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAqEA,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAiCxD"}

package/dist/mcp/tools-n8n-friendly.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nFriendlyDescriptions = void 0;
+exports.makeToolsN8nFriendly = makeToolsN8nFriendly;
+exports.n8nFriendlyDescriptions = {
+    validate_node: {
+        description: 'Validate n8n node config. Pass nodeType (string) and config (object). Use mode="full" for comprehensive validation, mode="minimal" for quick check. Example: {"nodeType": "nodes-base.slack", "config": {"resource": "channel", "operation": "create"}}',
+        params: {
+            nodeType: 'String value like "nodes-base.slack"',
+            config: 'Object value like {"resource": "channel", "operation": "create"} or empty object {}',
+            mode: 'Optional string: "full" (default) or "minimal"',
+            profile: 'Optional string: "minimal" or "runtime" or "ai-friendly" or "strict"'
+        }
+    },
+    search_nodes: {
+        description: 'Search nodes. Pass query (string). Example: {"query": "webhook"}',
+        params: {
+            query: 'String keyword like "webhook" or "database"',
+            limit: 'Optional number, default 20'
+        }
+    },
+    get_node: {
+        description: 'Get node info with multiple modes. Pass nodeType (string). Use mode="info" for config, mode="docs" for documentation, mode="search_properties" with propertyQuery for finding fields. Example: {"nodeType": "nodes-base.httpRequest", "detail": "standard"}',
+        params: {
+            nodeType: 'String with prefix like "nodes-base.httpRequest"',
+            mode: 'Optional string: "info" (default), "docs", "search_properties", "versions", "compare", "breaking", "migrations"',
+            detail: 'Optional string: "minimal", "standard" (default), "full"',
+            propertyQuery: 'For mode="search_properties": search term like "auth"'
+        }
+    },
+    validate_workflow: {
+        description: 'Validate workflow structure, connections, and expressions. Pass workflow object. MUST have: {"workflow": {"nodes": [array of node objects], "connections": {object with node connections}}}. Each node needs: name, type, typeVersion, position.',
+        params: {
+            workflow: 'Object with two required fields: nodes (array) and connections (object). Example: {"nodes": [{"name": "Webhook", "type": "n8n-nodes-base.webhook", "typeVersion": 2, "position": [250, 300], "parameters": {}}], "connections": {}}',
+            options: 'Optional object. Example: {"validateNodes": true, "validateConnections": true, "validateExpressions": true, "profile": "runtime"}'
+        }
+    },
+    search_templates: {
+        description: 'Search workflow templates with multiple modes. Use searchMode="keyword" for text search, searchMode="by_nodes" to find by node types, searchMode="by_task" for task-based templates, searchMode="by_metadata" for filtering. Example: {"query": "chatbot"} or {"searchMode": "by_task", "task": "webhook_processing"}',
+        params: {
+            query: 'For searchMode="keyword": string keyword like "chatbot"',
+            searchMode: 'Optional: "keyword" (default), "by_nodes", "by_task", "by_metadata"',
+            nodeTypes: 'For searchMode="by_nodes": array like ["n8n-nodes-base.httpRequest"]',
+            task: 'For searchMode="by_task": task like "webhook_processing", "ai_automation"',
+            limit: 'Optional number, default 20'
+        }
+    },
+    get_template: {
+        description: 'Get template by ID. Pass templateId (number). Example: {"templateId": 1234}',
+        params: {
+            templateId: 'Number ID like 1234',
+            mode: 'Optional: "full" (default), "nodes_only", "structure"'
+        }
+    },
+    tools_documentation: {
+        description: 'Get tool docs. Pass optional depth (string). Example: {"depth": "essentials"} or {}',
+        params: {
+            depth: 'Optional string: "essentials" (default) or "full"',
+            topic: 'Optional string tool name like "search_nodes"'
+        }
+    }
+};
+function makeToolsN8nFriendly(tools) {
+    return tools.map(tool => {
+        const toolName = tool.name;
+        const friendlyDesc = exports.n8nFriendlyDescriptions[toolName];
+        if (friendlyDesc) {
+            const updatedTool = { ...tool };
+            updatedTool.description = friendlyDesc.description;
+            if (tool.inputSchema?.properties) {
+                updatedTool.inputSchema = {
+                    ...tool.inputSchema,
+                    properties: { ...tool.inputSchema.properties }
+                };
+                Object.keys(updatedTool.inputSchema.properties).forEach(param => {
+                    if (friendlyDesc.params[param]) {
+                        updatedTool.inputSchema.properties[param] = {
+                            ...updatedTool.inputSchema.properties[param],
+                            description: friendlyDesc.params[param]
+                        };
+                    }
+                });
+            }
+            return updatedTool;
+        }
+        return tool;
+    });
+}
+//# sourceMappingURL=tools-n8n-friendly.js.map

package/dist/mcp/tools-n8n-friendly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-n8n-friendly.js","sourceRoot":"","sources":["../../src/mcp/tools-n8n-friendly.ts"],"names":[],"mappings":";;;AAyFA,oDAiCC;AA/GY,QAAA,uBAAuB,GAG/B;IAEH,aAAa,EAAE;QACb,WAAW,EAAE,yPAAyP;QACtQ,MAAM,EAAE;YACN,QAAQ,EAAE,sCAAsC;YAChD,MAAM,EAAE,qFAAqF;YAC7F,IAAI,EAAE,gDAAgD;YACtD,OAAO,EAAE,sEAAsE;SAChF;KACF;IAGD,YAAY,EAAE;QACZ,WAAW,EAAE,kEAAkE;QAC/E,MAAM,EAAE;YACN,KAAK,EAAE,6CAA6C;YACpD,KAAK,EAAE,6BAA6B;SACrC;KACF;IAGD,QAAQ,EAAE;QACR,WAAW,EAAE,6PAA6P;QAC1Q,MAAM,EAAE;YACN,QAAQ,EAAE,kDAAkD;YAC5D,IAAI,EAAE,iHAAiH;YACvH,MAAM,EAAE,0DAA0D;YAClE,aAAa,EAAE,uDAAuD;SACvE;KACF;IAGD,iBAAiB,EAAE;QACjB,WAAW,EAAE,kPAAkP;QAC/P,MAAM,EAAE;YACN,QAAQ,EAAE,qOAAqO;YAC/O,OAAO,EAAE,mIAAmI;SAC7I;KACF;IAGD,gBAAgB,EAAE;QAChB,WAAW,EAAE,uTAAuT;QACpU,MAAM,EAAE;YACN,KAAK,EAAE,yDAAyD;YAChE,UAAU,EAAE,qEAAqE;YACjF,SAAS,EAAE,sEAAsE;YACjF,IAAI,EAAE,2EAA2E;YACjF,KAAK,EAAE,6BAA6B;SACrC;KACF;IAED,YAAY,EAAE;QACZ,WAAW,EAAE,6EAA6E;QAC1F,MAAM,EAAE;YACN,UAAU,EAAE,qBAAqB;YACjC,IAAI,EAAE,uDAAuD;SAC9D;KACF;IAGD,mBAAmB,EAAE;QACnB,WAAW,EAAE,qFAAqF;QAClG,MAAM,EAAE;YACN,KAAK,EAAE,mDAAmD;YAC1D,KAAK,EAAE,+CAA+C;SACvD;KACF;CACF,CAAC;AAMF,SAAgB,oBAAoB,CAAC,KAAY;IAC/C,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAc,CAAC;QACrC,MAAM,YAAY,GAAG,+BAAuB,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,YAAY,EAAE,CAAC;YAEjB,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YAGhC,WAAW,CAAC,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC;YAGnD,IAAI,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;gBACjC,WAAW,CAAC,WAAW,GAAG;oBACxB,GAAG,IAAI,CAAC,WAAW;oBACnB,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE;iBAC/C,CAAC;gBAGF,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;oBAC9D,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC/B,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG;4BAC1C,GAAG,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC;4BAC5C,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;yBACxC,CAAC;oBACJ,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp/tools-n8n-manager.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types';
+export declare const n8nManagementTools: ToolDefinition[];
+//# sourceMappingURL=tools-n8n-manager.d.ts.map

package/dist/mcp/tools-n8n-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-n8n-manager.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-n8n-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAQ1C,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAi0C9C,CAAC"}