beth-copilot 1.0.18 → 1.1.0

package/dist/core/context.test.js

@@ -1,253 +0,0 @@
-/**
- * ConversationContext Tests
- *
- * Tests for conversation state management, message handling,
- * context window enforcement, skill injection, and handoff summaries.
- */
-import { describe, it } from 'node:test';
-import assert from 'node:assert';
-import { ConversationContext } from './context.js';
-// =============================================================================
-// Test Fixtures
-// =============================================================================
-function createTestAgent(overrides) {
-    return {
-        id: 'test-agent',
-        frontmatter: {
-            name: 'Test Agent',
-            description: 'A test agent',
-            tools: ['readFile', 'editFiles'],
-        },
-        body: '# Test Agent\n\nYou are a helpful test agent.',
-        sourcePath: '/test/test-agent.agent.md',
-        ...overrides,
-    };
-}
-function createTestSkill(id, name, body) {
-    return {
-        id,
-        frontmatter: { name },
-        body,
-        sourcePath: `/test/skills/${id}/SKILL.md`,
-        triggers: [`${id} trigger`],
-    };
-}
-// =============================================================================
-// Tests
-// =============================================================================
-describe('ConversationContext', () => {
-    describe('Construction', () => {
-        it('should create with default options', () => {
-            const agent = createTestAgent();
-            const ctx = new ConversationContext(agent);
-            assert.strictEqual(ctx.getTurnCount(), 0);
-            assert.strictEqual(ctx.getRawMessages().length, 0);
-            assert.deepStrictEqual(ctx.getInjectedSkillIds(), []);
-        });
-        it('should create with initial messages', () => {
-            const agent = createTestAgent();
-            const initial = [
-                { role: 'user', content: 'Hello' },
-                { role: 'assistant', content: 'Hi there' },
-            ];
-            const ctx = new ConversationContext(agent, { initialMessages: initial });
-            assert.strictEqual(ctx.getRawMessages().length, 2);
-            assert.strictEqual(ctx.getTurnCount(), 1);
-        });
-        it('should store the agent definition', () => {
-            const agent = createTestAgent({ id: 'my-agent' });
-            const ctx = new ConversationContext(agent);
-            assert.strictEqual(ctx.getAgent().id, 'my-agent');
-        });
-    });
-    describe('Message Management', () => {
-        it('should add user messages', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Hello');
-            ctx.addUserMessage('How are you?');
-            assert.strictEqual(ctx.getTurnCount(), 2);
-            assert.strictEqual(ctx.getRawMessages().length, 2);
-            assert.strictEqual(ctx.getRawMessages()[0].role, 'user');
-            assert.strictEqual(ctx.getRawMessages()[0].content, 'Hello');
-        });
-        it('should add assistant messages', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Hello');
-            ctx.addAssistantMessage('Hi there');
-            const msgs = ctx.getRawMessages();
-            assert.strictEqual(msgs.length, 2);
-            assert.strictEqual(msgs[1].role, 'assistant');
-            assert.strictEqual(msgs[1].content, 'Hi there');
-        });
-        it('should add assistant tool calls', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Read my file');
-            ctx.addAssistantToolCalls([{ id: 'tc1', type: 'function', function: { name: 'readFile', arguments: '{"path":"test.ts"}' } }], 'Let me read that file.');
-            const msgs = ctx.getRawMessages();
-            assert.strictEqual(msgs.length, 2);
-            assert.strictEqual(msgs[1].role, 'assistant');
-            assert.strictEqual(msgs[1].tool_calls?.length, 1);
-            assert.strictEqual(msgs[1].tool_calls[0].function.name, 'readFile');
-            assert.strictEqual(msgs[1].content, 'Let me read that file.');
-        });
-        it('should add tool results', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Read my file');
-            ctx.addAssistantToolCalls([{ id: 'tc1', type: 'function', function: { name: 'readFile', arguments: '{}' } }]);
-            ctx.addToolResult('tc1', 'File contents here');
-            const msgs = ctx.getRawMessages();
-            assert.strictEqual(msgs.length, 3);
-            assert.strictEqual(msgs[2].role, 'tool');
-            assert.strictEqual(msgs[2].tool_call_id, 'tc1');
-            assert.strictEqual(msgs[2].content, 'File contents here');
-        });
-        it('should clear history', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Hello');
-            ctx.addAssistantMessage('Hi');
-            ctx.clearHistory();
-            assert.strictEqual(ctx.getTurnCount(), 0);
-            assert.strictEqual(ctx.getRawMessages().length, 0);
-        });
-    });
-    describe('System Prompt Construction', () => {
-        it('should include agent body in system prompt', () => {
-            const agent = createTestAgent({ body: '# My Agent\n\nSpecial instructions.' });
-            const ctx = new ConversationContext(agent);
-            const prompt = ctx.buildSystemPrompt();
-            assert.ok(prompt.includes('# My Agent'));
-            assert.ok(prompt.includes('Special instructions.'));
-        });
-        it('should include additional context in system prompt', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addContext('Previous agent completed the design phase.');
-            const prompt = ctx.buildSystemPrompt();
-            assert.ok(prompt.includes('Additional Context'));
-            assert.ok(prompt.includes('Previous agent completed the design phase.'));
-        });
-        it('should include injected skills in system prompt', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            const skill = createTestSkill('prd', 'PRD Generation', 'Generate product requirements.');
-            ctx.injectSkill(skill);
-            const prompt = ctx.buildSystemPrompt();
-            assert.ok(prompt.includes('Skill: PRD Generation'));
-            assert.ok(prompt.includes('Generate product requirements.'));
-        });
-        it('getMessages should prepend system prompt', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Hello');
-            const msgs = ctx.getMessages();
-            assert.strictEqual(msgs.length, 2);
-            assert.strictEqual(msgs[0].role, 'system');
-            assert.ok(msgs[0].content.includes('Test Agent'));
-            assert.strictEqual(msgs[1].role, 'user');
-        });
-    });
-    describe('Skill Injection', () => {
-        it('should inject a skill once', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            const skill = createTestSkill('prd', 'PRD', 'PRD content');
-            const first = ctx.injectSkill(skill);
-            const second = ctx.injectSkill(skill);
-            assert.strictEqual(first, true);
-            assert.strictEqual(second, false);
-        });
-        it('should track injected skill IDs', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.injectSkill(createTestSkill('prd', 'PRD', 'content'));
-            ctx.injectSkill(createTestSkill('shadcn', 'shadcn', 'content'));
-            const ids = ctx.getInjectedSkillIds();
-            assert.deepStrictEqual(ids.sort(), ['prd', 'shadcn']);
-        });
-        it('should check if a skill is injected', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.injectSkill(createTestSkill('prd', 'PRD', 'content'));
-            assert.strictEqual(ctx.hasSkill('prd'), true);
-            assert.strictEqual(ctx.hasSkill('other'), false);
-        });
-    });
-    describe('Token Estimation', () => {
-        it('should estimate tokens for context', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Hello world');
-            const tokens = ctx.getEstimatedTokens();
-            assert.ok(tokens > 0);
-        });
-        it('should increase count with more messages', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Hello');
-            const tokensSmall = ctx.getEstimatedTokens();
-            ctx.addAssistantMessage('I am a very helpful assistant with a lot to say about this topic.');
-            ctx.addUserMessage('Tell me more about something else.');
-            const tokensLarge = ctx.getEstimatedTokens();
-            assert.ok(tokensLarge > tokensSmall);
-        });
-    });
-    describe('Context Window Truncation', () => {
-        it('should truncate old messages when exceeding context window', () => {
-            const agent = createTestAgent({ body: 'Short prompt.' });
-            const ctx = new ConversationContext(agent, {
-                maxTokens: 200, // Very small context window
-                responseReserve: 50,
-            });
-            // Add many messages
-            for (let i = 0; i < 20; i++) {
-                ctx.addUserMessage(`Message number ${i} with some extra content to fill tokens.`);
-                ctx.addAssistantMessage(`Response number ${i} with some extra content as well.`);
-            }
-            const msgs = ctx.getMessages();
-            // Should be truncated — fewer messages than what we added
-            assert.ok(msgs.length < 41); // 40 user+assistant + 1 system
-            assert.strictEqual(msgs[0].role, 'system');
-        });
-        it('should return all messages when within context window', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Hello');
-            ctx.addAssistantMessage('Hi');
-            const msgs = ctx.getMessages();
-            assert.strictEqual(msgs.length, 3); // system + user + assistant
-        });
-    });
-    describe('Tool Call Consistency Repair', () => {
-        it('should handle normal tool call flow without issues', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Read file');
-            ctx.addAssistantToolCalls([{ id: 'tc1', type: 'function', function: { name: 'readFile', arguments: '{}' } }]);
-            ctx.addToolResult('tc1', 'file contents');
-            ctx.addAssistantMessage('Here are the contents.');
-            const msgs = ctx.getMessages();
-            // system + user + assistant(tool_calls) + tool + assistant
-            assert.strictEqual(msgs.length, 5);
-        });
-    });
-    describe('Conversation Summary', () => {
-        it('should generate a summary', () => {
-            const ctx = new ConversationContext(createTestAgent({ id: 'developer' }));
-            ctx.addUserMessage('Implement login');
-            ctx.addAssistantMessage('I will create the login component.');
-            ctx.addUserMessage('Include remember me');
-            ctx.addAssistantMessage('Added remember me checkbox.');
-            const summary = ctx.getSummary();
-            assert.strictEqual(summary.agentId, 'developer');
-            assert.strictEqual(summary.turnCount, 2);
-            assert.ok(summary.summary.includes('login component'));
-        });
-        it('should include tool call summary', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            ctx.addUserMessage('Edit file');
-            ctx.addAssistantToolCalls([{ id: 'tc1', type: 'function', function: { name: 'editFile', arguments: '{"path":"a.ts"}' } }]);
-            ctx.addToolResult('tc1', 'OK');
-            ctx.addAssistantMessage('Done.');
-            const summary = ctx.getSummary();
-            assert.ok(summary.toolCallSummary.length > 0);
-            assert.ok(summary.toolCallSummary[0].includes('editFile'));
-        });
-        it('should handle empty conversation', () => {
-            const ctx = new ConversationContext(createTestAgent());
-            const summary = ctx.getSummary();
-            assert.strictEqual(summary.turnCount, 0);
-            assert.ok(summary.summary.includes('No assistant responses'));
-        });
-    });
-});
-//# sourceMappingURL=context.test.js.map

