@roj-ai/sdk 0.1.11 → 0.1.13

package/dist/plugins/agents/plugin.js

@@ -18,6 +18,102 @@ import { getNextAgentSeq } from '../../core/sessions/state.js';
 import { createTool } from '../../core/tools/definition.js';
 import { Err, Ok } from '../../lib/utils/result.js';
 import { mailboxPlugin } from '../../plugins/mailbox/plugin.js';
+/**
+ * Recommended supervision interval — 4 min, just under prompt cache TTL.
+ * Each tick triggers a parent inference, keeping the prompt cache warm.
+ */
+export const SUPERVISION_INTERVAL_CACHE_FRIENDLY = 240_000;
+/**
+ * Get all direct children of an agent.
+ */
+function getDirectChildren(sessionAgents, parentId) {
+    const out = [];
+    for (const agent of sessionAgents.values()) {
+        if (agent.parentId === parentId)
+            out.push(agent);
+    }
+    return out;
+}
+/**
+ * Count assistant tool calls across conversation history + currently pending.
+ */
+function countToolCalls(state) {
+    let total = state.pendingToolCalls.length;
+    for (const m of state.conversationHistory) {
+        if (m.role === 'assistant' && m.toolCalls)
+            total += m.toolCalls.length;
+    }
+    return total;
+}
+/**
+ * Count completed LLM inferences (= assistant turns in history).
+ */
+function countLLMCalls(state) {
+    let total = 0;
+    for (const m of state.conversationHistory) {
+        if (m.role === 'assistant')
+            total++;
+    }
+    return total;
+}
+/**
+ * Build a compact "first N words..last M words" preview of the agent's most
+ * recent assistant message (skipping empty turns). Returns null if none.
+ */
+function previewLastAssistant(state, headWords = 5, tailWords = 5) {
+    for (let i = state.conversationHistory.length - 1; i >= 0; i--) {
+        const m = state.conversationHistory[i];
+        if (m.role !== 'assistant')
+            continue;
+        const text = m.content?.trim();
+        if (!text)
+            continue;
+        const words = text.split(/\s+/);
+        if (words.length <= headWords + tailWords + 1)
+            return text;
+        return `${words.slice(0, headWords).join(' ')}..${words.slice(-tailWords).join(' ')}`;
+    }
+    return null;
+}
+/**
+ * Build a compact children-status snapshot for the given parent agent.
+ */
+function buildChildrenStatus(sessionAgents, parentId) {
+    const children = getDirectChildren(sessionAgents, parentId);
+    const lines = children.map((c) => {
+        const tools = countToolCalls(c);
+        const llm = countLLMCalls(c);
+        const subs = getDirectChildren(sessionAgents, c.id).length;
+        const last = previewLastAssistant(c);
+        const parts = [c.id, c.status];
+        parts.push(`${tools} tools`);
+        parts.push(`${llm} llm`);
+        if (subs > 0)
+            parts.push(`${subs} sub${subs === 1 ? '' : 's'}`);
+        if (last)
+            parts.push(`last "${last.replaceAll('"', "'")}"`);
+        return parts.join(', ');
+    });
+    return `<children-status>\n${lines.join('\n')}\n</children-status>`;
+}
+/**
+ * (Re)schedule a supervision tick for an agent. Any existing timer is cleared first.
+ */
+function scheduleSupervisionTick(pluginContext, agentId, delayMs) {
+    const existing = pluginContext.timers.get(agentId);
+    if (existing)
+        clearTimeout(existing);
+    const timer = setTimeout(() => {
+        pluginContext.timers.delete(agentId);
+        const trigger = pluginContext.triggerTick;
+        if (!trigger)
+            return;
+        trigger(agentId).catch((err) => {
+            pluginContext.logger?.error('Supervision tick failed', err instanceof Error ? err : undefined, { agentId });
+        });
+    }, delayMs);
+    pluginContext.timers.set(agentId, timer);
+}
 /**
  * Creates the Zod schema for a start_<agent_name> tool.
  * If the agent has an inputSchema, includes a typed `input` field.
@@ -36,6 +132,12 @@ function createStartAgentSchema(agent) {
 export const agentsPlugin = definePlugin('agents')
     .pluginConfig()
     .dependencies([mailboxPlugin])
+    .context(async () => ({
+    timers: new Map(),
+    triggerTick: null,
+    intervalMs: null,
+    logger: null,
+}))
     .isEnabled((ctx) => {
     return ctx.agentConfig.spawnableAgents.length > 0;
 })
@@ -82,6 +184,10 @@ export const agentsPlugin = definePlugin('agents')
             definitionName: input.definitionName,
             parentId: input.parentId,
         });
+        // Ensure parent has a supervision tick running now that it has a child.
+        if (ctx.pluginContext.intervalMs !== null) {
+            scheduleSupervisionTick(ctx.pluginContext, parentId, ctx.pluginContext.intervalMs);
+        }
         return Ok({ agentId });
     },
 })
@@ -157,12 +263,93 @@ export const agentsPlugin = definePlugin('agents')
         return Ok({});
     },
 })
-    .systemPrompt(() => {
-    return `## Working with Child Agents
+    .method('_supervisionTick', {
+    input: z.object({ agentId: agentIdSchema }),
+    output: z.object({}),
+    handler: async (ctx, input) => {
+        const agentId = AgentId(input.agentId);
+        // Self may already be gone (terminated mid-tick); just stop.
+        if (!ctx.sessionState.agents.has(agentId))
+            return Ok({});
+        const children = getDirectChildren(ctx.sessionState.agents, agentId);
+        if (children.length === 0) {
+            // No active children → don't reschedule. spawn() will re-arm if/when needed.
+            return Ok({});
+        }
+        const snapshot = buildChildrenStatus(ctx.sessionState.agents, agentId);
+        const sendResult = await ctx.deps.mailbox.send({
+            toAgentId: agentId,
+            content: snapshot,
+            fromSupervisor: true,
+        });
+        if (!sendResult.ok) {
+            ctx.logger.warn('Supervision snapshot send failed', {
+                agentId,
+                error: sendResult.error.message,
+            });
+        }
+        // Reschedule the next tick from now (rolling).
+        if (ctx.pluginContext.intervalMs !== null) {
+            scheduleSupervisionTick(ctx.pluginContext, agentId, ctx.pluginContext.intervalMs);
+        }
+        return Ok({});
+    },
+})
+    .sessionHook('onSessionReady', async (ctx) => {
+    const intervalMs = ctx.pluginConfig.superviseChildrenIntervalMs;
+    if (intervalMs === undefined) {
+        // Supervision disabled (default). No timer wiring; spawn() and
+        // afterInference() check intervalMs === null and skip too.
+        ctx.pluginContext.intervalMs = null;
+        return;
+    }
+    ctx.pluginContext.intervalMs = intervalMs;
+    ctx.pluginContext.logger = ctx.logger;
+    // Wire the trigger callback — calls back via self.* so each tick gets a
+    // fresh ctx (live sessionState/pluginState/deps).
+    ctx.pluginContext.triggerTick = (agentId) => ctx.self._supervisionTick({ agentId });
+    // (Re-)schedule timers for every agent that currently has direct children.
+    // Covers initial session creation AND server-restart reload (onSessionReady
+    // fires in both paths). Worst-case drift after restart = intervalMs.
+    for (const agent of ctx.sessionState.agents.values()) {
+        if (getDirectChildren(ctx.sessionState.agents, agent.id).length > 0) {
+            scheduleSupervisionTick(ctx.pluginContext, agent.id, intervalMs);
+        }
+    }
+})
+    .sessionHook('onSessionClose', async (ctx) => {
+    for (const t of ctx.pluginContext.timers.values())
+        clearTimeout(t);
+    ctx.pluginContext.timers.clear();
+    ctx.pluginContext.triggerTick = null;
+})
+    .hook('afterInference', async (ctx) => {
+    // Natural inference warmed the cache — push the next tick out by intervalMs
+    // so we don't double-charge for parents who are already actively interacting.
+    if (ctx.pluginContext.intervalMs !== null) {
+        if (getDirectChildren(ctx.sessionState.agents, ctx.agentId).length > 0) {
+            scheduleSupervisionTick(ctx.pluginContext, ctx.agentId, ctx.pluginContext.intervalMs);
+        }
+    }
+    return null;
+})
+    .systemPrompt((ctx) => {
+    const base = `## Working with Child Agents
 
 - **New task** → spawn a new agent using \`start_<agent_name>\`. You will receive the agent's ID in the result — use it with \`send_message\` for follow-up communication.
 - **Follow-up on an existing task** → send a message to the existing agent via \`send_message\` with the agent's ID. Do NOT spawn a new agent for feedback, corrections, or additional instructions on a task already assigned.
 - Spawned agents communicate back to you via \`send_message\`. Check your incoming messages for their results and progress updates.`;
+    // Only include supervision instructions if supervision is actually enabled
+    // for this session — otherwise the section is misleading bloat.
+    if (ctx.pluginContext.intervalMs === null)
+        return base;
+    return `${base}
+
+### Supervision messages
+
+You will periodically receive a \`<children-status>\` message from \`from="supervisor"\`. It is a status snapshot of your direct children — purely informational. Per child you'll see status, cumulative tool/llm call counts, sub-agent count, and a "first words..last words" preview of their last assistant turn.
+
+Do NOT act on a supervision tick unless something is genuinely wrong (a child has been errored or stuck for a long time, you have a deadline, etc.). Most of the time you should just wait. Never reply to the supervisor.`;
 })
     .tools((ctx) => {
     const spawnableAgents = ctx.agentConfig.spawnableAgents;

package/dist/plugins/agents/plugin.js.map

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

package/dist/plugins/agents/supervision.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=supervision.integration.test.d.ts.map

package/dist/plugins/agents/supervision.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervision.integration.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/agents/supervision.integration.test.ts"],"names":[],"mappings":""}

package/dist/plugins/agents/supervision.integration.test.js

@@ -0,0 +1,215 @@
+import { describe, expect, it } from 'bun:test';
+import { MockLLMProvider } from '../../core/llm/mock.js';
+import { ToolCallId } from '../../core/tools/schema.js';
+import { agentsPlugin } from '../../plugins/agents/plugin.js';
+import { mailboxEvents } from '../../plugins/mailbox/index.js';
+import { createMultiAgentPreset, TestHarness } from '../../testing/index.js';
+/**
+ * Helper — wait until at least one supervision message has landed in the parent's
+ * mailbox (or timeout). We poll because supervision ticks fire on real timers.
+ */
+async function waitForSupervisorMessage(session, toAgentId, timeoutMs = 2000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const events = await session.getEventsByType(mailboxEvents, 'mailbox_message');
+        const found = events.find((e) => e.message.from === 'supervisor'
+            && e.toAgentId === toAgentId
+            && typeof e.message.content === 'string');
+        if (found)
+            return found;
+        await new Promise((r) => setTimeout(r, 25));
+    }
+    return undefined;
+}
+describe('agents plugin supervision', () => {
+    it('parent with active children receives a periodic <children-status> snapshot', async () => {
+        let orchestratorCalls = 0;
+        let workerCalls = 0;
+        const harness = new TestHarness({
+            presets: [{
+                    ...createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' }),
+                    plugins: [{ pluginName: 'agents', definition: agentsPlugin, config: { superviseChildrenIntervalMs: 100 } }],
+                }],
+            mockHandler: (request) => {
+                if (request.systemPrompt.includes('Orchestrator')) {
+                    orchestratorCalls++;
+                    if (orchestratorCalls === 1) {
+                        return {
+                            content: null,
+                            toolCalls: [{ id: ToolCallId('tc1'), name: 'start_worker', input: { message: 'Long-running task' } }],
+                            finishReason: 'stop',
+                            metrics: MockLLMProvider.defaultMetrics(),
+                        };
+                    }
+                    // Subsequent calls: orchestrator does nothing more, just acknowledges.
+                    return { content: 'noted', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                }
+                // Worker: takes a long time — say something but never reports back.
+                workerCalls++;
+                return { content: `Working on step ${workerCalls}`, toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+            },
+        });
+        const session = await harness.createSession('test');
+        await session.sendMessage('Start');
+        // Orchestrator is the entry agent in this preset. Wait for a tick.
+        const orchestratorId = session.getEntryAgentId();
+        const supervisorMsg = await waitForSupervisorMessage(session, orchestratorId);
+        expect(supervisorMsg).toBeDefined();
+        expect(supervisorMsg.message.content).toContain('<children-status>');
+        expect(supervisorMsg.message.content).toContain('worker_1');
+        // Cumulative LLM call count should be present
+        expect(supervisorMsg.message.content).toMatch(/worker_1[^,\n]*,[^,\n]*,\s*\d+ tools,\s*\d+ llm/);
+        await harness.shutdown();
+    });
+    it('default (no config) → supervision disabled, no tick fires', async () => {
+        const harness = new TestHarness({
+            presets: [createMultiAgentPreset([
+                    { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                ], { orchestratorSystem: 'Orchestrator agent.' })],
+            mockHandler: (request) => {
+                if (request.systemPrompt.includes('Orchestrator')) {
+                    return {
+                        content: null,
+                        toolCalls: [{ id: ToolCallId('tc1'), name: 'start_worker', input: { message: 'Do work' } }],
+                        finishReason: 'stop',
+                        metrics: MockLLMProvider.defaultMetrics(),
+                    };
+                }
+                return { content: 'Working', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+            },
+        });
+        const session = await harness.createSession('test');
+        await session.sendMessage('Start');
+        // Wait long enough for ticks if they were enabled (they shouldn't).
+        await new Promise((r) => setTimeout(r, 300));
+        const events = await session.getEventsByType(mailboxEvents, 'mailbox_message');
+        const supervisorMessages = events.filter(e => e.message.from === 'supervisor');
+        expect(supervisorMessages).toHaveLength(0);
+        await harness.shutdown();
+    });
+    it('parent without children → no tick fires', async () => {
+        const harness = new TestHarness({
+            presets: [{
+                    ...createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' }),
+                    plugins: [{ pluginName: 'agents', definition: agentsPlugin, config: { superviseChildrenIntervalMs: 100 } }],
+                }],
+            mockHandler: (request) => {
+                // Orchestrator never spawns anyone.
+                if (request.systemPrompt.includes('Orchestrator')) {
+                    return { content: 'Done without spawning', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                }
+                return { content: 'unused', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+            },
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Start');
+        // Give supervision plenty of room to fire (it shouldn't).
+        await new Promise((r) => setTimeout(r, 300));
+        const events = await session.getEventsByType(mailboxEvents, 'mailbox_message');
+        const supervisorMessages = events.filter(e => e.message.from === 'supervisor');
+        expect(supervisorMessages).toHaveLength(0);
+        await harness.shutdown();
+    });
+    it('snapshot includes "first words..last words" preview of last assistant turn', async () => {
+        let orchestratorCalls = 0;
+        const harness = new TestHarness({
+            presets: [{
+                    ...createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' }),
+                    plugins: [{ pluginName: 'agents', definition: agentsPlugin, config: { superviseChildrenIntervalMs: 100 } }],
+                }],
+            mockHandler: (request) => {
+                if (request.systemPrompt.includes('Orchestrator')) {
+                    orchestratorCalls++;
+                    if (orchestratorCalls === 1) {
+                        return {
+                            content: null,
+                            toolCalls: [{ id: ToolCallId('tc1'), name: 'start_worker', input: { message: 'Long task' } }],
+                            finishReason: 'stop',
+                            metrics: MockLLMProvider.defaultMetrics(),
+                        };
+                    }
+                    return { content: 'ack', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                }
+                // Worker says a long sentence that should be truncated to first..last words
+                return {
+                    content: 'Started fetching data and now I am running through the pipeline analyzing the response carefully',
+                    toolCalls: [],
+                    finishReason: 'stop',
+                    metrics: MockLLMProvider.defaultMetrics(),
+                };
+            },
+        });
+        const session = await harness.createSession('test');
+        await session.sendMessage('Start');
+        const orchestratorId = session.getEntryAgentId();
+        const msg = await waitForSupervisorMessage(session, orchestratorId);
+        expect(msg).toBeDefined();
+        // Should contain both head (first 5 words) and tail (last 5 words), joined by ".."
+        expect(msg.message.content).toContain('Started fetching data and now');
+        expect(msg.message.content).toContain('pipeline analyzing the response carefully');
+        expect(msg.message.content).toMatch(/\.\.pipeline/);
+        await harness.shutdown();
+    });
+    it('server restart re-establishes timers via onSessionReady', async () => {
+        const sharedEventStore = new (await import('../../core/events/memory.js')).MemoryEventStore();
+        // Counter shared across phases — phase 1 spawns once, then orchestrator goes idle;
+        // phase 2 just acknowledges any wake-up triggered by the supervision tick.
+        let orchestratorCalls = 0;
+        const buildHarness = (intervalMs) => new TestHarness({
+            eventStore: sharedEventStore,
+            presets: [{
+                    ...createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' }),
+                    ...(intervalMs !== undefined && {
+                        plugins: [{ pluginName: 'agents', definition: agentsPlugin, config: { superviseChildrenIntervalMs: intervalMs } }],
+                    }),
+                }],
+            mockHandler: (request) => {
+                if (request.systemPrompt.includes('Orchestrator')) {
+                    orchestratorCalls++;
+                    if (orchestratorCalls === 1) {
+                        return {
+                            content: null,
+                            toolCalls: [{ id: ToolCallId('tc1'), name: 'start_worker', input: { message: 'Long task' } }],
+                            finishReason: 'stop',
+                            metrics: MockLLMProvider.defaultMetrics(),
+                        };
+                    }
+                    return { content: 'noted', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                }
+                return { content: 'still working', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+            },
+        });
+        // Phase 1: create session with supervision DISABLED (default) so no ticks pre-restart.
+        const harness1 = buildHarness(undefined);
+        const session1 = await harness1.createSession('test');
+        await session1.sendAndWaitForIdle('Start');
+        const hasWorker = () => {
+            for (const agent of session1.state.agents.values()) {
+                if (agent.definitionName === 'worker')
+                    return true;
+            }
+            return false;
+        };
+        expect(hasWorker()).toBe(true);
+        const sessionId = session1.sessionId;
+        await harness1.shutdown();
+        // Phase 2: restart with supervision enabled. onSessionReady should
+        // re-arm the orchestrator's tick because it has a child.
+        const harness2 = buildHarness(100);
+        const session2 = await harness2.openSession(sessionId);
+        const orchestratorId = session2.getEntryAgentId();
+        const msg = await waitForSupervisorMessage(session2, orchestratorId, 1500);
+        expect(msg).toBeDefined();
+        expect(msg.message.content).toContain('worker_1');
+        await harness2.shutdown();
+    });
+});
+//# sourceMappingURL=supervision.integration.test.js.map

package/dist/plugins/agents/supervision.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervision.integration.test.js","sourceRoot":"","sources":["../../../src/plugins/agents/supervision.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/plugins/mailbox/mailbox.integration.test.js

@@ -498,6 +498,86 @@ describe('mailbox plugin', () => {
             expect(completionMessages).toHaveLength(0);
             await harness.shutdown();
         });
+        it('empty-stop LLM response → agent retries; persistent empty → onError reports to parent', async () => {
+            let workerCalls = 0;
+            let orchestratorCalls = 0;
+            const harness = new TestHarness({
+                presets: [createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' })],
+                mockHandler: (request) => {
+                    if (request.systemPrompt.includes('Orchestrator')) {
+                        orchestratorCalls++;
+                        if (orchestratorCalls === 1) {
+                            return {
+                                content: null,
+                                toolCalls: [{ id: ToolCallId('tc1'), name: 'start_worker', input: { message: 'Do work' } }],
+                                finishReason: 'stop',
+                                metrics: MockLLMProvider.defaultMetrics(),
+                            };
+                        }
+                        return { content: 'Done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                    }
+                    workerCalls++;
+                    // Always empty-stop → triggers retry until exhausted, then onError
+                    return { content: null, toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                },
+            });
+            const session = await harness.createSession('test');
+            await session.sendMessage('Start');
+            // Worker ends up errored (not idle); poll for the error message to parent.
+            const deadline = Date.now() + 5000;
+            let errMsg;
+            while (Date.now() < deadline) {
+                const events = await session.getEventsByType(mailboxEvents, 'mailbox_message');
+                errMsg = events.find(e => e.message.from === AgentId('worker_1')
+                    && typeof e.message.content === 'string'
+                    && e.message.content.startsWith('Agent encountered an error:'));
+                if (errMsg)
+                    break;
+                await new Promise((r) => setTimeout(r, 50));
+            }
+            // Initial + 2 retries = 3 worker LLM calls
+            expect(workerCalls).toBe(3);
+            expect(errMsg).toBeDefined();
+            await harness.shutdown();
+        });
+        it('empty-stop LLM response → recovers on retry, no error sent', async () => {
+            let workerCalls = 0;
+            let orchestratorCalls = 0;
+            const harness = new TestHarness({
+                presets: [createMultiAgentPreset([
+                        { name: 'worker', system: 'Worker agent.', tools: [], agents: [] },
+                    ], { orchestratorSystem: 'Orchestrator agent.' })],
+                mockHandler: (request) => {
+                    if (request.systemPrompt.includes('Orchestrator')) {
+                        orchestratorCalls++;
+                        if (orchestratorCalls === 1) {
+                            return {
+                                content: null,
+                                toolCalls: [{ id: ToolCallId('tc1'), name: 'start_worker', input: { message: 'Do work' } }],
+                                finishReason: 'stop',
+                                metrics: MockLLMProvider.defaultMetrics(),
+                            };
+                        }
+                        return { content: 'Done', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                    }
+                    workerCalls++;
+                    if (workerCalls === 1) {
+                        return { content: null, toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                    }
+                    return { content: 'Recovered', toolCalls: [], finishReason: 'stop', metrics: MockLLMProvider.defaultMetrics() };
+                },
+            });
+            const session = await harness.createSession('test');
+            await session.sendAndWaitForIdle('Start');
+            expect(workerCalls).toBe(2);
+            const events = await session.getEventsByType(mailboxEvents, 'mailbox_message');
+            const errMsg = events.find(e => typeof e.message.content === 'string'
+                && e.message.content.startsWith('Agent encountered an error:'));
+            expect(errMsg).toBeUndefined();
+            await harness.shutdown();
+        });
         it('agent without parent → no completion message even with flag true', async () => {
             const harness = new TestHarness({
                 presets: [createTestPreset({