@n8n/instance-ai 1.0.0

package/dist/tools/orchestration/data-table-agent.prompt.d.ts

@@ -0,0 +1 @@
+export declare const DATA_TABLE_AGENT_PROMPT = "You are a data table management agent for n8n. You manage data tables \u2014 creating them, modifying their schema, and querying/inserting/updating/deleting rows.\n\n## Output Discipline\n- You report to a parent agent, not a human. Be terse.\n- Do NOT narrate (\"I'll create the table now\", \"Let me check\"). Just do the work.\n- No emojis, no filler phrases, no markdown headers.\n- Only output a final one-line summary (e.g., \"Created table 'leads' with 3 columns\").\n\n## Mandatory Process\n\n1. **Check existing tables first**: Always call `list-data-tables` before creating a new table to avoid duplicates.\n2. **Get schema before row operations**: Call `get-data-table-schema` to confirm column names and types before inserting or querying rows.\n3. **Execute the requested operation** using the appropriate tool(s).\n4. **Report concisely**: One sentence summary of what was done.\n\nDo NOT produce visible output until the final summary. All reasoning happens internally.\n\n## Column Rules\n\n- System columns (`id`, `createdAt`, `updatedAt`) are automatic and RESERVED \u2014 the API will reject any column with these names. If a spec asks for an `id` column, prefix it with a context-appropriate name before calling `create-data-table`.\n\n## Destructive Operations\n\n`delete-data-table` and `delete-data-table-rows` will trigger a confirmation prompt to the user. The user must approve before the action executes. Do not ask the user to confirm via text \u2014 the tool handles it.\n";

package/dist/tools/orchestration/data-table-agent.prompt.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATA_TABLE_AGENT_PROMPT = void 0;
+exports.DATA_TABLE_AGENT_PROMPT = `You are a data table management agent for n8n. You manage data tables — creating them, modifying their schema, and querying/inserting/updating/deleting rows.
+
+## Output Discipline
+- You report to a parent agent, not a human. Be terse.
+- Do NOT narrate ("I'll create the table now", "Let me check"). Just do the work.
+- No emojis, no filler phrases, no markdown headers.
+- Only output a final one-line summary (e.g., "Created table 'leads' with 3 columns").
+
+## Mandatory Process
+
+1. **Check existing tables first**: Always call \`list-data-tables\` before creating a new table to avoid duplicates.
+2. **Get schema before row operations**: Call \`get-data-table-schema\` to confirm column names and types before inserting or querying rows.
+3. **Execute the requested operation** using the appropriate tool(s).
+4. **Report concisely**: One sentence summary of what was done.
+
+Do NOT produce visible output until the final summary. All reasoning happens internally.
+
+## Column Rules
+
+- System columns (\`id\`, \`createdAt\`, \`updatedAt\`) are automatic and RESERVED — the API will reject any column with these names. If a spec asks for an \`id\` column, prefix it with a context-appropriate name before calling \`create-data-table\`.
+
+## Destructive Operations
+
+\`delete-data-table\` and \`delete-data-table-rows\` will trigger a confirmation prompt to the user. The user must approve before the action executes. Do not ask the user to confirm via text — the tool handles it.
+`;
+//# sourceMappingURL=data-table-agent.prompt.js.map

package/dist/tools/orchestration/data-table-agent.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-agent.prompt.js","sourceRoot":"","sources":["../../../src/tools/orchestration/data-table-agent.prompt.ts"],"names":[],"mappings":";;;AAOa,QAAA,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBtC,CAAC"}

package/dist/tools/orchestration/data-table-agent.tool.d.ts

