@atom8n/ai-workflow-builder 1.2.0

package/dist/tools/connect-nodes.tool.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONNECT_NODES_TOOL = exports.nodeConnectionSchema = void 0;
+exports.createConnectNodesTool = createConnectNodesTool;
+const tools_1 = require("@langchain/core/tools");
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+const progress_1 = require("./helpers/progress");
+const response_1 = require("./helpers/response");
+const state_1 = require("./helpers/state");
+const validation_1 = require("./helpers/validation");
+const connection_utils_1 = require("./utils/connection.utils");
+exports.nodeConnectionSchema = zod_1.z.object({
+    sourceNodeId: zod_1.z
+        .string()
+        .describe('The UUID of the source node. For ai_* connections (ai_languageModel, ai_tool, etc.), this MUST be the sub-node (e.g., OpenAI Chat Model). For main connections, this is the node producing the output'),
+    targetNodeId: zod_1.z
+        .string()
+        .describe('The UUID of the target node. For ai_* connections, this MUST be the main node that accepts the sub-node (e.g., AI Agent, Basic LLM Chain). For main connections, this is the node receiving the input'),
+    sourceOutputIndex: zod_1.z
+        .number()
+        .optional()
+        .describe('The index of the output to connect from (default: 0)'),
+    targetInputIndex: zod_1.z
+        .number()
+        .optional()
+        .describe('The index of the input to connect to (default: 0)'),
+});
+exports.CONNECT_NODES_TOOL = {
+    toolName: 'connect_nodes',
+    displayTitle: 'Connecting nodes',
+};
+function createConnectNodesTool(nodeTypes, logger) {
+    const dynamicTool = (0, tools_1.tool)((input, config) => {
+        const reporter = (0, progress_1.createProgressReporter)(config, exports.CONNECT_NODES_TOOL.toolName, exports.CONNECT_NODES_TOOL.displayTitle);
+        try {
+            const validatedInput = exports.nodeConnectionSchema.parse(input);
+            reporter.start(validatedInput);
+            const state = (0, state_1.getWorkflowState)();
+            const workflow = (0, state_1.getCurrentWorkflow)(state);
+            (0, progress_1.reportProgress)(reporter, 'Finding nodes to connect...');
+            let matchedSourceNode = (0, validation_1.validateNodeExists)(validatedInput.sourceNodeId, workflow.nodes);
+            let matchedTargetNode = (0, validation_1.validateNodeExists)(validatedInput.targetNodeId, workflow.nodes);
+            if (!matchedSourceNode || !matchedTargetNode) {
+                const missingNodeId = !matchedSourceNode
+                    ? validatedInput.sourceNodeId
+                    : validatedInput.targetNodeId;
+                const nodeError = new errors_1.NodeNotFoundError(missingNodeId);
+                const error = {
+                    message: nodeError.message,
+                    code: 'NODES_NOT_FOUND',
+                    details: {
+                        sourceNodeId: validatedInput.sourceNodeId,
+                        targetNodeId: validatedInput.targetNodeId,
+                        foundSource: !!matchedSourceNode,
+                        foundTarget: !!matchedTargetNode,
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const sourceNodeType = nodeTypes.find((nt) => nt.name === matchedSourceNode.type);
+            const targetNodeType = nodeTypes.find((nt) => nt.name === matchedTargetNode.type);
+            if (!sourceNodeType || !targetNodeType) {
+                const missingType = !sourceNodeType ? matchedSourceNode.type : matchedTargetNode.type;
+                const typeError = new errors_1.NodeTypeNotFoundError(missingType);
+                const error = {
+                    message: typeError.message,
+                    code: 'NODE_TYPE_NOT_FOUND',
+                    details: {
+                        sourceType: matchedSourceNode.type,
+                        targetType: matchedTargetNode.type,
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            (0, progress_1.reportProgress)(reporter, 'Inferring connection type...');
+            logger?.debug('\n=== Connect Nodes Tool ===');
+            logger?.debug(`Attempting to connect: ${matchedSourceNode.name} -> ${matchedTargetNode.name}`);
+            const inferResult = (0, connection_utils_1.inferConnectionType)(matchedSourceNode, matchedTargetNode, sourceNodeType, targetNodeType);
+            if (inferResult.error) {
+                const connectionError = new errors_1.ConnectionError(inferResult.error, {
+                    fromNodeId: matchedSourceNode.id,
+                    toNodeId: matchedTargetNode.id,
+                });
+                const error = {
+                    message: connectionError.message,
+                    code: 'CONNECTION_TYPE_INFERENCE_ERROR',
+                    details: {
+                        sourceNode: matchedSourceNode.name,
+                        targetNode: matchedTargetNode.name,
+                        possibleTypes: inferResult.possibleTypes,
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            if (!inferResult.connectionType) {
+                const error = {
+                    message: 'Could not infer connection type',
+                    code: 'CONNECTION_TYPE_INFERENCE_FAILED',
+                    details: {
+                        sourceNode: matchedSourceNode.name,
+                        targetNode: matchedTargetNode.name,
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const connectionType = inferResult.connectionType;
+            const inferredSwap = inferResult.requiresSwap ?? false;
+            if (inferredSwap) {
+                logger?.debug('Swapping nodes based on inference result');
+                const temp = matchedSourceNode;
+                matchedSourceNode = matchedTargetNode;
+                matchedTargetNode = temp;
+            }
+            (0, progress_1.reportProgress)(reporter, `Inferred connection type: ${connectionType}${inferredSwap ? ' (swapped nodes)' : ''}`);
+            logger?.debug(`Final connection: ${matchedSourceNode.name} -> ${matchedTargetNode.name} (${connectionType})\n`);
+            (0, progress_1.reportProgress)(reporter, `Connecting ${matchedSourceNode.name} to ${matchedTargetNode.name}...`);
+            const validation = (0, connection_utils_1.validateConnection)(matchedSourceNode, matchedTargetNode, connectionType, nodeTypes);
+            if (!validation.valid) {
+                const connectionError = new errors_1.ConnectionError(validation.error ?? 'Invalid connection', {
+                    fromNodeId: matchedSourceNode.id,
+                    toNodeId: matchedTargetNode.id,
+                });
+                const error = {
+                    message: connectionError.message,
+                    code: 'INVALID_CONNECTION',
+                    details: {
+                        sourceNode: matchedSourceNode.name,
+                        targetNode: matchedTargetNode.name,
+                        connectionType,
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const actualSourceNode = validation.swappedSource ?? matchedSourceNode;
+            const actualTargetNode = validation.swappedTarget ?? matchedTargetNode;
+            const swapped = inferredSwap || !!validation.shouldSwap;
+            const sourceIndex = validatedInput.sourceOutputIndex ?? 0;
+            const targetIndex = validatedInput.targetInputIndex ?? 0;
+            const newConnection = {
+                [actualSourceNode.name]: {
+                    [connectionType]: Array(sourceIndex + 1)
+                        .fill(null)
+                        .map((_, i) => i === sourceIndex
+                        ? [
+                            {
+                                node: actualTargetNode.name,
+                                type: connectionType,
+                                index: targetIndex,
+                            },
+                        ]
+                        : []),
+                },
+            };
+            const message = (0, connection_utils_1.formatConnectionMessage)(actualSourceNode.name, actualTargetNode.name, connectionType, swapped);
+            const output = {
+                sourceNode: actualSourceNode.name,
+                targetNode: actualTargetNode.name,
+                connectionType,
+                swapped,
+                message,
+                found: {
+                    sourceNode: true,
+                    targetNode: true,
+                },
+            };
+            reporter.complete(output);
+            const stateUpdates = (0, state_1.updateWorkflowConnections)(newConnection);
+            return (0, response_1.createSuccessResponse)(config, message, stateUpdates);
+        }
+        catch (error) {
+            let toolError;
+            if (error instanceof zod_1.z.ZodError) {
+                const validationError = new errors_1.ValidationError('Invalid connection parameters', {
+                    field: error.errors[0]?.path.join('.'),
+                    value: error.errors[0]?.message,
+                });
+                toolError = {
+                    message: validationError.message,
+                    code: 'VALIDATION_ERROR',
+                    details: error.errors,
+                };
+            }
+            else {
+                toolError = {
+                    message: error instanceof Error ? error.message : 'Unknown error occurred',
+                    code: 'EXECUTION_ERROR',
+                };
+            }
+            reporter.error(toolError);
+            return (0, response_1.createErrorResponse)(config, toolError);
+        }
+    }, {
+        name: exports.CONNECT_NODES_TOOL.toolName,
+        description: `Connect two nodes in the workflow. The tool automatically determines the connection type based on node capabilities and ensures correct connection direction.
+
+UNDERSTANDING CONNECTIONS:
+- SOURCE NODE: The node that PRODUCES output/provides capability
+- TARGET NODE: The node that RECEIVES input/uses capability
+- Flow direction: Source → Target
+
+AUTOMATIC CONNECTION TYPE DETECTION:
+- The tool analyzes the nodes' inputs and outputs to determine the appropriate connection type
+- If multiple connection types are possible, the tool will provide an error with the available options
+- The connection type is determined by matching compatible input/output types between nodes
+
+For ai_* connections (ai_languageModel, ai_tool, ai_memory, ai_embedding, etc.):
+- Sub-nodes are ALWAYS the source (they provide capabilities)
+- Main nodes are ALWAYS the target (they use capabilities)
+- The tool will AUTO-CORRECT if you specify them backwards
+
+CONNECTION EXAMPLES:
+- OpenAI Chat Model → AI Agent (detects ai_languageModel)
+- Calculator Tool → AI Agent (detects ai_tool)
+- Simple Memory → Basic LLM Chain (detects ai_memory)
+- Embeddings OpenAI → Vector Store (detects ai_embedding)
+- Document Loader → Embeddings OpenAI (detects ai_document)
+- HTTP Request → Set (detects main)`,
+        schema: exports.nodeConnectionSchema,
+    });
+    return {
+        tool: dynamicTool,
+        ...exports.CONNECT_NODES_TOOL,
+    };
+}
+//# sourceMappingURL=connect-nodes.tool.js.map

package/dist/tools/connect-nodes.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-nodes.tool.js","sourceRoot":"","sources":["../../src/tools/connect-nodes.tool.ts"],"names":[],"mappings":";;;AAyDA,wDAwRC;AAjVD,iDAA6C;AAG7C,6BAAwB;AAIxB,sCAKmB;AAEnB,iDAA4E;AAC5E,iDAAgF;AAChF,2CAAkG;AAClG,qDAA0D;AAC1D,+DAIkC;AAMrB,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,YAAY,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,CACR,uMAAuM,CACvM;IACF,YAAY,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,CACR,uMAAuM,CACvM;IACF,iBAAiB,EAAE,OAAC;SAClB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IAClE,gBAAgB,EAAE,OAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;CAC/D,CAAC,CAAC;AAEU,QAAA,kBAAkB,GAAoB;IAClD,QAAQ,EAAE,eAAe;IACzB,YAAY,EAAE,kBAAkB;CAChC,CAAC;AAKF,SAAgB,sBAAsB,CACrC,SAAiC,EACjC,MAAe;IAEf,MAAM,WAAW,GAAG,IAAA,YAAI,EAEvB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,IAAA,iCAAsB,EACtC,MAAM,EACN,0BAAkB,CAAC,QAAQ,EAC3B,0BAAkB,CAAC,YAAY,CAC/B,CAAC;QAEF,IAAI,CAAC;YAEJ,MAAM,cAAc,GAAG,4BAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAGzD,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAG/B,MAAM,KAAK,GAAG,IAAA,wBAAgB,GAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC;YAG3C,IAAA,yBAAc,EAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;YAGxD,IAAI,iBAAiB,GAAG,IAAA,+BAAkB,EAAC,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YACxF,IAAI,iBAAiB,GAAG,IAAA,+BAAkB,EAAC,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAGxF,IAAI,CAAC,iBAAiB,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC9C,MAAM,aAAa,GAAG,CAAC,iBAAiB;oBACvC,CAAC,CAAC,cAAc,CAAC,YAAY;oBAC7B,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC;gBAC/B,MAAM,SAAS,GAAG,IAAI,0BAAiB,CAAC,aAAa,CAAC,CAAC;gBACvD,MAAM,KAAK,GAAG;oBACb,OAAO,EAAE,SAAS,CAAC,OAAO;oBAC1B,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE;wBACR,YAAY,EAAE,cAAc,CAAC,YAAY;wBACzC,YAAY,EAAE,cAAc,CAAC,YAAY;wBACzC,WAAW,EAAE,CAAC,CAAC,iBAAiB;wBAChC,WAAW,EAAE,CAAC,CAAC,iBAAiB;qBAChC;iBACD,CAAC;gBACF,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,IAAA,8BAAmB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;YAGD,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,iBAAkB,CAAC,IAAI,CAAC,CAAC;YACnF,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,iBAAkB,CAAC,IAAI,CAAC,CAAC;YAEnF,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxC,MAAM,WAAW,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBACtF,MAAM,SAAS,GAAG,IAAI,8BAAqB,CAAC,WAAW,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG;oBACb,OAAO,EAAE,SAAS,CAAC,OAAO;oBAC1B,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE;wBACR,UAAU,EAAE,iBAAiB,CAAC,IAAI;wBAClC,UAAU,EAAE,iBAAiB,CAAC,IAAI;qBAClC;iBACD,CAAC;gBACF,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,IAAA,8BAAmB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;YAGD,IAAA,yBAAc,EAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAC;YAEzD,MAAM,EAAE,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC9C,MAAM,EAAE,KAAK,CACZ,0BAA0B,iBAAiB,CAAC,IAAI,OAAO,iBAAiB,CAAC,IAAI,EAAE,CAC/E,CAAC;YAEF,MAAM,WAAW,GAAG,IAAA,sCAAmB,EACtC,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,CACd,CAAC;YAEF,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;gBACvB,MAAM,eAAe,GAAG,IAAI,wBAAe,CAAC,WAAW,CAAC,KAAK,EAAE;oBAC9D,UAAU,EAAE,iBAAiB,CAAC,EAAE;oBAChC,QAAQ,EAAE,iBAAiB,CAAC,EAAE;iBAC9B,CAAC,CAAC;gBACH,MAAM,KAAK,GAAG;oBACb,OAAO,EAAE,eAAe,CAAC,OAAO;oBAChC,IAAI,EAAE,iCAAiC;oBACvC,OAAO,EAAE;wBACR,UAAU,EAAE,iBAAiB,CAAC,IAAI;wBAClC,UAAU,EAAE,iBAAiB,CAAC,IAAI;wBAClC,aAAa,EAAE,WAAW,CAAC,aAAa;qBACxC;iBACD,CAAC;gBACF,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,IAAA,8BAAmB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG;oBACb,OAAO,EAAE,iCAAiC;oBAC1C,IAAI,EAAE,kCAAkC;oBACxC,OAAO,EAAE;wBACR,UAAU,EAAE,iBAAiB,CAAC,IAAI;wBAClC,UAAU,EAAE,iBAAiB,CAAC,IAAI;qBAClC;iBACD,CAAC;gBACF,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,IAAA,8BAAmB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;YAED,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC;YAClD,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,IAAI,KAAK,CAAC;YAGvD,IAAI,YAAY,EAAE,CAAC;gBAClB,MAAM,EAAE,KAAK,CAAC,0CAA0C,CAAC,CAAC;gBAC1D,MAAM,IAAI,GAAG,iBAAiB,CAAC;gBAC/B,iBAAiB,GAAG,iBAAiB,CAAC;gBACtC,iBAAiB,GAAG,IAAI,CAAC;YAC1B,CAAC;YAED,IAAA,yBAAc,EACb,QAAQ,EACR,6BAA6B,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,CACtF,CAAC;YACF,MAAM,EAAE,KAAK,CACZ,qBAAqB,iBAAiB,CAAC,IAAI,OAAO,iBAAiB,CAAC,IAAI,KAAK,cAAc,KAAK,CAChG,CAAC;YAGF,IAAA,yBAAc,EACb,QAAQ,EACR,cAAc,iBAAiB,CAAC,IAAI,OAAO,iBAAiB,CAAC,IAAI,KAAK,CACtE,CAAC;YAGF,MAAM,UAAU,GAAG,IAAA,qCAAkB,EACpC,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,SAAS,CACT,CAAC;YAEF,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACvB,MAAM,eAAe,GAAG,IAAI,wBAAe,CAAC,UAAU,CAAC,KAAK,IAAI,oBAAoB,EAAE;oBACrF,UAAU,EAAE,iBAAiB,CAAC,EAAE;oBAChC,QAAQ,EAAE,iBAAiB,CAAC,EAAE;iBAC9B,CAAC,CAAC;gBACH,MAAM,KAAK,GAAG;oBACb,OAAO,EAAE,eAAe,CAAC,OAAO;oBAChC,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE;wBACR,UAAU,EAAE,iBAAiB,CAAC,IAAI;wBAClC,UAAU,EAAE,iBAAiB,CAAC,IAAI;wBAClC,cAAc;qBACd;iBACD,CAAC;gBACF,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,IAAA,8BAAmB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;YAGD,MAAM,gBAAgB,GAAG,UAAU,CAAC,aAAa,IAAI,iBAAiB,CAAC;YACvE,MAAM,gBAAgB,GAAG,UAAU,CAAC,aAAa,IAAI,iBAAiB,CAAC;YAEvE,MAAM,OAAO,GAAG,YAAY,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;YAIxD,MAAM,WAAW,GAAG,cAAc,CAAC,iBAAiB,IAAI,CAAC,CAAC;YAC1D,MAAM,WAAW,GAAG,cAAc,CAAC,gBAAgB,IAAI,CAAC,CAAC;YAEzD,MAAM,aAAa,GAAkC;gBACpD,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE;oBACxB,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;yBACtC,IAAI,CAAC,IAAI,CAAC;yBACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACb,CAAC,KAAK,WAAW;wBAChB,CAAC,CAAC;4BACA;gCACC,IAAI,EAAE,gBAAgB,CAAC,IAAI;gCAC3B,IAAI,EAAE,cAAc;gCACpB,KAAK,EAAE,WAAW;6BAClB;yBACD;wBACF,CAAC,CAAC,EAAE,CACL;iBACF;aACD,CAAC;YAGF,MAAM,OAAO,GAAG,IAAA,0CAAuB,EACtC,gBAAgB,CAAC,IAAI,EACrB,gBAAgB,CAAC,IAAI,EACrB,cAAc,EACd,OAAO,CACP,CAAC;YAGF,MAAM,MAAM,GAAuB;gBAClC,UAAU,EAAE,gBAAgB,CAAC,IAAI;gBACjC,UAAU,EAAE,gBAAgB,CAAC,IAAI;gBACjC,cAAc;gBACd,OAAO;gBACP,OAAO;gBACP,KAAK,EAAE;oBACN,UAAU,EAAE,IAAI;oBAChB,UAAU,EAAE,IAAI;iBAChB;aACD,CAAC;YACF,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAG1B,MAAM,YAAY,GAAG,IAAA,iCAAyB,EAAC,aAAa,CAAC,CAAC;YAC9D,OAAO,IAAA,gCAAqB,EAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEhB,IAAI,SAAS,CAAC;YAEd,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;gBACjC,MAAM,eAAe,GAAG,IAAI,wBAAe,CAAC,+BAA+B,EAAE;oBAC5E,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;oBACtC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO;iBAC/B,CAAC,CAAC;gBACH,SAAS,GAAG;oBACX,OAAO,EAAE,eAAe,CAAC,OAAO;oBAChC,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,KAAK,CAAC,MAAM;iBACrB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACP,SAAS,GAAG;oBACX,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;oBAC1E,IAAI,EAAE,iBAAiB;iBACvB,CAAC;YACH,CAAC;YAED,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC1B,OAAO,IAAA,8BAAmB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC/C,CAAC;IACF,CAAC,EACD;QACC,IAAI,EAAE,0BAAkB,CAAC,QAAQ;QACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;oCAuBoB;QACjC,MAAM,EAAE,4BAAoB;KAC5B,CACD,CAAC;IAEF,OAAO;QACN,IAAI,EAAE,WAAW;QACjB,GAAG,0BAAkB;KACrB,CAAC;AACH,CAAC"}

package/dist/tools/engines/node-search-engine.d.ts

@@ -0,0 +1,16 @@
+import type { INodeTypeDescription, NodeConnectionType } from 'n8n-workflow';
+import type { NodeSearchResult } from '../../types/nodes';
+export declare const SCORE_WEIGHTS: {
+    readonly CONNECTION_EXACT: 100;
+    readonly CONNECTION_IN_EXPRESSION: 50;
+};
+export declare class NodeSearchEngine {
+    private readonly nodeTypes;
+    constructor(nodeTypes: INodeTypeDescription[]);
+    searchByName(query: string, limit?: number): NodeSearchResult[];
+    searchByConnectionType(connectionType: NodeConnectionType, limit?: number, nameFilter?: string): NodeSearchResult[];
+    formatResult(result: NodeSearchResult): string;
+    private getConnectionScore;
+    static isAiConnectionType(connectionType: string): boolean;
+    static getAiConnectionTypes(): NodeConnectionType[];
+}

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

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeSearchEngine = exports.SCORE_WEIGHTS = void 0;
+const utils_1 = require("@n8n/utils");
+const n8n_workflow_1 = require("n8n-workflow");
+const NODE_SEARCH_KEYS = [
+    { key: 'displayName', weight: 1.5 },
+    { key: 'name', weight: 1.3 },
+    { key: 'codex.alias', weight: 1.0 },
+    { key: 'description', weight: 0.7 },
+];
+exports.SCORE_WEIGHTS = {
+    CONNECTION_EXACT: 100,
+    CONNECTION_IN_EXPRESSION: 50,
+};
+function getLatestVersion(version) {
+    return Array.isArray(version) ? Math.max(...version) : version;
+}
+function dedupeNodes(nodes) {
+    const dedupeCache = {};
+    nodes.forEach((node) => {
+        const cachedNodeType = dedupeCache[node.name];
+        if (!cachedNodeType) {
+            dedupeCache[node.name] = node;
+            return;
+        }
+        const cachedVersion = getLatestVersion(cachedNodeType.version);
+        const nextVersion = getLatestVersion(node.version);
+        if (nextVersion > cachedVersion) {
+            dedupeCache[node.name] = node;
+        }
+    });
+    return Object.values(dedupeCache);
+}
+class NodeSearchEngine {
+    nodeTypes;
+    constructor(nodeTypes) {
+        this.nodeTypes = dedupeNodes(nodeTypes);
+    }
+    searchByName(query, limit = 20) {
+        const searchResults = (0, utils_1.sublimeSearch)(query, this.nodeTypes, NODE_SEARCH_KEYS);
+        return searchResults.slice(0, limit).map(({ item, score }) => ({
+            name: item.name,
+            displayName: item.displayName,
+            description: item.description ?? 'No description available',
+            version: getLatestVersion(item.version),
+            inputs: item.inputs,
+            outputs: item.outputs,
+            score,
+        }));
+    }
+    searchByConnectionType(connectionType, limit = 20, nameFilter) {
+        const nodesWithConnectionType = this.nodeTypes
+            .map((nodeType) => {
+            const connectionScore = this.getConnectionScore(nodeType, connectionType);
+            return connectionScore > 0 ? { nodeType, connectionScore } : null;
+        })
+            .filter((result) => Boolean(result));
+        if (!nameFilter) {
+            return nodesWithConnectionType
+                .sort((a, b) => b.connectionScore - a.connectionScore)
+                .slice(0, limit)
+                .map(({ nodeType, connectionScore }) => ({
+                name: nodeType.name,
+                displayName: nodeType.displayName,
+                version: getLatestVersion(nodeType.version),
+                description: nodeType.description ?? 'No description available',
+                inputs: nodeType.inputs,
+                outputs: nodeType.outputs,
+                score: connectionScore,
+            }));
+        }
+        const nodeTypesOnly = nodesWithConnectionType.map((result) => result.nodeType);
+        const nameFilteredResults = (0, utils_1.sublimeSearch)(nameFilter, nodeTypesOnly, NODE_SEARCH_KEYS);
+        return nameFilteredResults
+            .slice(0, limit)
+            .map(({ item, score: nameScore }) => {
+            const connectionResult = nodesWithConnectionType.find((result) => result.nodeType.name === item.name);
+            const connectionScore = connectionResult?.connectionScore ?? 0;
+            return {
+                name: item.name,
+                version: getLatestVersion(item.version),
+                displayName: item.displayName,
+                description: item.description ?? 'No description available',
+                inputs: item.inputs,
+                outputs: item.outputs,
+                score: connectionScore + nameScore,
+            };
+        });
+    }
+    formatResult(result) {
+        return `
+		<node>
+			<node_name>${result.name}</node_name>
+			<node_version>${result.version}</node_version>
+			<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>`;
+    }
+    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;
+    }
+    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/get-best-practices.tool.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import type { BuilderToolBase } from '../utils/stream-processor';
+export declare const GET_BEST_PRACTICES_TOOL: BuilderToolBase;
+export declare function createGetBestPracticesTool(): {
+    toolName: string;
+    displayTitle: string;
+    getCustomDisplayTitle?: (values: Record<string, unknown>) => string;
+    tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        techniques: z.ZodArray<z.ZodNativeEnum<{
+            readonly SCHEDULING: "scheduling";
+            readonly CHATBOT: "chatbot";
+            readonly FORM_INPUT: "form_input";
+            readonly SCRAPING_AND_RESEARCH: "scraping_and_research";
+            readonly MONITORING: "monitoring";
+            readonly ENRICHMENT: "enrichment";
+            readonly TRIAGE: "triage";
+            readonly CONTENT_GENERATION: "content_generation";
+            readonly DOCUMENT_PROCESSING: "document_processing";
+            readonly DATA_EXTRACTION: "data_extraction";
+            readonly DATA_ANALYSIS: "data_analysis";
+            readonly DATA_TRANSFORMATION: "data_transformation";
+            readonly NOTIFICATION: "notification";
+            readonly KNOWLEDGE_BASE: "knowledge_base";
+            readonly HUMAN_IN_THE_LOOP: "human_in_the_loop";
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        techniques: ("scheduling" | "chatbot" | "form_input" | "scraping_and_research" | "monitoring" | "enrichment" | "triage" | "content_generation" | "document_processing" | "data_extraction" | "data_analysis" | "data_transformation" | "notification" | "knowledge_base" | "human_in_the_loop")[];
+    }, {
+        techniques: ("scheduling" | "chatbot" | "form_input" | "scraping_and_research" | "monitoring" | "enrichment" | "triage" | "content_generation" | "document_processing" | "data_extraction" | "data_analysis" | "data_transformation" | "notification" | "knowledge_base" | "human_in_the_loop")[];
+    }>, unknown, {
+        techniques: ("scheduling" | "chatbot" | "form_input" | "scraping_and_research" | "monitoring" | "enrichment" | "triage" | "content_generation" | "document_processing" | "data_extraction" | "data_analysis" | "data_transformation" | "notification" | "knowledge_base" | "human_in_the_loop")[];
+    }, import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
+};

package/dist/tools/get-best-practices.tool.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_BEST_PRACTICES_TOOL = void 0;
+exports.createGetBestPracticesTool = createGetBestPracticesTool;
+const tools_1 = require("@langchain/core/tools");
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+const best_practices_1 = require("../tools/best-practices");
+const progress_1 = require("../tools/helpers/progress");
+const response_1 = require("../tools/helpers/response");
+const categorization_1 = require("../types/categorization");
+const getBestPracticesSchema = zod_1.z.object({
+    techniques: zod_1.z
+        .array(zod_1.z.nativeEnum(categorization_1.WorkflowTechnique))
+        .min(1)
+        .describe('List of workflow techniques to retrieve best practices for'),
+});
+function formatBestPractices(techniques) {
+    const parts = [];
+    const foundDocs = [];
+    for (const technique of techniques) {
+        const doc = best_practices_1.documentation[technique];
+        if (doc) {
+            foundDocs.push(doc.getDocumentation());
+        }
+    }
+    if (foundDocs.length > 0) {
+        parts.push('<best_practices>');
+        parts.push(foundDocs.join('\n---\n'));
+        parts.push('</best_practices>');
+    }
+    return parts.join('\n');
+}
+exports.GET_BEST_PRACTICES_TOOL = {
+    toolName: 'get_best_practices',
+    displayTitle: 'Getting best practices',
+};
+function createGetBestPracticesTool() {
+    const dynamicTool = (0, tools_1.tool)((input, config) => {
+        const reporter = (0, progress_1.createProgressReporter)(config, exports.GET_BEST_PRACTICES_TOOL.toolName, exports.GET_BEST_PRACTICES_TOOL.displayTitle);
+        try {
+            const validatedInput = getBestPracticesSchema.parse(input);
+            const { techniques } = validatedInput;
+            reporter.start(validatedInput);
+            reporter.progress(`Retrieving best practices for ${techniques.length} technique(s)...`);
+            const availableDocs = techniques.filter((technique) => best_practices_1.documentation[technique]);
+            if (availableDocs.length === 0) {
+                const message = `No best practices documentation available for the requested techniques: ${techniques.join(', ')}`;
+                reporter.complete({ techniques, found: 0 });
+                return (0, response_1.createSuccessResponse)(config, message);
+            }
+            const message = formatBestPractices(techniques);
+            reporter.complete({
+                techniques,
+                found: availableDocs.length,
+                missing: techniques.length - availableDocs.length,
+            });
+            return (0, response_1.createSuccessResponse)(config, message);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                const validationError = new errors_1.ValidationError('Invalid input parameters', {
+                    extra: { errors: error.errors },
+                });
+                reporter.error(validationError);
+                return (0, response_1.createErrorResponse)(config, validationError);
+            }
+            const toolError = new errors_1.ToolExecutionError(error instanceof Error ? error.message : 'Unknown error occurred', {
+                toolName: exports.GET_BEST_PRACTICES_TOOL.toolName,
+                cause: error instanceof Error ? error : undefined,
+            });
+            reporter.error(toolError);
+            return (0, response_1.createErrorResponse)(config, toolError);
+        }
+    }, {
+        name: exports.GET_BEST_PRACTICES_TOOL.toolName,
+        description: `Retrieve best practices documentation for specific workflow techniques.
+
+Use this tool after categorizing a user's prompt to get relevant guidance on:
+- Recommended nodes and their purposes
+- Common pitfalls to avoid
+- Performance and resource management tips
+- Implementation patterns and best practices
+- General tips on building workflows that utilise the provided techniques
+
+This helps build better workflows by applying proven patterns and avoiding common mistakes.`,
+        schema: getBestPracticesSchema,
+    });
+    return {
+        tool: dynamicTool,
+        ...exports.GET_BEST_PRACTICES_TOOL,
+    };
+}
+//# sourceMappingURL=get-best-practices.tool.js.map

package/dist/tools/get-best-practices.tool.js.map

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

package/dist/tools/get-node-examples.tool.d.ts

@@ -0,0 +1,119 @@
+import type { Logger } from '@n8n/backend-common';
+import { z } from 'zod';
+export type NodeExampleType = 'configuration' | 'connections';
+interface CreateNodeExamplesToolOptions {
+    exampleType: NodeExampleType;
+    logger?: Logger;
+}
+export declare function createGetNodeExamplesTool({ exampleType, logger }: CreateNodeExamplesToolOptions): {
+    toolName: string;
+    displayTitle: string;
+    getCustomDisplayTitle?: (values: Record<string, unknown>) => string;
+    tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            nodeType: z.ZodString;
+            nodeVersion: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }, {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }>, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
+};
+export declare const createGetNodeConfigurationExamplesTool: (logger?: Logger) => {
+    toolName: string;
+    displayTitle: string;
+    getCustomDisplayTitle?: (values: Record<string, unknown>) => string;
+    tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            nodeType: z.ZodString;
+            nodeVersion: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }, {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }>, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
+};
+export declare const createGetNodeConnectionExamplesTool: (logger?: Logger) => {
+    toolName: string;
+    displayTitle: string;
+    getCustomDisplayTitle?: (values: Record<string, unknown>) => string;
+    tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            nodeType: z.ZodString;
+            nodeVersion: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }, {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }>, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, {
+        nodes: {
+            nodeType: string;
+            nodeVersion?: number | undefined;
+        }[];
+    }, import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
+};
+export {};