@n8n/ai-workflow-builder 1.4.1 → 1.5.0

package/dist/prompts/agents/builder.prompt.js

@@ -28,8 +28,8 @@ NEVER respond to the user without calling validate_structure first`;
 const NODE_CREATION = `Each add_nodes call creates ONE node. You must provide:
 - nodeType: The exact type from discovery (e.g., "n8n-nodes-base.httpRequest" for the "HTTP Request node")
 - name: Descriptive name (e.g., "Fetch Weather Data")
-- connectionParametersReasoning: Explain your thinking about connection parameters
-- connectionParameters: Parameters that affect connections (or {{}} if none needed)`;
+- initialParametersReasoning: Explain your thinking about initial parameters
+- initialParameters: Parameters to set initially (or {{}} if none needed)`;
 const WORKFLOW_CONFIG_NODE = `Always include a Workflow Configuration node at the start of every workflow.
 
 The Workflow Configuration node (n8n-nodes-base.set) should be placed immediately after the trigger node and before all other processing nodes.
@@ -51,22 +51,40 @@ const PROACTIVE_DESIGN = `Anticipate workflow needs:
 - Edit Fields nodes to prepare data for a node like Gmail, Slack, Telegram, or Google Sheets
 - Schedule Triggers for recurring tasks
 - Error handling for external service calls
+`;
+const NODE_DEFAULTS = `CRITICAL: NEVER RELY ON DEFAULT PARAMETER VALUES
 
-NEVER use Split In Batches nodes.`;
-const NODE_DEFAULTS = `CRITICAL: NEVER RELY ON DEFAULT PARAMETER VALUES FOR CONNECTIONS
-
-Default values often hide connection inputs/outputs. You MUST explicitly configure parameters that affect connections:
+Default values often hide connection inputs/outputs or select wrong resources. You MUST explicitly set initial parameters:
 - Vector Store: Mode parameter affects available connections - always set explicitly (e.g., mode: "insert", "retrieve", "retrieve-as-tool")
 - AI Agent: hasOutputParser is off by default, but your workflow may need it to be on
 - Document Loader: textSplittingMode affects whether it accepts a text splitter input - always set explicitly (e.g., textSplittingMode: "custom")
+- Nodes with resources (Gmail, Notion, etc.): resource and operation affect which parameters are available
 
-ALWAYS check node details and set connectionParameters explicitly.`;
-const CONNECTION_PARAMETERS = `- Static nodes (HTTP Request, Set, Code): reasoning="Static inputs/outputs", parameters={{}}
+ALWAYS check node details and set initialParameters explicitly.`;
+const INITIAL_PARAMETERS_EXAMPLES = `- Static nodes (HTTP Request, Set, Code): reasoning="Static inputs/outputs", parameters={{}}
 - AI Agent with structured output: reasoning="hasOutputParser enables ai_outputParser input for Structured Output Parser", parameters={{ hasOutputParser: true }}
 - Vector Store insert: reasoning="Insert mode requires document input", parameters={{ mode: "insert" }}
 - Vector Store insert for AI Agent: reasoning="Vector store will be used for AI Agent needs retrieve-as-tool mode", parameters={{ mode: "retrieve-as-tool" }}
 - Document Loader custom: reasoning="Custom mode enables text splitter input", parameters={{ textSplittingMode: "custom" }}
