@n8n/ai-workflow-builder 0.27.1 → 0.29.0

package/dist/chains/prompt-categorization.d.ts

@@ -0,0 +1,3 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import { type PromptCategorization } from '../types/categorization';
+export declare function promptCategorizationChain(llm: BaseChatModel, userPrompt: string): Promise<PromptCategorization>;

package/dist/chains/prompt-categorization.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptCategorizationChain = promptCategorizationChain;
+const prompts_1 = require("@langchain/core/prompts");
+const zod_1 = require("zod");
+const categorization_1 = require("../types/categorization");
+const examplePrompts = [
+    {
+        prompt: 'Monitor social channels for product mentions and auto-respond with campaign messages',
+        techniques: [
+            categorization_1.WorkflowTechnique.MONITORING,
+            categorization_1.WorkflowTechnique.CHATBOT,
+            categorization_1.WorkflowTechnique.CONTENT_GENERATION,
+        ],
+    },
+    {
+        prompt: 'Collect partner referral submissions and verify client instances via BigQuery',
+        techniques: [
+            categorization_1.WorkflowTechnique.FORM_INPUT,
+            categorization_1.WorkflowTechnique.HUMAN_IN_THE_LOOP,
+            categorization_1.WorkflowTechnique.NOTIFICATION,
+        ],
+    },
+    {
+        prompt: 'Scrape competitor pricing pages weekly and generate a summary report of changes',
+        techniques: [
+            categorization_1.WorkflowTechnique.SCHEDULING,
+            categorization_1.WorkflowTechnique.SCRAPING_AND_RESEARCH,
+            categorization_1.WorkflowTechnique.DATA_EXTRACTION,
+            categorization_1.WorkflowTechnique.DATA_ANALYSIS,
+        ],
+    },
+    {
+        prompt: 'Process uploaded PDF contracts to extract client details and update CRM records',
+        techniques: [
+            categorization_1.WorkflowTechnique.DOCUMENT_PROCESSING,
+            categorization_1.WorkflowTechnique.DATA_EXTRACTION,
+            categorization_1.WorkflowTechnique.DATA_TRANSFORMATION,
+            categorization_1.WorkflowTechnique.ENRICHMENT,
+        ],
+    },
+    {
+        prompt: 'Build a searchable internal knowledge base from past support tickets',
+        techniques: [
+            categorization_1.WorkflowTechnique.DATA_TRANSFORMATION,
+            categorization_1.WorkflowTechnique.DATA_ANALYSIS,
+            categorization_1.WorkflowTechnique.KNOWLEDGE_BASE,
+        ],
+    },
+];
+function formatExamplePrompts() {
+    return examplePrompts
+        .map((example) => `- ${example.prompt} → ${example.techniques.join(',')}`)
+        .join('\n');
+}
+const promptCategorizationTemplate = prompts_1.PromptTemplate.fromTemplate(`Analyze the following user prompt and identify the workflow techniques required to fulfill the request.
+Be specific and identify all relevant techniques.
+
+<user_prompt>
+{userPrompt}
+</user_prompt>
+
+<workflow_techniques>
+{techniques}
+</workflow_techniques>
+
+The following prompt categorization examples show a prompt → techniques involved to provide a sense
+of how the categorization should be carried out.
+<example_categorization>
+${formatExamplePrompts()}
+</example_categorization>
+
+Select a maximum of 5 techniques that you believe are applicable, but only select them if you are
+confident that they are applicable. If the prompt is ambigious or does not provide an obvious workflow
+do not provide any techniques - if confidence is low avoid providing techniques.
+
+Select ALL techniques that apply to this workflow. Most workflows use multiple techniques.
+Rate your confidence in this categorization from 0.0 to 1.0.
+`);
+function formatTechniqueList() {
+    return Object.entries(categorization_1.TechniqueDescription)
+        .map(([key, description]) => `- **${key}**: ${description}`)
+        .join('\n');
+}
+async function promptCategorizationChain(llm, userPrompt) {
+    const categorizationSchema = zod_1.z.object({
+        techniques: zod_1.z
+            .array(zod_1.z.nativeEnum(categorization_1.WorkflowTechnique))
+            .min(0)
+            .max(5)
+            .describe('Zero to five workflow techniques identified in the prompt (maximum of 5)'),
+        confidence: zod_1.z
+            .number()
+            .min(0)
+            .max(1)
+            .describe('Confidence level in this categorization from 0.0 to 1.0'),
+    });
+    const modelWithStructure = llm.withStructuredOutput(categorizationSchema);
+    const prompt = await promptCategorizationTemplate.invoke({
+        userPrompt,
+        techniques: formatTechniqueList(),
+    });
+    const structuredOutput = await modelWithStructure.invoke(prompt);
+    return {
+        techniques: structuredOutput.techniques,
+        confidence: structuredOutput.confidence,
+    };
+}
+//# sourceMappingURL=prompt-categorization.js.map

