ai.matey.backend 0.2.0

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

@@ -0,0 +1,91 @@
+/**
+ * Replicate Backend Adapter
+ *
+ * Adapts Universal IR to Replicate Predictions API.
+ * Replicate has per-model API variations and async prediction workflow.
+ *
+ * @module
+ */
+import type { BackendAdapter, BackendAdapterConfig, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+export interface ReplicateInput {
+    prompt?: string;
+    system_prompt?: string;
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    top_k?: number;
+}
+export interface ReplicatePrediction {
+    id: string;
+    status: 'starting' | 'processing' | 'succeeded' | 'failed' | 'canceled';
+    input: ReplicateInput;
+    output?: string | string[];
+    error?: string;
+    metrics?: {
+        predict_time?: number;
+    };
+    urls?: {
+        get: string;
+        cancel: string;
+    };
+}
+export interface ReplicateRequest {
+    version: string;
+    input: ReplicateInput;
+    stream?: boolean;
+}
+/**
+ * Backend adapter for Replicate Predictions API.
+ *
+ * Features:
+ * - Async prediction workflow
+ * - Per-model API variations
+ * - Limited streaming support
+ * - Text-only (vision varies by model)
+ * - No function calling
+ * - Variable pricing per model
+ *
+ * Note: This adapter uses a simplified synchronous approach by polling.
+ * For production, consider using webhooks or proper async patterns.
+ */
+export declare class ReplicateBackendAdapter implements BackendAdapter<ReplicateRequest, ReplicatePrediction> {
+    readonly metadata: AdapterMetadata;
+    private readonly config;
+    private readonly baseURL;
+    private readonly maxPollAttempts;
+    private readonly pollInterval;
+    constructor(config: BackendAdapterConfig);
+    /**
+     * Convert IR to Replicate format.
+     */
+    fromIR(request: IRChatRequest): ReplicateRequest;
+    /**
+     * Convert Replicate prediction to IR.
+     */
+    toIR(prediction: ReplicatePrediction, originalRequest: IRChatRequest, latencyMs: number): IRChatResponse;
+    /**
+     * Execute non-streaming request.
+     * Uses polling to wait for async prediction.
+     */
+    execute(request: IRChatRequest, signal?: AbortSignal): Promise<IRChatResponse>;
+    /**
+     * Execute streaming request.
+     * Replicate streaming is limited and varies by model.
+     */
+    executeStream(request: IRChatRequest, signal?: AbortSignal): IRChatStream;
+    /**
+     * Get HTTP headers.
+     */
+    private getHeaders;
+    /**
+     * Health check.
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Estimate cost.
+     * Replicate pricing varies significantly per model.
+     */
+    estimateCost(_request: IRChatRequest): Promise<number | null>;
+}
+//# sourceMappingURL=replicate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replicate.d.ts","sourceRoot":"","sources":["../../../src/providers/replicate.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;AAexB,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAEhB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxE,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAwB,YAAW,cAAc,CAC5D,gBAAgB,EAChB,mBAAmB,CACpB;IACC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAc;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,MAAM,EAAE,oBAAoB;IA4BxC;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB;IA4CvD;;OAEG;IACI,IAAI,CACT,UAAU,EAAE,mBAAmB,EAC/B,eAAe,EAAE,aAAa,EAC9B,SAAS,EAAE,MAAM,GAChB,cAAc;IA0CjB;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAwFpF;;;OAGG;IACI,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY;IA2GhF;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAarC;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAK9D"}

package/dist/types/providers/together-ai.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Together AI Backend Adapter
+ *
+ * Adapts Universal IR to Together AI Chat Completions API.
+ * Together AI is OpenAI-compatible with 200+ open-source models.
+ *
+ * @module
+ */
+import type { BackendAdapter, BackendAdapterConfig, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+export type TogetherAIMessageContent = string | Array<{
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+    };
+}>;
+export interface TogetherAIMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: TogetherAIMessageContent;
+    name?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+export interface TogetherAIRequest {
+    model: string;
+    messages: TogetherAIMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    stop?: string[];
+    stream?: boolean;
+}
+export interface TogetherAIResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: TogetherAIMessage;
+        finish_reason: 'stop' | 'length' | 'tool_calls' | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface TogetherAIStreamChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: {
+            role?: 'assistant';
+            content?: string;
+        };
+        finish_reason: 'stop' | 'length' | null;
+    }>;
+}
+/**
+ * Backend adapter for Together AI Chat Completions API.
+ *
+ * Features:
+ * - 200+ open-source models
+ * - OpenAI-compatible API
+ * - Vision model support
+ * - Function calling support
+ * - Budget pricing starting at $0.06 per 1M tokens
+ */
+export declare class TogetherAIBackendAdapter implements BackendAdapter<TogetherAIRequest, TogetherAIResponse> {
+    readonly metadata: AdapterMetadata;
+    private readonly config;
+    private readonly baseURL;
+    constructor(config: BackendAdapterConfig);
+    /**
+     * Convert IR to Together AI format.
+     */
+    fromIR(request: IRChatRequest): TogetherAIRequest;
+    /**
+     * Convert Together AI response to IR.
+     */
+    toIR(response: TogetherAIResponse, 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=together-ai.d.ts.map

package/dist/types/providers/together-ai.d.ts.map

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

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

@@ -0,0 +1,119 @@
+/**
+ * xAI Backend Adapter
+ *
+ * Adapts Universal IR to xAI (Grok) Chat Completions API.
+ * xAI is OpenAI-compatible with Grok models featuring real-time search.
+ *
+ * @module
+ */
+import type { BackendAdapter, BackendAdapterConfig, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+export type XAIMessageContent = string | Array<{
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+    };
+}>;
+export interface XAIMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: XAIMessageContent;
+    name?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+export interface XAIRequest {
+    model: string;
+    messages: XAIMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    stop?: string[];
+    stream?: boolean;
+}
+export interface XAIResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: XAIMessage;
+        finish_reason: 'stop' | 'length' | 'tool_calls' | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface XAIStreamChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: {
+            role?: 'assistant';
+            content?: string;
+        };
+        finish_reason: 'stop' | 'length' | null;
+    }>;
+}
+/**
+ * Backend adapter for xAI (Grok) Chat Completions API.
+ *
+ * Features:
+ * - Grok models with real-time search capabilities
+ * - OpenAI-compatible API
+ * - 2M context window
+ * - Vision model support (Grok-vision)
+ * - Function calling support
+ * - Premium pricing ($5-$15 per 1M tokens)
+ */
+export declare class XAIBackendAdapter implements BackendAdapter<XAIRequest, XAIResponse> {
+    readonly metadata: AdapterMetadata;
+    private readonly config;
+    private readonly baseURL;
+    constructor(config: BackendAdapterConfig);
+    /**
+     * Convert IR to xAI format.
+     */
+    fromIR(request: IRChatRequest): XAIRequest;
+    /**
+     * Convert xAI response to IR.
+     */
+    toIR(response: XAIResponse, 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=xai.d.ts.map

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

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

package/dist/types/shared.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Backend Shared Utilities
+ *
+ * Common utilities shared across all backend adapters to reduce code duplication.
+ * These functions handle token estimation, model listing, and filtering.
+ *
+ * @module
+ */
+import type { IRChatRequest, AIModel, ListModelsResult } from 'ai.matey.types';
+/**
+ * Estimate token count for a chat request.
+ *
+ * Uses a rough heuristic of 4 characters per token, which provides
+ * a reasonable approximation across most LLMs.
+ *
+ * @param request - The IR chat request to estimate tokens for
+ * @returns Estimated token count
+ *
+ * @example
+ * ```typescript
+ * const tokens = estimateTokens({
+ *   messages: [{ role: 'user', content: 'Hello, how are you?' }],
+ * });
+ * // tokens ≈ 5
+ * ```
+ */
+export declare function estimateTokens(request: IRChatRequest): number;
+/**
+ * Build a ListModelsResult from static model configuration.
+ *
+ * Converts string model IDs or AIModel objects into a standardized result.
+ *
+ * @param models - Array of model IDs or AIModel objects
+ * @param ownedBy - Default owner for string-only model IDs
+ * @returns Standardized ListModelsResult
+ *
+ * @example
+ * ```typescript
+ * // With string IDs
+ * const result = buildStaticResult(['gpt-4', 'gpt-3.5-turbo'], 'openai');
+ *
+ * // With AIModel objects
+ * const result = buildStaticResult([
+ *   { id: 'claude-3-sonnet', name: 'Claude 3 Sonnet', ownedBy: 'anthropic' }
+ * ]);
+ * ```
+ */
+export declare function buildStaticResult(models: readonly (string | AIModel)[], ownedBy?: string): ListModelsResult;
+/**
+ * Model capability filter options.
+ */
+export interface ModelCapabilityFilter {
+    /** Filter models that support streaming */
+    readonly supportsStreaming?: boolean;
+    /** Filter models that support vision/image inputs */
+    readonly supportsVision?: boolean;
+    /** Filter models that support tool/function calling */
+    readonly supportsTools?: boolean;
+    /** Filter models that support JSON mode output */
+    readonly supportsJSON?: boolean;
+}
+/**
+ * Apply capability filter to a model list result.
+ *
+ * Filters the models based on their declared capabilities.
+ * Models without capability information are included by default.
+ *
+ * @param result - The model list result to filter
+ * @param filter - Optional capability filter criteria
+ * @returns Filtered ListModelsResult
+ *
+ * @example
+ * ```typescript
+ * const filtered = applyModelFilter(result, {
+ *   supportsStreaming: true,
+ *   supportsVision: true,
+ * });
+ * ```
+ */
+export declare function applyModelFilter(result: ListModelsResult, filter?: ModelCapabilityFilter): ListModelsResult;
+/**
+ * Cost rates per 1 million tokens.
+ */
+export interface CostRates {
+    /** Cost per 1M input tokens */
+    inputPer1M: number;
+    /** Cost per 1M output tokens */
+    outputPer1M: number;
+}
+/**
+ * Estimate request cost based on token counts and provider rates.
+ *
+ * @param inputTokens - Estimated input token count
+ * @param outputTokens - Estimated output token count (defaults to maxTokens or 1000)
+ * @param rates - Cost rates per million tokens
+ * @returns Estimated cost in USD
+ *
+ * @example
+ * ```typescript
+ * const cost = estimateCost(1000, 500, {
+ *   inputPer1M: 3.00,  // $3 per 1M input tokens
+ *   outputPer1M: 15.00, // $15 per 1M output tokens
+ * });
+ * // cost ≈ $0.0105
+ * ```
+ */
+export declare function estimateCost(inputTokens: number, outputTokens: number, rates: CostRates): number;
+/**
+ * Default OpenAI models with capabilities.
+ */
+export declare const DEFAULT_OPENAI_MODELS: readonly AIModel[];
+/**
+ * Default Anthropic Claude models with capabilities.
+ */
+export declare const DEFAULT_ANTHROPIC_MODELS: readonly AIModel[];
+//# sourceMappingURL=shared.d.ts.map

package/dist/types/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAM/E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAiB7D;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,EACrC,OAAO,SAAa,GACnB,gBAAgB,CAmBlB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,qDAAqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,uDAAuD;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,gBAAgB,CA4ClB;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAIhG;AAMD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,OAAO,EAyD1C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,OAAO,EA2C7C,CAAC"}