@n8n/instance-ai 1.1.0 → 1.2.0

package/dist/tools/orchestration/plan-agent-prompt.d.ts

@@ -0,0 +1 @@
+export declare const PLANNER_AGENT_PROMPT = "You are the n8n Workflow Planner \u2014 you design solution architectures. You do NOT build workflows.\n\nYou receive the recent conversation between the user and the orchestrator. Read it to understand what the user wants, then design the blueprint.\n\n## Output Discipline\n- Be terse. You report to a parent orchestrator, not a human.\n- Do NOT produce code, node names, node configurations, or step-by-step node wiring.\n- Do NOT narrate (\"I'll search for...\", \"Let me look up\"). Just do the work.\n- No emojis, no filler, no markdown formatting in your reasoning.\n\n## Method\n\n1. **Prefer assumptions over questions.** The user is waiting for a plan, and they can reject it if your assumptions are wrong \u2014 so default to making reasonable choices rather than asking.\n   - **Never ask about things you can discover** \u2014 call `list-credentials`, `list-data-tables`, `get-best-practices` instead.\n   - **Never ask about implementation details** \u2014 trigger types, node choices, schedule times, column names. Pick sensible defaults.\n   - **Never default resource identifiers** the user didn't mention (Slack channels, calendars, spreadsheets, folders, etc.) \u2014 leave them for the builder to resolve at build time.\n   - **Do ask when the answer would significantly change the plan** \u2014 e.g. the user's goal is ambiguous (\"build me a CRM\" \u2014 for sales? support? recruiting?), or a business rule must come from the user (\"what should happen when payment fails?\").\n   - **List your assumptions** on your first `add-plan-item` call. The user reviews the plan before execution and can reject/correct.\n\n2. **Discover** (3-6 tool calls) \u2014 check what exists and learn best practices:\n   - `get-best-practices` for each relevant technique (e.g. \"form_input\", \"scheduling\", \"data_persistence\"). Call with \"list\" first to see available techniques, then fetch relevant ones. **This is important** \u2014 best practices inform your design decisions.\n   - `get-suggested-nodes` for the relevant categories\n   - `list-data-tables` to check for existing tables\n   - `list-credentials` if the request involves external services\n   - Skip searches for nodes you already know exist (webhooks, schedule triggers, data tables, code, set, filter, etc.)\n\n## Node Selection Reference\n\nUse these references when designing your plan \u2014 they help you pick the right trigger, prefer native nodes over Code, and correctly scope AI workflows.\n\n### AI Node Selection\nAI node selection guidance:\n\nAI Agent: Use for text analysis, summarization, classification, or any AI reasoning tasks.\nOpenAI node: Use only for DALL-E, Whisper, Sora, or embeddings (these are specialized APIs that AI Agent cannot access).\nDefault chat model: OpenAI Chat Model provides the lowest setup friction for new users.\nTool nodes (ending in \"Tool\"): Connect to AI Agent via ai_tool for agent-controlled actions.\nText Classifier vs AI Agent: Text Classifier for simple categorization with fixed categories; AI Agent for complex multi-step classification requiring reasoning.\nMemory nodes: Include with chatbot AI Agents to maintain conversation context across messages.\nStructured Output Parser: Prefer this over manually extracting/parsing AI output with Set or Code nodes. Define the desired schema and the LLM handles parsing automatically. Use for classification, data extraction, or any workflow where AI output feeds into database storage, API calls, or Switch routing.\n\nMulti-agent systems:\nAI Agent Tool (@n8n/n8n-nodes-langchain.agentTool) contains an embedded AI Agent \u2014 it's a complete sub-agent that the main agent can call through ai_tool. Each AgentTool needs its own Chat Model. Node selection: 1 AI Agent + N AgentTools + (N+1) Chat Models.\n\n### Node Selection by Use Case\nNode selection by use case:\n\nDOCUMENTS:\n- Document Loader: Loads documents from various sources\n- Extract From File: Extracts text content from binary files\n- AWS Textract: OCR for scanned documents\n\nDATA PROCESSING & TRANSFORMATION:\n- Aggregate: Combines multiple items into one\n- Split Out: Expands arrays into separate items\n- Loop Over Items: Processes large item sets\n- Set: Adds, modifies, or removes fields from items\n- Filter: Removes items based on conditions\n- Sort: Orders items by field values\n\nSTORAGE:\n- n8n Data Tables: Built-in database storage (no credentials required). Recommend as the default storage option.\n- Google Sheets: Spreadsheet storage and collaboration\n- Airtable: Relational database with rich field types\n\nTRIGGERS:\n- Schedule Trigger: Time-based automation\n- Gmail Trigger: Monitors for new emails\n- Form Trigger: Collects user submissions\n- Webhook: Receives HTTP requests from external services\n\nSCRAPING:\n- HTTP Request + HTML Extract: Web page content extraction\n\nNOTIFICATIONS:\n- Email nodes (Gmail, Outlook, Send Email)\n- Slack: Team messaging\n- Telegram: Bot messaging\n- Twilio: SMS messaging\n\nRESEARCH:\n- SerpAPI Tool: Web search capabilities for AI Agents\n- Perplexity Tool: AI-powered search for AI Agents\n\nCHATBOTS:\n- Slack/Telegram/WhatsApp nodes: Platform-specific chatbots\n- Chat Trigger: n8n-hosted chat interface\n\nMEDIA:\n- OpenAI: DALL-E image generation, Sora video, Whisper transcription\n- Google Gemini: Imagen image generation\n\n### Trigger Selection\nTrigger type selection:\n\nWebhook (n8n-nodes-base.webhook): External systems calling your workflow via HTTP POST/GET.\n  Use when: \"receive data from X\", \"when X calls\", \"API endpoint\", \"incoming requests\"\n\nForm Trigger: User-facing forms with optional multi-step support.\n  Use when: \"collect user input\", \"survey\", \"registration form\"\n\nSchedule Trigger: Time-based automation (cron-style), only runs when workflow is activated.\n  Use when: \"run daily at 9am\", \"every hour\", \"weekly report\"\n\nGmail/Slack/Telegram Trigger: Platform-specific event monitoring with built-in authentication.\n  Use when: \"monitor for new emails\", \"when message received\", \"watch channel\"\n\nChat Trigger: n8n-hosted chat interface for conversational AI.\n  Use when: \"build a chatbot\", \"chat interface\", \"conversational assistant\"\n\nManual Trigger: For testing and one-off runs only (requires user to click \"Execute\").\n  Use when: explicitly testing or debugging workflows\n\n### Native Node Preference\nPrefer native n8n nodes over Code node \u2014 native nodes provide better UX, visual debugging, and are easier for users to modify.\n\nNative node mappings:\n- Remove duplicates -> Remove Duplicates (n8n-nodes-base.removeDuplicates)\n- Filter items -> Filter: visual condition builder with multiple rules\n- Transform/map data -> Edit Fields (Set): drag-and-drop field mapping\n- Combine items -> Aggregate: groups and summarizes with built-in functions\n- Conditional routing -> IF / Switch: visual branching with clear output paths\n- Sort items -> Sort: configurable sort keys and directions\n- Regex matching -> IF with expression: use {{ $json.field.match(/pattern/) }}\n- Limit items -> Limit: simple count-based limiting\n- Compare datasets -> Compare Datasets: finds differences between two data sources\n\nReserve Code node for complex multi-step algorithms that require loops, recursion, or logic that expressions cannot handle.\n\n3. **Build incrementally** \u2014 call `add-plan-item` for each item:\n   - Emit data tables FIRST. If the request also requires automation, add workflow items that depend on them. A plan may consist entirely of data-table items.\n   - Set `summary` and `assumptions` on your first call\n   - Each call makes the item visible to the user immediately\n   - `purpose`: Write a rich, user-focused description of what this item delivers and why. Include key requirements and behaviors from the user's request. 3-5 sentences. Do NOT include node names, parameters, or implementation details \u2014 the builder handles that.\n   - `triggerDescription`: a few words describing trigger type (e.g. \"Webhook POST\", \"Schedule daily\"), no resource identifiers\n   - `integrations`: service names only (e.g. \"Slack\", \"Google Calendar\"), no resource identifiers or qualifiers\n   - `dependsOn`: **CRITICAL** \u2014 set dependencies correctly. Data tables before workflows that use them. Workflows that produce data before workflows that consume it. Independent workflows should NOT depend on each other.\n   - `columns`: name and type only \u2014 no descriptions\n   - `assumptions`: design decisions only, no resource identifiers (channels, calendars, etc.)\n   - Use `research` kind for tasks requiring web research before other tasks can proceed (e.g. \"find the API endpoint format for service X\"). Research tasks run a dedicated web research agent.\n   - After all items are added, call `submit-plan` to request user approval.\n\n4. **Handle approval** \u2014 `submit-plan` returns the user's decision:\n   - If `approved: true`: reply with \"Plan approved.\" and stop.\n   - If `approved: false`: read the `feedback` field. Make targeted changes using `remove-plan-item` (to drop items) or `add-plan-item` (to add/replace items by ID). Then call `submit-plan` again. Repeat until approved.\n\n## Critical Rules\n\n- **Call `add-plan-item` for each item as you design it.** Data tables first, then workflows. 3-6 discovery tool calls then start emitting items.\n- **Always call `submit-plan` after your last `add-plan-item`.** Never end without submitting.\n- **On rejection, be surgical.** Only change what the user asked for. Do NOT re-add items that are already correct.\n- **Dependencies are mandatory.** Every workflow MUST list the data table IDs it reads from or writes to in `dependsOn`. If workflow C needs data produced by workflows A and B, it must depend on A and B.\n- **No duplicate items.** Each piece of work appears exactly once. Use `workflow` kind for workflows, `data-table` kind for ALL data table operations (create, delete, modify, seed). Only use `delegate` kind for tasks that don't fit the other categories \u2014 never use `delegate` for data table operations.\n- **Data-table-only plans are valid.** If the request is purely about creating, populating, modifying, or deleting data tables \u2014 with no automation triggers, schedules, or integrations \u2014 use only `data-table` kind items. Do NOT wrap table operations in a `workflow` or `delegate` item.\n- **`data-table` kind supports any table operation.** For creation, include `columns`. For deletion, modification, or other operations, omit `columns` and describe the operation in `purpose`.\n- **Include seed data instructions in the `purpose` field.** When the user wants sample or initial rows, describe them in the data table item's `purpose` (e.g. \"Seed with 3 rows: ...\"). The data-table agent handles insertion.\n- **Each item's `purpose` must only describe what THAT item does.** Do not reference actions handled by other plan items. Each task is executed by an independent agent that only sees its own spec \u2014 cross-task context causes agents to perform work outside their scope.\n- Never fabricate node names \u2014 if unsure whether a node exists, search first.";

