@amodalai/core 0.1.0

package/dist/src/providers/runtime/google-provider.js

@@ -0,0 +1,239 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { ProviderError, RateLimitError, ProviderTimeoutError } from './provider-errors.js';
+/**
+ * RuntimeProvider backed by the Google Gemini API via @google/genai SDK.
+ */
+export class GoogleRuntimeProvider {
+    apiKey;
+    constructor(config) {
+        const key = config.credentials?.['GOOGLE_API_KEY']
+            ?? process.env['GOOGLE_API_KEY'];
+        if (!key) {
+            throw new ProviderError('GOOGLE_API_KEY is not set', { provider: 'google' });
+        }
+        this.apiKey = key;
+    }
+    async chat(request) {
+        const { GoogleGenAI } = await import('@google/genai');
+        const client = new GoogleGenAI({ apiKey: this.apiKey });
+        const contents = convertMessages(request.messages);
+        const tools = convertTools(request.tools);
+        try {
+            const response = await client.models.generateContent({
+                model: request.model,
+                contents,
+                config: {
+                    systemInstruction: request.systemPrompt,
+                    maxOutputTokens: request.maxTokens ?? 4096,
+                    ...(tools.length > 0
+                        ? { tools: [{ functionDeclarations: tools }] }
+                        : {}),
+                    ...(request.signal ? { abortSignal: request.signal } : {}),
+                },
+            });
+            /* eslint-disable @typescript-eslint/no-unsafe-type-assertion -- SDK boundary: accessing Gemini response shape */
+            const candidate = response.candidates?.[0];
+            const usageMetadata = response.usageMetadata;
+            /* eslint-enable @typescript-eslint/no-unsafe-type-assertion */
+            if (!candidate) {
+                throw new ProviderError('Google returned no candidates', { provider: 'google' });
+            }
+            return {
+                content: convertResponseParts(candidate.content?.parts ?? []),
+                stopReason: mapFinishReason(candidate.finishReason),
+                usage: usageMetadata
+                    ? {
+                        inputTokens: usageMetadata.promptTokenCount ?? 0,
+                        outputTokens: usageMetadata.candidatesTokenCount ?? 0,
+                    }
+                    : undefined,
+            };
+        }
+        catch (err) {
+            throw classifyError(err);
+        }
+    }
+    async *chatStream(request) {
+        const { GoogleGenAI } = await import('@google/genai');
+        const client = new GoogleGenAI({ apiKey: this.apiKey });
+        const contents = convertMessages(request.messages);
+        const tools = convertTools(request.tools);
+        try {
+            const stream = await client.models.generateContentStream({
+                model: request.model,
+                contents,
+                config: {
+                    systemInstruction: request.systemPrompt,
+                    maxOutputTokens: request.maxTokens ?? 4096,
+                    ...(tools.length > 0
+                        ? { tools: [{ functionDeclarations: tools }] }
+                        : {}),
+                    ...(request.signal ? { abortSignal: request.signal } : {}),
+                },
+            });
+            /* eslint-disable @typescript-eslint/no-unsafe-type-assertion -- SDK boundary: stream chunks */
+            for await (const chunk of stream) {
+                const candidate = chunk.candidates?.[0];
+                if (!candidate?.content?.parts)
+                    continue;
+                for (const part of candidate.content.parts) {
+                    if (part.text !== undefined) {
+                        yield { type: 'text_delta', text: part.text };
+                    }
+                    else if (part.functionCall?.name) {
+                        const id = part.functionCall.id ?? `call_${part.functionCall.name}_${Date.now()}`;
+                        yield { type: 'tool_use_start', id, name: part.functionCall.name };
+                        const args = part.functionCall.args ?? {};
+                        const argsStr = JSON.stringify(args);
+                        yield { type: 'tool_use_delta', id, inputDelta: argsStr };
+                        yield { type: 'tool_use_end', id, input: args };
+                    }
+                }
+                if (candidate.finishReason) {
+                    yield {
+                        type: 'message_end',
+                        stopReason: mapFinishReason(candidate.finishReason),
+                        usage: chunk.usageMetadata
+                            ? {
+                                inputTokens: chunk.usageMetadata.promptTokenCount ?? 0,
+                                outputTokens: chunk.usageMetadata.candidatesTokenCount ?? 0,
+                            }
+                            : undefined,
+                    };
+                }
+            }
+            /* eslint-enable @typescript-eslint/no-unsafe-type-assertion */
+        }
+        catch (err) {
+            throw classifyError(err);
+        }
+    }
+}
+function convertMessages(messages) {
+    const result = [];
+    for (const msg of messages) {
+        switch (msg.role) {
+            case 'user':
+                result.push({ role: 'user', parts: [{ text: msg.content }] });
+                break;
+            case 'assistant':
+                result.push({
+                    role: 'model',
+                    parts: msg.content.map((block) => {
+                        if (block.type === 'text') {
+                            return { text: block.text };
+                        }
+                        return {
+                            functionCall: {
+                                name: block.name,
+                                args: block.input,
+                            },
+                        };
+                    }),
+                });
+                break;
+            case 'tool_result':
+                result.push({
+                    role: 'user',
+                    parts: [
+                        {
+                            functionResponse: {
+                                id: msg.toolCallId,
+                                name: msg.toolCallId,
+                                response: safeParseJson(msg.content),
+                            },
+                        },
+                    ],
+                });
+                break;
+            default:
+                break;
+        }
+    }
+    return result;
+}
+function safeParseJson(content) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- parsing tool result content
+        const parsed = JSON.parse(content);
+        if (typeof parsed === 'object' && parsed !== null) {
+            return parsed;
+        }
+        return { result: content };
+    }
+    catch {
+        return { result: content };
+    }
+}
+function convertTools(tools) {
+    return tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        parameters: t.parameters,
+    }));
+}
+function convertResponseParts(parts) {
+    const result = [];
+    for (const part of parts) {
+        if (part.text !== undefined) {
+            result.push({ type: 'text', text: part.text });
+        }
+        else if (part.functionCall?.name) {
+            result.push({
+                type: 'tool_use',
+                id: part.functionCall.id ?? `call_${part.functionCall.name}_${Date.now()}`,
+                name: part.functionCall.name,
+                input: part.functionCall.args ?? {},
+            });
+        }
+    }
+    return result;
+}
+function mapFinishReason(reason) {
+    switch (reason) {
+        case 'STOP':
+            return 'end_turn';
+        case 'MAX_TOKENS':
+            return 'max_tokens';
+        case 'MALFORMED_FUNCTION_CALL':
+        case 'UNEXPECTED_TOOL_CALL':
+            return 'tool_use';
+        default:
+            // If there are function calls in the response, Gemini uses STOP
+            // We check for tool_use at the content level instead
+            return 'end_turn';
+    }
+}
+function classifyError(err) {
+    if (err instanceof ProviderError) {
+        return err;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- classifying unknown SDK errors
+    const errObj = err;
+    const status = errObj.status ?? errObj.code;
+    const message = errObj.message ?? String(err);
+    if (status === 429) {
+        return new RateLimitError(`Google rate limited: ${message}`, {
+            provider: 'google',
+            cause: err,
+        });
+    }
+    if (message.includes('timeout') || message.includes('ETIMEDOUT')) {
+        return new ProviderTimeoutError(`Google timeout: ${message}`, {
+            provider: 'google',
+            cause: err,
+        });
+    }
+    const retryable = typeof status === 'number' && status >= 500;
+    return new ProviderError(`Google error: ${message}`, {
+        provider: 'google',
+        statusCode: typeof status === 'number' ? status : undefined,
+        retryable,
+        cause: err,
+    });
+}
+//# sourceMappingURL=google-provider.js.map

package/dist/src/providers/runtime/google-provider.js.map

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

package/dist/src/providers/runtime/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './runtime-provider-types.js';
+export * from './streaming-types.js';
+export * from './provider-errors.js';
+export { AnthropicRuntimeProvider } from './anthropic-provider.js';
+export { OpenAIRuntimeProvider } from './openai-provider.js';
+export { GoogleRuntimeProvider } from './google-provider.js';
+export { BedrockRuntimeProvider } from './bedrock-provider.js';
+export { AzureOpenAIRuntimeProvider } from './azure-provider.js';
+export { createRuntimeProvider } from './provider-factory.js';
+export { FailoverProvider } from './failover-provider.js';
+export type { FailoverOptions } from './failover-provider.js';

package/dist/src/providers/runtime/index.js

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './runtime-provider-types.js';
+export * from './streaming-types.js';
+export * from './provider-errors.js';
+export { AnthropicRuntimeProvider } from './anthropic-provider.js';
+export { OpenAIRuntimeProvider } from './openai-provider.js';
+export { GoogleRuntimeProvider } from './google-provider.js';
+export { BedrockRuntimeProvider } from './bedrock-provider.js';
+export { AzureOpenAIRuntimeProvider } from './azure-provider.js';
+export { createRuntimeProvider } from './provider-factory.js';
+export { FailoverProvider } from './failover-provider.js';
+//# sourceMappingURL=index.js.map

package/dist/src/providers/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAC,wBAAwB,EAAC,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAC,sBAAsB,EAAC,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC"}

package/dist/src/providers/runtime/openai-provider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { ModelConfig } from '../../repo/config-schema.js';
+import type { RuntimeProvider, LLMChatRequest, LLMChatResponse } from './runtime-provider-types.js';
+import type { LLMStreamEvent } from './streaming-types.js';
+/**
+ * RuntimeProvider backed by the OpenAI Chat Completions API.
+ *
+ * Also serves as the provider for OpenAI-compatible endpoints (vLLM, Ollama,
+ * Together, Groq, etc.) via `config.baseUrl`.
+ */
+export declare class OpenAIRuntimeProvider implements RuntimeProvider {
+    private readonly apiKey;
+    private readonly baseUrl?;
+    constructor(config: ModelConfig);
+    chat(request: LLMChatRequest): Promise<LLMChatResponse>;
+    chatStream(request: LLMChatRequest): AsyncGenerator<LLMStreamEvent>;
+}

package/dist/src/providers/runtime/openai-provider.js

@@ -0,0 +1,266 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { ProviderError, RateLimitError, ProviderTimeoutError } from './provider-errors.js';
+/**
+ * RuntimeProvider backed by the OpenAI Chat Completions API.
+ *
+ * Also serves as the provider for OpenAI-compatible endpoints (vLLM, Ollama,
+ * Together, Groq, etc.) via `config.baseUrl`.
+ */
+export class OpenAIRuntimeProvider {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        const key = config.credentials?.['OPENAI_API_KEY']
+            ?? process.env['OPENAI_API_KEY']
+            ?? '';
+        // OpenAI-compatible endpoints may not require a key
+        if (!key && !config.baseUrl) {
+            throw new ProviderError('OPENAI_API_KEY is not set', { provider: 'openai' });
+        }
+        this.apiKey = key;
+        this.baseUrl = config.baseUrl;
+    }
+    async chat(request) {
+        const { default: OpenAI } = await import('openai');
+        const client = new OpenAI({
+            apiKey: this.apiKey || 'not-needed',
+            ...(this.baseUrl ? { baseURL: this.baseUrl } : {}),
+        });
+        const messages = convertMessages(request.systemPrompt, request.messages);
+        const tools = convertTools(request.tools);
+        try {
+            /* eslint-disable @typescript-eslint/no-unsafe-type-assertion -- SDK boundary: our message/tool types map to OpenAI SDK types */
+            const response = await client.chat.completions.create({
+                model: request.model,
+                max_tokens: request.maxTokens ?? 4096,
+                messages: messages,
+                ...(tools.length > 0
+                    ? { tools: tools }
+                    : {}),
+                stream: false,
+            });
+            const completion = response;
+            /* eslint-enable @typescript-eslint/no-unsafe-type-assertion */
+            const choice = completion.choices[0];
+            if (!choice) {
+                throw new ProviderError('OpenAI returned no choices', { provider: 'openai' });
+            }
+            return {
+                content: convertResponseContent(choice.message),
+                stopReason: mapFinishReason(choice.finish_reason),
+                usage: completion.usage
+                    ? {
+                        inputTokens: completion.usage.prompt_tokens,
+                        outputTokens: completion.usage.completion_tokens ?? 0,
+                    }
+                    : undefined,
+            };
+        }
+        catch (err) {
+            throw classifyError(err);
+        }
+    }
+    async *chatStream(request) {
+        const { default: OpenAI } = await import('openai');
+        const client = new OpenAI({
+            apiKey: this.apiKey || 'not-needed',
+            ...(this.baseUrl ? { baseURL: this.baseUrl } : {}),
+        });
+        const messages = convertMessages(request.systemPrompt, request.messages);
+        const tools = convertTools(request.tools);
+        try {
+            /* eslint-disable @typescript-eslint/no-unsafe-type-assertion -- SDK boundary: stream chunks */
+            const stream = await client.chat.completions.create({
+                model: request.model,
+                max_tokens: request.maxTokens ?? 4096,
+                messages: messages,
+                ...(tools.length > 0
+                    ? { tools: tools }
+                    : {}),
+                stream: true,
+            });
+            const toolInputBuffers = new Map();
+            for await (const chunk of stream) {
+                const delta = chunk.choices?.[0]?.delta;
+                const finishReason = chunk.choices?.[0]?.finish_reason;
+                if (delta?.content) {
+                    yield { type: 'text_delta', text: delta.content };
+                }
+                if (delta?.tool_calls) {
+                    for (const tc of delta.tool_calls) {
+                        const id = tc.id;
+                        if (id && tc.function?.name) {
+                            toolInputBuffers.set(id, '');
+                            yield { type: 'tool_use_start', id, name: tc.function.name };
+                        }
+                        if (tc.function?.arguments) {
+                            // Find the tool call id — may be in tc.id or from prior chunk
+                            const callId = tc.id ?? findToolIdByIndex(toolInputBuffers, tc.index);
+                            if (callId) {
+                                const prev = toolInputBuffers.get(callId) ?? '';
+                                toolInputBuffers.set(callId, prev + tc.function.arguments);
+                                yield { type: 'tool_use_delta', id: callId, inputDelta: tc.function.arguments };
+                            }
+                        }
+                    }
+                }
+                if (finishReason) {
+                    // End all open tool calls
+                    for (const [id, jsonStr] of toolInputBuffers) {
+                        let input = {};
+                        try {
+                            input = JSON.parse(jsonStr || '{}');
+                        }
+                        catch {
+                            // Malformed — pass empty
+                        }
+                        yield { type: 'tool_use_end', id, input };
+                    }
+                    toolInputBuffers.clear();
+                    yield {
+                        type: 'message_end',
+                        stopReason: mapFinishReason(finishReason),
+                        usage: chunk.usage
+                            ? {
+                                inputTokens: chunk.usage.prompt_tokens ?? 0,
+                                outputTokens: chunk.usage.completion_tokens ?? 0,
+                            }
+                            : undefined,
+                    };
+                }
+            }
+            /* eslint-enable @typescript-eslint/no-unsafe-type-assertion */
+        }
+        catch (err) {
+            throw classifyError(err);
+        }
+    }
+}
+function findToolIdByIndex(buffers, index) {
+    if (index === undefined)
+        return undefined;
+    let i = 0;
+    for (const id of buffers.keys()) {
+        if (i === index)
+            return id;
+        i++;
+    }
+    return undefined;
+}
+function convertMessages(systemPrompt, messages) {
+    const result = [{ role: 'system', content: systemPrompt }];
+    for (const msg of messages) {
+        switch (msg.role) {
+            case 'user':
+                result.push({ role: 'user', content: msg.content });
+                break;
+            case 'assistant': {
+                const textParts = msg.content.filter((b) => b.type === 'text');
+                const toolParts = msg.content.filter((b) => b.type === 'tool_use');
+                const content = textParts.map((b) => b.text).join('') || null;
+                const toolCalls = toolParts.length > 0
+                    ? toolParts.map((b) => ({
+                        id: b.id,
+                        type: 'function',
+                        function: {
+                            name: b.name,
+                            arguments: JSON.stringify(b.input),
+                        },
+                    }))
+                    : undefined;
+                result.push({ role: 'assistant', content, tool_calls: toolCalls });
+                break;
+            }
+            case 'tool_result':
+                result.push({
+                    role: 'tool',
+                    tool_call_id: msg.toolCallId,
+                    content: msg.content,
+                });
+                break;
+            default:
+                break;
+        }
+    }
+    return result;
+}
+function convertTools(tools) {
+    return tools.map((t) => ({
+        type: 'function',
+        function: {
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+        },
+    }));
+}
+function convertResponseContent(message) {
+    const blocks = [];
+    if (message.content) {
+        blocks.push({ type: 'text', text: message.content });
+    }
+    if (message.tool_calls) {
+        for (const tc of message.tool_calls) {
+            let input = {};
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- SDK boundary: parsing JSON args
+                input = JSON.parse(tc.function.arguments);
+            }
+            catch {
+                // Malformed JSON — pass empty input
+            }
+            blocks.push({
+                type: 'tool_use',
+                id: tc.id,
+                name: tc.function.name,
+                input,
+            });
+        }
+    }
+    return blocks;
+}
+function mapFinishReason(reason) {
+    switch (reason) {
+        case 'stop':
+            return 'end_turn';
+        case 'tool_calls':
+            return 'tool_use';
+        case 'length':
+            return 'max_tokens';
+        default:
+            return 'end_turn';
+    }
+}
+function classifyError(err) {
+    if (err instanceof ProviderError) {
+        return err;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- classifying unknown SDK errors
+    const errObj = err;
+    const status = errObj.status;
+    const message = errObj.message ?? String(err);
+    if (status === 429) {
+        return new RateLimitError(`OpenAI rate limited: ${message}`, {
+            provider: 'openai',
+            cause: err,
+        });
+    }
+    if (message.includes('timeout') || message.includes('ETIMEDOUT')) {
+        return new ProviderTimeoutError(`OpenAI timeout: ${message}`, {
+            provider: 'openai',
+            cause: err,
+        });
+    }
+    const retryable = typeof status === 'number' && status >= 500;
+    return new ProviderError(`OpenAI error: ${message}`, {
+        provider: 'openai',
+        statusCode: status,
+        retryable,
+        cause: err,
+    });
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/src/providers/runtime/openai-provider.js.map

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

package/dist/src/providers/runtime/provider-errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Base error for provider failures.
+ */
+export declare class ProviderError extends Error {
+    readonly provider: string;
+    readonly statusCode?: number;
+    readonly retryable: boolean;
+    constructor(message: string, options: {
+        provider: string;
+        statusCode?: number;
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown on 429 rate limit responses.
+ */
+export declare class RateLimitError extends ProviderError {
+    readonly retryAfterMs?: number;
+    constructor(message: string, options: {
+        provider: string;
+        retryAfterMs?: number;
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a request times out.
+ */
+export declare class ProviderTimeoutError extends ProviderError {
+    constructor(message: string, options: {
+        provider: string;
+        cause?: unknown;
+    });
+}