@n8n/ai-workflow-builder 0.13.0 → 0.14.0

package/dist/chains/conversation-compact.d.ts

@@ -0,0 +1,8 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { BaseMessage } from '@langchain/core/messages';
+export declare function conversationCompactChain(llm: BaseChatModel, messages: BaseMessage[]): Promise<{
+    success: boolean;
+    summary: Record<string, any>;
+    newMessages: BaseMessage[];
+    messagesRemoved: number;
+}>;

package/dist/chains/conversation-compact.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.conversationCompactChain = conversationCompactChain;
+const messages_1 = require("@langchain/core/messages");
+const zod_1 = __importDefault(require("zod"));
+async function conversationCompactChain(llm, messages) {
+    const CompactedSession = zod_1.default.object({
+        summary: zod_1.default.string().describe('A concise summary of the conversation so far'),
+        key_decisions: zod_1.default.array(zod_1.default.string()).describe('List of key decisions and actions taken'),
+        current_state: zod_1.default.string().describe('Description of the current workflow state'),
+        next_steps: zod_1.default.string().describe('Suggested next steps based on the conversation'),
+    });
+    const modelWithStructure = llm.withStructuredOutput(CompactedSession);
+    const conversationText = messages
+        .map((msg) => {
+        if (msg instanceof messages_1.HumanMessage) {
+            return `User: ${msg.content}`;
+        }
+        else if (msg instanceof messages_1.AIMessage) {
+            return `Assistant: ${msg.content ?? 'Used tools'}`;
+        }
+        return '';
+    })
+        .filter(Boolean)
+        .join('\n');
+    const compactPrompt = `Please summarize the following conversation between a user and an AI assistant building an n8n workflow:
+
+${conversationText}
+
+Provide a structured summary that captures the key points, decisions made, current state of the workflow, and suggested next steps.`;
+    const structuredOutput = await modelWithStructure.invoke(compactPrompt);
+    const compactedMessage = new messages_1.AIMessage({
+        content: `## Previous Conversation Summary
+
+**Summary:** ${structuredOutput.summary}
+
+**Key Decisions:**
+${structuredOutput.key_decisions.map((d) => `- ${d}`).join('\n')}
+
+**Current State:** ${structuredOutput.current_state}
+
+**Next Steps:** ${structuredOutput.next_steps}`,
+    });
+    const lastUserMessage = messages.slice(-1);
+    const newMessages = [lastUserMessage[0], compactedMessage];
+    return {
+        success: true,
+        summary: structuredOutput,
+        newMessages,
+        messagesRemoved: messages.length - newMessages.length,
+    };
+}
+//# sourceMappingURL=conversation-compact.js.map

package/dist/chains/conversation-compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-compact.js","sourceRoot":"","sources":["../../src/chains/conversation-compact.ts"],"names":[],"mappings":";;;;;AAKA,4DA0DC;AA7DD,uDAAmE;AACnE,8CAAoB;AAEb,KAAK,UAAU,wBAAwB,CAAC,GAAkB,EAAE,QAAuB;IAEzF,MAAM,gBAAgB,GAAG,aAAC,CAAC,MAAM,CAAC;QACjC,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC5E,aAAa,EAAE,aAAC,CAAC,KAAK,CAAC,aAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACtF,aAAa,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QAC/E,UAAU,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KACjF,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,GAAG,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAGtE,MAAM,gBAAgB,GAAG,QAAQ;SAC/B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACZ,IAAI,GAAG,YAAY,uBAAY,EAAE,CAAC;YAEjC,OAAO,SAAS,GAAG,CAAC,OAAO,EAAE,CAAC;QAC/B,CAAC;aAAM,IAAI,GAAG,YAAY,oBAAS,EAAE,CAAC;YAErC,OAAO,cAAc,GAAG,CAAC,OAAO,IAAI,YAAY,EAAE,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,CAAC;IACX,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,aAAa,GAAG;;EAErB,gBAAgB;;oIAEkH,CAAC;IAEpI,MAAM,gBAAgB,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAGxE,MAAM,gBAAgB,GAAG,IAAI,oBAAS,CAAC;QACtC,OAAO,EAAE;;eAEI,gBAAgB,CAAC,OAAO;;;EAGpC,gBAAgB,CAAC,aAA0B,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;qBAEjE,gBAAgB,CAAC,aAAa;;kBAEjC,gBAAgB,CAAC,UAAU,EAAE;KAC7C,CAAC,CAAC;IAGH,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAE3D,OAAO;QACN,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,gBAAgB;QACzB,WAAW;QACX,eAAe,EAAE,QAAQ,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM;KACrD,CAAC;AACH,CAAC"}

package/dist/chains/parameter-updater.d.ts

