@jackchen_me/open-multi-agent 0.1.0

package/dist/llm/adapter.js

@@ -0,0 +1,46 @@
+/**
+ * @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)
+ * ```
+ */
+/**
+ * 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 async function createAdapter(provider, apiKey) {
+    switch (provider) {
+        case 'anthropic': {
+            const { AnthropicAdapter } = await import('./anthropic.js');
+            return new AnthropicAdapter(apiKey);
+        }
+        case 'openai': {
+            const { OpenAIAdapter } = await import('./openai.js');
+            return new OpenAIAdapter(apiKey);
+        }
+        default: {
+            // The `never` cast here makes TypeScript enforce exhaustiveness.
+            const _exhaustive = provider;
+            throw new Error(`Unsupported LLM provider: ${String(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/llm/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/llm/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA2BH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAA2B,EAC3B,MAAe;IAEf,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;YAC3D,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAA;QACrC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;YACrD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAA;QAClC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,iEAAiE;YACjE,MAAM,WAAW,GAAU,QAAQ,CAAA;YACnC,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/llm/anthropic.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Anthropic Claude adapter implementing {@link LLMAdapter}.
+ *
+ * Converts between the framework's internal {@link ContentBlock} types and the
+ * Anthropic SDK's wire format, handling tool definitions, system prompts, and
+ * both batch and streaming response paths.
+ *
+ * API key resolution order:
+ *   1. `apiKey` constructor argument
+ *   2. `ANTHROPIC_API_KEY` environment variable
+ *
+ * @example
+ * ```ts
+ * import { AnthropicAdapter } from './anthropic.js'
+ *
+ * const adapter = new AnthropicAdapter()
+ * const response = await adapter.chat(messages, {
+ *   model: 'claude-opus-4-6',
+ *   maxTokens: 1024,
+ * })
+ * ```
+ */
+import type { ContentBlock, ImageBlock, LLMAdapter, LLMChatOptions, LLMMessage, LLMResponse, LLMStreamOptions, LLMToolDef, StreamEvent, TextBlock, ToolResultBlock, ToolUseBlock } from '../types.js';
+/**
+ * LLM adapter backed by the Anthropic Claude API.
+ *
+ * Thread-safe — a single instance may be shared across concurrent agent runs.
+ * The underlying SDK client is stateless across requests.
+ */
+export declare class AnthropicAdapter implements LLMAdapter {
+    #private;
+    readonly name = "anthropic";
+    constructor(apiKey?: string);
+    /**
+     * Send a synchronous (non-streaming) chat request and return the complete
+     * {@link LLMResponse}.
+     *
+     * Throws an `Anthropic.APIError` on non-2xx responses. Callers should catch
+     * and handle these (e.g. rate limits, context window exceeded).
+     */
+    chat(messages: LLMMessage[], options: LLMChatOptions): Promise<LLMResponse>;
+    /**
+     * Send a streaming chat request and yield {@link StreamEvent}s as they
+     * arrive from the API.
+     *
+     * Sequence guarantees:
+     * - Zero or more `text` events containing incremental deltas
+     * - Zero or more `tool_use` events when the model calls a tool (emitted once
+     *   per tool use, after input JSON has been fully assembled)
+     * - Exactly one terminal event: `done` (with the complete {@link LLMResponse}
+     *   as `data`) or `error` (with an `Error` as `data`)
+     */
+    stream(messages: LLMMessage[], options: LLMStreamOptions): AsyncIterable<StreamEvent>;
+}
+export type { ContentBlock, ImageBlock, LLMAdapter, LLMChatOptions, LLMMessage, LLMResponse, LLMStreamOptions, LLMToolDef, StreamEvent, TextBlock, ToolResultBlock, ToolUseBlock, };
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/llm/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAaH,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAA;AAqIpB;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,UAAU;;IACjD,QAAQ,CAAC,IAAI,eAAc;gBAIf,MAAM,CAAC,EAAE,MAAM;IAU3B;;;;;;OAMG;IACG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAmCjF;;;;;;;;;;OAUG;IACI,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,EAAE,gBAAgB,GACxB,aAAa,CAAC,WAAW,CAAC;CAkH9B;AAGD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,YAAY,GACb,CAAA"}

package/dist/llm/anthropic.js

