ai.libx.js 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Elya Livshitz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,339 @@
+# ai.libx.js
+
+A unified, stateless API bridge for various AI models including LLMs, image/video generation, TTS, and STT. Edge-compatible and designed for use in serverless environments like Vercel Edge Functions and Cloudflare Workers.
+
+## Features
+
+- 🚀 **Unified API** - Single interface for multiple AI providers
+- 🔌 **11 Providers** - OpenAI, Anthropic, Google, Groq, Mistral, Cohere, XAI, DeepSeek, AI21, OpenRouter, Cloudflare
+- 🌊 **Streaming Support** - Real-time streaming responses from all compatible providers
+- 📝 **Plain Text Mode** - Raw text output without JSON wrapping
+- 🤖 **Model Normalization** - Intelligent alias resolution (e.g., `gpt-5` → `chatgpt-4o-latest`)
+- 🧠 **Reasoning Model Support** - Automatic detection and parameter adjustment for o1/o3/R1 models
+- 📊 **Request Logging** - Built-in metrics tracking with detailed statistics
+- 🖼️ **Multi-Modal Ready** - Framework support for images (implementation per adapter)
+- 🪶 **Stateless Design** - No state management, pass API keys per request or globally
+- 🌐 **Edge Compatible** - Works with Vercel Edge Functions and Cloudflare Workers
+- 📦 **Tree-Shakeable** - Import only what you need
+- 🔒 **Type-Safe** - Full TypeScript support with comprehensive types
+- ⚡ **Zero Dependencies** - No external runtime dependencies
+
+## Installation
+
+```bash
+npm install ai.libx.js
+```
+
+## Usage
+
+### Pattern 1: Generic Client (Runtime Model Selection)
+
+```typescript
+import AIClient from 'ai.libx.js';
+
+// Initialize with API keys and enable logging
+const ai = new AIClient({
+    apiKeys: {
+        openai: process.env.OPENAI_API_KEY,
+        anthropic: process.env.ANTHROPIC_API_KEY,
+        google: process.env.GOOGLE_API_KEY,
+    },
+    enableLogging: true  // Track metrics
+});
+
+// Non-streaming chat
+const response = await ai.chat({
+    model: 'openai/gpt-4o',
+    messages: [
+        { role: 'user', content: 'Hello!' }
+    ],
+});
+
+console.log(response.content);
+console.log(ai.getStats()); // View metrics
+
+// Streaming chat
+const stream = await ai.chat({
+    model: 'anthropic/claude-3-5-sonnet-latest',
+    messages: [
+        { role: 'user', content: 'Write a story' }
+    ],
+    stream: true,
+});
+
+for await (const chunk of stream) {
+    process.stdout.write(chunk.content);
+}
+
+// Plain text mode (raw output)
+const plainResponse = await ai.chat({
+    model: 'openai/gpt-4o',
+    messages: [{ role: 'user', content: 'Hello!' }],
+    plain: true  // Returns plain text
+});
+```
+
+### Pattern 2: Direct Provider Adapter
+
+```typescript
+import { OpenAIAdapter, AnthropicAdapter } from 'ai.libx.js/adapters';
+
+// Work directly with a specific provider
+const openai = new OpenAIAdapter({
+    apiKey: process.env.OPENAI_API_KEY
+});
+
+const response = await openai.chat({
+    model: 'gpt-4o',  // No vendor prefix needed
+    messages: [{ role: 'user', content: 'Hello!' }],
+    temperature: 0.7,
+});
+```
+
+## API Reference
+
+### AIClient
+
+#### Constructor Options
+
+```typescript
+const ai = new AIClient({
+    apiKeys?: Record<string, string>;        // API keys by provider
+    baseUrls?: Record<string, string>;       // Custom base URLs
+    cloudflareAccountId?: string;            // For Cloudflare Workers AI
+});
+```
+
+#### chat(options)
+
+```typescript
+await ai.chat({
+    model: string;                  // Format: "provider/model-name"
+    messages: Message[];            // Conversation messages
+    apiKey?: string;                // Override global API key
+    temperature?: number;           // 0-2, default varies by provider
+    maxTokens?: number;             // Max tokens to generate
+    topP?: number;                  // 0-1, nucleus sampling
+    topK?: number;                  // Top-k sampling
+    frequencyPenalty?: number;      // -2 to 2
+    presencePenalty?: number;       // -2 to 2
+    stop?: string | string[];       // Stop sequences
+    stream?: boolean;               // Enable streaming
+    providerOptions?: object;       // Provider-specific options
+});
+```
+
+### Supported Providers
+
+| Provider | Prefix | Models |
+|----------|--------|---------|
+| OpenAI | `openai/` | GPT-4, GPT-3.5, etc. |
+| Anthropic | `anthropic/` | Claude 3/4 series |
+| Google | `google/` | Gemini 1.0/1.5/2.0 |
+| Groq | `groq/` | LLaMA, Mixtral, Gemma |
+| Mistral | `mistral/` | Mistral, Mixtral series |
+| Cohere | `cohere/` | Command series |
+| XAI | `xai/` | Grok series |
+| DeepSeek | `deepseek/` | DeepSeek V3, R1 |
+| AI21 | `ai21/` | Jamba, Jurassic |
+| OpenRouter | `openrouter/` | Multi-model proxy |
+| Cloudflare | `cloudflare/` | Workers AI models |
+
+### Types
+
+```typescript
+interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    name?: string;
+    tool_call_id?: string;
+}
+
+interface ChatResponse {
+    content: string;
+    finishReason?: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    raw?: any;  // Original provider response
+}
+
+interface StreamChunk {
+    content: string;
+    finishReason?: string;
+    index?: number;
+}
+```
+
+## Provider-Specific Notes
+
+### Cloudflare Workers AI
+
+Requires account ID:
+
+```typescript
+const ai = new AIClient({
+    apiKeys: { cloudflare: 'YOUR_API_KEY' },
+    cloudflareAccountId: 'YOUR_ACCOUNT_ID',
+});
+```
+
+### OpenRouter
+
+Supports custom headers:
+
+```typescript
+await ai.chat({
+    model: 'openrouter/meta-llama/llama-3-70b-instruct',
+    messages: [...],
+    providerOptions: {
+        httpReferer: 'https://yourapp.com',
+        xTitle: 'Your App Name',
+    }
+});
+```
+
+## Edge Runtime Compatibility
+
+This library is designed to work in edge environments:
+
+```typescript
+// Vercel Edge Function
+export const config = { runtime: 'edge' };
+
+export default async function handler(req: Request) {
+    const ai = new AIClient({
+        apiKeys: { openai: process.env.OPENAI_API_KEY }
+    });
+    
+    const response = await ai.chat({
+        model: 'openai/gpt-4o-mini',
+        messages: [{ role: 'user', content: 'Hello!' }],
+    });
+    
+    return new Response(JSON.stringify(response));
+}
+```
+
+## Error Handling
+
+```typescript
+import { 
+    AILibError,
+    AuthenticationError,
+    InvalidRequestError,
+    RateLimitError,
+    ModelNotFoundError,
+    ProviderError 
+} from 'ai.libx.js';
+
+try {
+    const response = await ai.chat({...});
+} catch (error) {
+    if (error instanceof AuthenticationError) {
+        console.error('Invalid API key');
+    } else if (error instanceof RateLimitError) {
+        console.error('Rate limit exceeded');
+    } else if (error instanceof ModelNotFoundError) {
+        console.error('Model not found');
+    }
+}
+```
+
+## Model Utilities
+
+### Model Registry
+
+```typescript
+import { 
+    supportedModels, 
+    getModelInfo, 
+    listModels, 
+    isModelSupported,
+    getProviderFromModel 
+} from 'ai.libx.js';
+
+// Get model info
+const info = getModelInfo('openai/gpt-4o');
+console.log(info?.displayName); // "GPT-4o"
+
+// List all models for a provider
+const openaiModels = listModels('openai');
+
+// Check if model is supported
+if (isModelSupported('anthropic/claude-3-5-sonnet-latest')) {
+    // ...
+}
+
+// Extract provider from model string
+const provider = getProviderFromModel('openai/gpt-4o'); // "openai"
+```
+
+### Model Normalization
+
+```typescript
+import { 
+    normalizeModelName,
+    isReasoningModel,
+    supportsSystemMessages,
+    getReasoningModelAdjustments
+} from 'ai.libx.js';
+
+// Resolve model aliases
+normalizeModelName('gpt-5'); // → 'chatgpt-4o-latest'
+normalizeModelName('claude-4'); // → 'claude-sonnet-4-0'
+normalizeModelName('gemini'); // → 'models/gemini-2.0-flash'
+
+// Check for reasoning models
+isReasoningModel('openai/o1-preview'); // true
+isReasoningModel('deepseek/deepseek-reasoner'); // true
+
+// Check system message support
+supportsSystemMessages('openai/o1-preview'); // false (o1 doesn't support)
+supportsSystemMessages('openai/gpt-4o'); // true
+
+// Get required parameter adjustments
+const adjustments = getReasoningModelAdjustments('openai/o3-mini');
+// { temperature: 1, topP: 1, useMaxCompletionTokens: true }
+```
+
+### Request Logging
+
+```typescript
+const ai = new AIClient({
+    apiKeys: { openai: 'sk-...' },
+    enableLogging: true
+});
+
+// Make requests...
+await ai.chat({ model: 'openai/gpt-4o', messages: [...] });
+
+// Get statistics
+const stats = ai.getStats();
+console.log(stats);
+// {
+//   totalRequests: 10,
+//   successfulRequests: 9,
+//   failedRequests: 1,
+//   averageLatency: 1234,
+//   totalTokensUsed: 12500,
+//   providerBreakdown: {
+//     openai: { requests: 6, avgLatency: 1100, tokens: 8000 }
+//   }
+// }
+```
+
+## Examples
+
+See [example.ts](./example.ts) for complete usage examples.
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! This library is designed to be extensible - adding new providers is straightforward by implementing the `IProviderAdapter` interface.

