ai.matey.backend 0.2.0

package/dist/types/providers/deepseek.d.ts

@@ -0,0 +1,68 @@
+/**
+ * DeepSeek Backend Adapter
+ *
+ * Adapts Universal IR to DeepSeek API (OpenAI-compatible).
+ * DeepSeek provides cost-effective models with strong reasoning capabilities.
+ *
+ * @module
+ */
+import { OpenAIBackendAdapter, type OpenAIRequest, type OpenAIResponse } from './openai.js';
+import type { BackendAdapter, BackendAdapterConfig } from 'ai.matey.types';
+/**
+ * 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 declare class DeepSeekBackendAdapter extends OpenAIBackendAdapter implements BackendAdapter<OpenAIRequest, OpenAIResponse> {
+    constructor(config: BackendAdapterConfig);
+}
+/**
+ * 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 declare function createDeepSeekAdapter(config: BackendAdapterConfig): DeepSeekBackendAdapter;
+//# sourceMappingURL=deepseek.d.ts.map

package/dist/types/providers/deepseek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,sBACX,SAAQ,oBACR,YAAW,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC;gBAE5C,MAAM,EAAE,oBAAoB;CAgCzC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAE1F"}

package/dist/types/providers/fireworks.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Fireworks AI Backend Adapter
+ *
+ * Adapts Universal IR to Fireworks AI Chat Completions API.
+ * Fireworks AI is OpenAI-compatible with 100+ models and fastest APIs.
+ *
+ * @module
+ */
+import type { BackendAdapter, BackendAdapterConfig, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+export type FireworksAIMessageContent = string | Array<{
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+    };
+}>;
+export interface FireworksAIMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: FireworksAIMessageContent;
+    name?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+export interface FireworksAIRequest {
+    model: string;
+    messages: FireworksAIMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    top_k?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    stop?: string[];
+    stream?: boolean;
+    reasoning_effort?: 'low' | 'medium' | 'high';
+}
+export interface FireworksAIResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: FireworksAIMessage;
+        finish_reason: 'stop' | 'length' | 'tool_calls' | null;
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface FireworksAIStreamChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: {
+            role?: 'assistant';
+            content?: string;
+        };
+        finish_reason: 'stop' | 'length' | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * Backend adapter for Fireworks AI Chat Completions API.
+ *
+ * Features:
+ * - 100+ open-source models
+ * - Fastest inference APIs
+ * - OpenAI-compatible with topK support
+ * - Vision model support
+ * - Function calling support
+ * - Reasoning models with reasoning_effort parameter
+ * - Pricing from $0.10 per 1M tokens
+ */
+export declare class FireworksAIBackendAdapter implements BackendAdapter<FireworksAIRequest, FireworksAIResponse> {
+    readonly metadata: AdapterMetadata;
+    private readonly config;
+    private readonly baseURL;
+    constructor(config: BackendAdapterConfig);
+    /**
+     * Convert IR to Fireworks AI format.
+     */
+    fromIR(request: IRChatRequest): FireworksAIRequest;
+    /**
+     * Convert Fireworks AI response to IR.
+     */
+    toIR(response: FireworksAIResponse, originalRequest: IRChatRequest, latencyMs: number): IRChatResponse;
+    /**
+     * Execute non-streaming request.
+     */
+    execute(request: IRChatRequest, signal?: AbortSignal): Promise<IRChatResponse>;
+    /**
+     * Execute streaming request.
+     */
+    executeStream(request: IRChatRequest, signal?: AbortSignal): IRChatStream;
+    /**
+     * Get HTTP headers.
+     */
+    private getHeaders;
+    /**
+     * Health check.
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Estimate cost.
+     */
+    estimateCost(request: IRChatRequest): Promise<number | null>;
+}
+//# sourceMappingURL=fireworks.d.ts.map

package/dist/types/providers/fireworks.d.ts.map

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

