ai.matey.backend 0.2.0

package/dist/esm/providers/deepinfra.js

@@ -0,0 +1,339 @@
+/**
+ * DeepInfra Backend Adapter
+ *
+ * Adapts Universal IR to DeepInfra Chat Completions API.
+ * DeepInfra is OpenAI-compatible with detailed cost estimation.
+ *
+ * @module
+ */
+import { NetworkError, ProviderError, StreamError, ErrorCode, createErrorFromHttpResponse, } from 'ai.matey.errors';
+import { normalizeSystemMessages } from 'ai.matey.utils';
+import { getEffectiveStreamMode, mergeStreamingConfig } from 'ai.matey.utils';
+// ============================================================================
+// DeepInfra Backend Adapter
+// ============================================================================
+/**
+ * Backend adapter for DeepInfra Chat Completions API.
+ *
+ * Features:
+ * - OpenAI-compatible API
+ * - Detailed cost estimation
+ * - Vision model support
+ * - Function calling support
+ * - Competitive pricing starting at $0.40 per 1M tokens
+ */
+export class DeepInfraBackendAdapter {
+    metadata;
+    config;
+    baseURL;
+    constructor(config) {
+        this.config = config;
+        this.baseURL = config.baseURL || 'https://api.deepinfra.com/v1/openai';
+        this.metadata = {
+            name: 'deepinfra-backend',
+            version: '1.0.0',
+            provider: 'DeepInfra',
+            capabilities: {
+                streaming: true,
+                multiModal: true, // Vision models available
+                tools: true, // Function calling
+                maxContextTokens: 128000,
+                systemMessageStrategy: 'in-messages',
+                supportsMultipleSystemMessages: true,
+                supportsTemperature: true,
+                supportsTopP: true,
+                supportsTopK: false,
+                supportsSeed: false,
+                supportsFrequencyPenalty: true,
+                supportsPresencePenalty: true,
+                maxStopSequences: 4,
+            },
+            config: {
+                baseURL: this.baseURL,
+            },
+        };
+    }
+    /**
+     * Convert IR to DeepInfra format.
+     */
+    fromIR(request) {
+        const { messages } = normalizeSystemMessages(request.messages, this.metadata.capabilities.systemMessageStrategy, this.metadata.capabilities.supportsMultipleSystemMessages);
+        const deepinfraMessages = messages.map((msg) => ({
+            role: msg.role,
+            content: typeof msg.content === 'string'
+                ? msg.content
+                : msg.content.map((block) => {
+                    if (block.type === 'text') {
+                        return { type: 'text', text: block.text };
+                    }
+                    else if (block.type === 'image') {
+                        return {
+                            type: 'image_url',
+                            image_url: {
+                                url: block.source.type === 'url'
+                                    ? block.source.url
+                                    : `data:${block.source.mediaType};base64,${block.source.data}`,
+                            },
+                        };
+                    }
+                    return { type: 'text', text: JSON.stringify(block) };
+                }),
+        }));
+        return {
+            model: request.parameters?.model ||
+                this.config.defaultModel ||
+                'meta-llama/Meta-Llama-3.1-8B-Instruct',
+            messages: deepinfraMessages,
+            temperature: request.parameters?.temperature,
+            max_tokens: request.parameters?.maxTokens,
+            top_p: request.parameters?.topP,
+            frequency_penalty: request.parameters?.frequencyPenalty,
+            presence_penalty: request.parameters?.presencePenalty,
+            stop: request.parameters?.stopSequences ? [...request.parameters.stopSequences] : undefined,
+            stream: request.stream || false,
+        };
+    }
+    /**
+     * Convert DeepInfra response to IR.
+     */
+    toIR(response, originalRequest, latencyMs) {
+        const choice = response.choices[0];
+        if (!choice) {
+            throw new ProviderError({
+                code: ErrorCode.PROVIDER_ERROR,
+                message: 'No choices returned in response',
+                isRetryable: false,
+                provenance: { backend: this.metadata.name },
+            });
+        }
+        const message = {
+            role: choice.message.role === 'assistant' ? 'assistant' : 'user',
+            content: typeof choice.message.content === 'string'
+                ? choice.message.content
+                : choice.message.content.map((c) => (c.type === 'text' ? c.text : '')).join(''),
+        };
+        const finishReasonMap = {
+            stop: 'stop',
+            length: 'length',
+            tool_calls: 'tool_calls',
+        };
+        return {
+            message,
+            finishReason: finishReasonMap[choice.finish_reason || 'stop'] || 'stop',
+            usage: response.usage
+                ? {
+                    promptTokens: response.usage.prompt_tokens,
+                    completionTokens: response.usage.completion_tokens,
+                    totalTokens: response.usage.total_tokens,
+                }
+                : undefined,
+            metadata: {
+                ...originalRequest.metadata,
+                providerResponseId: response.id,
+                provenance: {
+                    ...originalRequest.metadata.provenance,
+                    backend: this.metadata.name,
+                },
+                custom: {
+                    ...originalRequest.metadata.custom,
+                    latencyMs,
+                },
+            },
+            raw: response,
+        };
+    }
+    /**
+     * Execute non-streaming request.
+     */
+    async execute(request, signal) {
+        try {
+            const deepinfraRequest = this.fromIR(request);
+            deepinfraRequest.stream = false;
+            const startTime = Date.now();
+            const response = await fetch(`${this.baseURL}/chat/completions`, {
+                method: 'POST',
+                headers: this.getHeaders(),
+                body: JSON.stringify(deepinfraRequest),
+                signal,
+            });
+            if (!response.ok) {
+                throw createErrorFromHttpResponse(response.status, response.statusText, await response.text(), { backend: this.metadata.name });
+            }
+            const data = (await response.json());
+            return this.toIR(data, request, Date.now() - startTime);
+        }
+        catch (error) {
+            if (error instanceof NetworkError || error instanceof ProviderError) {
+                throw error;
+            }
+            throw new ProviderError({
+                code: ErrorCode.PROVIDER_ERROR,
+                message: `DeepInfra request failed: ${error instanceof Error ? error.message : String(error)}`,
+                isRetryable: true,
+                provenance: { backend: this.metadata.name },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Execute streaming request.
+     */
+    async *executeStream(request, signal) {
+        try {
+            const deepinfraRequest = this.fromIR(request);
+            deepinfraRequest.stream = true;
+            const streamingConfig = mergeStreamingConfig(this.config.streaming);
+            const effectiveMode = getEffectiveStreamMode(request.streamMode, undefined, streamingConfig);
+            const includeBoth = streamingConfig.includeBoth || effectiveMode === 'accumulated';
+            const response = await fetch(`${this.baseURL}/chat/completions`, {
+                method: 'POST',
+                headers: this.getHeaders(),
+                body: JSON.stringify(deepinfraRequest),
+                signal,
+            });
+            if (!response.ok) {
+                throw createErrorFromHttpResponse(response.status, response.statusText, await response.text(), { backend: this.metadata.name });
+            }
+            if (!response.body) {
+                throw new StreamError({
+                    code: ErrorCode.STREAM_ERROR,
+                    message: 'No response body',
+                    provenance: { backend: this.metadata.name },
+                });
+            }
+            let sequence = 0;
+            let contentBuffer = '';
+            yield {
+                type: 'start',
+                sequence: sequence++,
+                metadata: {
+                    ...request.metadata,
+                    provenance: {
+                        ...request.metadata.provenance,
+                        backend: this.metadata.name,
+                    },
+                },
+            };
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) {
+                        break;
+                    }
+                    buffer += decoder.decode(value, { stream: true });
+                    const lines = buffer.split('\n');
+                    buffer = lines.pop() || '';
+                    for (const line of lines) {
+                        if (!line.trim() || !line.startsWith('data: ')) {
+                            continue;
+                        }
+                        const data = line.slice(6).trim();
+                        if (data === '[DONE]') {
+                            continue;
+                        }
+                        try {
+                            const chunk = JSON.parse(data);
+                            const delta = chunk.choices[0]?.delta?.content;
+                            if (delta) {
+                                contentBuffer += delta;
+                                const contentChunk = {
+                                    type: 'content',
+                                    sequence: sequence++,
+                                    delta: delta,
+                                    role: 'assistant',
+                                };
+                                if (includeBoth) {
+                                    contentChunk.accumulated = contentBuffer;
+                                }
+                                yield contentChunk;
+                            }
+                            if (chunk.choices[0]?.finish_reason) {
+                                const finishReasonMap = {
+                                    stop: 'stop',
+                                    length: 'length',
+                                };
+                                yield {
+                                    type: 'done',
+                                    sequence: sequence++,
+                                    finishReason: finishReasonMap[chunk.choices[0].finish_reason] || 'stop',
+                                    message: { role: 'assistant', content: contentBuffer },
+                                };
+                            }
+                        }
+                        catch (parseError) {
+                            console.warn('Failed to parse SSE chunk:', data, parseError);
+                        }
+                    }
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+        }
+        catch (error) {
+            yield {
+                type: 'error',
+                sequence: 0,
+                error: {
+                    code: error instanceof Error ? error.name : 'UNKNOWN_ERROR',
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            };
+        }
+    }
+    /**
+     * Get HTTP headers.
+     */
+    getHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.config.apiKey}`,
+        };
+        return { ...headers, ...this.config.headers };
+    }
+    /**
+     * Health check.
+     */
+    async healthCheck() {
+        try {
+            const response = await fetch(`${this.baseURL}/models`, {
+                method: 'GET',
+                headers: this.getHeaders(),
+                signal: AbortSignal.timeout(5000),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Estimate cost with detailed pricing.
+     */
+    estimateCost(request) {
+        const pricing = {
+            'meta-llama/Meta-Llama-3.1-8B-Instruct': { input: 0.4, output: 0.4 },
+            'meta-llama/Meta-Llama-3.1-70B-Instruct': { input: 0.6, output: 0.6 },
+            'Qwen/Qwen2.5-72B-Instruct': { input: 0.6, output: 0.6 },
+            'deepseek-ai/DeepSeek-V3': { input: 0.6, output: 2.0 },
+            'mistralai/Mixtral-8x7B-Instruct-v0.1': { input: 0.24, output: 0.24 },
+        };
+        const model = request.parameters?.model || this.config.defaultModel || '';
+        const modelPricing = pricing[model];
+        if (!modelPricing) {
+            return Promise.resolve(null);
+        }
+        const inputTokens = request.messages.reduce((sum, msg) => {
+            const content = typeof msg.content === 'string' ? msg.content : '';
+            return sum + Math.ceil(content.length / 4);
+        }, 0);
+        const outputTokens = request.parameters?.maxTokens || 1024;
+        const inputCost = (inputTokens / 1_000_000) * modelPricing.input;
+        const outputCost = (outputTokens / 1_000_000) * modelPricing.output;
+        return Promise.resolve(inputCost + outputCost);
+    }
+}
+//# sourceMappingURL=deepinfra.js.map

package/dist/esm/providers/deepinfra.js.map

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

package/dist/esm/providers/deepseek.js

@@ -0,0 +1,99 @@
+/**
+ * DeepSeek Backend Adapter
+ *
+ * Adapts Universal IR to DeepSeek API (OpenAI-compatible).
+ * DeepSeek provides cost-effective models with strong reasoning capabilities.
+ *
+ * @module
+ */
+import { OpenAIBackendAdapter } from './openai.js';
+/**
+ * Backend adapter for DeepSeek API.
+ *
+ * DeepSeek uses an OpenAI-compatible API, so we extend the OpenAI adapter
+ * with DeepSeek-specific configuration.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { DeepSeekBackendAdapter } from 'ai.matey';
+ *
+ * const adapter = new DeepSeekBackendAdapter({
+ *   apiKey: process.env.DEEPSEEK_API_KEY,
+ * });
+ * ```
+ *
+ * @example With Custom Model
+ * ```typescript
+ * const adapter = new DeepSeekBackendAdapter({
+ *   apiKey: process.env.DEEPSEEK_API_KEY,
+ * });
+ *
+ * const response = await adapter.execute({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: { model: 'deepseek-chat' },
+ * });
+ * ```
+ *
+ * @example With Bridge
+ * ```typescript
+ * import { createBridge } from 'ai.matey';
+ *
+ * const bridge = createBridge({
+ *   backend: new DeepSeekBackendAdapter({
+ *     apiKey: process.env.DEEPSEEK_API_KEY,
+ *   }),
+ * });
+ * ```
+ */
+export class DeepSeekBackendAdapter extends OpenAIBackendAdapter {
+    constructor(config) {
+        // DeepSeek API endpoint
+        const deepseekConfig = {
+            ...config,
+            baseURL: config.baseURL ?? 'https://api.deepseek.com/v1',
+        };
+        // Pass DeepSeek-specific metadata to parent constructor
+        super(deepseekConfig, {
+            name: 'deepseek-backend',
+            version: '1.0.0',
+            provider: 'DeepSeek',
+            capabilities: {
+                streaming: true,
+                multiModal: false, // DeepSeek currently doesn't support vision
+                tools: true,
+                maxContextTokens: 64000, // DeepSeek V2.5 supports 64K context
+                systemMessageStrategy: 'in-messages',
+                supportsMultipleSystemMessages: false,
+                supportsTemperature: true,
+                supportsTopP: true,
+                supportsTopK: false,
+                supportsSeed: false,
+                supportsFrequencyPenalty: true,
+                supportsPresencePenalty: true,
+                maxStopSequences: 4,
+            },
+            config: {
+                baseURL: deepseekConfig.baseURL,
+            },
+        });
+    }
+}
+/**
+ * Create a DeepSeek backend adapter.
+ *
+ * @param config - Adapter configuration
+ * @returns DeepSeek backend adapter
+ *
+ * @example
+ * ```typescript
+ * import { createDeepSeekAdapter } from 'ai.matey';
+ *
+ * const adapter = createDeepSeekAdapter({
+ *   apiKey: process.env.DEEPSEEK_API_KEY,
+ * });
+ * ```
+ */
+export function createDeepSeekAdapter(config) {
+    return new DeepSeekBackendAdapter(config);
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/esm/providers/deepseek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAA2C,MAAM,aAAa,CAAC;AAG5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,OAAO,sBACX,SAAQ,oBAAoB;IAG5B,YAAY,MAA4B;QACtC,wBAAwB;QACxB,MAAM,cAAc,GAAyB;YAC3C,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,6BAA6B;SACzD,CAAC;QAEF,wDAAwD;QACxD,KAAK,CAAC,cAAc,EAAE;YACpB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE,UAAU;YACpB,YAAY,EAAE;gBACZ,SAAS,EAAE,IAAI;gBACf,UAAU,EAAE,KAAK,EAAE,4CAA4C;gBAC/D,KAAK,EAAE,IAAI;gBACX,gBAAgB,EAAE,KAAK,EAAE,qCAAqC;gBAC9D,qBAAqB,EAAE,aAAa;gBACpC,8BAA8B,EAAE,KAAK;gBACrC,mBAAmB,EAAE,IAAI;gBACzB,YAAY,EAAE,IAAI;gBAClB,YAAY,EAAE,KAAK;gBACnB,YAAY,EAAE,KAAK;gBACnB,wBAAwB,EAAE,IAAI;gBAC9B,uBAAuB,EAAE,IAAI;gBAC7B,gBAAgB,EAAE,CAAC;aACpB;YACD,MAAM,EAAE;gBACN,OAAO,EAAE,cAAc,CAAC,OAAO;aAChC;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA4B;IAChE,OAAO,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC"}