@@ -0,0 +1,16 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { Logger } from 'n8n-workflow';
+import { z } from 'zod';
+import type { ParameterUpdaterOptions } from '../types/config';
+export declare const parametersSchema: z.ZodObject<{
+    parameters: z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
+}, "strip", z.ZodTypeAny, {
+    parameters: {} & {
+        [k: string]: unknown;
+    };
+}, {
+    parameters: {} & {
+        [k: string]: unknown;
+    };
+}>;
+export declare const createParameterUpdaterChain: (llm: BaseChatModel, options: ParameterUpdaterOptions, logger?: Logger) => import("@langchain/core/runnables").Runnable<any, Record<string, any>, import("@langchain/core/runnables").RunnableConfig<Record<string, any>>>;

package/dist/chains/parameter-updater.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createParameterUpdaterChain = exports.parametersSchema = void 0;
+const messages_1 = require("@langchain/core/messages");
+const prompts_1 = require("@langchain/core/prompts");
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+const prompt_builder_1 = require("./prompts/prompt-builder");
+exports.parametersSchema = zod_1.z
+    .object({
+    parameters: zod_1.z
+        .object({})
+        .passthrough()
+        .describe("The complete updated parameters object for the node. This should be a JSON object that matches the node's parameter structure. Include ALL existing parameters plus the requested changes."),
+})
+    .describe('The complete updated parameters object for the node. Must include only parameters from <node_properties_definition>, for example For example: { "parameters": { "method": "POST", "url": "https://api.example.com", "sendHeaders": true, "headerParameters": { "parameters": [{ "name": "Content-Type", "value": "application/json" }] } } }}');
+const nodeDefinitionPrompt = `
+The node accepts these properties:
+<node_properties_definition>
+{node_definition}
+</node_properties_definition>`;
+const workflowContextPrompt = `
+<current_workflow_json>
+{workflow_json}
+</current_workflow_json>
+
+<current_simplified_execution_data>
+{execution_data}
+</current_simplified_execution_data>
+
+<current_execution_nodes_schemas>
+{execution_schema}
+</current_execution_nodes_schemas>
+
+
+<selected_node>
+Name: {node_name}
+Type: {node_type}
+
+Current Parameters: {current_parameters}
+</selected_node>
+
+<requested_changes>
+{changes}
+</requested_changes>
+
+Based on the requested changes and the node's property definitions, return the complete updated parameters object.`;
+const createParameterUpdaterChain = (llm, options, logger) => {
+    if (typeof llm.withStructuredOutput !== 'function') {
+        throw new errors_1.LLMServiceError("LLM doesn't support withStructuredOutput", {
+            llmModel: llm._llmType(),
+        });
+    }
+    const systemPromptContent = prompt_builder_1.ParameterUpdatePromptBuilder.buildSystemPrompt({
+        nodeType: options.nodeType,
+        nodeDefinition: options.nodeDefinition,
+        requestedChanges: options.requestedChanges,
+        hasResourceLocatorParams: prompt_builder_1.ParameterUpdatePromptBuilder.hasResourceLocatorParameters(options.nodeDefinition),
+    });
+    const tokenEstimate = prompt_builder_1.ParameterUpdatePromptBuilder.estimateTokens(systemPromptContent);
+    logger?.debug(`Parameter updater prompt size: ~${tokenEstimate} tokens`);
+    const systemPrompt = new messages_1.SystemMessage({
+        content: [
+            {
+                type: 'text',
+                text: systemPromptContent,
+                cache_control: { type: 'ephemeral' },
+            },
+        ],
+    });
+    const nodeDefinitionMessage = prompts_1.ChatPromptTemplate.fromMessages([
+        [
+            'human',
+            [
+                {
+                    type: 'text',
+                    text: nodeDefinitionPrompt,
+                    cache_control: { type: 'ephemeral' },
+                },
+            ],
+        ],
+    ]);
+    const workflowContextMessage = prompts_1.HumanMessagePromptTemplate.fromTemplate(workflowContextPrompt);
+    const prompt = prompts_1.ChatPromptTemplate.fromMessages([
+        systemPrompt,
+        nodeDefinitionMessage,
+        workflowContextMessage,
+    ]);
+    const llmWithStructuredOutput = llm.withStructuredOutput(exports.parametersSchema);
+    const modelWithStructure = prompt.pipe(llmWithStructuredOutput);
+    return modelWithStructure;
+};
+exports.createParameterUpdaterChain = createParameterUpdaterChain;
+//# sourceMappingURL=parameter-updater.js.map