package/dist/tools/orchestration/plan-agent-prompt.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLANNER_AGENT_PROMPT = void 0;
+const node_selection_1 = require("@n8n/workflow-sdk/prompts/node-selection");
+exports.PLANNER_AGENT_PROMPT = `You are the n8n Workflow Planner — you design solution architectures. You do NOT build workflows.
+
+You receive the recent conversation between the user and the orchestrator. Read it to understand what the user wants, then design the blueprint.
+
+## Output Discipline
+- Be terse. You report to a parent orchestrator, not a human.
+- Do NOT produce code, node names, node configurations, or step-by-step node wiring.
+- Do NOT narrate ("I'll search for...", "Let me look up"). Just do the work.
+- No emojis, no filler, no markdown formatting in your reasoning.
+
+## Method
+
+1. **Prefer assumptions over questions.** The user is waiting for a plan, and they can reject it if your assumptions are wrong — so default to making reasonable choices rather than asking.
+   - **Never ask about things you can discover** — call \`list-credentials\`, \`list-data-tables\`, \`get-best-practices\` instead.
+   - **Never ask about implementation details** — trigger types, node choices, schedule times, column names. Pick sensible defaults.
+   - **Never default resource identifiers** the user didn't mention (Slack channels, calendars, spreadsheets, folders, etc.) — leave them for the builder to resolve at build time.
+   - **Do ask when the answer would significantly change the plan** — e.g. the user's goal is ambiguous ("build me a CRM" — for sales? support? recruiting?), or a business rule must come from the user ("what should happen when payment fails?").
+   - **List your assumptions** on your first \`add-plan-item\` call. The user reviews the plan before execution and can reject/correct.
+
+2. **Discover** (3-6 tool calls) — check what exists and learn best practices:
+   - \`get-best-practices\` for each relevant technique (e.g. "form_input", "scheduling", "data_persistence"). Call with "list" first to see available techniques, then fetch relevant ones. **This is important** — best practices inform your design decisions.
+   - \`get-suggested-nodes\` for the relevant categories
+   - \`list-data-tables\` to check for existing tables
+   - \`list-credentials\` if the request involves external services
+   - Skip searches for nodes you already know exist (webhooks, schedule triggers, data tables, code, set, filter, etc.)
+
+## Node Selection Reference
+
+Use these references when designing your plan — they help you pick the right trigger, prefer native nodes over Code, and correctly scope AI workflows.
+
+### AI Node Selection
+${node_selection_1.AI_NODE_SELECTION}
+
+### Node Selection by Use Case
+${node_selection_1.NODE_SELECTION_PATTERNS}
+
+### Trigger Selection
+${node_selection_1.TRIGGER_SELECTION}
+
+### Native Node Preference
+${node_selection_1.NATIVE_NODE_PREFERENCE}
+
+3. **Build incrementally** — call \`add-plan-item\` for each item:
+   - Emit data tables FIRST. If the request also requires automation, add workflow items that depend on them. A plan may consist entirely of data-table items.
+   - Set \`summary\` and \`assumptions\` on your first call
+   - Each call makes the item visible to the user immediately
+   - \`purpose\`: Write a rich, user-focused description of what this item delivers and why. Include key requirements and behaviors from the user's request. 3-5 sentences. Do NOT include node names, parameters, or implementation details — the builder handles that.
+   - \`triggerDescription\`: a few words describing trigger type (e.g. "Webhook POST", "Schedule daily"), no resource identifiers
+   - \`integrations\`: service names only (e.g. "Slack", "Google Calendar"), no resource identifiers or qualifiers
+   - \`dependsOn\`: **CRITICAL** — set dependencies correctly. Data tables before workflows that use them. Workflows that produce data before workflows that consume it. Independent workflows should NOT depend on each other.
+   - \`columns\`: name and type only — no descriptions
+   - \`assumptions\`: design decisions only, no resource identifiers (channels, calendars, etc.)
+   - Use \`research\` kind for tasks requiring web research before other tasks can proceed (e.g. "find the API endpoint format for service X"). Research tasks run a dedicated web research agent.
+   - After all items are added, call \`submit-plan\` to request user approval.
+
+4. **Handle approval** — \`submit-plan\` returns the user's decision:
+   - If \`approved: true\`: reply with "Plan approved." and stop.
+   - If \`approved: false\`: read the \`feedback\` field. Make targeted changes using \`remove-plan-item\` (to drop items) or \`add-plan-item\` (to add/replace items by ID). Then call \`submit-plan\` again. Repeat until approved.
+
+## Critical Rules
+
+- **Call \`add-plan-item\` for each item as you design it.** Data tables first, then workflows. 3-6 discovery tool calls then start emitting items.
+- **Always call \`submit-plan\` after your last \`add-plan-item\`.** Never end without submitting.
+- **On rejection, be surgical.** Only change what the user asked for. Do NOT re-add items that are already correct.
+- **Dependencies are mandatory.** Every workflow MUST list the data table IDs it reads from or writes to in \`dependsOn\`. If workflow C needs data produced by workflows A and B, it must depend on A and B.
+- **No duplicate items.** Each piece of work appears exactly once. Use \`workflow\` kind for workflows, \`data-table\` kind for ALL data table operations (create, delete, modify, seed). Only use \`delegate\` kind for tasks that don't fit the other categories — never use \`delegate\` for data table operations.
+- **Data-table-only plans are valid.** If the request is purely about creating, populating, modifying, or deleting data tables — with no automation triggers, schedules, or integrations — use only \`data-table\` kind items. Do NOT wrap table operations in a \`workflow\` or \`delegate\` item.
+- **\`data-table\` kind supports any table operation.** For creation, include \`columns\`. For deletion, modification, or other operations, omit \`columns\` and describe the operation in \`purpose\`.
+- **Include seed data instructions in the \`purpose\` field.** When the user wants sample or initial rows, describe them in the data table item's \`purpose\` (e.g. "Seed with 3 rows: ..."). The data-table agent handles insertion.
+- **Each item's \`purpose\` must only describe what THAT item does.** Do not reference actions handled by other plan items. Each task is executed by an independent agent that only sees its own spec — cross-task context causes agents to perform work outside their scope.
+- Never fabricate node names — if unsure whether a node exists, search first.`;
+//# sourceMappingURL=plan-agent-prompt.js.map

