@n8n/ai-workflow-builder 0.25.0 → 0.26.0

package/dist/tools/builder-tools.js

@@ -7,6 +7,7 @@ const connect_nodes_tool_1 = require("./connect-nodes.tool");
 const get_node_parameter_tool_1 = require("./get-node-parameter.tool");
 const node_details_tool_1 = require("./node-details.tool");
 const node_search_tool_1 = require("./node-search.tool");
+const remove_connection_tool_1 = require("./remove-connection.tool");
 const remove_node_tool_1 = require("./remove-node.tool");
 const update_node_parameters_tool_1 = require("./update-node-parameters.tool");
 function getBuilderTools({ parsedNodeTypes, logger, llmComplexTask, instanceUrl, }) {
@@ -15,6 +16,7 @@ function getBuilderTools({ parsedNodeTypes, logger, llmComplexTask, instanceUrl,
         (0, node_details_tool_1.createNodeDetailsTool)(parsedNodeTypes),
         (0, add_node_tool_1.createAddNodeTool)(parsedNodeTypes),
         (0, connect_nodes_tool_1.createConnectNodesTool)(parsedNodeTypes, logger),
+        (0, remove_connection_tool_1.createRemoveConnectionTool)(logger),
         (0, remove_node_tool_1.createRemoveNodeTool)(logger),
         (0, update_node_parameters_tool_1.createUpdateNodeParametersTool)(parsedNodeTypes, llmComplexTask, logger, instanceUrl),
         (0, get_node_parameter_tool_1.createGetNodeParameterTool)(),
@@ -26,6 +28,7 @@ function getBuilderToolsForDisplay({ nodeTypes, }) {
         node_details_tool_1.NODE_DETAILS_TOOL,
         (0, add_node_tool_1.getAddNodeToolBase)(nodeTypes),
         connect_nodes_tool_1.CONNECT_NODES_TOOL,
+        remove_connection_tool_1.REMOVE_CONNECTION_TOOL,
         remove_node_tool_1.REMOVE_NODE_TOOL,
         update_node_parameters_tool_1.UPDATING_NODE_PARAMETER_TOOL,
         get_node_parameter_tool_1.GET_NODE_PARAMETER_TOOL,

package/dist/tools/builder-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder-tools.js","sourceRoot":"","sources":["../../src/tools/builder-tools.ts"],"names":[],"mappings":";;AAiBA,0CAoBC;AAOD,8DAYC;AAlDD,mDAAwE;AACxE,6DAAkF;AAClF,uEAAgG;AAChG,2DAA+E;AAC/E,yDAA4E;AAC5E,yDAA4E;AAC5E,+EAGuC;AAEvC,SAAgB,eAAe,CAAC,EAC/B,eAAe,EACf,MAAM,EACN,cAAc,EACd,WAAW,GAMX;IACA,OAAO;QACN,IAAA,uCAAoB,EAAC,eAAe,CAAC;QACrC,IAAA,yCAAqB,EAAC,eAAe,CAAC;QACtC,IAAA,iCAAiB,EAAC,eAAe,CAAC;QAClC,IAAA,2CAAsB,EAAC,eAAe,EAAE,MAAM,CAAC;QAC/C,IAAA,uCAAoB,EAAC,MAAM,CAAC;QAC5B,IAAA,4DAA8B,EAAC,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC;QACpF,IAAA,oDAA0B,GAAE;KAC5B,CAAC;AACH,CAAC;AAOD,SAAgB,yBAAyB,CAAC,EACzC,SAAS,GAC8B;IACvC,OAAO;QACN,mCAAgB;QAChB,qCAAiB;QACjB,IAAA,kCAAkB,EAAC,SAAS,CAAC;QAC7B,uCAAkB;QAClB,mCAAgB;QAChB,0DAA4B;QAC5B,iDAAuB;KACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"builder-tools.js","sourceRoot":"","sources":["../../src/tools/builder-tools.ts"],"names":[],"mappings":";;AAkBA,0CAqBC;AAOD,8DAaC;AArDD,mDAAwE;AACxE,6DAAkF;AAClF,uEAAgG;AAChG,2DAA+E;AAC/E,yDAA4E;AAC5E,qEAA8F;AAC9F,yDAA4E;AAC5E,+EAGuC;AAEvC,SAAgB,eAAe,CAAC,EAC/B,eAAe,EACf,MAAM,EACN,cAAc,EACd,WAAW,GAMX;IACA,OAAO;QACN,IAAA,uCAAoB,EAAC,eAAe,CAAC;QACrC,IAAA,yCAAqB,EAAC,eAAe,CAAC;QACtC,IAAA,iCAAiB,EAAC,eAAe,CAAC;QAClC,IAAA,2CAAsB,EAAC,eAAe,EAAE,MAAM,CAAC;QAC/C,IAAA,mDAA0B,EAAC,MAAM,CAAC;QAClC,IAAA,uCAAoB,EAAC,MAAM,CAAC;QAC5B,IAAA,4DAA8B,EAAC,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC;QACpF,IAAA,oDAA0B,GAAE;KAC5B,CAAC;AACH,CAAC;AAOD,SAAgB,yBAAyB,CAAC,EACzC,SAAS,GAC8B;IACvC,OAAO;QACN,mCAAgB;QAChB,qCAAiB;QACjB,IAAA,kCAAkB,EAAC,SAAS,CAAC;QAC7B,uCAAkB;QAClB,+CAAsB;QACtB,mCAAgB;QAChB,0DAA4B;QAC5B,iDAAuB;KACvB,CAAC;AACH,CAAC"}

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

@@ -11,3 +11,4 @@ export declare function removeNodeFromWorkflow(nodeId: string): Partial<typeof W
 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>;
+export declare function removeConnectionFromWorkflow(sourceNode: string, targetNode: string, connectionType: string, sourceOutputIndex: number, targetInputIndex: number): Partial<typeof WorkflowState.State>;

package/dist/tools/helpers/state.js

@@ -10,6 +10,7 @@ exports.removeNodeFromWorkflow = removeNodeFromWorkflow;
 exports.removeNodesFromWorkflow = removeNodesFromWorkflow;
 exports.updateNodeInWorkflow = updateNodeInWorkflow;
 exports.addConnectionToWorkflow = addConnectionToWorkflow;
+exports.removeConnectionFromWorkflow = removeConnectionFromWorkflow;
 const langgraph_1 = require("@langchain/langgraph");
 function getCurrentWorkflow(state) {
     return state.workflowJSON;
@@ -67,4 +68,18 @@ function addConnectionToWorkflow(sourceNodeId, _targetNodeId, connection) {
         ],
     };
 }
+function removeConnectionFromWorkflow(sourceNode, targetNode, connectionType, sourceOutputIndex, targetInputIndex) {
+    return {
+        workflowOperations: [
+            {
+                type: 'removeConnection',
+                sourceNode,
+                targetNode,
+                connectionType,
+                sourceOutputIndex,
+                targetInputIndex,
+            },
+        ],
+    };
+}
 //# sourceMappingURL=state.js.map

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

@@ -1 +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"}
+{"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;AAKD,oEAmBC;AAzID,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;AAKD,SAAgB,4BAA4B,CAC3C,UAAkB,EAClB,UAAkB,EAClB,cAAsB,EACtB,iBAAyB,EACzB,gBAAwB;IAExB,OAAO;QACN,kBAAkB,EAAE;YACnB;gBACC,IAAI,EAAE,kBAAkB;gBACxB,UAAU;gBACV,UAAU;gBACV,cAAc;gBACd,iBAAiB;gBACjB,gBAAgB;aAChB;SACD;KACD,CAAC;AACH,CAAC"}

package/dist/tools/remove-connection.tool.d.ts

@@ -0,0 +1,24 @@
+import type { Logger } from '@n8n/backend-common';
+import { z } from 'zod';
+import type { BuilderTool, BuilderToolBase } from '../utils/stream-processor';
+export declare const removeConnectionSchema: z.ZodObject<{
+    sourceNodeId: z.ZodString;
+    targetNodeId: z.ZodString;
+    connectionType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    sourceOutputIndex: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    targetInputIndex: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    connectionType: string;
+    sourceOutputIndex: number;
+    targetInputIndex: number;
+    sourceNodeId: string;
+    targetNodeId: string;
+}, {
+    sourceNodeId: string;
+    targetNodeId: string;
+    connectionType?: string | undefined;
+    sourceOutputIndex?: number | undefined;
+    targetInputIndex?: number | undefined;
+}>;
+export declare const REMOVE_CONNECTION_TOOL: BuilderToolBase;
+export declare function createRemoveConnectionTool(logger?: Logger): BuilderTool;

package/dist/tools/remove-connection.tool.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REMOVE_CONNECTION_TOOL = exports.removeConnectionSchema = void 0;
+exports.createRemoveConnectionTool = createRemoveConnectionTool;
+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");
+exports.removeConnectionSchema = zod_1.z.object({
+    sourceNodeId: zod_1.z
+        .string()
+        .describe('The UUID of the source node where the connection originates from'),
+    targetNodeId: zod_1.z.string().describe('The UUID of the target node where the connection goes to'),
+    connectionType: zod_1.z
+        .string()
+        .optional()
+        .default('main')
+        .describe('The type of connection to remove (default: "main")'),
+    sourceOutputIndex: zod_1.z
+        .number()
+        .optional()
+        .default(0)
+        .describe('The index of the output to disconnect from (default: 0)'),
+    targetInputIndex: zod_1.z
+        .number()
+        .optional()
+        .default(0)
+        .describe('The index of the input to disconnect from (default: 0)'),
+});
+exports.REMOVE_CONNECTION_TOOL = {
+    toolName: 'remove_connection',
+    displayTitle: 'Removing connection',
+};
+function buildResponseMessage(sourceNodeName, targetNodeName, connectionType, sourceOutputIndex, targetInputIndex) {
+    const parts = [
+        `Successfully removed connection: ${sourceNodeName} → ${targetNodeName} (${connectionType})`,
+    ];
+    if (sourceOutputIndex !== 0 || targetInputIndex !== 0) {
+        parts.push(`Output index: ${sourceOutputIndex}, Input index: ${targetInputIndex}`);
+    }
+    return parts.join('\n');
+}
+function createRemoveConnectionTool(logger) {
+    const dynamicTool = (0, tools_1.tool)((input, config) => {
+        const reporter = (0, progress_1.createProgressReporter)(config, exports.REMOVE_CONNECTION_TOOL.toolName, exports.REMOVE_CONNECTION_TOOL.displayTitle);
+        try {
+            const validatedInput = exports.removeConnectionSchema.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 disconnect...');
+            const sourceNode = (0, validation_1.validateNodeExists)(validatedInput.sourceNodeId, workflow.nodes);
+            const targetNode = (0, validation_1.validateNodeExists)(validatedInput.targetNodeId, workflow.nodes);
+            if (!sourceNode || !targetNode) {
+                const missingNodeId = !sourceNode
+                    ? 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: !!sourceNode,
+                        foundTarget: !!targetNode,
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            logger?.debug('\n=== Remove Connection Tool ===');
+            logger?.debug(`Attempting to remove connection: ${sourceNode.name} -> ${targetNode.name} (${validatedInput.connectionType})`);
+            (0, progress_1.reportProgress)(reporter, `Removing connection from ${sourceNode.name} to ${targetNode.name}...`);
+            const sourceConnections = workflow.connections[sourceNode.name];
+            if (!sourceConnections) {
+                const connectionError = new errors_1.ConnectionError(`Source node "${sourceNode.name}" has no outgoing connections`, {
+                    fromNodeId: sourceNode.id,
+                    toNodeId: targetNode.id,
+                });
+                const error = {
+                    message: connectionError.message,
+                    code: 'CONNECTION_NOT_FOUND',
+                    details: {
+                        sourceNode: sourceNode.name,
+                        targetNode: targetNode.name,
+                        connectionType: validatedInput.connectionType,
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const connectionTypeOutputs = sourceConnections[validatedInput.connectionType];
+            if (!connectionTypeOutputs || !Array.isArray(connectionTypeOutputs)) {
+                const connectionError = new errors_1.ConnectionError(`Source node "${sourceNode.name}" has no connections of type "${validatedInput.connectionType}"`, {
+                    fromNodeId: sourceNode.id,
+                    toNodeId: targetNode.id,
+                });
+                const error = {
+                    message: connectionError.message,
+                    code: 'CONNECTION_TYPE_NOT_FOUND',
+                    details: {
+                        sourceNode: sourceNode.name,
+                        targetNode: targetNode.name,
+                        connectionType: validatedInput.connectionType,
+                        availableConnectionTypes: Object.keys(sourceConnections),
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const outputConnections = connectionTypeOutputs[validatedInput.sourceOutputIndex];
+            if (!outputConnections || !Array.isArray(outputConnections)) {
+                const connectionError = new errors_1.ConnectionError(`Source node "${sourceNode.name}" has no connections at output index ${validatedInput.sourceOutputIndex}`, {
+                    fromNodeId: sourceNode.id,
+                    toNodeId: targetNode.id,
+                });
+                const error = {
+                    message: connectionError.message,
+                    code: 'OUTPUT_INDEX_NOT_FOUND',
+                    details: {
+                        sourceNode: sourceNode.name,
+                        targetNode: targetNode.name,
+                        connectionType: validatedInput.connectionType,
+                        sourceOutputIndex: validatedInput.sourceOutputIndex,
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const connectionExists = outputConnections.some((conn) => conn.node === targetNode.name &&
+                conn.type === validatedInput.connectionType &&
+                conn.index === validatedInput.targetInputIndex);
+            if (!connectionExists) {
+                const connectionError = new errors_1.ConnectionError(`Connection not found: ${sourceNode.name} → ${targetNode.name} (${validatedInput.connectionType}) at output ${validatedInput.sourceOutputIndex} to input ${validatedInput.targetInputIndex}`, {
+                    fromNodeId: sourceNode.id,
+                    toNodeId: targetNode.id,
+                });
+                const error = {
+                    message: connectionError.message,
+                    code: 'SPECIFIC_CONNECTION_NOT_FOUND',
+                    details: {
+                        sourceNode: sourceNode.name,
+                        targetNode: targetNode.name,
+                        connectionType: validatedInput.connectionType,
+                        sourceOutputIndex: validatedInput.sourceOutputIndex,
+                        targetInputIndex: validatedInput.targetInputIndex,
+                        existingConnections: outputConnections.map((conn) => ({
+                            node: conn.node,
+                            type: conn.type,
+                            index: conn.index,
+                        })),
+                    },
+                };
+                reporter.error(error);
+                return (0, response_1.createErrorResponse)(config, error);
+            }
+            const message = buildResponseMessage(sourceNode.name, targetNode.name, validatedInput.connectionType, validatedInput.sourceOutputIndex, validatedInput.targetInputIndex);
+            logger?.debug('Connection found and will be removed');
+            const output = {
+                sourceNode: sourceNode.name,
+                targetNode: targetNode.name,
+                connectionType: validatedInput.connectionType,
+                sourceOutputIndex: validatedInput.sourceOutputIndex,
+                targetInputIndex: validatedInput.targetInputIndex,
+                message,
+            };
+            reporter.complete(output);
+            const stateUpdates = (0, state_1.removeConnectionFromWorkflow)(sourceNode.name, targetNode.name, validatedInput.connectionType, validatedInput.sourceOutputIndex, validatedInput.targetInputIndex);
+            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 removal 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.REMOVE_CONNECTION_TOOL.toolName,
+        description: `Remove a specific connection between two nodes in the workflow. This allows you to disconnect nodes without deleting them.
+
+USAGE:
+Use this tool when you need to break an existing connection while keeping both nodes in the workflow.
+
+PARAMETERS:
+- sourceNodeId: The UUID of the node that is the source of the connection (where the data comes from)
+- targetNodeId: The UUID of the node that receives the connection (where the data goes to)
+- connectionType: The type of connection to remove (default: "main")
+  * For regular data flow: "main"
+  * For AI connections: "ai_languageModel", "ai_tool", "ai_memory", "ai_embedding", "ai_document", etc.
+- sourceOutputIndex: Which output of the source node to disconnect from (default: 0)
+- targetInputIndex: Which input of the target node to disconnect from (default: 0)
+
+EXAMPLES:
+1. Remove main data connection:
+   sourceNodeId: "abc-123", targetNodeId: "def-456", connectionType: "main"
+
+2. Remove AI model from AI Agent:
+   sourceNodeId: "model-id", targetNodeId: "agent-id", connectionType: "ai_languageModel"
+
+3. Remove specific connection when multiple exist:
+   sourceNodeId: "node-1", targetNodeId: "node-2", connectionType: "main", sourceOutputIndex: 1, targetInputIndex: 0
+
+NOTES:
+- Both nodes must exist in the workflow
+- The specific connection must exist or an error will be returned
+- Use this when restructuring workflows or replacing connections`,
+        schema: exports.removeConnectionSchema,
+    });
+    return {
+        tool: dynamicTool,
+        ...exports.REMOVE_CONNECTION_TOOL,
+    };
+}
+//# sourceMappingURL=remove-connection.tool.js.map

package/dist/tools/remove-connection.tool.js.map

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

package/dist/types/tools.d.ts

@@ -81,3 +81,11 @@ export interface NodeSearchOutput {
 export interface GetNodeParameterOutput {
     message: string;
 }
+export interface RemoveConnectionOutput {
+    sourceNode: string;
+    targetNode: string;
+    connectionType: string;
+    sourceOutputIndex: number;
+    targetInputIndex: number;
+    message: string;
+}

package/dist/types/workflow.d.ts

@@ -18,6 +18,13 @@ export type WorkflowOperation = {
 } | {
     type: 'mergeConnections';
     connections: IConnections;
+} | {
+    type: 'removeConnection';
+    sourceNode: string;
+    targetNode: string;
+    connectionType: string;
+    sourceOutputIndex: number;
+    targetInputIndex: number;
 } | {
     type: 'setName';
     name: string;

package/dist/utils/cleanup-dangling-tool-call-messages.d.ts

@@ -0,0 +1,3 @@
+import type { BaseMessage } from '@langchain/core/messages';
+import { RemoveMessage } from '@langchain/core/messages';
+export declare function cleanupDanglingToolCallMessages(messages: BaseMessage[]): RemoveMessage[];

package/dist/utils/cleanup-dangling-tool-call-messages.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupDanglingToolCallMessages = cleanupDanglingToolCallMessages;
+const messages_1 = require("@langchain/core/messages");
+function cleanupDanglingToolCallMessages(messages) {
+    const toolCallIds = new Set(messages.filter((m) => m instanceof messages_1.ToolMessage).map((m) => m.tool_call_id));
+    const danglingToolCalls = messages.filter((m) => m instanceof messages_1.AIMessage && m.tool_calls?.some(({ id }) => id && !toolCallIds.has(id)));
+    return danglingToolCalls.map((m) => new messages_1.RemoveMessage({ id: m.id }));
+}
+//# sourceMappingURL=cleanup-dangling-tool-call-messages.js.map

package/dist/utils/cleanup-dangling-tool-call-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-dangling-tool-call-messages.js","sourceRoot":"","sources":["../../src/utils/cleanup-dangling-tool-call-messages.ts"],"names":[],"mappings":";;AASA,0EAcC;AAtBD,uDAAiF;AAQjF,SAAgB,+BAA+B,CAAC,QAAuB;IAEtE,MAAM,WAAW,GAAG,IAAI,GAAG,CAC1B,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,YAAY,sBAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAC7F,CAAC;IAIF,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,oBAAS,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAC3F,CAAC;IAGF,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,wBAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAG,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC"}