@n8n/instance-ai 1.0.0 → 1.2.0

package/LICENSE_EE.md

@@ -0,0 +1,27 @@
+# The n8n Enterprise License (the “Enterprise License”)
+
+Copyright (c) 2022-present n8n GmbH.
+
+With regard to the n8n Software:
+
+This software and associated documentation files (the "Software") may only be used in production, if
+you (and any entity that you represent) hold a valid n8n Enterprise license corresponding to your
+usage. Subject to the foregoing sentence, you are free to modify this Software and publish patches
+to the Software. You agree that n8n and/or its licensors (as applicable) retain all right, title and
+interest in and to all such modifications and/or patches, and all such modifications and/or patches
+may only be used, copied, modified, displayed, distributed, or otherwise exploited with a valid n8n
+Enterprise license for the corresponding usage. Notwithstanding the foregoing, you may copy and
+modify the Software for development and testing purposes, without requiring a subscription. You
+agree that n8n and/or its licensors (as applicable) retain all right, title and interest in and to
+all such modifications. You are not granted any other rights beyond what is expressly stated herein.
+Subject to the foregoing, it is forbidden to copy, merge, publish, distribute, sublicense, and/or
+sell the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For all third party components incorporated into the n8n Software, those components are licensed
+under the original license provided by the owner of the applicable component.

package/dist/agent/instance-agent.js