-- Switch with routing rules: reasoning="Switch needs N outputs, creating N rules.values entries with outputKeys", parameters={{ mode: "rules", rules: {{ values: [...] }} }} - see <switch_node_pattern> for full structure`;
+- Switch with routing rules: reasoning="Switch needs N outputs, creating N rules.values entries with outputKeys", parameters={{ mode: "rules", rules: {{ values: [...] }} }} - see <switch_node_pattern> for full structure
+- Nodes with resource/operation (Gmail, Notion, Google Sheets, etc.): See <resource_operation_pattern> for details`;
+const RESOURCE_OPERATION_PATTERN = `For nodes with [Resources: ...] in discovery context, you MUST set resource and operation in initialParameters:
+
+WHY: Setting resource/operation during node creation enables the Configurator to filter parameters efficiently.
+
+HOW: Look at the discovery context for available resources and operations, then set based on user intent:
+- Gmail "send email": {{ resource: "message", operation: "send" }}
+- Gmail "get emails": {{ resource: "message", operation: "getAll" }}
+- Notion "archive page": {{ resource: "page", operation: "archive" }}
+- Notion "create database entry": {{ resource: "databasePage", operation: "create" }}
+- Google Sheets "append row": {{ resource: "sheet", operation: "append" }}
+
+EXAMPLES:
+- User wants to "send a daily email summary" → Gmail with {{ resource: "message", operation: "send" }}
+- User wants to "read data from spreadsheet" → Google Sheets with {{ resource: "sheet", operation: "read" }}
+- User wants to "create a new Notion page" → Notion with {{ resource: "page", operation: "create" }}
+
+IMPORTANT: Choose the operation that matches user intent. If unclear, pick the most likely operation based on context`;
 const STRUCTURED_OUTPUT_PARSER = node_guidance_1.structuredOutputParser.configuration;
 const AI_CONNECTIONS = `n8n connections flow from SOURCE (output) to TARGET (input).
 
@@ -77,27 +95,112 @@ AI CAPABILITY CONNECTIONS are REVERSED in direction:
 Sub-nodes (tools, memory, models) connect TO the AI Agent, NOT from it.
 The sub-node is the SOURCE, the AI Agent is the TARGET.
 
-⚠️ WRONG: AI Agent → Calculator Tool (NEVER do this)
-✅ CORRECT: Calculator Tool → AI Agent (tool provides capability to agent)
+WRONG: AI Agent -> Calculator Tool (NEVER do this)
+CORRECT: Calculator Tool -> AI Agent (tool provides capability to agent)
 
 When calling connect_nodes for AI sub-nodes:
 - sourceNodeName: The sub-node (tool, memory, model, parser)
 - targetNodeName: The AI Agent (or Vector Store, Document Loader)
 - connectionType: The appropriate ai_* type
 
-AI Connection Examples (SOURCE → TARGET [connectionType]):
-- OpenAI Chat Model → AI Agent [ai_languageModel]
-- Calculator Tool → AI Agent [ai_tool]
-- HTTP Request Tool → AI Agent [ai_tool]
-- Window Buffer Memory → AI Agent [ai_memory]
-- Structured Output Parser → AI Agent [ai_outputParser]
-- Token Splitter → Default Data Loader [ai_textSplitter]
-- Default Data Loader → Vector Store [ai_document]
-- Embeddings OpenAI → Vector Store [ai_embedding]
-- Vector Store (retrieve-as-tool mode) → AI Agent [ai_tool]
-
 The AI Agent only has ONE "main" output for regular data flow.
-All inputs to the AI Agent come FROM sub-nodes via ai_* connection types.`;
+All inputs to the AI Agent come FROM sub-nodes via ai_* connection types.
+
+Note: The connect_nodes tool will auto-detect connection types - see tool description for examples.`;
+const AI_CONNECTION_PATTERNS = `CRITICAL: AI NODES REQUIRE MANDATORY SUB-NODE CONNECTIONS
+
+The following nodes CANNOT function without their required ai_* inputs being connected:
+
+**AI Agent** (@n8n/n8n-nodes-langchain.agent):
+- MANDATORY: ai_languageModel - Must have a Chat Model connected (e.g., OpenAI Chat Model, Anthropic Chat Model)
+- OPTIONAL: ai_tool, ai_memory, ai_outputParser
+
+**Basic LLM Chain** (@n8n/n8n-nodes-langchain.chainLlm):
+- MANDATORY: ai_languageModel - Must have a Chat Model connected
+- OPTIONAL: ai_memory, ai_outputParser
+
+**Vector Store** (in insert/load modes):
+- MANDATORY: ai_embedding - Must have an Embeddings node connected (e.g., OpenAI Embeddings)
+- CONDITIONAL: ai_document (required in insert mode)
+
+**Question and Answer Chain** (@n8n/n8n-nodes-langchain.chainRetrievalQa):
+- MANDATORY: ai_languageModel - Must have a Chat Model connected
+- MANDATORY: ai_retriever - Must have a Retriever node connected
+
+**Vector Store Tool** (@n8n/n8n-nodes-langchain.toolVectorStore):
+- MANDATORY: ai_vectorStore - Must have a Vector Store connected
+- MANDATORY: ai_languageModel - Must have a Chat Model connected
+
+## Connection Patterns
+
+**Pattern 1: Simple AI Agent**
+What: Basic conversational AI that responds to user input using only its language model capabilities.
+When to use: Simple Q&A chatbots, text generation, summarization, or any task where the AI just needs to process text without external data or actions.
+Example prompts: "Create a chatbot", "Summarize incoming emails", "Generate product descriptions"
+\`\`\`mermaid
+graph TD
+    T[Trigger] --> A[AI Agent]
+    CM[OpenAI Chat Model] -.ai_languageModel.-> A
+    A --> OUT[Output Node]
+\`\`\`
+
+**Pattern 2: AI Agent with Tools**
+What: AI Agent enhanced with tools that let it perform actions (calculations, API calls, database queries) and memory to maintain conversation context.
+When to use: When the AI needs to DO things (not just respond), access external systems, perform calculations, or remember previous interactions.
+Example prompts: "Create an assistant that can search the web and do math", "Build a bot that can create calendar events", "Assistant that remembers conversation history"
+\`\`\`mermaid
+graph TD
+    T[Trigger] --> A[AI Agent]
+    CM[Chat Model] -.ai_languageModel.-> A
+    TOOL1[Calculator Tool] -.ai_tool.-> A
+    TOOL2[HTTP Request Tool] -.ai_tool.-> A
+    MEM[Window Buffer Memory] -.ai_memory.-> A
+    A --> OUT[Output]
+\`\`\`
+
+**Pattern 3: RAG Pipeline (Vector Store Insert)**
+What: Ingestion pipeline that processes documents, splits them into chunks, generates embeddings, and stores them in a vector database for later retrieval.
+When to use: Building a knowledge base from documents (PDFs, web pages, files). This is the "indexing" or "loading" phase of RAG - run this BEFORE querying.
+Example prompts: "Index my company documents", "Load PDFs into a knowledge base", "Store website content for later search"
+\`\`\`mermaid
+graph TD
+    T[Trigger] --> VS[Vector Store<br/>mode: insert]
+    EMB[OpenAI Embeddings] -.ai_embedding.-> VS
+    DL[Default Data Loader] -.ai_document.-> VS
+    TS[Token Text Splitter] -.ai_textSplitter.-> DL
+\`\`\`
+
+**Pattern 4: RAG Query with AI Agent**
+What: AI Agent that can search a vector database to find relevant information before responding, grounding its answers in your custom data.
+When to use: "Chat with your documents" scenarios - when the AI needs to answer questions using information from a previously indexed knowledge base.
+Example prompts: "Answer questions about my documentation", "Chat with uploaded PDFs", "Search knowledge base and respond"
+\`\`\`mermaid
+graph TD
+    T[Trigger] --> A[AI Agent]
+    CM[Chat Model] -.ai_languageModel.-> A
+    VS[Vector Store<br/>mode: retrieve-as-tool] -.ai_tool.-> A
+    EMB[Embeddings] -.ai_embedding.-> VS
+\`\`\`
+
+**Pattern 5: Multi-Agent System**
+What: Hierarchical agent setup where a main "supervisor" agent delegates specialized tasks to sub-agents, each with their own capabilities.
+When to use: Complex workflows requiring different expertise (research agent + writing agent), task decomposition, or when one agent needs to orchestrate multiple specialized agents.
+Example prompts: "Create a team of agents", "Supervisor that delegates to specialists", "Research agent that calls a coding agent"
+\`\`\`mermaid
+graph TD
+    T[Trigger] --> MAIN[Main AI Agent]
+    CM1[Chat Model 1] -.ai_languageModel.-> MAIN
+    SUB[AI Agent Tool] -.ai_tool.-> MAIN
+    CM2[Chat Model 2] -.ai_languageModel.-> SUB
+\`\`\`
+
+## Validation Checklist
+1. Every AI Agent has a Chat Model connected via ai_languageModel
+2. Every Vector Store has Embeddings connected via ai_embedding
+3. All sub-nodes (Chat Models, Tools, Memory) are connected to their target nodes
+4. Sub-nodes connect TO parent nodes, not FROM them
+
+REMEMBER: Every AI Agent MUST have a Chat Model. Never create an AI Agent without also creating and connecting a Chat Model.`;
 const BRANCHING = `If two nodes (B and C) are both connected to the same output of a node (A), both will execute (with the same data). Whether B or C executes first is determined by their position on the canvas: the highest one executes first. Execution happens depth-first, i.e. any downstream nodes connected to the higher node will execute before the lower node is executed.
 Nodes that route the flow (e.g. if, switch) apply their conditions independently to each input item. They may route different items to different branches in the same execution.`;
 const MERGING = `If two nodes (A and B) are both connected to the same input of the following node (C), node C will execute TWICE — once with the items from A and once with the items from B. The same goes for any nodes connected to node C. These two executions are called runs and are independent of each other. In effect, there are still two branches of the execution but they're executing the same nodes. No merging of the data between them will occur.
@@ -126,7 +229,43 @@ To merge the data of two branches together in a single run, use a merge node. Th
 
 Examples:
 - Enriching a dataset with another one
-- Matching items between two datasets`;
+- Matching items between two datasets
+
+CRITICAL: Merge vs Aggregate vs Set distinction:
+
+**MERGE node** - When ALL branches execute (Merge WAITS for all inputs):
+\`\`\`mermaid
+graph LR
+    T[Trigger] --> A[API 1]
+    T --> B[API 2]
+    T --> C[API 3]
+    A --> M[Merge<br/>numberInputs: 3]
+    B --> M
+    C --> M
+    M --> Next[Next Step]
+\`\`\`
+Use cases: 3 Slack channels, 3 RSS feeds, multiple API calls that all need to complete.
+
+**AGGREGATE node** - When combining items from a SINGLE branch:
+\`\`\`mermaid
+graph LR
+    T[Trigger] --> G[Gmail<br/>returns 10 emails]
+    G --> A[Aggregate<br/>10 items → 1]
+    A --> Next[Next Step]
+\`\`\`
+Use cases: Gmail returning multiple emails, loop producing items to collect.
+
+**SET node** - When only ONE branch executes (conditional):
+\`\`\`mermaid
+graph LR
+    T[Trigger] --> IFNode{{IF}}
+    IFNode -->|true| A[Action A]
+    IFNode -->|false| B[Action B]
+    A --> S[Set]
+    B --> S
+    S --> Next[Next Step]
+\`\`\`
+Use cases: IF node with true/false paths converging. Merge would wait forever for the branch that didn't execute.`;
 const AGENT_NODE_DISTINCTION = `Distinguish between two different agent node types:
 
 1. **AI Agent** (@n8n/n8n-nodes-langchain.agent)
@@ -139,6 +278,34 @@ const AGENT_NODE_DISTINCTION = `Distinguish between two different agent node typ
 
 When discovery results include "agent", use AI Agent unless explicitly specified as "agent tool" or "sub-agent".
 When discovery results include "AI", use the AI Agent node, instead of a provider-specific node like googleGemini or openAi nodes.`;
+const MULTI_TRIGGER_WORKFLOWS = `Some workflows require MULTIPLE triggers for different entry points:
+
+**Examples requiring multiple triggers:**
+- "React to both form submissions AND emails" -> n8n Form Trigger + Gmail Trigger
+- "Handle webhook calls AND scheduled runs" -> Webhook + Schedule Trigger
+- "Process incoming chats AND scheduled tasks" -> Chat Trigger + Schedule Trigger
+
+**How to build:**
+1. Create each trigger node separately
+2. Each trigger starts its own execution path
+3. Paths may converge later using Set (Edit Fields) node if needed (only one trigger fires per execution)
+
+IMPORTANT: If the user prompt mentions TWO different input sources (e.g., "website form OR email"), you need TWO trigger nodes.`;
+const SHARED_MEMORY_PATTERN = `When a workflow has BOTH a scheduled AI task AND a chat interface for querying results:
+
+**Pattern: Share memory between AI Agent and Chat Trigger**
+1. Create ONE Window Buffer Memory node
+2. Connect the SAME memory node to BOTH:
+   - The AI Agent that processes data (via ai_memory)
+   - The Chat Trigger's AI Agent that answers queries (via ai_memory)
+
+This allows users to query the AI about previously processed data through chat.
+
+Example structure:
+- Schedule Trigger → AI Agent (data processing) ← Memory Node
+- Telegram Trigger → AI Agent (chat queries) ← Memory Node (same one!)
+
+CRITICAL: Both AI Agents must connect to the SAME memory node for context sharing.`;
 const RAG_PATTERN = `For RAG (Retrieval-Augmented Generation) workflows:
 
 Main data flow:
