@open-multi-agent/core 1.4.0

package/dist/llm/gemini.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Google Gemini adapter implementing {@link LLMAdapter}.
+ *
+ * Built for `@google/genai` (the unified Google Gen AI SDK, v1.x), NOT the
+ * legacy `@google/generative-ai` package.
+ *
+ * Converts between the framework's internal {@link ContentBlock} types and the
+ * `@google/genai` 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. `GEMINI_API_KEY` environment variable
+ *   3. `GOOGLE_API_KEY` environment variable
+ *
+ * @example
+ * ```ts
+ * import { GeminiAdapter } from './gemini.js'
+ *
+ * const adapter = new GeminiAdapter()
+ * const response = await adapter.chat(messages, {
+ *   model: 'gemini-2.5-flash',
+ *   maxTokens: 1024,
+ * })
+ * ```
+ */
+import type { LLMAdapter, LLMChatOptions, LLMMessage, LLMResponse, LLMStreamOptions, StreamEvent } from '../types.js';
+/**
+ * LLM adapter backed by the Google Gemini API via `@google/genai`.
+ *
+ * Thread-safe — a single instance may be shared across concurrent agent runs.
+ * The underlying SDK client is stateless across requests.
+ */
+export declare class GeminiAdapter implements LLMAdapter {
+    #private;
+    readonly name = "gemini";
+    constructor(apiKey?: string);
+    /**
+     * Send a synchronous (non-streaming) chat request and return the complete
+     * {@link LLMResponse}.
+     *
+     * Uses `ai.models.generateContent()` with the full conversation as `contents`,
+     * which is the idiomatic pattern for `@google/genai`.
+     */
+    chat(messages: LLMMessage[], options: LLMChatOptions): Promise<LLMResponse>;
+    /**
+     * Send a streaming chat request and yield {@link StreamEvent}s as they
+     * arrive from the API.
+     *
+     * Uses `ai.models.generateContentStream()` which returns an
+     * `AsyncGenerator<GenerateContentResponse>`. Each yielded chunk has the same
+     * shape as a full response but contains only the delta for that chunk.
+     *
+     * Because `@google/genai` doesn't expose a `finalMessage()` helper like the
+     * Anthropic SDK, we accumulate content and token counts as we stream so that
+     * the terminal `done` event carries a complete and accurate {@link LLMResponse}.
+     *
+     * Sequence guarantees (matching the Anthropic adapter):
+     * - Zero or more `text` events with incremental deltas
+     * - Zero or more `tool_use` events (one per call; Gemini doesn't stream args)
+     * - Exactly one terminal event: `done` or `error`
+     */
+    stream(messages: LLMMessage[], options: LLMStreamOptions): AsyncIterable<StreamEvent>;
+}
+//# sourceMappingURL=gemini.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/llm/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAcH,OAAO,KAAK,EAEV,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAGhB,WAAW,EAGZ,MAAM,aAAa,CAAA;AAgTpB;;;;;GAKG;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;IAiBjF;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,EAAE,gBAAgB,GACxB,aAAa,CAAC,WAAW,CAAC;CA0E9B"}

package/dist/llm/gemini.js

