@n8n/ai-workflow-builder 0.13.0 → 0.14.1

package/dist/chains/prompts/node-types/tool-nodes.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_NODES_GUIDE = void 0;
+exports.TOOL_NODES_GUIDE = `
+## CRITICAL: $fromAI Expression Support for Tool Nodes
+
+Tool nodes (nodes ending with "Tool" like Gmail Tool, Google Calendar Tool, etc.) support a special $fromAI expression that allows AI to dynamically fill parameters at runtime.
+
+### When to Use $fromAI
+- ONLY available in tool nodes (node types ending with "Tool")
+- Use when the AI should determine the value based on context
+- Ideal for parameters that vary based on user input or conversation context
+
+### $fromAI Syntax
+\`={{ $fromAI('key', 'description', 'type', defaultValue) }}\`
+
+### Parameters
+- key: Unique identifier (1-64 chars, alphanumeric/underscore/hyphen)
+- description: Optional description for the AI (use empty string '' if not needed)
+- type: 'string' | 'number' | 'boolean' | 'json' (defaults to 'string')
+- defaultValue: Optional fallback value
+
+### Tool Node Examples
+
+#### Gmail Tool - Sending Email
+{
+  "sendTo": "={{ $fromAI('to') }}",
+  "subject": "={{ $fromAI('subject') }}",
+  "message": "={{ $fromAI('message_html') }}"
+}
+
+#### Google Calendar Tool - Filtering Events
+{
+  "timeMin": "={{ $fromAI('After', '', 'string') }}",
+  "timeMax": "={{ $fromAI('Before', '', 'string') }}"
+}
+
+### Mixed Usage Examples
+You can combine $fromAI with regular text:
+- "Subject: {{ $fromAI('subject') }} - Automated"
+- "Dear {{ $fromAI('recipientName', 'Customer name', 'string', 'Customer') }},"
+
+### Important Rules
+1. ONLY use $fromAI in tool nodes (check if node type ends with "Tool")
+2. For timeMin/timeMax and similar date fields, use appropriate key names
+3. The AI will fill these values based on context during execution
+4. Don't use $fromAI in regular nodes like Set, IF, HTTP Request, etc.
+
+## Tool Node Parameter Guidelines
+
+### Identifying Tool Nodes
+1. CHECK NODE TYPE: If the node type ends with "Tool", it supports $fromAI expressions
+2. COMMON TOOL NODES:
+   - Gmail Tool (gmailTool): to, subject, message → use $fromAI
+   - Google Calendar Tool (googleCalendarTool): timeMin, timeMax → use $fromAI
+   - Slack Tool (slackTool): channel, message → use $fromAI
+   - Microsoft Teams Tool: channel, message → use $fromAI
+   - Telegram Tool: chatId, text → use $fromAI
+   - Other communication/document tools: content fields → use $fromAI
+
+### When to Use $fromAI in Tool Nodes
+1. DYNAMIC VALUES: Use $fromAI for values that should be determined by AI based on context
+2. USER INPUT FIELDS: Recipients, subjects, messages, date ranges
+3. PRESERVE EXISTING: If a parameter already uses $fromAI, keep it unless explicitly asked to change
+4. DATE/TIME FIELDS: Use descriptive key names for clarity
+
+### Tool Node Parameter Patterns
+- Email recipients: "={{ $fromAI('to') }}"
+- Email subjects: "={{ $fromAI('subject') }}"
+- Message content: "={{ $fromAI('message_html') }}" or "={{ $fromAI('message') }}"
+- Date ranges: "={{ $fromAI('After', '', 'string') }}"
+- Channel IDs: "={{ $fromAI('channel') }}"`;
+//# sourceMappingURL=tool-nodes.js.map

package/dist/chains/prompts/node-types/tool-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-nodes.js","sourceRoot":"","sources":["../../../../src/chains/prompts/node-types/tool-nodes.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAoEW,CAAC"}

package/dist/chains/prompts/parameter-types/resource-locator.d.ts