package/build/@Module.d.ts

@@ -0,0 +1,6 @@
+export declare class Module {
+    options?: Partial<ModuleOptions>;
+    constructor(options?: Partial<ModuleOptions>);
+}
+export declare class ModuleOptions {
+}

package/build/@Module.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleOptions = exports.Module = void 0;
+class Module {
+    constructor(options) {
+        this.options = options;
+        this.options = Object.assign(Object.assign({}, new ModuleOptions()), options);
+    }
+}
+exports.Module = Module;
+class ModuleOptions {
+}
+exports.ModuleOptions = ModuleOptions;
+//# sourceMappingURL=@Module.js.map

package/build/@Module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"@Module.js","sourceRoot":"","sources":["../src/@Module.ts"],"names":[],"mappings":";;;AAEA,MAAa,MAAM;IACf,YAA0B,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;QACtD,IAAI,CAAC,OAAO,mCAAQ,IAAI,aAAa,EAAE,GAAK,OAAO,CAAE,CAAC;IAC1D,CAAC;CACJ;AAJD,wBAIC;AAED,MAAa,aAAa;CAAG;AAA7B,sCAA6B","sourcesContent":["// Module template\n\nexport class Module {\n    public constructor(public options?: Partial<ModuleOptions>) {\n        this.options = { ...new ModuleOptions(), ...options };\n    }\n}\n\nexport class ModuleOptions {}\n"]}