package/dist/chains/prompt-categorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-categorization.js","sourceRoot":"","sources":["../../src/chains/prompt-categorization.ts"],"names":[],"mappings":";;AA8FA,8DA8BC;AA3HD,qDAAyD;AACzD,6BAAwB;AAExB,2DAIgC;AAEhC,MAAM,cAAc,GAAG;IACtB;QACC,MAAM,EAAE,sFAAsF;QAC9F,UAAU,EAAE;YACX,kCAAiB,CAAC,UAAU;YAC5B,kCAAiB,CAAC,OAAO;YACzB,kCAAiB,CAAC,kBAAkB;SACpC;KACD;IACD;QACC,MAAM,EAAE,+EAA+E;QACvF,UAAU,EAAE;YACX,kCAAiB,CAAC,UAAU;YAC5B,kCAAiB,CAAC,iBAAiB;YACnC,kCAAiB,CAAC,YAAY;SAC9B;KACD;IACD;QACC,MAAM,EAAE,iFAAiF;QACzF,UAAU,EAAE;YACX,kCAAiB,CAAC,UAAU;YAC5B,kCAAiB,CAAC,qBAAqB;YACvC,kCAAiB,CAAC,eAAe;YACjC,kCAAiB,CAAC,aAAa;SAC/B;KACD;IACD;QACC,MAAM,EAAE,iFAAiF;QACzF,UAAU,EAAE;YACX,kCAAiB,CAAC,mBAAmB;YACrC,kCAAiB,CAAC,eAAe;YACjC,kCAAiB,CAAC,mBAAmB;YACrC,kCAAiB,CAAC,UAAU;SAC5B;KACD;IACD;QACC,MAAM,EAAE,sEAAsE;QAC9E,UAAU,EAAE;YACX,kCAAiB,CAAC,mBAAmB;YACrC,kCAAiB,CAAC,aAAa;YAC/B,kCAAiB,CAAC,cAAc;SAChC;KACD;CACD,CAAC;AAEF,SAAS,oBAAoB;IAC5B,OAAO,cAAc;SACnB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;SACzE,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,MAAM,4BAA4B,GAAG,wBAAc,CAAC,YAAY,CAC/D;;;;;;;;;;;;;;EAcC,oBAAoB,EAAE;;;;;;;;;CASvB,CACA,CAAC;AAEF,SAAS,mBAAmB;IAC3B,OAAO,MAAM,CAAC,OAAO,CAAC,qCAAoB,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,OAAO,GAAG,OAAO,WAAW,EAAE,CAAC;SAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,yBAAyB,CAC9C,GAAkB,EAClB,UAAkB;IAElB,MAAM,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;QACrC,UAAU,EAAE,OAAC;aACX,KAAK,CAAC,OAAC,CAAC,UAAU,CAAC,kCAAiB,CAAC,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,0EAA0E,CAAC;QACtF,UAAU,EAAE,OAAC;aACX,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,yDAAyD,CAAC;KACrE,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,GAAG,CAAC,oBAAoB,CAAuB,oBAAoB,CAAC,CAAC;IAEhG,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAAC,MAAM,CAAC;QACxD,UAAU;QACV,UAAU,EAAE,mBAAmB,EAAE;KACjC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEjE,OAAO;QACN,UAAU,EAAE,gBAAgB,CAAC,UAAU;QACvC,UAAU,EAAE,gBAAgB,CAAC,UAAU;KACvC,CAAC;AACH,CAAC"}

package/dist/chains/prompts/parameter-types/system-message.d.ts