@@ -0,0 +1,307 @@
+/**
+ * @fileoverview Anthropic Claude adapter implementing {@link LLMAdapter}.
+ *
+ * Converts between the framework's internal {@link ContentBlock} types and the
+ * Anthropic SDK's wire format, handling tool definitions, system prompts, and
+ * both batch and streaming response paths.
+ *
+ * API key resolution order:
+ *   1. `apiKey` constructor argument
+ *   2. `ANTHROPIC_API_KEY` environment variable
+ *
+ * @example
+ * ```ts
+ * import { AnthropicAdapter } from './anthropic.js'
+ *
+ * const adapter = new AnthropicAdapter()
+ * const response = await adapter.chat(messages, {
+ *   model: 'claude-opus-4-6',
+ *   maxTokens: 1024,
+ * })
+ * ```
+ */
+import Anthropic from '@anthropic-ai/sdk';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert a single framework {@link ContentBlock} into an Anthropic
+ * {@link ContentBlockParam} suitable for the `messages` array.
+ *
+ * `tool_result` blocks are only valid inside `user`-role messages, which is
+ * handled by {@link toAnthropicMessages} based on role context.
+ */
+function toAnthropicContentBlockParam(block) {
+    switch (block.type) {
+        case 'text': {
+            const param = { type: 'text', text: block.text };
+            return param;
+        }
+        case 'tool_use': {
+            const param = {
+                type: 'tool_use',
+                id: block.id,
+                name: block.name,
+                input: block.input,
+            };
+            return param;
+        }
+        case 'tool_result': {
+            const param = {
+                type: 'tool_result',
+                tool_use_id: block.tool_use_id,
+                content: block.content,
+                is_error: block.is_error,
+            };
+            return param;
+        }
+        case 'image': {
+            // Anthropic only accepts a subset of MIME types; we pass them through
+            // trusting the caller to supply a valid media_type value.
+            const param = {
+                type: 'image',
+                source: {
+                    type: 'base64',
+                    media_type: block.source.media_type,
+                    data: block.source.data,
+                },
+            };
+            return param;
+        }
+        default: {
+            // Exhaustiveness guard — TypeScript will flag this at compile time if a
+            // new variant is added to ContentBlock without updating this switch.
+            const _exhaustive = block;
+            throw new Error(`Unhandled content block type: ${JSON.stringify(_exhaustive)}`);
+        }
+    }
+}
+/**
+ * Convert framework messages into Anthropic's `MessageParam[]` format.
+ *
+ * The Anthropic API requires strict user/assistant alternation. We do not
+ * enforce that here — the caller is responsible for producing a valid
+ * conversation history.
+ */
+function toAnthropicMessages(messages) {
+    return messages.map((msg) => ({
+        role: msg.role,
+        content: msg.content.map(toAnthropicContentBlockParam),
+    }));
+}
+/**
+ * Convert framework {@link LLMToolDef}s into Anthropic's `Tool` objects.
+ *
+ * The `inputSchema` on {@link LLMToolDef} is already a plain JSON Schema
+ * object, so we just need to reshape the wrapper.
+ */
+function toAnthropicTools(tools) {
+    return tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        input_schema: {
+            type: 'object',
+            ...t.inputSchema,
+        },
+    }));
+}
+/**
+ * Convert an Anthropic SDK `ContentBlock` into a framework {@link ContentBlock}.
+ *
+ * We only map the subset of SDK types that the framework exposes. Unknown
+ * variants (thinking, server_tool_use, etc.) are converted to a text block
+ * carrying a stringified representation so data is never silently dropped.
+ */
+function fromAnthropicContentBlock(block) {
+    switch (block.type) {
+        case 'text': {
+            const text = { type: 'text', text: block.text };
+            return text;
+        }
+        case 'tool_use': {
+            const toolUse = {
+                type: 'tool_use',
+                id: block.id,
+                name: block.name,
+                input: block.input,
+            };
+            return toolUse;
+        }
+        default: {
+            // Graceful degradation for SDK types we don't model (thinking, etc.).
+            const fallback = {
+                type: 'text',
+                text: `[unsupported block type: ${block.type}]`,
+            };
+            return fallback;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+/**
+ * LLM adapter backed by the Anthropic Claude API.
+ *
+ * Thread-safe — a single instance may be shared across concurrent agent runs.
+ * The underlying SDK client is stateless across requests.
+ */
+export class AnthropicAdapter {
+    name = 'anthropic';
+    #client;
+    constructor(apiKey) {
+        this.#client = new Anthropic({
+            apiKey: apiKey ?? process.env['ANTHROPIC_API_KEY'],
+        });
+    }
+    // -------------------------------------------------------------------------
+    // chat()
+    // -------------------------------------------------------------------------
+    /**
+     * Send a synchronous (non-streaming) chat request and return the complete
+     * {@link LLMResponse}.
+     *
+     * Throws an `Anthropic.APIError` on non-2xx responses. Callers should catch
+     * and handle these (e.g. rate limits, context window exceeded).
+     */
+    async chat(messages, options) {
+        const anthropicMessages = toAnthropicMessages(messages);
+        const response = await this.#client.messages.create({
+            model: options.model,
+            max_tokens: options.maxTokens ?? 4096,
+            messages: anthropicMessages,
+            system: options.systemPrompt,
+            tools: options.tools ? toAnthropicTools(options.tools) : undefined,
+            temperature: options.temperature,
+        }, {
+            signal: options.abortSignal,
+        });
+        const content = response.content.map(fromAnthropicContentBlock);
+        return {
+            id: response.id,
+            content,
+            model: response.model,
+            stop_reason: response.stop_reason ?? 'end_turn',
+            usage: {
+                input_tokens: response.usage.input_tokens,
+                output_tokens: response.usage.output_tokens,
+            },
+        };
+    }
+    // -------------------------------------------------------------------------
+    // stream()
+    // -------------------------------------------------------------------------
+    /**
+     * Send a streaming chat request and yield {@link StreamEvent}s as they
+     * arrive from the API.
+     *
+     * Sequence guarantees:
+     * - Zero or more `text` events containing incremental deltas
+     * - Zero or more `tool_use` events when the model calls a tool (emitted once
+     *   per tool use, after input JSON has been fully assembled)
+     * - Exactly one terminal event: `done` (with the complete {@link LLMResponse}
+     *   as `data`) or `error` (with an `Error` as `data`)
+     */
+    async *stream(messages, options) {
+        const anthropicMessages = toAnthropicMessages(messages);
+        // MessageStream gives us typed events and handles SSE reconnect internally.
+        const stream = this.#client.messages.stream({
+            model: options.model,
+            max_tokens: options.maxTokens ?? 4096,
+            messages: anthropicMessages,
+            system: options.systemPrompt,
+            tools: options.tools ? toAnthropicTools(options.tools) : undefined,
+            temperature: options.temperature,
+        }, {
+            signal: options.abortSignal,
+        });
+        // Accumulate tool-use input JSON as it streams in.
+        // key = content block index, value = partially assembled input JSON string
+        const toolInputBuffers = new Map();
+        try {
+            for await (const event of stream) {
+                switch (event.type) {
+                    case 'content_block_start': {
+                        const block = event.content_block;
+                        if (block.type === 'tool_use') {
+                            toolInputBuffers.set(event.index, {
+                                id: block.id,
+                                name: block.name,
+                                json: '',
+                            });
+                        }
+                        break;
+                    }
+                    case 'content_block_delta': {
+                        const delta = event.delta;
+                        if (delta.type === 'text_delta') {
+                            const textEvent = { type: 'text', data: delta.text };
+                            yield textEvent;
+                        }
+                        else if (delta.type === 'input_json_delta') {
+                            const buf = toolInputBuffers.get(event.index);
+                            if (buf !== undefined) {
+                                buf.json += delta.partial_json;
+                            }
+                        }
+                        break;
+                    }
+                    case 'content_block_stop': {
+                        const buf = toolInputBuffers.get(event.index);
+                        if (buf !== undefined) {
+                            // Parse the accumulated JSON and emit a tool_use event.
+                            let parsedInput = {};
+                            try {
+                                const parsed = JSON.parse(buf.json);
+                                if (parsed !== null &&
+                                    typeof parsed === 'object' &&
+                                    !Array.isArray(parsed)) {
+                                    parsedInput = parsed;
+                                }
+                            }
+                            catch {
+                                // Malformed JSON from the model — surface as an empty object
+                                // rather than crashing the stream.
+                            }
+                            const toolUseBlock = {
+                                type: 'tool_use',
+                                id: buf.id,
+                                name: buf.name,
+                                input: parsedInput,
+                            };
+                            const toolUseEvent = { type: 'tool_use', data: toolUseBlock };
+                            yield toolUseEvent;
+                            toolInputBuffers.delete(event.index);
+                        }
+                        break;
+                    }
+                    // message_start, message_delta, message_stop — we handle the final
+                    // response via stream.finalMessage() below rather than piecemeal.
+                    default:
+                        break;
+                }
+            }
+            // Await the fully assembled final message (token counts, stop_reason, etc.)
+            const finalMessage = await stream.finalMessage();
+            const content = finalMessage.content.map(fromAnthropicContentBlock);
+            const finalResponse = {
+                id: finalMessage.id,
+                content,
+                model: finalMessage.model,
+                stop_reason: finalMessage.stop_reason ?? 'end_turn',
+                usage: {
+                    input_tokens: finalMessage.usage.input_tokens,
+                    output_tokens: finalMessage.usage.output_tokens,
+                },
+            };
+            const doneEvent = { type: 'done', data: finalResponse };
+            yield doneEvent;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            const errorEvent = { type: 'error', data: error };
+            yield errorEvent;
+        }
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/llm/anthropic.js.map

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