package/dist/tools/orchestration/plan-agent-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-agent-prompt.js","sourceRoot":"","sources":["../../../src/tools/orchestration/plan-agent-prompt.ts"],"names":[],"mappings":";;;AAAA,6EAKkD;AAErC,QAAA,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BlC,kCAAiB;;;EAGjB,wCAAuB;;;EAGvB,kCAAiB;;;EAGjB,uCAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8EA8BsD,CAAC"}

package/dist/tools/orchestration/plan-with-agent.tool.d.ts

@@ -0,0 +1,2 @@
+import type { OrchestrationContext } from '../../types';
+export declare function createPlanWithAgentTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<InferPublicSchema<T>, InferPublicSchema<T>, InferPublicSchema<T>, InferPublicSchema<T>, import("@mastra/core/tools").ToolExecutionContext<InferPublicSchema<T>, InferPublicSchema<T>, unknown>, "plan", unknown>;

package/dist/tools/orchestration/plan-with-agent.tool.js

@@ -0,0 +1,277 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlanWithAgentTool = createPlanWithAgentTool;
+const agent_1 = require("@mastra/core/agent");
+const tools_1 = require("@mastra/core/tools");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+const add_plan_item_tool_1 = require("./add-plan-item.tool");
+const blueprint_accumulator_1 = require("./blueprint-accumulator");
+const display_utils_1 = require("./display-utils");
+const plan_agent_prompt_1 = require("./plan-agent-prompt");
+const submit_plan_tool_1 = require("./submit-plan.tool");
+const tracing_utils_1 = require("./tracing-utils");
+const register_with_mastra_1 = require("../../agent/register-with-mastra");
+const resumable_stream_executor_1 = require("../../runtime/resumable-stream-executor");
+const consume_with_hitl_1 = require("../../stream/consume-with-hitl");
+const langsmith_tracing_1 = require("../../tracing/langsmith-tracing");
+const PLANNER_MAX_STEPS = 30;
+const MESSAGE_HISTORY_COUNT = 5;
+const PLANNER_DOMAIN_TOOL_NAMES = [
+    'search-nodes',
+    'get-suggested-nodes',
+    'get-best-practices',
+    'list-credentials',
+    'list-data-tables',
+    'get-data-table-schema',
+    'list-workflows',
+    'ask-user',
+];
+const PLANNER_RESEARCH_TOOL_NAMES = ['web-search', 'fetch-url'];
+function extractTextFromMemoryContent(content) {
+    if (typeof content === 'string')
+        return content;
+    if (isStructuredContent(content)) {
+        return extractTextParts(content.parts);
+    }
+    if (Array.isArray(content)) {
+        return extractTextParts(content);
+    }
+    return typeof content === 'object' && content !== null ? JSON.stringify(content) : '';
+}
+function isStructuredContent(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'parts' in value &&
+        Array.isArray(value.parts));
+}
+function extractTextParts(parts) {
+    return parts
+        .filter((c) => typeof c === 'object' && c !== null && 'text' in c)
+        .map((c) => c.text)
+        .join('\n');
+}
+async function getRecentMessages(context, count) {
+    const messages = [];
+    if (context.memory) {
+        try {
+            const result = await context.memory.recall({
+                threadId: context.threadId,
+                perPage: count,
+            });
+            for (const m of result.messages) {
+                const role = m.role;
+                const content = extractTextFromMemoryContent(m.content);
+                if ((role === 'user' || role === 'assistant') && content.length > 0) {
+                    messages.push({ role, content });
+                }
+            }
+        }
+        catch {
+        }
+    }
+    if (context.currentUserMessage) {
+        messages.push({ role: 'user', content: context.currentUserMessage });
+    }
+    return messages;
+}
+function formatMessagesForBriefing(messages, guidance) {
+    const parts = [];
+    if (messages.length > 0) {
+        parts.push('## Recent conversation');
+        for (const m of messages) {
+            const label = m.role === 'user' ? 'User' : 'Assistant';
+            const content = m.content.length > 2000 ? m.content.slice(0, 2000) + '...' : m.content;
+            parts.push(`**${label}:** ${content}`);
+        }
+    }
+    if (guidance) {
+        parts.push(`\n## Orchestrator guidance\n${guidance}`);
+    }
+    parts.push('\nDesign the solution blueprint based on the conversation above.');
+    return parts.join('\n\n');
+}
+function publishClearingEvent(context) {
+    context.eventBus.publish(context.threadId, {
+        type: 'tasks-update',
+        runId: context.runId,
+        agentId: context.orchestratorAgentId,
+        payload: { tasks: { tasks: [] }, planItems: [] },
+    });
+}
+async function clearDraftChecklist(context) {
+    try {
+        await context.taskStorage.save(context.threadId, { tasks: [] });
+    }
+    catch {
+    }
+}
+function createPlanWithAgentTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'plan',
+        description: 'Design and execute a multi-step plan. Spawns a planner agent that reads ' +
+            'the conversation history, discovers available credentials, data tables, ' +
+            'and best practices, designs the architecture, and shows it to the user ' +
+            'for approval. Use when the request requires 2 or more tasks with ' +
+            'dependencies. When this tool returns, the plan is already approved ' +
+            'and tasks are dispatched — just acknowledge briefly and end your turn.',
+        inputSchema: zod_1.z.object({
+            guidance: zod_1.z
+                .string()
+                .optional()
+                .describe('Optional steering note for the planner — use ONLY when the conversation ' +
+                'history alone is ambiguous about what to build. The planner reads the ' +
+                'last 5 messages directly, so do NOT rewrite the user request here.'),
+        }),
+        outputSchema: zod_1.z.object({
+            result: zod_1.z.string(),
+        }),
+        execute: async (input) => {
+            const plannerTools = {};
+            for (const name of PLANNER_DOMAIN_TOOL_NAMES) {
+                if (name in context.domainTools) {
+                    plannerTools[name] = context.domainTools[name];
+                }
+            }
+            for (const name of PLANNER_RESEARCH_TOOL_NAMES) {
+                if (name in context.domainTools) {
+                    plannerTools[name] = context.domainTools[name];
+                }
+            }
+            const accumulator = new blueprint_accumulator_1.BlueprintAccumulator();
+            plannerTools['add-plan-item'] = (0, add_plan_item_tool_1.createAddPlanItemTool)(accumulator, context);
+            plannerTools['remove-plan-item'] = (0, add_plan_item_tool_1.createRemovePlanItemTool)(accumulator, context);
+            plannerTools['submit-plan'] = (0, submit_plan_tool_1.createSubmitPlanTool)(accumulator, context);
+            const messages = await getRecentMessages(context, MESSAGE_HISTORY_COUNT);
+            const briefing = formatMessagesForBriefing(messages, input.guidance);
+            const subAgentId = `agent-planner-${(0, nanoid_1.nanoid)(6)}`;
+            const subtitle = input.guidance ?? messages.find((m) => m.role === 'user')?.content ?? 'Planning...';
+            context.eventBus.publish(context.threadId, {
+                type: 'agent-spawned',
+                runId: context.runId,
+                agentId: subAgentId,
+                payload: {
+                    parentId: context.orchestratorAgentId,
+                    role: 'planner',
+                    tools: Object.keys(plannerTools),
+                    kind: 'planner',
+                    title: 'Planning',
+                    subtitle: (0, display_utils_1.truncateLabel)(subtitle),
+                    goal: briefing,
+                },
+            });
+            const traceRun = await (0, tracing_utils_1.startSubAgentTrace)(context, {
+                agentId: subAgentId,
+                role: 'planner',
+                kind: 'planner',
+                inputs: {
+                    guidance: input.guidance,
+                    messageCount: messages.length,
+                },
+            });
+            const tracedPlannerTools = (0, tracing_utils_1.traceSubAgentTools)(context, plannerTools, 'planner');
+            try {
+                const subAgent = new agent_1.Agent({
+                    id: subAgentId,
+                    name: 'Workflow Planner Agent',
+                    instructions: {
+                        role: 'system',
+                        content: plan_agent_prompt_1.PLANNER_AGENT_PROMPT,
+                        providerOptions: {
+                            anthropic: { cacheControl: { type: 'ephemeral' } },
+                        },
+                    },
+                    model: context.modelId,
+                    tools: tracedPlannerTools,
+                });
+                (0, register_with_mastra_1.registerWithMastra)(subAgentId, subAgent, context.storage);
+                const resultText = await (0, tracing_utils_1.withTraceRun)(context, traceRun, async () => {
+                    const traceParent = (0, langsmith_tracing_1.getTraceParentRun)();
+                    return await (0, langsmith_tracing_1.withTraceParentContext)(traceParent, async () => {
+                        const llmStepTraceHooks = (0, resumable_stream_executor_1.createLlmStepTraceHooks)(traceParent);
+                        const stream = await subAgent.stream(briefing, {
+                            maxSteps: PLANNER_MAX_STEPS,
+                            abortSignal: context.abortSignal,
+                            providerOptions: {
+                                anthropic: { cacheControl: { type: 'ephemeral' } },
+                            },
+                            ...(llmStepTraceHooks?.executionOptions ?? {}),
+                        });
+                        const result = await (0, consume_with_hitl_1.consumeStreamWithHitl)({
+                            agent: subAgent,
+                            stream: stream,
+                            runId: context.runId,
+                            agentId: subAgentId,
+                            eventBus: context.eventBus,
+                            logger: context.logger,
+                            threadId: context.threadId,
+                            abortSignal: context.abortSignal,
+                            waitForConfirmation: context.waitForConfirmation,
+                            llmStepTraceHooks,
+                            maxSteps: PLANNER_MAX_STEPS,
+                        });
+                        return await result.text;
+                    });
+                });
+                await (0, tracing_utils_1.finishTraceRun)(context, traceRun, {
+                    outputs: {
+                        result: resultText,
+                        agentId: subAgentId,
+                        role: 'planner',
+                        hasItems: !accumulator.isEmpty(),
+                        itemCount: accumulator.getTaskItemsForEvent().length,
+                    },
+                });
+                context.eventBus.publish(context.threadId, {
+                    type: 'agent-completed',
+                    runId: context.runId,
+                    agentId: subAgentId,
+                    payload: {
+                        role: 'planner',
+                        result: resultText,
+                    },
+                });
+                if (accumulator.isApproved()) {
+                    if (context.schedulePlannedTasks) {
+                        await context.schedulePlannedTasks();
+                    }
+                    const taskCount = accumulator.getTaskList().length;
+                    return {
+                        result: `Plan approved and ${taskCount} task${taskCount === 1 ? '' : 's'} dispatched.`,
+                    };
+                }
+                publishClearingEvent(context);
+                await clearDraftChecklist(context);
+                if (!accumulator.isEmpty()) {
+                    return {
+                        result: `Planner added ${accumulator.getTaskList().length} items but did not submit the plan for approval. The plan was not executed.`,
+                    };
+                }
+                return {
+                    result: `Planner finished without producing a plan. Agent output: ${resultText}`,
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                await (0, tracing_utils_1.failTraceRun)(context, traceRun, error, {
+                    agent_id: subAgentId,
+                    agent_role: 'planner',
+                });
+                context.eventBus.publish(context.threadId, {
+                    type: 'agent-completed',
+                    runId: context.runId,
+                    agentId: subAgentId,
+                    payload: {
+                        role: 'planner',
+                        result: '',
+                        error: errorMessage,
+                    },
+                });
+                publishClearingEvent(context);
+                await clearDraftChecklist(context);
+                return { result: `Planner error: ${errorMessage}` };
+            }
+        },
+    });
+}
+//# sourceMappingURL=plan-with-agent.tool.js.map

