@n8n/instance-ai 1.0.0

package/dist/tools/orchestration/build-workflow-agent.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-workflow-agent.prompt.js","sourceRoot":"","sources":["../../../src/tools/orchestration/build-workflow-agent.prompt.ts"],"names":[],"mappings":";;;AA6hBA,0EAuTC;AA50BD,6DAKgC;AAIhC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;EAY7B,iCAAc;;;;EAId,wCAAqB;;;;EAIrB,uCAAoB;;;;EAIpB,uCAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2FA2bqE,CAAC;AAI/E,QAAA,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDlC,sBAAsB;CACvB,CAAC;AAIF,SAAgB,+BAA+B,CAAC,aAAqB;IACpE,OAAO;;;;;;;;;;;0BAWkB,aAAa,6DAA6D,aAAa;;;EAG/G,aAAa;;;;;;;;;;;;;;;;;;KAkBV,aAAa;;;;;;;;;;;;;;;KAeb,aAAa;;;;;;;;;;;;;;;;;;;;;KAqBb,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAqDb,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAoHoB,aAAa;;;;;;;;;;;;kCAYjB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;6BAwBlB,aAAa;;;;sCAIJ,aAAa;;;;;;;;yFAQsC,aAAa;;;;;;;;;;;;;;;;;;;;;;;EAuBpG,sBAAsB;CACvB,CAAC;AACF,CAAC"}

package/dist/tools/orchestration/build-workflow-agent.tool.d.ts