@@ -0,0 +1 @@
+export declare const RESOURCE_LOCATOR_GUIDE = "\n## IMPORTANT: ResourceLocator Parameter Handling\n\nResourceLocator parameters are special fields used for selecting resources like Slack channels, Google Drive files, Notion pages, etc. They MUST have a specific structure:\n\n### Required ResourceLocator Structure:\n```json\n{\n  \"__rl\": true,\n  \"mode\": \"id\" | \"url\" | \"list\" | \"name\",\n  \"value\": \"the-actual-value\"\n}\n```\n\n### Mode Detection Guidelines:\n- Use mode \"url\" when the value is a URL (starts with http:// or https://)\n- Use mode \"id\" when the value looks like an ID (alphanumeric string)\n- Use mode \"name\" when the value has a prefix like # (Slack channels) or @ (users)\n- Use mode \"list\" when referencing a dropdown selection (rarely needed in updates)\n\n### ResourceLocator Examples:\n\n#### Example 1: Slack Channel by ID\nParameter name: channelId\nChange: \"Set channel to C0122KQ70S7E\"\nOutput:\n```json\n{\n  \"channelId\": {\n    \"__rl\": true,\n    \"mode\": \"id\",\n    \"value\": \"C0122KQ70S7E\"\n  }\n}\n```\n\n#### Example 2: Google Drive File by URL\nParameter name: fileId\nChange: \"Use file https://drive.google.com/file/d/1Nvdl7bEfDW33cKQuwfItPhIk479--WYY/view\"\nOutput:\n```json\n{\n  \"fileId\": {\n    \"__rl\": true,\n    \"mode\": \"url\",\n    \"value\": \"https://drive.google.com/file/d/1Nvdl7bEfDW33cKQuwfItPhIk479--WYY/view\"\n  }\n}\n```\n\n#### Example 3: Notion Page by ID\nParameter name: pageId\nChange: \"Set page ID to 123e4567-e89b-12d3\"\nOutput:\n```json\n{\n  \"pageId\": {\n    \"__rl\": true,\n    \"mode\": \"id\",\n    \"value\": \"123e4567-e89b-12d3\"\n  }\n}\n```\n\n#### Example 4: Slack Channel by Name\nParameter name: channelId\nChange: \"Send to #general channel\"\nOutput:\n```json\n{\n  \"channelId\": {\n    \"__rl\": true,\n    \"mode\": \"name\",\n    \"value\": \"#general\"\n  }\n}\n```\n\n#### Example 5: Using Expression with ResourceLocator\nParameter name: channelId\nChange: \"Use channel ID from previous node\"\nOutput:\n```json\n{\n  \"channelId\": {\n    \"__rl\": true,\n    \"mode\": \"id\",\n    \"value\": \"={{ $('Previous Node').item.json.channelId }}\"\n  }\n}\n```";

package/dist/chains/prompts/parameter-types/resource-locator.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESOURCE_LOCATOR_GUIDE = void 0;
+exports.RESOURCE_LOCATOR_GUIDE = `
+## IMPORTANT: ResourceLocator Parameter Handling
+
+ResourceLocator parameters are special fields used for selecting resources like Slack channels, Google Drive files, Notion pages, etc. They MUST have a specific structure:
+
+### Required ResourceLocator Structure:
+\`\`\`json
+{
+  "__rl": true,
+  "mode": "id" | "url" | "list" | "name",
+  "value": "the-actual-value"
+}
+\`\`\`
+
+### Mode Detection Guidelines:
+- Use mode "url" when the value is a URL (starts with http:// or https://)
+- Use mode "id" when the value looks like an ID (alphanumeric string)
+- Use mode "name" when the value has a prefix like # (Slack channels) or @ (users)
+- Use mode "list" when referencing a dropdown selection (rarely needed in updates)
+
+### ResourceLocator Examples:
+
+#### Example 1: Slack Channel by ID
+Parameter name: channelId
+Change: "Set channel to C0122KQ70S7E"
+Output:
+\`\`\`json
+{
+  "channelId": {
+    "__rl": true,
+    "mode": "id",
+    "value": "C0122KQ70S7E"
+  }
+}
+\`\`\`
+
+#### Example 2: Google Drive File by URL
+Parameter name: fileId
+Change: "Use file https://drive.google.com/file/d/1Nvdl7bEfDW33cKQuwfItPhIk479--WYY/view"
+Output:
+\`\`\`json
+{
+  "fileId": {
+    "__rl": true,
+    "mode": "url",
+    "value": "https://drive.google.com/file/d/1Nvdl7bEfDW33cKQuwfItPhIk479--WYY/view"
+  }
+}
+\`\`\`
+
+#### Example 3: Notion Page by ID
+Parameter name: pageId
+Change: "Set page ID to 123e4567-e89b-12d3"
+Output:
+\`\`\`json
+{
+  "pageId": {
+    "__rl": true,
+    "mode": "id",
+    "value": "123e4567-e89b-12d3"
+  }
+}
+\`\`\`
+
+#### Example 4: Slack Channel by Name
+Parameter name: channelId
+Change: "Send to #general channel"
+Output:
+\`\`\`json
+{
+  "channelId": {
+    "__rl": true,
+    "mode": "name",
+    "value": "#general"
+  }
+}
+\`\`\`
+
+#### Example 5: Using Expression with ResourceLocator
+Parameter name: channelId
+Change: "Use channel ID from previous node"
+Output:
+\`\`\`json
+{
+  "channelId": {
+    "__rl": true,
+    "mode": "id",
+    "value": "={{ $('Previous Node').item.json.channelId }}"
+  }
+}
+\`\`\``;
+//# sourceMappingURL=resource-locator.js.map

