@theihtisham/budget-llm 1.0.0

package/.env.example

@@ -0,0 +1,21 @@
+# Server
+PORT=3210
+NODE_ENV=development
+
+# Encryption key for API key storage (generate with: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))")
+ENCRYPTION_KEY=change_me_to_a_64_char_hex_string_in_production_at_least_32_bytes_here
+
+# Default budget limits (in USD)
+DEFAULT_DAILY_BUDGET=10.00
+DEFAULT_MONTHLY_BUDGET=200.00
+DEFAULT_PER_REQUEST_CAP=1.00
+
+# Cache TTL in seconds
+CACHE_TTL=3600
+
+# Rate limiting
+RATE_LIMIT_WINDOW_MS=60000
+RATE_LIMIT_MAX_REQUESTS=60
+
+# Logging level: debug, info, warn, error
+LOG_LEVEL=info

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 BudgetLLM Contributors
+
+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,293 @@
+# BudgetLLM
+
+> Cut your AI costs by 60% — one API endpoint that automatically picks the cheapest model for every request.
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Strict-3178C6.svg)](https://www.typescriptlang.org/)
+[![Vitest](https://img.shields.io/badge/tested%20with-Vitest-6E9F18.svg)](https://vitest.dev/)
+
+BudgetLLM is a smart multi-provider LLM cost optimizer and routing proxy. It sits between your application and LLM providers (OpenAI, Anthropic, Google, DeepSeek) and automatically routes each request to the cheapest capable model based on the task type.
+
+## How It Works
+
+```
+Your App
+   |
+   | POST /v1/chat/completions  (OpenAI-compatible)
+   v
++------------------+
+|   BudgetLLM      |
+|   Proxy Server   |
++------------------+
+   |                |               |              |
+   | Task           | Budget        | Cache        | Rate Limit
+   | Classification | Enforcement   | Lookup       | Check
+   |                |               |              |
+   v                v               v              v
++----------------------------------------------------------+
+|                    Smart Router                           |
+|  code tasks -> cheapest capable model                     |
+|  creative tasks -> highest quality model                  |
+|  chat tasks -> fastest cheapest model                     |
+|  reasoning -> best reasoning model                        |
++----------------------------------------------------------+
+   |             |             |             |
+   v             v             v             v
++--------+  +--------+  +--------+  +--------+
+| OpenAI |  |Anthropic| | Google |  |DeepSeek|
++--------+  +--------+  +--------+  +--------+
+   |             |             |             |
+   +-------------+------+------+-------------+
+                        |
+                   Cost Tracking
+                   & Response Cache
+                        |
+                        v
+                   SQLite Database
+```
+
+## Features
+
+- **Smart Routing** - Automatically classifies tasks (code, creative, reasoning, chat, etc.) and picks the cheapest model that can handle it well
+- **Budget Limits** - Daily, monthly, and per-request cost caps with automatic enforcement
+- **Fallback Chain** - If the primary provider fails, automatically tries the next best provider
+- **Cost Tracking** - Per-request, per-day, per-model cost logging with SQLite storage
+- **Response Caching** - Identical prompts return cached responses (free!) with configurable TTL
+- **Rate Limiting** - Token bucket algorithm with per-IP limits
+- **Real-time Dashboard** - Beautiful web UI showing costs, savings, usage, and budget status
+- **OpenAI-Compatible** - Drop-in replacement for the OpenAI API. Just change the base URL.
+- **Security** - API key encryption (AES-256-GCM), rate limiting, input validation, no prompt content logging
+
+## Cost Comparison
+
+BudgetLLM automatically picks the cheapest model for each task type. Here's how costs compare:
+
+| Task Type | Default Route | Cost/1M Tokens | vs GPT-4 Turbo | Savings |
+|-----------|--------------|----------------|-----------------|---------|
+| Chat | Gemini 2.0 Flash | $0.10 / $0.40 | $10 / $30 | **97%** |
+| Code | GPT-4o Mini | $0.15 / $0.60 | $10 / $30 | **98%** |
+| Creative | GPT-4o | $2.50 / $10.00 | $10 / $30 | **67%** |
+| Reasoning | DeepSeek R1 | $0.55 / $2.19 | $10 / $30 | **93%** |
+| Summarization | Gemini 2.0 Flash | $0.10 / $0.40 | $10 / $30 | **97%** |
+| Translation | Gemini 2.0 Flash Lite | $0.075 / $0.30 | $10 / $30 | **99%** |
+| Math | DeepSeek R1 | $0.55 / $2.19 | $10 / $30 | **93%** |
+| Analysis | DeepSeek V3 | $0.27 / $1.10 | $10 / $30 | **96%** |
+
+### Model Catalog
+
+| Model | Provider | Input/1M | Output/1M | Quality | Speed | Cost |
+|-------|----------|----------|-----------|---------|-------|------|
+| GPT-4o | OpenAI | $2.50 | $10.00 | 9/10 | 7/10 | 5/10 |
+| GPT-4o Mini | OpenAI | $0.15 | $0.60 | 7/10 | 9/10 | 9/10 |
+| GPT-4 Turbo | OpenAI | $10.00 | $30.00 | 9/10 | 6/10 | 3/10 |
+| Claude Sonnet 4 | Anthropic | $3.00 | $15.00 | 9/10 | 7/10 | 5/10 |
+| Claude 3.5 Haiku | Anthropic | $0.80 | $4.00 | 7/10 | 9/10 | 7/10 |
+| Gemini 2.0 Flash | Google | $0.10 | $0.40 | 7/10 | 10/10 | 10/10 |
+| Gemini 2.0 Flash Lite | Google | $0.075 | $0.30 | 6/10 | 10/10 | 10/10 |
+| DeepSeek V3 | DeepSeek | $0.27 | $1.10 | 8/10 | 8/10 | 8/10 |
+| DeepSeek R1 | DeepSeek | $0.55 | $2.19 | 9/10 | 5/10 | 7/10 |
+
+## Quick Start
+
+### 1. Install
+
+```bash
+git clone https://github.com/your-username/budget-llm.git
+cd budget-llm
+npm install
+```
+
+### 2. Configure
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` and add your API keys:
+
+```env
+# Add at least one provider API key
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+GOOGLE_API_KEY=AIza...
+DEEPSEEK_API_KEY=sk-...
+
+# Set your budget limits
+DEFAULT_DAILY_BUDGET=10.00
+DEFAULT_MONTHLY_BUDGET=200.00
+DEFAULT_PER_REQUEST_CAP=1.00
+```
+
+### 3. Run
+
+```bash
+# Development
+npm run dev
+
+# Production
+npm run build
+npm start
+```
+
+### 4. Use It
+
+BudgetLLM is a drop-in replacement for the OpenAI API. Just change the base URL:
+
+**Before (direct OpenAI):**
+```javascript
+const openai = new OpenAI({
+  apiKey: 'sk-your-key',
+  baseURL: 'https://api.openai.com/v1',
+});
+```
+
+**After (via BudgetLLM):**
+```javascript
+const openai = new OpenAI({
+  apiKey: 'anything', // BudgetLLM doesn't require a client key
+  baseURL: 'http://localhost:3210/v1',
+});
+```
+
+That's it. Every request is now automatically optimized for cost.
+
+### 5. Optional: Task Type Hints
+
+Help BudgetLLM pick the best model by specifying a task type:
+
+```javascript
+const response = await openai.chat.completions.create({
+  model: 'auto', // let BudgetLLM decide
+  messages: [{ role: 'user', content: 'Write a sort function' }],
+  // BudgetLLM extension:
+  task_type: 'code',  // forces code-optimized routing
+});
+```
+
+## API Reference
+
+### OpenAI-Compatible Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/v1/chat/completions` | Chat completion (drop-in replacement) |
+| GET | `/v1/models` | List available models |
+
+### BudgetLLM Extensions
+
+The `/v1/chat/completions` endpoint accepts these additional fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `task_type` | string | Force routing: `code`, `creative`, `reasoning`, `chat`, `summarization`, `translation`, `analysis`, `math`, `auto` |
+| `request_id` | string | Custom request ID for tracking |
+| `budget_cap` | number | Per-request budget cap in USD |
+
+The response includes a `cost` field:
+
+```json
+{
+  "cost": {
+    "inputCost": 0.0000015,
+    "outputCost": 0.000006,
+    "totalCost": 0.0000075,
+    "currency": "USD",
+    "model": "gpt-4o-mini",
+    "provider": "openai",
+    "savingsVsGpt4": 0.00012
+  }
+}
+```
+
+### Management API
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/health` | Health check |
+| GET | `/api/dashboard` | Full dashboard data |
+| GET | `/api/costs?days=30` | Cost summary |
+| GET | `/api/budget` | Budget config and status |
+| PUT | `/api/budget` | Update budget limits |
+| GET | `/api/rate-limit` | Rate limit status |
+| DELETE | `/api/cache` | Clear response cache |
+| GET | `/dashboard` | Web dashboard UI |
+
+## Architecture
+
+```
+src/
+  server.ts          # Express HTTP server with all routes
+  proxy.ts           # Main request handler (orchestrates everything)
+  router.ts          # Smart model routing engine
+  task-classifier.ts # Task type detection from prompts
+  providers.ts       # Provider adapters (OpenAI, Anthropic, Google, DeepSeek)
+  database.ts        # SQLite database layer
+  rate-limiter.ts    # Token bucket rate limiter
+  config.ts          # Configuration, model catalog, logging
+  types.ts           # TypeScript type definitions
+  utils/
+    encryption.ts    # AES-256-GCM encryption for API keys
+```
+
+### Routing Algorithm
+
+BudgetLLM scores each model using weighted criteria that vary by task type:
+
+| Task Type | Quality Weight | Cost Weight | Speed Weight |
+|-----------|---------------|-------------|--------------|
+| Code | 40% | 45% | 15% |
+| Creative | 70% | 15% | 15% |
+| Reasoning | 65% | 25% | 10% |
+| Chat | 20% | 60% | 20% |
+| Summarization | 20% | 60% | 20% |
+| Translation | 20% | 60% | 20% |
+| Analysis | 50% | 35% | 15% |
+
+Models also get a +20 score bonus if they declare the task type as a capability, and a -10 penalty otherwise.
+
+### Fallback Chain
+
+When the primary provider fails, BudgetLLM tries up to 3 alternative providers in priority order. This means your app stays up even if one provider has an outage.
+
+### Caching
+
+Identical prompts (same messages, model, temperature, max_tokens) are cached with a configurable TTL. Cached responses are served instantly with zero cost. The cache uses content-hash matching so even rephrased requests that happen to match the exact same parameters get the benefit.
+
+## Security
+
+- **API Key Encryption** - Stored keys are encrypted with AES-256-GCM
+- **Rate Limiting** - Token bucket algorithm prevents abuse
+- **Input Validation** - Zod schema validation on all inputs
+- **No Prompt Logging** - Request metadata is logged, but prompt content is never stored in logs
+- **Helmet** - HTTP security headers via helmet middleware
+- **Budget Enforcement** - Hard limits prevent runaway spending
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode with hot reload
+npm run dev
+
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Generate coverage report
+npm run test:coverage
+
+# Type check
+npm run lint
+
+# Build for production
+npm run build
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/config.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import type { ProviderConfig, ModelInfo, BudgetConfig } from './types';
+declare const envSchema: z.ZodObject<{
+    PORT: z.ZodDefault<z.ZodNumber>;
+    NODE_ENV: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
+    ENCRYPTION_KEY: z.ZodDefault<z.ZodString>;
+    DEFAULT_DAILY_BUDGET: z.ZodDefault<z.ZodNumber>;
+    DEFAULT_MONTHLY_BUDGET: z.ZodDefault<z.ZodNumber>;
+    DEFAULT_PER_REQUEST_CAP: z.ZodDefault<z.ZodNumber>;
+    CACHE_TTL: z.ZodDefault<z.ZodNumber>;
+    RATE_LIMIT_WINDOW_MS: z.ZodDefault<z.ZodNumber>;
+    RATE_LIMIT_MAX_REQUESTS: z.ZodDefault<z.ZodNumber>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    OPENAI_API_KEY: z.ZodOptional<z.ZodString>;
+    ANTHROPIC_API_KEY: z.ZodOptional<z.ZodString>;
+    GOOGLE_API_KEY: z.ZodOptional<z.ZodString>;
+    DEEPSEEK_API_KEY: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    PORT: number;
+    NODE_ENV: "development" | "production" | "test";
+    ENCRYPTION_KEY: string;
+    DEFAULT_DAILY_BUDGET: number;
+    DEFAULT_MONTHLY_BUDGET: number;
+    DEFAULT_PER_REQUEST_CAP: number;
+    CACHE_TTL: number;
+    RATE_LIMIT_WINDOW_MS: number;
+    RATE_LIMIT_MAX_REQUESTS: number;
+    LOG_LEVEL: "debug" | "info" | "warn" | "error";
+    OPENAI_API_KEY?: string | undefined;
+    ANTHROPIC_API_KEY?: string | undefined;
+    GOOGLE_API_KEY?: string | undefined;
+    DEEPSEEK_API_KEY?: string | undefined;
+}, {
+    PORT?: number | undefined;
+    NODE_ENV?: "development" | "production" | "test" | undefined;
+    ENCRYPTION_KEY?: string | undefined;
+    DEFAULT_DAILY_BUDGET?: number | undefined;
+    DEFAULT_MONTHLY_BUDGET?: number | undefined;
+    DEFAULT_PER_REQUEST_CAP?: number | undefined;
+    CACHE_TTL?: number | undefined;
+    RATE_LIMIT_WINDOW_MS?: number | undefined;
+    RATE_LIMIT_MAX_REQUESTS?: number | undefined;
+    LOG_LEVEL?: "debug" | "info" | "warn" | "error" | undefined;
+    OPENAI_API_KEY?: string | undefined;
+    ANTHROPIC_API_KEY?: string | undefined;
+    GOOGLE_API_KEY?: string | undefined;
+    DEEPSEEK_API_KEY?: string | undefined;
+}>;
+export type EnvConfig = z.infer<typeof envSchema>;
+export declare const env: {
+    PORT: number;
+    NODE_ENV: "development" | "production" | "test";
+    ENCRYPTION_KEY: string;
+    DEFAULT_DAILY_BUDGET: number;
+    DEFAULT_MONTHLY_BUDGET: number;
+    DEFAULT_PER_REQUEST_CAP: number;
+    CACHE_TTL: number;
+    RATE_LIMIT_WINDOW_MS: number;
+    RATE_LIMIT_MAX_REQUESTS: number;
+    LOG_LEVEL: "debug" | "info" | "warn" | "error";
+    OPENAI_API_KEY?: string | undefined;
+    ANTHROPIC_API_KEY?: string | undefined;
+    GOOGLE_API_KEY?: string | undefined;
+    DEEPSEEK_API_KEY?: string | undefined;
+};
+export declare function getProviders(): ProviderConfig[];
+export declare const MODEL_CATALOG: ModelInfo[];
+export declare function getDefaultBudget(): BudgetConfig;
+export declare function getDbPath(): string;
+export declare const log: {
+    debug: (msg: string, data?: unknown) => void;
+    info: (msg: string, data?: unknown) => void;
+    warn: (msg: string, data?: unknown) => void;
+    error: (msg: string, data?: unknown) => void;
+};
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMvE,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeb,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAalD,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;CAAa,CAAC;AAI9B,wBAAgB,YAAY,IAAI,cAAc,EAAE,CAuC/C;AAID,eAAO,MAAM,aAAa,EAAE,SAAS,EA0HpC,CAAC;AAIF,wBAAgB,gBAAgB,IAAI,YAAY,CAM/C;AAID,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAgBD,eAAO,MAAM,GAAG;iBACD,MAAM,SAAS,OAAO;gBAGvB,MAAM,SAAS,OAAO;gBAGtB,MAAM,SAAS,OAAO;iBAGrB,MAAM,SAAS,OAAO;CAGpC,CAAC"}

package/dist/config.js

@@ -0,0 +1,246 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = exports.MODEL_CATALOG = exports.env = void 0;
+exports.getProviders = getProviders;
+exports.getDefaultBudget = getDefaultBudget;
+exports.getDbPath = getDbPath;
+const zod_1 = require("zod");
+const dotenv_1 = __importDefault(require("dotenv"));
+const path_1 = __importDefault(require("path"));
+dotenv_1.default.config({ path: path_1.default.resolve(process.cwd(), '.env') });
+// ---- Environment Schema ----
+const envSchema = zod_1.z.object({
+    PORT: zod_1.z.coerce.number().default(3210),
+    NODE_ENV: zod_1.z.enum(['development', 'production', 'test']).default('development'),
+    ENCRYPTION_KEY: zod_1.z.string().min(32).default('dev_key_change_in_production_32chars!!'),
+    DEFAULT_DAILY_BUDGET: zod_1.z.coerce.number().positive().default(10),
+    DEFAULT_MONTHLY_BUDGET: zod_1.z.coerce.number().positive().default(200),
+    DEFAULT_PER_REQUEST_CAP: zod_1.z.coerce.number().positive().default(1),
+    CACHE_TTL: zod_1.z.coerce.number().positive().default(3600),
+    RATE_LIMIT_WINDOW_MS: zod_1.z.coerce.number().positive().default(60000),
+    RATE_LIMIT_MAX_REQUESTS: zod_1.z.coerce.number().positive().default(60),
+    LOG_LEVEL: zod_1.z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+    OPENAI_API_KEY: zod_1.z.string().optional(),
+    ANTHROPIC_API_KEY: zod_1.z.string().optional(),
+    GOOGLE_API_KEY: zod_1.z.string().optional(),
+    DEEPSEEK_API_KEY: zod_1.z.string().optional(),
+});
+function parseEnv() {
+    const result = envSchema.safeParse(process.env);
+    if (!result.success) {
+        const errors = result.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        throw new Error(`Configuration error: ${errors}`);
+    }
+    return result.data;
+}
+exports.env = parseEnv();
+// ---- Provider Configurations ----
+function getProviders() {
+    return [
+        {
+            id: 'openai',
+            name: 'OpenAI',
+            baseUrl: 'https://api.openai.com/v1',
+            apiKey: exports.env.OPENAI_API_KEY ?? '',
+            enabled: !!exports.env.OPENAI_API_KEY,
+            priority: 1,
+            timeoutMs: 30000,
+        },
+        {
+            id: 'anthropic',
+            name: 'Anthropic',
+            baseUrl: 'https://api.anthropic.com/v1',
+            apiKey: exports.env.ANTHROPIC_API_KEY ?? '',
+            enabled: !!exports.env.ANTHROPIC_API_KEY,
+            priority: 2,
+            timeoutMs: 30000,
+        },
+        {
+            id: 'google',
+            name: 'Google',
+            baseUrl: 'https://generativelanguage.googleapis.com/v1beta',
+            apiKey: exports.env.GOOGLE_API_KEY ?? '',
+            enabled: !!exports.env.GOOGLE_API_KEY,
+            priority: 3,
+            timeoutMs: 30000,
+        },
+        {
+            id: 'deepseek',
+            name: 'DeepSeek',
+            baseUrl: 'https://api.deepseek.com/v1',
+            apiKey: exports.env.DEEPSEEK_API_KEY ?? '',
+            enabled: !!exports.env.DEEPSEEK_API_KEY,
+            priority: 4,
+            timeoutMs: 30000,
+        },
+    ];
+}
+// ---- Model Catalog ----
+exports.MODEL_CATALOG = [
+    // OpenAI
+    {
+        id: 'gpt-4o',
+        provider: 'openai',
+        displayName: 'GPT-4o',
+        inputPricePer1M: 2.50,
+        outputPricePer1M: 10.00,
+        contextWindow: 128000,
+        maxOutputTokens: 16384,
+        capabilities: ['code', 'creative', 'reasoning', 'chat', 'analysis', 'math'],
+        qualityScore: 9,
+        speedScore: 7,
+        costScore: 5,
+    },
+    {
+        id: 'gpt-4o-mini',
+        provider: 'openai',
+        displayName: 'GPT-4o Mini',
+        inputPricePer1M: 0.15,
+        outputPricePer1M: 0.60,
+        contextWindow: 128000,
+        maxOutputTokens: 16384,
+        capabilities: ['code', 'chat', 'summarization', 'translation'],
+        qualityScore: 7,
+        speedScore: 9,
+        costScore: 9,
+    },
+    {
+        id: 'gpt-4-turbo',
+        provider: 'openai',
+        displayName: 'GPT-4 Turbo',
+        inputPricePer1M: 10.00,
+        outputPricePer1M: 30.00,
+        contextWindow: 128000,
+        maxOutputTokens: 4096,
+        capabilities: ['code', 'creative', 'reasoning', 'chat', 'analysis', 'math'],
+        qualityScore: 9,
+        speedScore: 6,
+        costScore: 3,
+    },
+    // Anthropic
+    {
+        id: 'claude-sonnet-4-20250514',
+        provider: 'anthropic',
+        displayName: 'Claude Sonnet 4',
+        inputPricePer1M: 3.00,
+        outputPricePer1M: 15.00,
+        contextWindow: 200000,
+        maxOutputTokens: 8192,
+        capabilities: ['code', 'creative', 'reasoning', 'chat', 'analysis'],
+        qualityScore: 9,
+        speedScore: 7,
+        costScore: 5,
+    },
+    {
+        id: 'claude-haiku-3-5-20241022',
+        provider: 'anthropic',
+        displayName: 'Claude 3.5 Haiku',
+        inputPricePer1M: 0.80,
+        outputPricePer1M: 4.00,
+        contextWindow: 200000,
+        maxOutputTokens: 8192,
+        capabilities: ['code', 'chat', 'summarization', 'translation'],
+        qualityScore: 7,
+        speedScore: 9,
+        costScore: 7,
+    },
+    // Google
+    {
+        id: 'gemini-2.0-flash',
+        provider: 'google',
+        displayName: 'Gemini 2.0 Flash',
+        inputPricePer1M: 0.10,
+        outputPricePer1M: 0.40,
+        contextWindow: 1048576,
+        maxOutputTokens: 8192,
+        capabilities: ['code', 'chat', 'summarization', 'translation', 'analysis', 'math'],
+        qualityScore: 7,
+        speedScore: 10,
+        costScore: 10,
+    },
+    {
+        id: 'gemini-2.0-flash-lite',
+        provider: 'google',
+        displayName: 'Gemini 2.0 Flash Lite',
+        inputPricePer1M: 0.075,
+        outputPricePer1M: 0.30,
+        contextWindow: 1048576,
+        maxOutputTokens: 8192,
+        capabilities: ['chat', 'summarization', 'translation'],
+        qualityScore: 6,
+        speedScore: 10,
+        costScore: 10,
+    },
+    // DeepSeek
+    {
+        id: 'deepseek-chat',
+        provider: 'deepseek',
+        displayName: 'DeepSeek V3',
+        inputPricePer1M: 0.27,
+        outputPricePer1M: 1.10,
+        contextWindow: 65536,
+        maxOutputTokens: 8192,
+        capabilities: ['code', 'chat', 'reasoning', 'analysis', 'math'],
+        qualityScore: 8,
+        speedScore: 8,
+        costScore: 8,
+    },
+    {
+        id: 'deepseek-reasoner',
+        provider: 'deepseek',
+        displayName: 'DeepSeek R1',
+        inputPricePer1M: 0.55,
+        outputPricePer1M: 2.19,
+        contextWindow: 65536,
+        maxOutputTokens: 8192,
+        capabilities: ['reasoning', 'math', 'code', 'analysis'],
+        qualityScore: 9,
+        speedScore: 5,
+        costScore: 7,
+    },
+];
+// ---- Budget Defaults ----
+function getDefaultBudget() {
+    return {
+        dailyBudget: exports.env.DEFAULT_DAILY_BUDGET,
+        monthlyBudget: exports.env.DEFAULT_MONTHLY_BUDGET,
+        perRequestCap: exports.env.DEFAULT_PER_REQUEST_CAP,
+    };
+}
+// ---- Database Path ----
+function getDbPath() {
+    return path_1.default.resolve(process.cwd(), 'data', 'budgetllm.db');
+}
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+function shouldLog(level) {
+    return LOG_LEVELS[level] >= LOG_LEVELS[exports.env.LOG_LEVEL];
+}
+exports.log = {
+    debug: (msg, data) => {
+        if (shouldLog('debug'))
+            console.debug(`[DEBUG] ${msg}`, data ?? '');
+    },
+    info: (msg, data) => {
+        if (shouldLog('info'))
+            console.info(`[INFO] ${msg}`, data ?? '');
+    },
+    warn: (msg, data) => {
+        if (shouldLog('warn'))
+            console.warn(`[WARN] ${msg}`, data ?? '');
+    },
+    error: (msg, data) => {
+        if (shouldLog('error'))
+            console.error(`[ERROR] ${msg}`, data ?? '');
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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