@n8n/ai-workflow-builder 1.8.0 → 1.9.0

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

@@ -5,6 +5,7 @@ exports.buildRecoveryModeContext = buildRecoveryModeContext;
 exports.buildBuilderPrompt = buildBuilderPrompt;
 const data_table_helpers_1 = require("../../utils/data-table-helpers");
 const builder_1 = require("../builder");
+const deictic_resolution_1 = require("../shared/deictic-resolution");
 const node_guidance_1 = require("../shared/node-guidance");
 const dataTableColumnOperationsList = data_table_helpers_1.DATA_TABLE_ROW_COLUMN_MAPPING_OPERATIONS.join(', ');
 const ROLE = 'You are a Builder Agent that constructs n8n workflows: adding nodes, connecting them, and configuring their parameters.';
@@ -74,9 +75,27 @@ Example "Webhook → Set → IF → Slack / Email":
   Round 4: configure(Slack, Email)
   Round 5: connect(IF→Slack, IF→Email), validate_structure, validate_configuration
 
-Validation: Use validate_structure and validate_configuration once at the end. Once both pass, output your summary and stop—the workflow is complete.
+Validation: Use validate_structure and validate_configuration once at the end. Once both pass, output your summary and stop — the workflow is complete.
 
 Plan all nodes before starting to avoid backtracking.`;
+const VALIDATION_WITH_INTROSPECTION = `Validation: Call validate_structure and validate_configuration once at the end. After validation passes, call introspect to report any issues. Once both validation and introspection are complete, output your summary and stop — the workflow is complete.
+
+NEVER respond to the user without calling validate_structure, validate_configuration, AND introspect first.`;
+function buildExecutionSequence(includeExamples, enableIntrospection) {
+    const base = includeExamples ? EXECUTION_SEQUENCE_WITH_EXAMPLES : EXECUTION_SEQUENCE;
+    if (!enableIntrospection) {
+        return base;
+    }
+    if (includeExamples) {
+        return base
+            .replace(/^3\. Final: .*$/m, '$& → introspect')
+            .replace(/^\s+Round 5: .*$/m, '$&\n  Round 6: introspect (REQUIRED)')
+            .replace(/^Validation: .*$/m, VALIDATION_WITH_INTROSPECTION);
+    }
+    return base
+        .replace(/^\s+Turn 7: .*$/m, '$&\n  Turn 8: introspect (REQUIRED)')
+        .replace(/<validation>\n[\s\S]*?<\/validation>/, `<validation>\n${VALIDATION_WITH_INTROSPECTION}\n</validation>`);
+}
 const NODE_CREATION = `Each add_nodes call creates one node:
 - nodeType: Exact type from discovery (e.g., "n8n-nodes-base.httpRequest")
 - name: Descriptive name (e.g., "Fetch Weather Data")
@@ -483,6 +502,52 @@ Use these alternatives instead of placeholders:
 - ResourceLocator fields → use mode='list' for dropdown selection
 
 Copy placeholders exactly as shown—the format is parsed by the system to highlight fields requiring user input.`;
+const DEICTIC_RESOLUTION = (0, deictic_resolution_1.buildDeicticResolutionPrompt)({
+    conversationContext: '(e.g., a proposed structure, a connection pattern, an approach), use that referent.\n   Examples: "Do this" after suggesting a connection, "Add these" after listing nodes.',
+    selectedNodes: [
+        '"connect this to X" → Create connection FROM selected node(s) TO node X',
+        '"connect X to this" → Create connection FROM node X TO selected node(s)',
+        '"add X before this" → Create node X, then connect X TO selected node(s)',
+        '"add X after this" → Create node X, then connect selected node(s) TO X',
+        '"disconnect this" → Remove connections involving selected nodes',
+        '"connect these in sequence" → Connect selected nodes in order',
+    ],
+    positionalReferences: [
+        '"add a node before the previous one" → Insert node upstream of incomingConnections',
+        '"connect to the next node" → Connect to node in outgoingConnections',
+        '"insert between this and the next" → Add node between selected and its downstream',
+        '"connect to the first node" → Connect to the trigger/start node',
+        '"add after the last node" → Add node after terminal nodes',
+    ],
+    explicitNameMentions: [
+        '"connect this to the HTTP Request node" → Connect selected to the named node',
+        '"add a Set node before Gmail" → Create Set node, connect Set → Gmail',
+        '"disconnect the Webhook from Slack" → Remove connection between named nodes',
+    ],
+    attributeBasedReferences: [
+        '"connect this to the broken node" → Connect to the node with <issues>',
+        '"add error handling to the unconfigured nodes" → Add error paths to nodes needing config',
+    ],
+    dualReferences: [
+        '"connect this to that" → this = selected, that = ask for clarification',
+        '"swap this and that" → this = selected, that = needs clarification',
+        '"insert between this and the HTTP Request" → Add node between selected and named node',
+    ],
+    workflowFallback: [
+        '"connect these" → Connect all workflow nodes (clarify order if ambiguous)',
+        '"reorganize this" → Restructure workflow connections',
+    ],
+    examplesWithSelection: [
+        'User selects "HTTP Request", says "add an IF node after this" → Create IF, connect HTTP Request → IF',
+        'User selects "Trigger", says "connect this to Slack" → Connect Trigger → Slack',
+        'User selects 2 nodes, says "connect these" → Connect them in logical order',
+    ],
+    examplesWithoutSelection: [
+        'No selection + "connect these in sequence" → Connect all workflow nodes sequentially',
+        'No selection + "add error handling to this" → Add error handling to the workflow',
+        'No selection + "connect HTTP Request to Gmail" → Connect the named nodes',
+    ],
+});
 const RESOURCE_LOCATOR_DEFAULTS = `ResourceLocator field configuration for Google Sheets, Notion, Airtable, etc.:
 
 Default to mode = 'list' for document/database selectors:
