@open-multi-agent/core 1.4.0

package/dist/llm/anthropic.js

@@ -0,0 +1,432 @@
+/**
+ * @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, or `null`
+ * when the block has no faithful representation on the wire (e.g. a
+ * reasoning block from another provider that lacks an Anthropic signature).
+ *
+ * `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 'reasoning': {
+            // Anthropic strictly validates the signature on echoed thinking
+            // blocks, so we only round-trip blocks that originated here:
+            //   - `redactedData` -> `redacted_thinking` (opaque, signature lives inside)
+            //   - `signature`    -> `thinking` block with text + signature
+            // Cross-provider reasoning (e.g. Gemini thought summaries) and
+            // unsigned reasoning text from a single-turn final response carry no
+            // valid signature, so dropping them is safer than risking an API
+            // rejection on the next turn.
+            if (block.redactedData !== undefined) {
+                const param = {
+                    type: 'redacted_thinking',
+                    data: block.redactedData,
+                };
+                return param;
+            }
+            if (block.signature !== undefined) {
+                const param = {
+                    type: 'thinking',
+                    thinking: block.text,
+                    signature: block.signature,
+                };
+                return param;
+            }
+            return null;
+        }
+        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)
+            .filter((p) => p !== null),
+    }));
+}
+/**
+ * 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 are converted to a text block carrying a stringified
+ * representation so data is never silently dropped.
+ */
+function fromAnthropicContentBlock(block) {
+    switch (block.type) {
+        case 'thinking': {
+            // `signature` is required by the API to continue a multi-turn extended
+            // thinking conversation. Carry it on the framework block so the next
+            // turn can echo the original reasoning back unchanged.
+            const reasoning = {
+                type: 'reasoning',
+                text: block.thinking,
+                signature: block.signature,
+            };
+            return reasoning;
+        }
+        case 'redacted_thinking': {
+            // Anthropic returns redacted thinking when its safety system replaces
+            // the raw reasoning text with an opaque encrypted payload. The block
+            // must still be echoed back on subsequent turns, so we carry the
+            // payload via `redactedData` and leave `text` empty.
+            const reasoning = {
+                type: 'reasoning',
+                text: '',
+                redactedData: block.data,
+            };
+            return reasoning;
+        }
+        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.
+            const fallback = {
+                type: 'text',
+                text: `[unsupported block type: ${block.type}]`,
+            };
+            return fallback;
+        }
+    }
+}
+/**
+ * Convert the framework's {@link ThinkingConfig} into Anthropic's
+ * `thinking` request param. Returns `undefined` when the caller hasn't
+ * opted in, leaving the field absent from the request payload.
+ *
+ * Validates against the API's two `budget_tokens` constraints:
+ *   1. `budget_tokens >= 1024` (SDK-documented minimum, smaller budgets
+ *      yield no useful reasoning)
+ *   2. `budget_tokens < max_tokens` (docs: "budget_tokens must be set to a
+ *      value less than max_tokens"). Throws early with a clear message
+ *      rather than letting Anthropic return a 400.
+ *
+ * Defaults `budgetTokens` to 1024 when enabled without an explicit value;
+ * combined with the second constraint, this means a caller passing
+ * `thinking.enabled = true` MUST also set `maxTokens > 1024`.
+ *
+ * Model compatibility: emits `{type: 'enabled', budget_tokens}` which is
+ * supported by Claude Sonnet 3.7 and all Claude 4.x models up to and
+ * including 4.6 (deprecated on 4.6 in favor of `adaptive`). Claude Opus 4.7+
+ * accepts only `{type: 'adaptive'}` and rejects this shape with HTTP 400.
+ * Adaptive thinking support is tracked as a follow-up to RFC #200's phase 1.
+ *
+ * The `interleaved-thinking-2025-05-14` beta header (which would relax the
+ * `budget_tokens < max_tokens` rule for Claude 4.x manual mode) is not yet
+ * wired up — see RFC #200 phase 2.
+ */
+function toAnthropicThinkingParam(thinking, maxTokens) {
+    if (thinking === undefined || !thinking.enabled)
+        return undefined;
+    const budget = thinking.budgetTokens ?? 1024;
+    if (budget < 1024) {
+        throw new Error(`[anthropic] thinking.budgetTokens must be >= 1024 (got ${budget}); ` +
+            `the Anthropic API enforces this minimum.`);
+    }
+    if (budget >= maxTokens) {
+        throw new Error(`[anthropic] thinking.budgetTokens (${budget}) must be < maxTokens (${maxTokens}); ` +
+            `the Anthropic API rejects requests where budget_tokens >= max_tokens. ` +
+            `Either lower thinking.budgetTokens or raise maxTokens.`);
+    }
+    return {
+        type: 'enabled',
+        budget_tokens: budget,
+    };
+}
+// ---------------------------------------------------------------------------
+// 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, baseURL) {
+        this.#client = new Anthropic({
+            apiKey: apiKey ?? process.env['ANTHROPIC_API_KEY'],
+            baseURL,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // 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 effectiveMaxTokens = options.maxTokens ?? 4096;
+        const response = await this.#client.messages.create({
+            // Sampling params first so extraBody can override them. Structural
+            // fields (model/messages/system/tools/thinking) come after extraBody
+            // so users cannot accidentally clobber them via extraBody.
+            max_tokens: effectiveMaxTokens,
+            temperature: options.temperature,
+            top_p: options.topP,
+            top_k: options.topK,
+            ...options.extraBody,
+            model: options.model,
+            messages: anthropicMessages,
+            system: options.systemPrompt,
+            tools: options.tools ? toAnthropicTools(options.tools) : undefined,
+            thinking: toAnthropicThinkingParam(options.thinking, effectiveMaxTokens),
+            // Cast covers arbitrary `extraBody` keys not declared by the SDK.
+        }, {
+            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 `reasoning` events containing incremental thinking 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);
+        const effectiveMaxTokens = options.maxTokens ?? 4096;
+        // MessageStream gives us typed events and handles SSE reconnect internally.
+        const stream = this.#client.messages.stream({
+            // See chat() above for the rationale behind this field ordering.
+            max_tokens: effectiveMaxTokens,
+            temperature: options.temperature,
+            top_p: options.topP,
+            top_k: options.topK,
+            ...options.extraBody,
+            model: options.model,
+            messages: anthropicMessages,
+            system: options.systemPrompt,
+            tools: options.tools ? toAnthropicTools(options.tools) : undefined,
+            thinking: toAnthropicThinkingParam(options.thinking, effectiveMaxTokens),
+        }, {
+            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;
+                        switch (delta.type) {
+                            case 'text_delta': {
+                                const textEvent = { type: 'text', data: delta.text };
+                                yield textEvent;
+                                break;
+                            }
+                            case 'thinking_delta': {
+                                const reasoningEvent = { type: 'reasoning', data: delta.thinking };
+                                yield reasoningEvent;
+                                break;
+                            }
+                            case 'input_json_delta': {
+                                const buf = toolInputBuffers.get(event.index);
+                                if (buf !== undefined) {
+                                    buf.json += delta.partial_json;
+                                }
+                                break;
+                            }
+                            default:
+                                break;
+                        }
+                        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/azure-openai.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview Azure OpenAI adapter implementing {@link LLMAdapter}.
+ *
+ * Azure OpenAI uses regional deployment endpoints and API versioning that differ
+ * from standard OpenAI:
+ *
+ * - Endpoint: `https://{resource-name}.openai.azure.com`
+ * - API version: Query parameter (e.g., `?api-version=2024-10-21`)
+ * - Model/Deployment: Users deploy models with custom names; the `model` field
+ *   in agent config should contain the Azure deployment name, not the underlying
+ *   model name (e.g., `model: 'my-gpt4-deployment'`)
+ *
+ * The OpenAI SDK provides an `AzureOpenAI` client class that handles these
+ * Azure-specific requirements. This adapter uses that client while reusing all
+ * message conversion logic from `openai-common.ts`.
+ *
+ * Environment variable resolution order:
+ *   1. Constructor arguments
+ *   2. `AZURE_OPENAI_API_KEY` environment variable
+ *   3. `AZURE_OPENAI_ENDPOINT` environment variable
+ *   4. `AZURE_OPENAI_API_VERSION` environment variable (defaults to '2024-10-21')
+ *   5. `AZURE_OPENAI_DEPLOYMENT` as an optional fallback when `model` is blank
+ *
+ * Note: Azure introduced a next-generation v1 API (August 2025) that uses the standard
+ * OpenAI() client with baseURL set to `{endpoint}/openai/v1/` and requires no api-version.
+ * That path is not yet supported by this adapter. To use it, pass `provider: 'openai'`
+ * with `baseURL: 'https://{resource}.openai.azure.com/openai/v1/'` in your agent config.
+ *
+ * @example
+ * ```ts
+ * import { AzureOpenAIAdapter } from './azure-openai.js'
+ *
+ * const adapter = new AzureOpenAIAdapter()
+ * const response = await adapter.chat(messages, {
+ *   model: 'my-gpt4-deployment',  // Azure deployment name, not 'gpt-4'
+ *   maxTokens: 1024,
+ * })
+ * ```
+ */
+import type { LLMAdapter, LLMChatOptions, LLMMessage, LLMResponse, LLMStreamOptions, StreamEvent } from '../types.js';
+/**
+ * LLM adapter backed by Azure OpenAI Chat Completions API.
+ *
+ * Thread-safe — a single instance may be shared across concurrent agent runs.
+ */
+export declare class AzureOpenAIAdapter implements LLMAdapter {
+    #private;
+    readonly name: string;
+    /**
+     * @param apiKey - Azure OpenAI API key (falls back to AZURE_OPENAI_API_KEY env var)
+     * @param endpoint - Azure endpoint URL (falls back to AZURE_OPENAI_ENDPOINT env var)
+     * @param apiVersion - API version string (falls back to AZURE_OPENAI_API_VERSION, defaults to '2024-10-21')
+     */
+    constructor(apiKey?: string, endpoint?: string, apiVersion?: string);
+    /**
+     * Send a synchronous (non-streaming) chat request and return the complete
+     * {@link LLMResponse}.
+     *
+     * Throws an `AzureOpenAI.APIError` on non-2xx responses. Callers should catch and
+     * handle these (e.g. rate limits, context length exceeded, deployment not found).
+     */
+    chat(messages: LLMMessage[], options: LLMChatOptions): Promise<LLMResponse>;
+    /**
+     * Send a streaming chat request and yield {@link StreamEvent}s incrementally.
+     *
+     * Sequence guarantees match {@link OpenAIAdapter.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>;
+}
+//# sourceMappingURL=azure-openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"azure-openai.d.ts","sourceRoot":"","sources":["../../src/llm/azure-openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAOH,OAAO,KAAK,EAEV,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EAGZ,MAAM,aAAa,CAAA;AA8BpB;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,UAAU;;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAiB;IAItC;;;;OAIG;gBACS,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAYnE;;;;;;OAMG;IACG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAqCjF;;;;;;;;OAQG;IACI,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,EAAE,gBAAgB,GACxB,aAAa,CAAC,WAAW,CAAC;CAiK9B"}