@@ -0,0 +1,23 @@
+import type { OrchestrationContext } from '../../types';
+export interface StartBuildWorkflowAgentInput {
+    task: string;
+    workflowId?: string;
+    conversationContext?: string;
+    taskId?: string;
+    agentId?: string;
+    plannedTaskId?: string;
+}
+export interface StartedWorkflowBuildTask {
+    result: string;
+    taskId: string;
+    agentId: string;
+}
+export declare function startBuildWorkflowAgentTask(context: OrchestrationContext, input: StartBuildWorkflowAgentInput): Promise<StartedWorkflowBuildTask>;
+export declare function createBuildWorkflowAgentTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
+    task: string;
+    workflowId?: string | undefined;
+    conversationContext?: string | undefined;
+}, {
+    result: string;
+    taskId: string;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "build-workflow-with-agent", unknown>;

package/dist/tools/orchestration/build-workflow-agent.tool.js

@@ -0,0 +1,503 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startBuildWorkflowAgentTask = startBuildWorkflowAgentTask;
+exports.createBuildWorkflowAgentTool = createBuildWorkflowAgentTool;
+const agent_1 = require("@mastra/core/agent");
+const tools_1 = require("@mastra/core/tools");
+const workflow_sdk_1 = require("@n8n/workflow-sdk");
+const nanoid_1 = require("nanoid");
+const node_crypto_1 = require("node:crypto");
+const zod_1 = require("zod");
+const browser_credential_setup_tool_1 = require("./browser-credential-setup.tool");
+const build_workflow_agent_prompt_1 = require("./build-workflow-agent.prompt");
+const display_utils_1 = require("./display-utils");
+const tracing_utils_1 = require("./tracing-utils");
+const verify_built_workflow_tool_1 = require("./verify-built-workflow.tool");
+const register_with_mastra_1 = require("../../agent/register-with-mastra");
+const resumable_stream_executor_1 = require("../../runtime/resumable-stream-executor");
+const working_memory_tracing_1 = require("../../runtime/working-memory-tracing");
+const iteration_log_1 = require("../../storage/iteration-log");
+const consume_with_hitl_1 = require("../../stream/consume-with-hitl");
+const langsmith_tracing_1 = require("../../tracing/langsmith-tracing");
+const extract_code_1 = require("../../workflow-builder/extract-code");
+const sandbox_fs_1 = require("../../workspace/sandbox-fs");
+const sandbox_setup_1 = require("../../workspace/sandbox-setup");
+const apply_workflow_credentials_tool_1 = require("../workflows/apply-workflow-credentials.tool");
+const resolve_credentials_1 = require("../workflows/resolve-credentials");
+const submit_workflow_tool_1 = require("../workflows/submit-workflow.tool");
+const UNTESTABLE_TRIGGERS = new Set([
+    'n8n-nodes-base.webhook',
+    'n8n-nodes-base.formTrigger',
+    '@n8n/n8n-nodes-langchain.mcpTrigger',
+    '@n8n/n8n-nodes-langchain.chatTrigger',
+]);
+function triggerLabel(nodeType) {
+    const short = nodeType.split('.').pop() ?? nodeType;
+    return short.replace(/Trigger$/i, '').toLowerCase() || short.toLowerCase();
+}
+const UNTESTABLE_TRIGGER_LABELS = [...UNTESTABLE_TRIGGERS].map(triggerLabel).join(', ');
+function detectTriggerType(attempt) {
+    if (!attempt?.triggerNodeTypes || attempt.triggerNodeTypes.length === 0) {
+        return 'manual_or_testable';
+    }
+    const allUntestable = attempt.triggerNodeTypes.every((t) => UNTESTABLE_TRIGGERS.has(t));
+    return allUntestable ? 'trigger_only' : 'manual_or_testable';
+}
+function buildOutcome(workItemId, taskId, attempt, finalText) {
+    if (!attempt?.success) {
+        return {
+            workItemId,
+            taskId,
+            submitted: false,
+            triggerType: 'manual_or_testable',
+            needsUserInput: false,
+            failureSignature: attempt?.errors?.join('; '),
+            summary: finalText,
+        };
+    }
+    return {
+        workItemId,
+        taskId,
+        workflowId: attempt.workflowId,
+        submitted: true,
+        triggerType: detectTriggerType(attempt),
+        needsUserInput: false,
+        mockedNodeNames: attempt.mockedNodeNames,
+        mockedCredentialTypes: attempt.mockedCredentialTypes,
+        mockedCredentialsByNode: attempt.mockedCredentialsByNode,
+        verificationPinData: attempt.verificationPinData,
+        summary: finalText,
+    };
+}
+const BUILDER_MAX_STEPS = 30;
+const DETACHED_BUILDER_REQUIREMENTS = `## Detached Task Contract
+
+You are running as a detached background task. Do not stop after a successful submit — verify the workflow works.
+
+### Completion criteria
+
+Your job is done when ONE of these is true:
+- the workflow is verified (ran successfully or publish-workflow succeeded)
+- the workflow uses only event triggers (${UNTESTABLE_TRIGGER_LABELS}) and cannot be runtime-tested — publish it and stop
+- you are blocked after one repair attempt per unique failure
+
+### Submit discipline
+
+**Every file edit MUST be followed by submit-workflow before you do anything else.**
+The system tracks file hashes. If you edit the code and then call publish-workflow, run-workflow, or finish without re-submitting, your work is discarded. The sequence is always: edit → submit → then verify/publish.
+
+### Verification
+
+- If submit-workflow returned mocked credentials, call verify-built-workflow with the workItemId
+- Otherwise call run-workflow to test (skip for trigger-only workflows)
+- If verification fails, call debug-execution, fix the code, re-submit, and retry once
+- If the same failure signature repeats, stop and explain the block
+
+### Credential finalization
+
+If verification succeeds with mocked credentials:
+1. call setup-credentials with credentialFlow stage "finalize"
+2. if it returns needsBrowserSetup=true, call browser-credential-setup then setup-credentials again
+3. call apply-workflow-credentials with the workItemId and selected credentials
+
+### Resource discovery
+
+Before writing code that uses external services, **resolve real resource IDs**:
+- Call explore-node-resources for any parameter with searchListMethod (calendars, spreadsheets, channels, models, etc.)
+- Do NOT use "primary", "default", or any assumed identifier — look up the actual value
+- Call get-suggested-nodes early if the workflow fits a known category (web_app, form_input, data_persistence, etc.) — the pattern hints prevent common mistakes
+- Check @builderHint annotations in node type definitions for critical configuration guidance
+
+### Publish validation errors
+
+If publish-workflow fails with node configuration issues, the error tells you which node and what's wrong. Fix the parameter, re-submit, then try publishing again. Common causes:
+- Resource list parameters (calendar, spreadsheet) need a real ID from explore-node-resources, not "primary"
+- Expression parameters need the correct n8n expression syntax
+- Required parameters missing from the node config
+`;
+function hashContent(content) {
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(content ?? '', 'utf8')
+        .digest('hex');
+}
+async function startBuildWorkflowAgentTask(context, input) {
+    if (!context.spawnBackgroundTask) {
+        return {
+            result: 'Error: background task support not available.',
+            taskId: '',
+            agentId: '',
+        };
+    }
+    const factory = context.builderSandboxFactory;
+    const domainContext = context.domainContext;
+    const useSandbox = !!factory && !!domainContext;
+    let builderTools;
+    let prompt = build_workflow_agent_prompt_1.BUILDER_AGENT_PROMPT;
+    let credMap;
+    if (useSandbox) {
+        credMap = await (0, resolve_credentials_1.buildCredentialMap)(domainContext.credentialService);
+        const toolNames = [
+            'search-nodes',
+            'get-suggested-nodes',
+            'get-workflow-as-code',
+            'get-node-type-definition',
+            'explore-node-resources',
+            'list-workflows',
+            'list-credentials',
+            'test-credential',
+            'setup-credentials',
+            'ask-user',
+            'run-workflow',
+            'get-execution',
+            'debug-execution',
+            'publish-workflow',
+            'unpublish-workflow',
+            'list-data-tables',
+            'create-data-table',
+            'get-data-table-schema',
+            'add-data-table-column',
+            'query-data-table-rows',
+            'insert-data-table-rows',
+        ];
+        builderTools = {};
+        for (const name of toolNames) {
+            if (context.domainTools[name]) {
+                builderTools[name] = context.domainTools[name];
+            }
+        }
+        if (context.workflowTaskService && context.domainContext) {
+            builderTools['verify-built-workflow'] = (0, verify_built_workflow_tool_1.createVerifyBuiltWorkflowTool)(context);
+            builderTools['apply-workflow-credentials'] = (0, apply_workflow_credentials_tool_1.createApplyWorkflowCredentialsTool)(context);
+        }
+        if (context.browserMcpConfig) {
+            builderTools['browser-credential-setup'] = (0, browser_credential_setup_tool_1.createBrowserCredentialSetupTool)(context);
+        }
+    }
+    else {
+        builderTools = {};
+        const toolNames = [
+            'build-workflow',
+            'get-node-type-definition',
+            'get-workflow-as-code',
+            'list-workflows',
+            'search-nodes',
+            'get-suggested-nodes',
+            'ask-user',
+            'list-data-tables',
+            'create-data-table',
+            'get-data-table-schema',
+            'add-data-table-column',
+            'query-data-table-rows',
+            'insert-data-table-rows',
+            ...(context.researchMode ? ['web-search', 'fetch-url'] : []),
+        ];
+        for (const name of toolNames) {
+            if (name in context.domainTools) {
+                builderTools[name] = context.domainTools[name];
+            }
+        }
+        if (!builderTools['build-workflow']) {
+            return { result: 'Error: build-workflow tool not available.', taskId: '', agentId: '' };
+        }
+    }
+    const subAgentId = input.agentId ?? `agent-builder-${(0, nanoid_1.nanoid)(6)}`;
+    const taskId = input.taskId ?? `build-${(0, nanoid_1.nanoid)(8)}`;
+    const workItemId = `wi_${(0, nanoid_1.nanoid)(8)}`;
+    context.eventBus.publish(context.threadId, {
+        type: 'agent-spawned',
+        runId: context.runId,
+        agentId: subAgentId,
+        payload: {
+            parentId: context.orchestratorAgentId,
+            role: 'workflow-builder',
+            tools: Object.keys(builderTools),
+            taskId,
+            kind: 'builder',
+            title: 'Building workflow',
+            subtitle: (0, display_utils_1.truncateLabel)(input.task),
+            goal: input.task,
+            targetResource: input.workflowId
+                ? { type: 'workflow', id: input.workflowId }
+                : { type: 'workflow' },
+        },
+    });
+    const { workflowId } = input;
+    let iterationContext = '';
+    if (context.iterationLog) {
+        const taskKey = `build:${workflowId ?? 'new'}`;
+        try {
+            const entries = await context.iterationLog.getForTask(context.threadId, taskKey);
+            iterationContext = (0, iteration_log_1.formatPreviousAttempts)(entries);
+        }
+        catch {
+        }
+    }
+    const conversationCtx = input.conversationContext
+        ? `\n\n[CONVERSATION CONTEXT: ${input.conversationContext}]`
+        : '';
+    let briefing;
+    if (useSandbox) {
+        if (workflowId) {
+            briefing = `${input.task}${conversationCtx}\n\n[CONTEXT: Modifying existing workflow ${workflowId}. The current code is pre-loaded in ~/workspace/src/workflow.ts — read it first, then edit. Use workflowId "${workflowId}" when calling submit-workflow.]\n\n[WORK ITEM ID: ${workItemId}]\n\n${DETACHED_BUILDER_REQUIREMENTS}${iterationContext ? `\n\n${iterationContext}` : ''}`;
+        }
+        else {
+            briefing = `${input.task}${conversationCtx}\n\n[WORK ITEM ID: ${workItemId}]\n\n${DETACHED_BUILDER_REQUIREMENTS}${iterationContext ? `\n\n${iterationContext}` : ''}`;
+        }
+    }
+    else if (workflowId) {
+        briefing = `${input.task}${conversationCtx}\n\n[CONTEXT: Modifying existing workflow ${workflowId}. Use workflowId "${workflowId}" when calling build-workflow.]${iterationContext ? `\n\n${iterationContext}` : ''}`;
+    }
+    else {
+        briefing = `${input.task}${conversationCtx}${iterationContext ? `\n\n${iterationContext}` : ''}`;
+    }
+    const traceContext = await (0, tracing_utils_1.createDetachedSubAgentTracing)(context, {
+        agentId: subAgentId,
+        role: 'workflow-builder',
+        kind: 'builder',
+        taskId,
+        plannedTaskId: input.plannedTaskId,
+        workItemId,
+        inputs: {
+            task: input.task,
+            workflowId: input.workflowId,
+            conversationContext: input.conversationContext,
+        },
+    });
+    context.spawnBackgroundTask({
+        taskId,
+        threadId: context.threadId,
+        agentId: subAgentId,
+        role: 'workflow-builder',
+        traceContext,
+        plannedTaskId: input.plannedTaskId,
+        workItemId,
+        run: async (signal, drainCorrections) => await (0, tracing_utils_1.withTraceContextActor)(traceContext, async () => {
+            let builderWs;
+            const submitAttempts = new Map();
+            try {
+                if (useSandbox) {
+                    builderWs = await factory.create(subAgentId, domainContext);
+                    const workspace = builderWs.workspace;
+                    const root = await (0, sandbox_setup_1.getWorkspaceRoot)(workspace);
+                    prompt = (0, build_workflow_agent_prompt_1.createSandboxBuilderAgentPrompt)(root);
+                    if (workflowId && domainContext) {
+                        try {
+                            const json = await domainContext.workflowService.getAsWorkflowJSON(workflowId);
+                            let rawCode = (0, workflow_sdk_1.generateWorkflowCode)(json);
+                            rawCode = rawCode.replace(/newCredential\('([^']*)',\s*'[^']*'\)/g, "newCredential('$1')");
+                            const code = `${extract_code_1.SDK_IMPORT_STATEMENT}\n\n${rawCode}`;
+                            if (workspace.filesystem) {
+                                await workspace.filesystem.writeFile(`${root}/src/workflow.ts`, code, {
+                                    recursive: true,
+                                });
+                            }
+                        }
+                        catch {
+                        }
+                    }
+                    const mainWorkflowPath = `${root}/src/workflow.ts`;
+                    builderTools['submit-workflow'] = (0, submit_workflow_tool_1.createSubmitWorkflowTool)(domainContext, workspace, credMap, async (attempt) => {
+                        submitAttempts.set(attempt.filePath, attempt);
+                        if (attempt.filePath !== mainWorkflowPath || !context.workflowTaskService) {
+                            return;
+                        }
+                        await context.workflowTaskService.reportBuildOutcome(buildOutcome(workItemId, taskId, attempt, attempt.success
+                            ? 'Workflow submitted and ready for verification.'
+                            : (attempt.errors?.join(' ') ?? 'Workflow submission failed.')));
+                    });
+                    const tracedBuilderTools = (0, tracing_utils_1.traceSubAgentTools)(context, builderTools, 'workflow-builder');
+                    const subAgent = new agent_1.Agent({
+                        id: subAgentId,
+                        name: 'Workflow Builder Agent',
+                        instructions: {
+                            role: 'system',
+                            content: prompt,
+                            providerOptions: {
+                                anthropic: { cacheControl: { type: 'ephemeral' } },
+                            },
+                        },
+                        model: context.modelId,
+                        tools: tracedBuilderTools,
+                        workspace,
+                    });
+                    (0, langsmith_tracing_1.mergeTraceRunInputs)(traceContext?.actorRun, (0, langsmith_tracing_1.buildAgentTraceInputs)({
+                        systemPrompt: prompt,
+                        tools: tracedBuilderTools,
+                        modelId: context.modelId,
+                    }));
+                    (0, register_with_mastra_1.registerWithMastra)(subAgentId, subAgent, context.storage);
+                    const traceParent = (0, langsmith_tracing_1.getTraceParentRun)();
+                    const hitlResult = await (0, langsmith_tracing_1.withTraceParentContext)(traceParent, async () => {
+                        const llmStepTraceHooks = (0, resumable_stream_executor_1.createLlmStepTraceHooks)(traceParent);
+                        const stream = await (0, working_memory_tracing_1.traceWorkingMemoryContext)({
+                            phase: 'initial',
+                            agentId: subAgentId,
+                            agentRole: 'workflow-builder',
+                            threadId: context.threadId,
+                            input: briefing,
+                        }, async () => await subAgent.stream(briefing, {
+                            maxSteps: BUILDER_MAX_STEPS,
+                            abortSignal: signal,
+                            providerOptions: {
+                                anthropic: { cacheControl: { type: 'ephemeral' } },
+                            },
+                            ...(llmStepTraceHooks?.executionOptions ?? {}),
+                        }));
+                        return await (0, consume_with_hitl_1.consumeStreamWithHitl)({
+                            agent: subAgent,
+                            stream: stream,
+                            runId: context.runId,
+                            agentId: subAgentId,
+                            eventBus: context.eventBus,
+                            threadId: context.threadId,
+                            abortSignal: signal,
+                            waitForConfirmation: context.waitForConfirmation,
+                            drainCorrections,
+                            llmStepTraceHooks,
+                            workingMemoryEnabled: false,
+                        });
+                    });
+                    const finalText = await hitlResult.text;
+                    const mainWorkflowAttempt = submitAttempts.get(mainWorkflowPath);
+                    const currentMainWorkflow = await (0, sandbox_fs_1.readFileViaSandbox)(workspace, mainWorkflowPath);
+                    const currentMainWorkflowHash = hashContent(currentMainWorkflow);
+                    if (!mainWorkflowAttempt) {
+                        const text = 'Error: workflow builder finished without submitting /src/workflow.ts.';
+                        return {
+                            text,
+                            outcome: buildOutcome(workItemId, taskId, undefined, text),
+                        };
+                    }
+                    if (!mainWorkflowAttempt.success) {
+                        const errorText = mainWorkflowAttempt.errors?.join(' ') ?? 'Unknown submit-workflow failure.';
+                        const text = `Error: workflow builder stopped after a failed submit-workflow for /src/workflow.ts. ${errorText}`;
+                        return {
+                            text,
+                            outcome: buildOutcome(workItemId, taskId, mainWorkflowAttempt, text),
+                        };
+                    }
+                    if (mainWorkflowAttempt.sourceHash !== currentMainWorkflowHash) {
+                        const submitTool = tracedBuilderTools['submit-workflow'];
+                        if (submitTool && 'execute' in submitTool) {
+                            const resubmit = await submitTool.execute({
+                                filePath: mainWorkflowPath,
+                                workflowId: mainWorkflowAttempt.workflowId,
+                            });
+                            const refreshedAttempt = submitAttempts.get(mainWorkflowPath);
+                            if (refreshedAttempt?.success) {
+                                return {
+                                    text: finalText,
+                                    outcome: buildOutcome(workItemId, taskId, refreshedAttempt, finalText),
+                                };
+                            }
+                            const resubmitErrors = refreshedAttempt?.errors?.join(' ') ??
+                                (typeof resubmit?.errors === 'string'
+                                    ? resubmit.errors
+                                    : 'Auto-re-submit failed.');
+                            const text = `Error: auto-re-submit of edited /src/workflow.ts failed. ${resubmitErrors}`;
+                            return {
+                                text,
+                                outcome: buildOutcome(workItemId, taskId, refreshedAttempt ?? undefined, text),
+                            };
+                        }
+                    }
+                    return {
+                        text: finalText,
+                        outcome: buildOutcome(workItemId, taskId, mainWorkflowAttempt, finalText),
+                    };
+                }
+                const tracedBuilderTools = (0, tracing_utils_1.traceSubAgentTools)(context, builderTools, 'workflow-builder');
+                const subAgent = new agent_1.Agent({
+                    id: subAgentId,
+                    name: 'Workflow Builder Agent',
+                    instructions: {
+                        role: 'system',
+                        content: prompt,
+                        providerOptions: {
+                            anthropic: { cacheControl: { type: 'ephemeral' } },
+                        },
+                    },
+                    model: context.modelId,
+                    tools: tracedBuilderTools,
+                });
+                (0, langsmith_tracing_1.mergeTraceRunInputs)(traceContext?.actorRun, (0, langsmith_tracing_1.buildAgentTraceInputs)({
+                    systemPrompt: prompt,
+                    tools: tracedBuilderTools,
+                    modelId: context.modelId,
+                }));
+                (0, register_with_mastra_1.registerWithMastra)(subAgentId, subAgent, context.storage);
+                const traceParent = (0, langsmith_tracing_1.getTraceParentRun)();
+                const hitlResult = await (0, langsmith_tracing_1.withTraceParentContext)(traceParent, async () => {
+                    const llmStepTraceHooks = (0, resumable_stream_executor_1.createLlmStepTraceHooks)(traceParent);
+                    const stream = await (0, working_memory_tracing_1.traceWorkingMemoryContext)({
+                        phase: 'initial',
+                        agentId: subAgentId,
+                        agentRole: 'workflow-builder',
+                        threadId: context.threadId,
+                        input: briefing,
+                    }, async () => await subAgent.stream(briefing, {
+                        maxSteps: BUILDER_MAX_STEPS,
+                        abortSignal: signal,
+                        providerOptions: {
+                            anthropic: { cacheControl: { type: 'ephemeral' } },
+                        },
+                        ...(llmStepTraceHooks?.executionOptions ?? {}),
+                    }));
+                    return await (0, consume_with_hitl_1.consumeStreamWithHitl)({
+                        agent: subAgent,
+                        stream: stream,
+                        runId: context.runId,
+                        agentId: subAgentId,
+                        eventBus: context.eventBus,
+                        threadId: context.threadId,
+                        abortSignal: signal,
+                        waitForConfirmation: context.waitForConfirmation,
+                        drainCorrections,
+                        llmStepTraceHooks,
+                        workingMemoryEnabled: false,
+                    });
+                });
+                const toolFinalText = await hitlResult.text;
+                return { text: toolFinalText };
+            }
+            finally {
+                await builderWs?.cleanup();
+            }
+        }),
+    });
+    return {
+        result: `Workflow build started (task: ${taskId}). Reply with one short sentence — e.g. name what's being built. Do NOT summarize the plan or list details.`,
+        taskId,
+        agentId: subAgentId,
+    };
+}
+function createBuildWorkflowAgentTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'build-workflow-with-agent',
+        description: 'Build or modify an n8n workflow using a specialized builder agent. ' +
+            'The agent handles node discovery, schema lookups, code generation, ' +
+            'and validation internally.',
+        inputSchema: zod_1.z.object({
+            task: zod_1.z
+                .string()
+                .describe('What to build and any context: user requirements, available credential names/types.'),
+            workflowId: zod_1.z
+                .string()
+                .optional()
+                .describe('Existing workflow ID to modify. When provided, the agent starts with the current workflow code pre-loaded.'),
+            conversationContext: zod_1.z
+                .string()
+                .optional()
+                .describe('Brief summary of the conversation so far — what was discussed, decisions made, and information gathered (e.g., which credentials are available). The builder uses this to avoid repeating information the user already knows.'),
+        }),
+        outputSchema: zod_1.z.object({
+            result: zod_1.z.string(),
+            taskId: zod_1.z.string(),
+        }),
+        execute: async (input) => {
+            const result = await startBuildWorkflowAgentTask(context, input);
+            return { result: result.result, taskId: result.taskId };
+        },
+    });
+}
+//# sourceMappingURL=build-workflow-agent.tool.js.map