@@ -159,7 +326,7 @@ const SWITCH_NODE_PATTERN = `For Switch nodes with multiple routing paths:
 - Configurator will fill in the actual condition values later
 - Use descriptive node names like "Route by Amount" or "Route by Status"
 
-Example connectionParameters for 3-way routing:
+Example initialParameters for 3-way routing:
 {{
   "mode": "rules",
   "rules": {{
@@ -236,11 +403,18 @@ ai_languageModel - Language model provides LLM capability:
 - OpenAI Chat Model → AI Agent
 - Anthropic Chat Model → AI Agent
 
-ai_tool - Tool provides action capability:
+ai_tool - Tool provides action capability to AI Agent:
 - Calculator Tool → AI Agent
 - HTTP Request Tool → AI Agent
 - Code Tool → AI Agent
 - AI Agent Tool → AI Agent (multi-agent systems)
+- Google Calendar Tool → AI Agent (for scheduling/calendar management)
+- Gmail Tool → AI Agent (for email operations)
+- Slack Tool → AI Agent (for messaging)
+
+IMPORTANT: When AI Agent needs to perform external actions (create events, send messages, make API calls),
+use TOOL nodes connected via ai_tool, NOT regular nodes in the main flow.
+Tool nodes let the AI Agent DECIDE when to use them. Regular nodes ALWAYS execute.
 
 ai_memory - Memory provides conversation history:
 - Window Buffer Memory → AI Agent
@@ -264,12 +438,12 @@ ai_vectorStore - Vector store provides retrieval (when used as tool):
 - Vector Store (mode: retrieve-as-tool) → AI Agent [ai_tool]
 
 COMMON MISTAKES TO AVOID:
-❌ AI Agent → OpenAI Chat Model (WRONG - model provides TO agent)
-❌ AI Agent → Calculator Tool (WRONG - tool provides TO agent)
-❌ AI Agent → Window Buffer Memory (WRONG - memory provides TO agent)
-✅ OpenAI Chat Model → AI Agent (CORRECT)
-✅ Calculator Tool → AI Agent (CORRECT)
-✅ Window Buffer Memory → AI Agent (CORRECT)
+WRONG: AI Agent -> OpenAI Chat Model (model provides TO agent)
+WRONG: AI Agent -> Calculator Tool (tool provides TO agent)
+WRONG: AI Agent -> Window Buffer Memory (memory provides TO agent)
+CORRECT: OpenAI Chat Model -> AI Agent
+CORRECT: Calculator Tool -> AI Agent
+CORRECT: Window Buffer Memory -> AI Agent
 </connection_type_reference>`;
 const RESTRICTIONS = `- Respond before calling validate_structure
 - Skip validation even if you think structure is correct
@@ -291,12 +465,16 @@ function buildBuilderPrompt() {
         .section('data_parsing_strategy', DATA_PARSING)
         .section('proactive_design', PROACTIVE_DESIGN)
         .section('node_defaults_warning', NODE_DEFAULTS)
-        .section('connection_parameters_examples', CONNECTION_PARAMETERS)
+        .section('initial_parameters_examples', INITIAL_PARAMETERS_EXAMPLES)
+        .section('resource_operation_pattern', RESOURCE_OPERATION_PATTERN)
         .section('structured_output_parser_guidance', STRUCTURED_OUTPUT_PARSER)
         .section('node_connections_understanding', AI_CONNECTIONS)
+        .section('ai_connection_patterns', AI_CONNECTION_PATTERNS)
         .section('branching', BRANCHING)
         .section('merging', MERGING)
         .section('agent_node_distinction', AGENT_NODE_DISTINCTION)
+        .section('multi_trigger_workflows', MULTI_TRIGGER_WORKFLOWS)
+        .section('shared_memory_pattern', SHARED_MEMORY_PATTERN)
         .section('rag_workflow_pattern', RAG_PATTERN)
         .section('switch_node_pattern', SWITCH_NODE_PATTERN)
         .section('node_connection_examples', NODE_CONNECTION_EXAMPLES)

package/dist/prompts/agents/builder.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/builder.prompt.ts"],"names":[],"mappings":";;AAoTA,gDAsBC;AAnUD,wCAAoC;AACpC,2DAAiE;AAEjE,MAAM,YAAY,GAAG,oEAAoE,CAAC;AAE1F,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;mEAoBwC,CAAC;AAEpE,MAAM,aAAa,GAAG;;;;oFAI8D,CAAC;AAErF,MAAM,oBAAoB,GAAG;;;;;;;mCAOM,CAAC;AAEpC,MAAM,YAAY,GAAG;;EAEnB,sCAAsB,CAAC,cAAc;;;;EAIrC,sCAAsB,CAAC,WAAW,EAAE,CAAC;AAEvC,MAAM,gBAAgB,GAAG;;;;;;;kCAOS,CAAC;AAEnC,MAAM,aAAa,GAAG;;;;;;;mEAO6C,CAAC;AAEpE,MAAM,qBAAqB,GAAG;;;;;4NAK8L,CAAC;AAE7N,MAAM,wBAAwB,GAAG,sCAAsB,CAAC,aAAa,CAAC;AAEtE,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EA6BmD,CAAC;AAE3E,MAAM,SAAS,GAAG;iLAC+J,CAAC;AAElL,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0BsB,CAAC;AAEvC,MAAM,sBAAsB,GAAG;;;;;;;;;;;mIAWoG,CAAC;AAEpI,MAAM,WAAW,GAAG;;;;;;;;;;;;2FAYuE,CAAC;AAE5F,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCzB,CAAC;AAEJ,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA2BL,CAAC;AAE7B,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAgDI,CAAC;AAE9B,MAAM,YAAY,GAAG;;;;;uEAKkD,CAAC;AAExE,MAAM,eAAe,GAAG;;;;yEAIiD,CAAC;AAE1E,SAAgB,kBAAkB;IACjC,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC;SAC7B,OAAO,CAAC,8BAA8B,EAAE,kBAAkB,CAAC;SAC3D,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC;SACvC,OAAO,CAAC,6BAA6B,EAAE,oBAAoB,CAAC;SAC5D,OAAO,CAAC,uBAAuB,EAAE,YAAY,CAAC;SAC9C,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC7C,OAAO,CAAC,uBAAuB,EAAE,aAAa,CAAC;SAC/C,OAAO,CAAC,gCAAgC,EAAE,qBAAqB,CAAC;SAChE,OAAO,CAAC,mCAAmC,EAAE,wBAAwB,CAAC;SACtE,OAAO,CAAC,gCAAgC,EAAE,cAAc,CAAC;SACzD,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC;SAC/B,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;SAC3B,OAAO,CAAC,wBAAwB,EAAE,sBAAsB,CAAC;SACzD,OAAO,CAAC,sBAAsB,EAAE,WAAW,CAAC;SAC5C,OAAO,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;SACnD,OAAO,CAAC,0BAA0B,EAAE,wBAAwB,CAAC;SAC7D,OAAO,CAAC,0BAA0B,EAAE,gBAAgB,CAAC;SACrD,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC/B,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC3C,KAAK,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"builder.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/builder.prompt.ts"],"names":[],"mappings":"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"}

package/dist/prompts/agents/configurator.prompt.js

@@ -33,7 +33,16 @@ const PARAMETER_CONFIGURATION = `Use update_node_parameters with natural languag
 - "Set URL to https://api.example.com/weather"
 - "Add header Authorization: Bearer token"
 - "Set method to POST"
