@n8n/ai-workflow-builder 0.28.0 → 0.29.0

package/dist/tools/best-practices/form-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-input.js","sourceRoot":"","sources":["../../../src/tools/best-practices/form-input.ts"],"names":[],"mappings":";;;AACA,2DAA2D;AAE3D,MAAa,sBAAsB;IACzB,SAAS,GAAG,kCAAiB,CAAC,UAAU,CAAC;IACzC,OAAO,GAAG,OAAO,CAAC;IAEV,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+JjC,CAAC;IAED,gBAAgB;QACf,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;CACD;AAxKD,wDAwKC"}

package/dist/tools/best-practices/index.d.ts

@@ -0,0 +1,3 @@
+import type { BestPracticesDocument } from '../../types';
+import { type WorkflowTechniqueType } from '../../types/categorization';
+export declare const documentation: Record<WorkflowTechniqueType, BestPracticesDocument | undefined>;

package/dist/tools/best-practices/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.documentation = void 0;
+const categorization_1 = require("../../types/categorization");
+const chatbot_1 = require("./chatbot");
+const content_generation_1 = require("./content-generation");
+const data_extraction_1 = require("./data-extraction");
+const form_input_1 = require("./form-input");
+const scraping_and_research_1 = require("./scraping-and-research");
+exports.documentation = {
+    [categorization_1.WorkflowTechnique.SCRAPING_AND_RESEARCH]: new scraping_and_research_1.ScrapingAndResearchBestPractices(),
+    [categorization_1.WorkflowTechnique.CHATBOT]: new chatbot_1.ChatbotBestPractices(),
+    [categorization_1.WorkflowTechnique.CONTENT_GENERATION]: new content_generation_1.ContentGenerationBestPractices(),
+    [categorization_1.WorkflowTechnique.DATA_EXTRACTION]: new data_extraction_1.DataExtractionBestPractices(),
+    [categorization_1.WorkflowTechnique.FORM_INPUT]: new form_input_1.FormInputBestPractices(),
+    [categorization_1.WorkflowTechnique.DATA_ANALYSIS]: undefined,
+    [categorization_1.WorkflowTechnique.DATA_TRANSFORMATION]: undefined,
+    [categorization_1.WorkflowTechnique.DOCUMENT_PROCESSING]: undefined,
+    [categorization_1.WorkflowTechnique.ENRICHMENT]: undefined,
+    [categorization_1.WorkflowTechnique.HUMAN_IN_THE_LOOP]: undefined,
+    [categorization_1.WorkflowTechnique.KNOWLEDGE_BASE]: undefined,
+    [categorization_1.WorkflowTechnique.MONITORING]: undefined,
+    [categorization_1.WorkflowTechnique.NOTIFICATION]: undefined,
+    [categorization_1.WorkflowTechnique.SCHEDULING]: undefined,
+    [categorization_1.WorkflowTechnique.TRIAGE]: undefined,
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/best-practices/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/best-practices/index.ts"],"names":[],"mappings":";;;AACA,2DAAuF;AAEvF,uCAAiD;AACjD,6DAAsE;AACtE,uDAAgE;AAChE,6CAAsD;AACtD,mEAA2E;AAE9D,QAAA,aAAa,GAAqE;IAC9F,CAAC,kCAAiB,CAAC,qBAAqB,CAAC,EAAE,IAAI,wDAAgC,EAAE;IACjF,CAAC,kCAAiB,CAAC,OAAO,CAAC,EAAE,IAAI,8BAAoB,EAAE;IACvD,CAAC,kCAAiB,CAAC,kBAAkB,CAAC,EAAE,IAAI,mDAA8B,EAAE;IAC5E,CAAC,kCAAiB,CAAC,eAAe,CAAC,EAAE,IAAI,6CAA2B,EAAE;IACtE,CAAC,kCAAiB,CAAC,UAAU,CAAC,EAAE,IAAI,mCAAsB,EAAE;IAG5D,CAAC,kCAAiB,CAAC,aAAa,CAAC,EAAE,SAAS;IAC5C,CAAC,kCAAiB,CAAC,mBAAmB,CAAC,EAAE,SAAS;IAClD,CAAC,kCAAiB,CAAC,mBAAmB,CAAC,EAAE,SAAS;IAClD,CAAC,kCAAiB,CAAC,UAAU,CAAC,EAAE,SAAS;IACzC,CAAC,kCAAiB,CAAC,iBAAiB,CAAC,EAAE,SAAS;IAChD,CAAC,kCAAiB,CAAC,cAAc,CAAC,EAAE,SAAS;IAC7C,CAAC,kCAAiB,CAAC,UAAU,CAAC,EAAE,SAAS;IACzC,CAAC,kCAAiB,CAAC,YAAY,CAAC,EAAE,SAAS;IAC3C,CAAC,kCAAiB,CAAC,UAAU,CAAC,EAAE,SAAS;IACzC,CAAC,kCAAiB,CAAC,MAAM,CAAC,EAAE,SAAS;CACrC,CAAC"}

package/dist/tools/best-practices/scraping-and-research.d.ts

@@ -0,0 +1,7 @@
+import type { BestPracticesDocument } from '../../types/best-practices';
+export declare class ScrapingAndResearchBestPractices implements BestPracticesDocument {
+    readonly technique: "scraping_and_research";
+    readonly version = "1.0.0";
+    private readonly documentation;
+    getDocumentation(): string;
+}

package/dist/tools/best-practices/scraping-and-research.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScrapingAndResearchBestPractices = void 0;
+const categorization_1 = require("../../types/categorization");
+class ScrapingAndResearchBestPractices {
+    technique = categorization_1.WorkflowTechnique.SCRAPING_AND_RESEARCH;
+    version = '1.0.0';
+    documentation = `# Best Practices: Scraping & Research Workflows
+
+## Performance & Resource Management
+
+Batch requests and introduce delays to avoid hitting API rate limits or overloading target servers. Use Wait nodes and
+batching options in HTTP Request nodes. When 429 rate limiting errors occur due to receiving too many requests,
+implement batching to reduce request frequency or use the "Retry on Fail" feature to automatically handle throttled
+responses.
+
+Workflows processing large datasets can crash due to memory constraints. Use the Split In Batches node to process 200
+rows at a time to reduce memory usage, leverage built-in nodes instead of custom code, and increase execution timeouts
+via environment variables for better resource management.
+
+## Looping & Pagination
+
+Implement robust looping for paginated data. Use Set, IF, and Code nodes to manage page numbers and loop conditions,
+ensuring you don't miss data or create infinite loops. Leverage n8n's built-in mechanisms rather than manual approaches:
+use the $runIndex variable to track iterations without additional code nodes, and employ workflow static data or node
+run indexes to maintain state across loop cycles.
+
+## Recommended Nodes
+
+### HTTP Request (n8n-nodes-base.httpRequest)
+
+Purpose: Fetches web pages or API data for scraping and research workflows
+
+Pitfalls:
+
+- Depending on the data which the user wishes to scrape/research, it maybe against the terms of service to attempt to
+fetch it from the site directly. Using scraping nodes is the best way to get around this.
+
+Pitfalls:
+
+- Double-check URL formatting, query parameters, and ensure all required fields are present to avoid bad request errors
+- Be aware of 429 rate limiting errors when the service receives too many requests - implement batching or use "Retry on
+Fail" feature
+- Refresh expired tokens, verify API keys, and ensure correct permissions to avoid authentication failures
+
+### HTML Extract (n8n-nodes-base.htmlExtract)
+
+Purpose: Parses HTML and extracts data using CSS selectors for web scraping
+
+Pitfalls:
+
+- Some sites use JavaScript to render content, which may not be accessible via simple HTTP requests. Consider using
+browser automation tools or APIs if the HTML appears empty
+- Validate that the CSS selectors match the actual page structure to avoid extraction failures
+
+### Split Out (n8n-nodes-base.splitOut)
+
+Purpose: Processes lists of items one by one for sequential operations
+
+Pitfalls:
+- Can cause performance issues with very large datasets - consider using Split In Batches instead
+
+### Loop Over Items (Split in Batches) (n8n-nodes-base.splitInBatches)
+
+Purpose: Processes lists of items in batches to manage memory and performance
+
+Pitfalls:
+- Ensure proper loop configuration to avoid infinite loops or skipped data. The index 0
+(first connection) of the loop is treated as the done state, while the index 1 (second connection)
+is the connection that loops.
+- Use appropriate batch sizes (e.g., 200 rows) to balance memory usage and performance
+
+### Edit Fields (Set) (n8n-nodes-base.set)
+
+Purpose: Manipulates data, sets variables for loop control and state management
+
+### Code (n8n-nodes-base.code)
+
+Purpose: Implements custom logic for complex data transformations or pagination
+
+Pitfalls:
+
+- Prefer built-in nodes over custom code to reduce memory usage and improve maintainability
+- Avoid processing very large datasets in a single code execution - use batching
+
+### If (n8n-nodes-base.if)
+
+Purpose: Adds conditional logic for error handling, loop control, or data filtering
+
+Pitfalls:
+- Validate expressions carefully to avoid unexpected branching behavior
+
+### Wait (n8n-nodes-base.wait)
+
+Purpose: Introduces delays to respect rate limits and avoid overloading servers
+
+### Google Sheets (n8n-nodes-base.googleSheets)
+
+Purpose: Stores scraped data in spreadsheets for easy access and sharing
+
+### Microsoft Excel 365 (n8n-nodes-base.microsoftExcel)
+
+Purpose: Stores scraped data in Excel files for offline analysis
+
+### Airtable (n8n-nodes-base.airtable)
+
+Purpose: Saves structured data to a database with rich data types and relationships
+
+### AI Agent (@n8n/n8n-nodes-langchain.agent)
+
+Purpose: For research, summarization, and advanced data extraction. AI agents can autonomously gather information
+from websites, analyze content, and organize findings into structured formats, integrating tools for web scraping,
+content analysis, and database storage
+
+### Scraping Nodes
+
+- Phantombuster (n8n-nodes-base.phantombuster)
+- Apify (use HTTP Request or community node)
+- BrightData (use HTTP Request or community node)
+
+Purpose: If the user wishes to scrap data from sites like LinkedIn, Facebook, Instagram, Twitter/X, Indeed, Glassdoor
+or any other service similar to these large providers it is better to use a node designed for this. The scraping
+nodes provide access to these datasets while avoiding issues like rate limiting or breaking terms of service for
+sites like these.
+
+## Common Pitfalls to Avoid
+
+Bad Request Errors: Double-check URL formatting, query parameters, and ensure all required fields are present to
+avoid 400 errors when making HTTP requests.
+
+Rate Limits: Use batching and Wait nodes to avoid 429 errors. When the service receives too many requests, implement
+batching to reduce request frequency or use the "Retry on Fail" feature.
+
+Memory Issues: Avoid processing very large datasets in a single run; use batching and increase server resources if
+needed. Use Split In Batches node to process 200 rows at a time, leverage built-in nodes instead of custom code, and
+increase execution timeouts via environment variables.
+
+Empty or Unexpected Data: Some sites use JavaScript to render content, which may not be accessible via simple HTTP
+requests. Standard HTTP and HTML parsing nodes fail because sites load data asynchronously via JavaScript, leaving the
+initial HTML empty of actual content. Web scraping nodes can be used to avoid this.
+`;
+    getDocumentation() {
+        return this.documentation;
+    }
+}
+exports.ScrapingAndResearchBestPractices = ScrapingAndResearchBestPractices;
+//# sourceMappingURL=scraping-and-research.js.map

package/dist/tools/best-practices/scraping-and-research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scraping-and-research.js","sourceRoot":"","sources":["../../../src/tools/best-practices/scraping-and-research.ts"],"names":[],"mappings":";;;AACA,2DAA2D;AAE3D,MAAa,gCAAgC;IACnC,SAAS,GAAG,kCAAiB,CAAC,qBAAqB,CAAC;IACpD,OAAO,GAAG,OAAO,CAAC;IAEV,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqIjC,CAAC;IAED,gBAAgB;QACf,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;CACD;AA9ID,4EA8IC"}

package/dist/tools/builder-tools.js

@@ -3,7 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBuilderTools = getBuilderTools;
 exports.getBuilderToolsForDisplay = getBuilderToolsForDisplay;
 const add_node_tool_1 = require("./add-node.tool");
+const categorize_prompt_tool_1 = require("./categorize-prompt.tool");
 const connect_nodes_tool_1 = require("./connect-nodes.tool");
+const get_best_practices_tool_1 = require("./get-best-practices.tool");
 const get_node_parameter_tool_1 = require("./get-node-parameter.tool");
 const node_details_tool_1 = require("./node-details.tool");
 const node_search_tool_1 = require("./node-search.tool");
@@ -13,6 +15,8 @@ const update_node_parameters_tool_1 = require("./update-node-parameters.tool");
 const validate_workflow_tool_1 = require("./validate-workflow.tool");
 function getBuilderTools({ parsedNodeTypes, logger, llmComplexTask, instanceUrl, }) {
     return [
+        (0, categorize_prompt_tool_1.createCategorizePromptTool)(llmComplexTask, logger),
+        (0, get_best_practices_tool_1.createGetBestPracticesTool)(),
         (0, node_search_tool_1.createNodeSearchTool)(parsedNodeTypes),
         (0, node_details_tool_1.createNodeDetailsTool)(parsedNodeTypes),
         (0, add_node_tool_1.createAddNodeTool)(parsedNodeTypes),
@@ -26,6 +30,8 @@ function getBuilderTools({ parsedNodeTypes, logger, llmComplexTask, instanceUrl,
 }
 function getBuilderToolsForDisplay({ nodeTypes, }) {
     return [
+        categorize_prompt_tool_1.CATEGORIZE_PROMPT_TOOL,
+        get_best_practices_tool_1.GET_BEST_PRACTICES_TOOL,
         node_search_tool_1.NODE_SEARCH_TOOL,
         node_details_tool_1.NODE_DETAILS_TOOL,
         (0, add_node_tool_1.getAddNodeToolBase)(nodeTypes),

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

@@ -1 +1 @@
-{"version":3,"file":"builder-tools.js","sourceRoot":"","sources":["../../src/tools/builder-tools.ts"],"names":[],"mappings":";;AAmBA,0CAsBC;AAOD,8DAcC;AAxDD,mDAAwE;AACxE,6DAAkF;AAClF,uEAAgG;AAChG,2DAA+E;AAC/E,yDAA4E;AAC5E,qEAA8F;AAC9F,yDAA4E;AAC5E,+EAGuC;AACvC,qEAA8F;AAE9F,SAAgB,eAAe,CAAC,EAC/B,eAAe,EACf,MAAM,EACN,cAAc,EACd,WAAW,GAMX;IACA,OAAO;QACN,IAAA,uCAAoB,EAAC,eAAe,CAAC;QACrC,IAAA,yCAAqB,EAAC,eAAe,CAAC;QACtC,IAAA,iCAAiB,EAAC,eAAe,CAAC;QAClC,IAAA,2CAAsB,EAAC,eAAe,EAAE,MAAM,CAAC;QAC/C,IAAA,mDAA0B,EAAC,MAAM,CAAC;QAClC,IAAA,uCAAoB,EAAC,MAAM,CAAC;QAC5B,IAAA,4DAA8B,EAAC,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC;QACpF,IAAA,oDAA0B,GAAE;QAC5B,IAAA,mDAA0B,EAAC,eAAe,EAAE,MAAM,CAAC;KACnD,CAAC;AACH,CAAC;AAOD,SAAgB,yBAAyB,CAAC,EACzC,SAAS,GAC8B;IACvC,OAAO;QACN,mCAAgB;QAChB,qCAAiB;QACjB,IAAA,kCAAkB,EAAC,SAAS,CAAC;QAC7B,uCAAkB;QAClB,+CAAsB;QACtB,mCAAgB;QAChB,0DAA4B;QAC5B,iDAAuB;QACvB,+CAAsB;KACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"builder-tools.js","sourceRoot":"","sources":["../../src/tools/builder-tools.ts"],"names":[],"mappings":";;AAqBA,0CAwBC;AAOD,8DAgBC;AA9DD,mDAAwE;AACxE,qEAA8F;AAC9F,6DAAkF;AAClF,uEAAgG;AAChG,uEAAgG;AAChG,2DAA+E;AAC/E,yDAA4E;AAC5E,qEAA8F;AAC9F,yDAA4E;AAC5E,+EAGuC;AACvC,qEAA8F;AAE9F,SAAgB,eAAe,CAAC,EAC/B,eAAe,EACf,MAAM,EACN,cAAc,EACd,WAAW,GAMX;IACA,OAAO;QACN,IAAA,mDAA0B,EAAC,cAAc,EAAE,MAAM,CAAC;QAClD,IAAA,oDAA0B,GAAE;QAC5B,IAAA,uCAAoB,EAAC,eAAe,CAAC;QACrC,IAAA,yCAAqB,EAAC,eAAe,CAAC;QACtC,IAAA,iCAAiB,EAAC,eAAe,CAAC;QAClC,IAAA,2CAAsB,EAAC,eAAe,EAAE,MAAM,CAAC;QAC/C,IAAA,mDAA0B,EAAC,MAAM,CAAC;QAClC,IAAA,uCAAoB,EAAC,MAAM,CAAC;QAC5B,IAAA,4DAA8B,EAAC,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC;QACpF,IAAA,oDAA0B,GAAE;QAC5B,IAAA,mDAA0B,EAAC,eAAe,EAAE,MAAM,CAAC;KACnD,CAAC;AACH,CAAC;AAOD,SAAgB,yBAAyB,CAAC,EACzC,SAAS,GAC8B;IACvC,OAAO;QACN,+CAAsB;QACtB,iDAAuB;QACvB,mCAAgB;QAChB,qCAAiB;QACjB,IAAA,kCAAkB,EAAC,SAAS,CAAC;QAC7B,uCAAkB;QAClB,+CAAsB;QACtB,mCAAgB;QAChB,0DAA4B;QAC5B,iDAAuB;QACvB,+CAAsB;KACtB,CAAC;AACH,CAAC"}

package/dist/tools/categorize-prompt.tool.d.ts

@@ -0,0 +1,5 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { Logger } from '@n8n/backend-common';
+import type { BuilderTool, BuilderToolBase } from '../utils/stream-processor';
+export declare const CATEGORIZE_PROMPT_TOOL: BuilderToolBase;
+export declare function createCategorizePromptTool(llm: BaseChatModel, logger?: Logger): BuilderTool;

package/dist/tools/categorize-prompt.tool.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CATEGORIZE_PROMPT_TOOL = void 0;
+exports.createCategorizePromptTool = createCategorizePromptTool;
+const tools_1 = require("@langchain/core/tools");
+const zod_1 = require("zod");
+const prompt_categorization_1 = require("../chains/prompt-categorization");
+const errors_1 = require("../errors");
+const progress_1 = require("../tools/helpers/progress");
+const response_1 = require("../tools/helpers/response");
+const categorizePromptSchema = zod_1.z.object({
+    prompt: zod_1.z.string().min(1).describe('The user prompt to categorize'),
+});
+function buildCategorizationMessage(categorization) {
+    const parts = [];
+    parts.push('Prompt categorized');
+    if (categorization.techniques.length > 0) {
+        parts.push(`- Techniques: ${categorization.techniques.join(', ')}`);
+    }
+    if (categorization.confidence !== undefined) {
+        parts.push(`- Confidence: ${(categorization.confidence * 100).toFixed(0)}%`);
+    }
+    return parts.join('\n');
+}
+exports.CATEGORIZE_PROMPT_TOOL = {
+    toolName: 'categorize_prompt',
+    displayTitle: 'Categorizing prompt',
+};
+function createCategorizePromptTool(llm, logger) {
+    const dynamicTool = (0, tools_1.tool)(async (input, config) => {
+        const reporter = (0, progress_1.createProgressReporter)(config, exports.CATEGORIZE_PROMPT_TOOL.toolName, exports.CATEGORIZE_PROMPT_TOOL.displayTitle);
+        try {
+            const validatedInput = categorizePromptSchema.parse(input);
+            const { prompt } = validatedInput;
+            reporter.start(validatedInput);
+            logger?.debug('Categorizing user prompt using LLM...');
+            reporter.progress('Analyzing prompt to identify use case and techniques...');
+            const categorization = await (0, prompt_categorization_1.promptCategorizationChain)(llm, prompt);
+            logger?.debug('Prompt categorized', {
+                techniques: categorization.techniques,
+                confidence: categorization.confidence,
+            });
+            const output = {
+                categorization,
+            };
+            reporter.complete(output);
+            return (0, response_1.createSuccessResponse)(config, buildCategorizationMessage(categorization), {
+                categorization,
+            });
+        }
+        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.CATEGORIZE_PROMPT_TOOL.toolName,
+                cause: error instanceof Error ? error : undefined,
+            });
+            reporter.error(toolError);
+            return (0, response_1.createErrorResponse)(config, toolError);
+        }
+    }, {
+        name: exports.CATEGORIZE_PROMPT_TOOL.toolName,
+        description: `Categorize a user's workflow request to identify the use case and required techniques.
+
+This helps understand what type of workflow the user wants to build and which automation patterns will be needed.
+
+Use this tool when you receive an initial workflow request to:
+- Detect required techniques (e.g., scraping, data transformation, notifications)
+- Better understand the user's needs and context
+
+The categorization allows retrieving relevant best practice documentation to improve workflow structure and node selection.`,
+        schema: categorizePromptSchema,
+    });
+    return {
+        tool: dynamicTool,
+        ...exports.CATEGORIZE_PROMPT_TOOL,
+    };
+}
+//# sourceMappingURL=categorize-prompt.tool.js.map

package/dist/tools/categorize-prompt.tool.js.map

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

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":";;;AACA,+CAAmD;AAOtC,QAAA,aAAa,GAAG;IAC5B,aAAa,EAAE,EAAE;IACjB,qBAAqB,EAAE,CAAC;IACxB,oBAAoB,EAAE,CAAC;IACvB,cAAc,EAAE,CAAC;IACjB,UAAU,EAAE,EAAE;IACd,kBAAkB,EAAE,EAAE;IACtB,gBAAgB,EAAE,GAAG;IACrB,wBAAwB,EAAE,EAAE;CACnB,CAAC;AAMX,MAAa,gBAAgB;IACC;IAA7B,YAA6B,SAAiC;QAAjC,cAAS,GAAT,SAAS,CAAwB;IAAG,CAAC;IAQlE,YAAY,CAAC,KAAa,EAAE,QAAgB,EAAE;QAC7C,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAuB,EAAE,CAAC;QAEvC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;gBACjE,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;gBACxD,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;YAEjB,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IASD,sBAAsB,CACrB,cAAkC,EAClC,QAAgB,EAAE,EAClB,UAAmB;QAEnB,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,MAAM,gBAAgB,GAAG,UAAU,EAAE,WAAW,EAAE,CAAC;QAEnD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC;gBACJ,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;gBAC1E,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;oBAEzB,MAAM,SAAS,GAAG,gBAAgB;wBACjC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,CAAC;wBACrD,CAAC,CAAC,CAAC,CAAC;oBAEL,IAAI,CAAC,gBAAgB,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;wBACxC,MAAM,UAAU,GAAG,eAAe,GAAG,SAAS,CAAC;wBAC/C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;oBAC7D,CAAC;gBACF,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;YAEjB,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAOD,YAAY,CAAC,MAAwB;QACpC,OAAO;;gBAEO,MAAM,CAAC,IAAI;uBACJ,MAAM,CAAC,WAAW;kBACvB,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM;mBAChF,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO;UAC7F,CAAC;IACV,CAAC;IAQO,kBAAkB,CAAC,QAA8B,EAAE,eAAuB;QACjF,IAAI,KAAK,GAAG,CAAC,CAAC;QAGd,IAAI,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC3D,KAAK,IAAI,qBAAa,CAAC,aAAa,CAAC;QACtC,CAAC;QAGD,IAAI,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAClE,KAAK,IAAI,qBAAa,CAAC,qBAAqB,CAAC;QAC9C,CAAC;QAGD,IAAI,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACnE,KAAK,IAAI,qBAAa,CAAC,oBAAoB,CAAC;QAC7C,CAAC;QAGD,IAAI,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;YAC3F,KAAK,IAAI,qBAAa,CAAC,cAAc,CAAC;QACvC,CAAC;QAGD,IAAI,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,eAAe,EAAE,CAAC;YACrD,KAAK,IAAI,qBAAa,CAAC,UAAU,CAAC;QACnC,CAAC;QACD,IAAI,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,eAAe,EAAE,CAAC;YAC5D,KAAK,IAAI,qBAAa,CAAC,kBAAkB,CAAC;QAC3C,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;IAQO,kBAAkB,CACzB,QAA8B,EAC9B,cAAkC;QAElC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAE5B,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACtC,OAAO,qBAAa,CAAC,gBAAgB,CAAC;YACvC,CAAC;QACF,CAAC;aAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAExC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACtC,OAAO,qBAAa,CAAC,wBAAwB,CAAC;YAC/C,CAAC;QACF,CAAC;QAED,OAAO,CAAC,CAAC;IACV,CAAC;IAQO,kBAAkB,CAAC,QAA8B,EAAE,KAAa;QACvE,OAAO;YACN,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,0BAA0B;YAC/D,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,KAAK;SACL,CAAC;IACH,CAAC;IAQO,YAAY,CAAC,OAA2B,EAAE,KAAa;QAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAOD,MAAM,CAAC,kBAAkB,CAAC,cAAsB;QAC/C,OAAO,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAMD,MAAM,CAAC,oBAAoB;QAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,kCAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACzD,gBAAgB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CACjB,CAAC;IAC3B,CAAC;CACD;AA/LD,4CA+LC"}
+{"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>>;
+};