package/build/AIClient.d.ts

@@ -0,0 +1,19 @@
+import { ChatOptions, ChatResponse, StreamChunk } from './types';
+import { RequestLogger } from './utils/request-logger';
+export interface AIClientConfig {
+    apiKeys?: Record<string, string>;
+    baseUrls?: Record<string, string>;
+    cloudflareAccountId?: string;
+    enableLogging?: boolean;
+}
+export declare class AIClient {
+    private config;
+    private adapters;
+    private logger;
+    constructor(config?: AIClientConfig);
+    chat(options: ChatOptions): Promise<ChatResponse | AsyncIterable<StreamChunk>>;
+    private getAdapter;
+    clearAdapters(): void;
+    getLogger(): RequestLogger;
+    getStats(): import("./utils/request-logger").LoggerStats;
+}

package/build/AIClient.js

@@ -0,0 +1,132 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIClient = void 0;
+const validation_1 = require("./utils/validation");
+const errors_1 = require("./utils/errors");
+const models_1 = require("./models");
+const model_normalization_1 = require("./utils/model-normalization");
+const request_logger_1 = require("./utils/request-logger");
+const openai_1 = require("./adapters/openai");
+const anthropic_1 = require("./adapters/anthropic");
+const google_1 = require("./adapters/google");
+const groq_1 = require("./adapters/groq");
+const mistral_1 = require("./adapters/mistral");
+const cohere_1 = require("./adapters/cohere");
+const xai_1 = require("./adapters/xai");
+const deepseek_1 = require("./adapters/deepseek");
+const ai21_1 = require("./adapters/ai21");
+const openrouter_1 = require("./adapters/openrouter");
+const cloudflare_1 = require("./adapters/cloudflare");
+class AIClient {
+    constructor(config = {}) {
+        this.adapters = new Map();
+        this.config = config;
+        this.logger = (0, request_logger_1.getRequestLogger)(config.enableLogging || false);
+    }
+    chat(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const normalizedModel = (0, model_normalization_1.normalizeModelName)(options.model);
+            options = Object.assign(Object.assign({}, options), { model: normalizedModel });
+            (0, validation_1.validateChatOptions)(options);
+            const provider = (0, models_1.getProviderFromModel)(options.model);
+            if (!provider) {
+                throw new errors_1.InvalidRequestError(`Invalid model format: "${options.model}". Expected format: "provider/model-name"`);
+            }
+            if (!(0, models_1.isModelSupported)(options.model)) {
+                throw new errors_1.ModelNotFoundError(options.model);
+            }
+            const adapter = this.getAdapter(provider);
+            const chatOptions = Object.assign(Object.assign({}, options), { apiKey: options.apiKey || ((_a = this.config.apiKeys) === null || _a === void 0 ? void 0 : _a[provider]) });
+            const tracker = this.logger.startRequest(provider, options.model);
+            try {
+                const result = yield adapter.chat(chatOptions);
+                if ('content' in result) {
+                    const tokens = (_b = result.usage) === null || _b === void 0 ? void 0 : _b.totalTokens;
+                    this.logger.logRequest(tracker, true, tokens);
+                }
+                else {
+                    this.logger.logRequest(tracker, true);
+                }
+                return result;
+            }
+            catch (error) {
+                this.logger.logRequest(tracker, false, undefined, error instanceof Error ? error.message : 'Unknown error');
+                throw error;
+            }
+        });
+    }
+    getAdapter(provider) {
+        var _a, _b;
+        if (this.adapters.has(provider)) {
+            return this.adapters.get(provider);
+        }
+        const adapterConfig = {
+            apiKey: (_a = this.config.apiKeys) === null || _a === void 0 ? void 0 : _a[provider],
+            baseUrl: (_b = this.config.baseUrls) === null || _b === void 0 ? void 0 : _b[provider],
+        };
+        if (provider === 'cloudflare') {
+            adapterConfig.cloudflareAccountId = this.config.cloudflareAccountId;
+        }
+        let adapter;
+        switch (provider) {
+            case 'openai':
+                adapter = new openai_1.OpenAIAdapter(adapterConfig);
+                break;
+            case 'anthropic':
+                adapter = new anthropic_1.AnthropicAdapter(adapterConfig);
+                break;
+            case 'google':
+                adapter = new google_1.GoogleAdapter(adapterConfig);
+                break;
+            case 'groq':
+                adapter = new groq_1.GroqAdapter(adapterConfig);
+                break;
+            case 'mistral':
+                adapter = new mistral_1.MistralAdapter(adapterConfig);
+                break;
+            case 'cohere':
+                adapter = new cohere_1.CohereAdapter(adapterConfig);
+                break;
+            case 'xai':
+                adapter = new xai_1.XAIAdapter(adapterConfig);
+                break;
+            case 'deepseek':
+                adapter = new deepseek_1.DeepSeekAdapter(adapterConfig);
+                break;
+            case 'ai21':
+                adapter = new ai21_1.AI21Adapter(adapterConfig);
+                break;
+            case 'openrouter':
+                adapter = new openrouter_1.OpenRouterAdapter(adapterConfig);
+                break;
+            case 'cloudflare':
+                adapter = new cloudflare_1.CloudflareAdapter(adapterConfig);
+                break;
+            default:
+                throw new errors_1.InvalidRequestError(`Unsupported provider: ${provider}`);
+        }
+        this.adapters.set(provider, adapter);
+        return adapter;
+    }
+    clearAdapters() {
+        this.adapters.clear();
+    }
+    getLogger() {
+        return this.logger;
+    }
+    getStats() {
+        return this.logger.getStats();
+    }
+}
+exports.AIClient = AIClient;
+//# sourceMappingURL=AIClient.js.map

