@n8n/ai-workflow-builder 1.8.1 → 1.10.0

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":"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"}

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

@@ -1 +1,3 @@
-export declare function buildSupervisorPrompt(): string;
+export declare function buildSupervisorPrompt(options?: {
+    mergeAskBuild?: boolean;
+}): string;

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

@@ -2,39 +2,159 @@
 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
+const AVAILABLE_AGENTS_WITH_ASSISTANT = `- 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
+- assistant: Answer pure knowledge questions about errors, debugging, and n8n concepts (NOT for action requests)
 - 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"
+const AVAILABLE_AGENTS_WITHOUT_ASSISTANT = `- 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_WITH_ASSISTANT = `1. Is user asking a conversational question or chatting? → responder
+   Examples: "what does this do?", "explain the workflow", "thanks", "what does this node do?"
+   Responder explains THIS specific workflow/node using current workflow context.
+
+2. Is user asking a pure KNOWLEDGE QUESTION about errors, credentials, debugging, or n8n concepts? → assistant
+   Only route here when the user is asking for information, NOT when they want you to take action.
+   Assistant provides general n8n knowledge, credential help, error diagnosis, and best practices.
+   Examples: "why is this node failing?", "how do I set up Gmail credentials?", "what does this error mean?", "how does the HTTP Request node work?", "help me debug this"
+   Examples with selected nodes: "why is this failing?", "help me fix this error"
+
+3. Does the message contain BOTH a knowledge question AND an action request? → discovery or builder
+   When the user asks a question AND requests an action in the same message, always prefer the action path.
+   The responder will address the knowledge question when summarizing the build result.
+   Examples: "what are Slack credentials? set them up", "how does OAuth work? add it to this node", "explain webhooks and add one to my workflow"
 
-2. Does the request involve NEW or DIFFERENT node types? → discovery
+4. Is the user asking you to DO something to the workflow (create, modify, configure, set up nodes)? → discovery or builder
+   IMPORTANT: If the message is an action request (imperative/instructional tone), it goes to discovery or builder, NOT assistant.
+   Examples: "set them up", "configure the node", "now add a Slack node", "connect these", "do it"
+   Continue to steps 5-7 to choose between discovery and builder.
+
+5. Does the request involve NEW or DIFFERENT node types? → discovery
    Examples:
    - "Build a workflow that..." (new workflow)
    - "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
+6. 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
+7. 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..."`;
-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)`;
+   - "Update the email subject to..."
+   Examples with selected nodes: "change this", "update this", "fix this", "configure this"`;
+const ROUTING_DECISION_TREE_WITHOUT_ASSISTANT = `1. Is user asking a conversational 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"
+   Responder explains THIS specific workflow/node using current workflow context.
+
+2. Is the user asking you to DO something to the workflow? → discovery or builder
+   IMPORTANT: Action requests (imperative/instructional tone) always go to discovery or builder.
+   Continue to steps 3-4 to choose between discovery and builder.
+
+3. Does the request involve NEW or DIFFERENT node types? → discovery
+   Examples:
+   - "Build a workflow that..." (new workflow)
+   - "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)
+
+4. Is the request about connecting/disconnecting existing nodes or changing VALUES? → 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)
+   Value changes: "Change the URL to https://...", "Set the timeout to 30 seconds", "Update the email subject to..."
+   Examples with selected nodes: "change this", "update this", "fix this", "configure this"`;
+const KEY_DISTINCTION_WITH_ASSISTANT = `RESPONDER vs ASSISTANT:
+- Responder = explains THIS specific workflow/node using current workflow context
+- Assistant = general n8n knowledge, credential help, error diagnosis, best practices
+- "What does this node do?" = EXPLANATION of current workflow = responder
+- "How does the HTTP Request node work in general?" = KNOWLEDGE = assistant
+- "Is this set up correctly?" / "What's wrong with this?" = DIAGNOSIS = assistant
+
+ACTION vs KNOWLEDGE:
+- "Why is this node failing?" = ERROR DEBUG = assistant (needs SDK troubleshooting)
+- "How do I set up OAuth?" = CREDENTIAL HELP = assistant (SDK has credential documentation)
+- "Set up OAuth on this node" = ACTION REQUEST = builder (user wants you to configure, not explain)
+- "Now set them up for this workflow" = ACTION REQUEST = builder (imperative tone = action, not question)
+- "Use [ServiceB] instead of [ServiceA]" = REPLACEMENT = discovery (new node type needed)
+- "Change the [ServiceA] API key" = CONFIGURATION = builder (same node, different value)
+
+MIXED INTENT (question + action in same message):
+- "What are Slack credentials? Set them up" = ACTION (builder) — responder will explain credentials in summary
+- "How does OAuth work? Add it to this node" = ACTION (discovery/builder) — responder covers the explanation
+- "Explain webhooks and add one" = ACTION (discovery) — responder addresses the explanation part
+- When in doubt between assistant and action, prefer action — the responder can always explain
+
+COMMON PATTERNS:
+- Polite wrappers: "Help me set up X" / "Can you configure this?" / "Could you add a node?" = ACTION = discovery or builder (not assistant)
+- Complaints: "This doesn't work" / "It's broken" / "Something went wrong" = DIAGNOSIS = assistant
+- Implicit actions: "The timeout should be higher" / "This node needs OAuth" = ACTION = builder (implicit "change it")
+- Statements of need: "I need to send emails when X happens" = NEW WORKFLOW = discovery`;
+const KEY_DISTINCTION_WITHOUT_ASSISTANT = `- "What does this workflow do?" = EXPLANATION = responder (generates explanation from current workflow context)
+- "Use [ServiceB] instead of [ServiceA]" = REPLACEMENT = discovery (new node type needed)
+- "Change the [ServiceA] API key" = CONFIGURATION = builder (same node, different value)
+- Polite wrappers: "Help me set up X" / "Can you configure this?" = ACTION = discovery or builder
+- Implicit actions: "The timeout should be higher" = ACTION = builder (implicit "change it")`;
+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.';
-function buildSupervisorPrompt() {
+function buildSupervisorPrompt(options) {
+    const hasAssistant = options?.mergeAskBuild === true;
     return (0, builder_1.prompt)()
         .section('role', SUPERVISOR_ROLE)
-        .section('available_agents', AVAILABLE_AGENTS)
-        .section('routing_decision_tree', ROUTING_DECISION_TREE)
-        .section('key_distinction', KEY_DISTINCTION)
+        .section('available_agents', hasAssistant ? AVAILABLE_AGENTS_WITH_ASSISTANT : AVAILABLE_AGENTS_WITHOUT_ASSISTANT)
+        .section('routing_decision_tree', hasAssistant ? ROUTING_DECISION_TREE_WITH_ASSISTANT : ROUTING_DECISION_TREE_WITHOUT_ASSISTANT)
+        .section('key_distinction', hasAssistant ? KEY_DISTINCTION_WITH_ASSISTANT : KEY_DISTINCTION_WITHOUT_ASSISTANT)
+        .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":";;AAwKA,sDAqBC;AAtLD,wCAAoC;AACpC,qEAA4E;AAE5E,MAAM,eAAe,GAAG,sEAAsE,CAAC;AAE/F,MAAM,+BAA+B,GAAG;;;6DAGqB,CAAC;AAE9D,MAAM,kCAAkC,GAAG;;6DAEkB,CAAC;AAE9D,MAAM,oCAAoC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4FAqC+C,CAAC;AAE7F,MAAM,uCAAuC,GAAG;;;;;;;;;;;;;;;;;;;;;4FAqB4C,CAAC;AAG7F,MAAM,8BAA8B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;wFAyBiD,CAAC;AAEzF,MAAM,iCAAiC,GAAG;;;;6FAImD,CAAC;AAG9F,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,CAAC,OAAqC;IAC1E,MAAM,YAAY,GAAG,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAErD,OAAO,IAAA,gBAAM,GAAE;SACb,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC;SAChC,OAAO,CACP,kBAAkB,EAClB,YAAY,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,kCAAkC,CACnF;SACA,OAAO,CACP,uBAAuB,EACvB,YAAY,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,uCAAuC,CAC7F;SACA,OAAO,CACP,iBAAiB,EACjB,YAAY,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,iCAAiC,CACjF;SACA,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;

package/dist/prompts/shared/deictic-resolution.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDeicticResolutionPrompt = buildDeicticResolutionPrompt;
+function hasItems(arr) {
+    return Boolean(arr && arr.length > 0);
+}
+function formatExamples(examples) {
+    return examples.map((line) => `   - ${line}`);
+}
+function formatBulletList(examples) {
+    return examples.map((example) => `- ${example}`);
+}
+function buildCoreTiers(examples) {
+    return [
+        'DEICTIC REFERENCE RESOLUTION (in priority order):',
+        '',
+        '1. CONVERSATION CONTEXT (highest priority):',
+        '   If the conversation has established something that "this"/"these" could refer to',
+        `   ${examples.conversationContext}`,
+        '',
+        '2. SELECTED NODES (when <selected_nodes> is present and non-empty):',
+        '   - "this node" / "it" / "this" → The selected node(s)',
+        ...formatExamples(examples.selectedNodes),
+        '',
+        '   SINGULAR vs PLURAL handling:',
+        '   - If user uses singular ("this", "it") but multiple nodes are selected:',
+        '     - If nodes are similar (same type), address them together',
+        '     - If nodes are different types, briefly describe each or ask which one they mean',
+        '   - If user uses plural ("these") with single selection, treat as referring to that node',
+    ];
+}
+function buildPositionalReferencesSection(examples) {
+    if (!hasItems(examples.positionalReferences))
+        return [];
+    return [
+        '',
+        '3. POSITIONAL REFERENCES (relative to selected nodes, using connection info):',
+        '   Use <incoming_connections> and <outgoing_connections> from selected node context',
+        '   - "previous" / "before" / "upstream" → nodes in incomingConnections',
+        '   - "next" / "after" / "downstream" → nodes in outgoingConnections',
+        '   - "first" / "start" → trigger/start nodes with no incoming connections',
+        '   - "last" / "end" → terminal nodes with no outgoing connections',
+        ...formatExamples(examples.positionalReferences),
+    ];
+}
+function buildExplicitNameMentionsSection(examples) {
+    if (!hasItems(examples.explicitNameMentions))
+        return [];
+    const tierNumber = hasItems(examples.positionalReferences) ? '4' : '3';
+    return [
+        '',
+        `${tierNumber}. EXPLICIT NAME MENTIONS (when user mentions a node by name without @ selection):`,
+        '   - "the [NodeName] node" → resolve by exact name match in workflow',
+        '   - "the [NodeType]" (e.g., "the Webhook") → resolve by type match if unique',
+        '   - If multiple nodes match, ask for clarification',
+        ...formatExamples(examples.explicitNameMentions),
+    ];
+}
+function buildAttributeBasedReferencesSection(examples) {
+    if (!hasItems(examples.attributeBasedReferences))
+        return [];
+    const tierNumber = (hasItems(examples.positionalReferences) ? 1 : 0) +
+        (hasItems(examples.explicitNameMentions) ? 1 : 0) +
+        3;
+    return [
+        '',
+        `${tierNumber}. ATTRIBUTE-BASED REFERENCES (when no explicit selection):`,
+        '   - "the broken one" / "the red one" → nodes with non-empty <issues>',
+        '   - "the unconfigured one" → nodes with missing required parameters',
+        '   - "the new one" → most recently added node (if trackable)',
+        ...formatExamples(examples.attributeBasedReferences),
+    ];
+}
+function buildWorkflowFallbackSection(examples) {
+    const fallbackTierNumber = (hasItems(examples.positionalReferences) ? 1 : 0) +
+        (hasItems(examples.explicitNameMentions) ? 1 : 0) +
+        (hasItems(examples.attributeBasedReferences) ? 1 : 0) +
+        3;
+    return [
+        '',
+        `${fallbackTierNumber}. WORKFLOW FALLBACK (when no nodes selected and no conversation context):`,
+        '   - "this" → The workflow as a whole',
+        '   - "these" / "these nodes" → All nodes in the workflow',
+        ...formatExamples(examples.workflowFallback),
+    ];
+}
+function buildDualReferencesSection(examples) {
+    if (!hasItems(examples.dualReferences))
+        return [];
+    return [
+        '',
+        'DUAL REFERENCES (when user references two things):',
+        '   - "connect this to that" → this = selected node, that = requires clarification or context',
+        '   - "connect this to [NodeName]" → this = selected, NodeName = explicit mention',
+        '   - "move this before that" → resolve both, ask if "that" is ambiguous',
+        ...formatExamples(examples.dualReferences),
+    ];
+}
+function buildDisambiguationAndNegation() {
+    return [
+        '',
+        'DISAMBIGUATION:',
+        '   - If 2+ nodes match a reference equally well, ask: "Which node do you mean: X or Y?"',
+        '   - For destructive actions (delete, disconnect), always confirm the target',
+        '   - If no match found, suggest similar names: "I don\'t see a node called X. Did you mean Y?"',
+        '   - Never guess for ambiguous references - clarification is better than wrong actions',
+        '',
+        'NEGATION:',
+        '   - "not this one" / "not X" → explicitly exclude X from consideration',
+        '   - "the other one" → if 2 candidates, pick the one NOT selected/NOT recently mentioned',
+    ];
+}
+function buildExampleSections(examples) {
+    const lines = [];
+    if (hasItems(examples.examples)) {
+        lines.push('', 'Examples:', ...formatBulletList(examples.examples));
+    }
+    if (hasItems(examples.examplesWithSelection)) {
+        lines.push('', 'Examples with selection:', ...formatBulletList(examples.examplesWithSelection));
+    }
+    if (hasItems(examples.examplesWithoutSelection)) {
+        lines.push('', 'Examples without selection:', ...formatBulletList(examples.examplesWithoutSelection));
+    }
+    if (examples.additionalNotes) {
+        lines.push('', examples.additionalNotes);
+    }
+    return lines;
+}
+function buildDeicticResolutionPrompt(examples) {
+    const lines = [
+        ...buildCoreTiers(examples),
+        ...buildPositionalReferencesSection(examples),
+        ...buildExplicitNameMentionsSection(examples),
+        ...buildAttributeBasedReferencesSection(examples),
+        ...buildWorkflowFallbackSection(examples),
+        ...buildDualReferencesSection(examples),
+        ...buildDisambiguationAndNegation(),
+        ...buildExampleSections(examples),
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=deictic-resolution.js.map

package/dist/prompts/shared/deictic-resolution.js.map

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

package/dist/session-manager.service.d.ts

@@ -2,17 +2,20 @@ import { MemorySaver } from '@langchain/langgraph';
 import { Logger } from '@n8n/backend-common';
 import type { INodeTypeDescription } from 'n8n-workflow';
 import type { HITLHistoryEntry, HITLInterruptValue } from './types/planning';
-import { Session } from './types/sessions';
+import { ISessionStorage } from './types/session-storage';
+import { LangchainMessage, Session } from './types/sessions';
 export declare class SessionManagerService {
+    private readonly storage?;
     private readonly logger?;
     private checkpointer;
     private nodeTypes;
     private static readonly HITL_TTL_MS;
     private pendingHitlByThreadId;
     private hitlHistoryByThreadId;
-    constructor(parsedNodeTypes: INodeTypeDescription[], logger?: Logger | undefined);
+    constructor(parsedNodeTypes: INodeTypeDescription[], storage?: ISessionStorage | undefined, logger?: Logger | undefined);
+    get usesPersistence(): boolean;
     updateNodeTypes(nodeTypes: INodeTypeDescription[]): void;
-    static generateThreadId(workflowId?: string, userId?: string): string;
+    static generateThreadId(workflowId?: string, userId?: string, agentType?: 'code-builder'): string;
     getCheckpointer(): MemorySaver;
     setPendingHitl(threadId: string, value: HITLInterruptValue, triggeringMessageId?: string): void;
     clearPendingHitl(threadId: string): void;
@@ -28,8 +31,15 @@ export declare class SessionManagerService {
     private hitlEntryToMessages;
     private findInsertPosition;
     private evictExpiredHitl;
-    getSessions(workflowId: string | undefined, userId: string | undefined): Promise<{
+    loadSessionMessages(threadId: string): Promise<LangchainMessage[]>;
+    saveSessionFromCheckpointer(threadId: string, previousSummary?: string): Promise<void>;
+    getPreviousSummary(threadId: string): Promise<string | undefined>;
+    clearSession(threadId: string): Promise<void>;
+    clearAllSessions(workflowId: string, userId: string): Promise<void>;
+    getSessions(workflowId: string | undefined, userId: string | undefined, agentType?: 'code-builder'): Promise<{
         sessions: Session[];
     }>;
-    truncateMessagesAfter(workflowId: string, userId: string | undefined, messageId: string): Promise<boolean>;
+    private loadMessagesForTruncation;
+    truncateMessagesAfter(workflowId: string, userId: string | undefined, messageId: string, agentType?: 'code-builder'): Promise<boolean>;
+    private resetCodeBuilderSession;
 }