@n8n/ai-utilities 0.16.0 → 0.17.0

package/dist/cjs/node-catalog/suggested-nodes-data.js

@@ -0,0 +1,246 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.categoryList = exports.suggestedNodesData = void 0;
+    exports.suggestedNodesData = {
+        chatbot: {
+            description: 'Receiving chat messages and replying (built-in chat, Telegram, Slack, etc.)',
+            patternHint: 'Chat Trigger → AI Agent → Memory → Response',
+            nodes: [
+                {
+                    name: '@n8n/n8n-nodes-langchain.chatTrigger',
+                    note: 'When loadPreviousSession is set to memory, the downstream Agent must also have its own memory subnode to maintain conversation context during processing',
+                },
+                {
+                    name: '@n8n/n8n-nodes-langchain.agent',
+                    note: 'Every agent in a conversational workflow MUST have a memory subnode connected. If multiple agents share the same conversation, they must use the same memory session key',
+                },
+                { name: '@n8n/n8n-nodes-langchain.lmChatOpenAi' },
+                { name: '@n8n/n8n-nodes-langchain.lmChatGoogleGemini' },
+                {
+                    name: '@n8n/n8n-nodes-langchain.memoryBufferWindow',
+                    note: 'Maintains short-term conversation history. Must be connected as a subnode to every Agent that participates in a conversation. When multiple agents share a conversation, use the same session key across all of them',
+                },
+                {
+                    name: '@n8n/n8n-nodes-langchain.retrieverVectorStore',
+                    note: 'Connects any Vector Store (Pinecone, Qdrant, Supabase, In-Memory, etc.) to an AI Agent for RAG. Use this as a subnode between the vector store and the agent to retrieve relevant documents when answering questions',
+                },
+                { name: 'n8n-nodes-base.slack' },
+                { name: 'n8n-nodes-base.telegram' },
+                { name: 'n8n-nodes-base.whatsApp' },
+                { name: 'n8n-nodes-base.discord' },
+            ],
+        },
+        notification: {
+            description: 'Sending alerts or updates via email, chat, SMS when events occur',
+            patternHint: 'Trigger → Condition → Send (Email/Slack/SMS)',
+            nodes: [
+                { name: 'n8n-nodes-base.webhook', note: 'Event-based notifications from external systems' },
+                {
+                    name: 'n8n-nodes-base.scheduleTrigger',
+                    note: 'Periodic monitoring and batch notifications',
+                },
+                {
+                    name: 'n8n-nodes-base.gmail',
+                    note: "Default to this because it's easy for users to setup",
+                },
+                { name: 'n8n-nodes-base.slack' },
+                { name: 'n8n-nodes-base.telegram' },
+                { name: 'n8n-nodes-base.twilio' },
+                {
+                    name: 'n8n-nodes-base.httpRequest',
+                    note: 'For services without dedicated nodes (Teams, Discord)',
+                },
+                { name: 'n8n-nodes-base.if', note: 'Check alert conditions before sending' },
+                {
+                    name: 'n8n-nodes-base.switch',
+                    note: 'If routing by severity/type is needed, use Switch to direct to different channels',
+                },
+            ],
+        },
+        scheduling: {
+            description: 'Running actions at specific times or intervals',
+            patternHint: 'Schedule Trigger → Fetch → Process → Act',
+            nodes: [
+                { name: 'n8n-nodes-base.scheduleTrigger' },
+                { name: 'n8n-nodes-base.httpRequest' },
+                { name: 'n8n-nodes-base.set' },
+                { name: 'n8n-nodes-base.wait', note: 'Respect rate limits between API calls' },
+            ],
+        },
+        data_transformation: {
+            description: 'Cleaning, formatting, or restructuring data',
+            patternHint: 'Input → Filter/Map → Transform → Output',
+            nodes: [
+                { name: 'n8n-nodes-base.set' },
+                { name: 'n8n-nodes-base.if', note: 'Use early to validate inputs' },
+                { name: 'n8n-nodes-base.filter', note: 'Use early to reduce data volume' },
+                { name: 'n8n-nodes-base.summarize', note: 'Pivot table-style aggregations' },
+                { name: 'n8n-nodes-base.aggregate', note: 'Combine multiple items into one' },
+                {
+                    name: 'n8n-nodes-base.splitOut',
+                    note: 'Convert single item with array into multiple items',
+                },
+                { name: 'n8n-nodes-base.sort' },
+                { name: 'n8n-nodes-base.limit' },
+                { name: 'n8n-nodes-base.removeDuplicates' },
+                {
+                    name: 'n8n-nodes-base.splitInBatches',
+                    note: 'For large datasets (100+ items), batch processing prevents timeouts',
+                },
+            ],
+        },
+        data_persistence: {
+            description: 'Storing, updating, or retrieving records from persistent storage',
+            patternHint: 'Trigger → Process → Store (DataTable/Sheets)',
+            nodes: [
+                { name: 'n8n-nodes-base.dataTable', note: 'PREFERRED - no external config needed' },
+                {
+                    name: 'n8n-nodes-base.googleSheets',
+                    note: 'For collaboration needs; if >10k rows expected, consider DataTable instead',
+                },
+                {
+                    name: 'n8n-nodes-base.airtable',
+                    note: 'If relationships between tables are needed',
+                },
+                { name: 'n8n-nodes-base.postgres' },
+                { name: 'n8n-nodes-base.mySql' },
+                { name: 'n8n-nodes-base.mongoDb' },
+            ],
+        },
+        data_extraction: {
+            description: 'Pulling specific information from structured or unstructured inputs',
+            patternHint: 'Source → Extract → Parse → Structure',
+            nodes: [
+                {
+                    name: 'n8n-nodes-base.extractFromFile',
+                    note: 'For multiple file types, route by file type first with IF/Switch',
+                },
+                { name: 'n8n-nodes-base.htmlExtract', note: 'JS-rendered content may be empty' },
+                { name: 'n8n-nodes-base.splitOut', note: 'Use before Loop Over Items for arrays' },
+                {
+                    name: 'n8n-nodes-base.splitInBatches',
+                    note: 'Process 200 rows at a time for memory',
+                },
+                { name: 'n8n-nodes-base.code' },
+                { name: '@n8n/n8n-nodes-langchain.informationExtractor', note: 'For unstructured text' },
+                {
+                    name: '@n8n/n8n-nodes-langchain.chainSummarization',
+                    note: 'Context window limits may truncate',
+                },
+            ],
+        },
+        document_processing: {
+            description: 'Taking action on content within files (PDFs, Word docs, images)',
+            patternHint: 'Trigger → Extract Text → AI Parse → Store',
+            nodes: [
+                {
+                    name: 'n8n-nodes-base.gmailTrigger',
+                },
+                { name: 'n8n-nodes-base.googleDriveTrigger' },
+                {
+                    name: 'n8n-nodes-base.extractFromFile',
+                    note: 'Different file types require different operations - route accordingly',
+                },
+                { name: 'n8n-nodes-base.awsTextract', note: 'For tables and forms in scanned docs' },
+                { name: 'n8n-nodes-base.mindee', note: 'Specialized invoice/receipt parsing' },
+                { name: '@n8n/n8n-nodes-langchain.agent' },
+                {
+                    name: '@n8n/n8n-nodes-langchain.documentDefaultDataLoader',
+                    note: 'Loads binary files (PDF, CSV, JSON, DOCX, EPUB, text) into LangChain Documents. Auto-detects format from MIME type. Requires a preceding node that outputs binary data',
+                },
+                {
+                    name: '@n8n/n8n-nodes-langchain.vectorStoreInMemory',
+                    note: 'No external dependencies needed',
+                },
+                { name: 'n8n-nodes-base.splitInBatches', note: 'Process 5-10 files at a time' },
+            ],
+        },
+        form_input: {
+            description: 'Gathering data from users via forms',
+            patternHint: 'Form Trigger → Validate → Store → Respond',
+            nodes: [
+                { name: 'n8n-nodes-base.formTrigger', note: 'ALWAYS store raw data to persistent storage' },
+                { name: 'n8n-nodes-base.form', note: 'Each node is one page/step' },
+                { name: 'n8n-nodes-base.dataTable', note: 'PREFERRED for form data storage' },
+                { name: 'n8n-nodes-base.googleSheets' },
+                { name: 'n8n-nodes-base.airtable' },
+            ],
+        },
+        content_generation: {
+            description: 'Creating text, images, audio, or video',
+            patternHint: 'Trigger → Generate (Text/Image/Video) → Deliver',
+            nodes: [
+                { name: '@n8n/n8n-nodes-langchain.agent', note: 'For text generation' },
+                {
+                    name: '@n8n/n8n-nodes-langchain.openAi',
+                    note: 'Use for image/video generation. DALL-E, TTS, Sora video generation',
+                },
+                { name: '@n8n/n8n-nodes-langchain.lmChatGoogleGemini', note: 'Imagen, video generation' },
+                { name: 'n8n-nodes-base.httpRequest', note: 'For APIs without dedicated nodes' },
+                { name: 'n8n-nodes-base.editImage', note: 'Resize, crop, format conversion' },
+                { name: 'n8n-nodes-base.markdown', note: 'Convert to HTML' },
+                { name: 'n8n-nodes-base.facebookGraphApi' },
+                {
+                    name: 'n8n-nodes-base.wait',
+                    note: 'Video generation is async, use wait while polling for updated',
+                },
+            ],
+        },
+        triage: {
+            description: 'Classifying data for routing or prioritization',
+            patternHint: 'Trigger → Classify → Route → Act',
+            nodes: [
+                {
+                    name: '@n8n/n8n-nodes-langchain.agent',
+                    note: 'For consistent/deterministic classification, always use structured output parser and set temperature 0-0.2',
+                },
+                {
+                    name: '@n8n/n8n-nodes-langchain.outputParserStructured',
+                    note: 'Critical to ensure agent output is consistent and matching general schema',
+                },
+            ],
+        },
+        scraping_and_research: {
+            description: 'Collecting information from websites or APIs',
+            patternHint: 'Trigger → Fetch → Extract → Store',
+            nodes: [
+                {
+                    name: 'n8n-nodes-base.dataTable',
+                    note: 'Default storage for scraped data when the user does not specify a destination. No external config needed. Always include a storage step in scraping workflows',
+                },
+                {
+                    name: 'n8n-nodes-base.phantombuster',
+                    note: 'Use this for social media requests: LinkedIn, Facebook, Instagram, Twitter, etc.',
+                },
+                {
+                    name: '@n8n/n8n-nodes-langchain.toolSerpApi',
+                    note: 'Give agent web search capability, get up-to-date information from websites.',
+                },
+                { name: 'n8n-nodes-base.perplexity', note: 'Recommended for fetching up-to-date news' },
+                { name: 'n8n-nodes-base.perplexityTool', note: 'Recommended for fetching up-to-date news' },
+                {
+                    name: 'n8n-nodes-base.htmlExtract',
+                    note: 'Use to extract HTML content from http requests. Though, JS-rendered sites may return empty',
+                },
+                {
+                    name: 'n8n-nodes-base.splitInBatches',
+                    note: 'Use to batch the processing of items. General recommendation: 200 rows at a time if processing is fast',
+                },
+                { name: 'n8n-nodes-base.wait', note: 'Use this to avoid rate limits (429 errors)' },
+                { name: 'n8n-nodes-base.httpRequest' },
+                { name: 'n8n-nodes-base.httpRequestTool' },
+            ],
+        },
+    };
+    exports.categoryList = Object.keys(exports.suggestedNodesData);
+});
+//# sourceMappingURL=suggested-nodes-data.js.map

