@n8n/ai-workflow-builder 0.32.1 → 0.33.0

package/dist/subgraphs/discovery.subgraph.js

@@ -0,0 +1,415 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscoverySubgraph = exports.DiscoverySubgraphState = void 0;
+const messages_1 = require("@langchain/core/messages");
+const prompts_1 = require("@langchain/core/prompts");
+const tools_1 = require("@langchain/core/tools");
+const langgraph_1 = require("@langchain/langgraph");
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+const categorization_1 = require("../types/categorization");
+const subgraph_interface_1 = require("./subgraph-interface");
+const get_best_practices_tool_1 = require("../tools/get-best-practices.tool");
+const node_details_tool_1 = require("../tools/node-details.tool");
+const node_search_tool_1 = require("../tools/node-search.tool");
+const coordination_1 = require("../types/coordination");
+const cache_control_1 = require("../utils/cache-control");
+const context_builders_1 = require("../utils/context-builders");
+const subgraph_helpers_1 = require("../utils/subgraph-helpers");
+const exampleCategorizations = [
+    {
+        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,
+        ],
+    },
+    {
+        prompt: 'Create an AI agent that writes and sends personalized emails to leads',
+        techniques: [categorization_1.WorkflowTechnique.CONTENT_GENERATION, categorization_1.WorkflowTechnique.NOTIFICATION],
+    },
+    {
+        prompt: 'Fetch trending topics from Google Trends and Reddit, select the best ones, and create social posts',
+        techniques: [
+            categorization_1.WorkflowTechnique.SCRAPING_AND_RESEARCH,
+            categorization_1.WorkflowTechnique.TRIAGE,
+            categorization_1.WorkflowTechnique.CONTENT_GENERATION,
+        ],
+    },
+    {
+        prompt: 'Trigger when a new contact is created in HubSpot and enrich their profile with LinkedIn data',
+        techniques: [categorization_1.WorkflowTechnique.MONITORING, categorization_1.WorkflowTechnique.ENRICHMENT],
+    },
+    {
+        prompt: 'Get stock prices from financial APIs and analyze volatility patterns',
+        techniques: [categorization_1.WorkflowTechnique.SCRAPING_AND_RESEARCH, categorization_1.WorkflowTechnique.DATA_ANALYSIS],
+    },
+    {
+        prompt: 'Generate video reels from templates and auto-post to social media on schedule',
+        techniques: [
+            categorization_1.WorkflowTechnique.SCHEDULING,
+            categorization_1.WorkflowTechnique.DOCUMENT_PROCESSING,
+            categorization_1.WorkflowTechnique.CONTENT_GENERATION,
+        ],
+    },
+    {
+        prompt: 'Receive news from Telegram channels, filter relevant ones, and forward to my channel',
+        techniques: [
+            categorization_1.WorkflowTechnique.MONITORING,
+            categorization_1.WorkflowTechnique.TRIAGE,
+            categorization_1.WorkflowTechnique.NOTIFICATION,
+        ],
+    },
+    {
+        prompt: 'Analyze YouTube video performance data and generate a weekly report',
+        techniques: [
+            categorization_1.WorkflowTechnique.SCRAPING_AND_RESEARCH,
+            categorization_1.WorkflowTechnique.DATA_ANALYSIS,
+            categorization_1.WorkflowTechnique.DATA_TRANSFORMATION,
+        ],
+    },
+    {
+        prompt: 'Create a chatbot that answers questions using data from a Google Sheet as knowledge base',
+        techniques: [categorization_1.WorkflowTechnique.CHATBOT, categorization_1.WorkflowTechnique.KNOWLEDGE_BASE],
+    },
+    {
+        prompt: 'Form submission with file upload triggers document extraction and approval workflow',
+        techniques: [
+            categorization_1.WorkflowTechnique.FORM_INPUT,
+            categorization_1.WorkflowTechnique.DOCUMENT_PROCESSING,
+            categorization_1.WorkflowTechnique.HUMAN_IN_THE_LOOP,
+        ],
+    },
+];
+function formatTechniqueList() {
+    return Object.entries(categorization_1.TechniqueDescription)
+        .map(([key, description]) => `- **${key}**: ${description}`)
+        .join('\n');
+}
+function formatExampleCategorizations() {
+    return exampleCategorizations
+        .map((example) => `- ${example.prompt} → ${example.techniques.join(', ')}`)
+        .join('\n');
+}
+const discoveryOutputSchema = zod_1.z.object({
+    nodesFound: zod_1.z
+        .array(zod_1.z.object({
+        nodeName: zod_1.z.string().describe('The internal name of the node (e.g., n8n-nodes-base.gmail)'),
+        version: zod_1.z
+            .number()
+            .describe('The version number of the node (e.g., 1, 1.1, 2, 3, 3.2, etc.)'),
+        reasoning: zod_1.z.string().describe('Why this node is relevant for the workflow'),
+        connectionChangingParameters: zod_1.z
+            .array(zod_1.z.object({
+            name: zod_1.z
+                .string()
+                .describe('Parameter name (e.g., "mode", "operation", "hasOutputParser")'),
+            possibleValues: zod_1.z
+                .array(zod_1.z.union([zod_1.z.string(), zod_1.z.boolean(), zod_1.z.number()]))
+                .describe('Possible values this parameter can take'),
+        }))
+            .describe('Parameters that affect node connections (inputs/outputs). ONLY include if parameter appears in <input> or <output> expressions'),
+    }))
+        .describe('List of n8n nodes identified as necessary for the workflow'),
+});
+const DISCOVERY_PROMPT = `You are a Discovery Agent for n8n AI Workflow Builder.
+
+YOUR ROLE: Identify relevant n8n nodes and their connection-changing parameters.
+
+AVAILABLE TOOLS:
+- get_best_practices: Retrieve best practices (internal context)
+- search_nodes: Find n8n nodes by keyword
+- get_node_details: Get complete node information including <connections>
+- submit_discovery_results: Submit final results
+
+PROCESS:
+1. **Call get_best_practices** with identified techniques (internal context)
+2. **Identify workflow components** from user request and best practices
+3. **Call search_nodes IN PARALLEL** for all components (e.g., "Gmail", "OpenAI", "Schedule")
+4. **Call get_node_details IN PARALLEL** for ALL promising nodes (batch multiple calls)
+5. **Extract node information** from each node_details response:
+   - Node name from <name> tag
+   - Version number from <version> tag (required - extract the number)
+   - Connection-changing parameters from <connections> section
+6. **Call submit_discovery_results** with complete nodesFound array
+
+TECHNIQUE CATEGORIZATION:
+When calling get_best_practices, select techniques that match the user's workflow intent.
+
+<available_techniques>
+{techniques}
+</available_techniques>
+
+<example_categorizations>
+{exampleCategorizations}
+</example_categorizations>
+
+<technique_clarifications>
+Common distinctions to get right:
+- **NOTIFICATION vs CHATBOT**: Use NOTIFICATION when SENDING emails/messages/alerts (including to Telegram CHANNELS which are broadcast-only). Use CHATBOT only when RECEIVING and REPLYING to direct messages in a conversation.
+- **MONITORING**: Use when workflow TRIGGERS on external events (new record created, status changed, incoming webhook, new message in channel). NOT just scheduled runs.
+- **SCRAPING_AND_RESEARCH vs DATA_EXTRACTION**: Use SCRAPING when fetching from EXTERNAL sources (APIs, websites, social media). Use DATA_EXTRACTION for parsing INTERNAL data you already have.
+- **TRIAGE**: Use when SELECTING, PRIORITIZING, ROUTING, or QUALIFYING items (e.g., "pick the best", "route to correct team", "qualify leads").
+- **DOCUMENT_PROCESSING**: Use for ANY file handling - PDFs, images, videos, Excel, Google Sheets, audio files, file uploads in forms.
+- **HUMAN_IN_THE_LOOP**: Use when workflow PAUSES for human approval, review, signing documents, responding to polls, or any manual input before continuing.
+- **DATA_ANALYSIS**: Use when ANALYZING, CLASSIFYING, IDENTIFYING PATTERNS, or UNDERSTANDING data (e.g., "analyze outcomes", "learn from previous", "classify by type", "identify trends").
+- **KNOWLEDGE_BASE**: Use when storing/retrieving from a DATA SOURCE for Q&A - includes vector DBs, spreadsheets used as databases, document collections.
+- **DATA_TRANSFORMATION**: Use when CONVERTING data format, creating REPORTS/SUMMARIES from analyzed data, or restructuring output.
+</technique_clarifications>
+
+Technique selection rules:
+- Select ALL techniques that apply (most workflows use 2-4)
+- Maximum 5 techniques
+- Only select techniques you're confident apply
+
+CONNECTION-CHANGING PARAMETERS - CRITICAL RULES:
+
+A parameter is connection-changing ONLY IF it appears in <input> or <output> expressions within <node_details>.
+
+**How to identify:**
+1. Look at the <connections> section in node details
+2. Check if <input> or <output> uses expressions like: ={{...parameterName...}}
+3. If a parameter is referenced in these expressions, it IS connection-changing
+4. If a parameter is NOT in <input>/<output> expressions, it is NOT connection-changing
+
+**Example from AI Agent:**
+\`\`\`xml
+<input>={{...hasOutputParser, needsFallback...}}</input>
+\`\`\`
+→ hasOutputParser and needsFallback ARE connection-changing (they control which inputs appear)
+
+**Counter-example:**
+\`\`\`xml
+<properties>
+  <property name="promptType">...</property>  <!-- NOT in <input>/<output> -->
+  <property name="systemMessage">...</property>  <!-- NOT in <input>/<output> -->
+</properties>
+\`\`\`
+→ promptType and systemMessage are NOT connection-changing (they don't affect connections)
+
+**Common connection-changing parameters:**
+- Vector Store: mode (appears in <input>/<output> expressions)
+- AI Agent: hasOutputParser, needsFallback (appears in <input> expression)
+- Merge: numberInputs (appears in <input> expression)
+- Webhook: responseMode (appears in <output> expression)
+
+SUB-NODES SEARCHES:
+When searching for AI nodes, ALSO search for their required sub-nodes:
+- "AI Agent" → also search for "Chat Model", "Memory", "Output Parser"
+- "Basic LLM Chain" → also search for "Chat Model", "Output Parser"
+- "Vector Store" → also search for "Embeddings", "Document Loader"
+- Always use search_nodes to find the exact node names and versions - NEVER guess versions
+
+CRITICAL RULES:
+- NEVER ask clarifying questions
+- ALWAYS call get_best_practices first
+- THEN Call search_nodes to learn about available nodes and their inputs and outputs
+- FINALLY call get_node_details IN PARALLEL for speed to get more details about RELVANT node
+- ALWAYS extract version number from <version> tag in node details
+- NEVER guess node versions - always use search_nodes to find exact versions
+- ONLY flag connectionChangingParameters if they appear in <input> or <output> expressions
+- If no parameters appear in connection expressions, return empty array []
+- Output ONLY: nodesFound with {{ nodeName, version, reasoning, connectionChangingParameters }}
+
+DO NOT:
+- Output text commentary between tool calls
+- Include bestPractices or categorization in submit_discovery_results
+- Flag parameters that don't affect connections
+- Stop without calling submit_discovery_results
+`;
+exports.DiscoverySubgraphState = langgraph_1.Annotation.Root({
+    userRequest: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+        default: () => '',
+    }),
+    messages: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => x.concat(y),
+        default: () => [],
+    }),
+    nodesFound: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+        default: () => [],
+    }),
+    bestPractices: (0, langgraph_1.Annotation)({
+        reducer: (x, y) => y ?? x,
+    }),
+});
+class DiscoverySubgraph extends subgraph_interface_1.BaseSubgraph {
+    name = 'discovery_subgraph';
+    description = 'Discovers nodes and context for the workflow';
+    agent;
+    toolMap;
+    logger;
+    create(config) {
+        this.logger = config.logger;
+        const tools = [
+            (0, get_best_practices_tool_1.createGetBestPracticesTool)(),
+            (0, node_search_tool_1.createNodeSearchTool)(config.parsedNodeTypes),
+            (0, node_details_tool_1.createNodeDetailsTool)(config.parsedNodeTypes),
+        ];
+        this.toolMap = new Map(tools.map((bt) => [bt.tool.name, bt.tool]));
+        const submitTool = (0, tools_1.tool)(() => { }, {
+            name: 'submit_discovery_results',
+            description: 'Submit the final discovery results',
+            schema: discoveryOutputSchema,
+        });
+        const systemPrompt = prompts_1.ChatPromptTemplate.fromMessages([
+            [
+                'system',
+                [
+                    {
+                        type: 'text',
+                        text: DISCOVERY_PROMPT,
+                        cache_control: { type: 'ephemeral' },
+                    },
+                ],
+            ],
+            ['human', '{prompt}'],
+            ['placeholder', '{messages}'],
+        ]);
+        if (typeof config.llm.bindTools !== 'function') {
+            throw new errors_1.LLMServiceError('LLM does not support tools', {
+                llmModel: config.llm._llmType(),
+            });
+        }
+        const allTools = [...tools.map((bt) => bt.tool), submitTool];
+        this.agent = systemPrompt.pipe(config.llm.bindTools(allTools));
+        const subgraph = new langgraph_1.StateGraph(exports.DiscoverySubgraphState)
+            .addNode('agent', this.callAgent.bind(this))
+            .addNode('tools', async (state) => await (0, subgraph_helpers_1.executeSubgraphTools)(state, this.toolMap))
+            .addNode('format_output', this.formatOutput.bind(this))
+            .addEdge('__start__', 'agent')
+            .addConditionalEdges('agent', this.shouldContinue.bind(this), {
+            tools: 'tools',
+            format_output: 'format_output',
+            end: langgraph_1.END,
+        })
+            .addEdge('tools', 'agent')
+            .addEdge('format_output', langgraph_1.END);
+        return subgraph.compile();
+    }
+    async callAgent(state) {
+        if (state.messages.length > 0) {
+            (0, cache_control_1.applySubgraphCacheMarkers)(state.messages);
+        }
+        const response = (await this.agent.invoke({
+            messages: state.messages,
+            prompt: state.userRequest,
+            techniques: formatTechniqueList(),
+            exampleCategorizations: formatExampleCategorizations(),
+        }));
+        return { messages: [response] };
+    }
+    formatOutput(state) {
+        const lastMessage = state.messages.at(-1);
+        let output;
+        if (lastMessage && (0, messages_1.isAIMessage)(lastMessage) && lastMessage.tool_calls) {
+            const submitCall = lastMessage.tool_calls.find((tc) => tc.name === 'submit_discovery_results');
+            if (submitCall) {
+                output = submitCall.args;
+            }
+        }
+        if (!output) {
+            this.logger?.error('[Discovery] No submit tool call found in last message');
+            return {
+                nodesFound: [],
+            };
+        }
+        const bestPracticesTool = state.messages.find((m) => m.getType() === 'tool' && m?.text?.startsWith('<best_practices>'));
+        return {
+            nodesFound: output.nodesFound,
+            bestPractices: bestPracticesTool?.text,
+        };
+    }
+    shouldContinue(state) {
+        const lastMessage = state.messages[state.messages.length - 1];
+        if (lastMessage &&
+            (0, messages_1.isAIMessage)(lastMessage) &&
+            lastMessage.tool_calls &&
+            lastMessage.tool_calls.length > 0) {
+            const submitCall = lastMessage.tool_calls.find((tc) => tc.name === 'submit_discovery_results');
+            if (submitCall) {
+                return 'format_output';
+            }
+            return 'tools';
+        }
+        this.logger?.warn('[Discovery Subgraph] Agent stopped without submitting results');
+        return 'end';
+    }
+    transformInput(parentState) {
+        const userRequest = (0, subgraph_helpers_1.extractUserRequest)(parentState.messages, 'Build a workflow');
+        const contextParts = [];
+        contextParts.push('<user_request>');
+        contextParts.push(userRequest);
+        contextParts.push('</user_request>');
+        if (parentState.workflowJSON.nodes.length > 0) {
+            contextParts.push('<existing_workflow_summary>');
+            contextParts.push((0, context_builders_1.buildWorkflowSummary)(parentState.workflowJSON));
+            contextParts.push('</existing_workflow_summary>');
+        }
+        const contextMessage = (0, context_builders_1.createContextMessage)(contextParts);
+        return {
+            userRequest,
+            messages: [contextMessage],
+        };
+    }
+    transformOutput(subgraphOutput, _parentState) {
+        const nodesFound = subgraphOutput.nodesFound || [];
+        const discoveryContext = {
+            nodesFound,
+            bestPractices: subgraphOutput.bestPractices,
+        };
+        const logEntry = {
+            phase: 'discovery',
+            status: 'completed',
+            timestamp: Date.now(),
+            summary: `Discovered ${nodesFound.length} nodes`,
+            metadata: (0, coordination_1.createDiscoveryMetadata)({
+                nodesFound: nodesFound.length,
+                nodeTypes: nodesFound.map((n) => n.nodeName),
+                hasBestPractices: !!subgraphOutput.bestPractices,
+            }),
+        };
+        return {
+            discoveryContext,
+            coordinationLog: [logEntry],
+        };
+    }
+}
+exports.DiscoverySubgraph = DiscoverySubgraph;
+//# sourceMappingURL=discovery.subgraph.js.map