@@ -0,0 +1,21 @@
+import type { OrchestrationContext } from '../../types';
+export interface StartDataTableAgentInput {
+    task: string;
+    conversationContext?: string;
+    taskId?: string;
+    agentId?: string;
+    plannedTaskId?: string;
+}
+export interface StartedBackgroundAgentTask {
+    result: string;
+    taskId: string;
+    agentId: string;
+}
+export declare function startDataTableAgentTask(context: OrchestrationContext, input: StartDataTableAgentInput): Promise<StartedBackgroundAgentTask>;
+export declare function createDataTableAgentTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
+    task: string;
+    conversationContext?: string | undefined;
+}, {
+    result: string;
+    taskId: string;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "manage-data-tables-with-agent", unknown>;

package/dist/tools/orchestration/data-table-agent.tool.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startDataTableAgentTask = startDataTableAgentTask;
+exports.createDataTableAgentTool = createDataTableAgentTool;
+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 data_table_agent_prompt_1 = require("./data-table-agent.prompt");
+const display_utils_1 = require("./display-utils");
+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 working_memory_tracing_1 = require("../../runtime/working-memory-tracing");
+const consume_with_hitl_1 = require("../../stream/consume-with-hitl");
+const langsmith_tracing_1 = require("../../tracing/langsmith-tracing");
+const DATA_TABLE_MAX_STEPS = 15;
+const DATA_TABLE_TOOL_NAMES = [
+    'list-data-tables',
+    'create-data-table',
+    'delete-data-table',
+    'get-data-table-schema',
+    'add-data-table-column',
+    'delete-data-table-column',
+    'rename-data-table-column',
+    'query-data-table-rows',
+    'insert-data-table-rows',
+    'update-data-table-rows',
+    'delete-data-table-rows',
+];
+async function startDataTableAgentTask(context, input) {
+    const dataTableTools = {};
+    for (const name of DATA_TABLE_TOOL_NAMES) {
+        if (name in context.domainTools) {
+            dataTableTools[name] = context.domainTools[name];
+        }
+    }
+    if (Object.keys(dataTableTools).length === 0) {
+        return { result: 'Error: no data table tools available.', taskId: '', agentId: '' };
+    }
+    if (!context.spawnBackgroundTask) {
+        return { result: 'Error: background task support not available.', taskId: '', agentId: '' };
+    }
+    const subAgentId = input.agentId ?? `agent-datatable-${(0, nanoid_1.nanoid)(6)}`;
+    const taskId = input.taskId ?? `datatable-${(0, nanoid_1.nanoid)(8)}`;
+    context.eventBus.publish(context.threadId, {
+        type: 'agent-spawned',
+        runId: context.runId,
+        agentId: subAgentId,
+        payload: {
+            parentId: context.orchestratorAgentId,
+            role: 'data-table-manager',
+            tools: Object.keys(dataTableTools),
+            taskId,
+            kind: 'data-table',
+            title: 'Managing data table',
+            subtitle: (0, display_utils_1.truncateLabel)(input.task),
+            goal: input.task,
+            targetResource: { type: 'data-table' },
+        },
+    });
+    const traceContext = await (0, tracing_utils_1.createDetachedSubAgentTracing)(context, {
+        agentId: subAgentId,
+        role: 'data-table-manager',
+        kind: 'data-table',
+        taskId,
+        plannedTaskId: input.plannedTaskId,
+        inputs: {
+            task: input.task,
+            conversationContext: input.conversationContext,
+        },
+    });
+    const tracedDataTableTools = (0, tracing_utils_1.traceSubAgentTools)(context, dataTableTools, 'data-table-manager');
+    context.spawnBackgroundTask({
+        taskId,
+        threadId: context.threadId,
+        agentId: subAgentId,
+        role: 'data-table-manager',
+        traceContext,
+        plannedTaskId: input.plannedTaskId,
+        run: async (signal, _drainCorrections) => {
+            return await (0, tracing_utils_1.withTraceContextActor)(traceContext, async () => {
+                const subAgent = new agent_1.Agent({
+                    id: subAgentId,
+                    name: 'Data Table Agent',
+                    instructions: {
+                        role: 'system',
+                        content: data_table_agent_prompt_1.DATA_TABLE_AGENT_PROMPT,
+                        providerOptions: {
+                            anthropic: { cacheControl: { type: 'ephemeral' } },
+                        },
+                    },
+                    model: context.modelId,
+                    tools: tracedDataTableTools,
+                });
+                (0, langsmith_tracing_1.mergeTraceRunInputs)(traceContext?.actorRun, (0, langsmith_tracing_1.buildAgentTraceInputs)({
+                    systemPrompt: data_table_agent_prompt_1.DATA_TABLE_AGENT_PROMPT,
+                    tools: tracedDataTableTools,
+                    modelId: context.modelId,
+                }));
+                (0, register_with_mastra_1.registerWithMastra)(subAgentId, subAgent, context.storage);
+                const conversationCtx = input.conversationContext
+                    ? `\n\n[CONVERSATION CONTEXT: ${input.conversationContext}]`
+                    : '';
+                const briefing = `${input.task}${conversationCtx}`;
+                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 (0, working_memory_tracing_1.traceWorkingMemoryContext)({
+                        phase: 'initial',
+                        agentId: subAgentId,
+                        agentRole: 'data-table-manager',
+                        threadId: context.threadId,
+                        input: briefing,
+                    }, async () => await subAgent.stream(briefing, {
+                        maxSteps: DATA_TABLE_MAX_STEPS,
+                        abortSignal: signal,
+                        providerOptions: {
+                            anthropic: { cacheControl: { type: 'ephemeral' } },
+                        },
+                        ...(llmStepTraceHooks?.executionOptions ?? {}),
+                    }));
+                    const hitlResult = 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,
+                        llmStepTraceHooks,
+                        workingMemoryEnabled: false,
+                    });
+                    return await hitlResult.text;
+                });
+            });
+        },
+    });
+    return {
+        result: `Data table operation started (task: ${taskId}). Reply with one short sentence. Do NOT summarize the plan or list details.`,
+        taskId,
+        agentId: subAgentId,
+    };
+}
+function createDataTableAgentTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'manage-data-tables-with-agent',
+        description: 'Manage data tables using a specialized agent. ' +
+            'The agent handles listing, creating, deleting tables, modifying schemas, ' +
+            'and querying/inserting/updating/deleting rows.',
+        inputSchema: zod_1.z.object({
+            task: zod_1.z
+                .string()
+                .describe('What to do: describe the data table operation. Include table names, column details, data to insert, or query criteria.'),
+            conversationContext: zod_1.z
+                .string()
+                .optional()
+                .describe('Brief summary of the conversation so far — what was discussed, decisions made, and information gathered. The agent 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 startDataTableAgentTask(context, input);
+            return await Promise.resolve({ result: result.result, taskId: result.taskId });
+        },
+    });
+}
+//# sourceMappingURL=data-table-agent.tool.js.map