package/dist/tools/orchestration/build-workflow-agent.tool.js.map

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

package/dist/tools/orchestration/cancel-background-task.tool.d.ts

@@ -0,0 +1,6 @@
+import type { OrchestrationContext } from '../../types';
+export declare function createCancelBackgroundTaskTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
+    taskId: string;
+}, {
+    result: string;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "cancel-background-task", unknown>;

package/dist/tools/orchestration/cancel-background-task.tool.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCancelBackgroundTaskTool = createCancelBackgroundTaskTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+function createCancelBackgroundTaskTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'cancel-background-task',
+        description: 'Cancel a running background task (workflow builder, data table manager) by its task ID. ' +
+            'Use when the user asks to stop a background task. ' +
+            'Running task IDs are listed in the <running-tasks> section of the message.',
+        inputSchema: zod_1.z.object({
+            taskId: zod_1.z.string().describe('The task ID to cancel (e.g. build-XXXXXXXX)'),
+        }),
+        execute: async (input) => {
+            if (!context.cancelBackgroundTask) {
+                return { result: 'Error: background task cancellation not available.' };
+            }
+            await context.cancelBackgroundTask(input.taskId);
+            return { result: `Background task ${input.taskId} cancelled.` };
+        },
+    });
+}
+//# sourceMappingURL=cancel-background-task.tool.js.map

