@n8n/ai-workflow-builder 0.13.0 → 0.14.0

package/dist/tools/engines/node-search-engine.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeSearchEngine = exports.SCORE_WEIGHTS = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+exports.SCORE_WEIGHTS = {
+    NAME_CONTAINS: 10,
+    DISPLAY_NAME_CONTAINS: 8,
+    DESCRIPTION_CONTAINS: 5,
+    ALIAS_CONTAINS: 8,
+    NAME_EXACT: 20,
+    DISPLAY_NAME_EXACT: 15,
+    CONNECTION_EXACT: 100,
+    CONNECTION_IN_EXPRESSION: 50,
+};
+class NodeSearchEngine {
+    constructor(nodeTypes) {
+        this.nodeTypes = nodeTypes;
+    }
+    searchByName(query, limit = 20) {
+        const normalizedQuery = query.toLowerCase();
+        const results = [];
+        for (const nodeType of this.nodeTypes) {
+            try {
+                const score = this.calculateNameScore(nodeType, normalizedQuery);
+                if (score > 0) {
+                    results.push(this.createSearchResult(nodeType, score));
+                }
+            }
+            catch (error) {
+            }
+        }
+        return this.sortAndLimit(results, limit);
+    }
+    searchByConnectionType(connectionType, limit = 20, nameFilter) {
+        const results = [];
+        const normalizedFilter = nameFilter?.toLowerCase();
+        for (const nodeType of this.nodeTypes) {
+            try {
+                const connectionScore = this.getConnectionScore(nodeType, connectionType);
+                if (connectionScore > 0) {
+                    const nameScore = normalizedFilter
+                        ? this.calculateNameScore(nodeType, normalizedFilter)
+                        : 0;
+                    if (!normalizedFilter || nameScore > 0) {
+                        const totalScore = connectionScore + nameScore;
+                        results.push(this.createSearchResult(nodeType, totalScore));
+                    }
+                }
+            }
+            catch (error) {
+            }
+        }
+        return this.sortAndLimit(results, limit);
+    }
+    formatResult(result) {
+        return `
+		<node>
+			<node_name>${result.name}</node_name>
+			<node_description>${result.description}</node_description>
+			<node_inputs>${typeof result.inputs === 'object' ? JSON.stringify(result.inputs) : result.inputs}</node_inputs>
+			<node_outputs>${typeof result.outputs === 'object' ? JSON.stringify(result.outputs) : result.outputs}</node_outputs>
+		</node>`;
+    }
+    calculateNameScore(nodeType, normalizedQuery) {
+        let score = 0;
+        if (nodeType.name.toLowerCase().includes(normalizedQuery)) {
+            score += exports.SCORE_WEIGHTS.NAME_CONTAINS;
+        }
+        if (nodeType.displayName.toLowerCase().includes(normalizedQuery)) {
+            score += exports.SCORE_WEIGHTS.DISPLAY_NAME_CONTAINS;
+        }
+        if (nodeType.description?.toLowerCase().includes(normalizedQuery)) {
+            score += exports.SCORE_WEIGHTS.DESCRIPTION_CONTAINS;
+        }
+        if (nodeType.codex?.alias?.some((alias) => alias.toLowerCase().includes(normalizedQuery))) {
+            score += exports.SCORE_WEIGHTS.ALIAS_CONTAINS;
+        }
+        if (nodeType.name.toLowerCase() === normalizedQuery) {
+            score += exports.SCORE_WEIGHTS.NAME_EXACT;
+        }
+        if (nodeType.displayName.toLowerCase() === normalizedQuery) {
+            score += exports.SCORE_WEIGHTS.DISPLAY_NAME_EXACT;
+        }
+        return score;
+    }
+    getConnectionScore(nodeType, connectionType) {
+        const outputs = nodeType.outputs;
+        if (Array.isArray(outputs)) {
+            if (outputs.includes(connectionType)) {
+                return exports.SCORE_WEIGHTS.CONNECTION_EXACT;
+            }
+        }
+        else if (typeof outputs === 'string') {
+            if (outputs.includes(connectionType)) {
+                return exports.SCORE_WEIGHTS.CONNECTION_IN_EXPRESSION;
+            }
+        }
+        return 0;
+    }
+    createSearchResult(nodeType, score) {
+        return {
+            name: nodeType.name,
+            displayName: nodeType.displayName,
+            description: nodeType.description ?? 'No description available',
+            inputs: nodeType.inputs,
+            outputs: nodeType.outputs,
+            score,
+        };
+    }
+    sortAndLimit(results, limit) {
+        return results.sort((a, b) => b.score - a.score).slice(0, limit);
+    }
+    static isAiConnectionType(connectionType) {
+        return connectionType.startsWith('ai_');
+    }
+    static getAiConnectionTypes() {
+        return Object.values(n8n_workflow_1.NodeConnectionTypes).filter((type) => NodeSearchEngine.isAiConnectionType(type));
+    }
+}
+exports.NodeSearchEngine = NodeSearchEngine;
+//# sourceMappingURL=node-search-engine.js.map