@@ -0,0 +1 @@
+export declare const SYSTEM_MESSAGE_GUIDE = "\n## CRITICAL: System Message vs User Prompt Separation\n\nAI nodes (AI Agent, LLM Chain, Anthropic, OpenAI, etc.) have TWO distinct prompt fields that MUST be used correctly:\n\n### Field Separation\n1. **System Message** - Model's persistent identity, role, and instructions\n2. **User Message/Text** - Dynamic user context and data references per execution\n\n**Node-specific field names:**\n- AI Agent: `options.systemMessage` and `text`\n- LLM Chain: `messages.messageValues[]` with system role and `text`\n- Anthropic: `options.system` and `messages.values[]`\n- OpenAI: `messages.values[]` with role \"system\" vs \"user\"\n\n### System Message\nUse for STATIC, ROLE-DEFINING content:\n- Agent identity: \"You are a [role] agent...\"\n- Task description: \"Your task is to...\"\n- Step-by-step instructions: \"1. Do X, 2. Do Y, 3. Do Z\"\n- Behavioral guidelines: \"Always...\", \"Never...\"\n- Tool coordination: \"Call the Research Tool to..., then call...\"\n\n### Text Parameter\nUse for DYNAMIC, EXECUTION-SPECIFIC content:\n- User input: \"={{ $json.chatInput }}\"\n- Workflow context: \"=The research topic is: {{ $json.topic }}\"\n- Data from previous nodes: \"=Process this data: {{ $json.data }}\"\n- Variable context: \"=Analyze for user: {{ $json.userId }}\"\n\n### Common Mistakes to Avoid\n\n\u274C **WRONG - Everything in text field:**\n{\n  \"text\": \"=You are an orchestrator agent that coordinates specialized agents. Your task is to: 1) Call Research Agent Tool, 2) Call Fact-Check Agent Tool, 3) Generate report. Research topic: {{ $json.researchTopic }}\"\n}\n\n\u2705 **CORRECT - Properly separated:**\n{\n  \"text\": \"=The research topic is: {{ $json.researchTopic }}\",\n  \"options\": {\n    \"systemMessage\": \"You are an orchestrator agent that coordinates specialized agents.\\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. Generate a comprehensive report\\n\\nReturn ONLY the final report.\"\n  }\n}\n\n### Update Pattern Examples\n\nExample 1 - AI Agent with orchestration:\nInstructions: [\n  \"Set text to '=Research topic: {{ $json.researchTopic }}'\",\n  \"Set system message to 'You are an orchestrator coordinating research tasks.\\n\\nSteps:\\n1. Call Research Agent Tool\\n2. Call Fact-Check Agent Tool\\n3. Call Report Writer Agent Tool\\n4. Return final HTML report'\"\n]\n\nExample 2 - Chat-based AI node:\nInstructions: [\n  \"Set text to '=User question: {{ $json.chatInput }}'\",\n  \"Set system message to 'You are a helpful customer support assistant. Answer questions clearly and professionally. Escalate to human if needed.'\"\n]\n\nExample 3 - Data processing with AI:\nInstructions: [\n  \"Set text to '=Process this data: {{ $json.inputData }}'\",\n  \"Set system message to 'You are a data analysis assistant.\\n\\nTasks:\\n1. Validate data structure\\n2. Calculate statistics\\n3. Identify anomalies\\n4. Return JSON with findings'\"\n]\n\n### Why This Matters\n- **Consistency**: System message stays the same across executions\n- **Maintainability**: Easy to update AI behavior without touching data flow\n- **Best Practice**: Follows standard AI prompt engineering patterns\n- **Clarity**: Separates \"what the AI model is\" from \"what data to process\"\n";