package/dist/llm/openai.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview OpenAI adapter implementing {@link LLMAdapter}.
+ *
+ * Converts between the framework's internal {@link ContentBlock} types and the
+ * OpenAI Chat Completions wire format. Key mapping decisions:
+ *
+ * - Framework `tool_use` blocks in assistant messages → OpenAI `tool_calls`
+ * - Framework `tool_result` blocks in user messages  → OpenAI `tool` role messages
+ * - Framework `image` blocks in user messages        → OpenAI image content parts
+ * - System prompt in {@link LLMChatOptions}           → prepended `system` message
+ *
+ * Because OpenAI and Anthropic use fundamentally different role-based structures
+ * for tool calling (Anthropic embeds tool results in user-role content arrays;
+ * OpenAI uses a dedicated `tool` role), the conversion necessarily splits
+ * `tool_result` blocks out into separate top-level messages.
+ *
+ * API key resolution order:
+ *   1. `apiKey` constructor argument
+ *   2. `OPENAI_API_KEY` environment variable
+ *
+ * @example
+ * ```ts
+ * import { OpenAIAdapter } from './openai.js'
+ *
+ * const adapter = new OpenAIAdapter()
+ * const response = await adapter.chat(messages, {
+ *   model: 'gpt-5.4',
+ *   maxTokens: 1024,
+ * })
+ * ```
+ */
+import type { ContentBlock, LLMAdapter, LLMChatOptions, LLMMessage, LLMResponse, LLMStreamOptions, LLMToolDef, StreamEvent } from '../types.js';
+/**
+ * LLM adapter backed by the OpenAI Chat Completions API.
+ *
+ * Thread-safe — a single instance may be shared across concurrent agent runs.
+ */
+export declare class OpenAIAdapter implements LLMAdapter {
+    #private;
+    readonly name = "openai";
+    constructor(apiKey?: string);
+    /**
+     * Send a synchronous (non-streaming) chat request and return the complete
+     * {@link LLMResponse}.
+     *
+     * Throws an `OpenAI.APIError` on non-2xx responses. Callers should catch and
+     * handle these (e.g. rate limits, context length exceeded).
+     */
+    chat(messages: LLMMessage[], options: LLMChatOptions): Promise<LLMResponse>;
+    /**
+     * Send a streaming chat request and yield {@link StreamEvent}s incrementally.
+     *
+     * Sequence guarantees match {@link AnthropicAdapter.stream}:
+     * - Zero or more `text` events
+     * - Zero or more `tool_use` events (emitted once per tool call, after
+     *   arguments have been fully assembled)
+     * - Exactly one terminal event: `done` or `error`
+     */
+    stream(messages: LLMMessage[], options: LLMStreamOptions): AsyncIterable<StreamEvent>;
+}
+export type { ContentBlock, LLMAdapter, LLMChatOptions, LLMMessage, LLMResponse, LLMStreamOptions, LLMToolDef, StreamEvent, };
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/llm/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAcH,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EAGZ,MAAM,aAAa,CAAA;AAwOpB;;;;GAIG;AACH,qBAAa,aAAc,YAAW,UAAU;;IAC9C,QAAQ,CAAC,IAAI,YAAW;gBAIZ,MAAM,CAAC,EAAE,MAAM;IAU3B;;;;;;OAMG;IACG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBjF;;;;;;;;OAQG;IACI,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,EAAE,gBAAgB,GACxB,aAAa,CAAC,WAAW,CAAC;CAsI9B;AA4BD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,GACZ,CAAA"}