package/dist/chains/parameter-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-updater.js","sourceRoot":"","sources":["../../src/chains/parameter-updater.ts"],"names":[],"mappings":";;;AACA,uDAAyD;AACzD,qDAAyF;AAEzF,6BAAwB;AAExB,sCAA4C;AAE5C,6DAAwE;AAE3D,QAAA,gBAAgB,GAAG,OAAC;KAC/B,MAAM,CAAC;IACP,UAAU,EAAE,OAAC;SACX,MAAM,CAAC,EAAE,CAAC;SACV,WAAW,EAAE;SACb,QAAQ,CACR,4LAA4L,CAC5L;CACF,CAAC;KACD,QAAQ,CACR,+UAA+U,CAC/U,CAAC;AAEH,MAAM,oBAAoB,GAAG;;;;8BAIC,CAAC;AAE/B,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;mHAyBqF,CAAC;AAK7G,MAAM,2BAA2B,GAAG,CAC1C,GAAkB,EAClB,OAAgC,EAChC,MAAe,EACd,EAAE;IACH,IAAI,OAAO,GAAG,CAAC,oBAAoB,KAAK,UAAU,EAAE,CAAC;QACpD,MAAM,IAAI,wBAAe,CAAC,0CAA0C,EAAE;YACrE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE;SACxB,CAAC,CAAC;IACJ,CAAC;IAGD,MAAM,mBAAmB,GAAG,6CAA4B,CAAC,iBAAiB,CAAC;QAC1E,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,wBAAwB,EAAE,6CAA4B,CAAC,4BAA4B,CAClF,OAAO,CAAC,cAAc,CACtB;KACD,CAAC,CAAC;IAGH,MAAM,aAAa,GAAG,6CAA4B,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IACvF,MAAM,EAAE,KAAK,CAAC,mCAAmC,aAAa,SAAS,CAAC,CAAC;IAGzE,MAAM,YAAY,GAAG,IAAI,wBAAa,CAAC;QACtC,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,mBAAmB;gBACzB,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;aACpC;SACD;KACD,CAAC,CAAC;IACH,MAAM,qBAAqB,GAAG,4BAAkB,CAAC,YAAY,CAAC;QAC7D;YACC,OAAO;YACP;gBACC;oBACC,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oBAAoB;oBAC1B,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;iBACpC;aACD;SACD;KACD,CAAC,CAAC;IAEH,MAAM,sBAAsB,GAAG,oCAA0B,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC;IAE9F,MAAM,MAAM,GAAG,4BAAkB,CAAC,YAAY,CAAC;QAC9C,YAAY;QACZ,qBAAqB;QACrB,sBAAsB;KACtB,CAAC,CAAC;IACH,MAAM,uBAAuB,GAAG,GAAG,CAAC,oBAAoB,CAAC,wBAAgB,CAAC,CAAC;IAC3E,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAEhE,OAAO,kBAAkB,CAAC;AAC3B,CAAC,CAAC;AA3DW,QAAA,2BAA2B,+BA2DtC"}

package/dist/chains/planner.js

