beth-copilot 1.0.15 → 1.0.16

package/dist/core/router.js

@@ -0,0 +1,178 @@
+/**
+ * Agent Router
+ *
+ * Routes user requests to the appropriate agent based on:
+ * 1. Explicit @agent mentions in user input
+ * 2. Active handoff targets from the current agent
+ * 3. Skill trigger matching
+ * 4. Default to the orchestrator (Beth)
+ *
+ * Also provides agent lookup utilities for the orchestrator.
+ */
+import { findMatchingSkills, buildTriggerMap } from './skills/loader.js';
+// =============================================================================
+// AgentRouter
+// =============================================================================
+/**
+ * Routes requests to the appropriate agent.
+ *
+ * @example
+ * ```typescript
+ * const router = new AgentRouter(agentLoadResult, skillLoadResult, 'beth');
+ *
+ * const result = router.route('@developer implement login page');
+ * // result.agent.id === 'developer'
+ * // result.reason === 'mention'
+ * // result.cleanedPrompt === 'implement login page'
+ *
+ * const result2 = router.route('create a prd for auth');
+ * // result2.matchedSkills contains the PRD skill
+ * ```
+ */
+export class AgentRouter {
+    /** Map of agent ID → agent definition */
+    agents;
+    /** Map of agent name (lowercase) → agent ID for lookup */
+    nameToId;
+    /** Skill trigger map for matching */
+    triggerMap;
+    /** Default agent ID (typically 'beth') */
+    defaultAgentId;
+    constructor(agentResult, skillResult, defaultAgentId = 'beth') {
+        this.agents = new Map();
+        this.nameToId = new Map();
+        this.defaultAgentId = defaultAgentId;
+        for (const agent of agentResult.agents) {
+            this.agents.set(agent.id, agent);
+            // Map both ID and name for flexible lookup
+            this.nameToId.set(agent.id.toLowerCase(), agent.id);
+            if (agent.frontmatter.name) {
+                this.nameToId.set(agent.frontmatter.name.toLowerCase(), agent.id);
+            }
+        }
+        this.triggerMap = buildTriggerMap(skillResult);
+    }
+    // ===========================================================================
+    // Routing
+    // ===========================================================================
+    /**
+     * Route a user message to the appropriate agent.
+     *
+     * @param userMessage - The user's input text
+     * @param currentAgentId - The currently active agent (for handoff context)
+     * @returns Routing result with selected agent and matched skills
+     */
+    route(userMessage, currentAgentId) {
+        // 1. Check for explicit @mention
+        const mentionResult = this.checkMention(userMessage);
+        if (mentionResult) {
+            return {
+                ...mentionResult,
+                matchedSkills: this.findSkills(mentionResult.cleanedPrompt ?? userMessage),
+            };
+        }
+        // 2. Find matching skills
+        const matchedSkills = this.findSkills(userMessage);
+        // 3. Use current agent if one is active (stay in context)
+        if (currentAgentId) {
+            const currentAgent = this.agents.get(currentAgentId);
+            if (currentAgent) {
+                return {
+                    agent: currentAgent,
+                    reason: 'default',
+                    matchedSkills,
+                };
+            }
+        }
+        // 4. Default to orchestrator
+        const defaultAgent = this.getDefaultAgent();
+        return {
+            agent: defaultAgent,
+            reason: 'default',
+            matchedSkills,
+        };
+    }
+    /**
+     * Route directly to a specific agent by ID or name.
+     *
+     * @param agentIdOrName - Agent ID or display name
+     * @returns The agent definition, or undefined if not found
+     */
+    resolveAgent(agentIdOrName) {
+        // Try direct ID lookup first
+        const direct = this.agents.get(agentIdOrName);
+        if (direct)
+            return direct;
+        // Try name-based lookup (case-insensitive)
+        const id = this.nameToId.get(agentIdOrName.toLowerCase());
+        if (id)
+            return this.agents.get(id);
+        return undefined;
+    }
+    /**
+     * Get all registered agents.
+     */
+    getAgents() {
+        return [...this.agents.values()];
+    }
+    /**
+     * Get agents that can be invoked as subagents (infer: true).
+     */
+    getInferableAgents() {
+        return [...this.agents.values()].filter((a) => a.frontmatter.infer === true);
+    }
+    /**
+     * Get the default orchestrator agent.
+     */
+    getDefaultAgent() {
+        const agent = this.agents.get(this.defaultAgentId);
+        if (!agent) {
+            // Fallback: return the first agent
+            const first = this.agents.values().next().value;
+            if (!first) {
+                throw new Error('No agents loaded — cannot route requests');
+            }
+            return first;
+        }
+        return agent;
+    }
+    /**
+     * Check if a specific agent is registered.
+     */
+    hasAgent(agentIdOrName) {
+        return this.resolveAgent(agentIdOrName) !== undefined;
+    }
+    // ===========================================================================
+    // Internal Routing Logic
+    // ===========================================================================
+    /**
+     * Check for @agent mention in user input.
+     *
+     * Matches patterns like:
+     * - "@developer implement the login page"
+     * - "@product-manager create a PRD"
+     * - "@Beth plan a feature"
+     */
+    checkMention(userMessage) {
+        const mentionMatch = userMessage.match(/^@(\S+)\s*(.*)/s);
+        if (!mentionMatch)
+            return null;
+        const mentionName = mentionMatch[1];
+        const restOfMessage = mentionMatch[2].trim();
+        const agent = this.resolveAgent(mentionName);
+        if (!agent)
+            return null;
+        return {
+            agent,
+            reason: 'mention',
+            cleanedPrompt: restOfMessage || userMessage,
+        };
+    }
+    /**
+     * Find skills whose triggers match the user message.
+     */
+    findSkills(userMessage) {
+        return findMatchingSkills(userMessage, this.triggerMap);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/core/router.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * AgentRouter Tests
+ *
+ * Tests for agent routing: @mention parsing, skill trigger matching,
+ * agent resolution, and default routing behavior.
+ */
+export {};
+//# sourceMappingURL=router.test.d.ts.map

package/dist/core/router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.test.d.ts","sourceRoot":"","sources":["../../src/core/router.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/router.test.js

@@ -0,0 +1,215 @@
+/**
+ * AgentRouter Tests
+ *
+ * Tests for agent routing: @mention parsing, skill trigger matching,
+ * agent resolution, and default routing behavior.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { AgentRouter } from './router.js';
+// =============================================================================
+// Test Fixtures
+// =============================================================================
+function createAgent(id, name, infer) {
+    return {
+        id,
+        frontmatter: {
+            name,
+            description: `${name} agent`,
+            tools: ['readFile'],
+            infer,
+            handoffs: [
+                { label: 'Test Handoff', agent: 'tester', prompt: 'Test this' },
+            ],
+        },
+        body: `# ${name}`,
+        sourcePath: `/agents/${id}.agent.md`,
+    };
+}
+function createSkill(id, name, triggers) {
+    return {
+        id,
+        frontmatter: { name, description: `Triggers on: ${triggers.join(', ')}` },
+        body: `Skill content for ${name}`,
+        sourcePath: `/skills/${id}/SKILL.md`,
+        triggers,
+    };
+}
+function createTestRouter(agents, skills, defaultId) {
+    const agentResult = {
+        agents: agents ?? [
+            createAgent('beth', 'Beth', true),
+            createAgent('developer', 'developer', true),
+            createAgent('tester', 'tester', true),
+            createAgent('product-manager', 'product-manager', true),
+            createAgent('ux-designer', 'ux-designer', true),
+        ],
+        errors: [],
+    };
+    const skillResult = {
+        skills: skills ?? [
+            createSkill('prd', 'PRD Generation', ['create a prd', 'product requirements']),
+            createSkill('shadcn-ui', 'shadcn/ui', ['shadcn', 'ui component']),
+        ],
+        errors: [],
+    };
+    return new AgentRouter(agentResult, skillResult, defaultId ?? 'beth');
+}
+// =============================================================================
+// Tests
+// =============================================================================
+describe('AgentRouter', () => {
+    describe('Construction', () => {
+        it('should create with agents and skills', () => {
+            const router = createTestRouter();
+            assert.ok(router.hasAgent('beth'));
+            assert.ok(router.hasAgent('developer'));
+            assert.strictEqual(router.getAgents().length, 5);
+        });
+        it('should handle empty agents', () => {
+            assert.throws(() => {
+                const router = createTestRouter([]);
+                router.route('hello');
+            }, /No agents loaded/);
+        });
+    });
+    describe('Route by @mention', () => {
+        it('should route @developer to developer agent', () => {
+            const router = createTestRouter();
+            const result = router.route('@developer implement login');
+            assert.strictEqual(result.agent.id, 'developer');
+            assert.strictEqual(result.reason, 'mention');
+            assert.strictEqual(result.cleanedPrompt, 'implement login');
+        });
+        it('should route @Beth to Beth agent (case-insensitive name)', () => {
+            const router = createTestRouter();
+            const result = router.route('@Beth plan a feature');
+            assert.strictEqual(result.agent.id, 'beth');
+            assert.strictEqual(result.reason, 'mention');
+            assert.strictEqual(result.cleanedPrompt, 'plan a feature');
+        });
+        it('should route @product-manager correctly', () => {
+            const router = createTestRouter();
+            const result = router.route('@product-manager create a PRD');
+            assert.strictEqual(result.agent.id, 'product-manager');
+            assert.strictEqual(result.reason, 'mention');
+        });
+        it('should fall through to default for unknown @mention', () => {
+            const router = createTestRouter();
+            const result = router.route('@unknown-agent do something');
+            // Unknown mention falls through to default behavior
+            assert.strictEqual(result.reason, 'default');
+        });
+        it('should handle @mention with no trailing text', () => {
+            const router = createTestRouter();
+            const result = router.route('@developer');
+            // '@developer' without trailing text — the match won't capture the second group
+            // This should fall through since the regex requires whitespace after the mention
+            assert.ok(result.agent !== undefined);
+        });
+    });
+    describe('Route with skill matching', () => {
+        it('should find matching skills in user message', () => {
+            const router = createTestRouter();
+            const result = router.route('create a prd for authentication');
+            assert.ok(result.matchedSkills.length > 0);
+            assert.strictEqual(result.matchedSkills[0].id, 'prd');
+        });
+        it('should find shadcn skills', () => {
+            const router = createTestRouter();
+            const result = router.route('add a shadcn button component');
+            assert.ok(result.matchedSkills.length > 0);
+            assert.strictEqual(result.matchedSkills[0].id, 'shadcn-ui');
+        });
+        it('should return empty skills when no triggers match', () => {
+            const router = createTestRouter();
+            const result = router.route('hello world');
+            assert.strictEqual(result.matchedSkills.length, 0);
+        });
+        it('should combine @mention routing with skill matching', () => {
+            const router = createTestRouter();
+            const result = router.route('@developer create a shadcn button');
+            assert.strictEqual(result.agent.id, 'developer');
+            assert.strictEqual(result.reason, 'mention');
+            assert.ok(result.matchedSkills.length > 0);
+        });
+    });
+    describe('Default routing', () => {
+        it('should default to Beth when no mention or current agent', () => {
+            const router = createTestRouter();
+            const result = router.route('do something');
+            assert.strictEqual(result.agent.id, 'beth');
+            assert.strictEqual(result.reason, 'default');
+        });
+        it('should stay with current agent when one is active', () => {
+            const router = createTestRouter();
+            const result = router.route('do something else', 'developer');
+            assert.strictEqual(result.agent.id, 'developer');
+            assert.strictEqual(result.reason, 'default');
+        });
+        it('@mention should override current agent', () => {
+            const router = createTestRouter();
+            const result = router.route('@tester test this', 'developer');
+            assert.strictEqual(result.agent.id, 'tester');
+            assert.strictEqual(result.reason, 'mention');
+        });
+    });
+    describe('Agent resolution', () => {
+        it('should resolve by ID', () => {
+            const router = createTestRouter();
+            const agent = router.resolveAgent('developer');
+            assert.strictEqual(agent?.id, 'developer');
+        });
+        it('should resolve by name (case-insensitive)', () => {
+            const router = createTestRouter();
+            const agent = router.resolveAgent('Beth');
+            assert.strictEqual(agent?.id, 'beth');
+        });
+        it('should return undefined for unknown agent', () => {
+            const router = createTestRouter();
+            const agent = router.resolveAgent('nonexistent');
+            assert.strictEqual(agent, undefined);
+        });
+        it('should check agent existence', () => {
+            const router = createTestRouter();
+            assert.strictEqual(router.hasAgent('developer'), true);
+            assert.strictEqual(router.hasAgent('nonexistent'), false);
+        });
+    });
+    describe('Inferable agents', () => {
+        it('should return agents with infer: true', () => {
+            const router = createTestRouter();
+            const inferable = router.getInferableAgents();
+            assert.ok(inferable.length > 0);
+            for (const agent of inferable) {
+                assert.strictEqual(agent.frontmatter.infer, true);
+            }
+        });
+        it('should not include non-inferable agents', () => {
+            const agents = [
+                createAgent('beth', 'Beth', true),
+                createAgent('helper', 'Helper', false),
+                createAgent('developer', 'developer', true),
+            ];
+            const router = createTestRouter(agents);
+            const inferable = router.getInferableAgents();
+            assert.strictEqual(inferable.length, 2);
+            const ids = inferable.map((a) => a.id);
+            assert.ok(!ids.includes('helper'));
+        });
+    });
+    describe('Default agent', () => {
+        it('should return the configured default agent', () => {
+            const router = createTestRouter(undefined, undefined, 'beth');
+            const agent = router.getDefaultAgent();
+            assert.strictEqual(agent.id, 'beth');
+        });
+        it('should fallback to first agent if default not found', () => {
+            const agents = [createAgent('dev', 'Developer')];
+            const router = createTestRouter(agents, [], 'nonexistent');
+            const agent = router.getDefaultAgent();
+            assert.strictEqual(agent.id, 'dev');
+        });
+    });
+});
+//# sourceMappingURL=router.test.js.map

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

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

package/dist/index.d.ts

@@ -5,6 +5,15 @@
  */
 export * from './core/agents/index.js';
 export * from './core/skills/index.js';
+export { Orchestrator } from './core/orchestrator.js';
+export type { OrchestratorConfig, TurnResult, ToolCallRecord, SubagentResult, OrchestratorObserver, } from './core/orchestrator.js';
+export { ConversationContext } from './core/context.js';
+export type { ConversationContextOptions, ConversationSummary, } from './core/context.js';
+export { AgentRouter } from './core/router.js';
+export type { RouteResult, RouteReason } from './core/router.js';
+export { HandoffManager } from './core/handoffs.js';
+export type { HandoffRequest, HandoffResult, HandoffRecord, HandoffMode, } from './core/handoffs.js';
 export * from './lib/index.js';
 export * from './cli/commands/index.js';
+export * from './tools/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,wBAAwB,CAAC;AAGvC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,wBAAwB,CAAC;AAGvC,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,yBAAyB,CAAC;AAGxC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -7,8 +7,15 @@
 export * from './core/agents/index.js';
 // Core exports - Skills
 export * from './core/skills/index.js';
+// Core exports - Orchestration
+export { Orchestrator } from './core/orchestrator.js';
+export { ConversationContext } from './core/context.js';
+export { AgentRouter } from './core/router.js';
+export { HandoffManager } from './core/handoffs.js';
 // Library utilities
 export * from './lib/index.js';
 // CLI commands
 export * from './cli/commands/index.js';
+// Tool abstraction layer
+export * from './tools/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAwB;AACxB,cAAc,wBAAwB,CAAC;AAEvC,wBAAwB;AACxB,cAAc,wBAAwB,CAAC;AAEvC,oBAAoB;AACpB,cAAc,gBAAgB,CAAC;AAE/B,eAAe;AACf,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAwB;AACxB,cAAc,wBAAwB,CAAC;AAEvC,wBAAwB;AACxB,cAAc,wBAAwB,CAAC;AAEvC,+BAA+B;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAKxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQpD,oBAAoB;AACpB,cAAc,gBAAgB,CAAC;AAE/B,eAAe;AACf,cAAc,yBAAyB,CAAC;AAExC,yBAAyB;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/tools/cli/beads.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Beads Tool
+ *
+ * Wraps the `bd` CLI for issue tracking via the beads system.
+ * Supports creating, closing, listing, and inspecting issues
+ * and their dependency trees.
+ *
+ * @see https://github.com/steveyegge/beads
+ */
+import { execFile as nodeExecFile } from 'node:child_process';
+import type { Tool } from '../interface.js';
+/** Type for the execFile callback-style function, used for dependency injection in tests */
+type ExecFileFn = typeof nodeExecFile;
+/**
+ * Create a beads tool instance.
+ *
+ * Accepts an optional `execFn` for dependency injection in tests.
+ * When omitted, uses `node:child_process.execFile`.
+ *
+ * @param execFn - Optional execFile function for testing
+ * @returns A Tool implementation for beads
+ */
+export declare function createBeadsTool(execFn?: ExecFileFn): Tool;
+/** Default beads tool instance using real execFile */
+export declare const beadsTool: Tool;
+export {};
+//# sourceMappingURL=beads.d.ts.map

package/dist/tools/cli/beads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beads.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/beads.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,4FAA4F;AAC5F,KAAK,UAAU,GAAG,OAAO,YAAY,CAAC;AAsGtC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CA2EzD;AAED,sDAAsD;AACtD,eAAO,MAAM,SAAS,EAAE,IAAwB,CAAC"}