package/build/AIClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIClient.js","sourceRoot":"","sources":["../src/AIClient.ts"],"names":[],"mappings":"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","sourcesContent":["import { ChatOptions, ChatResponse, StreamChunk, ProviderConfig } from './types';\nimport { IProviderAdapter } from './types/provider';\nimport { validateChatOptions } from './utils/validation';\nimport { ModelNotFoundError, InvalidRequestError } from './utils/errors';\nimport { getProviderFromModel, isModelSupported } from './models';\nimport { normalizeModelName } from './utils/model-normalization';\nimport { RequestLogger, getRequestLogger } from './utils/request-logger';\n\n// Lazy import adapters\nimport { OpenAIAdapter } from './adapters/openai';\nimport { AnthropicAdapter } from './adapters/anthropic';\nimport { GoogleAdapter } from './adapters/google';\nimport { GroqAdapter } from './adapters/groq';\nimport { MistralAdapter } from './adapters/mistral';\nimport { CohereAdapter } from './adapters/cohere';\nimport { XAIAdapter } from './adapters/xai';\nimport { DeepSeekAdapter } from './adapters/deepseek';\nimport { AI21Adapter } from './adapters/ai21';\nimport { OpenRouterAdapter } from './adapters/openrouter';\nimport { CloudflareAdapter } from './adapters/cloudflare';\n\nexport interface AIClientConfig {\n\t/**\n\t * API keys for different providers\n\t * Example: { openai: 'sk-...', anthropic: 'sk-ant-...', google: '...' }\n\t */\n\tapiKeys?: Record<string, string>;\n\n\t/**\n\t * Base URLs for providers (optional, for custom endpoints)\n\t */\n\tbaseUrls?: Record<string, string>;\n\n\t/**\n\t * Cloudflare account ID (required for Cloudflare Workers AI)\n\t */\n\tcloudflareAccountId?: string;\n\n\t/**\n\t * Enable request logging for metrics tracking\n\t */\n\tenableLogging?: boolean;\n}\n\n/**\n * Main AI client class providing unified access to multiple AI providers\n */\nexport class AIClient {\n\tprivate config: AIClientConfig;\n\tprivate adapters: Map<string, IProviderAdapter> = new Map();\n\tprivate logger: RequestLogger;\n\n\tconstructor(config: AIClientConfig = {}) {\n\t\tthis.config = config;\n\t\tthis.logger = getRequestLogger(config.enableLogging || false);\n\t}\n\n\t/**\n\t * Execute a chat completion request\n\t * @param options Chat options including model, messages, and parameters\n\t * @returns ChatResponse for non-streaming, AsyncIterable<StreamChunk> for streaming\n\t */\n\tasync chat(options: ChatOptions): Promise<ChatResponse | AsyncIterable<StreamChunk>> {\n\t\t// Normalize model name (resolve aliases)\n\t\tconst normalizedModel = normalizeModelName(options.model);\n\t\toptions = { ...options, model: normalizedModel };\n\n\t\t// Validate options\n\t\tvalidateChatOptions(options);\n\n\t\t// Extract provider from model string\n\t\tconst provider = getProviderFromModel(options.model);\n\t\tif (!provider) {\n\t\t\tthrow new InvalidRequestError(\n\t\t\t\t`Invalid model format: \"${options.model}\". Expected format: \"provider/model-name\"`\n\t\t\t);\n\t\t}\n\n\t\t// Check if model is supported\n\t\tif (!isModelSupported(options.model)) {\n\t\t\tthrow new ModelNotFoundError(options.model);\n\t\t}\n\n\t\t// Get or create adapter\n\t\tconst adapter = this.getAdapter(provider);\n\n\t\t// Merge API keys from config if not provided in options\n\t\tconst chatOptions: ChatOptions = {\n\t\t\t...options,\n\t\t\tapiKey: options.apiKey || this.config.apiKeys?.[provider],\n\t\t};\n\n\t\t// Start request tracking\n\t\tconst tracker = this.logger.startRequest(provider, options.model);\n\n\t\ttry {\n\t\t\t// Execute chat\n\t\t\tconst result = await adapter.chat(chatOptions);\n\n\t\t\t// Log successful request\n\t\t\tif ('content' in result) {\n\t\t\t\tconst tokens = result.usage?.totalTokens;\n\t\t\t\tthis.logger.logRequest(tracker, true, tokens);\n\t\t\t} else {\n\t\t\t\t// Streaming - log without token count\n\t\t\t\tthis.logger.logRequest(tracker, true);\n\t\t\t}\n\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\t// Log failed request\n\t\t\tthis.logger.logRequest(\n\t\t\t\ttracker,\n\t\t\t\tfalse,\n\t\t\t\tundefined,\n\t\t\t\terror instanceof Error ? error.message : 'Unknown error'\n\t\t\t);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\t/**\n\t * Get adapter for a provider (creates if not exists)\n\t */\n\tprivate getAdapter(provider: string): IProviderAdapter {\n\t\t// Return cached adapter if exists\n\t\tif (this.adapters.has(provider)) {\n\t\t\treturn this.adapters.get(provider)!;\n\t\t}\n\n\t\t// Create adapter config\n\t\tconst adapterConfig: ProviderConfig = {\n\t\t\tapiKey: this.config.apiKeys?.[provider],\n\t\t\tbaseUrl: this.config.baseUrls?.[provider],\n\t\t};\n\n\t\t// Add cloudflare-specific config\n\t\tif (provider === 'cloudflare') {\n\t\t\tadapterConfig.cloudflareAccountId = this.config.cloudflareAccountId;\n\t\t}\n\n\t\t// Create new adapter\n\t\tlet adapter: IProviderAdapter;\n\n\t\tswitch (provider) {\n\t\t\tcase 'openai':\n\t\t\t\tadapter = new OpenAIAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'anthropic':\n\t\t\t\tadapter = new AnthropicAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'google':\n\t\t\t\tadapter = new GoogleAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'groq':\n\t\t\t\tadapter = new GroqAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'mistral':\n\t\t\t\tadapter = new MistralAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'cohere':\n\t\t\t\tadapter = new CohereAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'xai':\n\t\t\t\tadapter = new XAIAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'deepseek':\n\t\t\t\tadapter = new DeepSeekAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'ai21':\n\t\t\t\tadapter = new AI21Adapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'openrouter':\n\t\t\t\tadapter = new OpenRouterAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tcase 'cloudflare':\n\t\t\t\tadapter = new CloudflareAdapter(adapterConfig);\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new InvalidRequestError(`Unsupported provider: ${provider}`);\n\t\t}\n\n\t\t// Cache adapter\n\t\tthis.adapters.set(provider, adapter);\n\n\t\treturn adapter;\n\t}\n\n\t/**\n\t * Clear cached adapters (useful for testing or resetting state)\n\t */\n\tclearAdapters(): void {\n\t\tthis.adapters.clear();\n\t}\n\n\t/**\n\t * Get request logger for metrics\n\t */\n\tgetLogger(): RequestLogger {\n\t\treturn this.logger;\n\t}\n\n\t/**\n\t * Get request statistics\n\t */\n\tgetStats() {\n\t\treturn this.logger.getStats();\n\t}\n}\n\n"]}

