@jackchen_me/open-multi-agent 0.1.0

package/dist/agent/runner.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Core conversation loop engine for open-multi-agent.
+ *
+ * {@link AgentRunner} is the heart of the framework. It handles:
+ *  - Sending messages to the LLM adapter
+ *  - Extracting tool-use blocks from the response
+ *  - Executing tool calls in parallel via {@link ToolExecutor}
+ *  - Appending tool results and looping back until `end_turn`
+ *  - Accumulating token usage and timing data across all turns
+ *
+ * The loop follows a standard agentic conversation pattern:
+ * one outer `while (true)` that breaks on `end_turn` or maxTurns exhaustion.
+ */
+import type { LLMMessage, ToolCallRecord, TokenUsage, StreamEvent, ToolResult, LLMAdapter } from '../types.js';
+import type { ToolRegistry } from '../tool/framework.js';
+import type { ToolExecutor } from '../tool/executor.js';
+/**
+ * Static configuration for an {@link AgentRunner} instance.
+ * These values are constant across every `run` / `stream` call.
+ */
+export interface RunnerOptions {
+    /** LLM model identifier, e.g. `'claude-opus-4-6'`. */
+    readonly model: string;
+    /** Optional system prompt prepended to every conversation. */
+    readonly systemPrompt?: string;
+    /**
+     * Maximum number of tool-call round-trips before the runner stops.
+     * Prevents unbounded loops. Defaults to `10`.
+     */
+    readonly maxTurns?: number;
+    /** Maximum output tokens per LLM response. */
+    readonly maxTokens?: number;
+    /** Sampling temperature passed to the adapter. */
+    readonly temperature?: number;
+    /** AbortSignal that cancels any in-flight adapter call and stops the loop. */
+    readonly abortSignal?: AbortSignal;
+    /**
+     * Whitelist of tool names this runner is allowed to use.
+     * When provided, only tools whose name appears in this list are sent to the
+     * LLM. When omitted, all registered tools are available.
+     */
+    readonly allowedTools?: readonly string[];
+    /** Display name of the agent driving this runner (used in tool context). */
+    readonly agentName?: string;
+    /** Short role description of the agent (used in tool context). */
+    readonly agentRole?: string;
+}
+/**
+ * Per-call callbacks for observing tool execution in real time.
+ * All callbacks are optional; unused ones are simply skipped.
+ */
+export interface RunOptions {
+    /** Fired just before each tool is dispatched. */
+    readonly onToolCall?: (name: string, input: Record<string, unknown>) => void;
+    /** Fired after each tool result is received. */
+    readonly onToolResult?: (name: string, result: ToolResult) => void;
+    /** Fired after each complete {@link LLMMessage} is appended. */
+    readonly onMessage?: (message: LLMMessage) => void;
+}
+/** The aggregated result returned when a full run completes. */
+export interface RunResult {
+    /** All messages accumulated during this run (assistant + tool results). */
+    readonly messages: LLMMessage[];
+    /** The final text output from the last assistant turn. */
+    readonly output: string;
+    /** All tool calls made during this run, in execution order. */
+    readonly toolCalls: ToolCallRecord[];
+    /** Aggregated token counts across every LLM call in this run. */
+    readonly tokenUsage: TokenUsage;
+    /** Total number of LLM turns (including tool-call follow-ups). */
+    readonly turns: number;
+}
+/**
+ * Drives a full agentic conversation: LLM calls, tool execution, and looping.
+ *
+ * @example
+ * ```ts
+ * const runner = new AgentRunner(adapter, registry, executor, {
+ *   model: 'claude-opus-4-6',
+ *   maxTurns: 10,
+ * })
+ * const result = await runner.run(messages)
+ * console.log(result.output)
+ * ```
+ */
+export declare class AgentRunner {
+    private readonly adapter;
+    private readonly toolRegistry;
+    private readonly toolExecutor;
+    private readonly options;
+    private readonly maxTurns;
+    constructor(adapter: LLMAdapter, toolRegistry: ToolRegistry, toolExecutor: ToolExecutor, options: RunnerOptions);
+    /**
+     * Run a complete conversation starting from `messages`.
+     *
+     * The call may internally make multiple LLM requests (one per tool-call
+     * round-trip). It returns only when:
+     *  - The LLM emits `end_turn` with no tool-use blocks, or
+     *  - `maxTurns` is exceeded, or
+     *  - The abort signal is triggered.
+     */
+    run(messages: LLMMessage[], options?: RunOptions): Promise<RunResult>;
+    /**
+     * Run the conversation and yield {@link StreamEvent}s incrementally.
+     *
+     * Callers receive:
+     *  - `{ type: 'text', data: string }` for each text delta
+     *  - `{ type: 'tool_use', data: ToolUseBlock }` when the model requests a tool
+     *  - `{ type: 'tool_result', data: ToolResultBlock }` after each execution
+     *  - `{ type: 'done', data: RunResult }` at the very end
+     *  - `{ type: 'error', data: Error }` on unrecoverable failure
+     */
+    stream(initialMessages: LLMMessage[], options?: RunOptions): AsyncGenerator<StreamEvent>;
+    /**
+     * Build the {@link ToolUseContext} passed to every tool execution.
+     * Identifies this runner as the invoking agent.
+     */
+    private buildToolContext;
+}
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,UAAU,EAKV,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EAEV,UAAU,EAEX,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAMvD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;IAClC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC5E,gDAAgD;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAClE,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAA;CACnD;AAED,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAAA;IACpC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAiCD;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAGd,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,aAAa;IASzC;;;;;;;;OAQG;IACG,GAAG,CACP,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC;IA8BrB;;;;;;;;;OASG;IACI,MAAM,CACX,eAAe,EAAE,UAAU,EAAE,EAC7B,OAAO,GAAE,UAAe,GACvB,cAAc,CAAC,WAAW,CAAC;IA6L9B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/agent/runner.js