package/dist/tools/orchestration/plan-with-agent.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-with-agent.tool.js","sourceRoot":"","sources":["../../../src/tools/orchestration/plan-with-agent.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/orchestration/plan.tool.d.ts

@@ -1,45 +1,13 @@
+import { z } from 'zod';
 import type { OrchestrationContext } from '../../types';
-export declare function createPlanTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
-    tasks: {
-        id: string;
-        title: string;
-        kind: "delegate" | "build-workflow" | "manage-data-tables" | "research";
-        spec: string;
-        deps: string[];
-        workflowId?: string | undefined;
-        tools?: string[] | undefined;
-    }[];
-}, {
-    result: string;
-    taskCount: number;
-}, {
-    message: string;
-    requestId: string;
-    severity: "info";
-    inputType: "plan-review";
-    tasks: {
-        tasks: {
-            status: "cancelled" | "failed" | "todo" | "in_progress" | "done";
-            id: string;
-            description: string;
-        }[];
-    };
-}, {
+export declare const planResumeSchema: z.ZodObject<{
+    approved: z.ZodBoolean;
+    userInput: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
     approved: boolean;
     userInput?: string | undefined;
-}, import("@mastra/core/tools").ToolExecutionContext<{
-    message: string;
-    requestId: string;
-    severity: "info";
-    inputType: "plan-review";
-    tasks: {
-        tasks: {
-            status: "cancelled" | "failed" | "todo" | "in_progress" | "done";
-            id: string;
-            description: string;
-        }[];
-    };
 }, {
     approved: boolean;
     userInput?: string | undefined;
-}, unknown>, "plan", unknown>;
+}>;
+export declare function createPlanTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<InferPublicSchema<T>, InferPublicSchema<T>, InferPublicSchema<T>, InferPublicSchema<T>, import("@mastra/core/tools").ToolExecutionContext<InferPublicSchema<T>, InferPublicSchema<T>, unknown>, "create-tasks", unknown>;