package/dist/cjs/node-catalog/suggested-nodes-data.js.map

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

package/dist/cjs/node-catalog/suggested.d.ts

@@ -0,0 +1,3 @@
+import type { NodeTypeParser } from './node-type-parser';
+export { categoryList } from './suggested-nodes-data';
+export declare function getSuggestedNodes(nodeTypeParser: NodeTypeParser, categories: string[]): string;

package/dist/cjs/node-catalog/suggested.js

@@ -0,0 +1,86 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "./suggested-nodes-data", "./suggested-nodes-data"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.categoryList = void 0;
+    exports.getSuggestedNodes = getSuggestedNodes;
+    const suggested_nodes_data_1 = require("./suggested-nodes-data");
+    var suggested_nodes_data_2 = require("./suggested-nodes-data");
+    Object.defineProperty(exports, "categoryList", { enumerable: true, get: function () { return suggested_nodes_data_2.categoryList; } });
+    function formatCategoryResult(nodeTypeParser, category) {
+        const categoryData = suggested_nodes_data_1.suggestedNodesData[category];
+        if (!categoryData) {
+            return null;
+        }
+        const nodes = categoryData.nodes.map((node) => {
+            const nodeType = nodeTypeParser.getLeanNodeType(node.name);
+            if (nodeType) {
+                return {
+                    name: node.name,
+                    displayName: nodeType.displayName,
+                    description: nodeType.description,
+                    note: node.note,
+                };
+            }
+            return {
+                name: node.name,
+                displayName: '(not found)',
+                description: '(not found)',
+                note: node.note,
+            };
+        });
+        return {
+            category,
+            patternHint: categoryData.patternHint,
+            nodes,
+        };
+    }
+    function formatOutput(results) {
+        const lines = [];
+        for (const result of results) {
+            if (!result) {
+                lines.push('Category not found\n');
+                continue;
+            }
+            lines.push(`## ${result.category}`);
+            lines.push(`patternHint: ${result.patternHint}`);
+            lines.push('');
+            lines.push('Suggested nodes:');
+            for (const node of result.nodes) {
+                lines.push(`- ${node.name}`);
+                lines.push(`  displayName: ${node.displayName}`);
+                lines.push(`  description: ${node.description}`);
+                if (node.note) {
+                    lines.push(`  note: ${node.note}`);
+                }
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    function getSuggestedNodes(nodeTypeParser, categories) {
+        const results = [];
+        for (const category of categories) {
+            const result = formatCategoryResult(nodeTypeParser, category);
+            if (result) {
+                results.push(result);
+            }
+            else {
+                results.push({
+                    category,
+                    patternHint: 'Category not found',
+                    nodes: [],
+                });
+            }
+        }
+        return formatOutput(results);
+    }
+});
+//# sourceMappingURL=suggested.js.map

package/dist/cjs/node-catalog/suggested.js.map

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

package/dist/cjs/node-catalog/types.d.ts

@@ -0,0 +1,17 @@
+import type { IDisplayOptions, INodeTypeDescription } from 'n8n-workflow';
+export interface SubnodeRequirement {
+    connectionType: string;
+    required: boolean;
+    displayOptions?: IDisplayOptions;
+}
+export interface CodeBuilderNodeSearchResult {
+    name: string;
+    displayName: string;
+    description: string;
+    version: number;
+    score: number;
+    inputs: INodeTypeDescription['inputs'];
+    outputs: INodeTypeDescription['outputs'];
+    builderHintMessage?: string;
+    subnodeRequirements?: SubnodeRequirement[];
+}

package/dist/cjs/node-catalog/types.js

@@ -0,0 +1,13 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});
+//# sourceMappingURL=types.js.map

package/dist/cjs/node-catalog/types.js.map

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