mozart-router 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ucav
+
+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,250 @@
+# Mozart
+
+[![CI](https://github.com/ucav/mozart-router/actions/workflows/ci.yml/badge.svg)](https://github.com/ucav/mozart-router/actions)
+[![Tests](https://img.shields.io/badge/tests-118%20passed-brightgreen)](https://github.com/ucav/mozart-router)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![Version](https://img.shields.io/badge/version-0.1.0-blue)](https://github.com/ucav/mozart-router)
+
+**Mozart is the local conductor for AI agents** — a gateway-aware routing and orchestration layer that integrates as a skill, tool, adapter or middleware into your existing AI stack.
+
+Mozart detects your available gateways, providers and models, then routes each task to the best option based on cost, context, latency, privacy, quotas and reliability.
+
+```
+Gateways execute. Mozart decides.
+
+Do not rebuild what the gateway already does.
+Detect it, understand it, orchestrate it.
+```
+
+## Why Mozart?
+
+- **Stop choosing models manually.** Mozart classifies your task and picks the best model.
+- **Stop wasting tokens.** Context optimization reduces token usage.
+- **Stop leaking sensitive context.** Privacy Guard prevents secrets from being sent to cloud models.
+- **Stop breaking agent workflows when providers fail.** Automatic fallback chains keep your agents running.
+- **Understand every decision.** Every route comes with a full explanation — why this model, why not the others.
+
+## What Mozart is
+
+- A **skill** callable by OpenClaw, OpenCode, Hermes or custom agents
+- A **tool** that agents can invoke for routing decisions
+- An **adapter** that reads existing gateway configs without duplicating them
+- A **middleware** you can insert between your agent and its gateway
+- A **local SDK** you import into your own TypeScript/Node.js projects
+- A **CLI** for diagnostics, simulation, and reporting
+
+## What Mozart is NOT
+
+- Not a desktop application or separate dashboard
+- Not a replacement for LiteLLM, OpenRouter, or your existing gateways
+- Not a tool that asks you to re-enter all your API keys
+- Not a system that stores or manages keys that gateways already handle
+
+## Quick start
+
+```bash
+git clone https://github.com/ucav/mozart-router.git
+cd mozart-router
+npm install
+npm run build
+
+# Integration-first — detect your existing stack
+npx mozart-router init --gateway opencode
+npx mozart-router init --gateway openclaw
+npx mozart-router init --gateway hermes
+
+# Discover what's already available
+npx mozart-router doctor
+
+# See your full inventory
+npx mozart-router inventory
+
+# Simulate routing before executing
+npx mozart-router simulate "debug my Next.js build error"
+
+# Route a task (recommend-only by default)
+npx mozart-router route "write Playwright tests"
+
+# Understand the decision
+npx mozart-router why
+
+# Session report
+npx mozart-router report
+
+# List available Mozart skills for your agents
+npx mozart-router skills
+```
+
+> Note: until published to npm, use `npm run mozart -- <command>` for local development. The `npx mozart-router` commands will work after `npm publish`.
+
+## Integration modes
+
+### 1. Skill mode — for OpenClaw, OpenCode, Hermes
+
+Copy the skill manifest from `examples/` into your agent:
+
+```bash
+npx mozart-router init --gateway opencode    # → examples/opencode/mozart-skill.json
+npx mozart-router init --gateway openclaw    # → examples/openclaw/mozart-skill.yaml
+npx mozart-router init --gateway hermes      # → examples/hermes/mozart-tool.json
+```
+
+### 2. SDK mode — import into your agent code
+
+```typescript
+import { Mozart, OllamaAdapter, OpenRouterAdapter, OpenClawAdapter } from 'mozart-router';
+
+const mozart = new Mozart();
+
+// Register adapters — Mozart auto-detects each gateway
+mozart.registry.registerAdapter(new OllamaAdapter());
+mozart.registry.registerAdapter(new OpenRouterAdapter());
+mozart.registry.registerAdapter(new OpenClawAdapter());
+
+// Discover all gateways
+await mozart.detectAll();
+
+// Route a task
+const route = await mozart.recommend('write a function to sort an array');
+console.log(route.selectedModel); // e.g. "qwen3:8b"
+
+// Full processing with privacy, cost, explanation
+const response = await mozart.process({
+  input: 'refactor the auth module',
+  budgetMode: 'balanced',
+  privacyMode: 'balanced',
+  executionMode: 'recommend',
+});
+```
+
+### 3. Adapter mode — introspect any gateway
+
+```typescript
+import { OllamaAdapter } from 'mozart-router';
+
+const ollama = new OllamaAdapter();
+const detection = await ollama.detect();
+const models = await ollama.listModels();
+// Build inventory without touching API keys
+```
+
+### 4. Middleware mode — OpenAI-compatible proxy
+
+```bash
+npm run mozart -- proxy --port=4445
+# Point your agent to http://127.0.0.1:4445/v1
+# Mozart routes every chat completion to the best model
+```
+
+### 5. Recommend-only mode — advisory without execution
+
+```typescript
+const recommendation = await mozart.recommend('security audit payment module');
+// Returns: selected model, confidence, cost estimate, explanation
+// No execution — your existing gateway handles the actual call
+```
+
+## Architecture
+
+```
+User / Agent / IDE
+        |
+Mozart Interface (CLI · SDK · Skills · API · Middleware)
+        |
+Gateway Introspection Layer → detects existing configs non-destructively
+        |
+Provider & Model Inventory  → built from detected gateways
+        |
+Task Classifier             → heuristic, local, no LLM needed
+        |
+Policy Engine               → privacy, budget, routing rules
+        |
+Privacy Guard               → scans for secrets, blocks cloud leaks
+        |
+Context Optimizer           → reduces token waste
+        |
+Routing Engine              → 7-dimension scoring per model
+        |
+Explainability              → every decision explained
+        |
+Execution Delegation        → delegates to existing gateway
+        |
+Existing Gateway            → LiteLLM · OpenRouter · Ollama · ...
+```
+
+## Feature matrix
+
+See [docs/FEATURE_MATRIX.md](docs/FEATURE_MATRIX.md) for the complete status of every module.
+
+## Core commands
+
+| Command | Description |
+|---------|-------------|
+| `mozart doctor` | Detect gateways, providers and models |
+| `mozart inventory` | Show full inventory as JSON |
+| `mozart simulate <task>` | Simulate routing for a task |
+| `mozart route <task>` | Route a task (recommend-only) |
+| `mozart why` | Explain the last routing decision |
+| `mozart report` | Show session report |
+| `mozart skills` | List available Mozart skills |
+| `mozart profiles` | List built-in policy profiles |
+| `mozart policy list` | List available policy profiles |
+| `mozart start [--port=4444]` | Start local HTTP API + dashboard |
+| `mozart stream [--port=4445]` | Start streaming middleware (SSE) |
+| `mozart proxy [--port=4445]` | Start OpenAI-compatible middleware |
+| `mozart mcp` | Start MCP server (stdlib) |
+| `mozart config init` | Interactive config generator |
+| `mozart plugins` | List registered plugins |
+| `mozart metrics` | Export metrics (JSON + Prometheus) |
+| `mozart health` | Health check all adapters |
+| `mozart scan-local` | Scan local hardware capabilities |
+| `mozart sync dealsforge` | Load DealsForge provider intelligence |
+| `mozart init --gateway <name>` | Generate integration files |
+| `mozart reset` | Clear all local data |
+
+## Skills
+
+Mozart exposes these skills for agents:
+
+| Skill | Description |
+|-------|-------------|
+| `mozart.route_model` | Choose best model/provider for a task |
+| `mozart.explain_route` | Explain why a model was chosen |
+| `mozart.estimate_cost` | Estimate cost before execution |
+| `mozart.compress_context` | Optimize context for token savings |
+| `mozart.privacy_check` | Scan content for secrets |
+| `mozart.fallback_plan` | Generate fallback execution plan |
+| `mozart.inventory` | Return current inventory |
+
+## Documentation
+
+| Document | Content |
+|----------|---------|
+| [ARCHITECTURE](docs/ARCHITECTURE.md) | System design and module dependencies |
+| [GATEWAY_FIRST_PRINCIPLES](docs/GATEWAY_FIRST_PRINCIPLES.md) | Why Mozart doesn't replace gateways |
+| [FEATURE_MATRIX](docs/FEATURE_MATRIX.md) | Complete feature status |
+| [INTEGRATIONS](docs/INTEGRATIONS.md) | Supported gateways and agents |
+| [ADAPTERS](docs/ADAPTERS.md) | Adapter reference and how to create new ones |
+| [SKILLS_AND_TOOLS](docs/SKILLS_AND_TOOLS.md) | Skill/tool manifest reference |
+| [RECOMMEND_ONLY_MODE](docs/RECOMMEND_ONLY_MODE.md) | How Mozart works without execution |
+| [SECURITY](docs/SECURITY.md) | Security design and privacy guard |
+| [LIMITATIONS](docs/LIMITATIONS.md) | Honest limits and constraints |
+| [ROADMAP](docs/ROADMAP.md) | Development plans |
+
+## Security
+
+- All secrets are redacted in logs (see [SECURITY](docs/SECURITY.md))
+- No API keys are stored or logged
+- Privacy Guard scans content before routing
+- Local-only mode prevents cloud routing
+- No mandatory telemetry
+- All processing is local by default
+- See [reports/SECURITY_AUDIT.md](reports/SECURITY_AUDIT.md) for full audit
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
+
+## License
+
+MIT — see [LICENSE](LICENSE)

package/dist/adapters/cursor.d.ts

@@ -0,0 +1,10 @@
+import { GatewayAdapter, DetectionResult, GatewayConfigSummary, Provider, Model } from '../types';
+export declare class CursorAdapter implements GatewayAdapter {
+    id: string;
+    name: string;
+    detect(): Promise<DetectionResult>;
+    readConfig(): Promise<GatewayConfigSummary>;
+    listProviders(): Promise<Provider[]>;
+    listModels(): Promise<Model[]>;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,QAAQ,EACR,KAAK,EACN,MAAM,UAAU,CAAC;AAElB,qBAAa,aAAc,YAAW,cAAc;IAClD,EAAE,SAAY;IACd,IAAI,SAAY;IAEV,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAgBlC,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAU3C,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIpC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CAGrC"}

package/dist/adapters/cursor.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorAdapter = void 0;
+class CursorAdapter {
+    id = 'cursor';
+    name = 'Cursor';
+    async detect() {
+        return {
+            detected: false,
+            gatewayId: this.id,
+            gatewayName: this.name,
+            status: 'not_found',
+            providersCount: 0,
+            modelsCount: 0,
+            details: [
+                'Cursor adapter is a stub — direct integration depends on Cursor extension API.',
+                'Mozart can be exposed as local endpoint for Cursor to consume.',
+                'Alternatively, use Mozart as advisory layer via CLI or SDK.',
+            ],
+        };
+    }
+    async readConfig() {
+        return {
+            gatewayId: this.id,
+            gatewayName: this.name,
+            providers: [],
+            models: [],
+            capabilities: ['ide', 'coding', 'agent', 'editing'],
+        };
+    }
+    async listProviders() {
+        return [];
+    }
+    async listModels() {
+        return [];
+    }
+}
+exports.CursorAdapter = CursorAdapter;
+//# sourceMappingURL=cursor.js.map

package/dist/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":";;;AAQA,MAAa,aAAa;IACxB,EAAE,GAAG,QAAQ,CAAC;IACd,IAAI,GAAG,QAAQ,CAAC;IAEhB,KAAK,CAAC,MAAM;QACV,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,MAAM,EAAE,WAAW;YACnB,cAAc,EAAE,CAAC;YACjB,WAAW,EAAE,CAAC;YACd,OAAO,EAAE;gBACP,gFAAgF;gBAChF,gEAAgE;gBAChE,6DAA6D;aAC9D;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,EAAE;YACV,YAAY,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;SACpD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AArCD,sCAqCC"}

package/dist/adapters/generic.d.ts

@@ -0,0 +1,24 @@
+import { GatewayAdapter, DetectionResult, Provider, Model, ExecutionTarget, ExecutionRequest, ExecutionResult, RouteDecision } from '../types';
+export interface GenericAdapterConfig {
+    id: string;
+    name: string;
+    baseUrl: string;
+    apiKeyEnv?: string;
+    timeout?: number;
+}
+export declare class GenericOpenAIAdapter implements GatewayAdapter {
+    id: string;
+    name: string;
+    private baseUrl;
+    private apiKeyEnv?;
+    private timeout;
+    constructor(config: GenericAdapterConfig);
+    private headers;
+    detect(): Promise<DetectionResult>;
+    listProviders(): Promise<Provider[]>;
+    listModels(): Promise<Model[]>;
+    getExecutionTarget(decision: RouteDecision): Promise<ExecutionTarget>;
+    execute(request: ExecutionRequest): Promise<ExecutionResult>;
+}
+export declare function discoverAllGenericAdapters(): Promise<GenericOpenAIAdapter[]>;
+//# sourceMappingURL=generic.d.ts.map

package/dist/adapters/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,QAAQ,EACR,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,UAAU,CAAC;AAKlB,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,oBAAqB,YAAW,cAAc;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,oBAAoB;IAQxC,OAAO,CAAC,OAAO;IAQT,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAwClC,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAoBpC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAkC9B,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAYrE,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CA2BnE;AAkBD,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAwBlF"}

package/dist/adapters/generic.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenericOpenAIAdapter = void 0;
+exports.discoverAllGenericAdapters = discoverAllGenericAdapters;
+class GenericOpenAIAdapter {
+    id;
+    name;
+    baseUrl;
+    apiKeyEnv;
+    timeout;
+    constructor(config) {
+        this.id = config.id;
+        this.name = config.name;
+        this.baseUrl = config.baseUrl.replace(/\/+$/, '');
+        this.apiKeyEnv = config.apiKeyEnv;
+        this.timeout = config.timeout ?? 5000;
+    }
+    headers() {
+        const h = { 'Content-Type': 'application/json' };
+        if (this.apiKeyEnv && process.env[this.apiKeyEnv]) {
+            h['Authorization'] = `Bearer ${process.env[this.apiKeyEnv]}`;
+        }
+        return h;
+    }
+    async detect() {
+        const details = [];
+        let modelsCount = 0;
+        let status = 'not_found';
+        try {
+            const response = await fetch(`${this.baseUrl}/v1/models`, {
+                headers: this.headers(),
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (response.ok) {
+                const data = await response.json();
+                const models = data.data ?? [];
+                modelsCount = models.length;
+                status = 'active';
+                details.push(`OpenAI-compatible endpoint detected: ${this.baseUrl}`);
+                details.push(`${modelsCount} models found`);
+                for (const m of models.slice(0, 10)) {
+                    details.push(`  - ${m.id}`);
+                }
+                if (models.length > 10) {
+                    details.push(`  ... and ${models.length - 10} more`);
+                }
+            }
+        }
+        catch (err) {
+            details.push(`No response from ${this.baseUrl}: ${String(err).slice(0, 80)}`);
+        }
+        return {
+            detected: status !== 'not_found',
+            gatewayId: this.id,
+            gatewayName: this.name,
+            status,
+            providersCount: status !== 'not_found' ? 1 : 0,
+            modelsCount,
+            details,
+        };
+    }
+    async listProviders() {
+        const hasKey = this.apiKeyEnv ? !!process.env[this.apiKeyEnv] : true;
+        return [
+            {
+                id: this.id,
+                name: this.name,
+                source: 'detected',
+                gateway: this.id,
+                baseUrl: this.baseUrl,
+                supportsModelsEndpoint: true,
+                supportsStreaming: true,
+                supportsTools: 'unknown',
+                supportsJsonMode: 'unknown',
+                privacyLevel: this.id.includes('local') || this.baseUrl.includes('localhost') || this.baseUrl.includes('127.0.0.1') ? 'local' : 'cloud',
+                status: hasKey ? 'available' : 'limited',
+                lastCheckedAt: new Date().toISOString(),
+            },
+        ];
+    }
+    async listModels() {
+        const models = [];
+        try {
+            const response = await fetch(`${this.baseUrl}/v1/models`, {
+                headers: this.headers(),
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (response.ok) {
+                const data = await response.json();
+                for (const entry of data.data ?? []) {
+                    const isLocal = this.baseUrl.includes('localhost') || this.baseUrl.includes('127.0.0.1');
+                    models.push({
+                        id: entry.id,
+                        providerId: this.id,
+                        gatewayId: this.id,
+                        displayName: entry.id,
+                        family: entry.owned_by,
+                        modality: ['text'],
+                        contextWindow: isLocal ? 8192 : 32768,
+                        latencyClass: isLocal ? 'fast' : 'medium',
+                        qualityClass: 'medium',
+                        strengths: isLocal ? ['local', 'private', 'free'] : ['openai_compatible'],
+                        weaknesses: ['capabilities_unknown'],
+                        privacyLevel: isLocal ? 'local' : 'cloud',
+                        availability: 'available',
+                        sourceConfidence: 'high',
+                        lastCheckedAt: new Date().toISOString(),
+                    });
+                }
+            }
+        }
+        catch { /* no models endpoint */ }
+        return models;
+    }
+    async getExecutionTarget(decision) {
+        return {
+            adapter: this.id,
+            provider: this.id,
+            model: decision.selectedModel,
+            baseUrl: this.baseUrl,
+            requiresApiKey: !!this.apiKeyEnv,
+            apiKeyManagedBy: this.apiKeyEnv ? 'env' : 'none',
+            method: 'direct_http',
+        };
+    }
+    async execute(request) {
+        try {
+            const response = await fetch(`${this.baseUrl}/v1/chat/completions`, {
+                method: 'POST',
+                headers: this.headers(),
+                body: JSON.stringify({
+                    model: request.model,
+                    messages: [{ role: 'user', content: request.input }],
+                    stream: false,
+                }),
+                signal: AbortSignal.timeout(60000),
+            });
+            if (!response.ok) {
+                const errText = await response.text().catch(() => '');
+                return { success: false, error: `${this.name} error ${response.status}: ${errText.slice(0, 200)}`, delegated: false };
+            }
+            const data = await response.json();
+            return {
+                success: true,
+                output: data.choices?.[0]?.message?.content ?? '',
+                tokens: data.usage ? { input: data.usage.prompt_tokens ?? 0, output: data.usage.completion_tokens ?? 0, total: data.usage.total_tokens ?? 0 } : undefined,
+                delegated: false,
+            };
+        }
+        catch (err) {
+            return { success: false, error: `${this.name} execution failed: ${err}`, delegated: false };
+        }
+    }
+}
+exports.GenericOpenAIAdapter = GenericOpenAIAdapter;
+// ── Auto-discovery utility ─────────────────────────────────
+const COMMON_GATEWAY_URLS = [
+    { id: 'ollama-openai', name: 'Ollama (OpenAI endpoint)', url: 'http://localhost:11434/v1' },
+    { id: 'lmstudio', name: 'LM Studio', url: 'http://localhost:1234/v1' },
+    { id: 'vllm-local', name: 'vLLM (local)', url: 'http://localhost:8000/v1' },
+    { id: 'litellm-local', name: 'LiteLLM (local)', url: 'http://localhost:4000/v1' },
+    { id: 'openrouter-generic', name: 'OpenRouter', url: 'https://openrouter.ai/api/v1', apiKeyEnv: 'OPENROUTER_API_KEY' },
+    { id: 'openai-generic', name: 'OpenAI', url: 'https://api.openai.com/v1', apiKeyEnv: 'OPENAI_API_KEY' },
+    { id: 'groq-generic', name: 'Groq', url: 'https://api.groq.com/openai/v1', apiKeyEnv: 'GROQ_API_KEY' },
+    { id: 'together-generic', name: 'Together AI', url: 'https://api.together.xyz/v1', apiKeyEnv: 'TOGETHER_API_KEY' },
+    { id: 'deepseek-generic', name: 'DeepSeek', url: 'https://api.deepseek.com/v1', apiKeyEnv: 'DEEPSEEK_API_KEY' },
+    { id: 'fireworks-generic', name: 'Fireworks', url: 'https://api.fireworks.ai/inference/v1', apiKeyEnv: 'FIREWORKS_API_KEY' },
+    { id: 'mistral-generic', name: 'Mistral', url: 'https://api.mistral.ai/v1', apiKeyEnv: 'MISTRAL_API_KEY' },
+];
+async function discoverAllGenericAdapters() {
+    const discovered = [];
+    const results = await Promise.allSettled(COMMON_GATEWAY_URLS.map(async (entry) => {
+        const adapter = new GenericOpenAIAdapter({
+            id: entry.id,
+            name: entry.name,
+            baseUrl: entry.url,
+            apiKeyEnv: entry.apiKeyEnv,
+            timeout: 3000,
+        });
+        const detection = await adapter.detect();
+        if (detection.detected)
+            return adapter;
+        return null;
+    }));
+    for (const result of results) {
+        if (result.status === 'fulfilled' && result.value) {
+            discovered.push(result.value);
+        }
+    }
+    return discovered;
+}
+//# sourceMappingURL=generic.js.map

package/dist/adapters/generic.js.map

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

package/dist/adapters/hermes.d.ts

@@ -0,0 +1,10 @@
+import { GatewayAdapter, DetectionResult, GatewayConfigSummary, Provider, Model } from '../types';
+export declare class HermesAdapter implements GatewayAdapter {
+    id: string;
+    name: string;
+    detect(): Promise<DetectionResult>;
+    readConfig(): Promise<GatewayConfigSummary>;
+    listProviders(): Promise<Provider[]>;
+    listModels(): Promise<Model[]>;
+}
+//# sourceMappingURL=hermes.d.ts.map

package/dist/adapters/hermes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../../src/adapters/hermes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,QAAQ,EACR,KAAK,EACN,MAAM,UAAU,CAAC;AAkBlB,qBAAa,aAAc,YAAW,cAAc;IAClD,EAAE,SAAY;IACd,IAAI,SAAkB;IAEhB,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAgDlC,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAQ3C,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAqBpC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CAoCrC"}