@n8n/ai-workflow-builder 0.27.1 → 0.29.0

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

@@ -1,12 +1,6 @@
 import type { INodeTypeDescription, NodeConnectionType } from 'n8n-workflow';
 import type { NodeSearchResult } from '../../types/nodes';
 export declare const SCORE_WEIGHTS: {
-    readonly NAME_CONTAINS: 10;
-    readonly DISPLAY_NAME_CONTAINS: 8;
-    readonly DESCRIPTION_CONTAINS: 5;
-    readonly ALIAS_CONTAINS: 8;
-    readonly NAME_EXACT: 20;
-    readonly DISPLAY_NAME_EXACT: 15;
     readonly CONNECTION_EXACT: 100;
     readonly CONNECTION_IN_EXPRESSION: 50;
 };
@@ -16,10 +10,7 @@ export declare class NodeSearchEngine {
     searchByName(query: string, limit?: number): NodeSearchResult[];
     searchByConnectionType(connectionType: NodeConnectionType, limit?: number, nameFilter?: string): NodeSearchResult[];
     formatResult(result: NodeSearchResult): string;
-    private calculateNameScore;
     private getConnectionScore;
-    private createSearchResult;
-    private sortAndLimit;
     static isAiConnectionType(connectionType: string): boolean;
     static getAiConnectionTypes(): NodeConnectionType[];
 }

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

@@ -1,14 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeSearchEngine = exports.SCORE_WEIGHTS = void 0;
+const sublimeSearch_1 = require("@n8n/utils/dist/search/sublimeSearch");
 const n8n_workflow_1 = require("n8n-workflow");
+const NODE_SEARCH_KEYS = [
+    { key: 'displayName', weight: 1.5 },
+    { key: 'name', weight: 1.3 },
+    { key: 'codex.alias', weight: 1.0 },
+    { key: 'description', weight: 0.7 },
+];
 exports.SCORE_WEIGHTS = {
-    NAME_CONTAINS: 10,
-    DISPLAY_NAME_CONTAINS: 8,
-    DESCRIPTION_CONTAINS: 5,
-    ALIAS_CONTAINS: 8,
-    NAME_EXACT: 20,
-    DISPLAY_NAME_EXACT: 15,
     CONNECTION_EXACT: 100,
     CONNECTION_IN_EXPRESSION: 50,
 };