@@ -12,6 +12,7 @@ const create_tools_from_mcp_server_1 = require("../tools/filesystem/create-tools
 const langsmith_tracing_1 = require("../tracing/langsmith-tracing");
 const sanitize_mcp_schemas_1 = require("./sanitize-mcp-schemas");
 const system_prompt_1 = require("./system-prompt");
+const tool_access_1 = require("./tool-access");
 function buildMcpServers(configs) {
     const servers = {};
     for (const server of configs) {
@@ -28,21 +29,21 @@ let cachedMcpTools = null;
 let cachedMcpServersKey = '';
 let cachedBrowserMcpTools = null;
 let cachedBrowserMcpKey = '';
-let cachedToolSearchProcessor = null;
-let cachedToolSearchKey = '';
 let cachedMastra = null;
 let cachedMastraStorageKey = '';
-const ALWAYS_LOADED_TOOLS = new Set(['plan', 'delegate', 'ask-user', 'web-search', 'fetch-url']);
+const ALWAYS_LOADED_TOOLS = new Set([
+    'plan',
+    'create-tasks',
+    'delegate',
+    'ask-user',
+    'web-search',
+    'fetch-url',
+]);
 function getOrCreateToolSearchProcessor(tools) {
-    const key = JSON.stringify(Object.keys(tools).sort());
-    if (cachedToolSearchProcessor && cachedToolSearchKey === key)
-        return cachedToolSearchProcessor;
-    cachedToolSearchProcessor = new processors_1.ToolSearchProcessor({
+    return new processors_1.ToolSearchProcessor({
         tools: tools,
         search: { topK: 5 },
     });
-    cachedToolSearchKey = key;
-    return cachedToolSearchProcessor;
 }
 async function getMcpTools(mcpServers) {
     const key = JSON.stringify(mcpServers);
@@ -77,46 +78,16 @@ async function getBrowserMcpTools(config) {
 }
 function ensureMastraRegistered(agent, storage) {
     const key = storage.id ?? 'default';
-    if (cachedMastra && cachedMastraStorageKey === key) {
-        agent.__registerMastra(cachedMastra);
-        return;
+    if (!cachedMastra || cachedMastraStorageKey !== key) {
+        cachedMastra = new mastra_1.Mastra({ storage });
+        cachedMastraStorageKey = key;
     }
-    cachedMastra = new mastra_1.Mastra({
-        agents: { 'n8n-instance-agent': agent },
-        storage,
-    });
-    cachedMastraStorageKey = key;
+    agent.__registerMastra(cachedMastra);
 }
 async function createInstanceAgent(options) {
     const { modelId, context, orchestrationContext, mcpServers = [], memoryConfig, disableDeferredTools = false, } = options;
     const domainTools = (0, tools_1.createAllTools)(context);
-    const BUILDER_ONLY_TOOLS = new Set([
-        'search-nodes',
-        'list-nodes',
-        'get-node-type-definition',
-        'get-node-description',
-        'get-best-practices',
-        'search-template-structures',
-        'search-template-parameters',
-        'build-workflow',
-        'get-workflow-as-code',
-    ]);
-    const DATA_TABLE_WRITE_TOOLS = new Set([
-        'create-data-table',
-        'delete-data-table',
-        'add-data-table-column',
-        'delete-data-table-column',
-        'rename-data-table-column',
-        'insert-data-table-rows',
-        'update-data-table-rows',
-        'delete-data-table-rows',
-    ]);
-    const orchestratorDomainTools = {};
-    for (const [name, tool] of Object.entries(domainTools)) {
-        if (!BUILDER_ONLY_TOOLS.has(name) && !DATA_TABLE_WRITE_TOOLS.has(name)) {
-            orchestratorDomainTools[name] = tool;
-        }
-    }
+    const orchestratorDomainTools = (0, tool_access_1.getOrchestratorDomainTools)(domainTools);
     const mcpTools = await getMcpTools(mcpServers);
     const browserMcpTools = await getBrowserMcpTools(orchestrationContext?.browserMcpConfig);
     const browserToolNames = new Set([
@@ -177,12 +148,13 @@ async function createInstanceAgent(options) {
     const systemPrompt = (0, system_prompt_1.getSystemPrompt)({
         researchMode: orchestrationContext?.researchMode,
         webhookBaseUrl: orchestrationContext?.webhookBaseUrl,
-        filesystemAccess: !!(context.localMcpServer ?? context.filesystemService),
+        filesystemAccess: (context.localMcpServer?.getToolsByCategory('filesystem').length ?? 0) > 0,
         localGateway: context.localGatewayStatus,
         toolSearchEnabled: hasDeferrableTools,
         licenseHints: context.licenseHints,
         timeZone: options.timeZone,
         browserAvailable: browserToolNames.size > 0,
+        branchReadOnly: context.branchReadOnly,
     });
     const agent = new agent_1.Agent({
         id: 'n8n-instance-agent',

package/dist/agent/instance-agent.js.map

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

package/dist/agent/register-with-mastra.d.ts

@@ -1,3 +1,3 @@
 import type { Agent } from '@mastra/core/agent';
 import type { MastraCompositeStore } from '@mastra/core/storage';
-export declare function registerWithMastra(agentId: string, agent: Agent, storage: MastraCompositeStore): void;
+export declare function registerWithMastra(_agentId: string, agent: Agent, storage: MastraCompositeStore): void;

package/dist/agent/register-with-mastra.js

@@ -4,16 +4,12 @@ exports.registerWithMastra = registerWithMastra;
 const mastra_1 = require("@mastra/core/mastra");
 let cachedSubAgentMastra = null;
 let cachedSubAgentStorageKey = '';
-function registerWithMastra(agentId, agent, storage) {
+function registerWithMastra(_agentId, agent, storage) {
     const key = storage.id ?? 'default';
-    if (cachedSubAgentMastra && cachedSubAgentStorageKey === key) {
-        agent.__registerMastra(cachedSubAgentMastra);
-        return;
+    if (!cachedSubAgentMastra || cachedSubAgentStorageKey !== key) {
+        cachedSubAgentMastra = new mastra_1.Mastra({ storage });
+        cachedSubAgentStorageKey = key;
     }
-    cachedSubAgentMastra = new mastra_1.Mastra({
-        agents: { [agentId]: agent },
-        storage,
-    });
-    cachedSubAgentStorageKey = key;
+    agent.__registerMastra(cachedSubAgentMastra);
 }
 //# sourceMappingURL=register-with-mastra.js.map

package/dist/agent/register-with-mastra.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-with-mastra.js","sourceRoot":"","sources":["../../src/agent/register-with-mastra.ts"],"names":[],"mappings":";;AAgBA,gDAeC;AArBD,gDAA6C;AAG7C,IAAI,oBAAoB,GAAkB,IAAI,CAAC;AAC/C,IAAI,wBAAwB,GAAG,EAAE,CAAC;AAElC,SAAgB,kBAAkB,CAAC,OAAe,EAAE,KAAY,EAAE,OAA6B;IAC9F,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,IAAI,SAAS,CAAC;IAEpC,IAAI,oBAAoB,IAAI,wBAAwB,KAAK,GAAG,EAAE,CAAC;QAG9D,KAAK,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;QAC7C,OAAO;IACR,CAAC;IAED,oBAAoB,GAAG,IAAI,eAAM,CAAC;QACjC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE;QAC5B,OAAO;KACP,CAAC,CAAC;IACH,wBAAwB,GAAG,GAAG,CAAC;AAChC,CAAC"}
+{"version":3,"file":"register-with-mastra.js","sourceRoot":"","sources":["../../src/agent/register-with-mastra.ts"],"names":[],"mappings":";;AAkBA,gDAYC;AAlBD,gDAA6C;AAG7C,IAAI,oBAAoB,GAAkB,IAAI,CAAC;AAC/C,IAAI,wBAAwB,GAAG,EAAE,CAAC;AAElC,SAAgB,kBAAkB,CAAC,QAAgB,EAAE,KAAY,EAAE,OAA6B;IAC/F,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,IAAI,SAAS,CAAC;IAEpC,IAAI,CAAC,oBAAoB,IAAI,wBAAwB,KAAK,GAAG,EAAE,CAAC;QAI/D,oBAAoB,GAAG,IAAI,eAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,wBAAwB,GAAG,GAAG,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;AAC9C,CAAC"}

package/dist/agent/sub-agent-briefing.d.ts

@@ -0,0 +1,20 @@
+import { type IterationLog } from '../storage/iteration-log';
+export interface RunningTaskSummary {
+    taskId: string;
+    role: string;
+    goal?: string;
+}
+export interface SubAgentBriefingInput {
+    task: string;
+    conversationContext?: string;
+    artifacts?: Record<string, unknown>;
+    additionalContext?: string;
+    requirements?: string;
+    iteration?: {
+        log: IterationLog;
+        threadId: string;
+        taskKey: string;
+    };
+    runningTasks?: RunningTaskSummary[];
+}
+export declare function buildSubAgentBriefing(input: SubAgentBriefingInput): Promise<string>;

package/dist/agent/sub-agent-briefing.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSubAgentBriefing = buildSubAgentBriefing;
+const iteration_log_1 = require("../storage/iteration-log");
+async function buildSubAgentBriefing(input) {
+    const parts = [];
+    parts.push(`<task>\n${input.task}\n</task>`);
+    if (input.conversationContext) {
+        parts.push(`<conversation-context>\n${input.conversationContext}\n</conversation-context>`);
+    }
+    if (input.artifacts && Object.keys(input.artifacts).length > 0) {
+        parts.push(`<artifacts>\n${JSON.stringify(input.artifacts)}\n</artifacts>`);
+    }
+    if (input.additionalContext) {
+        parts.push(input.additionalContext);
+    }
+    if (input.requirements) {
+        parts.push(input.requirements);
+    }
+    if (input.runningTasks && input.runningTasks.length > 0) {
+        const taskLines = input.runningTasks
+            .map((t) => `  <running-task taskId="${t.taskId}" role="${t.role}">${t.goal ?? ''}</running-task>`)
+            .join('\n');
+        parts.push(`<thread-state>\n${taskLines}\n</thread-state>`);
+    }
+    if (input.iteration) {
+        try {
+            const entries = await input.iteration.log.getForTask(input.iteration.threadId, input.iteration.taskKey);
+            const formatted = (0, iteration_log_1.formatPreviousAttempts)(entries);
+            if (formatted) {
+                parts.push(formatted);
+            }
+        }
+        catch {
+        }
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=sub-agent-briefing.js.map

package/dist/agent/sub-agent-briefing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-briefing.js","sourceRoot":"","sources":["../../src/agent/sub-agent-briefing.ts"],"names":[],"mappings":";;AAwCA,sDAsDC;AA9FD,4DAAqF;AAwC9E,KAAK,UAAU,qBAAqB,CAAC,KAA4B;IACvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAG3B,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC;IAG7C,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,mBAAmB,2BAA2B,CAAC,CAAC;IAC7F,CAAC;IAGD,IAAI,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC7E,CAAC;IAGD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAGD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAGD,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY;aAClC,GAAG,CACH,CAAC,CAAC,EAAE,EAAE,CACL,2BAA2B,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,iBAAiB,CACvF;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,mBAAmB,SAAS,mBAAmB,CAAC,CAAC;IAC7D,CAAC;IAGD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CACnD,KAAK,CAAC,SAAS,CAAC,QAAQ,EACxB,KAAK,CAAC,SAAS,CAAC,OAAO,CACvB,CAAC;YACF,MAAM,SAAS,GAAG,IAAA,sCAAsB,EAAC,OAAO,CAAC,CAAC;YAClD,IAAI,SAAS,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/dist/agent/sub-agent-debriefing.d.ts

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import type { WorkSummary } from '../stream/work-summary-accumulator';
+export declare const subAgentDebriefingSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    role: z.ZodString;
+    status: z.ZodEnum<["completed", "failed", "cancelled"]>;
+    result: z.ZodString;
+    toolCallCount: z.ZodNumber;
+    toolErrorCount: z.ZodNumber;
+    toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        toolCallId: z.ZodString;
+        toolName: z.ZodString;
+        succeeded: z.ZodBoolean;
+        errorSummary: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        succeeded: boolean;
+        toolCallId: string;
+        toolName: string;
+        errorSummary?: string | undefined;
+    }, {
+        succeeded: boolean;
+        toolCallId: string;
+        toolName: string;
+        errorSummary?: string | undefined;
+    }>, "many">>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    stoppingReason: z.ZodOptional<z.ZodString>;
+    blockers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    result: string;
+    status: "completed" | "failed" | "cancelled";
+    role: string;
+    agentId: string;
+    toolCallCount: number;
+    toolErrorCount: number;
+    toolCalls?: {
+        succeeded: boolean;
+        toolCallId: string;
+        toolName: string;
+        errorSummary?: string | undefined;
+    }[] | undefined;
+    durationMs?: number | undefined;
+    blockers?: string[] | undefined;
+    stoppingReason?: string | undefined;
+}, {
+    result: string;
+    status: "completed" | "failed" | "cancelled";
+    role: string;
+    agentId: string;
+    toolCallCount: number;
+    toolErrorCount: number;
+    toolCalls?: {
+        succeeded: boolean;
+        toolCallId: string;
+        toolName: string;
+        errorSummary?: string | undefined;
+    }[] | undefined;
+    durationMs?: number | undefined;
+    blockers?: string[] | undefined;
+    stoppingReason?: string | undefined;
+}>;
+export type SubAgentDebriefing = z.infer<typeof subAgentDebriefingSchema>;
+export interface BuildDebriefingInput {
+    agentId: string;
+    role: string;
+    result: string;
+    workSummary: WorkSummary;
+    startTime: number;
+    error?: string;
+}
+export declare function buildDebriefing(input: BuildDebriefingInput): SubAgentDebriefing;

package/dist/agent/sub-agent-debriefing.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subAgentDebriefingSchema = void 0;
+exports.buildDebriefing = buildDebriefing;
+const zod_1 = require("zod");
+const work_summary_accumulator_1 = require("../stream/work-summary-accumulator");
+exports.subAgentDebriefingSchema = zod_1.z.object({
+    agentId: zod_1.z.string(),
+    role: zod_1.z.string(),
+    status: zod_1.z.enum(['completed', 'failed', 'cancelled']),
+    result: zod_1.z.string(),
+    toolCallCount: zod_1.z.number().int().min(0),
+    toolErrorCount: zod_1.z.number().int().min(0),
+    toolCalls: zod_1.z.array(work_summary_accumulator_1.toolCallSummarySchema).optional(),
+    durationMs: zod_1.z.number().optional(),
+    stoppingReason: zod_1.z.string().optional(),
+    blockers: zod_1.z.array(zod_1.z.string()).optional(),
+});
+function buildDebriefing(input) {
+    const { agentId, role, result, workSummary, startTime, error } = input;
+    const status = error ? 'failed' : 'completed';
+    const durationMs = Date.now() - startTime;
+    const blockers = workSummary.toolCalls
+        .filter((c) => !c.succeeded && c.errorSummary)
+        .map((c) => `${c.toolName}: ${c.errorSummary}`);
+    return {
+        agentId,
+        role,
+        status,
+        result,
+        toolCallCount: workSummary.totalToolCalls,
+        toolErrorCount: workSummary.totalToolErrors,
+        ...(workSummary.toolCalls.length > 0 ? { toolCalls: workSummary.toolCalls } : {}),
+        durationMs,
+        ...(error ? { stoppingReason: error } : {}),
+        ...(blockers.length > 0 ? { blockers } : {}),
+    };
+}
+//# sourceMappingURL=sub-agent-debriefing.js.map

package/dist/agent/sub-agent-debriefing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-debriefing.js","sourceRoot":"","sources":["../../src/agent/sub-agent-debriefing.ts"],"names":[],"mappings":";;;AAsDA,0CAuBC;AA7ED,6BAAwB;AAExB,iFAA2E;AAK9D,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAEhD,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IAEnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAEhB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEpD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAIlB,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtC,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvC,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,gDAAqB,CAAC,CAAC,QAAQ,EAAE;IAIpD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAIjC,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAErC,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAoBH,SAAgB,eAAe,CAAC,KAA2B;IAC1D,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAEvE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAG1C,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,YAAY,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;IAEjD,OAAO;QACN,OAAO;QACP,IAAI;QACJ,MAAM;QACN,MAAM;QACN,aAAa,EAAE,WAAW,CAAC,cAAc;QACzC,cAAc,EAAE,WAAW,CAAC,eAAe;QAC3C,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,UAAU;QACV,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC;AACH,CAAC"}

package/dist/agent/sub-agent-factory.d.ts

@@ -9,6 +9,6 @@ export interface SubAgentOptions {
     modelId: ModelConfig;
     traceRun?: InstanceAiTraceRun;
 }
-declare const SUB_AGENT_PROTOCOL = "## Output Protocol (MANDATORY)\nYou are reporting to a parent agent, NOT a human user. Your output is machine-consumed.\n- Return ONLY structured data: IDs, statuses, errors, counts.\n- NO prose, NO narration, NO emojis, NO markdown headers (## or **bold**), NO filler phrases.\n- Do NOT describe what you are about to do or what you did. Just return the facts.\n- One tool call at a time unless truly independent. Minimum tool calls needed.\n- You cannot delegate to other agents or create plans.\n- If you are stuck or need information only a human can provide, use the ask-user tool.\n- Do NOT retry the same failing approach more than twice \u2014 ask the user instead.";
+declare const SUB_AGENT_PROTOCOL = "## Output Protocol (MANDATORY)\nYou are reporting to a parent agent, NOT a human user. Your output is machine-consumed.\n\n### Structured Result (required)\nReturn a concise result summary: IDs created, statuses, counts, errors encountered.\nNo emojis, no markdown headers, no filler phrases.\n\n### Diagnostic Context (when relevant)\nIf you encountered errors, retried operations, or made non-obvious decisions, add a brief\ndiagnostic section at the end explaining:\n- What approaches you tried and why they failed\n- What blockers remain (missing credentials, permissions, API errors)\n- What assumptions you made\n\nKeep diagnostics to 2-3 sentences maximum. Omit entirely when the task succeeded cleanly.\n\n### Rules\n- One tool call at a time unless truly independent. Minimum tool calls needed.\n- You cannot delegate to other agents or create plans.\n- If you are stuck or need information only a human can provide, use the ask-user tool.\n- Do NOT retry the same failing approach more than twice \u2014 ask the user instead.";
 export { SUB_AGENT_PROTOCOL };
 export declare function createSubAgent(options: SubAgentOptions): Agent;

package/dist/agent/sub-agent-factory.js

@@ -6,9 +6,21 @@ const agent_1 = require("@mastra/core/agent");
 const langsmith_tracing_1 = require("../tracing/langsmith-tracing");
 const SUB_AGENT_PROTOCOL = `## Output Protocol (MANDATORY)
 You are reporting to a parent agent, NOT a human user. Your output is machine-consumed.
-- Return ONLY structured data: IDs, statuses, errors, counts.
-- NO prose, NO narration, NO emojis, NO markdown headers (## or **bold**), NO filler phrases.
-- Do NOT describe what you are about to do or what you did. Just return the facts.
+
+### Structured Result (required)
+Return a concise result summary: IDs created, statuses, counts, errors encountered.
+No emojis, no markdown headers, no filler phrases.
+
+### Diagnostic Context (when relevant)
+If you encountered errors, retried operations, or made non-obvious decisions, add a brief
+diagnostic section at the end explaining:
+- What approaches you tried and why they failed
+- What blockers remain (missing credentials, permissions, API errors)
+- What assumptions you made
+
+Keep diagnostics to 2-3 sentences maximum. Omit entirely when the task succeeded cleanly.
+
+### Rules
 - One tool call at a time unless truly independent. Minimum tool calls needed.
 - You cannot delegate to other agents or create plans.
 - If you are stuck or need information only a human can provide, use the ask-user tool.

package/dist/agent/sub-agent-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"sub-agent-factory.js","sourceRoot":"","sources":["../../src/agent/sub-agent-factory.ts"],"names":[],"mappings":";;;AA2CA,wCA6BC;AAxED,8CAA2C;AAG3C,oEAA0F;AAmB1F,MAAM,kBAAkB,GAAG;;;;;;;;iFAQsD,CAAC;AAEzE,gDAAkB;AAE3B,SAAS,mBAAmB,CAAC,IAAY,EAAE,YAAoB;IAC9D,OAAO,GAAG,kBAAkB;;qCAEQ,IAAI;;;EAGvC,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,SAAgB,cAAc,CAAC,OAAwB;IACtD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE1E,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC;QACvB,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,cAAc,IAAI,EAAE;QAC1B,YAAY,EAAE;YACb,IAAI,EAAE,QAAiB;YACvB,OAAO,EAAE,YAAY;YACrB,eAAe,EAAE;gBAChB,SAAS,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;aAClD;SACD;QACD,KAAK,EAAE,OAAO;QACd,KAAK;KACL,CAAC,CAAC;IAEH,IAAA,uCAAmB,EAClB,QAAQ,EACR,IAAA,yCAAqB,EAAC;QACrB,YAAY;QACZ,KAAK;QACL,OAAO;KACP,CAAC,CACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"sub-agent-factory.js","sourceRoot":"","sources":["../../src/agent/sub-agent-factory.ts"],"names":[],"mappings":";;;AAuDA,wCA6BC;AApFD,8CAA2C;AAG3C,oEAA0F;AAmB1F,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;iFAoBsD,CAAC;AAEzE,gDAAkB;AAE3B,SAAS,mBAAmB,CAAC,IAAY,EAAE,YAAoB;IAC9D,OAAO,GAAG,kBAAkB;;qCAEQ,IAAI;;;EAGvC,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,SAAgB,cAAc,CAAC,OAAwB;IACtD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE1E,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC;QACvB,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,cAAc,IAAI,EAAE;QAC1B,YAAY,EAAE;YACb,IAAI,EAAE,QAAiB;YACvB,OAAO,EAAE,YAAY;YACrB,eAAe,EAAE;gBAChB,SAAS,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;aAClD;SACD;QACD,KAAK,EAAE,OAAO;QACd,KAAK;KACL,CAAC,CAAC;IAEH,IAAA,uCAAmB,EAClB,QAAQ,EACR,IAAA,yCAAqB,EAAC;QACrB,YAAY;QACZ,KAAK;QACL,OAAO;KACP,CAAC,CACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/agent/system-prompt.d.ts

@@ -8,6 +8,7 @@ interface SystemPromptOptions {
     licenseHints?: string[];
     timeZone?: string;
     browserAvailable?: boolean;
+    branchReadOnly?: boolean;
 }
 export declare function getSystemPrompt(options?: SystemPromptOptions): string;
 export {};