package/dist/core/context.test.js.map

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

package/dist/core/handoffs.d.ts

@@ -1,151 +0,0 @@
-/**
- * Handoff Manager
- *
- * Manages agent-to-agent transfers, including:
- * - Interactive handoffs (user reviews before transfer)
- * - Autonomous handoffs (subagent spawning — orchestrator decides)
- * - Context transfer (conversation summary passed to new agent)
- * - Handoff history tracking
- *
- * Handoffs are defined in agent frontmatter:
- * ```yaml
- * handoffs:
- *   - label: "Development"
- *     agent: developer
- *     prompt: "Implement this feature"
- *     send: true  # auto-send vs. prepare for review
- * ```
- */
-import type { AgentDefinition, AgentHandoff } from './agents/types.js';
-import type { ConversationContext, ConversationSummary } from './context.js';
-import { AgentRouter } from './router.js';
-/**
- * A handoff request — the intent to transfer from one agent to another.
- */
-export interface HandoffRequest {
-    /** Source agent initiating the handoff */
-    fromAgentId: string;
-    /** Target agent receiving the handoff */
-    toAgentId: string;
-    /** The prompt/message to send to the target agent */
-    prompt: string;
-    /** Label for this handoff (from agent definition) */
-    label: string;
-    /** Whether to auto-send or wait for user review */
-    autoSend: boolean;
-    /** Summary of the conversation being handed off */
-    conversationSummary?: ConversationSummary;
-}
-/**
- * The result of executing a handoff.
- */
-export interface HandoffResult {
-    /** Whether the handoff was executed */
-    executed: boolean;
-    /** The target agent (resolved) */
-    targetAgent?: AgentDefinition;
-    /** Reason if handoff was not executed */
-    reason?: string;
-    /** The handoff request that was processed */
-    request: HandoffRequest;
-}
-/**
- * Record of a completed handoff, for history tracking.
- */
-export interface HandoffRecord {
-    /** Handoff request */
-    request: HandoffRequest;
-    /** When the handoff occurred */
-    timestamp: number;
-    /** Whether it was executed */
-    executed: boolean;
-}
-/**
- * Mode for handoff execution.
- */
-export type HandoffMode = 'interactive' | 'autonomous';
-/**
- * Manages agent handoffs and context transfer.
- *
- * @example
- * ```typescript
- * const manager = new HandoffManager(router);
- *
- * // Get available handoffs for the current agent
- * const available = manager.getAvailableHandoffs(bethAgent);
- *
- * // Prepare a handoff
- * const request = manager.prepareHandoff(bethAgent, 'developer', 'Implement login');
- *
- * // Execute the handoff
- * const result = manager.executeHandoff(request, currentContext);
- * ```
- */
-export declare class HandoffManager {
-    /** Router for resolving agent references */
-    private readonly router;
-    /** History of handoffs in this session */
-    private readonly history;
-    /** Maximum depth of handoff chains to prevent infinite loops */
-    private readonly maxDepth;
-    constructor(router: AgentRouter, options?: {
-        maxDepth?: number;
-    });
-    /**
-     * Get the handoff definitions available from an agent.
-     */
-    getAvailableHandoffs(agent: AgentDefinition): AgentHandoff[];
-    /**
-     * Find a handoff definition by target agent name.
-     */
-    findHandoff(agent: AgentDefinition, targetAgentId: string): AgentHandoff | undefined;
-    /**
-     * Prepare a handoff request from the current agent to a target.
-     *
-     * @param fromAgent - The agent initiating the handoff
-     * @param toAgentId - The target agent's ID or name
-     * @param prompt - The message to send (overrides handoff default)
-     * @param context - Optional conversation context for summary
-     * @returns The prepared handoff request, or null if the target agent isn't found
-     */
-    prepareHandoff(fromAgent: AgentDefinition, toAgentId: string, prompt?: string, context?: ConversationContext): HandoffRequest | null;
-    /**
-     * Execute a handoff — validate and prepare the transfer.
-     *
-     * The actual agent switch happens in the orchestrator. This method
-     * validates the handoff, checks depth limits, and records it.
-     *
-     * @param request - The handoff request to execute
-     * @returns The handoff result
-     */
-    executeHandoff(request: HandoffRequest): HandoffResult;
-    /**
-     * Build the context injection string for the target agent.
-     *
-     * Creates a summary of the previous conversation that gets injected
-     * into the new agent's system prompt.
-     */
-    buildHandoffContext(request: HandoffRequest): string;
-    /**
-     * Get the handoff history for this session.
-     */
-    getHistory(): HandoffRecord[];
-    /**
-     * Get the current handoff chain depth for a target agent.
-     * Counts consecutive handoffs in recent history.
-     */
-    getDepth(): number;
-    /**
-     * Clear handoff history (e.g., when starting a new conversation).
-     */
-    clearHistory(): void;
-    /**
-     * Check if handing off to a specific agent would exceed the depth limit.
-     */
-    private isDepthExceeded;
-    /**
-     * Record a handoff in history.
-     */
-    private recordHandoff;
-}
-//# sourceMappingURL=handoffs.d.ts.map