package/build/Extensions.d.ts

@@ -0,0 +1,3 @@
+declare interface String {
+    replaceAt(index: number, replacement: string): string;
+}

package/build/Extensions.js

@@ -0,0 +1,4 @@
+String.prototype.replaceAt = function (index, replacement) {
+    return this.substr(0, index) + replacement + this.substr(index + replacement.length);
+};
+//# sourceMappingURL=Extensions.js.map

package/build/Extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Extensions.js","sourceRoot":"","sources":["../src/Extensions.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,SAAS,CAAC,SAAS,GAAG,UAAU,KAAK,EAAE,WAAW;IACrD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AACzF,CAAC,CAAC","sourcesContent":["declare interface String {\n    replaceAt(index: number, replacement: string): string;\n}\n\nString.prototype.replaceAt = function (index, replacement) {\n    return this.substr(0, index) + replacement + this.substr(index + replacement.length);\n};\n"]}

package/build/adapters/ai21.d.ts

@@ -0,0 +1,8 @@
+import { BaseAdapter } from './base/BaseAdapter';
+import { ChatOptions, ChatResponse, StreamChunk } from '../types';
+export declare class AI21Adapter extends BaseAdapter {
+    get name(): string;
+    chat(options: ChatOptions): Promise<ChatResponse | AsyncIterable<StreamChunk>>;
+    private transformMessages;
+    private handleNonStreamResponse;
+}