package/dist/tools/orchestration/cancel-background-task.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-background-task.tool.js","sourceRoot":"","sources":["../../../src/tools/orchestration/cancel-background-task.tool.ts"],"names":[],"mappings":";;AAUA,wEAkBC;AA5BD,8CAAgD;AAChD,6BAAwB;AASxB,SAAgB,8BAA8B,CAAC,OAA6B;IAC3E,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,wBAAwB;QAC5B,WAAW,EACV,0FAA0F;YAC1F,oDAAoD;YACpD,4EAA4E;QAC7E,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAC1E,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxB,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;gBACnC,OAAO,EAAE,MAAM,EAAE,oDAAoD,EAAE,CAAC;YACzE,CAAC;YACD,MAAM,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjD,OAAO,EAAE,MAAM,EAAE,mBAAmB,KAAK,CAAC,MAAM,aAAa,EAAE,CAAC;QACjE,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/orchestration/correct-background-task.tool.d.ts

@@ -0,0 +1,7 @@
+import type { OrchestrationContext } from '../../types';
+export declare function createCorrectBackgroundTaskTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
+    taskId: string;
+    correction: string;
+}, {
+    result: string;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "correct-background-task", unknown>;

package/dist/tools/orchestration/correct-background-task.tool.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCorrectBackgroundTaskTool = createCorrectBackgroundTaskTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+function createCorrectBackgroundTaskTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'correct-background-task',
+        description: 'Send a correction to a running background task (e.g. a workflow builder). ' +
+            'Use when the user sends a message that is clearly a correction for an in-progress build ' +
+            '(mentions specific nodes, databases, credentials, or says "wait"/"use X instead"). ' +
+            'Running task IDs are listed in the <running-tasks> section of the message.',
+        inputSchema: zod_1.z.object({
+            taskId: zod_1.z.string().describe('The task ID to send the correction to (e.g. build-XXXXXXXX)'),
+            correction: zod_1.z
+                .string()
+                .describe("The correction message from the user (e.g. 'use the Projects database')"),
+        }),
+        execute: async (input) => {
+            if (!context.sendCorrectionToTask) {
+                return await Promise.resolve({ result: 'Error: correction delivery not available.' });
+            }
+            const status = context.sendCorrectionToTask(input.taskId, input.correction);
+            if (status === 'task-not-found') {
+                return await Promise.resolve({
+                    result: `Task ${input.taskId} not found. It may have already been cleaned up.`,
+                });
+            }
+            if (status === 'task-completed') {
+                return await Promise.resolve({
+                    result: `Task ${input.taskId} has already completed. The correction was not delivered. ` +
+                        `Incorporate "${input.correction}" into a new follow-up task instead.`,
+                });
+            }
+            return await Promise.resolve({
+                result: `Correction sent to task ${input.taskId}: "${input.correction}". The builder will see this on its next step.`,
+            });
+        },
+    });
+}
+//# sourceMappingURL=correct-background-task.tool.js.map