package/dist/subgraphs/discovery.subgraph.js.map

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

package/dist/subgraphs/subgraph-interface.d.ts

@@ -0,0 +1,23 @@
+type StateRecord = Record<string, unknown>;
+interface InvokeConfig {
+    recursionLimit?: number;
+}
+export interface ISubgraph<TConfig = unknown, TChildState extends StateRecord = StateRecord, TParentState extends StateRecord = StateRecord> {
+    name: string;
+    description: string;
+    create(config: TConfig): {
+        invoke: (input: Partial<TChildState>, config?: InvokeConfig) => Promise<TChildState>;
+    };
+    transformInput: (parentState: TParentState) => Partial<TChildState>;
+    transformOutput: (childOutput: TChildState, parentState: TParentState) => Partial<TParentState>;
+}
+export declare abstract class BaseSubgraph<TConfig = unknown, TChildState extends StateRecord = StateRecord, TParentState extends StateRecord = StateRecord> implements ISubgraph<TConfig, TChildState, TParentState> {
+    abstract name: string;
+    abstract description: string;
+    abstract create(config: TConfig): {
+        invoke: (input: Partial<TChildState>, config?: InvokeConfig) => Promise<TChildState>;
+    };
+    abstract transformInput(parentState: TParentState): Partial<TChildState>;
+    abstract transformOutput(childOutput: TChildState, parentState: TParentState): Partial<TParentState>;
+}
+export {};