package/dist/chains/prompts/parameter-types/system-message.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYSTEM_MESSAGE_GUIDE = void 0;
+exports.SYSTEM_MESSAGE_GUIDE = `
+## CRITICAL: System Message vs User Prompt Separation
+
+AI nodes (AI Agent, LLM Chain, Anthropic, OpenAI, etc.) have TWO distinct prompt fields that MUST be used correctly:
+
+### Field Separation
+1. **System Message** - Model's persistent identity, role, and instructions
+2. **User Message/Text** - Dynamic user context and data references per execution
+
+**Node-specific field names:**
+- AI Agent: \`options.systemMessage\` and \`text\`
+- LLM Chain: \`messages.messageValues[]\` with system role and \`text\`
+- Anthropic: \`options.system\` and \`messages.values[]\`
+- OpenAI: \`messages.values[]\` with role "system" vs "user"
+
+### System Message
+Use for STATIC, ROLE-DEFINING content:
+- Agent identity: "You are a [role] agent..."
+- Task description: "Your task is to..."
+- Step-by-step instructions: "1. Do X, 2. Do Y, 3. Do Z"
+- Behavioral guidelines: "Always...", "Never..."
+- Tool coordination: "Call the Research Tool to..., then call..."
+
+### Text Parameter
+Use for DYNAMIC, EXECUTION-SPECIFIC content:
+- User input: "={{ $json.chatInput }}"
+- Workflow context: "=The research topic is: {{ $json.topic }}"
+- Data from previous nodes: "=Process this data: {{ $json.data }}"
+- Variable context: "=Analyze for user: {{ $json.userId }}"
+
+### Common Mistakes to Avoid
+
+❌ **WRONG - Everything in text field:**
+{
+  "text": "=You are an orchestrator agent that coordinates specialized agents. Your task is to: 1) Call Research Agent Tool, 2) Call Fact-Check Agent Tool, 3) Generate report. Research topic: {{ $json.researchTopic }}"
+}
+
+✅ **CORRECT - Properly separated:**
+{
+  "text": "=The research topic is: {{ $json.researchTopic }}",
+  "options": {
+    "systemMessage": "You are an orchestrator agent that coordinates specialized agents.\\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. Generate a comprehensive report\\n\\nReturn ONLY the final report."
+  }
+}
+
+### Update Pattern Examples
+
+Example 1 - AI Agent with orchestration:
+Instructions: [
+  "Set text to '=Research topic: {{ $json.researchTopic }}'",
+  "Set system message to 'You are an orchestrator coordinating research tasks.\\n\\nSteps:\\n1. Call Research Agent Tool\\n2. Call Fact-Check Agent Tool\\n3. Call Report Writer Agent Tool\\n4. Return final HTML report'"
+]
+
+Example 2 - Chat-based AI node:
+Instructions: [
+  "Set text to '=User question: {{ $json.chatInput }}'",
+  "Set system message to 'You are a helpful customer support assistant. Answer questions clearly and professionally. Escalate to human if needed.'"
+]
+
+Example 3 - Data processing with AI:
+Instructions: [
+  "Set text to '=Process this data: {{ $json.inputData }}'",
+  "Set system message to 'You are a data analysis assistant.\\n\\nTasks:\\n1. Validate data structure\\n2. Calculate statistics\\n3. Identify anomalies\\n4. Return JSON with findings'"
+]
+
+### Why This Matters
+- **Consistency**: System message stays the same across executions
+- **Maintainability**: Easy to update AI behavior without touching data flow
+- **Best Practice**: Follows standard AI prompt engineering patterns
+- **Clarity**: Separates "what the AI model is" from "what data to process"
+`;
+//# sourceMappingURL=system-message.js.map

package/dist/chains/prompts/parameter-types/system-message.js.map

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

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

