@illuma-ai/agents 1.0.90 → 1.0.93

package/src/graphs/handoffValidation.test.js

@@ -0,0 +1,276 @@
+/**
+ * Unit tests for MultiAgentGraph handoff validation and pre-handoff compaction.
+ *
+ * These tests exercise the handoff logic (destination validation, compaction threshold,
+ * briefing generation, error formatting) without instantiating the full MultiAgentGraph.
+ * We test the helper functions directly and verify the behavioral patterns that
+ * the graph's agent node closure relies on.
+ */
+import { HumanMessage, AIMessage, SystemMessage, ToolMessage, } from '@langchain/core/messages';
+import { summarize, createEmergencySummary, buildFullSummaryPrompt, formatMessagesForSummary, } from '@/messages';
+// ---------------------------------------------------------------------------
+// 1. Handoff destination validation logic
+// ---------------------------------------------------------------------------
+describe('handoff destination validation', () => {
+    it('detects non-existent agent in contexts map', () => {
+        const agentContexts = new Map([
+            ['agent-a', { agentId: 'agent-a', name: 'Agent A' }],
+            ['agent-b', { agentId: 'agent-b', name: 'Agent B' }],
+        ]);
+        const handoffDest = 'agent-c';
+        expect(agentContexts.has(handoffDest)).toBe(false);
+        const availableAgents = Array.from(agentContexts.keys()).join(', ');
+        expect(availableAgents).toBe('agent-a, agent-b');
+    });
+    it('passes validation for existing agent', () => {
+        const agentContexts = new Map([
+            ['agent-a', { agentId: 'agent-a', name: 'Agent A' }],
+        ]);
+        expect(agentContexts.has('agent-a')).toBe(true);
+    });
+    it('handles empty contexts map', () => {
+        const agentContexts = new Map();
+        expect(agentContexts.has('any-agent')).toBe(false);
+        const availableAgents = Array.from(agentContexts.keys()).join(', ');
+        expect(availableAgents).toBe('');
+    });
+});
+// ---------------------------------------------------------------------------
+// 2. Pre-handoff compaction threshold
+// ---------------------------------------------------------------------------
+describe('pre-handoff compaction threshold', () => {
+    it('triggers compaction when context exceeds 70% of receiver budget', () => {
+        const receiverBudget = 100000;
+        const currentSize = 75000; // 75%
+        expect(currentSize > receiverBudget * 0.7).toBe(true);
+    });
+    it('skips compaction when context fits within 70% of receiver budget', () => {
+        const receiverBudget = 100000;
+        const currentSize = 60000; // 60%
+        expect(currentSize > receiverBudget * 0.7).toBe(false);
+    });
+    it('triggers compaction at exactly the boundary (>70%)', () => {
+        const receiverBudget = 100000;
+        // Exactly 70% should NOT trigger (condition is strictly >)
+        expect(70000 > receiverBudget * 0.7).toBe(false);
+        // Just above 70% should trigger
+        expect(70001 > receiverBudget * 0.7).toBe(true);
+    });
+    it('computes summary budget as 20% of receiver budget', () => {
+        const receiverBudget = 100000;
+        const summaryBudget = Math.floor(receiverBudget * 0.2);
+        expect(summaryBudget).toBe(20000);
+    });
+});
+// ---------------------------------------------------------------------------
+// 3. Handoff briefing via summarize (multi-agent aware)
+// ---------------------------------------------------------------------------
+describe('handoff briefing generation', () => {
+    it('generates multi-agent aware briefing', async () => {
+        const messages = [
+            new HumanMessage('Analyze the data'),
+            new AIMessage('I found 3 key patterns...'),
+            new HumanMessage('Can you elaborate on pattern 2?'),
+            new AIMessage('Pattern 2 shows...'),
+        ];
+        const callback = jest.fn().mockResolvedValue('## 5. Agent Workflow State\n- Agent A analyzed data and found 3 patterns');
+        const result = await summarize(messages, callback, {
+            isMultiAgent: true,
+            agentWorkflowState: {
+                currentAgentId: 'agent-b',
+                agentChain: ['agent-a', 'agent-b'],
+                pendingAgents: [],
+            },
+            summaryBudget: 2000,
+        });
+        // Without a tokenCounter the budget check is skipped, so full tier is returned
+        expect(result.tier).toBe('full');
+        expect(result.summary).toContain('Agent Workflow State');
+        // Verify callback was called with the full prompt containing agent workflow info
+        expect(callback).toHaveBeenCalledWith(expect.stringContaining('Agent Workflow State'), expect.any(Number));
+    });
+    it('includes agent chain in the prompt', () => {
+        const conversation = formatMessagesForSummary([
+            new HumanMessage('Hello'),
+        ]);
+        const prompt = buildFullSummaryPrompt(conversation, {
+            isMultiAgent: true,
+            agentWorkflowState: {
+                currentAgentId: 'agent-b',
+                agentChain: ['agent-a', 'agent-b'],
+                pendingAgents: ['agent-c'],
+            },
+        });
+        expect(prompt).toContain('Current agent: agent-b');
+        expect(prompt).toContain('Agent chain: agent-a -> agent-b');
+        expect(prompt).toContain('Pending agents: agent-c');
+    });
+    it('shows N/A for single-agent conversations', () => {
+        const conversation = formatMessagesForSummary([
+            new HumanMessage('Hello'),
+        ]);
+        const prompt = buildFullSummaryPrompt(conversation);
+        expect(prompt).toContain('N/A (single-agent conversation)');
+    });
+});
+// ---------------------------------------------------------------------------
+// 4. Emergency briefing fallback
+// ---------------------------------------------------------------------------
+describe('emergency briefing fallback', () => {
+    it('generates briefing without LLM when callback fails', async () => {
+        const messages = [
+            new HumanMessage('Analyze this'),
+            new AIMessage('Here is the analysis...'),
+        ];
+        const failingCallback = jest.fn().mockRejectedValue(new Error('LLM timeout'));
+        const result = await summarize(messages, failingCallback);
+        expect(result.tier).toBe('emergency');
+        expect(result.summary).toContain('[Emergency Context Summary]');
+        expect(result.summary).toContain('Analyze this');
+    });
+    it('falls to emergency when both full and simple callbacks fail', async () => {
+        let callCount = 0;
+        const failingCallback = jest.fn().mockImplementation(() => {
+            callCount++;
+            throw new Error(`Failure #${callCount}`);
+        });
+        const messages = [
+            new HumanMessage('Do something'),
+            new AIMessage('Working on it...'),
+            new ToolMessage({ content: 'result', tool_call_id: 'tc-1', name: 'search' }),
+        ];
+        const result = await summarize(messages, failingCallback);
+        expect(result.tier).toBe('emergency');
+        expect(result.summary).toContain('Do something');
+        expect(result.summary).toContain('Working on it...');
+        expect(result.summary).toContain('search');
+        expect(result.messagesCompacted).toBe(3);
+    });
+    it('createEmergencySummary captures first user message and last AI message', () => {
+        const messages = [
+            new HumanMessage('First user message'),
+            new AIMessage('First AI response'),
+            new HumanMessage('Second user message'),
+            new AIMessage('Second AI response'),
+        ];
+        const summary = createEmergencySummary(messages);
+        expect(summary).toContain('[Emergency Context Summary]');
+        expect(summary).toContain('Original request: First user message');
+        expect(summary).toContain('Last response: Second AI response');
+        expect(summary).toContain('Tools used: none');
+        expect(summary).toContain('Messages compacted: 4');
+    });
+    it('createEmergencySummary collects unique tool names', () => {
+        const messages = [
+            new HumanMessage('Test'),
+            new ToolMessage({ content: 'ok', tool_call_id: 'tc-1', name: 'search' }),
+            new ToolMessage({ content: 'ok', tool_call_id: 'tc-2', name: 'search' }),
+            new ToolMessage({ content: 'ok', tool_call_id: 'tc-3', name: 'calculator' }),
+        ];
+        const summary = createEmergencySummary(messages);
+        expect(summary).toContain('search');
+        expect(summary).toContain('calculator');
+    });
+});
+// ---------------------------------------------------------------------------
+// 5. Handoff error ToolMessage format
+// ---------------------------------------------------------------------------
+describe('handoff error message format', () => {
+    it('creates properly formatted error ToolMessage', () => {
+        const availableAgents = 'agent-a, agent-b, agent-c';
+        const handoffDest = 'nonexistent-agent';
+        const errorMsg = new ToolMessage({
+            content: `Transfer failed: agent "${handoffDest}" does not exist. Available agents: ${availableAgents}. Please choose a valid agent to transfer to.`,
+            tool_call_id: 'call-123',
+            name: `transfer_to_${handoffDest}`,
+        });
+        expect(errorMsg.content).toContain('does not exist');
+        expect(errorMsg.content).toContain(availableAgents);
+        expect(errorMsg.tool_call_id).toBe('call-123');
+        expect(errorMsg.name).toBe('transfer_to_nonexistent-agent');
+    });
+    it('error message includes all available agents', () => {
+        const agentContexts = new Map([
+            ['alpha', {}],
+            ['beta', {}],
+            ['gamma', {}],
+        ]);
+        const availableAgents = Array.from(agentContexts.keys()).join(', ');
+        const errorMsg = new ToolMessage({
+            content: `Transfer failed: agent "delta" does not exist. Available agents: ${availableAgents}. Please choose a valid agent to transfer to.`,
+            tool_call_id: 'call-456',
+            name: 'lc_transfer_to_delta',
+        });
+        expect(errorMsg.content).toContain('alpha, beta, gamma');
+        expect(errorMsg.getType()).toBe('tool');
+    });
+});
+// ---------------------------------------------------------------------------
+// 6. Compacted handoff message structure
+// ---------------------------------------------------------------------------
+describe('compacted handoff message structure', () => {
+    it('keeps briefing + last 3 messages', () => {
+        const originalMessages = [
+            new HumanMessage('msg 1'),
+            new AIMessage('msg 2'),
+            new HumanMessage('msg 3'),
+            new AIMessage('msg 4'),
+            new HumanMessage('msg 5'),
+            new AIMessage('msg 6'),
+        ];
+        const briefingMsg = new SystemMessage('[Handoff Briefing]\nAgent A completed analysis');
+        const keepCount = Math.min(3, originalMessages.length);
+        const compacted = [
+            briefingMsg,
+            ...originalMessages.slice(originalMessages.length - keepCount),
+        ];
+        expect(compacted).toHaveLength(4); // briefing + 3 messages
+        expect(compacted[0].getType()).toBe('system');
+        expect(compacted[0].content).toContain('Handoff Briefing');
+        expect(compacted[3].getType()).toBe('ai'); // last message preserved
+    });
+    it('keeps all messages when fewer than 3 remain', () => {
+        const originalMessages = [
+            new HumanMessage('only message'),
+            new AIMessage('only response'),
+        ];
+        const briefingMsg = new SystemMessage('[Handoff Briefing]\nBriefing text');
+        const keepCount = Math.min(3, originalMessages.length);
+        const compacted = [
+            briefingMsg,
+            ...originalMessages.slice(originalMessages.length - keepCount),
+        ];
+        // briefing + 2 original messages
+        expect(compacted).toHaveLength(3);
+        expect(compacted[1].content).toBe('only message');
+        expect(compacted[2].content).toBe('only response');
+    });
+    it('preserves the handoff tool message as the last message', () => {
+        const originalMessages = [
+            new HumanMessage('do X'),
+            new AIMessage('calling agent-b'),
+            new ToolMessage({
+                content: 'Transferred to agent-b',
+                tool_call_id: 'tc-handoff',
+                name: 'lc_transfer_to_agent-b',
+            }),
+        ];
+        const briefingMsg = new SystemMessage('[Handoff Briefing]\nContext');
+        const keepCount = Math.min(3, originalMessages.length);
+        const compacted = [
+            briefingMsg,
+            ...originalMessages.slice(originalMessages.length - keepCount),
+        ];
+        const lastMsg = compacted[compacted.length - 1];
+        expect(lastMsg.getType()).toBe('tool');
+        expect(lastMsg.name).toContain('lc_transfer_to_');
+    });
+    it('briefing contains sender name in the expected format', () => {
+        const senderName = 'Research Agent';
+        const summaryText = 'User asked about market trends. Found 5 data points.';
+        const briefingMsg = new SystemMessage(`[Handoff Briefing from "${senderName}"]\n${summaryText}`);
+        expect(briefingMsg.content).toContain(`Handoff Briefing from "Research Agent"`);
+        expect(briefingMsg.content).toContain(summaryText);
+    });
+});
+//# sourceMappingURL=handoffValidation.test.js.map