package/dist/types/providers/gemini.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Google Gemini Backend Adapter
+ *
+ * Adapts Universal IR to Google Gemini API.
+ * Handles Gemini's systemInstruction field and content array format.
+ *
+ * @module
+ */
+import type { BackendAdapter, BackendAdapterConfig, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+export interface GeminiContent {
+    role: 'user' | 'model';
+    parts: Array<{
+        text: string;
+    } | {
+        inlineData: {
+            mimeType: string;
+            data: string;
+        };
+    }>;
+}
+export interface GeminiRequest {
+    contents: GeminiContent[];
+    systemInstruction?: {
+        parts: Array<{
+            text: string;
+        }>;
+    };
+    generationConfig?: {
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        maxOutputTokens?: number;
+        stopSequences?: string[];
+    };
+}
+export interface GeminiResponse {
+    candidates: Array<{
+        content: GeminiContent;
+        finishReason: 'STOP' | 'MAX_TOKENS' | 'SAFETY' | 'RECITATION' | 'OTHER';
+    }>;
+    usageMetadata?: {
+        promptTokenCount: number;
+        candidatesTokenCount: number;
+        totalTokenCount: number;
+    };
+}
+export declare class GeminiBackendAdapter implements BackendAdapter<GeminiRequest, GeminiResponse> {
+    readonly metadata: AdapterMetadata;
+    private readonly config;
+    private readonly baseURL;
+    constructor(config: BackendAdapterConfig);
+    execute(request: IRChatRequest, signal?: AbortSignal): Promise<IRChatResponse>;
+    executeStream(request: IRChatRequest, signal?: AbortSignal): IRChatStream;
+    healthCheck(): Promise<boolean>;
+    estimateCost(_request: IRChatRequest): Promise<number | null>;
+    /**
+     * Convert IR request to Gemini format.
+     *
+     * Public method for testing and debugging - see what will be sent to Gemini.
+     */
+    fromIR(request: IRChatRequest): GeminiRequest;
+    /**
+     * Convert Gemini response to IR format.
+     *
+     * Public method for testing and debugging - parse Gemini responses manually.
+     */
+    toIR(response: GeminiResponse, originalRequest: IRChatRequest, latencyMs: number): IRChatResponse;
+    private mapFinishReason;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/types/providers/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EAIb,MAAM,gBAAgB,CAAC;AAgBxB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,UAAU,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACvD,gBAAgB,CAAC,EAAE;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,KAAK,CAAC;QAChB,OAAO,EAAE,aAAa,CAAC;QACvB,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;KACzE,CAAC,CAAC;IACH,aAAa,CAAC,EAAE;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAMD,qBAAa,oBAAqB,YAAW,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC;IACxF,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,oBAAoB;IA8BlC,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAqC7E,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY;IAgI1E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAYrC,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7D;;;;OAIG;IACI,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa;IAoCpD;;;;OAIG;IACI,IAAI,CACT,QAAQ,EAAE,cAAc,EACxB,eAAe,EAAE,aAAa,EAC9B,SAAS,EAAE,MAAM,GAChB,cAAc;IAiCjB,OAAO,CAAC,eAAe;CAYxB"}

package/dist/types/providers/groq.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Groq Backend Adapter
+ *
+ * Adapts Universal IR to Groq API (OpenAI-compatible).
+ * Groq provides ultra-fast inference with LPU (Language Processing Unit) technology.
+ *
+ * @module
+ */
+import { OpenAIBackendAdapter, type OpenAIRequest, type OpenAIResponse } from './openai.js';
+import type { BackendAdapter, BackendAdapterConfig, IRChatRequest } from 'ai.matey.types';
+/**
+ * Backend adapter for Groq API.
+ *
+ * Groq uses an OpenAI-compatible API with ultra-fast inference speeds.
+ * Known for extremely low latency responses.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { GroqBackendAdapter } from 'ai.matey';
+ *
+ * const adapter = new GroqBackendAdapter({
+ *   apiKey: process.env.GROQ_API_KEY,
+ * });
+ * ```
+ *
+ * @example With Fast Models
+ * ```typescript
+ * const adapter = new GroqBackendAdapter({
+ *   apiKey: process.env.GROQ_API_KEY,
+ * });
+ *
+ * const response = await adapter.execute({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: {
+ *     model: 'llama-3.3-70b-versatile', // Fast and capable
+ *   },
+ * });
+ * ```
+ *
+ * @example Streaming for Ultra-Fast Responses
+ * ```typescript
+ * const stream = adapter.executeStream({
+ *   messages: [{ role: 'user', content: 'Tell me a story' }],
+ *   parameters: {
+ *     model: 'llama-3.1-8b-instant', // Optimized for speed
+ *   },
+ * });
+ *
+ * for await (const chunk of stream) {
+ *   if (chunk.type === 'content') {
+ *     console.log(chunk.delta);
+ *   }
+ * }
+ * ```
+ */
+export declare class GroqBackendAdapter extends OpenAIBackendAdapter implements BackendAdapter<OpenAIRequest, OpenAIResponse> {
+    constructor(config: BackendAdapterConfig);
+    /**
+     * Health check for Groq API.
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Estimate cost for Groq (very low cost, optimized for speed).
+     */
+    estimateCost(request: IRChatRequest): Promise<number | null>;
+}
+/**
+ * Create a Groq backend adapter.
+ *
+ * @param config - Adapter configuration
+ * @returns Groq backend adapter
+ *
+ * @example
+ * ```typescript
+ * import { createGroqAdapter } from 'ai.matey';
+ *
+ * const adapter = createGroqAdapter({
+ *   apiKey: process.env.GROQ_API_KEY,
+ * });
+ * ```
+ */
+export declare function createGroqAdapter(config: BackendAdapterConfig): GroqBackendAdapter;
+//# sourceMappingURL=groq.d.ts.map

package/dist/types/providers/groq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groq.d.ts","sourceRoot":"","sources":["../../../src/providers/groq.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,kBACX,SAAQ,oBACR,YAAW,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC;gBAE5C,MAAM,EAAE,oBAAoB;IAiCxC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAWnE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,kBAAkB,CAElF"}

package/dist/types/providers/huggingface.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Hugging Face Backend Adapter
+ *
+ * Adapts Universal IR to Hugging Face Inference API.
+ * Access thousands of models through Hugging Face's unified API.
+ *
+ * @module
+ */
+import type { BackendAdapter, BackendAdapterConfig, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+/**
+ * Hugging Face API message format.
+ */
+export interface HuggingFaceMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Hugging Face API request.
+ */
+export interface HuggingFaceRequest {
+    inputs: string | {
+        past_user_inputs?: string[];
+        generated_responses?: string[];
+        text: string;
+    };
+    parameters?: {
+        temperature?: number;
+        max_new_tokens?: number;
+        top_p?: number;
+        top_k?: number;
+        repetition_penalty?: number;
+        do_sample?: boolean;
+        return_full_text?: boolean;
+    };
+    options?: {
+        wait_for_model?: boolean;
+        use_cache?: boolean;
+    };
+}
+/**
+ * Hugging Face API response.
+ */
+export interface HuggingFaceResponse {
+    generated_text?: string;
+    conversation?: {
+        past_user_inputs: string[];
+        generated_responses: string[];
+    };
+    error?: string;
+}
+/**
+ * Backend adapter for Hugging Face Inference API.
+ *
+ * Supports text generation models from Hugging Face Hub.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { HuggingFaceBackendAdapter } from 'ai.matey';
+ *
+ * const adapter = new HuggingFaceBackendAdapter({
+ *   apiKey: process.env.HUGGINGFACE_API_KEY,
+ * });
+ * ```
+ *
+ * @example With Specific Model
+ * ```typescript
+ * const adapter = new HuggingFaceBackendAdapter({
+ *   apiKey: process.env.HUGGINGFACE_API_KEY,
+ * });
+ *
+ * const response = await adapter.execute({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: {
+ *     model: 'mistralai/Mixtral-8x7B-Instruct-v0.1',
+ *   },
+ * });
+ * ```
+ *
+ * @example With Inference Endpoints
+ * ```typescript
+ * const adapter = new HuggingFaceBackendAdapter({
+ *   apiKey: process.env.HUGGINGFACE_API_KEY,
+ *   baseURL: 'https://your-endpoint.aws.endpoints.huggingface.cloud',
+ * });
+ * ```
+ */
+export declare class HuggingFaceBackendAdapter implements BackendAdapter<HuggingFaceRequest, HuggingFaceResponse> {
+    readonly metadata: AdapterMetadata;
+    private readonly config;
+    private readonly baseURL;
+    constructor(config: BackendAdapterConfig);
+    /**
+     * Execute non-streaming chat completion request.
+     */
+    execute(request: IRChatRequest, signal?: AbortSignal): Promise<IRChatResponse>;
+    /**
+     * Execute streaming chat completion request.
+     */
+    executeStream(request: IRChatRequest, _signal?: AbortSignal): IRChatStream;
+    /**
+     * Health check for Hugging Face API.
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Estimate cost for Hugging Face.
+     */
+    estimateCost(request: IRChatRequest): Promise<number | null>;
+    /**
+     * Convert IR request to Hugging Face format.
+     *
+     * Public method for testing and debugging - see what will be sent to Hugging Face.
+     */
+    fromIR(request: IRChatRequest): HuggingFaceRequest;
+    /**
+     * Convert Hugging Face response to IR format.
+     *
+     * Public method for testing and debugging - parse Hugging Face responses manually.
+     */
+    toIR(response: HuggingFaceResponse | HuggingFaceResponse[], originalRequest: IRChatRequest, latencyMs: number): IRChatResponse;
+    /**
+     * Convert messages to prompt text.
+     */
+    private messagesToPrompt;
+    /**
+     * Make HTTP request to Hugging Face API.
+     */
+    private makeRequest;
+    /**
+     * Get HTTP headers for Hugging Face API requests.
+     */
+    private getHeaders;
+    /**
+     * Estimate token count for a request.
+     */
+    private estimateTokens;
+}
+/**
+ * Create a Hugging Face backend adapter.
+ *
+ * @param config - Adapter configuration
+ * @returns Hugging Face backend adapter
+ *
+ * @example
+ * ```typescript
+ * import { createHuggingFaceAdapter } from 'ai.matey';
+ *
+ * const adapter = createHuggingFaceAdapter({
+ *   apiKey: process.env.HUGGINGFACE_API_KEY,
+ * });
+ * ```
+ */
+export declare function createHuggingFaceAdapter(config: BackendAdapterConfig): HuggingFaceBackendAdapter;
+//# sourceMappingURL=huggingface.d.ts.map

package/dist/types/providers/huggingface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.d.ts","sourceRoot":"","sources":["../../../src/providers/huggingface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EAGb,MAAM,gBAAgB,CAAC;AASxB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EACF,MAAM,GACN;QACE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACN,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;IACF,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE;QACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,yBAA0B,YAAW,cAAc,CAC9D,kBAAkB,EAClB,mBAAmB,CACpB;IACC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,oBAAoB;IA6BxC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAoCpF;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY;IAgDjF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkB5D;;;;OAIG;IACI,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB;IAoCzD;;;;OAIG;IACI,IAAI,CACT,QAAQ,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,EACrD,eAAe,EAAE,aAAa,EAC9B,SAAS,EAAE,MAAM,GAChB,cAAc;IAgDjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;YACW,WAAW;IAuCzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,cAAc;CAiBvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,yBAAyB,CAEhG"}

package/dist/types/providers/lmstudio.d.ts

@@ -0,0 +1,88 @@
+/**
+ * LM Studio Backend Adapter
+ *
+ * Adapts Universal IR to LM Studio local API (OpenAI-compatible).
+ * LM Studio runs models locally on your machine with zero cost.
+ *
+ * @module
+ */
+import { OpenAIBackendAdapter, type OpenAIRequest, type OpenAIResponse } from './openai.js';
+import type { BackendAdapter, BackendAdapterConfig, IRChatRequest } from 'ai.matey.types';
+/**
+ * Backend adapter for LM Studio local API.
+ *
+ * LM Studio provides a local OpenAI-compatible API server for running
+ * models on your own hardware. Perfect for privacy, development, and cost savings.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { LMStudioBackendAdapter } from 'ai.matey';
+ *
+ * const adapter = new LMStudioBackendAdapter({
+ *   baseURL: 'http://localhost:1234/v1', // Default LM Studio port
+ * });
+ * ```
+ *
+ * @example With Custom Model
+ * ```typescript
+ * const adapter = new LMStudioBackendAdapter({
+ *   baseURL: 'http://localhost:1234/v1',
+ * });
+ *
+ * const response = await adapter.execute({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: {
+ *     model: 'local-model', // Use whatever model is loaded in LM Studio
+ *   },
+ * });
+ * ```
+ *
+ * @example Privacy-Focused Local Inference
+ * ```typescript
+ * import { createBridge } from 'ai.matey';
+ *
+ * const bridge = createBridge({
+ *   backend: new LMStudioBackendAdapter({
+ *     baseURL: 'http://localhost:1234/v1',
+ *   }),
+ * });
+ *
+ * // All requests stay on your local machine
+ * const response = await bridge.chat({
+ *   messages: [{ role: 'user', content: 'Sensitive data here' }],
+ * });
+ * ```
+ */
+export declare class LMStudioBackendAdapter extends OpenAIBackendAdapter implements BackendAdapter<OpenAIRequest, OpenAIResponse> {
+    constructor(config: BackendAdapterConfig);
+    /**
+     * Health check for LM Studio.
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Estimate cost for LM Studio (always $0 - local inference).
+     */
+    estimateCost(_request: IRChatRequest): Promise<number | null>;
+}
+/**
+ * Create an LM Studio backend adapter.
+ *
+ * @param config - Adapter configuration
+ * @returns LM Studio backend adapter
+ *
+ * @example Default Configuration
+ * ```typescript
+ * import { createLMStudioAdapter } from 'ai.matey';
+ *
+ * const adapter = createLMStudioAdapter({});
+ * ```
+ *
+ * @example Custom Port
+ * ```typescript
+ * const adapter = createLMStudioAdapter({
+ *   baseURL: 'http://localhost:8080/v1',
+ * });
+ * ```
+ */
+export declare function createLMStudioAdapter(config?: BackendAdapterConfig): LMStudioBackendAdapter;
+//# sourceMappingURL=lmstudio.d.ts.map

package/dist/types/providers/lmstudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lmstudio.d.ts","sourceRoot":"","sources":["../../../src/providers/lmstudio.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,sBACX,SAAQ,oBACR,YAAW,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC;gBAE5C,MAAM,EAAE,oBAAoB;IAmCxC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAI9D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,oBAAiD,GACxD,sBAAsB,CAExB"}

package/dist/types/providers/mistral.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Mistral Backend Adapter
+ *
+ * Adapts Universal IR to Mistral API.
+ * Mistral uses OpenAI-compatible format with minor differences.
+ *
+ * @module
+ */
+import type { BackendAdapter, BackendAdapterConfig, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+export interface MistralMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface MistralRequest {
+    model: string;
+    messages: MistralMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    stream?: boolean;
+    safe_mode?: boolean;
+    random_seed?: number;
+}
+export interface MistralResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: MistralMessage;
+        finish_reason: 'stop' | 'length' | 'model_length' | null;
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export declare class MistralBackendAdapter implements BackendAdapter<MistralRequest, MistralResponse> {
+    readonly metadata: AdapterMetadata;
+    private readonly config;
+    private readonly baseURL;
+    constructor(config: BackendAdapterConfig);
+    execute(request: IRChatRequest, signal?: AbortSignal): Promise<IRChatResponse>;
+    executeStream(request: IRChatRequest, signal?: AbortSignal): IRChatStream;
+    healthCheck(): Promise<boolean>;
+    estimateCost(request: IRChatRequest): Promise<number | null>;
+    /**
+     * Convert IR request to Mistral format.
+     *
+     * Public method for testing and debugging - see what will be sent to Mistral.
+     */
+    fromIR(request: IRChatRequest): MistralRequest;
+    /**
+     * Convert Mistral response to IR format.
+     *
+     * Public method for testing and debugging - parse Mistral responses manually.
+     */
+    toIR(response: MistralResponse, originalRequest: IRChatRequest, latencyMs: number): IRChatResponse;
+    private mapFinishReason;
+    private estimateTokens;
+}
+//# sourceMappingURL=mistral.d.ts.map