@@ -0,0 +1,274 @@
+/**
+ * @fileoverview Core conversation loop engine for open-multi-agent.
+ *
+ * {@link AgentRunner} is the heart of the framework. It handles:
+ *  - Sending messages to the LLM adapter
+ *  - Extracting tool-use blocks from the response
+ *  - Executing tool calls in parallel via {@link ToolExecutor}
+ *  - Appending tool results and looping back until `end_turn`
+ *  - Accumulating token usage and timing data across all turns
+ *
+ * The loop follows a standard agentic conversation pattern:
+ * one outer `while (true)` that breaks on `end_turn` or maxTurns exhaustion.
+ */
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Extract every TextBlock from a content array and join them. */
+function extractText(content) {
+    return content
+        .filter((b) => b.type === 'text')
+        .map(b => b.text)
+        .join('');
+}
+/** Extract every ToolUseBlock from a content array. */
+function extractToolUseBlocks(content) {
+    return content.filter((b) => b.type === 'tool_use');
+}
+/** Add two {@link TokenUsage} values together, returning a new object. */
+function addTokenUsage(a, b) {
+    return {
+        input_tokens: a.input_tokens + b.input_tokens,
+        output_tokens: a.output_tokens + b.output_tokens,
+    };
+}
+const ZERO_USAGE = { input_tokens: 0, output_tokens: 0 };
+// ---------------------------------------------------------------------------
+// AgentRunner
+// ---------------------------------------------------------------------------
+/**
+ * Drives a full agentic conversation: LLM calls, tool execution, and looping.
+ *
+ * @example
+ * ```ts
+ * const runner = new AgentRunner(adapter, registry, executor, {
+ *   model: 'claude-opus-4-6',
+ *   maxTurns: 10,
+ * })
+ * const result = await runner.run(messages)
+ * console.log(result.output)
+ * ```
+ */
+export class AgentRunner {
+    adapter;
+    toolRegistry;
+    toolExecutor;
+    options;
+    maxTurns;
+    constructor(adapter, toolRegistry, toolExecutor, options) {
+        this.adapter = adapter;
+        this.toolRegistry = toolRegistry;
+        this.toolExecutor = toolExecutor;
+        this.options = options;
+        this.maxTurns = options.maxTurns ?? 10;
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Run a complete conversation starting from `messages`.
+     *
+     * The call may internally make multiple LLM requests (one per tool-call
+     * round-trip). It returns only when:
+     *  - The LLM emits `end_turn` with no tool-use blocks, or
+     *  - `maxTurns` is exceeded, or
+     *  - The abort signal is triggered.
+     */
+    async run(messages, options = {}) {
+        // Collect everything yielded by the internal streaming loop.
+        const accumulated = {
+            messages: [],
+            output: '',
+            toolCalls: [],
+            tokenUsage: ZERO_USAGE,
+            turns: 0,
+        };
+        for await (const event of this.stream(messages, options)) {
+            if (event.type === 'done') {
+                const result = event.data;
+                accumulated.messages = result.messages;
+                accumulated.output = result.output;
+                accumulated.toolCalls = result.toolCalls;
+                accumulated.tokenUsage = result.tokenUsage;
+                accumulated.turns = result.turns;
+            }
+        }
+        return accumulated;
+    }
+    /**
+     * Run the conversation and yield {@link StreamEvent}s incrementally.
+     *
+     * Callers receive:
+     *  - `{ type: 'text', data: string }` for each text delta
+     *  - `{ type: 'tool_use', data: ToolUseBlock }` when the model requests a tool
+     *  - `{ type: 'tool_result', data: ToolResultBlock }` after each execution
+     *  - `{ type: 'done', data: RunResult }` at the very end
+     *  - `{ type: 'error', data: Error }` on unrecoverable failure
+     */
+    async *stream(initialMessages, options = {}) {
+        // Working copy of the conversation — mutated as turns progress.
+        const conversationMessages = [...initialMessages];
+        // Accumulated state across all turns.
+        let totalUsage = ZERO_USAGE;
+        const allToolCalls = [];
+        let finalOutput = '';
+        let turns = 0;
+        // Build the stable LLM options once; model / tokens / temp don't change.
+        // toToolDefs() returns LLMToolDef[] (inputSchema, camelCase) — matches
+        // LLMChatOptions.tools from types.ts directly.
+        const allDefs = this.toolRegistry.toToolDefs();
+        const toolDefs = this.options.allowedTools
+            ? allDefs.filter(d => this.options.allowedTools.includes(d.name))
+            : allDefs;
+        const baseChatOptions = {
+            model: this.options.model,
+            tools: toolDefs.length > 0 ? toolDefs : undefined,
+            maxTokens: this.options.maxTokens,
+            temperature: this.options.temperature,
+            systemPrompt: this.options.systemPrompt,
+            abortSignal: this.options.abortSignal,
+        };
+        try {
+            // -----------------------------------------------------------------
+            // Main agentic loop — `while (true)` until end_turn or maxTurns
+            // -----------------------------------------------------------------
+            while (true) {
+                // Respect abort before each LLM call.
+                if (this.options.abortSignal?.aborted) {
+                    break;
+                }
+                // Guard against unbounded loops.
+                if (turns >= this.maxTurns) {
+                    break;
+                }
+                turns++;
+                // ------------------------------------------------------------------
+                // Step 1: Call the LLM and collect the full response for this turn.
+                // ------------------------------------------------------------------
+                const response = await this.adapter.chat(conversationMessages, baseChatOptions);
+                totalUsage = addTokenUsage(totalUsage, response.usage);
+                // ------------------------------------------------------------------
+                // Step 2: Build the assistant message from the response content.
+                // ------------------------------------------------------------------
+                const assistantMessage = {
+                    role: 'assistant',
+                    content: response.content,
+                };
+                conversationMessages.push(assistantMessage);
+                options.onMessage?.(assistantMessage);
+                // Yield text deltas so streaming callers can display them promptly.
+                const turnText = extractText(response.content);
+                if (turnText.length > 0) {
+                    yield { type: 'text', data: turnText };
+                }
+                // Announce each tool-use block the model requested.
+                const toolUseBlocks = extractToolUseBlocks(response.content);
+                for (const block of toolUseBlocks) {
+                    yield { type: 'tool_use', data: block };
+                }
+                // ------------------------------------------------------------------
+                // Step 3: Decide whether to continue looping.
+                // ------------------------------------------------------------------
+                if (toolUseBlocks.length === 0) {
+                    // No tools requested — this is the terminal assistant turn.
+                    finalOutput = turnText;
+                    break;
+                }
+                // ------------------------------------------------------------------
+                // Step 4: Execute all tool calls in PARALLEL.
+                //
+                // Parallel execution is critical for multi-tool responses where the
+                // tools are independent (e.g. reading several files at once).
+                // ------------------------------------------------------------------
+                const toolContext = this.buildToolContext();
+                const executionPromises = toolUseBlocks.map(async (block) => {
+                    options.onToolCall?.(block.name, block.input);
+                    const startTime = Date.now();
+                    let result;
+                    try {
+                        result = await this.toolExecutor.execute(block.name, block.input, toolContext);
+                    }
+                    catch (err) {
+                        // Tool executor errors become error results — the loop continues.
+                        const message = err instanceof Error ? err.message : String(err);
+                        result = { data: message, isError: true };
+                    }
+                    const duration = Date.now() - startTime;
+                    options.onToolResult?.(block.name, result);
+                    const record = {
+                        toolName: block.name,
+                        input: block.input,
+                        output: result.data,
+                        duration,
+                    };
+                    const resultBlock = {
+                        type: 'tool_result',
+                        tool_use_id: block.id,
+                        content: result.data,
+                        is_error: result.isError,
+                    };
+                    return { resultBlock, record };
+                });
+                // Wait for every tool in this turn to finish.
+                const executions = await Promise.all(executionPromises);
+                // ------------------------------------------------------------------
+                // Step 5: Accumulate results and build the user message that carries
+                //         them back to the LLM in the next turn.
+                // ------------------------------------------------------------------
+                const toolResultBlocks = executions.map(e => e.resultBlock);
+                for (const { record, resultBlock } of executions) {
+                    allToolCalls.push(record);
+                    yield { type: 'tool_result', data: resultBlock };
+                }
+                const toolResultMessage = {
+                    role: 'user',
+                    content: toolResultBlocks,
+                };
+                conversationMessages.push(toolResultMessage);
+                options.onMessage?.(toolResultMessage);
+                // Loop back to Step 1 — send updated conversation to the LLM.
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            yield { type: 'error', data: error };
+            return;
+        }
+        // If the loop exited due to maxTurns, use whatever text was last emitted.
+        if (finalOutput === '' && conversationMessages.length > 0) {
+            const lastAssistant = [...conversationMessages]
+                .reverse()
+                .find(m => m.role === 'assistant');
+            if (lastAssistant !== undefined) {
+                finalOutput = extractText(lastAssistant.content);
+            }
+        }
+        const runResult = {
+            // Return only the messages added during this run (not the initial seed).
+            messages: conversationMessages.slice(initialMessages.length),
+            output: finalOutput,
+            toolCalls: allToolCalls,
+            tokenUsage: totalUsage,
+            turns,
+        };
+        yield { type: 'done', data: runResult };
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Build the {@link ToolUseContext} passed to every tool execution.
+     * Identifies this runner as the invoking agent.
+     */
+    buildToolContext() {
+        return {
+            agent: {
+                name: this.options.agentName ?? 'runner',
+                role: this.options.agentRole ?? 'assistant',
+                model: this.options.model,
+            },
+            abortSignal: this.options.abortSignal,
+        };
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/agent/runner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview open-multi-agent — public API surface.
+ *
+ * Import from `'open-multi-agent'` to access everything you need:
+ *
+ * ```ts
+ * import { OpenMultiAgent, Agent, Team, defineTool } from 'open-multi-agent'
+ * ```
+ *
+ * ## Quickstart
+ *
+ * ### Single agent
+ * ```ts
+ * const orchestrator = new OpenMultiAgent({ defaultModel: 'claude-opus-4-6' })
+ * const result = await orchestrator.runAgent(
+ *   { name: 'assistant', model: 'claude-opus-4-6' },
+ *   'Explain monads in one paragraph.',
+ * )
+ * console.log(result.output)
+ * ```
+ *
+ * ### Multi-agent team (auto-orchestrated)
+ * ```ts
+ * const orchestrator = new OpenMultiAgent()
+ * const team = orchestrator.createTeam('writers', {
+ *   name: 'writers',
+ *   agents: [
+ *     { name: 'researcher', model: 'claude-opus-4-6', systemPrompt: 'You research topics thoroughly.' },
+ *     { name: 'writer',     model: 'claude-opus-4-6', systemPrompt: 'You write clear documentation.' },
+ *   ],
+ *   sharedMemory: true,
+ * })
+ * const result = await orchestrator.runTeam(team, 'Write a guide on TypeScript generics.')
+ * console.log(result.agentResults.get('coordinator')?.output)
+ * ```
+ *
+ * ### Custom tools
+ * ```ts
+ * import { z } from 'zod'
+ *
+ * const myTool = defineTool({
+ *   name: 'fetch_data',
+ *   description: 'Fetch JSON data from a URL.',
+ *   inputSchema: z.object({ url: z.string().url() }),
+ *   execute: async ({ url }) => {
+ *     const res = await fetch(url)
+ *     return { data: await res.text() }
+ *   },
+ * })
+ * ```
+ */
+export { OpenMultiAgent } from './orchestrator/orchestrator.js';
+export { Scheduler } from './orchestrator/scheduler.js';
+export type { SchedulingStrategy } from './orchestrator/scheduler.js';
+export { Agent } from './agent/agent.js';
+export { AgentPool, Semaphore } from './agent/pool.js';
+export type { PoolStatus } from './agent/pool.js';
+export { Team } from './team/team.js';
+export { MessageBus } from './team/messaging.js';
+export type { Message } from './team/messaging.js';
+export { TaskQueue } from './task/queue.js';
+export { createTask, isTaskReady, getTaskDependencyOrder, validateTaskDependencies } from './task/task.js';
+export type { TaskQueueEvent } from './task/queue.js';
+export { defineTool, ToolRegistry, zodToJsonSchema } from './tool/framework.js';
+export { ToolExecutor } from './tool/executor.js';
+export type { ToolExecutorOptions, BatchToolCall } from './tool/executor.js';
+export { registerBuiltInTools, BUILT_IN_TOOLS, bashTool, fileReadTool, fileWriteTool, fileEditTool, grepTool, } from './tool/built-in/index.js';
+export { createAdapter } from './llm/adapter.js';
+export type { SupportedProvider } from './llm/adapter.js';
+export { InMemoryStore } from './memory/store.js';
+export { SharedMemory } from './memory/shared.js';
+export type { TextBlock, ToolUseBlock, ToolResultBlock, ImageBlock, ContentBlock, LLMMessage, LLMResponse, LLMAdapter, LLMChatOptions, LLMStreamOptions, LLMToolDef, TokenUsage, StreamEvent, ToolDefinition, ToolResult, ToolUseContext, AgentInfo, TeamInfo, AgentConfig, AgentState, AgentRunResult, ToolCallRecord, TeamConfig, TeamRunResult, Task, TaskStatus, OrchestratorConfig, OrchestratorEvent, MemoryEntry, MemoryStore, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAMrE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAMjD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC1G,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAMrD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,QAAQ,GACT,MAAM,0BAA0B,CAAA;AAMjC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAMzD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMjD,YAAY,EAEV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,UAAU,EACV,YAAY,EAGZ,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EAGX,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACT,QAAQ,EAGR,WAAW,EACX,UAAU,EACV,cAAc,EACd,cAAc,EAGd,UAAU,EACV,aAAa,EAGb,IAAI,EACJ,UAAU,EAGV,kBAAkB,EAClB,iBAAiB,EAGjB,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview open-multi-agent — public API surface.
+ *
+ * Import from `'open-multi-agent'` to access everything you need:
+ *
+ * ```ts
+ * import { OpenMultiAgent, Agent, Team, defineTool } from 'open-multi-agent'
+ * ```
+ *
+ * ## Quickstart
+ *
+ * ### Single agent
+ * ```ts
+ * const orchestrator = new OpenMultiAgent({ defaultModel: 'claude-opus-4-6' })
+ * const result = await orchestrator.runAgent(
+ *   { name: 'assistant', model: 'claude-opus-4-6' },
+ *   'Explain monads in one paragraph.',
+ * )
+ * console.log(result.output)
+ * ```
+ *
+ * ### Multi-agent team (auto-orchestrated)
+ * ```ts
+ * const orchestrator = new OpenMultiAgent()
+ * const team = orchestrator.createTeam('writers', {
+ *   name: 'writers',
+ *   agents: [
+ *     { name: 'researcher', model: 'claude-opus-4-6', systemPrompt: 'You research topics thoroughly.' },
+ *     { name: 'writer',     model: 'claude-opus-4-6', systemPrompt: 'You write clear documentation.' },
+ *   ],
+ *   sharedMemory: true,
+ * })
+ * const result = await orchestrator.runTeam(team, 'Write a guide on TypeScript generics.')
+ * console.log(result.agentResults.get('coordinator')?.output)
+ * ```
+ *
+ * ### Custom tools
+ * ```ts
+ * import { z } from 'zod'
+ *
+ * const myTool = defineTool({
+ *   name: 'fetch_data',
+ *   description: 'Fetch JSON data from a URL.',
+ *   inputSchema: z.object({ url: z.string().url() }),
+ *   execute: async ({ url }) => {
+ *     const res = await fetch(url)
+ *     return { data: await res.text() }
+ *   },
+ * })
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// Orchestrator (primary entry point)
+// ---------------------------------------------------------------------------
+export { OpenMultiAgent } from './orchestrator/orchestrator.js';
+export { Scheduler } from './orchestrator/scheduler.js';
+// ---------------------------------------------------------------------------
+// Agent layer
+// ---------------------------------------------------------------------------
+export { Agent } from './agent/agent.js';
+export { AgentPool, Semaphore } from './agent/pool.js';
+// ---------------------------------------------------------------------------
+// Team layer
+// ---------------------------------------------------------------------------
+export { Team } from './team/team.js';
+export { MessageBus } from './team/messaging.js';
+// ---------------------------------------------------------------------------
+// Task layer
+// ---------------------------------------------------------------------------
+export { TaskQueue } from './task/queue.js';
+export { createTask, isTaskReady, getTaskDependencyOrder, validateTaskDependencies } from './task/task.js';
+// ---------------------------------------------------------------------------
+// Tool system
+// ---------------------------------------------------------------------------
+export { defineTool, ToolRegistry, zodToJsonSchema } from './tool/framework.js';
+export { ToolExecutor } from './tool/executor.js';
+export { registerBuiltInTools, BUILT_IN_TOOLS, bashTool, fileReadTool, fileWriteTool, fileEditTool, grepTool, } from './tool/built-in/index.js';
+// ---------------------------------------------------------------------------
+// LLM adapters
+// ---------------------------------------------------------------------------
+export { createAdapter } from './llm/adapter.js';
+// ---------------------------------------------------------------------------
+// Memory
+// ---------------------------------------------------------------------------
+export { InMemoryStore } from './memory/store.js';
+export { SharedMemory } from './memory/shared.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAGvD,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGtD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGhD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAG1G,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,QAAQ,GACT,MAAM,0BAA0B,CAAA;AAEjC,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhD,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/llm/adapter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview LLM adapter factory.
+ *
+ * Re-exports the {@link LLMAdapter} interface and provides a
+ * {@link createAdapter} factory that returns the correct concrete
+ * implementation based on the requested provider.
+ *
+ * @example
+ * ```ts
+ * import { createAdapter } from './adapter.js'
+ *
+ * const anthropic = createAdapter('anthropic')
+ * const openai    = createAdapter('openai', process.env.OPENAI_API_KEY)
+ * ```
+ */
+export type { LLMAdapter, LLMChatOptions, LLMStreamOptions, LLMToolDef, LLMMessage, LLMResponse, StreamEvent, TokenUsage, ContentBlock, TextBlock, ToolUseBlock, ToolResultBlock, ImageBlock, } from '../types.js';
+import type { LLMAdapter } from '../types.js';
+/**
+ * The set of LLM providers supported out of the box.
+ * Additional providers can be integrated by implementing {@link LLMAdapter}
+ * directly and bypassing this factory.
+ */
+export type SupportedProvider = 'anthropic' | 'openai';
+/**
+ * Instantiate the appropriate {@link LLMAdapter} for the given provider.
+ *
+ * API keys fall back to the standard environment variables
+ * (`ANTHROPIC_API_KEY` / `OPENAI_API_KEY`) when not supplied explicitly.
+ *
+ * Adapters are imported lazily so that projects using only one provider
+ * are not forced to install the SDK for the other.
+ *
+ * @param provider - Which LLM provider to target.
+ * @param apiKey   - Optional API key override; falls back to env var.
+ * @throws {Error} When the provider string is not recognised.
+ */
+export declare function createAdapter(provider: SupportedProvider, apiKey?: string): Promise<LLMAdapter>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/llm/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/llm/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEtD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CAgBrB"}