@jackchen_me/open-multi-agent 0.1.0

package/dist/agent/agent.js

@@ -0,0 +1,294 @@
+/**
+ * @fileoverview High-level Agent class for open-multi-agent.
+ *
+ * {@link Agent} is the primary interface most consumers interact with.
+ * It wraps {@link AgentRunner} with:
+ *  - Persistent conversation history (`prompt()`)
+ *  - Fresh-conversation semantics (`run()`)
+ *  - Streaming support (`stream()`)
+ *  - Dynamic tool registration at runtime
+ *  - Full lifecycle state tracking (`idle → running → completed | error`)
+ *
+ * @example
+ * ```ts
+ * const agent = new Agent({
+ *   name: 'researcher',
+ *   model: 'claude-opus-4-6',
+ *   systemPrompt: 'You are a rigorous research assistant.',
+ *   tools: ['web_search', 'read_file'],
+ * })
+ *
+ * const result = await agent.run('Summarise the last 3 IPCC reports.')
+ * console.log(result.output)
+ * ```
+ */
+import { createAdapter } from '../llm/adapter.js';
+import { AgentRunner } from './runner.js';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+const ZERO_USAGE = { input_tokens: 0, output_tokens: 0 };
+function addUsage(a, b) {
+    return {
+        input_tokens: a.input_tokens + b.input_tokens,
+        output_tokens: a.output_tokens + b.output_tokens,
+    };
+}
+// ---------------------------------------------------------------------------
+// Agent
+// ---------------------------------------------------------------------------
+/**
+ * High-level wrapper around {@link AgentRunner} that manages conversation
+ * history, state transitions, and tool lifecycle.
+ */
+export class Agent {
+    name;
+    config;
+    runner = null;
+    state;
+    _toolRegistry;
+    _toolExecutor;
+    messageHistory = [];
+    /**
+     * @param config       - Static configuration for this agent.
+     * @param toolRegistry - Registry used to resolve and manage tools.
+     * @param toolExecutor - Executor that dispatches tool calls.
+     *
+     * `toolRegistry` and `toolExecutor` are injected rather than instantiated
+     * internally so that teams of agents can share a single registry.
+     */
+    constructor(config, toolRegistry, toolExecutor) {
+        this.name = config.name;
+        this.config = config;
+        this._toolRegistry = toolRegistry;
+        this._toolExecutor = toolExecutor;
+        this.state = {
+            status: 'idle',
+            messages: [],
+            tokenUsage: ZERO_USAGE,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Initialisation (async, called lazily)
+    // -------------------------------------------------------------------------
+    /**
+     * Lazily create the {@link AgentRunner}.
+     *
+     * The adapter is created asynchronously (it may lazy-import provider SDKs),
+     * so we defer construction until the first `run` / `prompt` / `stream` call.
+     */
+    async getRunner() {
+        if (this.runner !== null) {
+            return this.runner;
+        }
+        const provider = this.config.provider ?? 'anthropic';
+        const adapter = await createAdapter(provider);
+        const runnerOptions = {
+            model: this.config.model,
+            systemPrompt: this.config.systemPrompt,
+            maxTurns: this.config.maxTurns,
+            maxTokens: this.config.maxTokens,
+            temperature: this.config.temperature,
+            allowedTools: this.config.tools,
+            agentName: this.name,
+            agentRole: this.config.systemPrompt?.slice(0, 50) ?? 'assistant',
+        };
+        this.runner = new AgentRunner(adapter, this._toolRegistry, this._toolExecutor, runnerOptions);
+        return this.runner;
+    }
+    // -------------------------------------------------------------------------
+    // Primary execution methods
+    // -------------------------------------------------------------------------
+    /**
+     * Run `prompt` in a fresh conversation (history is NOT used).
+     *
+     * Equivalent to constructing a brand-new messages array `[{ role:'user', … }]`
+     * and calling the runner once. The agent's persistent history is not modified.
+     *
+     * Use this for one-shot queries where past context is irrelevant.
+     */
+    async run(prompt) {
+        const messages = [
+            { role: 'user', content: [{ type: 'text', text: prompt }] },
+        ];
+        return this.executeRun(messages);
+    }
+    /**
+     * Run `prompt` as part of the ongoing conversation.
+     *
+     * Appends the user message to the persistent history, runs the agent, then
+     * appends the resulting messages to the history for the next call.
+     *
+     * Use this for multi-turn interactions.
+     */
+    async prompt(message) {
+        const userMessage = {
+            role: 'user',
+            content: [{ type: 'text', text: message }],
+        };
+        this.messageHistory.push(userMessage);
+        const result = await this.executeRun([...this.messageHistory]);
+        // Persist the new messages into history so the next `prompt` sees them.
+        for (const msg of result.messages) {
+            this.messageHistory.push(msg);
+        }
+        return result;
+    }
+    /**
+     * Stream a fresh-conversation response, yielding {@link StreamEvent}s.
+     *
+     * Like {@link run}, this does not use or update the persistent history.
+     */
+    async *stream(prompt) {
+        const messages = [
+            { role: 'user', content: [{ type: 'text', text: prompt }] },
+        ];
+        yield* this.executeStream(messages);
+    }
+    // -------------------------------------------------------------------------
+    // State management
+    // -------------------------------------------------------------------------
+    /** Return a snapshot of the current agent state (does not clone nested objects). */
+    getState() {
+        return { ...this.state, messages: [...this.state.messages] };
+    }
+    /** Return a copy of the persistent message history. */
+    getHistory() {
+        return [...this.messageHistory];
+    }
+    /**
+     * Clear the persistent conversation history and reset state to `idle`.
+     * Does NOT discard the runner instance — the adapter connection is reused.
+     */
+    reset() {
+        this.messageHistory = [];
+        this.state = {
+            status: 'idle',
+            messages: [],
+            tokenUsage: ZERO_USAGE,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Dynamic tool management
+    // -------------------------------------------------------------------------
+    /**
+     * Register a new tool with this agent's tool registry at runtime.
+     *
+     * The tool becomes available to the next LLM call — no restart required.
+     */
+    addTool(tool) {
+        this._toolRegistry.register(tool);
+    }
+    /**
+     * Deregister a tool by name.
+     * If the tool is not registered this is a no-op (no error is thrown).
+     */
+    removeTool(name) {
+        this._toolRegistry.deregister(name);
+    }
+    /** Return the names of all currently registered tools. */
+    getTools() {
+        return this._toolRegistry.list().map((t) => t.name);
+    }
+    // -------------------------------------------------------------------------
+    // Private execution core
+    // -------------------------------------------------------------------------
+    /**
+     * Shared execution path used by both `run` and `prompt`.
+     * Handles state transitions and error wrapping.
+     */
+    async executeRun(messages) {
+        this.transitionTo('running');
+        try {
+            const runner = await this.getRunner();
+            const runOptions = {
+                onMessage: msg => {
+                    this.state.messages.push(msg);
+                },
+            };
+            const result = await runner.run(messages, runOptions);
+            this.state.tokenUsage = addUsage(this.state.tokenUsage, result.tokenUsage);
+            this.transitionTo('completed');
+            return this.toAgentRunResult(result, true);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.transitionToError(error);
+            return {
+                success: false,
+                output: error.message,
+                messages: [],
+                tokenUsage: ZERO_USAGE,
+                toolCalls: [],
+            };
+        }
+    }
+    /**
+     * Shared streaming path used by `stream`.
+     * Handles state transitions and error wrapping.
+     */
+    async *executeStream(messages) {
+        this.transitionTo('running');
+        try {
+            const runner = await this.getRunner();
+            for await (const event of runner.stream(messages)) {
+                if (event.type === 'done') {
+                    const result = event.data;
+                    this.state.tokenUsage = addUsage(this.state.tokenUsage, result.tokenUsage);
+                    this.transitionTo('completed');
+                }
+                else if (event.type === 'error') {
+                    const error = event.data instanceof Error
+                        ? event.data
+                        : new Error(String(event.data));
+                    this.transitionToError(error);
+                }
+                yield event;
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.transitionToError(error);
+            yield { type: 'error', data: error };
+        }
+    }
+    // -------------------------------------------------------------------------
+    // State transition helpers
+    // -------------------------------------------------------------------------
+    transitionTo(status) {
+        this.state = { ...this.state, status };
+    }
+    transitionToError(error) {
+        this.state = { ...this.state, status: 'error', error };
+    }
+    // -------------------------------------------------------------------------
+    // Result mapping
+    // -------------------------------------------------------------------------
+    toAgentRunResult(result, success) {
+        return {
+            success,
+            output: result.output,
+            messages: result.messages,
+            tokenUsage: result.tokenUsage,
+            toolCalls: result.toolCalls,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // ToolUseContext builder (for direct use by subclasses or advanced callers)
+    // -------------------------------------------------------------------------
+    /**
+     * Build a {@link ToolUseContext} that identifies this agent.
+     * Exposed so team orchestrators can inject richer context (e.g. `TeamInfo`).
+     */
+    buildToolContext(abortSignal) {
+        return {
+            agent: {
+                name: this.name,
+                role: this.config.systemPrompt?.slice(0, 60) ?? 'assistant',
+                model: this.config.model,
+            },
+            abortSignal,
+        };
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

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

package/dist/agent/pool.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @fileoverview Agent pool for managing and scheduling multiple agents.
+ *
+ * {@link AgentPool} is a registry + scheduler that:
+ *  - Holds any number of named {@link Agent} instances
+ *  - Enforces a concurrency cap across parallel runs via {@link Semaphore}
+ *  - Provides `runParallel` for fan-out and `runAny` for round-robin dispatch
+ *  - Reports aggregate pool health via `getStatus()`
+ *
+ * @example
+ * ```ts
+ * const pool = new AgentPool(3)
+ * pool.add(researchAgent)
+ * pool.add(writerAgent)
+ *
+ * const results = await pool.runParallel([
+ *   { agent: 'researcher', prompt: 'Find recent AI papers.' },
+ *   { agent: 'writer',     prompt: 'Draft an intro section.' },
+ * ])
+ * ```
+ */
+import type { AgentRunResult } from '../types.js';
+import type { Agent } from './agent.js';
+export { Semaphore } from '../utils/semaphore.js';
+export interface PoolStatus {
+    /** Total number of agents registered in the pool. */
+    readonly total: number;
+    /** Agents currently in `idle` state. */
+    readonly idle: number;
+    /** Agents currently in `running` state. */
+    readonly running: number;
+    /** Agents currently in `completed` state. */
+    readonly completed: number;
+    /** Agents currently in `error` state. */
+    readonly error: number;
+}
+/**
+ * Registry and scheduler for a collection of {@link Agent} instances.
+ *
+ * Thread-safety note: Node.js is single-threaded, so the semaphore approach
+ * is safe — no atomics or mutex primitives are needed. The semaphore gates
+ * concurrent async operations, not CPU threads.
+ */
+export declare class AgentPool {
+    private readonly maxConcurrency;
+    private readonly agents;
+    private readonly semaphore;
+    /** Cursor used by `runAny` for round-robin dispatch. */
+    private roundRobinIndex;
+    /**
+     * @param maxConcurrency - Maximum number of agent runs allowed at the same
+     *                         time across the whole pool. Defaults to `5`.
+     */
+    constructor(maxConcurrency?: number);
+    /**
+     * Register an agent with the pool.
+     *
+     * @throws {Error} If an agent with the same name is already registered.
+     */
+    add(agent: Agent): void;
+    /**
+     * Unregister an agent by name.
+     *
+     * @throws {Error} If the agent is not found.
+     */
+    remove(name: string): void;
+    /**
+     * Retrieve a registered agent by name, or `undefined` if not found.
+     */
+    get(name: string): Agent | undefined;
+    /**
+     * Return all registered agents in insertion order.
+     */
+    list(): Agent[];
+    /**
+     * Run a single prompt on the named agent, respecting the pool concurrency
+     * limit.
+     *
+     * @throws {Error} If the agent name is not found.
+     */
+    run(agentName: string, prompt: string): Promise<AgentRunResult>;
+    /**
+     * Run prompts on multiple agents in parallel, subject to the concurrency
+     * cap set at construction time.
+     *
+     * Results are returned as a `Map<agentName, AgentRunResult>`. If two tasks
+     * target the same agent name, the map will only contain the last result.
+     * Use unique agent names or run tasks sequentially in that case.
+     *
+     * @param tasks - Array of `{ agent, prompt }` descriptors.
+     */
+    runParallel(tasks: ReadonlyArray<{
+        readonly agent: string;
+        readonly prompt: string;
+    }>): Promise<Map<string, AgentRunResult>>;
+    /**
+     * Run a prompt on the "best available" agent using round-robin selection.
+     *
+     * Agents are selected in insertion order, cycling back to the start. The
+     * concurrency limit is still enforced — if the selected agent is busy the
+     * call will queue via the semaphore.
+     *
+     * @throws {Error} If the pool is empty.
+     */
+    runAny(prompt: string): Promise<AgentRunResult>;
+    /**
+     * Snapshot of how many agents are in each lifecycle state.
+     */
+    getStatus(): PoolStatus;
+    /**
+     * Reset all agents in the pool.
+     *
+     * Clears their conversation histories and returns them to `idle` state.
+     * Does not remove agents from the pool.
+     *
+     * Async for forward compatibility — shutdown may need to perform async
+     * cleanup (e.g. draining in-flight requests) in future versions.
+     */
+    shutdown(): Promise<void>;
+    private requireAgent;
+    /**
+     * Build a failure {@link AgentRunResult} from a caught rejection reason.
+     * This keeps `runParallel` returning a complete map even when individual
+     * agents fail.
+     */
+    private errorResult;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/agent/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/agent/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAMjD,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAMD;;;;;;GAMG;AACH,qBAAa,SAAS;IAUR,OAAO,CAAC,QAAQ,CAAC,cAAc;IAT3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,wDAAwD;IACxD,OAAO,CAAC,eAAe,CAAI;IAE3B;;;OAGG;gBAC0B,cAAc,GAAE,MAAU;IAQvD;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUvB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO1B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC;;OAEG;IACH,IAAI,IAAI,KAAK,EAAE;IAQf;;;;;OAKG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWrE;;;;;;;;;OASG;IACG,WAAW,CACf,KAAK,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GACxE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IA2BvC;;;;;;;;OAQG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuBrD;;OAEG;IACH,SAAS,IAAI,UAAU;IAsBvB;;;;;;;;OAQG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,OAAO,CAAC,YAAY;IAWpB;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAUpB"}

package/dist/agent/pool.js

@@ -0,0 +1,236 @@
+/**
+ * @fileoverview Agent pool for managing and scheduling multiple agents.
+ *
+ * {@link AgentPool} is a registry + scheduler that:
+ *  - Holds any number of named {@link Agent} instances
+ *  - Enforces a concurrency cap across parallel runs via {@link Semaphore}
+ *  - Provides `runParallel` for fan-out and `runAny` for round-robin dispatch
+ *  - Reports aggregate pool health via `getStatus()`
+ *
+ * @example
+ * ```ts
+ * const pool = new AgentPool(3)
+ * pool.add(researchAgent)
+ * pool.add(writerAgent)
+ *
+ * const results = await pool.runParallel([
+ *   { agent: 'researcher', prompt: 'Find recent AI papers.' },
+ *   { agent: 'writer',     prompt: 'Draft an intro section.' },
+ * ])
+ * ```
+ */
+import { Semaphore } from '../utils/semaphore.js';
+export { Semaphore } from '../utils/semaphore.js';
+// ---------------------------------------------------------------------------
+// AgentPool
+// ---------------------------------------------------------------------------
+/**
+ * Registry and scheduler for a collection of {@link Agent} instances.
+ *
+ * Thread-safety note: Node.js is single-threaded, so the semaphore approach
+ * is safe — no atomics or mutex primitives are needed. The semaphore gates
+ * concurrent async operations, not CPU threads.
+ */
+export class AgentPool {
+    maxConcurrency;
+    agents = new Map();
+    semaphore;
+    /** Cursor used by `runAny` for round-robin dispatch. */
+    roundRobinIndex = 0;
+    /**
+     * @param maxConcurrency - Maximum number of agent runs allowed at the same
+     *                         time across the whole pool. Defaults to `5`.
+     */
+    constructor(maxConcurrency = 5) {
+        this.maxConcurrency = maxConcurrency;
+        this.semaphore = new Semaphore(maxConcurrency);
+    }
+    // -------------------------------------------------------------------------
+    // Registry operations
+    // -------------------------------------------------------------------------
+    /**
+     * Register an agent with the pool.
+     *
+     * @throws {Error} If an agent with the same name is already registered.
+     */
+    add(agent) {
+        if (this.agents.has(agent.name)) {
+            throw new Error(`AgentPool: agent '${agent.name}' is already registered. ` +
+                `Call remove('${agent.name}') before re-adding.`);
+        }
+        this.agents.set(agent.name, agent);
+    }
+    /**
+     * Unregister an agent by name.
+     *
+     * @throws {Error} If the agent is not found.
+     */
+    remove(name) {
+        if (!this.agents.has(name)) {
+            throw new Error(`AgentPool: agent '${name}' is not registered.`);
+        }
+        this.agents.delete(name);
+    }
+    /**
+     * Retrieve a registered agent by name, or `undefined` if not found.
+     */
+    get(name) {
+        return this.agents.get(name);
+    }
+    /**
+     * Return all registered agents in insertion order.
+     */
+    list() {
+        return Array.from(this.agents.values());
+    }
+    // -------------------------------------------------------------------------
+    // Execution API
+    // -------------------------------------------------------------------------
+    /**
+     * Run a single prompt on the named agent, respecting the pool concurrency
+     * limit.
+     *
+     * @throws {Error} If the agent name is not found.
+     */
+    async run(agentName, prompt) {
+        const agent = this.requireAgent(agentName);
+        await this.semaphore.acquire();
+        try {
+            return await agent.run(prompt);
+        }
+        finally {
+            this.semaphore.release();
+        }
+    }
+    /**
+     * Run prompts on multiple agents in parallel, subject to the concurrency
+     * cap set at construction time.
+     *
+     * Results are returned as a `Map<agentName, AgentRunResult>`. If two tasks
+     * target the same agent name, the map will only contain the last result.
+     * Use unique agent names or run tasks sequentially in that case.
+     *
+     * @param tasks - Array of `{ agent, prompt }` descriptors.
+     */
+    async runParallel(tasks) {
+        const resultMap = new Map();
+        const settledResults = await Promise.allSettled(tasks.map(async (task) => {
+            const result = await this.run(task.agent, task.prompt);
+            return { name: task.agent, result };
+        }));
+        for (const settled of settledResults) {
+            if (settled.status === 'fulfilled') {
+                resultMap.set(settled.value.name, settled.value.result);
+            }
+            else {
+                // A rejected run is surfaced as an error AgentRunResult so the caller
+                // sees it in the map rather than needing to catch Promise.allSettled.
+                // We cannot know the agent name from the rejection alone — find it via
+                // the original task list index.
+                const idx = settledResults.indexOf(settled);
+                const agentName = tasks[idx]?.agent ?? 'unknown';
+                resultMap.set(agentName, this.errorResult(settled.reason));
+            }
+        }
+        return resultMap;
+    }
+    /**
+     * Run a prompt on the "best available" agent using round-robin selection.
+     *
+     * Agents are selected in insertion order, cycling back to the start. The
+     * concurrency limit is still enforced — if the selected agent is busy the
+     * call will queue via the semaphore.
+     *
+     * @throws {Error} If the pool is empty.
+     */
+    async runAny(prompt) {
+        const allAgents = this.list();
+        if (allAgents.length === 0) {
+            throw new Error('AgentPool: cannot call runAny on an empty pool.');
+        }
+        // Wrap the index to keep it in bounds even if agents were removed.
+        this.roundRobinIndex = this.roundRobinIndex % allAgents.length;
+        const agent = allAgents[this.roundRobinIndex];
+        this.roundRobinIndex = (this.roundRobinIndex + 1) % allAgents.length;
+        await this.semaphore.acquire();
+        try {
+            return await agent.run(prompt);
+        }
+        finally {
+            this.semaphore.release();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Observability
+    // -------------------------------------------------------------------------
+    /**
+     * Snapshot of how many agents are in each lifecycle state.
+     */
+    getStatus() {
+        let idle = 0;
+        let running = 0;
+        let completed = 0;
+        let error = 0;
+        for (const agent of this.agents.values()) {
+            switch (agent.getState().status) {
+                case 'idle':
+                    idle++;
+                    break;
+                case 'running':
+                    running++;
+                    break;
+                case 'completed':
+                    completed++;
+                    break;
+                case 'error':
+                    error++;
+                    break;
+            }
+        }
+        return { total: this.agents.size, idle, running, completed, error };
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    /**
+     * Reset all agents in the pool.
+     *
+     * Clears their conversation histories and returns them to `idle` state.
+     * Does not remove agents from the pool.
+     *
+     * Async for forward compatibility — shutdown may need to perform async
+     * cleanup (e.g. draining in-flight requests) in future versions.
+     */
+    async shutdown() {
+        for (const agent of this.agents.values()) {
+            agent.reset();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    requireAgent(name) {
+        const agent = this.agents.get(name);
+        if (agent === undefined) {
+            throw new Error(`AgentPool: agent '${name}' is not registered. ` +
+                `Registered agents: [${Array.from(this.agents.keys()).join(', ')}]`);
+        }
+        return agent;
+    }
+    /**
+     * Build a failure {@link AgentRunResult} from a caught rejection reason.
+     * This keeps `runParallel` returning a complete map even when individual
+     * agents fail.
+     */
+    errorResult(reason) {
+        const message = reason instanceof Error ? reason.message : String(reason);
+        return {
+            success: false,
+            output: message,
+            messages: [],
+            tokenUsage: { input_tokens: 0, output_tokens: 0 },
+            toolCalls: [],
+        };
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/agent/pool.js.map

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