@n8n/ai-workflow-builder 0.2.0

package/dist/chains/connection-composer.d.ts

@@ -0,0 +1,10 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import { SystemMessage } from '@langchain/core/messages';
+export declare const connectionComposerPrompt: SystemMessage;
+export declare const connectionComposerChain: (llm: BaseChatModel) => import("@langchain/core/runnables").Runnable<any, Record<string, {
+    main: {
+        type: "main";
+        node: string;
+        index: number;
+    }[][];
+}>, import("@langchain/core/runnables").RunnableConfig<Record<string, any>>>;

package/dist/chains/connection-composer.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectionComposerChain = exports.connectionComposerPrompt = void 0;
+const messages_1 = require("@langchain/core/messages");
+const prompts_1 = require("@langchain/core/prompts");
+const tools_1 = require("@langchain/core/tools");
+const n8n_workflow_1 = require("n8n-workflow");
+const zod_1 = require("zod");
+exports.connectionComposerPrompt = new messages_1.SystemMessage(`You are an expert in creating n8n workflow connections. Your job is to create a valid n8n workflow by connecting nodes in a logical sequence.
+
+## Your Task
+Create connections between nodes that form a coherent, executable workflow based on the user's request.
+
+## Input Format
+You will receive a list of n8n nodes with their details in <node> tags:
+\`\`\`
+<node>
+  {
+    "name": "Node display name",
+    "type": "n8n-nodes-base.nodeType",
+    "parameters": { ... },
+    "position": [x, y]
+  }
+</node>
+\`\`\`
+
+## n8n Connection Structure
+In n8n workflows:
+1. Data flows from one node to the next through connections
+2. Connections are defined in the "connections" object
+3. Each node's output can connect to one or more nodes' inputs
+4. Each connection has a source node, target node, and IO indices
+
+## Connection Format
+\`\`\`json
+{
+  "connections": {
+    "Source Node Display Name": {
+      "main": [
+        [
+          {
+            "node": "Target Node Display Name",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  }
+}
+\`\`\`
+
+## Rules for Creating Connections
+1. ALWAYS use the node "name" field (display name) for the connection references
+2. Create a logical flow from trigger/input nodes to output/action nodes
+3. Each node MUST connect to at least one other node (except terminal nodes)
+4. Don't create loops or cycles in the workflow
+5. Ensure the output data from one node is compatible with the input expected by the next node
+6. For nodes with multiple outputs (like IF nodes), connect each output appropriately:
+   - For IF nodes, first output (index 0) is the TRUE branch, second output (index 1) is the FALSE branch
+   - For Switch nodes, each output (starting at index 0) corresponds to a different case
+
+## Common Workflow Patterns
+1. Trigger → Process → Action
+2. Data Source → Filter/Transform → Destination
+3. Scheduled Trigger → HTTP Request → Process Response → Send Notification
+4. Conditional Branch: Previous Node → IF Node → [True Branch, False Branch]
+
+## Output
+Return ONLY a valid JSON object with the "connections" property following the structure above:
+\`\`\`json
+{
+  "connections": {
+    "NodeName1": {
+      "main": [[{ "node": "NodeName2", "type": "main", "index": 0 }]]
+    },
+    "NodeName2": {
+      "main": [
+        [{ "node": "TrueBranchNode", "type": "main", "index": 0 }],
+        [{ "node": "FalseBranchNode", "type": "main", "index": 0 }]
+      ]
+    },
+    ...
+  }
+}
+\`\`\``);
+const connectionsSchema = zod_1.z.object({
+    connections: zod_1.z
+        .record(zod_1.z
+        .string()
+        .describe('The source node\'s display name exactly as specified in the node\'s "name" field'), zod_1.z
+        .object({
+        main: zod_1.z.array(zod_1.z.array(zod_1.z.object({
+            node: zod_1.z
+                .string()
+                .describe('The target node\'s display name exactly as specified in the node\'s "name" field'),
+            type: zod_1.z
+                .literal('main')
+                .describe('The connection type, always use "main" for standard n8n connections'),
+            index: zod_1.z
+                .number()
+                .describe('Output index from the source node, typically 0 for single-output nodes, 0=true/1=false for IF nodes'),
+        }))),
+    })
+        .describe('The connection configuration for a single source node'))
+        .describe('A mapping of all connections in the workflow, where each key is a source node name'),
+});
+const connectionComposerTool = new tools_1.DynamicStructuredTool({
+    name: 'compose_connections',
+    description: "Create valid connections between n8n nodes to form a coherent, executable workflow that implements the user's request.",
+    schema: connectionsSchema,
+    func: async (input) => {
+        return { connections: input.connections };
+    },
+});
+const humanTemplate = '{workflowJSON}';
+const chatPrompt = prompts_1.ChatPromptTemplate.fromMessages([
+    exports.connectionComposerPrompt,
+    prompts_1.HumanMessagePromptTemplate.fromTemplate(humanTemplate),
+]);
+const connectionComposerChain = (llm) => {
+    if (!llm.bindTools) {
+        throw new n8n_workflow_1.OperationalError("LLM doesn't support binding tools");
+    }
+    return chatPrompt
+        .pipe(llm.bindTools([connectionComposerTool], {
+        tool_choice: connectionComposerTool.name,
+    }))
+        .pipe((x) => {
+        const toolCall = x.tool_calls?.[0];
+        return (toolCall?.args).connections;
+    });
+};
+exports.connectionComposerChain = connectionComposerChain;
+//# sourceMappingURL=connection-composer.js.map