package/dist/chains/prompts/parameter-types/resource-locator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-locator.js","sourceRoot":"","sources":["../../../../src/chains/prompts/parameter-types/resource-locator.ts"],"names":[],"mappings":";;;AAAa,QAAA,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0F/B,CAAC"}

package/dist/chains/prompts/parameter-types/text-fields.d.ts

@@ -0,0 +1 @@
+export declare const TEXT_FIELDS_GUIDE = "\n## Text Field Expression Formatting\n\n### PREFERRED METHOD: Embedding expressions directly within text\n```\n\"text\": \"=ALERT: It is currently {{ $('Weather Node').item.json.weather }} in {{ $('Weather Node').item.json.city }}!\"\n```\n\n### Alternative method: Using string concatenation (use only when needed)\n```\n\"text\": \"={{ 'ALERT: It is currently ' + $('Weather Node').item.json.weather + ' in ' + $('Weather Node').item.json.city + '!' }}\"\n```\n\n### Key Points:\n- Use the embedded expression format when mixing static text with dynamic values\n- The entire string must start with = when using expressions\n- Expressions within text use single curly braces {{ }}\n- The outer expression wrapper uses double curly braces ={{ }}";

package/dist/chains/prompts/parameter-types/text-fields.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEXT_FIELDS_GUIDE = void 0;
+exports.TEXT_FIELDS_GUIDE = `
+## Text Field Expression Formatting
+
+### PREFERRED METHOD: Embedding expressions directly within text
+\`\`\`
+"text": "=ALERT: It is currently {{ $('Weather Node').item.json.weather }} in {{ $('Weather Node').item.json.city }}!"
+\`\`\`
+
+### Alternative method: Using string concatenation (use only when needed)
+\`\`\`
+"text": "={{ 'ALERT: It is currently ' + $('Weather Node').item.json.weather + ' in ' + $('Weather Node').item.json.city + '!' }}"
+\`\`\`
+
+### Key Points:
+- Use the embedded expression format when mixing static text with dynamic values
+- The entire string must start with = when using expressions
+- Expressions within text use single curly braces {{ }}
+- The outer expression wrapper uses double curly braces ={{ }}`;
+//# sourceMappingURL=text-fields.js.map

package/dist/chains/prompts/parameter-types/text-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-fields.js","sourceRoot":"","sources":["../../../../src/chains/prompts/parameter-types/text-fields.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAG;;;;;;;;;;;;;;;;;+DAiB8B,CAAC"}

package/dist/chains/prompts/prompt-builder.d.ts

@@ -0,0 +1,14 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+import type { PromptBuilderContext } from '../../types/config';
+export declare class ParameterUpdatePromptBuilder {
+    static buildSystemPrompt(context: PromptBuilderContext): string;
+    private static isSetNode;
+    private static isIfNode;
+    private static isHttpRequestNode;
+    private static isToolNode;
+    private static needsResourceLocatorGuide;
+    private static hasTextFields;
+    private static selectRelevantExamples;
+    static hasResourceLocatorParameters(nodeDefinition: INodeTypeDescription): boolean;
+    static estimateTokens(prompt: string): number;
+}