package/dist/tools/engines/node-search-engine.js.map

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

package/dist/tools/helpers/index.d.ts

@@ -0,0 +1,4 @@
+export * from './progress';
+export * from './response';
+export * from './validation';
+export * from './state';

package/dist/tools/helpers/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./progress"), exports);
+__exportStar(require("./response"), exports);
+__exportStar(require("./validation"), exports);
+__exportStar(require("./state"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,6CAA2B;AAG3B,6CAA2B;AAG3B,+CAA6B;AAG7B,0CAAwB"}

package/dist/tools/helpers/progress.d.ts

@@ -0,0 +1,9 @@
+import type { ToolRunnableConfig } from '@langchain/core/tools';
+import type { LangGraphRunnableConfig } from '@langchain/langgraph';
+import type { ToolError, ProgressReporter, BatchReporter } from '../../types/tools';
+export declare function createProgressReporter<TToolName extends string = string>(config: ToolRunnableConfig & LangGraphRunnableConfig, toolName: TToolName): ProgressReporter;
+export declare function reportStart<T>(reporter: ProgressReporter, input: T): void;
+export declare function reportProgress(reporter: ProgressReporter, message: string, data?: Record<string, unknown>): void;
+export declare function reportComplete<T>(reporter: ProgressReporter, output: T): void;
+export declare function reportError(reporter: ProgressReporter, error: ToolError): void;
+export declare function createBatchProgressReporter(reporter: ProgressReporter, scope: string): BatchReporter;

package/dist/tools/helpers/progress.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgressReporter = createProgressReporter;
+exports.reportStart = reportStart;
+exports.reportProgress = reportProgress;
+exports.reportComplete = reportComplete;
+exports.reportError = reportError;
+exports.createBatchProgressReporter = createBatchProgressReporter;
+function createProgressReporter(config, toolName) {
+    const toolCallId = config.toolCall?.id;
+    const emit = (message) => {
+        config.writer?.(message);
+    };
+    const start = (input) => {
+        emit({
+            type: 'tool',
+            toolName,
+            toolCallId,
+            status: 'running',
+            updates: [
+                {
+                    type: 'input',
+                    data: input,
+                },
+            ],
+        });
+    };
+    const progress = (message, data) => {
+        emit({
+            type: 'tool',
+            toolName,
+            toolCallId,
+            status: 'running',
+            updates: [
+                {
+                    type: 'progress',
+                    data: data ?? { message },
+                },
+            ],
+        });
+    };
+    const complete = (output) => {
+        emit({
+            type: 'tool',
+            toolName,
+            toolCallId,
+            status: 'completed',
+            updates: [
+                {
+                    type: 'output',
+                    data: output,
+                },
+            ],
+        });
+    };
+    const error = (error) => {
+        emit({
+            type: 'tool',
+            toolName,
+            toolCallId,
+            status: 'error',
+            updates: [
+                {
+                    type: 'error',
+                    data: {
+                        message: error.message,
+                        code: error.code,
+                        details: error.details,
+                    },
+                },
+            ],
+        });
+    };
+    const createBatchReporter = (scope) => {
+        let currentIndex = 0;
+        let totalItems = 0;
+        return {
+            init: (total) => {
+                totalItems = total;
+                currentIndex = 0;
+            },
+            next: (itemDescription) => {
+                currentIndex++;
+                progress(`${scope}: Processing item ${currentIndex} of ${totalItems}: ${itemDescription}`);
+            },
+            complete: () => {
+                progress(`${scope}: Completed all ${totalItems} items`);
+            },
+        };
+    };
+    return {
+        start,
+        progress,
+        complete,
+        error,
+        createBatchReporter,
+    };
+}
+function reportStart(reporter, input) {
+    reporter.start(input);
+}
+function reportProgress(reporter, message, data) {
+    reporter.progress(message, data);
+}
+function reportComplete(reporter, output) {
+    reporter.complete(output);
+}
+function reportError(reporter, error) {
+    reporter.error(error);
+}
+function createBatchProgressReporter(reporter, scope) {
+    return reporter.createBatchReporter(scope);
+}
+//# sourceMappingURL=progress.js.map

package/dist/tools/helpers/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/tools/helpers/progress.ts"],"names":[],"mappings":";;AAaA,wDAoGC;AAKD,kCAEC;AAKD,wCAMC;AAKD,wCAEC;AAKD,kCAEC;AAKD,kEAKC;AA9ID,SAAgB,sBAAsB,CACrC,MAAoD,EACpD,QAAmB;IAEnB,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IAEvC,MAAM,IAAI,GAAG,CAAC,OAAuC,EAAQ,EAAE;QAC9D,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAI,KAAQ,EAAQ,EAAE;QACnC,IAAI,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,QAAQ;YACR,UAAU;YACV,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,KAAgC;iBACtC;aACD;SACD,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,IAA8B,EAAQ,EAAE;QAC1E,IAAI,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,QAAQ;YACR,UAAU;YACV,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,IAAI,IAAI,EAAE,OAAO,EAAE;iBACzB;aACD;SACD,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAI,MAAS,EAAQ,EAAE;QACvC,IAAI,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,QAAQ;YACR,UAAU;YACV,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,MAAiC;iBACvC;aACD;SACD,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,KAAgB,EAAQ,EAAE;QACxC,IAAI,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,QAAQ;YACR,UAAU;YACV,MAAM,EAAE,OAAO;YACf,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE;wBACL,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;qBACtB;iBACD;aACD;SACD,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAiB,EAAE;QAC5D,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,OAAO;YACN,IAAI,EAAE,CAAC,KAAa,EAAE,EAAE;gBACvB,UAAU,GAAG,KAAK,CAAC;gBACnB,YAAY,GAAG,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,EAAE,CAAC,eAAuB,EAAE,EAAE;gBACjC,YAAY,EAAE,CAAC;gBACf,QAAQ,CAAC,GAAG,KAAK,qBAAqB,YAAY,OAAO,UAAU,KAAK,eAAe,EAAE,CAAC,CAAC;YAC5F,CAAC;YACD,QAAQ,EAAE,GAAG,EAAE;gBACd,QAAQ,CAAC,GAAG,KAAK,mBAAmB,UAAU,QAAQ,CAAC,CAAC;YACzD,CAAC;SACD,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACN,KAAK;QACL,QAAQ;QACR,QAAQ;QACR,KAAK;QACL,mBAAmB;KACnB,CAAC;AACH,CAAC;AAKD,SAAgB,WAAW,CAAI,QAA0B,EAAE,KAAQ;IAClE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAKD,SAAgB,cAAc,CAC7B,QAA0B,EAC1B,OAAe,EACf,IAA8B;IAE9B,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAKD,SAAgB,cAAc,CAAI,QAA0B,EAAE,MAAS;IACtE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAKD,SAAgB,WAAW,CAAC,QAA0B,EAAE,KAAgB;IACvE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAKD,SAAgB,2BAA2B,CAC1C,QAA0B,EAC1B,KAAa;IAEb,OAAO,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC"}

package/dist/tools/helpers/response.d.ts

@@ -0,0 +1,7 @@
+import type { ToolRunnableConfig } from '@langchain/core/tools';
+import { Command } from '@langchain/langgraph';
+import type { ToolError } from '../../types/tools';
+import type { StateUpdater } from '../../types/utils';
+import type { WorkflowState } from '../../workflow-state';
+export declare function createSuccessResponse<TState = typeof WorkflowState.State>(config: ToolRunnableConfig, message: string, stateUpdates?: StateUpdater<TState>): Command;
+export declare function createErrorResponse(config: ToolRunnableConfig, error: ToolError): Command;

package/dist/tools/helpers/response.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSuccessResponse = createSuccessResponse;
+exports.createErrorResponse = createErrorResponse;
+const messages_1 = require("@langchain/core/messages");
+const langgraph_1 = require("@langchain/langgraph");
+function createSuccessResponse(config, message, stateUpdates) {
+    const toolCallId = config.toolCall?.id;
+    const messages = [
+        new messages_1.ToolMessage({
+            content: message,
+            tool_call_id: toolCallId,
+        }),
+    ];
+    const update = { messages };
+    if (stateUpdates) {
+        Object.assign(update, stateUpdates);
+    }
+    return new langgraph_1.Command({ update });
+}
+function createErrorResponse(config, error) {
+    const toolCallId = config.toolCall?.id;
+    const messages = [
+        new messages_1.ToolMessage({
+            content: `Error: ${error.message}`,
+            tool_call_id: toolCallId,
+        }),
+    ];
+    return new langgraph_1.Command({ update: { messages } });
+}
+//# sourceMappingURL=response.js.map

package/dist/tools/helpers/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/tools/helpers/response.ts"],"names":[],"mappings":";;AAWA,sDAqBC;AAKD,kDAWC;AAhDD,uDAAuD;AAEvD,oDAA+C;AAS/C,SAAgB,qBAAqB,CACpC,MAA0B,EAC1B,OAAe,EACf,YAAmC;IAEnC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAY,CAAC;IAEjD,MAAM,QAAQ,GAAG;QAChB,IAAI,sBAAW,CAAC;YACf,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,UAAU;SACxB,CAAC;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,EAAE,QAAQ,EAAE,CAAC;IAE5B,IAAI,YAAY,EAAE,CAAC;QAClB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,mBAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC;AAKD,SAAgB,mBAAmB,CAAC,MAA0B,EAAE,KAAgB;IAC/E,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAY,CAAC;IAEjD,MAAM,QAAQ,GAAG;QAChB,IAAI,sBAAW,CAAC;YACf,OAAO,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE;YAClC,YAAY,EAAE,UAAU;SACxB,CAAC;KACF,CAAC;IAEF,OAAO,IAAI,mBAAO,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/tools/helpers/state.d.ts

@@ -0,0 +1,13 @@
+import type { INode, IConnection } from 'n8n-workflow';
+import type { SimpleWorkflow } from '../../types/workflow';
+import type { WorkflowState } from '../../workflow-state';
+export declare function getCurrentWorkflow(state: typeof WorkflowState.State): SimpleWorkflow;
+export declare function getWorkflowState(): typeof WorkflowState.State;
+export declare function getCurrentWorkflowFromTaskInput(): SimpleWorkflow;
+export declare function updateWorkflowConnections(connections: SimpleWorkflow['connections']): Partial<typeof WorkflowState.State>;
+export declare function addNodeToWorkflow(node: INode): Partial<typeof WorkflowState.State>;
+export declare function addNodesToWorkflow(nodes: INode[]): Partial<typeof WorkflowState.State>;
+export declare function removeNodeFromWorkflow(nodeId: string): Partial<typeof WorkflowState.State>;
+export declare function removeNodesFromWorkflow(nodeIds: string[]): Partial<typeof WorkflowState.State>;
+export declare function updateNodeInWorkflow(state: typeof WorkflowState.State, nodeId: string, updates: Partial<INode>): Partial<typeof WorkflowState.State>;
+export declare function addConnectionToWorkflow(sourceNodeId: string, _targetNodeId: string, connection: IConnection): Partial<typeof WorkflowState.State>;

package/dist/tools/helpers/state.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentWorkflow = getCurrentWorkflow;
+exports.getWorkflowState = getWorkflowState;
+exports.getCurrentWorkflowFromTaskInput = getCurrentWorkflowFromTaskInput;
+exports.updateWorkflowConnections = updateWorkflowConnections;
+exports.addNodeToWorkflow = addNodeToWorkflow;
+exports.addNodesToWorkflow = addNodesToWorkflow;
+exports.removeNodeFromWorkflow = removeNodeFromWorkflow;
+exports.removeNodesFromWorkflow = removeNodesFromWorkflow;
+exports.updateNodeInWorkflow = updateNodeInWorkflow;
+exports.addConnectionToWorkflow = addConnectionToWorkflow;
+const langgraph_1 = require("@langchain/langgraph");
+function getCurrentWorkflow(state) {
+    return state.workflowJSON;
+}
+function getWorkflowState() {
+    return (0, langgraph_1.getCurrentTaskInput)();
+}
+function getCurrentWorkflowFromTaskInput() {
+    const state = getWorkflowState();
+    return getCurrentWorkflow(state);
+}
+function updateWorkflowConnections(connections) {
+    return {
+        workflowOperations: [{ type: 'mergeConnections', connections }],
+    };
+}
+function addNodeToWorkflow(node) {
+    return addNodesToWorkflow([node]);
+}
+function addNodesToWorkflow(nodes) {
+    return {
+        workflowOperations: [{ type: 'addNodes', nodes }],
+    };
+}
+function removeNodeFromWorkflow(nodeId) {
+    return {
+        workflowOperations: [{ type: 'removeNode', nodeIds: [nodeId] }],
+    };
+}
+function removeNodesFromWorkflow(nodeIds) {
+    return {
+        workflowOperations: [{ type: 'removeNode', nodeIds }],
+    };
+}
+function updateNodeInWorkflow(state, nodeId, updates) {
+    const existingNode = state.workflowJSON.nodes.find((n) => n.id === nodeId);
+    if (!existingNode) {
+        return {};
+    }
+    return {
+        workflowOperations: [{ type: 'updateNode', nodeId, updates }],
+    };
+}
+function addConnectionToWorkflow(sourceNodeId, _targetNodeId, connection) {
+    return {
+        workflowOperations: [
+            {
+                type: 'mergeConnections',
+                connections: {
+                    [sourceNodeId]: {
+                        main: [[connection]],
+                    },
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/tools/helpers/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/tools/helpers/state.ts"],"names":[],"mappings":";;AASA,gDAEC;AAED,4CAEC;AAKD,0EAGC;AAKD,8DAOC;AAKD,8CAEC;AAKD,gDAKC;AAKD,wDAKC;AAKD,0DAKC;AAKD,oDAcC;AAKD,0DAiBC;AAjHD,oDAA2D;AAS3D,SAAgB,kBAAkB,CAAC,KAAiC;IACnE,OAAO,KAAK,CAAC,YAAY,CAAC;AAC3B,CAAC;AAED,SAAgB,gBAAgB;IAC/B,OAAO,IAAA,+BAAmB,GAAE,CAAC;AAC9B,CAAC;AAKD,SAAgB,+BAA+B;IAC9C,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAKD,SAAgB,yBAAyB,CACxC,WAA0C;IAG1C,OAAO;QACN,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,CAAC;KAC/D,CAAC;AACH,CAAC;AAKD,SAAgB,iBAAiB,CAAC,IAAW;IAC5C,OAAO,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC;AAKD,SAAgB,kBAAkB,CAAC,KAAc;IAEhD,OAAO;QACN,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;KACjD,CAAC;AACH,CAAC;AAKD,SAAgB,sBAAsB,CAAC,MAAc;IAEpD,OAAO;QACN,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;KAC/D,CAAC;AACH,CAAC;AAKD,SAAgB,uBAAuB,CAAC,OAAiB;IAExD,OAAO;QACN,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;KACrD,CAAC;AACH,CAAC;AAKD,SAAgB,oBAAoB,CACnC,KAAiC,EACjC,MAAc,EACd,OAAuB;IAEvB,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAC3E,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACX,CAAC;IAGD,OAAO;QACN,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;KAC7D,CAAC;AACH,CAAC;AAKD,SAAgB,uBAAuB,CACtC,YAAoB,EACpB,aAAqB,EACrB,UAAuB;IAEvB,OAAO;QACN,kBAAkB,EAAE;YACnB;gBACC,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EAAE;oBACZ,CAAC,YAAY,CAAC,EAAE;wBACf,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;qBACpB;iBACD;aACD;SACD;KACD,CAAC;AACH,CAAC"}

package/dist/tools/helpers/validation.d.ts

@@ -0,0 +1,12 @@
+import type { INode, INodeTypeDescription } from 'n8n-workflow';
+import type { ToolError } from '../../types/tools';
+import type { SimpleWorkflow } from '../../types/workflow';
+export declare function validateNodeExists(nodeId: string, nodes: INode[]): INode | null;
+export declare function findNodeByName(nodeName: string, nodes: INode[]): INode | null;
+export declare function findNodeByIdOrName(nodeIdentifier: string, nodes: INode[]): INode | null;
+export declare function findNodeType(nodeTypeName: string, nodeTypes: INodeTypeDescription[]): INodeTypeDescription | null;
+export declare function validateConnection(sourceNode: INode, targetNode: INode): ToolError | null;
+export declare function createValidationError(message: string, code: string, details?: Record<string, string>): ToolError;
+export declare function createNodeNotFoundError(nodeIdentifier: string): ToolError;
+export declare function createNodeTypeNotFoundError(nodeTypeName: string): ToolError;
+export declare function hasNodes(workflow: SimpleWorkflow): boolean;

package/dist/tools/helpers/validation.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNodeExists = validateNodeExists;
+exports.findNodeByName = findNodeByName;
+exports.findNodeByIdOrName = findNodeByIdOrName;
+exports.findNodeType = findNodeType;
+exports.validateConnection = validateConnection;
+exports.createValidationError = createValidationError;
+exports.createNodeNotFoundError = createNodeNotFoundError;
+exports.createNodeTypeNotFoundError = createNodeTypeNotFoundError;
+exports.hasNodes = hasNodes;
+const errors_1 = require("../../errors");
+function validateNodeExists(nodeId, nodes) {
+    return nodes.find((n) => n.id === nodeId) ?? null;
+}
+function findNodeByName(nodeName, nodes) {
+    return nodes.find((n) => n.name.toLowerCase() === nodeName.toLowerCase()) ?? null;
+}
+function findNodeByIdOrName(nodeIdentifier, nodes) {
+    const byId = validateNodeExists(nodeIdentifier, nodes);
+    if (byId)
+        return byId;
+    return findNodeByName(nodeIdentifier, nodes);
+}
+function findNodeType(nodeTypeName, nodeTypes) {
+    return nodeTypes.find((nt) => nt.name === nodeTypeName) ?? null;
+}
+function validateConnection(sourceNode, targetNode) {
+    if (sourceNode.id === targetNode.id) {
+        const error = new errors_1.ConnectionError('Cannot connect a node to itself', {
+            fromNodeId: sourceNode.id,
+            toNodeId: targetNode.id,
+        });
+        return {
+            message: error.message,
+            code: 'SELF_CONNECTION',
+            details: { sourceId: sourceNode.id, targetId: targetNode.id },
+        };
+    }
+    return null;
+}
+function createValidationError(message, code, details) {
+    const error = new errors_1.ValidationError(message, { tags: { code, ...details } });
+    return {
+        message: error.message,
+        code,
+        details,
+    };
+}
+function createNodeNotFoundError(nodeIdentifier) {
+    const error = new errors_1.NodeNotFoundError(nodeIdentifier);
+    return {
+        message: error.message,
+        code: 'NODE_NOT_FOUND',
+        details: { nodeIdentifier },
+    };
+}
+function createNodeTypeNotFoundError(nodeTypeName) {
+    const error = new errors_1.NodeTypeNotFoundError(nodeTypeName);
+    return {
+        message: error.message,
+        code: 'NODE_TYPE_NOT_FOUND',
+        details: { nodeTypeName },
+    };
+}
+function hasNodes(workflow) {
+    return workflow.nodes.length > 0;
+}
+//# sourceMappingURL=validation.js.map

package/dist/tools/helpers/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/tools/helpers/validation.ts"],"names":[],"mappings":";;AAcA,gDAEC;AAKD,wCAEC;AAKD,gDAOC;AAKD,oCAKC;AAKD,gDAeC;AAKD,sDAYC;AAKD,0DAOC;AAKD,kEAOC;AAKD,4BAEC;AA/GD,yCAKsB;AAOtB,SAAgB,kBAAkB,CAAC,MAAc,EAAE,KAAc;IAChE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;AACnD,CAAC;AAKD,SAAgB,cAAc,CAAC,QAAgB,EAAE,KAAc;IAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AACnF,CAAC;AAKD,SAAgB,kBAAkB,CAAC,cAAsB,EAAE,KAAc;IAExE,MAAM,IAAI,GAAG,kBAAkB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACvD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAGtB,OAAO,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAKD,SAAgB,YAAY,CAC3B,YAAoB,EACpB,SAAiC;IAEjC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,IAAI,CAAC;AACjE,CAAC;AAKD,SAAgB,kBAAkB,CAAC,UAAiB,EAAE,UAAiB;IAEtE,IAAI,UAAU,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,wBAAe,CAAC,iCAAiC,EAAE;YACpE,UAAU,EAAE,UAAU,CAAC,EAAE;YACzB,QAAQ,EAAE,UAAU,CAAC,EAAE;SACvB,CAAC,CAAC;QACH,OAAO;YACN,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE;SAC7D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAKD,SAAgB,qBAAqB,CACpC,OAAe,EACf,IAAY,EACZ,OAAgC;IAGhC,MAAM,KAAK,GAAG,IAAI,wBAAe,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3E,OAAO;QACN,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI;QACJ,OAAO;KACP,CAAC;AACH,CAAC;AAKD,SAAgB,uBAAuB,CAAC,cAAsB;IAC7D,MAAM,KAAK,GAAG,IAAI,0BAAiB,CAAC,cAAc,CAAC,CAAC;IACpD,OAAO;QACN,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,EAAE,cAAc,EAAE;KAC3B,CAAC;AACH,CAAC;AAKD,SAAgB,2BAA2B,CAAC,YAAoB;IAC/D,MAAM,KAAK,GAAG,IAAI,8BAAqB,CAAC,YAAY,CAAC,CAAC;IACtD,OAAO;QACN,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,EAAE,YAAY,EAAE;KACzB,CAAC;AACH,CAAC;AAKD,SAAgB,QAAQ,CAAC,QAAwB;IAChD,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/node-details.tool.d.ts

@@ -0,0 +1,19 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+import { z } from 'zod';
+export declare function createNodeDetailsTool(nodeTypes: INodeTypeDescription[]): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    nodeName: z.ZodString;
+    withParameters: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    withConnections: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    nodeName: string;
+    withParameters: boolean;
+    withConnections: boolean;
+}, {
+    nodeName: string;
+    withParameters?: boolean | undefined;
+    withConnections?: boolean | undefined;
+}>, unknown, {
+    nodeName: string;
+    withParameters?: boolean | undefined;
+    withConnections?: boolean | undefined;
+}, import("@langchain/langgraph").Command<unknown>>;