@@ -0,0 +1,427 @@
+/**
+ * @fileoverview Google Gemini adapter implementing {@link LLMAdapter}.
+ *
+ * Built for `@google/genai` (the unified Google Gen AI SDK, v1.x), NOT the
+ * legacy `@google/generative-ai` package.
+ *
+ * Converts between the framework's internal {@link ContentBlock} types and the
+ * `@google/genai` 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. `GEMINI_API_KEY` environment variable
+ *   3. `GOOGLE_API_KEY` environment variable
+ *
+ * @example
+ * ```ts
+ * import { GeminiAdapter } from './gemini.js'
+ *
+ * const adapter = new GeminiAdapter()
+ * const response = await adapter.chat(messages, {
+ *   model: 'gemini-2.5-flash',
+ *   maxTokens: 1024,
+ * })
+ * ```
+ */
+import { GoogleGenAI, FunctionCallingConfigMode, } from '@google/genai';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Map framework role names to Gemini role names.
+ *
+ * Gemini uses `"model"` instead of `"assistant"`.
+ */
+function toGeminiRole(role) {
+    return role === 'assistant' ? 'model' : 'user';
+}
+/**
+ * Convert framework messages into Gemini's {@link Content}[] format.
+ *
+ * Key differences from Anthropic:
+ * - Gemini uses `"model"` instead of `"assistant"`.
+ * - `functionResponse` parts (tool results) must appear in `"user"` turns.
+ * - `functionCall` parts appear in `"model"` turns.
+ * - We build a name lookup map from tool_use blocks so tool_result blocks
+ *   can resolve the function name required by Gemini's `functionResponse`.
+ *
+ * Reasoning handling: Gemini's `thoughtSignature` is a top-level field on
+ * Part that accompanies a functionCall Part, identifying the signed thought
+ * sequence that produced the call. We attach it to the outgoing Part
+ * whenever the source {@link ToolUseBlock} carries a signature. Thought
+ * summaries (incoming text Parts with `thought: true` surfaced as
+ * {@link ReasoningBlock}) are echoed back only when they carry a signature
+ * — Gemini 3 recommends round-tripping these signatures, but unsigned
+ * reasoning (e.g. cross-provider blocks or Gemini 2.5 thought summaries
+ * which never carry signatures) is dropped to keep context lean.
+ */
+function toGeminiContents(messages) {
+    // First pass: build id → name map for resolving tool results.
+    const toolNameById = new Map();
+    for (const msg of messages) {
+        for (const block of msg.content) {
+            if (block.type === 'tool_use') {
+                toolNameById.set(block.id, block.name);
+            }
+        }
+    }
+    return messages.map((msg) => {
+        const parts = [];
+        for (const block of msg.content) {
+            switch (block.type) {
+                case 'reasoning': {
+                    // Echo only when we have a signature to round-trip — see JSDoc
+                    // above. Drop unsigned reasoning silently rather than emitting an
+                    // empty/unsigned text part that would inflate context for no
+                    // protocol benefit.
+                    if (block.signature === undefined)
+                        break;
+                    const part = {
+                        text: block.text,
+                        thought: true,
+                        thoughtSignature: block.signature,
+                    };
+                    parts.push(part);
+                    break;
+                }
+                case 'text':
+                    parts.push({ text: block.text });
+                    break;
+                case 'tool_use': {
+                    const part = {
+                        functionCall: {
+                            id: block.id,
+                            name: block.name,
+                            args: block.input,
+                        },
+                    };
+                    if (block.signature !== undefined) {
+                        // thoughtSignature is a top-level field on Part (NOT nested under
+                        // functionCall) — see Part schema in @google/genai. Required by
+                        // Gemini 3+ to maintain extended-thinking context across tool-use
+                        // turns.
+                        part.thoughtSignature = block.signature;
+                    }
+                    parts.push(part);
+                    break;
+                }
+                case 'tool_result': {
+                    const name = toolNameById.get(block.tool_use_id) ?? block.tool_use_id;
+                    parts.push({
+                        functionResponse: {
+                            id: block.tool_use_id,
+                            name,
+                            response: {
+                                content: typeof block.content === 'string'
+                                    ? block.content
+                                    : JSON.stringify(block.content),
+                                isError: block.is_error ?? false,
+                            },
+                        },
+                    });
+                    break;
+                }
+                case 'image':
+                    parts.push({
+                        inlineData: {
+                            mimeType: block.source.media_type,
+                            data: block.source.data,
+                        },
+                    });
+                    break;
+                default: {
+                    const _exhaustive = block;
+                    throw new Error(`Unhandled content block type: ${JSON.stringify(_exhaustive)}`);
+                }
+            }
+        }
+        return { role: toGeminiRole(msg.role), parts };
+    });
+}
+/**
+ * Convert framework {@link LLMToolDef}s into a Gemini `tools` config array.
+ *
+ * In `@google/genai`, function declarations use `parametersJsonSchema` (not
+ * `parameters` or `input_schema`). All declarations are grouped under a single
+ * tool entry.
+ */
+function toGeminiTools(tools) {
+    const functionDeclarations = tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        parametersJsonSchema: t.inputSchema,
+    }));
+    return [{ functionDeclarations }];
+}
+/**
+ * Convert the framework's {@link ThinkingConfig} into Gemini's
+ * `thinkingConfig`. Returns `undefined` when the caller hasn't opted in,
+ * leaving the field absent so server defaults apply.
+ *
+ * `includeThoughts` defaults on when extended thinking is enabled — the
+ * thought-summary stream is the only way for callers to surface model
+ * reasoning, and the cost of the metadata is negligible. `thinkingBudget`
+ * is forwarded only when the caller specifies one (Gemini accepts -1 to
+ * mean "dynamic").
+ */
+function toGeminiThinkingConfig(thinking) {
+    if (thinking === undefined || !thinking.enabled)
+        return undefined;
+    const config = { includeThoughts: true };
+    if (thinking.budgetTokens !== undefined) {
+        config.thinkingBudget = thinking.budgetTokens;
+    }
+    return config;
+}
+/**
+ * Build the {@link GenerateContentConfig} shared by chat() and stream().
+ */
+function buildConfig(options) {
+    return {
+        maxOutputTokens: options.maxTokens ?? 4096,
+        temperature: options.temperature,
+        systemInstruction: options.systemPrompt,
+        tools: options.tools ? toGeminiTools(options.tools) : undefined,
+        toolConfig: options.tools
+            ? { functionCallingConfig: { mode: FunctionCallingConfigMode.AUTO } }
+            : undefined,
+        thinkingConfig: toGeminiThinkingConfig(options.thinking),
+        abortSignal: options.abortSignal,
+    };
+}
+/**
+ * Generate a stable pseudo-random ID string for tool use blocks.
+ *
+ * Gemini may not always return call IDs (especially in streaming), so we
+ * fabricate them when absent to satisfy the framework's {@link ToolUseBlock}
+ * contract.
+ */
+function generateId() {
+    return `gemini-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+/**
+ * Extract the function call ID from a Gemini part, or generate one.
+ *
+ * The `id` field exists in newer API versions but may be absent in older
+ * responses, so we cast conservatively and fall back to a generated ID.
+ */
+function getFunctionCallId(part) {
+    return part.functionCall?.id ?? generateId();
+}
+/**
+ * Extract `thoughtSignature` from a Gemini Part.
+ *
+ * Gemini puts thoughtSignature as a top-level field on Part (NOT nested
+ * under functionCall, despite some early docs implying otherwise — see
+ * the Part schema in @google/genai). Gemini 3+ rejects subsequent turns
+ * when the signature isn't echoed back unchanged on the corresponding
+ * functionCall part.
+ */
+function getThoughtSignature(part) {
+    return part.thoughtSignature;
+}
+/**
+ * Convert a single Gemini {@link Part} into zero or one framework
+ * {@link ContentBlock}s. Returns `null` for parts we don't model so the
+ * caller can skip them without inflating the content array.
+ *
+ * Recognised inputs:
+ * - text part with `thought: true` → {@link ReasoningBlock} (thought summary,
+ *   carries `thoughtSignature` on Gemini 3 if present)
+ * - regular text part            → {@link TextBlock}
+ * - functionCall part            → {@link ToolUseBlock} (with optional signature)
+ */
+function fromGeminiPart(part) {
+    if (part.functionCall !== undefined) {
+        const block = {
+            type: 'tool_use',
+            id: getFunctionCallId(part),
+            name: part.functionCall.name ?? '',
+            input: (part.functionCall.args ?? {}),
+        };
+        const signature = getThoughtSignature(part);
+        if (signature !== undefined) {
+            return { ...block, signature };
+        }
+        return block;
+    }
+    if (part.text !== undefined && part.text !== '') {
+        if (part.thought === true) {
+            const reasoning = { type: 'reasoning', text: part.text };
+            // Gemini 3 may attach thoughtSignature to thought-summary parts too.
+            // Preserve it on the framework block so the next turn can echo it
+            // back — see toGeminiContents reasoning case for the round-trip.
+            const signature = getThoughtSignature(part);
+            if (signature !== undefined) {
+                return { ...reasoning, signature };
+            }
+            return reasoning;
+        }
+        return { type: 'text', text: part.text };
+    }
+    // inlineData echoes and other part types are silently ignored.
+    return null;
+}
+/**
+ * Convert a Gemini {@link GenerateContentResponse} into a framework
+ * {@link LLMResponse}.
+ */
+function fromGeminiResponse(response, id, model) {
+    const candidate = response.candidates?.[0];
+    const content = [];
+    for (const part of candidate?.content?.parts ?? []) {
+        const block = fromGeminiPart(part);
+        if (block !== null)
+            content.push(block);
+    }
+    // Map Gemini finish reasons to framework stop_reason vocabulary.
+    const finishReason = candidate?.finishReason;
+    let stop_reason = 'end_turn';
+    if (finishReason === 'MAX_TOKENS') {
+        stop_reason = 'max_tokens';
+    }
+    else if (content.some((b) => b.type === 'tool_use')) {
+        // Gemini may report STOP even when it returned function calls.
+        stop_reason = 'tool_use';
+    }
+    const usage = response.usageMetadata;
+    return {
+        id,
+        content,
+        model,
+        stop_reason,
+        usage: {
+            input_tokens: usage?.promptTokenCount ?? 0,
+            output_tokens: usage?.candidatesTokenCount ?? 0,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+/**
+ * LLM adapter backed by the Google Gemini API via `@google/genai`.
+ *
+ * Thread-safe — a single instance may be shared across concurrent agent runs.
+ * The underlying SDK client is stateless across requests.
+ */
+export class GeminiAdapter {
+    name = 'gemini';
+    #client;
+    constructor(apiKey) {
+        this.#client = new GoogleGenAI({
+            apiKey: apiKey ?? process.env['GEMINI_API_KEY'] ?? process.env['GOOGLE_API_KEY'],
+        });
+    }
+    // -------------------------------------------------------------------------
+    // chat()
+    // -------------------------------------------------------------------------
+    /**
+     * Send a synchronous (non-streaming) chat request and return the complete
+     * {@link LLMResponse}.
+     *
+     * Uses `ai.models.generateContent()` with the full conversation as `contents`,
+     * which is the idiomatic pattern for `@google/genai`.
+     */
+    async chat(messages, options) {
+        const id = generateId();
+        const contents = toGeminiContents(messages);
+        const response = await this.#client.models.generateContent({
+            model: options.model,
+            contents,
+            config: buildConfig(options),
+        });
+        return fromGeminiResponse(response, id, options.model);
+    }
+    // -------------------------------------------------------------------------
+    // stream()
+    // -------------------------------------------------------------------------
+    /**
+     * Send a streaming chat request and yield {@link StreamEvent}s as they
+     * arrive from the API.
+     *
+     * Uses `ai.models.generateContentStream()` which returns an
+     * `AsyncGenerator<GenerateContentResponse>`. Each yielded chunk has the same
+     * shape as a full response but contains only the delta for that chunk.
+     *
+     * Because `@google/genai` doesn't expose a `finalMessage()` helper like the
+     * Anthropic SDK, we accumulate content and token counts as we stream so that
+     * the terminal `done` event carries a complete and accurate {@link LLMResponse}.
+     *
+     * Sequence guarantees (matching the Anthropic adapter):
+     * - Zero or more `text` events with incremental deltas
+     * - Zero or more `tool_use` events (one per call; Gemini doesn't stream args)
+     * - Exactly one terminal event: `done` or `error`
+     */
+    async *stream(messages, options) {
+        const id = generateId();
+        const contents = toGeminiContents(messages);
+        try {
+            const streamResponse = await this.#client.models.generateContentStream({
+                model: options.model,
+                contents,
+                config: buildConfig(options),
+            });
+            // Accumulators for building the done payload.
+            const accumulatedContent = [];
+            let inputTokens = 0;
+            let outputTokens = 0;
+            let lastFinishReason;
+            for await (const chunk of streamResponse) {
+                const candidate = chunk.candidates?.[0];
+                // Accumulate token counts — the API emits these on the final chunk.
+                if (chunk.usageMetadata) {
+                    inputTokens = chunk.usageMetadata.promptTokenCount ?? inputTokens;
+                    outputTokens = chunk.usageMetadata.candidatesTokenCount ?? outputTokens;
+                }
+                if (candidate?.finishReason) {
+                    lastFinishReason = candidate.finishReason;
+                }
+                for (const part of candidate?.content?.parts ?? []) {
+                    const block = fromGeminiPart(part);
+                    if (block === null)
+                        continue;
+                    accumulatedContent.push(block);
+                    switch (block.type) {
+                        case 'text':
+                            yield { type: 'text', data: block.text };
+                            break;
+                        case 'reasoning':
+                            // Thought summary delta — surface as a reasoning event so
+                            // observers can stream model thinking the same way they do
+                            // for Anthropic's `thinking_delta`.
+                            yield { type: 'reasoning', data: block.text };
+                            break;
+                        case 'tool_use':
+                            yield { type: 'tool_use', data: block };
+                            break;
+                        // No other block types come back from Gemini parts.
+                    }
+                }
+            }
+            // Determine stop_reason from the accumulated response.
+            const hasToolUse = accumulatedContent.some((b) => b.type === 'tool_use');
+            let stop_reason = 'end_turn';
+            if (lastFinishReason === 'MAX_TOKENS') {
+                stop_reason = 'max_tokens';
+            }
+            else if (hasToolUse) {
+                stop_reason = 'tool_use';
+            }
+            const finalResponse = {
+                id,
+                content: accumulatedContent,
+                model: options.model,
+                stop_reason,
+                usage: { input_tokens: inputTokens, output_tokens: outputTokens },
+            };
+            yield { type: 'done', data: finalResponse };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            yield { type: 'error', data: error };
+        }
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/llm/gemini.js.map

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

package/dist/llm/grok.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Grok (xAI) adapter.
+ *
+ * Thin wrapper around OpenAIAdapter that hard-codes the official xAI endpoint
+ * and XAI_API_KEY environment variable fallback.
+ */
+import { OpenAIAdapter } from './openai.js';
+/**
+ * LLM adapter for Grok models (grok-4 series and future models).
+ *
+ * Thread-safe. Can be shared across agents.
+ *
+ * Usage:
+ *   provider: 'grok'
+ *   model: 'grok-4' (or any current Grok model name)
+ */
+export declare class GrokAdapter extends OpenAIAdapter {
+    readonly name = "grok";
+    constructor(apiKey?: string, baseURL?: string);
+}
+//# sourceMappingURL=grok.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grok.d.ts","sourceRoot":"","sources":["../../src/llm/grok.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C;;;;;;;;GAQG;AACH,qBAAa,WAAY,SAAQ,aAAa;IAC5C,QAAQ,CAAC,IAAI,UAAS;gBAEV,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAO9C"}

package/dist/llm/grok.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Grok (xAI) adapter.
+ *
+ * Thin wrapper around OpenAIAdapter that hard-codes the official xAI endpoint
+ * and XAI_API_KEY environment variable fallback.
+ */
+import { OpenAIAdapter } from './openai.js';
+/**
+ * LLM adapter for Grok models (grok-4 series and future models).
+ *
+ * Thread-safe. Can be shared across agents.
+ *
+ * Usage:
+ *   provider: 'grok'
+ *   model: 'grok-4' (or any current Grok model name)
+ */
+export class GrokAdapter extends OpenAIAdapter {
+    name = 'grok';
+    constructor(apiKey, baseURL) {
+        // Allow override of baseURL (for proxies or future changes) but default to official xAI endpoint.
+        super(apiKey ?? process.env['XAI_API_KEY'], baseURL ?? 'https://api.x.ai/v1');
+    }
+}
+//# sourceMappingURL=grok.js.map

package/dist/llm/grok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok.js","sourceRoot":"","sources":["../../src/llm/grok.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAY,SAAQ,aAAa;IACnC,IAAI,GAAG,MAAM,CAAA;IAEtB,YAAY,MAAe,EAAE,OAAgB;QAC3C,kGAAkG;QAClG,KAAK,CACH,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EACpC,OAAO,IAAI,qBAAqB,CACjC,CAAA;IACH,CAAC;CACF"}

package/dist/llm/minimax.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview MiniMax adapter.
+ *
+ * Thin wrapper around OpenAIAdapter that hard-codes the official MiniMax
+ * OpenAI-compatible endpoint and MINIMAX_API_KEY environment variable fallback.
+ */
+import { OpenAIAdapter } from './openai.js';
+/**
+ * LLM adapter for MiniMax models (MiniMax-M2.7 series and future models).
+ *
+ * Thread-safe. Can be shared across agents.
+ *
+ * Usage:
+ *   provider: 'minimax'
+ *   model: 'MiniMax-M2.7' (or any current MiniMax model name)
+ */
+export declare class MiniMaxAdapter extends OpenAIAdapter {
+    readonly name = "minimax";
+    constructor(apiKey?: string, baseURL?: string);
+}
+//# sourceMappingURL=minimax.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"minimax.d.ts","sourceRoot":"","sources":["../../src/llm/minimax.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,QAAQ,CAAC,IAAI,aAAY;gBAEb,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAO9C"}

package/dist/llm/minimax.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview MiniMax adapter.
+ *
+ * Thin wrapper around OpenAIAdapter that hard-codes the official MiniMax
+ * OpenAI-compatible endpoint and MINIMAX_API_KEY environment variable fallback.
+ */
+import { OpenAIAdapter } from './openai.js';
+/**
+ * LLM adapter for MiniMax models (MiniMax-M2.7 series and future models).
+ *
+ * Thread-safe. Can be shared across agents.
+ *
+ * Usage:
+ *   provider: 'minimax'
+ *   model: 'MiniMax-M2.7' (or any current MiniMax model name)
+ */
+export class MiniMaxAdapter extends OpenAIAdapter {
+    name = 'minimax';
+    constructor(apiKey, baseURL) {
+        // Allow override of baseURL (for proxies or future changes) but default to official MiniMax endpoint.
+        super(apiKey ?? process.env['MINIMAX_API_KEY'], baseURL ?? process.env['MINIMAX_BASE_URL'] ?? 'https://api.minimax.io/v1');
+    }
+}
+//# sourceMappingURL=minimax.js.map

package/dist/llm/minimax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimax.js","sourceRoot":"","sources":["../../src/llm/minimax.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IACtC,IAAI,GAAG,SAAS,CAAA;IAEzB,YAAY,MAAe,EAAE,OAAgB;QAC3C,sGAAsG;QACtG,KAAK,CACH,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EACxC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,2BAA2B,CAC1E,CAAA;IACH,CAAC;CACF"}