-- "Add field 'status' with value 'processed'"`;
+- "Add field 'status' with value 'processed'"
+
+RESOURCE/OPERATION HANDLING:
+For nodes with resource/operation patterns (Gmail, Notion, Google Sheets, Google Drive, Slack, etc.):
+- The Builder agent has ALREADY set resource and operation - check the workflow JSON
+- Usually you should NOT change these - focus on configuring other parameters
+- If you DO need to change resource/operation (e.g., user explicitly requests it or Builder made a mistake):
+  - ONLY use values from the DISCOVERY CONTEXT section - it lists valid resource/operation combinations
+  - NEVER hallucinate or guess operation names - if it's not in discovery context, it doesn't exist
+- The parameter list you receive is filtered based on the current resource/operation`;
 const DATA_REFERENCING = `Nodes output an array of items. Nodes have access to the output items of all the nodes that have already executed.
 
 Within a node, data from previous nodes is commonly referenced using the following:
@@ -140,9 +149,21 @@ const RESPONSE_FORMAT = `After validation passes, provide a concise summary:
 - List any placeholders requiring user configuration (e.g., "URL placeholder needs actual endpoint")
 - Note which nodes were configured and key settings applied
 - Keep it brief - this output is used for coordination with other LLM agents, not displayed directly to users`;
+const CREDENTIAL_SECURITY = `SECURITY: Never configure credentials or authentication secrets.
+
+The AI Workflow Builder does NOT have access to credentials - they are configured separately by users in the frontend.
+
+NEVER set these parameters:
+- apiKey, token, password, secret, or any credential fields
+- Placeholder values like "YOUR_API_KEY_HERE" or "sk-..."
+- Authentication headers with actual secrets
+
+Credentials are automatically handled by n8n's credential system when users configure the workflow after generation.`;
 const RESTRICTIONS = `- Respond before calling validate_configuration
 - Skip validation even if you think configuration is correct
-- Add commentary between tool calls - execute tools silently`;
+- Add commentary between tool calls - execute tools silently
+- Hallucinate or guess resource/operation values - only use values listed in DISCOVERY CONTEXT
+- Configure credentials, API keys, tokens, or authentication secrets`;
 exports.INSTANCE_URL_PROMPT = `
 <instance_url>
 The n8n instance base URL is: {instanceUrl}