package/build/adapters/ai21.js

@@ -0,0 +1,83 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI21Adapter = void 0;
+const BaseAdapter_1 = require("./base/BaseAdapter");
+const errors_1 = require("../utils/errors");
+class AI21Adapter extends BaseAdapter_1.BaseAdapter {
+    get name() {
+        return 'ai21';
+    }
+    chat(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const apiKey = this.getApiKey(options);
+                const baseUrl = this.getBaseUrl('https://api.ai21.com/studio/v1');
+                const model = options.model.replace(/^ai21\//, '');
+                const request = {
+                    model,
+                    messages: this.transformMessages(options.messages),
+                };
+                if (options.temperature !== undefined)
+                    request.temperature = options.temperature;
+                if (options.maxTokens !== undefined)
+                    request.max_tokens = options.maxTokens;
+                if (options.topP !== undefined)
+                    request.top_p = options.topP;
+                if (options.stop && Array.isArray(options.stop)) {
+                    request.stop = options.stop;
+                }
+                if (options.providerOptions) {
+                    Object.assign(request, options.providerOptions);
+                }
+                const response = yield this.fetchWithErrorHandling(`${baseUrl}/chat/completions`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': `Bearer ${apiKey}`,
+                    },
+                    body: JSON.stringify(request),
+                }, this.name);
+                const data = yield response.json();
+                return this.handleNonStreamResponse(data, model);
+            }
+            catch (error) {
+                (0, errors_1.handleProviderError)(error, this.name);
+            }
+        });
+    }
+    transformMessages(messages) {
+        return messages.map((msg) => ({
+            role: msg.role,
+            content: msg.content,
+        }));
+    }
+    handleNonStreamResponse(data, model) {
+        var _a, _b;
+        const choice = (_a = data.choices) === null || _a === void 0 ? void 0 : _a[0];
+        if (!choice) {
+            throw new Error('No choices in response');
+        }
+        return {
+            content: ((_b = choice.message) === null || _b === void 0 ? void 0 : _b.content) || '',
+            finishReason: choice.finish_reason,
+            usage: data.usage ? {
+                promptTokens: data.usage.prompt_tokens || 0,
+                completionTokens: data.usage.completion_tokens || 0,
+                totalTokens: data.usage.total_tokens || 0,
+            } : undefined,
+            model,
+            raw: data,
+        };
+    }
+}
+exports.AI21Adapter = AI21Adapter;
+//# sourceMappingURL=ai21.js.map