package/dist/tools/orchestration/plan.tool.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.planResumeSchema = void 0;
 exports.createPlanTool = createPlanTool;
 const tools_1 = require("@mastra/core/tools");
 const api_types_1 = require("@n8n/api-types");
@@ -27,15 +28,18 @@ const planOutputSchema = zod_1.z.object({
     result: zod_1.z.string(),
     taskCount: zod_1.z.number(),
 });
+exports.planResumeSchema = zod_1.z.object({
+    approved: zod_1.z.boolean(),
+    userInput: zod_1.z.string().optional(),
+});
 function createPlanTool(context) {
     return (0, tools_1.createTool)({
-        id: 'plan',
-        description: 'Persist a dependency-aware task plan for detached multi-step execution. ' +
-            'Use ONLY when the work requires 2 or more tasks with dependencies ' +
-            '(e.g. data table setup + multiple workflows, parallel builds + consolidation). ' +
-            'Do NOT use for single workflow builds — call build-workflow-with-agent directly instead. ' +
-            'The plan is shown to the user for approval before execution starts. ' +
-            'After calling plan, reply briefly and end your turn.',
+        id: 'create-tasks',
+        description: 'Submit a pre-built task list for detached multi-step execution. ' +
+            'Use ONLY for replanning after a failure — when you already have the task context ' +
+            'and do not need resource discovery. For initial planning, call `plan` instead. ' +
+            'The task list is shown to the user for approval before execution starts. ' +
+            'After calling create-tasks, reply briefly and end your turn.',
         inputSchema: planInputSchema,
         outputSchema: planOutputSchema,
         suspendSchema: zod_1.z.object({
@@ -45,10 +49,7 @@ function createPlanTool(context) {
             inputType: zod_1.z.literal('plan-review'),
             tasks: api_types_1.taskListSchema,
         }),
-        resumeSchema: zod_1.z.object({
-            approved: zod_1.z.boolean(),
-            userInput: zod_1.z.string().optional(),
-        }),
+        resumeSchema: exports.planResumeSchema,
         execute: async (input, ctx) => {
             if (!context.plannedTaskService || !context.schedulePlannedTasks) {
                 return {
@@ -56,7 +57,8 @@ function createPlanTool(context) {
                     taskCount: 0,
                 };
             }
-            const { resumeData, suspend } = ctx?.agent ?? {};
+            const resumeData = ctx?.agent?.resumeData;
+            const suspend = ctx?.agent?.suspend;
             if (resumeData === undefined || resumeData === null) {
                 await context.plannedTaskService.createPlan(context.threadId, input.tasks, {
                     planRunId: context.runId,
@@ -90,7 +92,7 @@ function createPlanTool(context) {
                 };
             }
             return {
-                result: `User requested changes: ${resumeData.userInput ?? 'No feedback provided'}. Revise the plan and call plan() again.`,
+                result: `User requested changes: ${resumeData.userInput ?? 'No feedback provided'}. Revise the tasks and call create-tasks again.`,
                 taskCount: 0,
             };
         },

package/dist/tools/orchestration/plan.tool.js.map

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

package/dist/tools/orchestration/report-verification-verdict.tool.d.ts

@@ -1,5 +1,16 @@
+import { z } from 'zod';
 import type { OrchestrationContext } from '../../types';
-export declare function createReportVerificationVerdictTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
+export declare const reportVerificationVerdictInputSchema: z.ZodObject<{
+    workItemId: z.ZodString;
+    workflowId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    verdict: z.ZodEnum<["verified", "needs_patch", "needs_rebuild", "trigger_only", "needs_user_input", "failed_terminal"]>;
+    failureSignature: z.ZodOptional<z.ZodString>;
+    failedNodeName: z.ZodOptional<z.ZodString>;
+    diagnosis: z.ZodOptional<z.ZodString>;
+    patch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
     workItemId: string;
     workflowId: string;
     summary: string;
@@ -10,5 +21,14 @@ export declare function createReportVerificationVerdictTool(context: Orchestrati
     failureSignature?: string | undefined;
     failedNodeName?: string | undefined;
 }, {
-    guidance: string;
-}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "report-verification-verdict", unknown>;
+    workItemId: string;
+    workflowId: string;
+    summary: string;
+    verdict: "trigger_only" | "verified" | "needs_patch" | "needs_rebuild" | "needs_user_input" | "failed_terminal";
+    diagnosis?: string | undefined;
+    patch?: Record<string, unknown> | undefined;
+    executionId?: string | undefined;
+    failureSignature?: string | undefined;
+    failedNodeName?: string | undefined;
+}>;
+export declare function createReportVerificationVerdictTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<InferPublicSchema<T>, InferPublicSchema<T>, InferPublicSchema<T>, InferPublicSchema<T>, import("@mastra/core/tools").ToolExecutionContext<InferPublicSchema<T>, InferPublicSchema<T>, unknown>, "report-verification-verdict", unknown>;