package/dist/core/handoffs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handoffs.d.ts","sourceRoot":"","sources":["../../src/core/handoffs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IAEf,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAElB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAElB,kCAAkC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IAExB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,YAAY,CAAC;AAMvD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IAErC,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAShE;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,EAAE;IAI5D;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWpF;;;;;;;;OAQG;IACH,cAAc,CACZ,SAAS,EAAE,eAAe,EAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,cAAc,GAAG,IAAI;IA0BxB;;;;;;;;OAQG;IACH,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa;IAsCtD;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;IA2BpD;;OAEG;IACH,UAAU,IAAI,aAAa,EAAE;IAI7B;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAOtB"}

package/dist/core/handoffs.js

@@ -1,220 +0,0 @@
-/**
- * Handoff Manager
- *
- * Manages agent-to-agent transfers, including:
- * - Interactive handoffs (user reviews before transfer)
- * - Autonomous handoffs (subagent spawning — orchestrator decides)
- * - Context transfer (conversation summary passed to new agent)
- * - Handoff history tracking
- *
- * Handoffs are defined in agent frontmatter:
- * ```yaml
- * handoffs:
- *   - label: "Development"
- *     agent: developer
- *     prompt: "Implement this feature"
- *     send: true  # auto-send vs. prepare for review
- * ```
- */
-// =============================================================================
-// HandoffManager
-// =============================================================================
-/**
- * Manages agent handoffs and context transfer.
- *
- * @example
- * ```typescript
- * const manager = new HandoffManager(router);
- *
- * // Get available handoffs for the current agent
- * const available = manager.getAvailableHandoffs(bethAgent);
- *
- * // Prepare a handoff
- * const request = manager.prepareHandoff(bethAgent, 'developer', 'Implement login');
- *
- * // Execute the handoff
- * const result = manager.executeHandoff(request, currentContext);
- * ```
- */
-export class HandoffManager {
-    /** Router for resolving agent references */
-    router;
-    /** History of handoffs in this session */
-    history = [];
-    /** Maximum depth of handoff chains to prevent infinite loops */
-    maxDepth;
-    constructor(router, options) {
-        this.router = router;
-        this.maxDepth = options?.maxDepth ?? 10;
-    }
-    // ===========================================================================
-    // Handoff Discovery
-    // ===========================================================================
-    /**
-     * Get the handoff definitions available from an agent.
-     */
-    getAvailableHandoffs(agent) {
-        return agent.frontmatter.handoffs ?? [];
-    }
-    /**
-     * Find a handoff definition by target agent name.
-     */
-    findHandoff(agent, targetAgentId) {
-        const handoffs = this.getAvailableHandoffs(agent);
-        return handoffs.find((h) => h.agent.toLowerCase() === targetAgentId.toLowerCase());
-    }
-    // ===========================================================================
-    // Handoff Preparation
-    // ===========================================================================
-    /**
-     * Prepare a handoff request from the current agent to a target.
-     *
-     * @param fromAgent - The agent initiating the handoff
-     * @param toAgentId - The target agent's ID or name
-     * @param prompt - The message to send (overrides handoff default)
-     * @param context - Optional conversation context for summary
-     * @returns The prepared handoff request, or null if the target agent isn't found
-     */
-    prepareHandoff(fromAgent, toAgentId, prompt, context) {
-        // Resolve the target agent
-        const targetAgent = this.router.resolveAgent(toAgentId);
-        if (!targetAgent) {
-            return null;
-        }
-        // Look up the handoff definition for defaults
-        const handoffDef = this.findHandoff(fromAgent, toAgentId);
-        const request = {
-            fromAgentId: fromAgent.id,
-            toAgentId: targetAgent.id,
-            prompt: prompt ?? handoffDef?.prompt ?? '',
-            label: handoffDef?.label ?? `Handoff to ${targetAgent.frontmatter.name}`,
-            autoSend: handoffDef?.send ?? false,
-            conversationSummary: context?.getSummary(),
-        };
-        return request;
-    }
-    // ===========================================================================
-    // Handoff Execution
-    // ===========================================================================
-    /**
-     * Execute a handoff — validate and prepare the transfer.
-     *
-     * The actual agent switch happens in the orchestrator. This method
-     * validates the handoff, checks depth limits, and records it.
-     *
-     * @param request - The handoff request to execute
-     * @returns The handoff result
-     */
-    executeHandoff(request) {
-        // Check depth limit to prevent infinite handoff chains
-        if (this.isDepthExceeded(request.toAgentId)) {
-            const result = {
-                executed: false,
-                reason: `Handoff depth limit (${this.maxDepth}) exceeded — possible loop detected`,
-                request,
-            };
-            this.recordHandoff(request, false);
-            return result;
-        }
-        // Resolve the target agent
-        const targetAgent = this.router.resolveAgent(request.toAgentId);
-        if (!targetAgent) {
-            const result = {
-                executed: false,
-                reason: `Agent "${request.toAgentId}" not found`,
-                request,
-            };
-            this.recordHandoff(request, false);
-            return result;
-        }
-        // Record and succeed
-        this.recordHandoff(request, true);
-        return {
-            executed: true,
-            targetAgent,
-            request,
-        };
-    }
-    // ===========================================================================
-    // Context Transfer
-    // ===========================================================================
-    /**
-     * Build the context injection string for the target agent.
-     *
-     * Creates a summary of the previous conversation that gets injected
-     * into the new agent's system prompt.
-     */
-    buildHandoffContext(request) {
-        const parts = [];
-        parts.push(`## Handoff from ${request.fromAgentId}`);
-        parts.push(`**Reason:** ${request.label}`);
-        if (request.conversationSummary) {
-            const summary = request.conversationSummary;
-            parts.push(`**Previous conversation** (${summary.turnCount} turns with ${summary.agentId}):`);
-            parts.push(summary.summary);
-            if (summary.toolCallSummary.length > 0) {
-                parts.push(`**Tools used:** ${summary.toolCallSummary.join(', ')}`);
-            }
-        }
-        if (request.prompt) {
-            parts.push(`\n**Task:** ${request.prompt}`);
-        }
-        return parts.join('\n');
-    }
-    // ===========================================================================
-    // History & Safety
-    // ===========================================================================
-    /**
-     * Get the handoff history for this session.
-     */
-    getHistory() {
-        return [...this.history];
-    }
-    /**
-     * Get the current handoff chain depth for a target agent.
-     * Counts consecutive handoffs in recent history.
-     */
-    getDepth() {
-        return this.history.filter((h) => h.executed).length;
-    }
-    /**
-     * Clear handoff history (e.g., when starting a new conversation).
-     */
-    clearHistory() {
-        this.history.length = 0;
-    }
-    /**
-     * Check if handing off to a specific agent would exceed the depth limit.
-     */
-    isDepthExceeded(_targetAgentId) {
-        const executedCount = this.history.filter((h) => h.executed).length;
-        if (executedCount >= this.maxDepth) {
-            return true;
-        }
-        // Also check for direct ping-pong loops (A→B→A→B...)
-        const recentExecuted = this.history
-            .filter((h) => h.executed)
-            .slice(-4);
-        if (recentExecuted.length >= 4) {
-            const pattern = recentExecuted.map((h) => h.request.toAgentId);
-            // Check for A-B-A-B pattern
-            if (pattern[0] === pattern[2] &&
-                pattern[1] === pattern[3] &&
-                pattern[0] !== pattern[1]) {
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * Record a handoff in history.
-     */
-    recordHandoff(request, executed) {
-        this.history.push({
-            request,
-            timestamp: Date.now(),
-            executed,
-        });
-    }
-}
-//# sourceMappingURL=handoffs.js.map

package/dist/core/handoffs.js.map

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

package/dist/core/handoffs.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * HandoffManager Tests
- *
- * Tests for agent-to-agent transfers: preparation, execution,
- * context building, depth limits, and loop detection.
- */
-export {};
-//# sourceMappingURL=handoffs.test.d.ts.map