package/dist/chains/connection-composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-composer.js","sourceRoot":"","sources":["../../src/chains/connection-composer.ts"],"names":[],"mappings":";;;AAEA,uDAAyD;AACzD,qDAAyF;AACzF,iDAA8D;AAC9D,+CAAgD;AAChD,6BAAwB;AAEX,QAAA,wBAAwB,GAAG,IAAI,wBAAa,CACxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6EM,CACN,CAAC;AAEF,MAAM,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,WAAW,EAAE,OAAC;SACZ,MAAM,CACN,OAAC;SACC,MAAM,EAAE;SACR,QAAQ,CACR,kFAAkF,CAClF,EACF,OAAC;SACC,MAAM,CAAC;QACP,IAAI,EAAE,OAAC,CAAC,KAAK,CACZ,OAAC,CAAC,KAAK,CACN,OAAC,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CACR,kFAAkF,CAClF;YACF,IAAI,EAAE,OAAC;iBACL,OAAO,CAAC,MAAM,CAAC;iBACf,QAAQ,CAAC,qEAAqE,CAAC;YACjF,KAAK,EAAE,OAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CACR,qGAAqG,CACrG;SACF,CAAC,CACF,CACD;KACD,CAAC;SACD,QAAQ,CAAC,uDAAuD,CAAC,CACnE;SACA,QAAQ,CAAC,oFAAoF,CAAC;CAChG,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,IAAI,6BAAqB,CAAC;IACxD,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACV,wHAAwH;IACzH,MAAM,EAAE,iBAAiB;IACzB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,gBAAgB,CAAC;AACvC,MAAM,UAAU,GAAG,4BAAkB,CAAC,YAAY,CAAC;IAClD,gCAAwB;IACxB,oCAA0B,CAAC,YAAY,CAAC,aAAa,CAAC;CACtD,CAAC,CAAC;AAEI,MAAM,uBAAuB,GAAG,CAAC,GAAkB,EAAE,EAAE;IAC7D,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,+BAAgB,CAAC,mCAAmC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,UAAU;SACf,IAAI,CACJ,GAAG,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC,EAAE;QACvC,WAAW,EAAE,sBAAsB,CAAC,IAAI;KACxC,CAAC,CACF;SACA,IAAI,CAAC,CAAC,CAAiB,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,QAAQ,EAAE,IAA0C,CAAA,CAAC,WAAW,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAfW,QAAA,uBAAuB,2BAelC"}

package/dist/chains/node-selector.d.ts

@@ -0,0 +1,8 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import { SystemMessage } from '@langchain/core/messages';
+export declare const nodeSelectorPrompt: SystemMessage;
+export declare const nodesSelectionChain: (llm: BaseChatModel) => import("@langchain/core/runnables").Runnable<any, {
+    node: string;
+    score: number;
+    reasoning: string;
+}[], import("@langchain/core/runnables").RunnableConfig<Record<string, any>>>;