package/src/graphs/handoffValidation.test.js.map

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

package/src/graphs/handoffValidation.test.ts

@@ -0,0 +1,353 @@
+/**
+ * Unit tests for MultiAgentGraph handoff validation and pre-handoff compaction.
+ *
+ * These tests exercise the handoff logic (destination validation, compaction threshold,
+ * briefing generation, error formatting) without instantiating the full MultiAgentGraph.
+ * We test the helper functions directly and verify the behavioral patterns that
+ * the graph's agent node closure relies on.
+ */
+import {
+  HumanMessage,
+  AIMessage,
+  SystemMessage,
+  ToolMessage,
+} from '@langchain/core/messages';
+import {
+  summarize,
+  createEmergencySummary,
+  buildFullSummaryPrompt,
+  formatMessagesForSummary,
+} from '@/messages';
+
+// ---------------------------------------------------------------------------
+// 1. Handoff destination validation logic
+// ---------------------------------------------------------------------------
+describe('handoff destination validation', () => {
+  it('detects non-existent agent in contexts map', () => {
+    const agentContexts = new Map([
+      ['agent-a', { agentId: 'agent-a', name: 'Agent A' }],
+      ['agent-b', { agentId: 'agent-b', name: 'Agent B' }],
+    ]);
+
+    const handoffDest = 'agent-c';
+    expect(agentContexts.has(handoffDest)).toBe(false);
+
+    const availableAgents = Array.from(agentContexts.keys()).join(', ');
+    expect(availableAgents).toBe('agent-a, agent-b');
+  });
+
+  it('passes validation for existing agent', () => {
+    const agentContexts = new Map([
+      ['agent-a', { agentId: 'agent-a', name: 'Agent A' }],
+    ]);
+
+    expect(agentContexts.has('agent-a')).toBe(true);
+  });
+
+  it('handles empty contexts map', () => {
+    const agentContexts = new Map<string, { agentId: string; name: string }>();
+    expect(agentContexts.has('any-agent')).toBe(false);
+
+    const availableAgents = Array.from(agentContexts.keys()).join(', ');
+    expect(availableAgents).toBe('');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// 2. Pre-handoff compaction threshold
+// ---------------------------------------------------------------------------
+describe('pre-handoff compaction threshold', () => {
+  it('triggers compaction when context exceeds 70% of receiver budget', () => {
+    const receiverBudget = 100000;
+    const currentSize = 75000; // 75%
+    expect(currentSize > receiverBudget * 0.7).toBe(true);
+  });
+
+  it('skips compaction when context fits within 70% of receiver budget', () => {
+    const receiverBudget = 100000;
+    const currentSize = 60000; // 60%
+    expect(currentSize > receiverBudget * 0.7).toBe(false);
+  });
+
+  it('triggers compaction at exactly the boundary (>70%)', () => {
+    const receiverBudget = 100000;
+    // Exactly 70% should NOT trigger (condition is strictly >)
+    expect(70000 > receiverBudget * 0.7).toBe(false);
+    // Just above 70% should trigger
+    expect(70001 > receiverBudget * 0.7).toBe(true);
+  });
+
+  it('computes summary budget as 20% of receiver budget', () => {
+    const receiverBudget = 100000;
+    const summaryBudget = Math.floor(receiverBudget * 0.2);
+    expect(summaryBudget).toBe(20000);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// 3. Handoff briefing via summarize (multi-agent aware)
+// ---------------------------------------------------------------------------
+describe('handoff briefing generation', () => {
+  it('generates multi-agent aware briefing', async () => {
+    const messages = [
+      new HumanMessage('Analyze the data'),
+      new AIMessage('I found 3 key patterns...'),
+      new HumanMessage('Can you elaborate on pattern 2?'),
+      new AIMessage('Pattern 2 shows...'),
+    ];
+
+    const callback = jest
+      .fn()
+      .mockResolvedValue(
+        '## 5. Agent Workflow State\n- Agent A analyzed data and found 3 patterns'
+      );
+
+    const result = await summarize(messages, callback, {
+      isMultiAgent: true,
+      agentWorkflowState: {
+        currentAgentId: 'agent-b',
+        agentChain: ['agent-a', 'agent-b'],
+        pendingAgents: [],
+      },
+      summaryBudget: 2000,
+    });
+
+    // Without a tokenCounter the budget check is skipped, so full tier is returned
+    expect(result.tier).toBe('full');
+    expect(result.summary).toContain('Agent Workflow State');
+    // Verify callback was called with the full prompt containing agent workflow info
+    expect(callback).toHaveBeenCalledWith(
+      expect.stringContaining('Agent Workflow State'),
+      expect.any(Number)
+    );
+  });
+
+  it('includes agent chain in the prompt', () => {
+    const conversation = formatMessagesForSummary([new HumanMessage('Hello')]);
+    const prompt = buildFullSummaryPrompt(conversation, {
+      isMultiAgent: true,
+      agentWorkflowState: {
+        currentAgentId: 'agent-b',
+        agentChain: ['agent-a', 'agent-b'],
+        pendingAgents: ['agent-c'],
+      },
+    });
+
+    expect(prompt).toContain('Current agent: agent-b');
+    expect(prompt).toContain('Agent chain: agent-a -> agent-b');
+    expect(prompt).toContain('Pending agents: agent-c');
+  });
+
+  it('shows N/A for single-agent conversations', () => {
+    const conversation = formatMessagesForSummary([new HumanMessage('Hello')]);
+    const prompt = buildFullSummaryPrompt(conversation);
+
+    expect(prompt).toContain('N/A (single-agent conversation)');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// 4. Emergency briefing fallback
+// ---------------------------------------------------------------------------
+describe('emergency briefing fallback', () => {
+  it('generates briefing without LLM when callback fails', async () => {
+    const messages = [
+      new HumanMessage('Analyze this'),
+      new AIMessage('Here is the analysis...'),
+    ];
+
+    const failingCallback = jest
+      .fn()
+      .mockRejectedValue(new Error('LLM timeout'));
+    const result = await summarize(messages, failingCallback);
+
+    expect(result.tier).toBe('emergency');
+    expect(result.summary).toContain('[Emergency Context Summary]');
+    expect(result.summary).toContain('Analyze this');
+  });
+
+  it('falls to emergency when both full and simple callbacks fail', async () => {
+    let callCount = 0;
+    const failingCallback = jest.fn().mockImplementation(() => {
+      callCount++;
+      throw new Error(`Failure #${callCount}`);
+    });
+
+    const messages = [
+      new HumanMessage('Do something'),
+      new AIMessage('Working on it...'),
+      new ToolMessage({
+        content: 'result',
+        tool_call_id: 'tc-1',
+        name: 'search',
+      }),
+    ];
+
+    const result = await summarize(messages, failingCallback);
+
+    expect(result.tier).toBe('emergency');
+    expect(result.summary).toContain('Do something');
+    expect(result.summary).toContain('Working on it...');
+    expect(result.summary).toContain('search');
+    expect(result.messagesCompacted).toBe(3);
+  });
+
+  it('createEmergencySummary captures first user message and last AI message', () => {
+    const messages = [
+      new HumanMessage('First user message'),
+      new AIMessage('First AI response'),
+      new HumanMessage('Second user message'),
+      new AIMessage('Second AI response'),
+    ];
+
+    const summary = createEmergencySummary(messages);
+
+    expect(summary).toContain('[Emergency Context Summary]');
+    expect(summary).toContain('Original request: First user message');
+    expect(summary).toContain('Last response: Second AI response');
+    expect(summary).toContain('Tools used: none');
+    expect(summary).toContain('Messages compacted: 4');
+  });
+
+  it('createEmergencySummary collects unique tool names', () => {
+    const messages = [
+      new HumanMessage('Test'),
+      new ToolMessage({ content: 'ok', tool_call_id: 'tc-1', name: 'search' }),
+      new ToolMessage({ content: 'ok', tool_call_id: 'tc-2', name: 'search' }),
+      new ToolMessage({
+        content: 'ok',
+        tool_call_id: 'tc-3',
+        name: 'calculator',
+      }),
+    ];
+
+    const summary = createEmergencySummary(messages);
+
+    expect(summary).toContain('search');
+    expect(summary).toContain('calculator');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// 5. Handoff error ToolMessage format
+// ---------------------------------------------------------------------------
+describe('handoff error message format', () => {
+  it('creates properly formatted error ToolMessage', () => {
+    const availableAgents = 'agent-a, agent-b, agent-c';
+    const handoffDest = 'nonexistent-agent';
+
+    const errorMsg = new ToolMessage({
+      content: `Transfer failed: agent "${handoffDest}" does not exist. Available agents: ${availableAgents}. Please choose a valid agent to transfer to.`,
+      tool_call_id: 'call-123',
+      name: `transfer_to_${handoffDest}`,
+    });
+
+    expect(errorMsg.content).toContain('does not exist');
+    expect(errorMsg.content).toContain(availableAgents);
+    expect(errorMsg.tool_call_id).toBe('call-123');
+    expect(errorMsg.name).toBe('transfer_to_nonexistent-agent');
+  });
+
+  it('error message includes all available agents', () => {
+    const agentContexts = new Map([
+      ['alpha', {}],
+      ['beta', {}],
+      ['gamma', {}],
+    ]);
+    const availableAgents = Array.from(agentContexts.keys()).join(', ');
+
+    const errorMsg = new ToolMessage({
+      content: `Transfer failed: agent "delta" does not exist. Available agents: ${availableAgents}. Please choose a valid agent to transfer to.`,
+      tool_call_id: 'call-456',
+      name: 'lc_transfer_to_delta',
+    });
+
+    expect(errorMsg.content).toContain('alpha, beta, gamma');
+    expect(errorMsg.getType()).toBe('tool');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// 6. Compacted handoff message structure
+// ---------------------------------------------------------------------------
+describe('compacted handoff message structure', () => {
+  it('keeps briefing + last 3 messages', () => {
+    const originalMessages = [
+      new HumanMessage('msg 1'),
+      new AIMessage('msg 2'),
+      new HumanMessage('msg 3'),
+      new AIMessage('msg 4'),
+      new HumanMessage('msg 5'),
+      new AIMessage('msg 6'),
+    ];
+
+    const briefingMsg = new SystemMessage(
+      '[Handoff Briefing]\nAgent A completed analysis'
+    );
+    const keepCount = Math.min(3, originalMessages.length);
+    const compacted = [
+      briefingMsg,
+      ...originalMessages.slice(originalMessages.length - keepCount),
+    ];
+
+    expect(compacted).toHaveLength(4); // briefing + 3 messages
+    expect(compacted[0].getType()).toBe('system');
+    expect(compacted[0].content).toContain('Handoff Briefing');
+    expect(compacted[3].getType()).toBe('ai'); // last message preserved
+  });
+
+  it('keeps all messages when fewer than 3 remain', () => {
+    const originalMessages = [
+      new HumanMessage('only message'),
+      new AIMessage('only response'),
+    ];
+
+    const briefingMsg = new SystemMessage('[Handoff Briefing]\nBriefing text');
+    const keepCount = Math.min(3, originalMessages.length);
+    const compacted = [
+      briefingMsg,
+      ...originalMessages.slice(originalMessages.length - keepCount),
+    ];
+
+    // briefing + 2 original messages
+    expect(compacted).toHaveLength(3);
+    expect(compacted[1].content).toBe('only message');
+    expect(compacted[2].content).toBe('only response');
+  });
+
+  it('preserves the handoff tool message as the last message', () => {
+    const originalMessages = [
+      new HumanMessage('do X'),
+      new AIMessage('calling agent-b'),
+      new ToolMessage({
+        content: 'Transferred to agent-b',
+        tool_call_id: 'tc-handoff',
+        name: 'lc_transfer_to_agent-b',
+      }),
+    ];
+
+    const briefingMsg = new SystemMessage('[Handoff Briefing]\nContext');
+    const keepCount = Math.min(3, originalMessages.length);
+    const compacted = [
+      briefingMsg,
+      ...originalMessages.slice(originalMessages.length - keepCount),
+    ];
+
+    const lastMsg = compacted[compacted.length - 1];
+    expect(lastMsg.getType()).toBe('tool');
+    expect((lastMsg as ToolMessage).name).toContain('lc_transfer_to_');
+  });
+
+  it('briefing contains sender name in the expected format', () => {
+    const senderName = 'Research Agent';
+    const summaryText = 'User asked about market trends. Found 5 data points.';
+    const briefingMsg = new SystemMessage(
+      `[Handoff Briefing from "${senderName}"]\n${summaryText}`
+    );
+
+    expect(briefingMsg.content).toContain(
+      'Handoff Briefing from "Research Agent"'
+    );
+    expect(briefingMsg.content).toContain(summaryText);
+  });
+});

package/src/graphs/index.js

@@ -0,0 +1,3 @@
+export * from './Graph';
+export * from './MultiAgentGraph';
+//# sourceMappingURL=index.js.map

package/src/graphs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}