package/dist/subgraphs/subgraph-interface.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSubgraph = void 0;
+class BaseSubgraph {
+}
+exports.BaseSubgraph = BaseSubgraph;
+//# sourceMappingURL=subgraph-interface.js.map

package/dist/subgraphs/subgraph-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph-interface.js","sourceRoot":"","sources":["../../src/subgraphs/subgraph-interface.ts"],"names":[],"mappings":";;;AAoBA,MAAsB,YAAY;CA2BjC;AA3BD,oCA2BC"}

package/dist/tools/builder-tools.d.ts

@@ -2,12 +2,15 @@ import type { BaseChatModel } from '@langchain/core/language_models/chat_models'
 import type { Logger } from '@n8n/backend-common';
 import type { INodeTypeDescription } from 'n8n-workflow';
 import type { BuilderTool, BuilderToolBase } from '../utils/stream-processor';
-export declare function getBuilderTools({ parsedNodeTypes, logger, llmComplexTask, instanceUrl, }: {
+import type { BuilderFeatureFlags } from '../workflow-builder-agent';
+export declare function getBuilderTools({ parsedNodeTypes, logger, llmComplexTask, instanceUrl, featureFlags, }: {
     parsedNodeTypes: INodeTypeDescription[];
     llmComplexTask: BaseChatModel;
     logger?: Logger;
     instanceUrl?: string;
+    featureFlags?: BuilderFeatureFlags;
 }): BuilderTool[];
-export declare function getBuilderToolsForDisplay({ nodeTypes, }: {
+export declare function getBuilderToolsForDisplay({ nodeTypes, featureFlags, }: {
     nodeTypes: INodeTypeDescription[];
+    featureFlags?: BuilderFeatureFlags;
 }): BuilderToolBase[];

package/dist/tools/builder-tools.js

@@ -7,40 +7,30 @@ 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 get_workflow_examples_tool_1 = require("./get-workflow-examples.tool");
 const node_details_tool_1 = require("./node-details.tool");
 const node_search_tool_1 = require("./node-search.tool");
 const remove_connection_tool_1 = require("./remove-connection.tool");
 const remove_node_tool_1 = require("./remove-node.tool");
 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 [
+function getBuilderTools({ parsedNodeTypes, logger, llmComplexTask, instanceUrl, featureFlags, }) {
+    const tools = [
         (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),
-        (0, connect_nodes_tool_1.createConnectNodesTool)(parsedNodeTypes, logger),
-        (0, remove_connection_tool_1.createRemoveConnectionTool)(logger),
-        (0, remove_node_tool_1.createRemoveNodeTool)(logger),
-        (0, update_node_parameters_tool_1.createUpdateNodeParametersTool)(parsedNodeTypes, llmComplexTask, logger, instanceUrl),
-        (0, get_node_parameter_tool_1.createGetNodeParameterTool)(),
-        (0, validate_workflow_tool_1.createValidateWorkflowTool)(parsedNodeTypes, logger),
     ];
+    if (featureFlags?.templateExamples === true) {
+        tools.push((0, get_workflow_examples_tool_1.createGetWorkflowExamplesTool)(logger));
+    }
+    tools.push((0, node_search_tool_1.createNodeSearchTool)(parsedNodeTypes), (0, node_details_tool_1.createNodeDetailsTool)(parsedNodeTypes), (0, add_node_tool_1.createAddNodeTool)(parsedNodeTypes), (0, connect_nodes_tool_1.createConnectNodesTool)(parsedNodeTypes, logger), (0, remove_connection_tool_1.createRemoveConnectionTool)(logger), (0, remove_node_tool_1.createRemoveNodeTool)(logger), (0, update_node_parameters_tool_1.createUpdateNodeParametersTool)(parsedNodeTypes, llmComplexTask, logger, instanceUrl), (0, get_node_parameter_tool_1.createGetNodeParameterTool)(), (0, validate_workflow_tool_1.createValidateWorkflowTool)(parsedNodeTypes, logger));
+    return tools;
 }
-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),
-        connect_nodes_tool_1.CONNECT_NODES_TOOL,
-        remove_connection_tool_1.REMOVE_CONNECTION_TOOL,
-        remove_node_tool_1.REMOVE_NODE_TOOL,
-        update_node_parameters_tool_1.UPDATING_NODE_PARAMETER_TOOL,
-        get_node_parameter_tool_1.GET_NODE_PARAMETER_TOOL,
-        validate_workflow_tool_1.VALIDATE_WORKFLOW_TOOL,
-    ];
+function getBuilderToolsForDisplay({ nodeTypes, featureFlags, }) {
+    const tools = [categorize_prompt_tool_1.CATEGORIZE_PROMPT_TOOL, get_best_practices_tool_1.GET_BEST_PRACTICES_TOOL];
+    if (featureFlags?.templateExamples === true) {
+        tools.push(get_workflow_examples_tool_1.GET_WORKFLOW_EXAMPLES_TOOL);
+    }
+    tools.push(node_search_tool_1.NODE_SEARCH_TOOL, node_details_tool_1.NODE_DETAILS_TOOL, (0, add_node_tool_1.getAddNodeToolBase)(nodeTypes), connect_nodes_tool_1.CONNECT_NODES_TOOL, remove_connection_tool_1.REMOVE_CONNECTION_TOOL, remove_node_tool_1.REMOVE_NODE_TOOL, update_node_parameters_tool_1.UPDATING_NODE_PARAMETER_TOOL, get_node_parameter_tool_1.GET_NODE_PARAMETER_TOOL, validate_workflow_tool_1.VALIDATE_WORKFLOW_TOOL);
+    return tools;
 }
 //# sourceMappingURL=builder-tools.js.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"builder-tools.js","sourceRoot":"","sources":["../../src/tools/builder-tools.ts"],"names":[],"mappings":";;AA0BA,0CAsCC;AAOD,8DA6BC;AA7FD,mDAAwE;AACxE,qEAA8F;AAC9F,6DAAkF;AAClF,uEAAgG;AAChG,uEAAgG;AAChG,6EAGsC;AACtC,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,EACX,YAAY,GAOZ;IACA,MAAM,KAAK,GAAkB;QAC5B,IAAA,mDAA0B,EAAC,cAAc,EAAE,MAAM,CAAC;QAClD,IAAA,oDAA0B,GAAE;KAC5B,CAAC;IAIF,IAAI,YAAY,EAAE,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,IAAA,0DAA6B,EAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAGD,KAAK,CAAC,IAAI,CACT,IAAA,uCAAoB,EAAC,eAAe,CAAC,EACrC,IAAA,yCAAqB,EAAC,eAAe,CAAC,EACtC,IAAA,iCAAiB,EAAC,eAAe,CAAC,EAClC,IAAA,2CAAsB,EAAC,eAAe,EAAE,MAAM,CAAC,EAC/C,IAAA,mDAA0B,EAAC,MAAM,CAAC,EAClC,IAAA,uCAAoB,EAAC,MAAM,CAAC,EAC5B,IAAA,4DAA8B,EAAC,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC,EACpF,IAAA,oDAA0B,GAAE,EAC5B,IAAA,mDAA0B,EAAC,eAAe,EAAE,MAAM,CAAC,CACnD,CAAC;IAEF,OAAO,KAAK,CAAC;AACd,CAAC;AAOD,SAAgB,yBAAyB,CAAC,EACzC,SAAS,EACT,YAAY,GAIZ;IACA,MAAM,KAAK,GAAsB,CAAC,+CAAsB,EAAE,iDAAuB,CAAC,CAAC;IAInF,IAAI,YAAY,EAAE,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,uDAA0B,CAAC,CAAC;IACxC,CAAC;IAGD,KAAK,CAAC,IAAI,CACT,mCAAgB,EAChB,qCAAiB,EACjB,IAAA,kCAAkB,EAAC,SAAS,CAAC,EAC7B,uCAAkB,EAClB,+CAAsB,EACtB,mCAAgB,EAChB,0DAA4B,EAC5B,iDAAuB,EACvB,+CAAsB,CACtB,CAAC;IAEF,OAAO,KAAK,CAAC;AACd,CAAC"}

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

@@ -29,5 +29,5 @@ export declare function createGetBestPracticesTool(): {
         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>>;
+    }, import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
 };

package/dist/tools/get-workflow-examples.tool.d.ts

@@ -0,0 +1,34 @@
+import type { Logger } from '@n8n/backend-common';
+import { z } from 'zod';
+import type { BuilderToolBase } from '../utils/stream-processor';
+export declare const GET_WORKFLOW_EXAMPLES_TOOL: BuilderToolBase;
+export declare function createGetWorkflowExamplesTool(logger?: Logger): {
+    toolName: string;
+    displayTitle: string;
+    getCustomDisplayTitle?: (values: Record<string, unknown>) => string;
+    tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        queries: z.ZodArray<z.ZodObject<{
+            search: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            search?: string | undefined;
+        }, {
+            search?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        queries: {
+            search?: string | undefined;
+        }[];
+    }, {
+        queries: {
+            search?: string | undefined;
+        }[];
+    }>, {
+        queries: {
+            search?: string | undefined;
+        }[];
+    }, {
+        queries: {
+            search?: string | undefined;
+        }[];
+    }, import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
+};