package/dist/chains/prompts/prompt-builder.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParameterUpdatePromptBuilder = void 0;
+const common_patterns_1 = require("./base/common-patterns");
+const core_instructions_1 = require("./base/core-instructions");
+const expression_rules_1 = require("./base/expression-rules");
+const output_format_1 = require("./base/output-format");
+const resource_locator_examples_1 = require("./examples/advanced/resource-locator-examples");
+const tool_node_examples_1 = require("./examples/advanced/tool-node-examples");
+const if_node_examples_1 = require("./examples/basic/if-node-examples");
+const set_node_examples_1 = require("./examples/basic/set-node-examples");
+const simple_updates_1 = require("./examples/basic/simple-updates");
+const http_request_1 = require("./node-types/http-request");
+const if_node_1 = require("./node-types/if-node");
+const set_node_1 = require("./node-types/set-node");
+const tool_nodes_1 = require("./node-types/tool-nodes");
+const resource_locator_1 = require("./parameter-types/resource-locator");
+const text_fields_1 = require("./parameter-types/text-fields");
+const prompt_config_1 = require("./prompt-config");
+class ParameterUpdatePromptBuilder {
+    static buildSystemPrompt(context) {
+        const options = context.options ?? {};
+        const sections = [];
+        sections.push(core_instructions_1.CORE_INSTRUCTIONS);
+        sections.push(expression_rules_1.EXPRESSION_RULES);
+        if (this.isSetNode(context.nodeType)) {
+            sections.push(set_node_1.SET_NODE_GUIDE);
+        }
+        else if (this.isIfNode(context.nodeType)) {
+            sections.push(if_node_1.IF_NODE_GUIDE);
+        }
+        else if (this.isHttpRequestNode(context.nodeType)) {
+            sections.push(http_request_1.HTTP_REQUEST_GUIDE);
+        }
+        if (this.isToolNode(context.nodeType)) {
+            sections.push(tool_nodes_1.TOOL_NODES_GUIDE);
+        }
+        if (context.hasResourceLocatorParams || this.needsResourceLocatorGuide(context)) {
+            sections.push(resource_locator_1.RESOURCE_LOCATOR_GUIDE);
+        }
+        if (this.hasTextFields(context.nodeDefinition)) {
+            sections.push(text_fields_1.TEXT_FIELDS_GUIDE);
+        }
+        sections.push(common_patterns_1.COMMON_PATTERNS);
+        if (options.includeExamples !== false) {
+            const examples = this.selectRelevantExamples(context);
+            if (examples.length > 0) {
+                sections.push('\n## Relevant Examples');
+                sections.push(...examples);
+            }
+        }
+        sections.push(output_format_1.OUTPUT_FORMAT);
+        const finalPrompt = sections.join('\n');
+        return finalPrompt;
+    }
+    static isSetNode(nodeType) {
+        const category = (0, prompt_config_1.getNodeTypeCategory)(nodeType);
+        return category === 'set';
+    }
+    static isIfNode(nodeType) {
+        const category = (0, prompt_config_1.getNodeTypeCategory)(nodeType);
+        return category === 'if';
+    }
+    static isHttpRequestNode(nodeType) {
+        const category = (0, prompt_config_1.getNodeTypeCategory)(nodeType);
+        return category === 'httpRequest';
+    }
+    static isToolNode(nodeType) {
+        const category = (0, prompt_config_1.getNodeTypeCategory)(nodeType);
+        return category === 'tool';
+    }
+    static needsResourceLocatorGuide(context) {
+        return (0, prompt_config_1.mentionsResourceKeywords)(context.requestedChanges, context.config);
+    }
+    static hasTextFields(nodeDefinition) {
+        if (!nodeDefinition.properties)
+            return false;
+        return nodeDefinition.properties.some((prop) => prop.type === 'string' && prop.typeOptions?.multipleValues !== true);
+    }
+    static selectRelevantExamples(context) {
+        const examples = [];
+        const config = context.config ?? prompt_config_1.DEFAULT_PROMPT_CONFIG;
+        const maxExamples = context.options?.maxExamples ?? config.maxExamples;
+        if (this.isToolNode(context.nodeType)) {
+            examples.push(tool_node_examples_1.TOOL_NODE_EXAMPLES);
+        }
+        else if (this.isSetNode(context.nodeType)) {
+            examples.push(set_node_examples_1.SET_NODE_EXAMPLES);
+        }
+        else if (this.isIfNode(context.nodeType)) {
+            examples.push(if_node_examples_1.IF_NODE_EXAMPLES);
+        }
+        if (context.hasResourceLocatorParams) {
+            examples.push(resource_locator_examples_1.RESOURCE_LOCATOR_EXAMPLES);
+        }
+        if (examples.length === 0) {
+            examples.push(simple_updates_1.SIMPLE_UPDATE_EXAMPLES);
+        }
+        return examples.slice(0, maxExamples);
+    }
+    static hasResourceLocatorParameters(nodeDefinition) {
+        if (!nodeDefinition.properties)
+            return false;
+        const checkProperties = (properties) => {
+            for (const prop of properties) {
+                if (prop.type === 'resourceLocator' || prop.type === 'fixedCollection')
+                    return true;
+            }
+            return false;
+        };
+        return checkProperties(nodeDefinition.properties);
+    }
+    static estimateTokens(prompt) {
+        return Math.ceil(prompt.length / 4);
+    }
+}
+exports.ParameterUpdatePromptBuilder = ParameterUpdatePromptBuilder;
+//# sourceMappingURL=prompt-builder.js.map