package/dist/tools/orchestration/data-table-agent.tool.js.map

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

package/dist/tools/orchestration/delegate.schemas.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export declare const delegateInputSchema: z.ZodObject<{
+    role: z.ZodString;
+    instructions: z.ZodString;
+    tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    briefing: z.ZodString;
+    artifacts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    conversationContext: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    role: string;
+    tools: string[];
+    instructions: string;
+    briefing: string;
+    conversationContext?: string | undefined;
+    artifacts?: Record<string, unknown> | undefined;
+}, {
+    role: string;
+    instructions: string;
+    briefing: string;
+    tools?: string[] | undefined;
+    conversationContext?: string | undefined;
+    artifacts?: Record<string, unknown> | undefined;
+}>;
+export type DelegateInput = z.infer<typeof delegateInputSchema>;
+export declare const delegateOutputSchema: z.ZodObject<{
+    result: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    result: string;
+}, {
+    result: string;
+}>;
+export type DelegateOutput = z.infer<typeof delegateOutputSchema>;

package/dist/tools/orchestration/delegate.schemas.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delegateOutputSchema = exports.delegateInputSchema = void 0;
+const zod_1 = require("zod");
+exports.delegateInputSchema = zod_1.z.object({
+    role: zod_1.z
+        .string()
+        .describe('Free-form role description (e.g., "workflow builder", "execution debugger")'),
+    instructions: zod_1.z
+        .string()
+        .describe('Task-specific system prompt for the sub-agent. Be specific about what to do and how.'),
+    tools: zod_1.z
+        .array(zod_1.z.string())
+        .default([])
+        .describe('Subset of registered native domain tool names the sub-agent needs'),
+    briefing: zod_1.z.string().describe('The specific task to accomplish, including all relevant context'),
+    artifacts: zod_1.z
+        .record(zod_1.z.unknown())
+        .optional()
+        .describe('Relevant IDs, data, or context (workflow IDs, credential IDs, etc.)'),
+    conversationContext: zod_1.z
+        .string()
+        .optional()
+        .describe('Brief summary of the conversation so far — what was discussed, decisions made, and information gathered. The sub-agent uses this to avoid repeating information the user already knows.'),
+});
+exports.delegateOutputSchema = zod_1.z.object({
+    result: zod_1.z.string().describe('The sub-agent synthesized answer'),
+});
+//# sourceMappingURL=delegate.schemas.js.map