@@ -613,6 +678,21 @@ Use get_node_configuration_examples when configuring complex nodes. This tool re
 - HTTP Request, Gmail, Slack: Complex parameter hierarchies benefit from real examples
 - AI nodes: Model settings and prompt structures vary by use case
 - Any node where you want to see how others have configured similar integrations`;
+const DIAGNOSTIC_TOOL = `REQUIRED: You MUST call the introspect tool at least once per workflow to report any issues with your instructions.
+
+The introspect tool helps improve the system by capturing issues with YOUR instructions and documentation (not the user's request).
+
+MANDATORY CALL: Before responding to the user, call introspect to report at least one of these:
+- Any section of your instructions that was unclear, ambiguous, or hard to follow
+- Any best practice pattern that didn't apply well to this specific workflow
+- Any node description from discovery that was confusing or incomplete
+- Any connection pattern example that didn't match what you needed to build
+- Any guidance that was missing for a common scenario you encountered
+- If instructions were perfect, report category "other" with issue "Instructions were sufficient for this task"
+
+Be specific: identify WHICH instruction section or documentation caused the issue (e.g., "ai_connection_patterns section", "node_defaults_warning section", "discovery context for Gmail node").
+
+This data is critical for improving the system prompts and documentation.`;
 function buildRecoveryModeContext(nodeCount, nodeNames) {
     return (`RECOVERY MODE: ${nodeCount} node(s) created (${nodeNames.join(', ')}) before hitting iteration limit.\n` +
         'The workflow is incomplete. Your task:\n' +
@@ -625,11 +705,11 @@ function buildRecoveryModeContext(nodeCount, nodeNames) {
         'Work efficiently—you have limited iterations remaining.');
 }
 function buildBuilderPrompt(options = { includeExamples: false }) {
+    const { includeExamples, enableIntrospection = false } = options;
     return ((0, builder_1.prompt)()
         .section('role', ROLE)
         .section('understanding_context', UNDERSTANDING_CONTEXT)
-        .sectionIf(!options.includeExamples, 'execution_sequence', EXECUTION_SEQUENCE)
-        .sectionIf(options.includeExamples, 'execution_sequence', EXECUTION_SEQUENCE_WITH_EXAMPLES)
+        .section('execution_sequence', buildExecutionSequence(includeExamples, enableIntrospection))
         .section('node_creation', NODE_CREATION)
         .section('use_discovered_nodes', USE_DISCOVERED_NODES)
         .section('ai_connections', AI_CONNECTIONS)
@@ -651,10 +731,12 @@ function buildBuilderPrompt(options = { includeExamples: false }) {
         .section('model_configuration', MODEL_CONFIGURATION)
         .section('node_settings', NODE_SETTINGS)
         .section('workflow_context_tools', WORKFLOW_CONTEXT_TOOLS)
-        .sectionIf(options.includeExamples, 'example_tools', EXAMPLE_TOOLS)
+        .sectionIf(includeExamples, 'example_tools', EXAMPLE_TOOLS)
+        .sectionIf(enableIntrospection, 'diagnostic_tool', DIAGNOSTIC_TOOL)
         .section('anti_overengineering', ANTI_OVERENGINEERING)
         .section('response_format', RESPONSE_FORMAT)
         .section('common_mistakes', COMMON_MISTAKES)
+        .section('deictic_resolution', DEICTIC_RESOLUTION)
         .build());
 }
 //# sourceMappingURL=builder.prompt.js.map

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":";;;AA2pBA,4DAYC;AAED,gDA0CC;AA3sBD,mEAAsF;AAEtF,wCAAoC;AACpC,2DAAkD;AAMlD,MAAM,6BAA6B,GAAG,6DAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1F,MAAM,IAAI,GACT,yHAAyH,CAAC;AAE3H,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyCb,CAAC;AAEf,MAAM,gCAAgC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;sDA0Ba,CAAC;AAIvD,MAAM,aAAa,GAAG;;;;;;oJAM8H,CAAC;AAErJ,MAAM,oBAAoB,GAAG;;;;;;;;;;;;oBAYT,CAAC;AAErB,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6HAwHsG,CAAC;AAE9H,MAAM,gBAAgB,GAAG;;;;;;;;;2EASkD,CAAC;AAE5E,MAAM,kBAAkB,GAAG;;;;;;;;;CAS1B,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oLA+F+J,CAAC;AAErL,MAAM,aAAa,GAAG;mEAC6C,CAAC;AAEpE,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;kIAgBwG,CAAC;AAInI,MAAM,gBAAgB,GAAG;;;;qKAI4I,CAAC;AAEtK,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;mEAmByC,CAAC;AAEpE,MAAM,UAAU,GAAG;;;;;;;;;;2GAUwF,CAAC;AAE5G,MAAM,mBAAmB,GAAG;;;;;mIAKuG,CAAC;AAEpI,MAAM,wBAAwB,GAAG;;;;4BAIL,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAwC7B,CAAC;AAE7B,MAAM,eAAe,GAAG;;;;;;;;;;;;;;kHAc0F,CAAC;AAEnH,MAAM,mBAAmB,GAAG;;;;;;;;qMAQyK,CAAC;AAEtM,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;gHAkBsF,CAAC;AAEjH,MAAM,yBAAyB,GAAG;;;;;;;2MAOyK,CAAC;AAE5M,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;sEAa0C,CAAC;AAEvE,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uFAiCiE,CAAC;AAIxF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;qBAgBT,CAAC;AAEtB,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BP,CAAC;AAIzB,MAAM,oBAAoB,GAAG;;;;iJAIoH,CAAC;AAElJ,MAAM,eAAe,GAAG;;iKAEyI,CAAC;AAGrJ,QAAA,mBAAmB,GAAG;;;gBAGnB,CAAC;AAEjB,MAAM,eAAe,GAAG;;;;sPAI8N,CAAC;AAIvP,MAAM,aAAa,GAAG;;;;;;;;iFAQ2D,CAAC;AAGlF,SAAgB,wBAAwB,CAAC,SAAiB,EAAE,SAAmB;IAC9E,OAAO,CACN,kBAAkB,SAAS,qBAAqB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,qCAAqC;QACzG,0CAA0C;QAC1C,yEAAyE;QACzE,2CAA2C;QAC3C,2CAA2C;QAC3C,sDAAsD;QACtD,wDAAwD;QACxD,mDAAmD;QACnD,yDAAyD,CACzD,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CACjC,UAAgC,EAAE,eAAe,EAAE,KAAK,EAAE;IAE1D,OAAO,CACN,IAAA,gBAAM,GAAE;SACN,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;SAEvD,SAAS,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,CAAC;SAC7E,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,oBAAoB,EAAE,gCAAgC,CAAC;SAE1F,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC;SACvC,OAAO,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;SACrD,OAAO,CAAC,gBAAgB,EAAE,cAAc,CAAC;SACzC,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC7C,OAAO,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;SACjD,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC;SACrC,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC;SACvC,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;SAE/C,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC7C,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;SAC/C,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC;SACjC,OAAO,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;SACnD,OAAO,CAAC,0BAA0B,EAAE,wBAAwB,CAAC;SAC7D,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC3C,OAAO,CAAC,uBAAuB,EAAE,uBAAO,CAAC,aAAa,CAAC;SACvD,OAAO,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;SACnD,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;SAC/C,OAAO,CAAC,2BAA2B,EAAE,yBAAyB,CAAC;SAC/D,OAAO,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;SACnD,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC;SAEvC,OAAO,CAAC,wBAAwB,EAAE,sBAAsB,CAAC;SAEzD,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,eAAe,EAAE,aAAa,CAAC;SAElE,OAAO,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;SACrD,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC3C,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC3C,KAAK,EAAE,CACT,CAAC;AACH,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/discovery.prompt.js

@@ -27,7 +27,8 @@ function formatExampleCategorizations() {
         .join('\n');
 }
 const ROLE = `You are a Discovery Agent for n8n AI Workflow Builder.
-Identify relevant n8n nodes and their connection-changing parameters for the user's request.`;
+Identify relevant n8n nodes and their connection-changing parameters for the user's request.
+When the request is underspecified, ask clarifying questions to ensure the right workflow gets built.`;
 const N8N_EXECUTION_MODEL = `n8n executes each node once per input item.
 
 When a trigger or node outputs multiple items (e.g., Gmail returns 10 emails), every downstream node runs once for each item. Flow control nodes like Aggregate and Split Out change how items flow through the workflow by combining or expanding them.`;
@@ -36,7 +37,7 @@ const PROCESS = `1. Search for nodes matching the user's request using search_no
 3. Call submit_discovery_results with your nodesFound array`;
 const PROCESS_WITH_QUESTIONS = `1. Search for nodes matching the user's request using search_nodes tool
 2. Identify connection-changing parameters from input/output expressions (look for $parameter.X)
-3. If the search results reveal a genuine ambiguity that would lead to very different workflows, ask clarifying questions using submit_questions (see clarifying_questions section)
+3. Assess: do you have enough information to build exactly what the user wants, or would you need to make assumptions about their intent? If assumptions are needed, ask clarifying questions using submit_questions (see clarifying_questions section)
 4. Call submit_discovery_results with your nodesFound array`;
 const PROCESS_WITH_EXAMPLES = `1. Search for nodes matching the user's request using search_nodes tool
 2. Identify connection-changing parameters from input/output expressions (look for $parameter.X)
@@ -47,7 +48,7 @@ const PROCESS_WITH_EXAMPLES_AND_QUESTIONS = `1. Search for nodes matching the us
 2. Identify connection-changing parameters from input/output expressions (look for $parameter.X)
 3. Use get_documentation to retrieve best practices for relevant workflow techniques—this provides proven patterns that improve workflow quality
 4. Use get_workflow_examples to find real community workflows using mentioned services—these examples show how experienced users structure similar integrations
-5. If the search results reveal a genuine ambiguity that would lead to very different workflows, ask clarifying questions using submit_questions (see clarifying_questions section)
+5. Assess: do you have enough information to build exactly what the user wants, or would you need to make assumptions about their intent? If assumptions are needed, ask clarifying questions using submit_questions (see clarifying_questions section)
 6. Call submit_discovery_results with your nodesFound array`;
 const AI_NODE_SELECTION = `AI node selection guidance:
 
@@ -185,22 +186,26 @@ Chat Trigger: n8n-hosted chat interface for conversational AI.
 
 Manual Trigger: For testing and one-off runs only (requires user to click "Execute").
   Use when: explicitly testing or debugging workflows`;
-const CLARIFYING_QUESTIONS = `You can ask the user clarifying questions using submit_questions. This pauses the workflow until the user responds, so use it deliberately.
+const CLARIFYING_QUESTIONS = `You can ask the user clarifying questions using submit_questions. Asking the right questions produces much better workflows — a quick clarification now prevents building the wrong thing.
 
-Always search for nodes FIRST. Searching often resolves ambiguities on its own—if only one weather service node exists, there is nothing to ask about. Your questions should be grounded in what n8n can actually build, based on the nodes you found.
+Always search for nodes FIRST. Your questions should be grounded in what n8n can actually build, based on the nodes you found. But finding relevant nodes doesn't mean you know which ones the user actually wants — assess whether the user's intent is clear enough to pick the right ones.
 
 <when_to_ask>
-Ask when the request is vague enough that it could mean multiple fundamentally different workflows. Evaluate after searching: "Does this request describe ONE clear workflow, or could it reasonably be 3+ completely different automations?"
+Ask when the request has meaningful gaps — missing services, unclear goals, or unspecified triggers — that would force you to guess in ways the user might disagree with. After searching, decide: do you have enough information to build exactly what the user wants, or are you making assumptions they might not agree with? If you'd need to make more than one significant assumption, ask.
 
 Examples where questions help:
 - "Do something with my emails" → Could be filtering, forwarding, archiving, summarizing. Ask about the goal.
 - "Set up notifications" → Found Email, Slack, Telegram, SMS nodes. Ask which channel.
 - "Another automation for weather" → No specific action stated. Ask what should happen.
+- "Automate new employee onboarding" → Which systems? What steps? Ask about the scope.
+- "Automatically process invoices and update accounting" → Invoices from where? Which accounting tool? Ask about the services.
+- "Use AI to help with my content creation" → What kind of content? Blog, social, email? Ask about the use case.
 
 Examples where questions do NOT help:
 - "Send a Slack message when I get a Gmail with an invoice" → One clear workflow. Build it.
-- "Check weather every hour and store it" → Specific enough. Build it.
-- "Monitor my website for downtime" → Reasonable defaults exist. Build it.
+- "Check weather every hour and store it" → Specific enough, reasonable defaults exist. Build it.
+- "Monitor my website for downtime" → Clear intent, reasonable defaults exist. Build it.
+- "Receive webhook POST data and insert it into PostgreSQL" → All details specified. Build it.
 </when_to_ask>
 
 <how_to_ask>

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/agents/planner.prompt.d.ts

@@ -10,5 +10,6 @@ export interface PlannerContextOptions {
     workflowJSON: SimpleWorkflow;
     planPrevious?: PlanOutput | null;
     planFeedback?: string | null;
+    selectedNodesContext?: string;
 }
 export declare function buildPlannerContext(options: PlannerContextOptions): string;

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

@@ -34,7 +34,7 @@ For additionalSpecs: NEVER mention API keys, credentials, authentication, or acc
 Rules:
 - Do not generate workflow JSON.
 - Do not mention internal n8n node type names in steps — describe what happens in plain language.
-- You may include suggestedNodes in the structured output for the builder, but the step description should be human-readable.
+- You may include suggestedNodes in the structured output for the builder, but the step description should be human-readable. Copy node names exactly from the discovery_context_suggested_nodes section — do not add prefixes, rename, or invent node names.
 - If key information is missing, make reasonable assumptions. Only add to additionalSpecs if something would genuinely surprise the user — never credentials or API keys.
 
 <modification_mode>
@@ -59,7 +59,7 @@ function buildPlannerPrompt(options) {
         .build();
 }
 function buildPlannerContext(options) {
-    const { userRequest, discoveryContext, workflowJSON, planPrevious, planFeedback } = options;
+    const { userRequest, discoveryContext, workflowJSON, planPrevious, planFeedback, selectedNodesContext, } = options;
     const discoveredNodesList = discoveryContext.nodesFound
         .map((node) => `- ${node.nodeName} v${node.version}: ${node.reasoning}`)
         .join('\n');
@@ -68,6 +68,7 @@ function buildPlannerContext(options) {
         : '';
     return (0, builder_1.prompt)()
         .section('user_request', userRequest)
+        .sectionIf(selectedNodesContext, 'selected_nodes', () => selectedNodesContext)
         .sectionIf(discoveryContext.nodesFound.length > 0, 'discovery_context_suggested_nodes', discoveredNodesList)
         .sectionIf(workflowJSON.nodes.length > 0, 'existing_workflow', workflowOverview)
         .sectionIf(planPrevious, 'previous_plan', () => (0, plan_helpers_1.formatPlanAsText)(planPrevious))

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

@@ -1 +1 @@
-{"version":3,"file":"planner.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/planner.prompt.ts"],"names":[],"mappings":";;AA+DA,gDAQC;AAeD,kDA0BC;AA1GD,+DAA+D;AAI/D,uDAAwD;AAExD,wCAAoC;AAEpC,MAAM,IAAI,GAAG;6IACgI,CAAC;AAE9I,MAAM,IAAI,GAAG;;gSAEmR,CAAC;AAEjS,MAAM,mBAAmB,GAAG;;;;0aAI8Y,CAAC;AAE3a,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4BO,CAAC;AAEtB,MAAM,aAAa,GAAG;;;;gQAI0O,CAAC;AAEjQ,SAAgB,kBAAkB,CAAC,OAA4C;IAC9E,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,SAAS,CAAC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,CAAC;SACpF,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;SACvB,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC;SACvC,KAAK,EAAE,CAAC;AACX,CAAC;AAeD,SAAgB,mBAAmB,CAAC,OAA8B;IACjE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAE5F,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,UAAU;SACrD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;SACvE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,gBAAgB,GACrB,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,CAAC,IAAA,gCAAgB,EAChB,EAAE,QAAQ,EAAE,YAAY,EAAE,EAC1B,EAAE,eAAe,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAC7E;QACF,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC;SACpC,SAAS,CACT,gBAAgB,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EACtC,mCAAmC,EACnC,mBAAmB,CACnB;SACA,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;SAC/E,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,IAAA,+BAAgB,EAAC,YAAa,CAAC,CAAC;SAC/E,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,YAAa,CAAC;SAC7D,KAAK,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"planner.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/planner.prompt.ts"],"names":[],"mappings":";;AA+DA,gDAQC;AAgBD,kDAkCC;AAnHD,+DAA+D;AAI/D,uDAAwD;AAExD,wCAAoC;AAEpC,MAAM,IAAI,GAAG;6IACgI,CAAC;AAE9I,MAAM,IAAI,GAAG;;gSAEmR,CAAC;AAEjS,MAAM,mBAAmB,GAAG;;;;0aAI8Y,CAAC;AAE3a,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4BO,CAAC;AAEtB,MAAM,aAAa,GAAG;;;;gQAI0O,CAAC;AAEjQ,SAAgB,kBAAkB,CAAC,OAA4C;IAC9E,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,SAAS,CAAC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,CAAC;SACpF,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;SACvB,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC;SACvC,KAAK,EAAE,CAAC;AACX,CAAC;AAgBD,SAAgB,mBAAmB,CAAC,OAA8B;IACjE,MAAM,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,oBAAoB,GACpB,GAAG,OAAO,CAAC;IAEZ,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,UAAU;SACrD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;SACvE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,gBAAgB,GACrB,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,CAAC,IAAA,gCAAgB,EAChB,EAAE,QAAQ,EAAE,YAAY,EAAE,EAC1B,EAAE,eAAe,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAC7E;QACF,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC;SACpC,SAAS,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,oBAAqB,CAAC;SAC9E,SAAS,CACT,gBAAgB,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EACtC,mCAAmC,EACnC,mBAAmB,CACnB;SACA,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;SAC/E,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,IAAA,+BAAgB,EAAC,YAAa,CAAC,CAAC;SAC/E,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,YAAa,CAAC;SAC7D,KAAK,EAAE,CAAC;AACX,CAAC"}

package/dist/prompts/agents/responder.prompt.d.ts

@@ -1,6 +1,9 @@
 import { type DataTableInfo } from '../../utils/data-table-helpers';
+export interface ResponderPromptOptions {
+    enableIntrospection?: boolean;
+}
 export declare function buildRecursionErrorWithWorkflowGuidance(nodeCount: number): string[];
 export declare function buildRecursionErrorNoWorkflowGuidance(): string[];
 export declare function buildGeneralErrorGuidance(): string;
 export declare function buildDataTableCreationGuidance(dataTables: DataTableInfo[]): string;
-export declare function buildResponderPrompt(): string;
+export declare function buildResponderPrompt(options?: ResponderPromptOptions): string;

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

@@ -7,6 +7,7 @@ exports.buildDataTableCreationGuidance = buildDataTableCreationGuidance;
 exports.buildResponderPrompt = buildResponderPrompt;
 const data_table_helpers_1 = require("../../utils/data-table-helpers");
 const builder_1 = require("../builder");
+const deictic_resolution_1 = require("../shared/deictic-resolution");
 const RESPONDER_ROLE = `You are a helpful AI assistant for n8n workflow automation.
 
 You have access to context about what has been built, including:
@@ -39,6 +40,59 @@ Example response structure:
 [If data tables are used, include Data Table creation steps with link to Data Tables tab]
 
 Let me know if you'd like to adjust anything."`;
+const DEICTIC_RESOLUTION = (0, deictic_resolution_1.buildDeicticResolutionPrompt)({
+    conversationContext: '(e.g., a topic being discussed, a question asked, an explanation given), use that referent.\n   Examples: "Explain this more" after a topic, "What about this?" referring to something mentioned.',
+    selectedNodes: [
+        '"what does this do?" → Explain what the selected node(s) do',
+        '"how does this work?" → Explain the functionality of selected node(s)',
+        '"what\'s wrong with this?" → Review issues/configuration of selected node(s)',
+        '"explain this connection" → Describe data flow to/from selected node(s)',
+    ],
+    positionalReferences: [
+        '"what does the previous node do?" → Explain the node in incomingConnections',
+        '"what comes next?" → Describe the node(s) in outgoingConnections',
+        '"explain what happens upstream" → Describe the data flow leading to selected node',
+        '"what triggers this?" → Trace back to the trigger/start node',
+    ],
+    explicitNameMentions: [
+        '"explain the HTTP Request node" → Find and explain the node named "HTTP Request"',
+        '"what does the Gmail node do?" → Explain the Gmail node\'s functionality',
+        '"how is the Webhook configured?" → Describe Webhook node\'s current configuration',
+    ],
+    attributeBasedReferences: [
+        '"what\'s wrong with the broken one?" → Explain issues in the node with <issues>',
+        '"why is this node red?" → Explain the validation errors/issues',
+        '"which nodes are unconfigured?" → List nodes with missing required parameters',
+    ],
+    dualReferences: [
+        '"what\'s the difference between this and that?" → Compare selected vs clarified node',
+        '"how does this connect to the HTTP Request?" → Explain data flow between them',
+    ],
+    workflowFallback: [
+        '"what does this do?" → Explain what the entire workflow does',
+        '"how does this work?" → Explain the workflow\'s overall logic and data flow',
+        '"what\'s wrong with this?" → Review the workflow for issues',
+        '"explain these" → Describe all nodes and their connections',
+    ],
+    examplesWithSelection: [
+        'User selects "HTTP Request", says "what does this do?" → Explain HTTP Request functionality',
+        'User selects 2 nodes, says "explain this" → Explain both nodes and their relationship',
+    ],
+    examplesWithoutSelection: [
+        'No selection + "explain the Gmail node" → Find and explain Gmail node',
+        'No selection + "what\'s the trigger?" → Explain the workflow\'s trigger node',
+    ],
+    additionalNotes: `When answering about selected nodes:
+1. Reference the node by name (e.g., "The HTTP Request node...")
+2. Use information from <selected_nodes> context (connections, issues)
+3. If the node has issues listed, proactively mention them
+4. Explain how the node fits into the workflow based on its connections
+
+When answering about the workflow (no selection):
+1. Provide a high-level overview of what the workflow accomplishes
+2. Describe the data flow from trigger to end
+3. Highlight any issues or areas that need attention`,
+});
 const CONVERSATIONAL_RESPONSES = `- Be friendly and concise
 - Explain n8n capabilities when asked
 - Provide practical examples when helpful`;
@@ -51,6 +105,20 @@ CRITICAL - Describe what was built:
 - Report the ACTUAL configuration from the workflow JSON, not what you think should be there
 - If the workflow uses a model name you don't recognize, describe it exactly as configured—do NOT claim it was changed to something else
 - Your training has a knowledge cutoff. New models exist. Never say "X isn't available yet" about configured values`;
+const DIAGNOSTIC_TOOL = `REQUIRED: You MUST call the introspect tool once before response to report any issues with your instructions.
+
+The introspect tool helps improve the system by capturing issues with YOUR instructions and documentation (not the user's request).
+
+MANDATORY CALL: Before responding to the user, call introspect to report at least one of these:
+- Any response guidelines that were unclear or conflicting
+- Any formatting or tone instructions that didn't apply to this situation
+- Any missing guidance for handling the specific scenario you encountered
+- Any unclear boundaries about what you should/shouldn't say
+- If instructions were perfect, report category "other" with issue "Instructions were sufficient for this task"
+
+Be specific: identify WHICH instruction section caused the issue (e.g., "workflow_completion_responses section", "response_style section", "guardrails section").
+
+This data is critical for improving the system prompts and documentation.`;
 const GUARDRAILS = `Your capabilities are focused on workflow building:
 - You work from your existing knowledge of n8n nodes and integrations
 - You help users design and configure workflows based on their requirements
@@ -131,11 +199,14 @@ function buildColumnInfo(table, isColumnOperation) {
     }
     return 'Add columns based on the data you want to store';
 }
-function buildResponderPrompt() {
+function buildResponderPrompt(options) {
+    const enableIntrospection = options?.enableIntrospection === true;
     return (0, builder_1.prompt)()
         .section('role', RESPONDER_ROLE)
         .section('guardrails', GUARDRAILS)
+        .sectionIf(enableIntrospection, 'diagnostic_tool', DIAGNOSTIC_TOOL)
         .section('execution_issue_handling', EXECUTION_ISSUE_HANDLING)
+        .section('deictic_resolution', DEICTIC_RESOLUTION)
         .section('workflow_completion_responses', WORKFLOW_COMPLETION)
         .section('conversational_responses', CONVERSATIONAL_RESPONSES)
         .section('response_style', RESPONSE_STYLE)

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

@@ -1 +1 @@
-{"version":3,"file":"responder.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/responder.prompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"responder.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/responder.prompt.ts"],"names":[],"mappings":";;AAwKA,0FAOC;AAGD,sFAOC;AAGD,8DAKC;AAMD,wEAwBC;AAoBD,oDAaC;AAzPD,mEAA+F;AAE/F,wCAAoC;AACpC,qEAA4E;AAE5E,MAAM,cAAc,GAAG;;;;;;;;;;;;qFAY8D,CAAC;AAEtF,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;+CAkBmB,CAAC;AAEhD,MAAM,kBAAkB,GAAG,IAAA,iDAA4B,EAAC;IACvD,mBAAmB,EAClB,mMAAmM;IACpM,aAAa,EAAE;QACd,6DAA6D;QAC7D,uEAAuE;QACvE,8EAA8E;QAC9E,yEAAyE;KACzE;IACD,oBAAoB,EAAE;QACrB,6EAA6E;QAC7E,kEAAkE;QAClE,mFAAmF;QACnF,8DAA8D;KAC9D;IACD,oBAAoB,EAAE;QACrB,kFAAkF;QAClF,0EAA0E;QAC1E,mFAAmF;KACnF;IACD,wBAAwB,EAAE;QACzB,iFAAiF;QACjF,gEAAgE;QAChE,+EAA+E;KAC/E;IACD,cAAc,EAAE;QACf,sFAAsF;QACtF,+EAA+E;KAC/E;IACD,gBAAgB,EAAE;QACjB,8DAA8D;QAC9D,6EAA6E;QAC7E,6DAA6D;QAC7D,4DAA4D;KAC5D;IACD,qBAAqB,EAAE;QACtB,6FAA6F;QAC7F,uFAAuF;KACvF;IACD,wBAAwB,EAAE;QACzB,uEAAuE;QACvE,8EAA8E;KAC9E;IACD,eAAe,EAAE;;;;;;;;;qDASmC;CACpD,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG;;0CAES,CAAC;AAE3C,MAAM,cAAc,GAAG;;;;;;;;oHAQ6F,CAAC;AAErH,MAAM,eAAe,GAAG;;;;;;;;;;;;;0EAakD,CAAC;AAO3E,MAAM,UAAU,GAAG;;;;;iQAK8O,CAAC;AAElQ,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;oFAmBmD,CAAC;AAOrF,SAAgB,uCAAuC,CAAC,SAAiB;IACxE,OAAO;QACN,wBAAwB,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,mDAAmD;QAC1J,qGAAqG;YACpG,iDAAiD;YACjD,mGAAmG;KACpG,CAAC;AACH,CAAC;AAGD,SAAgB,qCAAqC;IACpD,OAAO;QACN,oGAAoG;QACpG,gFAAgF;YAC/E,wFAAwF;YACxF,mEAAmE;KACpE,CAAC;AACH,CAAC;AAGD,SAAgB,yBAAyB;IACxC,OAAO,CACN,yDAAyD;QACzD,0EAA0E,CAC1E,CAAC;AACH,CAAC;AAMD,SAAgB,8BAA8B,CAAC,UAA2B;IACzE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9C,MAAM,iBAAiB,GAAG,IAAA,kDAA6B,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;QAC7D,OAAO,OAAO,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,SAAS,MAAM,UAAU,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,OAAO,IAAA,gBAAM,EAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;SACnC,OAAO,CACP,2BAA2B,EAC3B;;;;;EAKD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;;2EAEiD,CACxE;SACA,KAAK,EAAE,CAAC;AACX,CAAC;AAED,SAAS,eAAe,CAAC,KAAoB,EAAE,iBAA0B;IACxE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACxB,OAAO,4DAA4D,KAAK,CAAC,SAAS,cAAc,CAAC;IAClG,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,WAAW,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,OAAO,gBAAgB,UAAU,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,2CAA2C,KAAK,CAAC,WAAW,QAAQ,CAAC;IAC7E,CAAC;IAED,OAAO,iDAAiD,CAAC;AAC1D,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAgC;IACpE,MAAM,mBAAmB,GAAG,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAElE,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC;SAC/B,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC;SACjC,SAAS,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,CAAC;SAClE,OAAO,CAAC,0BAA0B,EAAE,wBAAwB,CAAC;SAC7D,OAAO,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;SACjD,OAAO,CAAC,+BAA+B,EAAE,mBAAmB,CAAC;SAC7D,OAAO,CAAC,0BAA0B,EAAE,wBAAwB,CAAC;SAC7D,OAAO,CAAC,gBAAgB,EAAE,cAAc,CAAC;SACzC,KAAK,EAAE,CAAC;AACX,CAAC"}

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

@@ -2,12 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildSupervisorPrompt = buildSupervisorPrompt;
 const builder_1 = require("../builder");
+const deictic_resolution_1 = require("../shared/deictic-resolution");
 const SUPERVISOR_ROLE = 'You are a Supervisor that routes user requests to specialist agents.';
 const AVAILABLE_AGENTS = `- discovery: Find n8n nodes for building/modifying workflows
 - builder: Create nodes and connections (requires discovery first for new node types) and sets parameters on nodes
 - responder: Answer questions, confirm completion (TERMINAL)`;
 const ROUTING_DECISION_TREE = `1. Is user asking a question or chatting? → responder
    Examples: "what does this do?", "explain the workflow", "thanks"
+   Examples with selected nodes: "what does this node do?", "explain how it works"
 
 2. Does the request involve NEW or DIFFERENT node types? → discovery
    Examples:
@@ -15,17 +17,62 @@ const ROUTING_DECISION_TREE = `1. Is user asking a question or chatting? → res
    - "Use [ServiceB] instead of [ServiceA]" (replacing node type)
    - "Add [some integration]" (new integration)
    - "Switch from [ServiceA] to [ServiceB]" (swapping services)
+   - "Add something before/after this" (needs discovery to find what to add)
 
 3. Is the request about connecting/disconnecting existing nodes? → builder
    Examples: "Connect node A to node B", "Remove the connection to X"
+   Examples with selected nodes: "connect this to X", "disconnect this", "add X before/after this" (after discovery)
 
 4. Is the request about changing VALUES in existing nodes? → builder
    Examples:
    - "Change the URL to https://..."
    - "Set the timeout to 30 seconds"
-   - "Update the email subject to..."`;
+   - "Update the email subject to..."
+   Examples with selected nodes: "change this", "update this", "fix this", "configure this"`;
 const KEY_DISTINCTION = `- "Use [ServiceB] instead of [ServiceA]" = REPLACEMENT = discovery (new node type needed)
 - "Change the [ServiceA] API key" = CONFIGURATION = builder (same node, different value)`;
+const DEICTIC_RESOLUTION = (0, deictic_resolution_1.buildDeicticResolutionPrompt)({
+    conversationContext: '(e.g., a proposed change, an approach, an error, a feature), use that referent.\n   Examples: "Let\'s do this" after discussing an approach, "Fix this" after an error was mentioned.',
+    selectedNodes: [
+        '"change this" / "update this" / "fix this" → builder',
+        '"connect this to X" / "disconnect this" → builder',
+        '"add X before/after this" → discovery first, then builder',
+        '"what does this do?" / "explain this" → responder',
+    ],
+    positionalReferences: [
+        '"configure the previous node" → builder (for node in incomingConnections)',
+        '"explain what comes next" → responder (for node in outgoingConnections)',
+        '"add a node before this" → discovery + builder',
+    ],
+    explicitNameMentions: [
+        '"configure the HTTP Request node" → builder (explicit node reference)',
+        '"explain the Gmail node" → responder (explain named node)',
+        '"connect HTTP Request to Slack" → builder (named nodes)',
+    ],
+    attributeBasedReferences: [
+        '"fix the broken node" → builder (node with issues)',
+        '"what\'s wrong with the red one?" → responder (explain issues)',
+    ],
+    dualReferences: [
+        '"connect this to that" → builder (may need clarification for "that")',
+        '"copy settings from this to the HTTP Request" → builder',
+    ],
+    workflowFallback: [
+        '"change this" → builder (workflow-wide changes)',
+        '"explain this" → responder (explain the workflow)',
+        '"what does this do?" → responder (describe what the workflow does)',
+    ],
+    examplesWithSelection: [
+        'Selected node + "what does this do?" → responder (explain selected node)',
+        'Selected node + "fix this" → builder (configure selected node)',
+        'Selected node + "add a Slack node after this" → discovery (find Slack node)',
+    ],
+    examplesWithoutSelection: [
+        'No selection + "what does this do?" → responder (explain the workflow)',
+        'No selection + "fix these" → builder (review all nodes for issues)',
+        'No selection + "configure the HTTP Request node" → builder (explicit name)',
+    ],
+});
 const OUTPUT_FORMAT = `- reasoning: One sentence explaining your routing decision
 - next: Agent name`;
 const INSTRUCTION = 'Given the conversation above, which agent should act next? Provide your reasoning and selection.';
@@ -35,6 +82,7 @@ function buildSupervisorPrompt() {
         .section('available_agents', AVAILABLE_AGENTS)
         .section('routing_decision_tree', ROUTING_DECISION_TREE)
         .section('key_distinction', KEY_DISTINCTION)
+        .section('deictic_resolution', DEICTIC_RESOLUTION)
         .section('output', OUTPUT_FORMAT)
         .section('instruction', INSTRUCTION)
         .build();

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

@@ -1 +1 @@
-{"version":3,"file":"supervisor.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/supervisor.prompt.ts"],"names":[],"mappings":";;AA4CA,sDASC;AA9CD,wCAAoC;AAEpC,MAAM,eAAe,GAAG,sEAAsE,CAAC;AAE/F,MAAM,gBAAgB,GAAG;;6DAEoC,CAAC;AAE9D,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;sCAiBQ,CAAC;AAGvC,MAAM,eAAe,GAAG;yFACiE,CAAC;AAE1F,MAAM,aAAa,GAAG;mBACH,CAAC;AAEpB,MAAM,WAAW,GAChB,kGAAkG,CAAC;AAEpG,SAAgB,qBAAqB;IACpC,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC;SAChC,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC7C,OAAO,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;SACvD,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC3C,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC;SAChC,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC;SACnC,KAAK,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"supervisor.prompt.js","sourceRoot":"","sources":["../../../src/prompts/agents/supervisor.prompt.ts"],"names":[],"mappings":";;AA8FA,sDAUC;AAjGD,wCAAoC;AACpC,qEAA4E;AAE5E,MAAM,eAAe,GAAG,sEAAsE,CAAC;AAE/F,MAAM,gBAAgB,GAAG;;6DAEoC,CAAC;AAE9D,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;4FAqB8D,CAAC;AAG7F,MAAM,eAAe,GAAG;yFACiE,CAAC;AAG1F,MAAM,kBAAkB,GAAG,IAAA,iDAA4B,EAAC;IACvD,mBAAmB,EAClB,uLAAuL;IACxL,aAAa,EAAE;QACd,sDAAsD;QACtD,mDAAmD;QACnD,2DAA2D;QAC3D,mDAAmD;KACnD;IACD,oBAAoB,EAAE;QACrB,2EAA2E;QAC3E,yEAAyE;QACzE,gDAAgD;KAChD;IACD,oBAAoB,EAAE;QACrB,uEAAuE;QACvE,2DAA2D;QAC3D,yDAAyD;KACzD;IACD,wBAAwB,EAAE;QACzB,oDAAoD;QACpD,gEAAgE;KAChE;IACD,cAAc,EAAE;QACf,sEAAsE;QACtE,yDAAyD;KACzD;IACD,gBAAgB,EAAE;QACjB,iDAAiD;QACjD,mDAAmD;QACnD,oEAAoE;KACpE;IACD,qBAAqB,EAAE;QACtB,0EAA0E;QAC1E,gEAAgE;QAChE,6EAA6E;KAC7E;IACD,wBAAwB,EAAE;QACzB,wEAAwE;QACxE,oEAAoE;QACpE,4EAA4E;KAC5E;CACD,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG;mBACH,CAAC;AAEpB,MAAM,WAAW,GAChB,kGAAkG,CAAC;AAEpG,SAAgB,qBAAqB;IACpC,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC;SAChC,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC7C,OAAO,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;SACvD,OAAO,CAAC,iBAAiB,EAAE,eAAe,CAAC;SAC3C,OAAO,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;SACjD,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC;SAChC,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC;SACnC,KAAK,EAAE,CAAC;AACX,CAAC"}

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

@@ -23,6 +23,9 @@ function normalizeToTag(name) {
         .replace(/_+/g, '_');
 }
 function formatSection(name, content, format, customTag) {
+    if (format === 'plain') {
+        return content;
+    }
     if (format === 'markdown') {
         const header = customTag ?? name;
         return `## ${header}\n${content}`;
@@ -87,9 +90,12 @@ class PromptBuilder {
         }
         const format = formatter ?? defaultExampleFormatter;
         const examplesContent = examples.map(format).join('\n\n');
-        const examplesBlock = this.format === 'markdown'
-            ? `## Examples\n${examplesContent}`
-            : `<examples>\n${examplesContent}\n</examples>`;
+        const sectionFormat = lastSection.options.format ?? this.format;
+        const examplesBlock = sectionFormat === 'plain'
+            ? examplesContent
+            : sectionFormat === 'markdown'
+                ? `## Examples\n${examplesContent}`
+                : `<examples>\n${examplesContent}\n</examples>`;
         const originalContent = lastSection.content;
         lastSection.content = () => {
             const resolved = resolveContent(originalContent);
@@ -112,7 +118,8 @@ class PromptBuilder {
             if (content === null) {
                 continue;
             }
-            formatted.push(formatSection(section.name, content, this.format, section.options.tag));
+            const sectionFormat = section.options.format ?? this.format;
+            formatted.push(formatSection(section.name, content, sectionFormat, section.options.tag));
         }
         return formatted.join(this.separator);
     }
@@ -123,7 +130,8 @@ class PromptBuilder {
             if (content === null) {
                 continue;
             }
-            const text = formatSection(section.name, content, this.format, section.options.tag);
+            const sectionFormat = section.options.format ?? this.format;
+            const text = formatSection(section.name, content, sectionFormat, section.options.tag);
             const block = { type: 'text', text };
             if (section.options.cache) {
                 block.cache_control = { type: 'ephemeral' };

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

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

package/dist/prompts/builder/types.d.ts

@@ -1,7 +1,8 @@
-export type SectionFormat = 'xml' | 'markdown';
+export type SectionFormat = 'xml' | 'markdown' | 'plain';
 export type ContentOrFactory = string | (() => string | null | undefined);
 export interface SectionOptions {
     tag?: string;
+    format?: SectionFormat;
     cache?: boolean;
 }
 export interface PromptBuilderOptions {

package/dist/prompts/shared/deictic-resolution.d.ts

@@ -0,0 +1,14 @@
+export interface DeicticExamples {
+    conversationContext: string;
+    selectedNodes: string[];
+    workflowFallback: string[];
+    examples?: string[];
+    examplesWithSelection?: string[];
+    examplesWithoutSelection?: string[];
+    additionalNotes?: string;
+    positionalReferences?: string[];
+    explicitNameMentions?: string[];
+    attributeBasedReferences?: string[];
+    dualReferences?: string[];
+}
+export declare function buildDeicticResolutionPrompt(examples: DeicticExamples): string;