package/dist/chains/prompts/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../../src/chains/prompts/prompt-builder.ts"],"names":[],"mappings":"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"}

package/dist/chains/prompts/prompt-config.d.ts

@@ -0,0 +1,5 @@
+import type { NodePromptConfig } from '../../types/config';
+export declare const DEFAULT_PROMPT_CONFIG: NodePromptConfig;
+export declare function getNodeTypeCategory(nodeType: string, config?: NodePromptConfig): string | null;
+export declare function mentionsResourceKeywords(changes: string[], config?: NodePromptConfig): boolean;
+export declare function mentionsTextKeywords(changes: string[], config?: NodePromptConfig): boolean;

package/dist/chains/prompts/prompt-config.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PROMPT_CONFIG = void 0;
+exports.getNodeTypeCategory = getNodeTypeCategory;
+exports.mentionsResourceKeywords = mentionsResourceKeywords;
+exports.mentionsTextKeywords = mentionsTextKeywords;
+exports.DEFAULT_PROMPT_CONFIG = {
+    nodeTypePatterns: {
+        set: ['n8n-nodes-base.set', 'set'],
+        if: ['n8n-nodes-base.if', 'if', 'filter'],
+        httpRequest: ['n8n-nodes-base.httpRequest', 'httprequest', 'webhook', 'n8n-nodes-base.webhook'],
+        tool: ['Tool', '.tool'],
+    },
+    parameterKeywords: {
+        resourceLocator: [
+            'channel',
+            'file',
+            'page',
+            'document',
+            'sheet',
+            'folder',
+            'database',
+            'board',
+            'list',
+            'space',
+        ],
+        textExpressions: ['message', 'text', 'content', 'body', 'description', 'title', 'subject'],
+    },
+    maxExamples: 3,
+    targetTokenBudget: 3000,
+};
+function getNodeTypeCategory(nodeType, config = exports.DEFAULT_PROMPT_CONFIG) {
+    const lowerType = nodeType.toLowerCase();
+    for (const [category, patterns] of Object.entries(config.nodeTypePatterns)) {
+        if (patterns.some((pattern) => lowerType.includes(pattern.toLowerCase()))) {
+            return category;
+        }
+    }
+    if (nodeType.endsWith('Tool') || nodeType.includes('.tool')) {
+        return 'tool';
+    }
+    return null;
+}
+function mentionsResourceKeywords(changes, config = exports.DEFAULT_PROMPT_CONFIG) {
+    const changesText = changes.join(' ').toLowerCase();
+    return config.parameterKeywords.resourceLocator.some((keyword) => changesText.includes(keyword));
+}
+function mentionsTextKeywords(changes, config = exports.DEFAULT_PROMPT_CONFIG) {
+    const changesText = changes.join(' ').toLowerCase();
+    return config.parameterKeywords.textExpressions.some((keyword) => changesText.includes(keyword));
+}
+//# sourceMappingURL=prompt-config.js.map