package/dist/tools/orchestration/correct-background-task.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correct-background-task.tool.js","sourceRoot":"","sources":["../../../src/tools/orchestration/correct-background-task.tool.ts"],"names":[],"mappings":";;AAUA,0EAoCC;AA9CD,8CAAgD;AAChD,6BAAwB;AASxB,SAAgB,+BAA+B,CAAC,OAA6B;IAC5E,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,yBAAyB;QAC7B,WAAW,EACV,4EAA4E;YAC5E,0FAA0F;YAC1F,qFAAqF;YACrF,4EAA4E;QAC7E,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;YAC1F,UAAU,EAAE,OAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,yEAAyE,CAAC;SACrF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxB,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;gBACnC,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,2CAA2C,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAC5E,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBACjC,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC;oBAC5B,MAAM,EAAE,QAAQ,KAAK,CAAC,MAAM,kDAAkD;iBAC9E,CAAC,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBACjC,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC;oBAC5B,MAAM,EACL,QAAQ,KAAK,CAAC,MAAM,4DAA4D;wBAChF,gBAAgB,KAAK,CAAC,UAAU,sCAAsC;iBACvE,CAAC,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC;gBAC5B,MAAM,EAAE,2BAA2B,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,UAAU,gDAAgD;aACrH,CAAC,CAAC;QACJ,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}