@@ -18,40 +19,54 @@ class NodeSearchEngine {
         this.nodeTypes = nodeTypes;
     }
     searchByName(query, limit = 20) {
-        const normalizedQuery = query.toLowerCase();
-        const results = [];
-        for (const nodeType of this.nodeTypes) {
-            try {
-                const score = this.calculateNameScore(nodeType, normalizedQuery);
-                if (score > 0) {
-                    results.push(this.createSearchResult(nodeType, score));
-                }
-            }
-            catch (error) {
-            }
-        }
-        return this.sortAndLimit(results, limit);
+        const searchResults = (0, sublimeSearch_1.sublimeSearch)(query, this.nodeTypes, NODE_SEARCH_KEYS);
+        return searchResults
+            .slice(0, limit)
+            .map(({ item, score }) => ({
+            name: item.name,
+            displayName: item.displayName,
+            description: item.description ?? 'No description available',
+            inputs: item.inputs,
+            outputs: item.outputs,
+            score,
+        }));
     }
     searchByConnectionType(connectionType, limit = 20, nameFilter) {
-        const results = [];
-        const normalizedFilter = nameFilter?.toLowerCase();
-        for (const nodeType of this.nodeTypes) {
-            try {
-                const connectionScore = this.getConnectionScore(nodeType, connectionType);
-                if (connectionScore > 0) {
-                    const nameScore = normalizedFilter
-                        ? this.calculateNameScore(nodeType, normalizedFilter)
-                        : 0;
-                    if (!normalizedFilter || nameScore > 0) {
-                        const totalScore = connectionScore + nameScore;
-                        results.push(this.createSearchResult(nodeType, totalScore));
-                    }
-                }
-            }
-            catch (error) {
-            }
+        const nodesWithConnectionType = this.nodeTypes
+            .map((nodeType) => {
+            const connectionScore = this.getConnectionScore(nodeType, connectionType);
+            return connectionScore > 0 ? { nodeType, connectionScore } : null;
+        })
+            .filter((result) => Boolean(result));
+        if (!nameFilter) {
+            return nodesWithConnectionType
+                .sort((a, b) => b.connectionScore - a.connectionScore)
+                .slice(0, limit)
+                .map(({ nodeType, connectionScore }) => ({
+                name: nodeType.name,
+                displayName: nodeType.displayName,
+                description: nodeType.description ?? 'No description available',
+                inputs: nodeType.inputs,
+                outputs: nodeType.outputs,
+                score: connectionScore,
+            }));
         }
-        return this.sortAndLimit(results, limit);
+        const nodeTypesOnly = nodesWithConnectionType.map((result) => result.nodeType);
+        const nameFilteredResults = (0, sublimeSearch_1.sublimeSearch)(nameFilter, nodeTypesOnly, NODE_SEARCH_KEYS);
+        return nameFilteredResults
+            .slice(0, limit)
+            .map(({ item, score: nameScore }) => {
+            const connectionResult = nodesWithConnectionType.find((result) => result.nodeType.name === item.name);
+            const connectionScore = connectionResult?.connectionScore ?? 0;
+            return {
+                name: item.name,
+                displayName: item.displayName,
+                description: item.description ?? 'No description available',
+                inputs: item.inputs,
+                outputs: item.outputs,
+                score: connectionScore + nameScore,
+            };
+        });
     }
     formatResult(result) {
         return `
@@ -62,28 +77,6 @@ class NodeSearchEngine {
 			<node_outputs>${typeof result.outputs === 'object' ? JSON.stringify(result.outputs) : result.outputs}</node_outputs>
 		</node>`;
     }
-    calculateNameScore(nodeType, normalizedQuery) {
-        let score = 0;
-        if (nodeType.name.toLowerCase().includes(normalizedQuery)) {
-            score += exports.SCORE_WEIGHTS.NAME_CONTAINS;
-        }
-        if (nodeType.displayName.toLowerCase().includes(normalizedQuery)) {
-            score += exports.SCORE_WEIGHTS.DISPLAY_NAME_CONTAINS;
-        }
-        if (nodeType.description?.toLowerCase().includes(normalizedQuery)) {
-            score += exports.SCORE_WEIGHTS.DESCRIPTION_CONTAINS;
-        }
-        if (nodeType.codex?.alias?.some((alias) => alias.toLowerCase().includes(normalizedQuery))) {
-            score += exports.SCORE_WEIGHTS.ALIAS_CONTAINS;
-        }
-        if (nodeType.name.toLowerCase() === normalizedQuery) {
-            score += exports.SCORE_WEIGHTS.NAME_EXACT;
-        }
-        if (nodeType.displayName.toLowerCase() === normalizedQuery) {
-            score += exports.SCORE_WEIGHTS.DISPLAY_NAME_EXACT;
-        }
-        return score;
-    }
     getConnectionScore(nodeType, connectionType) {
         const outputs = nodeType.outputs;
         if (Array.isArray(outputs)) {
@@ -98,19 +91,6 @@ class NodeSearchEngine {
         }
         return 0;
     }
-    createSearchResult(nodeType, score) {
-        return {
-            name: nodeType.name,
-            displayName: nodeType.displayName,
-            description: nodeType.description ?? 'No description available',
-            inputs: nodeType.inputs,
-            outputs: nodeType.outputs,
-            score,
-        };
-    }
-    sortAndLimit(results, limit) {
-        return results.sort((a, b) => b.score - a.score).slice(0, limit);
-    }
     static isAiConnectionType(connectionType) {
         return connectionType.startsWith('ai_');
     }

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

@@ -1 +1 @@
-{"version":3,"file":"node-search-engine.js","sourceRoot":"","sources":["../../../src/tools/engines/node-search-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node-search-engine.js","sourceRoot":"","sources":["../../../src/tools/engines/node-search-engine.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-best-practices.tool.d.ts

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

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

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

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

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

package/dist/tools/prompts/main-agent.prompt.js

@@ -33,24 +33,28 @@ The system's operations processor ensures state consistency across all parallel
 <workflow_creation_sequence>
 Follow this proven sequence for creating robust workflows:
 
-1. **Discovery Phase** (parallel execution)
+1. **Categorization Phase** - MANDATORY
+   - Categorize the prompt and search for best practices documentation based on the techniques found
+   - Why: Best practices help to inform which nodes to search for and use to build the workflow plus mistakes to avoid
+
+2. **Discovery Phase** (parallel execution)
    - Search for all required node types simultaneously
    - Why: Ensures you work with actual available nodes, not assumptions
 
-2. **Analysis Phase** (parallel execution)
+3. **Analysis Phase** (parallel execution)
    - Get details for ALL nodes before proceeding
    - Why: Understanding inputs/outputs prevents connection errors and ensures proper parameter configuration
 
-3. **Creation Phase** (parallel execution)
+4. **Creation Phase** (parallel execution)
    - Add nodes individually by calling add_nodes for each node
    - Execute multiple add_nodes calls in parallel for efficiency
    - Why: Each node addition is independent, parallel execution is faster, and the operations processor ensures consistency
 
-4. **Connection Phase** (parallel execution)
+5. **Connection Phase** (parallel execution)
    - Connect all nodes based on discovered input/output structure
    - Why: Parallel connections are safe and faster
 
-5. **Configuration Phase** (parallel execution) - MANDATORY
+6. **Configuration Phase** (parallel execution) - MANDATORY
    - ALWAYS configure nodes using update_node_parameters
    - Even for "simple" nodes like HTTP Request, Set, etc.
    - Configure all nodes in parallel for efficiency
@@ -58,6 +62,23 @@ Follow this proven sequence for creating robust workflows:
    - Pay special attention to parameters that control node behavior (dataType, mode, operation)
    - Why: Unconfigured nodes will fail at runtime, defaults are unreliable
 
+6. **Validation Phase** (tool call) - MANDATORY
+   - Run validate_workflow after applying changes to refresh the workflow validation report
+   - Review <workflow_validation_report> and resolve any violations before finalizing
+   - Why: Ensures structural issues are surfaced early; rerun validation after major updates
+
+<best_practices_compliance>
+Enforcing best practice compliance is MANDATORY
+
+You MUST enforce best practices even when the user doesn't explicitly request them. Best practices document CRITICAL requirements that prevent production failures.
+
+When you retrieve best practices and see CRITICAL requirements:
+1. Identify all MUST-HAVE nodes and configurations
+2. Add them to your workflow plan
+3. Include them in the workflow even if user didn't explicitly ask
+4. Mention them in your setup response so user understands why they're there
+</best_practices_compliance>
+
 <parallel_node_creation_example>
 Example: Creating and configuring a workflow (complete process):
 
@@ -71,6 +92,10 @@ Step 2 - Connect nodes:
 Step 3 - Configure ALL nodes in parallel (MANDATORY):
 - update_node_parameters({{ nodeId: "Fetch Data", instructions: ["Set URL to https://api.example.com/users", "Set method to GET"] }})
 - update_node_parameters({{ nodeId: "Transform Data", instructions: ["Add field status with value 'processed'", "Add field timestamp with current date"] }})
+
+Step 4 - Validate workflow:
+- validate_workflow()
+- If there are validation errors or warnings, address them by returning to the appropriate phase.
 </parallel_node_creation_example>
 </workflow_creation_sequence>
 
@@ -83,6 +108,7 @@ Always determine connectionParametersReasoning before setting connectionParamete
 - Does this node have dynamic inputs/outputs?
 - Which parameters affect the connection structure?
 - What mode or operation changes the available connections?
+- Are there best practices which provide recommendations for connections?
 </reasoning_first>
 
 <parameter_examples>
@@ -232,6 +258,90 @@ Configure multiple nodes in parallel:
 - update_node_parameters({{ nodeId: "documentLoader1", instructions: ["Set dataType to 'binary' for processing PDF files", "Set loader to 'pdfLoader'", "Enable splitPages option"] }})
 
 Why: Unconfigured nodes WILL fail at runtime
+
+<system_message_configuration>
+CRITICAL: For AI nodes (AI Agent, LLM Chain, Anthropic, OpenAI, etc.), you MUST separate system-level instructions from user context.
+
+**System Message vs User Prompt:**
+- **System Message** = AI's ROLE, CAPABILITIES, TASK DESCRIPTION, and BEHAVIORAL INSTRUCTIONS
+- **User Message/Text** = DYNAMIC USER INPUT, CONTEXT VARIABLES, and DATA REFERENCES
+
+**Node-specific field names:**
+- AI Agent: system message goes in options.systemMessage, user context in text
+- LLM Chain: system message in messages.messageValues[] with system role, user context in text
+- Anthropic: system message in options.system, user context in messages.values[]
+- OpenAI: system message in messages.values[] with role "system", user in messages.values[] with role "user"
+
+**System Message** should contain:
+- AI identity and role ("You are a...")
+- Task description ("Your task is to...")
+- Step-by-step instructions
+- Behavioral guidelines
+- Expected output format
+- Coordination instructions
+
+**User Message/Text** should contain:
+- Dynamic data from workflow (expressions like {{ $json.field }})
+- User input references ({{ $json.chatInput }})
+- Context variables from previous nodes
+- Minimal instruction (just what varies per execution)
+
+**WRONG - Everything in text/user message field:**
+❌ text: "=You are an orchestrator that coordinates specialized AI tasks. Your task is to: 1) Call Research Tool 2) Call Fact-Check Tool 3) Return HTML. The research topic is: {{ $json.researchTopic }}"
+
+**RIGHT - Properly separated:**
+✅ text: "=The research topic is: {{ $json.researchTopic }}"
+✅ System message: "You are an orchestrator that coordinates specialized AI tasks.\n\nYour task is to:\n1. Call the Research Agent Tool to gather information\n2. Call the Fact-Check Agent Tool to verify findings\n3. Call the Report Writer Agent Tool to create a report\n4. Return ONLY the final result"
+
+**Configuration Examples:**
+
+Example 1 - AI Agent with orchestration:
+update_node_parameters({{
+  nodeId: "orchestratorAgent",
+  instructions: [
+    "Set text to '=The research topic is: {{ $json.researchTopic }}'",
+    "Set system message to 'You are an orchestrator coordinating AI tasks to research topics and generate reports.\\n\\nYour task is to:\\n1. Call the Research Agent Tool to gather information\\n2. Call the Fact-Check Agent Tool to verify findings (require 2+ sources)\\n3. Call the Report Writer Agent Tool to create a report under 1,000 words\\n4. Call the HTML Editor Agent Tool to format as HTML\\n5. Return ONLY the final HTML content'"
+  ]
+}})
+
+Example 2 - AI Agent Tool (sub-agent):
+update_node_parameters({{
+  nodeId: "subAgentTool",
+  instructions: [
+    "Set text to '=Process this input: {{ $fromAI(\\'input\\') }}'",
+    "Set system message to 'You are a specialized assistant. Process the provided input and return the results in the requested format.'"
+  ]
+}})
+
+CRITICAL: AI Agent Tools MUST have BOTH system message AND text field configured:
+- System message: Define the tool's role and capabilities
+- Text field: Pass the context/input using $fromAI() to receive parameters from the parent agent
+- Never leave text field empty - the tool needs to know what to process
+
+Example 3 - Chat-based AI node:
+update_node_parameters({{
+  nodeId: "chatAssistant",
+  instructions: [
+    "Set text to '=User question: {{ $json.chatInput }}'",
+    "Set system message to 'You are a helpful customer service assistant. Answer questions clearly and concisely. If you don\\'t know the answer, say so and offer to escalate to a human.'"
+  ]
+}})
+
+Example 4 - Data processing AI:
+update_node_parameters({{
+  nodeId: "analysisNode",
+  instructions: [
+    "Set text to '=Analyze this data: {{ $json.data }}'",
+    "Set system message to 'You are a data analysis assistant. Examine the provided data and:\\n1. Identify key patterns and trends\\n2. Calculate relevant statistics\\n3. Highlight anomalies or outliers\\n4. Provide actionable insights\\n\\nReturn your analysis in structured JSON format.'"
+  ]
+}})
+
+**Why this matters:**
+- Keeps AI behavior consistent (system message) while allowing dynamic context (user message)
+- Makes workflows more maintainable and reusable
+- Follows AI best practices for prompt engineering
+- Prevents mixing static instructions with dynamic data
+</system_message_configuration>
 </configuration_requirements>
 
 <data_parsing_strategy>
@@ -342,6 +452,7 @@ When modifying existing nodes:
 <handling_uncertainty>
 When unsure about specific values:
 - Add nodes and connections confidently
+- investigate best practices to see if there are recommendations on how to proceed
 - For uncertain parameters, use update_node_parameters with placeholders formatted exactly as "<__PLACEHOLDER_VALUE__VALUE_LABEL__>"
 - Make VALUE_LABEL descriptive (e.g., "API endpoint URL", "Auth token header") so users know what to supply
 - For tool nodes with dynamic values, use $fromAI expressions instead of placeholders

package/dist/tools/prompts/main-agent.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"main-agent.prompt.js","sourceRoot":"","sources":["../../../src/tools/prompts/main-agent.prompt.ts"],"names":[],"mappings":";;;AAAA,qDAA6D;AAE7D,oEAAsE;AAEtE,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwWpB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCxB,CAAC;AAEF,MAAM,2BAA2B,GAAG;;;oBAGhB,CAAC;AAER,QAAA,eAAe,GAAG,4BAAkB,CAAC,YAAY,CAAC;IAC9D;QACC,QAAQ;QACR;YACC;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,YAAY;aAClB;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,gCAAiB;aACvB;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,gBAAgB;aACtB;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,2BAA2B;gBACjC,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;aACpC;SACD;KACD;IACD,CAAC,aAAa,EAAE,YAAY,CAAC;CAC7B,CAAC,CAAC"}
+{"version":3,"file":"main-agent.prompt.js","sourceRoot":"","sources":["../../../src/tools/prompts/main-agent.prompt.ts"],"names":[],"mappings":";;;AAAA,qDAA6D;AAE7D,oEAAsE;AAEtE,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAudpB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCxB,CAAC;AAEF,MAAM,2BAA2B,GAAG;;;oBAGhB,CAAC;AAER,QAAA,eAAe,GAAG,4BAAkB,CAAC,YAAY,CAAC;IAC9D;QACC,QAAQ;QACR;YACC;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,YAAY;aAClB;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,gCAAiB;aACvB;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,gBAAgB;aACtB;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,2BAA2B;gBACjC,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;aACpC;SACD;KACD;IACD,CAAC,aAAa,EAAE,YAAY,CAAC;CAC7B,CAAC,CAAC"}

package/dist/tools/validate-workflow.tool.d.ts

@@ -0,0 +1,5 @@
+import type { Logger } from '@n8n/backend-common';
+import type { INodeTypeDescription } from 'n8n-workflow';
+import type { BuilderTool, BuilderToolBase } from '../utils/stream-processor';
+export declare const VALIDATE_WORKFLOW_TOOL: BuilderToolBase;
+export declare function createValidateWorkflowTool(parsedNodeTypes: INodeTypeDescription[], logger?: Logger): BuilderTool;

package/dist/tools/validate-workflow.tool.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALIDATE_WORKFLOW_TOOL = void 0;
+exports.createValidateWorkflowTool = createValidateWorkflowTool;
+const tools_1 = require("@langchain/core/tools");
+const zod_1 = require("zod");
+const programmatic_1 = require("../validation/programmatic");
+const errors_1 = require("../errors");
+const workflow_validation_1 = require("../utils/workflow-validation");
+const progress_1 = require("./helpers/progress");
+const response_1 = require("./helpers/response");
+const state_1 = require("./helpers/state");
+const validateWorkflowSchema = zod_1.z.object({}).strict().default({});
+exports.VALIDATE_WORKFLOW_TOOL = {
+    toolName: 'validate_workflow',
+    displayTitle: 'Validating workflow',
+};
+function createValidateWorkflowTool(parsedNodeTypes, logger) {
+    const dynamicTool = (0, tools_1.tool)(async (input, config) => {
+        const reporter = (0, progress_1.createProgressReporter)(config, exports.VALIDATE_WORKFLOW_TOOL.toolName, exports.VALIDATE_WORKFLOW_TOOL.displayTitle);
+        try {
+            const validatedInput = validateWorkflowSchema.parse(input ?? {});
+            reporter.start(validatedInput);
+            const state = (0, state_1.getWorkflowState)();
+            (0, progress_1.reportProgress)(reporter, 'Running programmatic checks');
+            const violations = (0, programmatic_1.programmaticValidation)({
+                generatedWorkflow: state.workflowJSON,
+            }, parsedNodeTypes);
+            const message = (0, workflow_validation_1.formatWorkflowValidation)(violations);
+            reporter.complete({ message });
+            return (0, response_1.createSuccessResponse)(config, message, {
+                workflowValidation: violations,
+            });
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                const validationError = new errors_1.ValidationError('Invalid input parameters', {
+                    extra: { errors: error.errors },
+                });
+                reporter.error(validationError);
+                return (0, response_1.createErrorResponse)(config, validationError);
+            }
+            const toolError = new errors_1.ToolExecutionError(error instanceof Error ? error.message : 'Failed to validate workflow', {
+                toolName: exports.VALIDATE_WORKFLOW_TOOL.toolName,
+                cause: error instanceof Error ? error : undefined,
+            });
+            logger?.warn('validate_workflow tool failed', { error: toolError });
+            reporter.error(toolError);
+            return (0, response_1.createErrorResponse)(config, toolError);
+        }
+    }, {
+        name: exports.VALIDATE_WORKFLOW_TOOL.toolName,
+        description: 'Run validation checks against the current workflow. Call this after making changes to ensure the workflow is valid.',
+        schema: validateWorkflowSchema,
+    });
+    return {
+        tool: dynamicTool,
+        ...exports.VALIDATE_WORKFLOW_TOOL,
+    };
+}
+//# sourceMappingURL=validate-workflow.tool.js.map

package/dist/tools/validate-workflow.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow.tool.js","sourceRoot":"","sources":["../../src/tools/validate-workflow.tool.ts"],"names":[],"mappings":";;;AAqBA,gEAoEC;AAzFD,iDAA6C;AAG7C,6BAAwB;AAGxB,4DAAmE;AAEnE,sCAAgE;AAChE,sEAAwE;AACxE,iDAA4E;AAC5E,iDAAgF;AAChF,2CAAmD;AAEnD,MAAM,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAEpD,QAAA,sBAAsB,GAAoB;IACtD,QAAQ,EAAE,mBAAmB;IAC7B,YAAY,EAAE,qBAAqB;CACnC,CAAC;AAEF,SAAgB,0BAA0B,CACzC,eAAuC,EACvC,MAAe;IAEf,MAAM,WAAW,GAAG,IAAA,YAAI,EACvB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,IAAA,iCAAsB,EACtC,MAAM,EACN,8BAAsB,CAAC,QAAQ,EAC/B,8BAAsB,CAAC,YAAY,CACnC,CAAC;QAEF,IAAI,CAAC;YACJ,MAAM,cAAc,GAAG,sBAAsB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACjE,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAE/B,MAAM,KAAK,GAAG,IAAA,wBAAgB,GAAE,CAAC;YACjC,IAAA,yBAAc,EAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;YAExD,MAAM,UAAU,GAAG,IAAA,qCAAsB,EACxC;gBACC,iBAAiB,EAAE,KAAK,CAAC,YAAY;aACrC,EACD,eAAe,CACf,CAAC;YAEF,MAAM,OAAO,GAAG,IAAA,8CAAwB,EAAC,UAAU,CAAC,CAAC;YAErD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAE/B,OAAO,IAAA,gCAAqB,EAAC,MAAM,EAAE,OAAO,EAAE;gBAC7C,kBAAkB,EAAE,UAAU;aAC9B,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;gBACjC,MAAM,eAAe,GAAG,IAAI,wBAAe,CAAC,0BAA0B,EAAE;oBACvE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;iBAC/B,CAAC,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;gBAChC,OAAO,IAAA,8BAAmB,EAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,2BAAkB,CACvC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,EACtE;gBACC,QAAQ,EAAE,8BAAsB,CAAC,QAAQ;gBACzC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACjD,CACD,CAAC;YAEF,MAAM,EAAE,IAAI,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAEpE,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC1B,OAAO,IAAA,8BAAmB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC/C,CAAC;IACF,CAAC,EACD;QACC,IAAI,EAAE,8BAAsB,CAAC,QAAQ;QACrC,WAAW,EACV,qHAAqH;QACtH,MAAM,EAAE,sBAAsB;KAC9B,CACD,CAAC;IAEF,OAAO;QACN,IAAI,EAAE,WAAW;QACjB,GAAG,8BAAsB;KACzB,CAAC;AACH,CAAC"}

package/dist/types/best-practices.d.ts

@@ -0,0 +1,6 @@
+import type { WorkflowTechniqueType } from './categorization';
+export interface BestPracticesDocument {
+    readonly technique: WorkflowTechniqueType;
+    readonly version: string;
+    getDocumentation(): string;
+}

package/dist/types/best-practices.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=best-practices.js.map

package/dist/types/best-practices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-practices.js","sourceRoot":"","sources":["../../src/types/best-practices.ts"],"names":[],"mappings":""}