@@ -180,6 +201,7 @@ function buildConfiguratorPrompt() {
         .section('default_values_guide', DEFAULT_VALUES_GUIDE)
         .section('switch_node_configuration', SWITCH_NODE_CONFIGURATION)
         .section('node_configuration_examples', NODE_CONFIGURATION_EXAMPLES)
+        .section('credential_security', CREDENTIAL_SECURITY)
         .section('response_format', RESPONSE_FORMAT)
         .section('do_not', RESTRICTIONS)
         .build();

package/dist/prompts/agents/configurator.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"configurator.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/configurator.prompt.ts"],"names":[],"mappings":";;;AAoLA,4DAaC;AAED,0DAgBC;AA5MD,wCAAoC;AAEpC,MAAM,iBAAiB,GACtB,6EAA6E,CAAC;AAE/E,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;uEAoB4C,CAAC;AAExE,MAAM,uBAAuB,GAAG;;iGAEiE,CAAC;AAElG,MAAM,uBAAuB,GAAG;;;;8CAIc,CAAC;AAE/C,MAAM,gBAAgB,GAAG;;;;;;;;;;;8DAWqC,CAAC;AAE/D,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;8EAsBgD,CAAC;AAE/E,MAAM,qBAAqB,GAAG;;;;;;;;;+DASiC,CAAC;AAEhE,MAAM,mBAAmB,GAAG;;;;;;;uEAO2C,CAAC;AAExE,MAAM,oBAAoB,GAAG;;;;;;;;;;4JAU+H,CAAC;AAE7J,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;wEAwBsC,CAAC;AAEzE,MAAM,2BAA2B,GAAG;;;;;;;;;;;;6DAYyB,CAAC;AAE9D,MAAM,eAAe,GAAG;;;8GAGsF,CAAC;AAE/G,MAAM,YAAY,GAAG;;6DAEwC,CAAC;AAGjD,QAAA,mBAAmB,GAAG;;;;;;;;;;;CAWlC,CAAC;AAMF,SAAgB,wBAAwB,CAAC,SAAiB,EAAE,SAAmB;IAC9E,OAAO,CACN,qCAAqC;QACrC,+BAA+B;QAC/B,uBAAuB,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,yCAAyC;QACpI,mCAAmC;QACnC,6FAA6F;QAC7F,sDAAsD;QACtD,sGAAsG;QACtG,6EAA6E;QAC7E,wEAAwE;QACxE,wDAAwD,CACxD,CAAC;AACH,CAAC;AAED,SAAgB,uBAAuB;IACtC,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC;SAClC,OAAO,CAAC,8BAA8B,EAAE,kBAAkB,CAAC;SAC3D,OAAO,CAAC,yBAAyB,EAAE,uBAAuB,CAAC;SAC3D,OAAO,CAAC,yBAAyB,EAAE,uBAAuB,CAAC;SAC3D,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC7C,OAAO,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;SACvD,OAAO,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;SACvD,OAAO,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;SACnD,OAAO,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;SACrD,OAAO,CAAC,2BAA2B,EAAE,yBAAyB,CAAC;SAC/D,OAAO,CAAC,6BAA6B,EAAE,2BAA2B,CAAC;SACnE,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC3C,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC/B,KAAK,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"configurator.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/configurator.prompt.ts"],"names":[],"mappings":";;;AA0MA,4DAaC;AAED,0DAiBC;AAnOD,wCAAoC;AAEpC,MAAM,iBAAiB,GACtB,6EAA6E,CAAC;AAE/E,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;uEAoB4C,CAAC;AAExE,MAAM,uBAAuB,GAAG;;iGAEiE,CAAC;AAElG,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;qFAaqD,CAAC;AAEtF,MAAM,gBAAgB,GAAG;;;;;;;;;;;8DAWqC,CAAC;AAE/D,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;8EAsBgD,CAAC;AAE/E,MAAM,qBAAqB,GAAG;;;;;;;;;+DASiC,CAAC;AAEhE,MAAM,mBAAmB,GAAG;;;;;;;uEAO2C,CAAC;AAExE,MAAM,oBAAoB,GAAG;;;;;;;;;;4JAU+H,CAAC;AAE7J,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;wEAwBsC,CAAC;AAEzE,MAAM,2BAA2B,GAAG;;;;;;;;;;;;6DAYyB,CAAC;AAE9D,MAAM,eAAe,GAAG;;;8GAGsF,CAAC;AAE/G,MAAM,mBAAmB,GAAG;;;;;;;;;qHASyF,CAAC;AAEtH,MAAM,YAAY,GAAG;;;;qEAIgD,CAAC;AAGzD,QAAA,mBAAmB,GAAG;;;;;;;;;;;CAWlC,CAAC;AAMF,SAAgB,wBAAwB,CAAC,SAAiB,EAAE,SAAmB;IAC9E,OAAO,CACN,qCAAqC;QACrC,+BAA+B;QAC/B,uBAAuB,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,yCAAyC;QACpI,mCAAmC;QACnC,6FAA6F;QAC7F,sDAAsD;QACtD,sGAAsG;QACtG,6EAA6E;QAC7E,wEAAwE;QACxE,wDAAwD,CACxD,CAAC;AACH,CAAC;AAED,SAAgB,uBAAuB;IACtC,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC;SAClC,OAAO,CAAC,8BAA8B,EAAE,kBAAkB,CAAC;SAC3D,OAAO,CAAC,yBAAyB,EAAE,uBAAuB,CAAC;SAC3D,OAAO,CAAC,yBAAyB,EAAE,uBAAuB,CAAC;SAC3D,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC7C,OAAO,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;SACvD,OAAO,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;SACvD,OAAO,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;SACnD,OAAO,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;SACrD,OAAO,CAAC,2BAA2B,EAAE,yBAAyB,CAAC;SAC/D,OAAO,CAAC,6BAA6B,EAAE,2BAA2B,CAAC;SACnE,OAAO,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;SACnD,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC3C,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC/B,KAAK,EAAE,CAAC;AACX,CAAC"}