package/dist/chains/node-selector.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodesSelectionChain = exports.nodeSelectorPrompt = void 0;
+const messages_1 = require("@langchain/core/messages");
+const prompts_1 = require("@langchain/core/prompts");
+const tools_1 = require("@langchain/core/tools");
+const n8n_workflow_1 = require("n8n-workflow");
+const zod_1 = require("zod");
+exports.nodeSelectorPrompt = new messages_1.SystemMessage(`You are an expert in n8n workflows who selects the optimal n8n nodes to implement workflow steps.
+
+## Your Task
+For each workflow step, recommend the most appropriate n8n nodes from the allowed list.
+
+## Input Information
+- <user_request>: Original user workflow request
+- <steps>: List of workflow steps to implement
+- <allowed_n8n_nodes>: List of available n8n nodes with descriptions
+
+## CRITICAL REQUIREMENTS
+- ONLY recommend nodes that EXACTLY match names from the <allowed_n8n_nodes> list
+- NEVER suggest nodes that are not explicitly defined in <allowed_n8n_nodes>
+- ALWAYS use the COMPLETE node name as it appears in <node_name> tags (e.g., "Gmail" is NOT sufficient if the node name is "n8n-nodes-base.gmail")
+- VERIFY each recommended node exists in the allowed list before including it
+
+## Selection Criteria
+1. Functionality - Node must be able to perform the required action
+2. Integration - Prefer nodes that integrate directly with services mentioned in the user request
+3. Efficiency - Prefer nodes that accomplish the task with minimal configuration
+
+## Output Requirements
+For the planned workflow steps, provider:
+1. List of all possibly useful nodes in order of preference
+2. Concise reasoning for why each node is suitable
+3. Use EXACT, FULL node names from <node_name> tags
+4. Pay attention to case sensitivity, e.g. "n8n-nodes-base.msql" is NOT "n8n-nodes-base.mySql"!
+
+Remember: ONLY use nodes from the <allowed_n8n_nodes> list and ALWAYS use their FULL names exactly as provided.`);
+const nodeSelectorSchema = zod_1.z.object({
+    recommended_nodes: zod_1.z
+        .array(zod_1.z.object({
+        score: zod_1.z.number().describe('Matching score of the node for all the workflows steps'),
+        node: zod_1.z
+            .string()
+            .describe('The full node type identifier (e.g., "n8n-nodes-base.if") from <allowed_n8n_nodes> list'),
+        reasoning: zod_1.z
+            .string()
+            .describe('Very short explanation of why this node might be used to implement the workflow step'),
+    }))
+        .min(1)
+        .max(20)
+        .describe('Recommended n8n nodes for implementing any of the workflow steps, in order of descending preference. ONLY use nodes from the <allowed_n8n_nodes> list with EXACT full names from <node_name> tags.'),
+});
+const nodeSelectorTool = new tools_1.DynamicStructuredTool({
+    name: 'select_n8n_nodes',
+    description: 'Match each workflow step with the most appropriate n8n nodes from the allowed list, ensuring they can implement the required functionality.',
+    schema: nodeSelectorSchema,
+    func: async ({ recommended_nodes }) => {
+        return { recommended_nodes };
+    },
+});
+const humanTemplate = `
+<user_request>
+	{prompt}
+</user_request>
+<steps>
+	{steps}
+</steps>
+<allowed_n8n_nodes>
+	{allowedNodes}
+</allowed_n8n_nodes>
+`;
+const chatPrompt = prompts_1.ChatPromptTemplate.fromMessages([
+    exports.nodeSelectorPrompt,
+    prompts_1.HumanMessagePromptTemplate.fromTemplate(humanTemplate),
+]);
+const nodesSelectionChain = (llm) => {
+    if (!llm.bindTools) {
+        throw new n8n_workflow_1.OperationalError("LLM doesn't support binding tools");
+    }
+    return chatPrompt
+        .pipe(llm.bindTools([nodeSelectorTool], {
+        tool_choice: nodeSelectorTool.name,
+    }))
+        .pipe((x) => {
+        const toolCall = x.tool_calls?.[0];
+        return (toolCall?.args).recommended_nodes;
+    });
+};
+exports.nodesSelectionChain = nodesSelectionChain;
+//# sourceMappingURL=node-selector.js.map

package/dist/chains/node-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-selector.js","sourceRoot":"","sources":["../../src/chains/node-selector.ts"],"names":[],"mappings":";;;AAEA,uDAAyD;AACzD,qDAAyF;AACzF,iDAA8D;AAC9D,+CAAgD;AAChD,6BAAwB;AAEX,QAAA,kBAAkB,GAAG,IAAI,wBAAa,CAClD;;;;;;;;;;;;;;;;;;;;;;;;;;;;gHA4B+G,CAC/G,CAAC;AACF,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACnC,iBAAiB,EAAE,OAAC;SAClB,KAAK,CACL,OAAC,CAAC,MAAM,CAAC;QACR,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACpF,IAAI,EAAE,OAAC;aACL,MAAM,EAAE;aACR,QAAQ,CACR,yFAAyF,CACzF;QACF,SAAS,EAAE,OAAC;aACV,MAAM,EAAE;aACR,QAAQ,CACR,sFAAsF,CACtF;KACF,CAAC,CACF;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACR,oMAAoM,CACpM;CACF,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,6BAAqB,CAAC;IAClD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACV,6IAA6I;IAC9I,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;QACrC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC9B,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG;;;;;;;;;;CAUrB,CAAC;AAEF,MAAM,UAAU,GAAG,4BAAkB,CAAC,YAAY,CAAC;IAClD,0BAAkB;IAClB,oCAA0B,CAAC,YAAY,CAAC,aAAa,CAAC;CACtD,CAAC,CAAC;AAEI,MAAM,mBAAmB,GAAG,CAAC,GAAkB,EAAE,EAAE;IACzD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,+BAAgB,CAAC,mCAAmC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,UAAU;SACf,IAAI,CACJ,GAAG,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,EAAE;QACjC,WAAW,EAAE,gBAAgB,CAAC,IAAI;KAClC,CAAC,CACF;SACA,IAAI,CAAC,CAAC,CAAiB,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,QAAQ,EAAE,IAA2C,CAAA,CAAC,iBAAiB,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAfW,QAAA,mBAAmB,uBAe9B"}

package/dist/chains/nodes-composer.d.ts

@@ -0,0 +1,8 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import { ChatPromptTemplate } from '@langchain/core/prompts';
+export declare const nodesComposerPrompt: ChatPromptTemplate<any, any>;
+export declare const nodesComposerChain: (llm: BaseChatModel) => import("@langchain/core/runnables").Runnable<any, {
+    type: string;
+    parameters: Record<string, any>;
+    name: string;
+}[], import("@langchain/core/runnables").RunnableConfig<Record<string, any>>>;