@@ -4,8 +4,8 @@ exports.plannerChain = exports.plannerPrompt = 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");
+const errors_1 = require("../errors");
 exports.plannerPrompt = new messages_1.SystemMessage(`You are a Workflow Planner for n8n, a platform that helps users automate processes across different services and APIs.
 
 ## Your Task
@@ -72,7 +72,7 @@ const chatPrompt = prompts_1.ChatPromptTemplate.fromMessages([
 ]);
 const plannerChain = (llm) => {
     if (!llm.bindTools) {
-        throw new n8n_workflow_1.OperationalError("LLM doesn't support binding tools");
+        throw new errors_1.LLMServiceError("LLM doesn't support binding tools", { llmModel: llm._llmType() });
     }
     return chatPrompt
         .pipe(llm.bindTools([generatePlanTool], {

package/dist/chains/planner.js.map

@@ -1 +1 @@
-{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/chains/planner.ts"],"names":[],"mappings":";;;AAEA,uDAAyD;AACzD,qDAAyF;AACzF,iDAA8D;AAC9D,+CAAgD;AAChD,6BAAwB;AAEX,QAAA,aAAa,GAAG,IAAI,wBAAa,CAC7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4FA0C2F,CAC3F,CAAC;AAEF,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAC;SACN,KAAK,CACL,OAAC;SACC,MAAM,EAAE;SACR,QAAQ,CACR,qHAAqH,CACrH,CACF;SACA,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,0KAA0K,CAC1K;CACF,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,6BAAqB,CAAC;IAClD,IAAI,EAAE,eAAe;IACrB,WAAW,EACV,4HAA4H;IAC7H,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,UAAU,CAAC;AACjC,MAAM,UAAU,GAAG,4BAAkB,CAAC,YAAY,CAAC;IAClD,qBAAa;IACb,oCAA0B,CAAC,YAAY,CAAC,aAAa,CAAC;CACtD,CAAC,CAAC;AAEI,MAAM,YAAY,GAAG,CAAC,GAAkB,EAAE,EAAE;IAClD,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,IAAmC,CAAA,CAAC,KAAK,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAfW,QAAA,YAAY,gBAevB"}
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/chains/planner.ts"],"names":[],"mappings":";;;AAEA,uDAAyD;AACzD,qDAAyF;AACzF,iDAA8D;AAC9D,6BAAwB;AAExB,sCAA4C;AAE/B,QAAA,aAAa,GAAG,IAAI,wBAAa,CAC7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4FA0C2F,CAC3F,CAAC;AAEF,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAC;SACN,KAAK,CACL,OAAC;SACC,MAAM,EAAE;SACR,QAAQ,CACR,qHAAqH,CACrH,CACF;SACA,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,0KAA0K,CAC1K;CACF,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,6BAAqB,CAAC;IAClD,IAAI,EAAE,eAAe;IACrB,WAAW,EACV,4HAA4H;IAC7H,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,UAAU,CAAC;AACjC,MAAM,UAAU,GAAG,4BAAkB,CAAC,YAAY,CAAC;IAClD,qBAAa;IACb,oCAA0B,CAAC,YAAY,CAAC,aAAa,CAAC;CACtD,CAAC,CAAC;AAEI,MAAM,YAAY,GAAG,CAAC,GAAkB,EAAE,EAAE;IAClD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,wBAAe,CAAC,mCAAmC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC9F,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,IAAmC,CAAA,CAAC,KAAK,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAfW,QAAA,YAAY,gBAevB"}

package/dist/chains/prompts/base/common-patterns.d.ts

@@ -0,0 +1 @@
+export declare const COMMON_PATTERNS = "\n## Common Parameter Update Patterns\n\n### HTTP Request Node Updates\n- URL: Set directly or use expressions\n- Method: GET, POST, PUT, DELETE, etc.\n- Headers: Add/update in headerParameters.parameters array\n- Body: Update bodyParameters.parameters for POST/PUT\n- Authentication: Update authentication settings";

package/dist/chains/prompts/base/common-patterns.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMON_PATTERNS = void 0;
+exports.COMMON_PATTERNS = `
+## Common Parameter Update Patterns
+
+### HTTP Request Node Updates
+- URL: Set directly or use expressions
+- Method: GET, POST, PUT, DELETE, etc.
+- Headers: Add/update in headerParameters.parameters array
+- Body: Update bodyParameters.parameters for POST/PUT
+- Authentication: Update authentication settings`;
+//# sourceMappingURL=common-patterns.js.map

package/dist/chains/prompts/base/common-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-patterns.js","sourceRoot":"","sources":["../../../../src/chains/prompts/base/common-patterns.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG;;;;;;;;iDAQkB,CAAC"}

package/dist/chains/prompts/base/core-instructions.d.ts

@@ -0,0 +1 @@
+export declare const CORE_INSTRUCTIONS = "You are an expert n8n workflow architect who updates node parameters based on natural language instructions.\n\n## Your Task\nUpdate the parameters of an existing n8n node based on the requested changes. Return the COMPLETE parameters object with both modified and unmodified parameters. Only modify the parameters that are explicitly mentioned in the changes, preserving all other existing parameters exactly as they are.\n\n## Reference Information\nYou will receive:\n1. The original user workflow request\n2. The current workflow JSON\n3. The selected node's current configuration (id, name, type, parameters)\n4. The node type's parameter definitions\n5. Natural language changes to apply\n\n## Parameter Update Guidelines\n1. START WITH CURRENT: If current parameters is empty {}, start with an empty object and add the requested parameters\n2. PRESERVE EXISTING VALUES: Only modify parameters mentioned in the requested changes\n3. MAINTAIN STRUCTURE: Keep the exact parameter structure required by the node type\n4. CHECK FOR RESOURCELOCATOR: If a parameter is type 'resourceLocator' in the node definition, it MUST use the ResourceLocator structure with __rl, mode, and value fields\n5. USE PROPER EXPRESSIONS: Follow n8n expression syntax when referencing other nodes\n6. VALIDATE TYPES: Ensure parameter values match their expected types\n7. HANDLE NESTED PARAMETERS: Correctly update nested structures like headers, conditions, etc.\n8. SIMPLE VALUES: For simple parameter updates like \"Set X to Y\", directly set the parameter without unnecessary nesting\n9. GENERATE IDS: When adding new items to arrays (like assignments, headers, etc.), generate unique IDs using a simple pattern like \"id-1\", \"id-2\", etc.\n10. TOOL NODE DETECTION: Check if node type ends with \"Tool\" to determine if $fromAI expressions are available";

package/dist/chains/prompts/base/core-instructions.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_INSTRUCTIONS = void 0;
+exports.CORE_INSTRUCTIONS = `You are an expert n8n workflow architect who updates node parameters based on natural language instructions.
+
+## Your Task
+Update the parameters of an existing n8n node based on the requested changes. Return the COMPLETE parameters object with both modified and unmodified parameters. Only modify the parameters that are explicitly mentioned in the changes, preserving all other existing parameters exactly as they are.
+
+## Reference Information
+You will receive:
+1. The original user workflow request
+2. The current workflow JSON
+3. The selected node's current configuration (id, name, type, parameters)
+4. The node type's parameter definitions
+5. Natural language changes to apply
+
+## Parameter Update Guidelines
+1. START WITH CURRENT: If current parameters is empty {}, start with an empty object and add the requested parameters
+2. PRESERVE EXISTING VALUES: Only modify parameters mentioned in the requested changes
+3. MAINTAIN STRUCTURE: Keep the exact parameter structure required by the node type
+4. CHECK FOR RESOURCELOCATOR: If a parameter is type 'resourceLocator' in the node definition, it MUST use the ResourceLocator structure with __rl, mode, and value fields
+5. USE PROPER EXPRESSIONS: Follow n8n expression syntax when referencing other nodes
+6. VALIDATE TYPES: Ensure parameter values match their expected types
+7. HANDLE NESTED PARAMETERS: Correctly update nested structures like headers, conditions, etc.
+8. SIMPLE VALUES: For simple parameter updates like "Set X to Y", directly set the parameter without unnecessary nesting
+9. GENERATE IDS: When adding new items to arrays (like assignments, headers, etc.), generate unique IDs using a simple pattern like "id-1", "id-2", etc.
+10. TOOL NODE DETECTION: Check if node type ends with "Tool" to determine if $fromAI expressions are available`;
+//# sourceMappingURL=core-instructions.js.map

package/dist/chains/prompts/base/core-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-instructions.js","sourceRoot":"","sources":["../../../../src/chains/prompts/base/core-instructions.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;+GAuB8E,CAAC"}

package/dist/chains/prompts/base/expression-rules.d.ts

@@ -0,0 +1 @@
+export declare const EXPRESSION_RULES = "\n## CRITICAL: Correctly Formatting n8n Expressions\nWhen using expressions to reference data from other nodes:\n- ALWAYS use the format: `={{ $('Node Name').item.json.field }}`\n- NEVER omit the equals sign before the double curly braces\n- ALWAYS use DOUBLE curly braces, never single\n- NEVER use emojis or special characters inside expressions as they will break the expression\n- INCORRECT: `{ $('Node Name').item.json.field }` (missing =, single braces)\n- INCORRECT: `{{ $('Node Name').item.json.field }}` (missing =)\n- INCORRECT: `={{ $('\uD83D\uDC4D Node').item.json.field }}` (contains emoji)\n- CORRECT: `={{ $('Previous Node').item.json.field }}`";

package/dist/chains/prompts/base/expression-rules.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPRESSION_RULES = void 0;
+exports.EXPRESSION_RULES = `
+## CRITICAL: Correctly Formatting n8n Expressions
+When using expressions to reference data from other nodes:
+- ALWAYS use the format: \`={{ $('Node Name').item.json.field }}\`
+- NEVER omit the equals sign before the double curly braces
+- ALWAYS use DOUBLE curly braces, never single
+- NEVER use emojis or special characters inside expressions as they will break the expression
+- INCORRECT: \`{ $('Node Name').item.json.field }\` (missing =, single braces)
+- INCORRECT: \`{{ $('Node Name').item.json.field }}\` (missing =)
+- INCORRECT: \`={{ $('👍 Node').item.json.field }}\` (contains emoji)
+- CORRECT: \`={{ $('Previous Node').item.json.field }}\``;
+//# sourceMappingURL=expression-rules.js.map

package/dist/chains/prompts/base/expression-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-rules.js","sourceRoot":"","sources":["../../../../src/chains/prompts/base/expression-rules.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG;;;;;;;;;;yDAUyB,CAAC"}

package/dist/chains/prompts/base/output-format.d.ts

@@ -0,0 +1 @@
+export declare const OUTPUT_FORMAT = "\n## Output Format\nReturn ONLY the complete updated parameters object that matches the node's parameter structure. Include ALL parameters, both modified and unmodified.";

package/dist/chains/prompts/base/output-format.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OUTPUT_FORMAT = void 0;
+exports.OUTPUT_FORMAT = `
+## Output Format
+Return ONLY the complete updated parameters object that matches the node's parameter structure. Include ALL parameters, both modified and unmodified.`;
+//# sourceMappingURL=output-format.js.map

package/dist/chains/prompts/base/output-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.js","sourceRoot":"","sources":["../../../../src/chains/prompts/base/output-format.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;;sJAEyH,CAAC"}

package/dist/chains/prompts/examples/advanced/resource-locator-examples.d.ts

@@ -0,0 +1 @@
+export declare const RESOURCE_LOCATOR_EXAMPLES = "\n### ResourceLocator Examples\n\n#### Example 1: Slack Node - Channel by ID\nCurrent Parameters:\n{\n  \"select\": \"channel\",\n  \"channelId\": {\n    \"__rl\": true,\n    \"value\": \"\",\n    \"mode\": \"list\"\n  },\n  \"otherOptions\": {}\n}\n\nRequested Changes: Send to channel C0122KQ70S7E\n\nExpected Output:\n{\n  \"select\": \"channel\",\n  \"channelId\": {\n    \"__rl\": true,\n    \"mode\": \"id\",\n    \"value\": \"C0122KQ70S7E\"\n  },\n  \"otherOptions\": {}\n}\n\n#### Example 2: Google Drive Node - File by URL\nCurrent Parameters:\n{\n  \"operation\": \"download\",\n  \"fileId\": {\n    \"__rl\": true,\n    \"value\": \"\",\n    \"mode\": \"list\"\n  }\n}\n\nRequested Changes: Use file https://drive.google.com/file/d/1ABC123XYZ/view\n\nExpected Output:\n{\n  \"operation\": \"download\",\n  \"fileId\": {\n    \"__rl\": true,\n    \"mode\": \"url\",\n    \"value\": \"https://drive.google.com/file/d/1ABC123XYZ/view\"\n  }\n}\n\n#### Example 3: Notion Node - Page ID from Expression\nCurrent Parameters:\n{\n  \"resource\": \"databasePage\",\n  \"operation\": \"get\",\n  \"pageId\": {\n    \"__rl\": true,\n    \"value\": \"hardcoded-page-id\",\n    \"mode\": \"id\"\n  }\n}\n\nRequested Changes: Use page ID from the previous node's output\n\nExpected Output:\n{\n  \"resource\": \"databasePage\",\n  \"operation\": \"get\",\n  \"pageId\": {\n    \"__rl\": true,\n    \"mode\": \"id\",\n    \"value\": \"={{ $('Previous Node').item.json.pageId }}\"\n  }\n}";

package/dist/chains/prompts/examples/advanced/resource-locator-examples.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESOURCE_LOCATOR_EXAMPLES = void 0;
+exports.RESOURCE_LOCATOR_EXAMPLES = `
+### ResourceLocator Examples
+
+#### Example 1: Slack Node - Channel by ID
+Current Parameters:
+{
+  "select": "channel",
+  "channelId": {
+    "__rl": true,
+    "value": "",
+    "mode": "list"
+  },
+  "otherOptions": {}
+}
+
+Requested Changes: Send to channel C0122KQ70S7E
+
+Expected Output:
+{
+  "select": "channel",
+  "channelId": {
+    "__rl": true,
+    "mode": "id",
+    "value": "C0122KQ70S7E"
+  },
+  "otherOptions": {}
+}
+
+#### Example 2: Google Drive Node - File by URL
+Current Parameters:
+{
+  "operation": "download",
+  "fileId": {
+    "__rl": true,
+    "value": "",
+    "mode": "list"
+  }
+}
+
+Requested Changes: Use file https://drive.google.com/file/d/1ABC123XYZ/view
+
+Expected Output:
+{
+  "operation": "download",
+  "fileId": {
+    "__rl": true,
+    "mode": "url",
+    "value": "https://drive.google.com/file/d/1ABC123XYZ/view"
+  }
+}
+
+#### Example 3: Notion Node - Page ID from Expression
+Current Parameters:
+{
+  "resource": "databasePage",
+  "operation": "get",
+  "pageId": {
+    "__rl": true,
+    "value": "hardcoded-page-id",
+    "mode": "id"
+  }
+}
+
+Requested Changes: Use page ID from the previous node's output
+
+Expected Output:
+{
+  "resource": "databasePage",
+  "operation": "get",
+  "pageId": {
+    "__rl": true,
+    "mode": "id",
+    "value": "={{ $('Previous Node').item.json.pageId }}"
+  }
+}`;
+//# sourceMappingURL=resource-locator-examples.js.map

package/dist/chains/prompts/examples/advanced/resource-locator-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-locator-examples.js","sourceRoot":"","sources":["../../../../../src/chains/prompts/examples/advanced/resource-locator-examples.ts"],"names":[],"mappings":";;;AAAa,QAAA,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0EvC,CAAC"}

package/dist/chains/prompts/examples/advanced/tool-node-examples.d.ts

@@ -0,0 +1 @@
+export declare const TOOL_NODE_EXAMPLES = "\n### Tool Node Examples\n\n#### Example 1: Gmail Tool - Send Email with AI\nCurrent Parameters: {}\nRequested Changes: Let AI determine recipient, subject, and message\nExpected Output:\n{\n  \"sendTo\": \"={{ $fromAI('to') }}\",\n  \"subject\": \"={{ $fromAI('subject') }}\",\n  \"message\": \"={{ $fromAI('message_html') }}\",\n  \"options\": {}\n}\n\n#### Example 2: Google Calendar Tool - Filter by Date\nCurrent Parameters:\n{\n  \"operation\": \"getAll\",\n  \"calendar\": {\n    \"__rl\": true,\n    \"value\": \"primary\",\n    \"mode\": \"list\"\n  }\n}\n\nRequested Changes: Let AI determine date range for filtering\n\nExpected Output:\n{\n  \"operation\": \"getAll\",\n  \"calendar\": {\n    \"__rl\": true,\n    \"value\": \"primary\",\n    \"mode\": \"list\"\n  },\n  \"timeMin\": \"={{ $fromAI('After', '', 'string') }}\",\n  \"timeMax\": \"={{ $fromAI('Before', '', 'string') }}\"\n}\n\n#### Example 3: Slack Tool - Send Message\nCurrent Parameters:\n{\n  \"resource\": \"message\"\n}\n\nRequested Changes: Let AI determine channel and message content\n\nExpected Output:\n{\n  \"resource\": \"message\",\n  \"channelId\": \"={{ $fromAI('channel') }}\",\n  \"messageText\": \"={{ $fromAI('message') }}\"\n}\n\n#### Example 4: Tool Node with Mixed Content\nCurrent Parameters:\n{\n  \"sendTo\": \"admin@company.com\"\n}\n\nRequested Changes: Keep admin email but let AI add additional recipients and determine subject\n\nExpected Output:\n{\n  \"sendTo\": \"=admin@company.com, {{ $fromAI('additional_recipients') }}\",\n  \"subject\": \"={{ $fromAI('subject') }} - Automated Report\"\n}";

package/dist/chains/prompts/examples/advanced/tool-node-examples.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_NODE_EXAMPLES = void 0;
+exports.TOOL_NODE_EXAMPLES = `
+### Tool Node Examples
+
+#### Example 1: Gmail Tool - Send Email with AI
+Current Parameters: {}
+Requested Changes: Let AI determine recipient, subject, and message
+Expected Output:
+{
+  "sendTo": "={{ $fromAI('to') }}",
+  "subject": "={{ $fromAI('subject') }}",
+  "message": "={{ $fromAI('message_html') }}",
+  "options": {}
+}
+
+#### Example 2: Google Calendar Tool - Filter by Date
+Current Parameters:
+{
+  "operation": "getAll",
+  "calendar": {
+    "__rl": true,
+    "value": "primary",
+    "mode": "list"
+  }
+}
+
+Requested Changes: Let AI determine date range for filtering
+
+Expected Output:
+{
+  "operation": "getAll",
+  "calendar": {
+    "__rl": true,
+    "value": "primary",
+    "mode": "list"
+  },
+  "timeMin": "={{ $fromAI('After', '', 'string') }}",
+  "timeMax": "={{ $fromAI('Before', '', 'string') }}"
+}
+
+#### Example 3: Slack Tool - Send Message
+Current Parameters:
+{
+  "resource": "message"
+}
+
+Requested Changes: Let AI determine channel and message content
+
+Expected Output:
+{
+  "resource": "message",
+  "channelId": "={{ $fromAI('channel') }}",
+  "messageText": "={{ $fromAI('message') }}"
+}
+
+#### Example 4: Tool Node with Mixed Content
+Current Parameters:
+{
+  "sendTo": "admin@company.com"
+}
+
+Requested Changes: Keep admin email but let AI add additional recipients and determine subject
+
+Expected Output:
+{
+  "sendTo": "=admin@company.com, {{ $fromAI('additional_recipients') }}",
+  "subject": "={{ $fromAI('subject') }} - Automated Report"
+}`;
+//# sourceMappingURL=tool-node-examples.js.map

package/dist/chains/prompts/examples/advanced/tool-node-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-node-examples.js","sourceRoot":"","sources":["../../../../../src/chains/prompts/examples/advanced/tool-node-examples.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkEhC,CAAC"}

package/dist/chains/prompts/examples/basic/if-node-examples.d.ts

@@ -0,0 +1 @@
+export declare const IF_NODE_EXAMPLES = "\n### IF Node Examples\n\n#### Example 1: Simple String Condition\nCurrent Parameters: {}\nRequested Changes: Check if order status equals \"pending\"\nExpected Output:\n{\n  \"conditions\": {\n    \"options\": {\n      \"caseSensitive\": false,\n      \"leftValue\": \"\",\n      \"typeValidation\": \"loose\"\n    },\n    \"conditions\": [\n      {\n        \"id\": \"id-1\",\n        \"leftValue\": \"={{ $('Previous Node').item.json.orderStatus }}\",\n        \"rightValue\": \"pending\",\n        \"operator\": {\n          \"type\": \"string\",\n          \"operation\": \"equals\"\n        }\n      }\n    ],\n    \"combinator\": \"and\"\n  }\n}\n\n#### Example 2: Check if Field Exists\nCurrent Parameters: {}\nRequested Changes: Check if email field exists in the data\nExpected Output:\n{\n  \"conditions\": {\n    \"options\": {\n      \"caseSensitive\": false,\n      \"leftValue\": \"\",\n      \"typeValidation\": \"loose\"\n    },\n    \"conditions\": [\n      {\n        \"id\": \"id-1\",\n        \"leftValue\": \"={{ $('Previous Node').item.json.email }}\",\n        \"operator\": {\n          \"type\": \"string\",\n          \"operation\": \"exists\"\n        }\n      }\n    ],\n    \"combinator\": \"and\"\n  }\n}\n\n#### Example 3: Multiple Conditions with AND\nCurrent Parameters: {}\nRequested Changes: Check if status is active AND score is 50 or higher\nExpected Output:\n{\n  \"conditions\": {\n    \"options\": {\n      \"caseSensitive\": false,\n      \"leftValue\": \"\",\n      \"typeValidation\": \"loose\"\n    },\n    \"conditions\": [\n      {\n        \"id\": \"id-1\",\n        \"leftValue\": \"={{ $('Set').item.json.status }}\",\n        \"rightValue\": \"active\",\n        \"operator\": {\n          \"type\": \"string\",\n          \"operation\": \"equals\"\n        }\n      },\n      {\n        \"id\": \"id-2\",\n        \"leftValue\": \"={{ $('Set').item.json.score }}\",\n        \"rightValue\": \"50\",\n        \"operator\": {\n          \"type\": \"number\",\n          \"operation\": \"gte\"\n        }\n      }\n    ],\n    \"combinator\": \"and\"\n  }\n}\n\n#### Example 3: IF Node - Complex Multi-Type Conditions\nCurrent Parameters: {}\n\nRequested Changes:\n- Check if email is not empty AND verified is true AND permissions array contains \"write\"\n\nExpected Output:\n{\n  \"conditions\": {\n    \"options\": {\n      \"caseSensitive\": true,\n      \"leftValue\": \"\",\n      \"typeValidation\": \"strict\"\n    },\n    \"conditions\": [\n      {\n        \"id\": \"id-1\",\n        \"leftValue\": \"={{ $('Set').item.json.email }}\",\n        \"operator\": {\n          \"type\": \"string\",\n          \"operation\": \"notEmpty\"\n        }\n      },\n      {\n        \"id\": \"id-2\",\n        \"leftValue\": \"={{ $('Set').item.json.verified }}\",\n        \"operator\": {\n          \"type\": \"boolean\",\n          \"operation\": \"true\"\n        }\n      },\n      {\n        \"id\": \"id-3\",\n        \"leftValue\": \"={{ $('Set').item.json.permissions }}\",\n        \"rightValue\": \"write\",\n        \"operator\": {\n          \"type\": \"array\",\n          \"operation\": \"contains\"\n        }\n      }\n    ],\n    \"combinator\": \"and\"\n  }\n}\n";

package/dist/chains/prompts/examples/basic/if-node-examples.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IF_NODE_EXAMPLES = void 0;
+exports.IF_NODE_EXAMPLES = `
+### IF Node Examples
+
+#### Example 1: Simple String Condition
+Current Parameters: {}
+Requested Changes: Check if order status equals "pending"
+Expected Output:
+{
+  "conditions": {
+    "options": {
+      "caseSensitive": false,
+      "leftValue": "",
+      "typeValidation": "loose"
+    },
+    "conditions": [
+      {
+        "id": "id-1",
+        "leftValue": "={{ $('Previous Node').item.json.orderStatus }}",
+        "rightValue": "pending",
+        "operator": {
+          "type": "string",
+          "operation": "equals"
+        }
+      }
+    ],
+    "combinator": "and"
+  }
+}
+
+#### Example 2: Check if Field Exists
+Current Parameters: {}
+Requested Changes: Check if email field exists in the data
+Expected Output:
+{
+  "conditions": {
+    "options": {
+      "caseSensitive": false,
+      "leftValue": "",
+      "typeValidation": "loose"
+    },
+    "conditions": [
+      {
+        "id": "id-1",
+        "leftValue": "={{ $('Previous Node').item.json.email }}",
+        "operator": {
+          "type": "string",
+          "operation": "exists"
+        }
+      }
+    ],
+    "combinator": "and"
+  }
+}
+
+#### Example 3: Multiple Conditions with AND
+Current Parameters: {}
+Requested Changes: Check if status is active AND score is 50 or higher
+Expected Output:
+{
+  "conditions": {
+    "options": {
+      "caseSensitive": false,
+      "leftValue": "",
+      "typeValidation": "loose"
+    },
+    "conditions": [
+      {
+        "id": "id-1",
+        "leftValue": "={{ $('Set').item.json.status }}",
+        "rightValue": "active",
+        "operator": {
+          "type": "string",
+          "operation": "equals"
+        }
+      },
+      {
+        "id": "id-2",
+        "leftValue": "={{ $('Set').item.json.score }}",
+        "rightValue": "50",
+        "operator": {
+          "type": "number",
+          "operation": "gte"
+        }
+      }
+    ],
+    "combinator": "and"
+  }
+}
+
+#### Example 3: IF Node - Complex Multi-Type Conditions
+Current Parameters: {}
+
+Requested Changes:
+- Check if email is not empty AND verified is true AND permissions array contains "write"
+
+Expected Output:
+{
+  "conditions": {
+    "options": {
+      "caseSensitive": true,
+      "leftValue": "",
+      "typeValidation": "strict"
+    },
+    "conditions": [
+      {
+        "id": "id-1",
+        "leftValue": "={{ $('Set').item.json.email }}",
+        "operator": {
+          "type": "string",
+          "operation": "notEmpty"
+        }
+      },
+      {
+        "id": "id-2",
+        "leftValue": "={{ $('Set').item.json.verified }}",
+        "operator": {
+          "type": "boolean",
+          "operation": "true"
+        }
+      },
+      {
+        "id": "id-3",
+        "leftValue": "={{ $('Set').item.json.permissions }}",
+        "rightValue": "write",
+        "operator": {
+          "type": "array",
+          "operation": "contains"
+        }
+      }
+    ],
+    "combinator": "and"
+  }
+}
+`;
+//# sourceMappingURL=if-node-examples.js.map

package/dist/chains/prompts/examples/basic/if-node-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"if-node-examples.js","sourceRoot":"","sources":["../../../../../src/chains/prompts/examples/basic/if-node-examples.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqI/B,CAAC"}