package/dist/chains/prompts/prompt-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-config.js","sourceRoot":"","sources":["../../../src/chains/prompts/prompt-config.ts"],"names":[],"mappings":";;;AAiCA,kDAkBC;AAKD,4DAMC;AAKD,oDAMC;AAvEY,QAAA,qBAAqB,GAAqB;IACtD,gBAAgB,EAAE;QACjB,GAAG,EAAE,CAAC,oBAAoB,EAAE,KAAK,CAAC;QAClC,EAAE,EAAE,CAAC,mBAAmB,EAAE,IAAI,EAAE,QAAQ,CAAC;QACzC,WAAW,EAAE,CAAC,4BAA4B,EAAE,aAAa,EAAE,SAAS,EAAE,wBAAwB,CAAC;QAC/F,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KACvB;IAED,iBAAiB,EAAE;QAClB,eAAe,EAAE;YAChB,SAAS;YACT,MAAM;YACN,MAAM;YACN,UAAU;YACV,OAAO;YACP,QAAQ;YACR,UAAU;YACV,OAAO;YACP,MAAM;YACN,OAAO;SACP;QACD,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC;KAC1F;IAED,WAAW,EAAE,CAAC;IACd,iBAAiB,EAAE,IAAI;CACvB,CAAC;AAKF,SAAgB,mBAAmB,CAClC,QAAgB,EAChB,SAA2B,6BAAqB;IAEhD,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5E,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3E,OAAO,QAAQ,CAAC;QACjB,CAAC;IACF,CAAC;IAGD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAKD,SAAgB,wBAAwB,CACvC,OAAiB,EACjB,SAA2B,6BAAqB;IAEhD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,OAAO,MAAM,CAAC,iBAAiB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAClG,CAAC;AAKD,SAAgB,oBAAoB,CACnC,OAAiB,EACjB,SAA2B,6BAAqB;IAEhD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,OAAO,MAAM,CAAC,iBAAiB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAClG,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,45 @@
+import { OperationalError, UnexpectedError } from 'n8n-workflow';
+import type { OperationalErrorOptions, UnexpectedErrorOptions } from 'n8n-workflow';
+export declare abstract class AiWorkflowBuilderError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class NodeNotFoundError extends OperationalError {
+    constructor(nodeId: string, nodeType?: string, options?: OperationalErrorOptions);
+}
+export declare class NodeTypeNotFoundError extends OperationalError {
+    constructor(nodeType: string, options?: OperationalErrorOptions);
+}
+export declare class ConnectionError extends OperationalError {
+    constructor(message: string, options?: OperationalErrorOptions & {
+        fromNodeId?: string;
+        toNodeId?: string;
+        connectionType?: string;
+    });
+}
+export declare class LLMServiceError extends OperationalError {
+    constructor(message: string, options?: OperationalErrorOptions & {
+        llmModel?: string;
+        statusCode?: number;
+    });
+}
+export declare class ValidationError extends OperationalError {
+    constructor(message: string, options?: OperationalErrorOptions & {
+        field?: string;
+        value?: unknown;
+    });
+}
+export declare class ParameterUpdateError extends OperationalError {
+    constructor(message: string, options?: OperationalErrorOptions & {
+        nodeId?: string;
+        nodeType: string;
+        parameter?: string;
+    });
+}
+export declare class WorkflowStateError extends UnexpectedError {
+    constructor(message: string, options?: UnexpectedErrorOptions);
+}
+export declare class ToolExecutionError extends UnexpectedError {
+    constructor(message: string, options?: UnexpectedErrorOptions & {
+        toolName?: string;
+    });
+}