package/dist/tools/orchestration/delegate.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.schemas.js","sourceRoot":"","sources":["../../../src/tools/orchestration/delegate.schemas.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAEX,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,6EAA6E,CAAC;IACzF,YAAY,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,CACR,sFAAsF,CACtF;IACF,KAAK,EAAE,OAAC;SACN,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,mEAAmE,CAAC;IAC/E,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;IAChG,SAAS,EAAE,OAAC;SACV,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;IACjF,mBAAmB,EAAE,OAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,yLAAyL,CACzL;CACF,CAAC,CAAC;AAIU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAC/D,CAAC,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { OrchestrationContext } from '../../types';
+export interface DetachedDelegateTaskInput {
+    title: string;
+    spec: string;
+    tools: string[];
+    artifacts?: unknown;
+    conversationContext?: string;
+    taskId?: string;
+    agentId?: string;
+    plannedTaskId?: string;
+}
+export interface DetachedDelegateTaskResult {
+    result: string;
+    taskId: string;
+    agentId: string;
+}
+export declare function startDetachedDelegateTask(context: OrchestrationContext, input: DetachedDelegateTaskInput): Promise<DetachedDelegateTaskResult>;
+export declare function createDelegateTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
+    role: string;
+    tools: string[];
+    instructions: string;
+    briefing: string;
+    conversationContext?: string | undefined;
+    artifacts?: Record<string, unknown> | undefined;
+}, {
+    result: string;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "delegate", unknown>;

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

@@ -0,0 +1,307 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startDetachedDelegateTask = startDetachedDelegateTask;
+exports.createDelegateTool = createDelegateTool;
+const tools_1 = require("@mastra/core/tools");
+const nanoid_1 = require("nanoid");
+const delegate_schemas_1 = require("./delegate.schemas");
+const display_utils_1 = require("./display-utils");
+const tracing_utils_1 = require("./tracing-utils");
+const register_with_mastra_1 = require("../../agent/register-with-mastra");
+const sub_agent_factory_1 = require("../../agent/sub-agent-factory");
+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 FORBIDDEN_TOOL_NAMES = new Set(['plan', 'delegate']);
+const FALLBACK_MAX_STEPS = 10;
+function generateAgentId() {
+    return `agent-${(0, nanoid_1.nanoid)(6)}`;
+}
+function buildRoleKey(role) {
+    return role
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function resolveDelegateTools(context, toolNames) {
+    const errors = [];
+    const validTools = {};
+    const availableMcpTools = context.mcpTools ?? {};
+    for (const name of toolNames) {
+        if (FORBIDDEN_TOOL_NAMES.has(name)) {
+            errors.push(`"${name}" is an orchestration tool and cannot be delegated`);
+        }
+        else if (name in context.domainTools) {
+            validTools[name] = context.domainTools[name];
+        }
+        else if (name in availableMcpTools) {
+            validTools[name] = availableMcpTools[name];
+        }
+        else {
+            errors.push(`"${name}" is not a registered domain tool`);
+        }
+    }
+    return { validTools, errors };
+}
+async function buildDelegateBriefing(context, role, briefing, artifacts, conversationContext) {
+    const serializedArtifacts = artifacts ? `\n\nArtifacts: ${JSON.stringify(artifacts)}` : '';
+    const conversationCtx = conversationContext
+        ? `\n\n[CONVERSATION CONTEXT: ${conversationContext}]`
+        : '';
+    let iterationContext = '';
+    if (context.iterationLog) {
+        const taskKey = `delegate:${role}`;
+        try {
+            const entries = await context.iterationLog.getForTask(context.threadId, taskKey);
+            iterationContext = (0, iteration_log_1.formatPreviousAttempts)(entries);
+        }
+        catch {
+        }
+    }
+    return `${briefing}${conversationCtx}${serializedArtifacts}${iterationContext ? `\n\n${iterationContext}` : ''}\n\nRemember: ${sub_agent_factory_1.SUB_AGENT_PROTOCOL}`;
+}
+async function startDetachedDelegateTask(context, input) {
+    if (input.tools.length === 0) {
+        return {
+            result: 'Delegation failed: "tools" must contain at least one tool name',
+            taskId: '',
+            agentId: '',
+        };
+    }
+    const { validTools, errors } = resolveDelegateTools(context, input.tools);
+    if (errors.length > 0) {
+        return {
+            result: `Delegation failed: ${errors.join('; ')}`,
+            taskId: '',
+            agentId: '',
+        };
+    }
+    if (!context.spawnBackgroundTask) {
+        return {
+            result: 'Delegation failed: background task support not available.',
+            taskId: '',
+            agentId: '',
+        };
+    }
+    const role = buildRoleKey(input.title) || 'delegate-worker';
+    const subAgentId = input.agentId ?? `agent-delegate-${(0, nanoid_1.nanoid)(6)}`;
+    const taskId = input.taskId ?? `delegate-${(0, nanoid_1.nanoid)(8)}`;
+    context.eventBus.publish(context.threadId, {
+        type: 'agent-spawned',
+        runId: context.runId,
+        agentId: subAgentId,
+        payload: {
+            parentId: context.orchestratorAgentId,
+            role,
+            tools: input.tools,
+            taskId,
+            kind: 'delegate',
+            title: input.title,
+            subtitle: (0, display_utils_1.truncateLabel)(input.spec),
+            goal: input.spec,
+        },
+    });
+    const briefingMessage = await buildDelegateBriefing(context, role, input.spec, input.artifacts, input.conversationContext);
+    const traceContext = await (0, tracing_utils_1.createDetachedSubAgentTracing)(context, {
+        agentId: subAgentId,
+        role,
+        kind: 'delegate',
+        taskId,
+        plannedTaskId: input.plannedTaskId,
+        inputs: {
+            title: input.title,
+            briefing: input.spec,
+            tools: input.tools,
+            conversationContext: input.conversationContext,
+        },
+    });
+    const tracedTools = (0, tracing_utils_1.traceSubAgentTools)(context, validTools, role);
+    context.spawnBackgroundTask({
+        taskId,
+        threadId: context.threadId,
+        agentId: subAgentId,
+        role,
+        traceContext,
+        plannedTaskId: input.plannedTaskId,
+        run: async (signal, drainCorrections) => {
+            return await (0, tracing_utils_1.withTraceContextActor)(traceContext, async () => {
+                const subAgent = (0, sub_agent_factory_1.createSubAgent)({
+                    agentId: subAgentId,
+                    role,
+                    instructions: 'Complete the delegated task using the provided tools. Return concrete results only.',
+                    tools: tracedTools,
+                    modelId: context.modelId,
+                    traceRun: traceContext?.actorRun,
+                });
+                (0, register_with_mastra_1.registerWithMastra)(subAgentId, subAgent, context.storage);
+                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 (0, working_memory_tracing_1.traceWorkingMemoryContext)({
+                        phase: 'initial',
+                        agentId: subAgentId,
+                        agentRole: role,
+                        threadId: context.threadId,
+                        input: briefingMessage,
+                    }, async () => await subAgent.stream(briefingMessage, {
+                        maxSteps: context.subAgentMaxSteps ?? FALLBACK_MAX_STEPS,
+                        abortSignal: signal,
+                        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,
+                        threadId: context.threadId,
+                        abortSignal: signal,
+                        waitForConfirmation: context.waitForConfirmation,
+                        drainCorrections,
+                        llmStepTraceHooks,
+                        workingMemoryEnabled: false,
+                    });
+                    return await result.text;
+                });
+            });
+        },
+    });
+    return {
+        result: `Delegation started (task: ${taskId}). Reply with one short sentence. Do NOT summarize the plan or list details.`,
+        taskId,
+        agentId: subAgentId,
+    };
+}
+function createDelegateTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'delegate',
+        description: 'Spawn a focused sub-agent to handle a specific subtask. Specify the ' +
+            'role, a task-specific system prompt, the tool subset needed, and a ' +
+            'detailed briefing. The sub-agent executes independently and returns ' +
+            'a synthesized result. Use for complex multi-step operations that ' +
+            'benefit from a clean context window.',
+        inputSchema: delegate_schemas_1.delegateInputSchema,
+        outputSchema: delegate_schemas_1.delegateOutputSchema,
+        execute: async (input) => {
+            if (input.tools.length === 0) {
+                return { result: 'Delegation failed: "tools" must contain at least one tool name' };
+            }
+            const { validTools, errors } = resolveDelegateTools(context, input.tools);
+            if (errors.length > 0) {
+                return { result: `Delegation failed: ${errors.join('; ')}` };
+            }
+            const subAgentId = generateAgentId();
+            context.eventBus.publish(context.threadId, {
+                type: 'agent-spawned',
+                runId: context.runId,
+                agentId: subAgentId,
+                payload: {
+                    parentId: context.orchestratorAgentId,
+                    role: input.role,
+                    tools: input.tools,
+                    kind: 'delegate',
+                    subtitle: (0, display_utils_1.truncateLabel)(input.briefing),
+                    goal: input.briefing,
+                },
+            });
+            const traceRun = await (0, tracing_utils_1.startSubAgentTrace)(context, {
+                agentId: subAgentId,
+                role: input.role,
+                kind: 'delegate',
+                inputs: {
+                    briefing: input.briefing,
+                    instructions: input.instructions,
+                    tools: input.tools,
+                    conversationContext: input.conversationContext,
+                },
+            });
+            const tracedTools = (0, tracing_utils_1.traceSubAgentTools)(context, validTools, input.role);
+            try {
+                const subAgent = (0, sub_agent_factory_1.createSubAgent)({
+                    agentId: subAgentId,
+                    role: input.role,
+                    instructions: input.instructions,
+                    tools: tracedTools,
+                    modelId: context.modelId,
+                    traceRun,
+                });
+                (0, register_with_mastra_1.registerWithMastra)(subAgentId, subAgent, context.storage);
+                const briefingMessage = await buildDelegateBriefing(context, input.role, input.briefing, input.artifacts, input.conversationContext);
+                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 (0, working_memory_tracing_1.traceWorkingMemoryContext)({
+                            phase: 'initial',
+                            agentId: subAgentId,
+                            agentRole: input.role,
+                            threadId: context.threadId,
+                            input: briefingMessage,
+                        }, async () => await subAgent.stream(briefingMessage, {
+                            maxSteps: context.subAgentMaxSteps ?? FALLBACK_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,
+                            threadId: context.threadId,
+                            abortSignal: context.abortSignal,
+                            waitForConfirmation: context.waitForConfirmation,
+                            llmStepTraceHooks,
+                            workingMemoryEnabled: false,
+                        });
+                        return await result.text;
+                    });
+                });
+                await (0, tracing_utils_1.finishTraceRun)(context, traceRun, {
+                    outputs: {
+                        result: resultText,
+                        agentId: subAgentId,
+                        role: input.role,
+                    },
+                });
+                context.eventBus.publish(context.threadId, {
+                    type: 'agent-completed',
+                    runId: context.runId,
+                    agentId: subAgentId,
+                    payload: {
+                        role: input.role,
+                        result: resultText,
+                    },
+                });
+                return { result: 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: input.role,
+                });
+                context.eventBus.publish(context.threadId, {
+                    type: 'agent-completed',
+                    runId: context.runId,
+                    agentId: subAgentId,
+                    payload: {
+                        role: input.role,
+                        result: '',
+                        error: errorMessage,
+                    },
+                });
+                return { result: `Sub-agent error: ${errorMessage}` };
+            }
+        },
+    });
+}
+//# sourceMappingURL=delegate.tool.js.map