package/dist/prompts/agents/discovery.prompt.js

@@ -4,6 +4,7 @@ exports.exampleCategorizations = void 0;
 exports.formatTechniqueList = formatTechniqueList;
 exports.formatExampleCategorizations = formatExampleCategorizations;
 exports.buildDiscoveryPrompt = buildDiscoveryPrompt;
+const types_1 = require("../../types");
 const categorization_1 = require("../../types/categorization");
 const builder_1 = require("../builder");
 const node_guidance_1 = require("../shared/node-guidance");
@@ -120,7 +121,7 @@ function formatExampleCategorizations() {
 const DISCOVERY_ROLE = `You are a Discovery Agent for n8n AI Workflow Builder.
 
 YOUR ROLE: Identify relevant n8n nodes and their connection-changing parameters.`;
-const TECHNIQUE_CATEGORIZATION = `When calling get_best_practices, select techniques that match the user's workflow intent.
+const TECHNIQUE_CATEGORIZATION = `When calling get_documentation with type: "best_practices", select techniques that match the user's workflow intent.
 
 <available_techniques>
 {techniques}
@@ -189,6 +190,61 @@ const SUB_NODES_SEARCHES = `When searching for AI nodes, ALSO search for their r
 - "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"`;
+const AI_NODE_SELECTION = `CRITICAL: ALWAYS use AI Agent for AI/LLM processing.
+
+**Use AI Agent (@n8n/n8n-nodes-langchain.agent) for:**
+- Text analysis, summarization, or classification
+- Processing data with AI/LLM (e.g., "analyze weather", "summarize emails")
+- Any task requiring reasoning or decision-making
+- Chat completions or conversational AI
+- Multi-step AI tasks
+- ANY prompt asking for "AI", "agent", or "AI processing"
+
+**Use @n8n/n8n-nodes-langchain.openAi ONLY for:**
+- Image generation (DALL-E)
+- Audio transcription (Whisper)
+- Text-to-speech
+- Embeddings generation
+- Other OpenAI-specific operations that are NOT text analysis/reasoning
+
+WRONG: Recommending openAi node for "analyze weather data" or "summarize news"
+CORRECT: Recommending AI Agent for analysis/summarization tasks
+
+When user asks for AI processing, analysis, or summarization:
+1. Recommend AI Agent (@n8n/n8n-nodes-langchain.agent)
+2. Recommend OpenAI Chat Model (lmChatOpenAi) as the default chat model - new users get free OpenAI credits
+3. Do NOT recommend the standalone openAi node for these tasks
+4. Do NOT recommend Basic LLM Chain - always prefer AI Agent
+
+**Default Chat Model: OpenAI (lmChatOpenAi)**
+- Use OpenAI Chat Model unless user explicitly requests a different provider (e.g., "use Claude", "use Gemini")
+- OpenAI has the lowest setup friction for new trial users
+- Only use lmChatAnthropic, lmChatGoogleGemini, etc. when explicitly requested
+
+Chat Model nodes are SUB-NODES - they connect TO AI Agent via ai_languageModel, never used standalone for text processing.`;
+const AI_AGENT_TOOLS = `When AI Agent needs to perform external actions, use TOOL nodes connected via ai_tool:
+
+**Pattern: AI Agent with Tool nodes**
+- AI Agent decides WHEN and HOW to use tools based on its reasoning
+- Tool nodes connect TO the AI Agent (Tool → AI Agent [ai_tool])
+- The agent can call tools multiple times or skip them entirely based on context
+
+**Common Tool nodes (use INSTEAD of regular nodes when AI Agent is involved):**
+| Regular Node | Tool Node | When to use Tool version |
+|--------------|-----------|--------------------------|
+| googleCalendar | googleCalendarTool | AI Agent creates/manages calendar events |
+| slack | slackTool | AI Agent sends messages or reads channels |
+| gmail | gmailTool | AI Agent sends emails or searches inbox |
+| httpRequest | httpRequestTool | AI Agent makes API calls |
+| calculator | calculatorTool | AI Agent performs calculations |
+
+**When to use Tool nodes vs Regular nodes:**
+- Tool node: AI Agent needs to DECIDE whether/when to perform the action
+- Regular node: Action ALWAYS happens at that point in the workflow
+
+**Example - AI scheduling assistant:**
+WRONG: AI Agent → Google Calendar (calendar always creates event)
+CORRECT: Google Calendar Tool → AI Agent [ai_tool] (agent decides if/when to create event)`;
 const STRUCTURED_OUTPUT_PARSER = node_guidance_1.structuredOutputParser.usage;
 const CODE_NODE_ALTERNATIVES = `CRITICAL: Prefer native n8n nodes over Code node. Code nodes are slower (sandboxed environment).
 
@@ -212,8 +268,8 @@ const CODE_NODE_ALTERNATIVES = `CRITICAL: Prefer native n8n nodes over Code node
 | Filter items by condition | Filter |
 | Route by condition | If or Switch |
 | Split array into items | Split Out |
-| Combine multiple items | Aggregate |
-| Merge data from branches | Merge |
+| Combine/join/merge data from multiple sources | Merge AND Aggregate (recommend BOTH - Builder decides structure) |
+| Rejoin conditional branches (after If/Switch) | Edit Fields (Set) |
 | Summarize/pivot data | Summarize |
 | Sort items | Sort |
 | Remove duplicates | Remove Duplicates |
@@ -248,8 +304,13 @@ const CODE_NODE_ALTERNATIVES = `CRITICAL: Prefer native n8n nodes over Code node
 - Regex operations (use expressions in If or Edit Fields nodes)
 - Text extraction or parsing (use Edit Fields with expressions)
 - Logging using console.log unless user explicitly asks - only useful for debugging, not production`;
+const EXPLICIT_INTEGRATIONS = `When user explicitly requests a specific service or integration:
+- ALWAYS use the exact integration requested (e.g., "use Perplexity" → Perplexity node, NOT SerpAPI)
+- Do NOT substitute with similar services unless the requested one doesn't exist in n8n
+- Search for the requested integration first before considering alternatives
+- Examples: "use Gemini" → Google Gemini; "send via Telegram" → Telegram node`;
 const CRITICAL_RULES = `- NEVER ask clarifying questions
-- ALWAYS call get_best_practices first
+- ALWAYS call get_documentation first (with best_practices, and node_recommendations if AI tasks are needed)
 - 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 RELEVANT node
 - ALWAYS extract version number from <version> tag in node details
@@ -258,7 +319,19 @@ const CRITICAL_RULES = `- NEVER ask clarifying questions
 - If no parameters appear in connection expressions, return empty array []
 - Output ONLY: nodesFound with {{ nodeName, version, reasoning, connectionChangingParameters }}
 - When user specifies a model name (e.g., 'gpt-4.1-mini') try to use this if it is a valid option
-- PREFER native n8n nodes (especially Edit Fields) over Code node`;
+- PREFER native n8n nodes (especially Edit Fields) over Code node
+- For structural/flow nodes (Merge, Aggregate, If, Switch), be INCLUSIVE - recommend ALL that COULD be useful, let Builder decide which to actually use based on workflow structure
+- Example: If task involves combining data from multiple sources, recommend BOTH Merge (for parallel branches) AND Aggregate (for items in same branch) - Builder will pick the right one
+- Reasoning should focus on FUNCTIONAL capability (what the node does), NOT workflow structure assumptions (how branches will be arranged)
+- WRONG reasoning: "Aggregate to combine 3 channels" (assumes structure)
+- CORRECT reasoning: "Aggregate to combine multiple items into one" (describes capability)`;
+const NODE_RECOMMENDATIONS_GUIDANCE = `When to include node_recommendations in get_documentation requests:
+- User mentions generic tasks like "generate image", "transcribe audio", "analyze text"
+- The user's request falls within one of the node recommendation categories: ${Object.values(types_1.RecommendationCategory).join(', ')}
+
+Do NOT request node_recommendations when:
+- It is clear for each recommendation category what nodes the user would like to use
+- It is clear how to configure the nodes they have requested to use (e.g. what model to use for an agent)`;
 const RESTRICTIONS = `- Output text commentary between tool calls
 - Include bestPractices or categorization in submit_discovery_results
 - Flag parameters that don't affect connections
@@ -266,7 +339,7 @@ const RESTRICTIONS = `- Output text commentary between tool calls
 function generateAvailableToolsList(options) {
     const { includeExamples } = options;
     const tools = [
-        '- get_best_practices: Retrieve best practices (internal context)',
+        '- get_documentation: Retrieve best practices and/or node recommendations. Pass an array of requests, each with type "best_practices" (requires techniques array) or "node_recommendations" (requires categories array)',
         '- search_nodes: Find n8n nodes by keyword',
         '- get_node_details: Get complete node information including <connections>',
     ];
@@ -280,7 +353,7 @@ function generateProcessSteps(options) {
     const { includeExamples } = options;
     const steps = [
         '**Analyze user prompt** - Extract services, models, and technologies mentioned',
-        '**Call get_best_practices** with identified techniques (internal context)',
+        '**Call get_documentation** with requests array containing best_practices (with techniques) and optionally node_recommendations (with categories for AI tasks)',
     ];
     if (includeExamples) {
         steps.push('**Call get_workflow_examples** with search queries for mentioned services/models');
@@ -301,10 +374,14 @@ function buildDiscoveryPrompt(options) {
         .section('process', processSteps)
         .section('technique_categorization', TECHNIQUE_CATEGORIZATION)
         .section('technique_clarifications', TECHNIQUE_CLARIFICATIONS)
+        .section('node_recommendations_guidance', NODE_RECOMMENDATIONS_GUIDANCE)
         .section('code_node_alternatives', CODE_NODE_ALTERNATIVES)
+        .section('explicit_integrations', EXPLICIT_INTEGRATIONS)
         .section('connection_changing_parameters', CONNECTION_PARAMETERS)
         .section('dynamic_output_nodes', DYNAMIC_OUTPUT_NODES)
         .section('sub_nodes_searches', SUB_NODES_SEARCHES)
+        .section('ai_node_selection', AI_NODE_SELECTION)
+        .section('ai_agent_tools', AI_AGENT_TOOLS)
         .section('structured_output_parser', STRUCTURED_OUTPUT_PARSER)
         .section('critical_rules', CRITICAL_RULES)
         .section('do_not', RESTRICTIONS)

package/dist/prompts/agents/discovery.prompt.js.map

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

package/dist/prompts/chains/parameter-updater/guides/gmail.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GMAIL_GUIDE = void 0;
 exports.GMAIL_GUIDE = {
-    patterns: ['n8n-nodes-base.gmail'],
+    patterns: ['n8n-nodes-base.gmail', 'n8n-nodes-base.gmailTrigger'],
     content: `
 ### Gmail Node Updates
 
@@ -14,13 +14,38 @@ exports.GMAIL_GUIDE = {
 - **message**: Email body/content
 - **authentication**: OAuth2 or Service Account
 
+#### Simplify Option (CRITICAL)
+- **simplify: false** - Returns FULL email with body, attachments, headers
+- **simplify: true** - Returns LIMITED data (subject, snippet only, NO body)
+
+ALWAYS set simplify to FALSE when:
+- Workflow needs to analyze email content/body
+- AI Agent will process or summarize emails
+- Email content is used for decision making
+- Attachments need to be accessed
+
+#### Gmail Filter Queries
+For Gmail Trigger nodes, use comprehensive search filters with OR operators:
+- Multiple keywords: "subject:(delivery OR shipment OR package OR tracking)"
+- From specific senders: "from:example@domain.com"
+- With attachments: "has:attachment"
+- Unread only: "is:unread"
+
+Example for package tracking: "subject:(delivery OR shipment OR package OR tracking OR shipped)"
+NOT just: "subject:delivery" (misses many relevant emails)
+
 #### Common Patterns
 1. **Sending Email**:
    - Set resource to "message"
    - Set operation to "send"
    - Configure to, subject, and message fields
 
-2. **Using Expressions**:
+2. **Reading Emails for AI Analysis**:
+   - Set simplify to false (required for full email body)
+   - Configure appropriate filter query
+   - Pass full email data to AI Agent
+
+3. **Using Expressions**:
    - Can use expressions: "={{ $('Previous Node').item.json.email }}"
    - Can reference previous node data for dynamic values
 `,

package/dist/prompts/chains/parameter-updater/guides/gmail.js.map

@@ -1 +1 @@
-{"version":3,"file":"gmail.js","sourceRoot":"","sources":["../../../../../src/prompts/chains/parameter-updater/guides/gmail.ts"],"names":[],"mappings":";;;AAEa,QAAA,WAAW,GAAkB;IACzC,QAAQ,EAAE,CAAC,sBAAsB,CAAC;IAClC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;CAoBT;CACA,CAAC"}
+{"version":3,"file":"gmail.js","sourceRoot":"","sources":["../../../../../src/prompts/chains/parameter-updater/guides/gmail.ts"],"names":[],"mappings":";;;AAEa,QAAA,WAAW,GAAkB;IACzC,QAAQ,EAAE,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;IACjE,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CT;CACA,CAAC"}