package/dist/errors/index.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutionError = exports.WorkflowStateError = exports.ParameterUpdateError = exports.ValidationError = exports.LLMServiceError = exports.ConnectionError = exports.NodeTypeNotFoundError = exports.NodeNotFoundError = exports.AiWorkflowBuilderError = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+class AiWorkflowBuilderError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = this.constructor.name;
+    }
+}
+exports.AiWorkflowBuilderError = AiWorkflowBuilderError;
+class NodeNotFoundError extends n8n_workflow_1.OperationalError {
+    constructor(nodeId, nodeType, options) {
+        super(`Node with ID "${nodeId}" not found in workflow`, {
+            ...options,
+            tags: {
+                ...options?.tags,
+                nodeId,
+                nodeType,
+            },
+            shouldReport: false,
+        });
+    }
+}
+exports.NodeNotFoundError = NodeNotFoundError;
+class NodeTypeNotFoundError extends n8n_workflow_1.OperationalError {
+    constructor(nodeType, options) {
+        super(`Node type "${nodeType}" not found`, {
+            ...options,
+            tags: {
+                ...options?.tags,
+                nodeType,
+            },
+            shouldReport: false,
+        });
+    }
+}
+exports.NodeTypeNotFoundError = NodeTypeNotFoundError;
+class ConnectionError extends n8n_workflow_1.OperationalError {
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            tags: {
+                ...options?.tags,
+                fromNodeId: options?.fromNodeId,
+                toNodeId: options?.toNodeId,
+                connectionType: options?.connectionType,
+            },
+            shouldReport: false,
+        });
+    }
+}
+exports.ConnectionError = ConnectionError;
+class LLMServiceError extends n8n_workflow_1.OperationalError {
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            tags: {
+                ...options?.tags,
+                llmModel: options?.llmModel,
+                statusCode: options?.statusCode,
+            },
+            shouldReport: true,
+        });
+    }
+}
+exports.LLMServiceError = LLMServiceError;
+class ValidationError extends n8n_workflow_1.OperationalError {
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            tags: {
+                ...options?.tags,
+                field: options?.field,
+            },
+            extra: {
+                ...options?.extra,
+                value: options?.value,
+            },
+            shouldReport: false,
+        });
+    }
+}
+exports.ValidationError = ValidationError;
+class ParameterUpdateError extends n8n_workflow_1.OperationalError {
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            tags: {
+                ...options?.tags,
+                nodeId: options?.nodeId,
+                nodeType: options?.nodeType,
+                parameter: options?.parameter,
+            },
+            shouldReport: false,
+        });
+    }
+}
+exports.ParameterUpdateError = ParameterUpdateError;
+class WorkflowStateError extends n8n_workflow_1.UnexpectedError {
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            shouldReport: true,
+        });
+    }
+}
+exports.WorkflowStateError = WorkflowStateError;
+class ToolExecutionError extends n8n_workflow_1.UnexpectedError {
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            shouldReport: true,
+            tags: {
+                ...options?.tags,
+                toolName: options?.toolName,
+            },
+        });
+    }
+}
+exports.ToolExecutionError = ToolExecutionError;
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './ai-workflow-builder.service';
+export * from './ai-workflow-builder-agent.service';
 export * from './types';
 export * from './workflow-state';

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./ai-workflow-builder.service"), exports);
+__exportStar(require("./ai-workflow-builder-agent.service"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./workflow-state"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,0CAAwB;AACxB,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sEAAoD;AACpD,0CAAwB;AACxB,mDAAiC"}

package/dist/llm-config.d.ts

@@ -1,9 +1,10 @@
-type LLMConfig = {
+interface LLMProviderConfig {
     apiKey: string;
     baseUrl?: string;
     headers?: Record<string, string>;
-};
-export declare const o4mini: (config: LLMConfig) => Promise<import("@langchain/openai").ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>>;
-export declare const gpt41mini: (config: LLMConfig) => Promise<import("@langchain/openai").ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>>;
-export declare const anthropicClaude37Sonnet: (config: LLMConfig) => Promise<import("@langchain/anthropic").ChatAnthropic>;
+}
+export declare const o4mini: (config: LLMProviderConfig) => Promise<import("@langchain/openai").ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>>;
+export declare const gpt41mini: (config: LLMProviderConfig) => Promise<import("@langchain/openai").ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>>;
+export declare const gpt41: (config: LLMProviderConfig) => Promise<import("@langchain/openai").ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>>;
+export declare const anthropicClaudeSonnet4: (config: LLMProviderConfig) => Promise<import("@langchain/anthropic").ChatAnthropic>;
 export {};