@@ -2,6 +2,7 @@ import type { INodeTypeDescription } from 'n8n-workflow';
 import type { PromptBuilderContext } from '../../types/config';
 export declare class ParameterUpdatePromptBuilder {
     static buildSystemPrompt(context: PromptBuilderContext): string;
+    private static hasSystemMessageParameters;
     private static isSetNode;
     private static isIfNode;
     private static isHttpRequestNode;

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

@@ -15,6 +15,7 @@ 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 system_message_1 = require("./parameter-types/system-message");
 const text_fields_1 = require("./parameter-types/text-fields");
 const prompt_config_1 = require("./prompt-config");
 class ParameterUpdatePromptBuilder {
@@ -23,7 +24,10 @@ class ParameterUpdatePromptBuilder {
         const sections = [];
         sections.push(core_instructions_1.CORE_INSTRUCTIONS);
         sections.push(expression_rules_1.EXPRESSION_RULES);
-        if (this.isSetNode(context.nodeType)) {
+        if (this.hasSystemMessageParameters(context.nodeDefinition)) {
+            sections.push(system_message_1.SYSTEM_MESSAGE_GUIDE);
+        }
+        else if (this.isSetNode(context.nodeType)) {
             sections.push(set_node_1.SET_NODE_GUIDE);
         }
         else if (this.isIfNode(context.nodeType)) {
@@ -53,6 +57,24 @@ class ParameterUpdatePromptBuilder {
         const finalPrompt = sections.join('\n');
         return finalPrompt;
     }
+    static hasSystemMessageParameters(nodeDefinition) {
+        if (!nodeDefinition.properties)
+            return false;
+        const hasSystemMessageParam = nodeDefinition.properties.some((prop) => {
+            if (prop.name === 'options' && prop.type === 'collection') {
+                const collectionProp = prop;
+                if (Array.isArray(collectionProp.options)) {
+                    return collectionProp.options.some((opt) => opt.name === 'systemMessage' || opt.name === 'system');
+                }
+            }
+            if (prop.name === 'messages' &&
+                (prop.type === 'fixedCollection' || prop.type === 'collection')) {
+                return true;
+            }
+            return false;
+        });
+        return hasSystemMessageParam;
+    }
     static isSetNode(nodeType) {
         const category = (0, prompt_config_1.getNodeTypeCategory)(nodeType);
         return category === 'set';

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

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

package/dist/chains/test/integration/test-helpers.d.ts

@@ -0,0 +1,3 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+export declare function setupIntegrationLLM(): Promise<BaseChatModel>;
+export declare function shouldRunIntegrationTests(): boolean;

package/dist/chains/test/integration/test-helpers.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupIntegrationLLM = setupIntegrationLLM;
+exports.shouldRunIntegrationTests = shouldRunIntegrationTests;
+const llm_config_1 = require("../../../llm-config");
+async function setupIntegrationLLM() {
+    const apiKey = process.env.N8N_AI_ANTHROPIC_KEY;
+    if (!apiKey) {
+        throw new Error('N8N_AI_ANTHROPIC_KEY environment variable is required for integration tests');
+    }
+    return await (0, llm_config_1.anthropicClaudeSonnet45)({ apiKey });
+}
+function shouldRunIntegrationTests() {
+    return process.env.ENABLE_INTEGRATION_TESTS === 'true';
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/chains/test/integration/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../../src/chains/test/integration/test-helpers.ts"],"names":[],"mappings":";;AAWA,kDAMC;AAQD,8DAEC;AAzBD,6CAAuD;AAShD,KAAK,UAAU,mBAAmB;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,MAAM,IAAA,oCAAuB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAClD,CAAC;AAQD,SAAgB,yBAAyB;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,KAAK,MAAM,CAAC;AACxD,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './ai-workflow-builder-agent.service';
 export type * from './types';
 export * from './workflow-state';
+export { resolveConnections } from './validation/utils/resolve-connections';

package/dist/index.js

@@ -14,6 +14,9 @@ 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 });
+exports.resolveConnections = void 0;
 __exportStar(require("./ai-workflow-builder-agent.service"), exports);
 __exportStar(require("./workflow-state"), exports);
+var resolve_connections_1 = require("./validation/utils/resolve-connections");
+Object.defineProperty(exports, "resolveConnections", { enumerable: true, get: function () { return resolve_connections_1.resolveConnections; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sEAAoD;AAEpD,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,sEAAoD;AAEpD,mDAAiC;AACjC,8EAA4E;AAAnE,yHAAA,kBAAkB,OAAA"}

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

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

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

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatbotBestPractices = void 0;
+const categorization_1 = require("../../types/categorization");
+class ChatbotBestPractices {
+    technique = categorization_1.WorkflowTechnique.CHATBOT;
+    version = '1.0.0';
+    documentation = `# Best Practices: Chatbot Workflows
+
+## Workflow Design
+
+Break chatbot logic into manageable steps and use error handling nodes (IF, Switch) with fallback mechanisms to manage unexpected inputs.
+
+Most chatbots run through external platforms like Slack, Telegram, or WhatsApp rather than through the n8n chat interface - if the user
+requests a service like this don't use the built in chat interface nodes. If the user mentions chatting but does not mention a service
+then use the built in n8n chat node.
+
+CRITICAL: The user may ask to be able to chat to a workflow as well as trigger it via some other method, for example scheduling information
+gathering but also being able to chat with the agent - in scenarios like this the two separate workflows MUST be connected through shared memory,
+vector stores, data storage, or direct connections.
+
+Example pattern:
+- Schedule Trigger → News Gathering Agent → [memory node via ai_memory]
+- Chat Trigger → Chatbot Agent → [SAME memory node via ai_memory]
+- Result: Both agents share conversation/context history, enabling the chatbot to discuss gathered news
+
+For the chatbot always use the same chat node type as used for response. If Telegram has been requested trigger the chatbot via telegram AND
+respond via telegram - do not mix chatbot interfaces.
+
+## Context & Memory Management
+
+Always utilise memory in chatbot agent nodes - providing context gives you full conversation history and more control over context.
+Memory nodes enable the bot to handle follow-up questions by maintaining short-term conversation history.
+
+Include information with the user prompt such as timestamp, user ID, or session metadata. This enriches context without relying solely on memory and user prompt.
+
+If there are other agents involved in the workflow you should share memory between the chatbot and those other agents where it makes sense.
+Connect the same memory node to multiple agents to enable data sharing and context continuity.
+
+## Context Engineering & AI Agent Output
+
+It can be beneficial to respond to the user as a tool of the chatbot agent rather than using the agent output - this allows the agent to loop/carry out multiple responses if necessary.
+This will require adding a note to the system prompt for the agent to tell it to use the tool to respond to the user.
+
+## Message Attribution
+
+n8n chatbots often attach the attribution "n8n workflow" to messages by default - you must disable this setting which will
+often be called "Append n8n Attribution" for nodes that support it, add this setting and set it to false.
+
+## Recommended Nodes
+
+### Chat Trigger (@n8n/n8n-nodes-langchain.chatTrigger)
+
+Purpose: Entry point for user messages in n8n-hosted chat interfaces
+
+Pitfalls:
+
+- Most production chatbots use external platforms (Slack, Telegram) rather than n8n's chat interface
+
+### AI Agent (@n8n/n8n-nodes-langchain.agent)
+
+Purpose: Orchestrates logic, tool use, and LLM calls for intelligent responses
+
+### Chat Model Nodes
+
+- OpenAI Chat Model (@n8n/n8n-nodes-langchain.lmChatOpenAi)
+- Google Gemini Chat Model (@n8n/n8n-nodes-langchain.lmChatGoogleGemini)
+- xAI Grok Chat Model (@n8n/n8n-nodes-langchain.lmChatXAiGrok)
+- DeepSeek Chat Model (@n8n/n8n-nodes-langchain.lmChatDeepSeek)
+
+Purpose: Connect to LLMs for natural, context-aware responses
+
+### Simple Memory (@n8n/n8n-nodes-langchain.memoryBufferWindow)
+
+Purpose: Maintains short-term conversation history for context continuity
+
+### HTTP Request (n8n-nodes-base.httpRequest)
+
+Purpose: Fetches external data to enrich chatbot responses with real-time or organizational information
+
+### Database Nodes & Google Sheets
+
+- Postgres (n8n-nodes-base.postgres)
+- MySQL (n8n-nodes-base.mySql)
+- MongoDB (n8n-nodes-base.mongoDb)
+- Google Sheets (n8n-nodes-base.googleSheets)
+
+Purpose: Store conversation logs, retrieve structured data, or maintain user preferences
+
+### IF / Switch
+
+- If (n8n-nodes-base.if)
+- Switch (n8n-nodes-base.switch)
+
+Purpose: Conditional logic and error handling for routing messages or managing conversation state
+
+### Integration Nodes
+
+- Slack (n8n-nodes-base.slack)
+- Telegram (n8n-nodes-base.telegram)
+- WhatsApp Business Cloud (n8n-nodes-base.whatsApp)
+- Discord (n8n-nodes-base.discord)
+
+Purpose: Multi-channel support for deploying chatbots on popular messaging platforms
+
+## Common Pitfalls to Avoid
+
+### Leaving Chatbot Disconnected
+
+When a workflow has multiple triggers (e.g., scheduled data collection + chatbot interaction), the chatbot MUST have access to the data
+generated by the workflow. Connect the chatbot through shared memory, vector stores, data storage, or direct data flow connections.
+`;
+    getDocumentation() {
+        return this.documentation;
+    }
+}
+exports.ChatbotBestPractices = ChatbotBestPractices;
+//# sourceMappingURL=chatbot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.js","sourceRoot":"","sources":["../../../src/tools/best-practices/chatbot.ts"],"names":[],"mappings":";;;AACA,2DAA2D;AAE3D,MAAa,oBAAoB;IACvB,SAAS,GAAG,kCAAiB,CAAC,OAAO,CAAC;IACtC,OAAO,GAAG,OAAO,CAAC;IAEV,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGjC,CAAC;IAED,gBAAgB;QACf,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;CACD;AAjHD,oDAiHC"}

package/dist/tools/best-practices/content-generation.d.ts

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

package/dist/tools/best-practices/content-generation.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentGenerationBestPractices = void 0;
+const categorization_1 = require("../../types/categorization");
+class ContentGenerationBestPractices {
+    technique = categorization_1.WorkflowTechnique.CONTENT_GENERATION;
+    version = '1.0.0';
+    documentation = `# Best Practices: Content Generation Workflows
+
+## Workflow Design
+
+Break complex tasks into sequential steps (e.g., generate text, create image, compose video) for modularity and easier troubleshooting.
+
+## Content-Specific Guidance
+
+For text generation, validate and sanitize input/output to avoid malformed data. When generating images, prefer binary data over URLs for uploads to avoid media type errors.
+
+## Recommended Nodes
+
+### OpenAI (@n8n/n8n-nodes-langchain.openAi)
+
+Purpose: GPT-based text generation, DALL-E image generation, text-to-speech (TTS), and audio transcription
+
+### xAI Grok Chat Model (@n8n/n8n-nodes-langchain.lmChatXAiGrok)
+
+Purpose: Conversational AI and text generation
+
+### Google Gemini Chat Model (@n8n/n8n-nodes-langchain.lmChatGoogleGemini)
+
+Purpose: Image analysis and generation, video generation from text prompts, multimodal content creation
+
+### ElevenLabs
+
+Purpose: Natural-sounding AI voice generation
+
+Note: Use HTTP Request node or a community node to integrate with ElevenLabs API
+
+### HTTP Request (n8n-nodes-base.httpRequest)
+
+Purpose: Integrating with other LLM and content generation APIs (e.g., Jasper, Writesonic, Anthropic, HuggingFace)
+
+### Edit Image (n8n-nodes-base.editImage)
+
+Purpose: Manipulating images - resize, crop, rotate, and format conversion
+
+Pitfalls:
+
+- Ensure input is valid binary image data
+- Check output format compatibility with downstream nodes
+
+### Markdown (n8n-nodes-base.markdown)
+
+Purpose: Formatting and converting text to HTML or Markdown reports
+
+### Facebook Graph API (n8n-nodes-base.facebookGraphApi)
+
+Purpose: Uploading videos and images to Instagram and Facebook
+
+Pitfalls:
+
+- Use binary data fields rather than URLs for media uploads to prevent "media type" errors
+- Verify page IDs and access tokens have correct permissions
+
+### Wait (n8n-nodes-base.wait)
+
+Purpose: Handling delays in video processing/uploading and respecting API rate limits
+
+## Common Pitfalls to Avoid
+
+Binary Data Handling: For media uploads, use binary fields rather than URLs to prevent "media type" errors, especially with Facebook and Instagram APIs. Download media to binary data first, then upload from binary rather than passing URLs.
+
+Async Processing: For long-running content generation tasks (especially video), implement proper wait/polling mechanisms. Don't assume instant completion - many AI services process requests asynchronously.
+`;
+    getDocumentation() {
+        return this.documentation;
+    }
+}
+exports.ContentGenerationBestPractices = ContentGenerationBestPractices;
+//# sourceMappingURL=content-generation.js.map

package/dist/tools/best-practices/content-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-generation.js","sourceRoot":"","sources":["../../../src/tools/best-practices/content-generation.ts"],"names":[],"mappings":";;;AACA,2DAA2D;AAE3D,MAAa,8BAA8B;IACjC,SAAS,GAAG,kCAAiB,CAAC,kBAAkB,CAAC;IACjD,OAAO,GAAG,OAAO,CAAC;IAEV,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEjC,CAAC;IAED,gBAAgB;QACf,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;CACD;AA1ED,wEA0EC"}

package/dist/tools/best-practices/data-extraction.d.ts

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