mythos-router 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.2.1]
+
+### Added
+- **Multi-Provider Orchestration Engine** — Decoupled the core application from the Anthropic SDK. The system now supports fallback routing, adaptive watchdogs, circuit breakers, and EMA-based performance scoring across multiple providers.
+- **OpenAI & DeepSeek Support** — Added a native, zero-dependency `fetch`-based provider (`OpenAIProvider`) to seamlessly support OpenAI and DeepSeek endpoints (including streaming reasoning content for `o1` and `DeepSeek-R1`).
+- **Skills Protocol** — Modular expert plugins via zero-dependency YAML frontmatter parsing. Skills (`-s <skill>`) can inject customized instructions, modify budget multipliers, and enforce deterministic provider selection.
+- **Deterministic Response Caching** — SQLite-backed response caching for pure-reasoning requests (like `verify` or `dream`). Bypass rule strictly ensures file-mutating responses are never cached.
+- **Centralized Pricing Registry** — Unified token cost calculator across different providers, feeding exact financial data into the budget metrics.
+- **Auto-Healing TDD Loop** — Bounded, error-driven autonomy. Passing `--test-cmd` will automatically execute tests after a successful SWD mutation. If tests fail, the CLI intercepts `stderr`, truncates it, identifies TS/Runtime issues, and feeds it back to Claude for a self-healing iteration.
+- **TDD Anti-Thrashing Guards** — The orchestrator will automatically abort the healing loop if Claude attempts the exact same fix or if output remains identically broken, preventing runaway API costs.
+- **Contributor Covenant** — Added `CODE_OF_CONDUCT.md` to formally establish community standards.
+
+### Security
+- **CodeQL Integration** — Added GitHub CodeQL scanning badge to `README.md`.
+- **Dependency Audit** — Triaged and validated false-positive Socket.dev supply chain alerts for `@anthropic-ai/sdk`.
+
+---
 ## [1.2.0] — 2026-04-23
 
 ### Added
@@ -137,9 +154,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Correction Turns** — max 2 retries before yielding to human.
 - **Dream/Verify Commands** — memory compression and drift detection.
 
-[1.1.6]: https://github.com/thewaltero/mythos-router/compare/v1.1.3...v1.1.6
-[1.1.3]: https://github.com/thewaltero/mythos-router/compare/v1.1.2...v1.1.3
-[1.1.2]: https://github.com/thewaltero/mythos-router/compare/v1.1.1...v1.1.2
-[1.1.1]: https://github.com/thewaltero/mythos-router/compare/v1.1.0...v1.1.1
-[1.1.0]: https://github.com/thewaltero/mythos-router/compare/v1.0.0...v1.1.0
+
+[1.2.1]: https://github.com/thewaltero/mythos-router/releases/tag/v1.2.1
+[1.2.0]: https://github.com/thewaltero/mythos-router/releases/tag/v1.2.0
+[1.1.9]: https://github.com/thewaltero/mythos-router/releases/tag/v1.1.9
+[1.1.8]: https://github.com/thewaltero/mythos-router/releases/tag/v1.1.8
+[1.1.7]: https://github.com/thewaltero/mythos-router/releases/tag/v1.1.7
+[1.1.6]: https://github.com/thewaltero/mythos-router/releases/tag/v1.1.6
+[1.1.3]: https://github.com/thewaltero/mythos-router/releases/tag/v1.1.3
+[1.1.2]: https://github.com/thewaltero/mythos-router/releases/tag/v1.1.2
+[1.1.1]: https://github.com/thewaltero/mythos-router/releases/tag/v1.1.1
+[1.1.0]: https://github.com/thewaltero/mythos-router/releases/tag/v1.1.0
 [1.0.0]: https://github.com/thewaltero/mythos-router/releases/tag/v1.0.0

package/README.md

@@ -1,6 +1,7 @@
 <div align="center">
 <img src="assets/banner.png" alt="Mythos Router Banner" width="864" />
 
+[![CodeQL](https://github.com/thewaltero/mythos-router/actions/workflows/github-code-scanning/codeql/badge.svg?branch=main)](https://github.com/thewaltero/mythos-router/actions/workflows/github-code-scanning/codeql)
 [![npm](https://img.shields.io/npm/v/mythos-router?style=flat-square&color=cc785c)](https://www.npmjs.com/package/mythos-router)
 [![Node.js](https://img.shields.io/badge/Node.js-20+-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://typescriptlang.org)
@@ -12,6 +13,11 @@
 ## Claude Opus 4.7 · Strict Write Discipline · Zero Slop
 **A local CLI power tool for verifiable AI-assisted coding.**
 
+<br />
+
+[What is this?](#what-is-this) • [Features](#features) • [Installation](#installation) • [Usage](#usage) • [Architecture](#architecture) • [Token Budget](#token-usage--budget) • [SDK](#-sdk-usage-for-agentic-systems)
+
+
 ---
 
 ### Support the project
@@ -47,9 +53,13 @@ Zero slop. Zero hallucinated state. Full adaptive thinking.
 
 | Feature | Description |
 |---------|-------------|
+|  **Multi-Provider Fallback** | Auto-routes between Anthropic, DeepSeek, and OpenAI with circuit breakers |
+|  **Skills Protocol** | Inject modular expert plugins via YAML frontmatter (`-s mcp`, `-s react`) |
+|  **Deterministic Caching** | SQLite-backed caching for zero-cost, zero-latency repetitive reasoning |
 |  **Adaptive Thinking** | Opus 4.7 with configurable effort levels (high/medium/low) |
 |  **Strict Write Discipline** | Pre/post filesystem snapshots verify every model claim |
 |  **Self-Healing Memory** | Authority-based logging with a rebuildable SQLite FTS5 search index |
+|  **Auto-Healing TDD** | Pass `--test-cmd` for bounded, error-driven autonomous repair loops |
 |  **Correction Turns** | Model gets 2 retries to match filesystem reality, then yields |
 |  **Integrity Gate** | `verify` command and startup hashing ensure zero drift |
 |  **Token Limiter** | Budget cap with graceful save — progress saved to MEMORY.md, never lose work |
@@ -91,9 +101,10 @@ As memory approaches capacity, the `dream` command delegates a compression phase
 # Install globally
 npm install -g mythos-router
 
-# Set your API key
+# Set your API keys (Anthropic is primary, others are fallbacks)
 export ANTHROPIC_API_KEY="sk-ant-..."
-# Windows: $env:ANTHROPIC_API_KEY = "sk-ant-..."
+export OPENAI_API_KEY="sk-proj-..."
+export DEEPSEEK_API_KEY="sk-..."
 
 # Go
 mythos chat
@@ -122,6 +133,8 @@ npm run chat
 
 ```bash
 mythos chat                  # Full power (high effort, Opus 4.7)
+mythos chat -s react         # Load the 'react' expert skill
+mythos chat --test-cmd "npm test" # Enable autonomous test-driven self-healing
 mythos chat --effort low     # Budget mode (Haiku 3)
 mythos chat --effort medium  # Balanced (Sonnet 3.5)
 mythos chat --dry-run        # Preview all file changes before executing
@@ -270,6 +283,12 @@ mythos-router/
 │       ├── verify.ts    # Codebase ↔ Memory scanner (dry-run aware)
 │       ├── dream.ts     # Memory compression (dry-run aware)
 │       └── stats.ts     # Budget analytics reporter
+├── src/providers/       # Multi-Provider Orchestration Engine
+│   ├── orchestrator.ts  # Adaptive routing, circuit breakers, scoring
+│   ├── pricing.ts       # Centralized token cost registry
+│   ├── types.ts         # Unified BaseProvider contracts
+│   ├── anthropic.ts     # Claude provider
+│   └── openai.ts        # Fetch-based OpenAI & DeepSeek provider
 ├── test/                # Automated test suite (node:test)
 ├── .mythosignore        # SWD scan exclusions
 ├── MEMORY.md            # Auto-generated agentic memory
@@ -317,7 +336,9 @@ If you prefer to keep it private, add `MEMORY.md` to your `.gitignore`.
 
 | Env Variable | Required | Description |
 |-------------|----------|-------------|
-| `ANTHROPIC_API_KEY` | ✅ | Your Anthropic API key |
+| `ANTHROPIC_API_KEY` | ✅ | Your Anthropic API key (Primary Provider) |
+| `OPENAI_API_KEY` | ❌ | OpenAI API Key (Fallback Provider) |
+| `DEEPSEEK_API_KEY` | ❌ | DeepSeek API Key (Fallback Provider, reasoning capable) |
 
 | File | Purpose |
 |------|---------| 

package/dist/cache.d.ts

@@ -0,0 +1,28 @@
+import type { UnifiedResponse } from './providers/types.js';
+export interface CacheKeyInput {
+    model: string;
+    systemPrompt: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+}
+export declare function generateCacheKey(input: CacheKeyInput): string;
+export declare class ResponseCache {
+    private db;
+    private ttlMs;
+    private enabled;
+    constructor(ttlMs?: number, enabled?: boolean);
+    private ensureDb;
+    get(key: string): UnifiedResponse | null;
+    set(key: string, response: UnifiedResponse, model: string): void;
+    evictExpired(): number;
+    clear(): void;
+    stats(): {
+        entries: number;
+        totalHits: number;
+        oldestMs: number;
+    };
+    close(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA4B5D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAG7D;AAGD,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAwE;IAClF,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAU;gBAEb,KAAK,GAAE,MAAuB,EAAE,OAAO,GAAE,OAAc;IAMnE,OAAO,CAAC,QAAQ;IAgChB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IA0BxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBhE,YAAY,IAAI,MAAM;IActB,KAAK,IAAI,IAAI;IAYb,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAoBjE,KAAK,IAAI,IAAI;CAMd"}

package/dist/cache.js

@@ -0,0 +1,169 @@
+// ─────────────────────────────────────────────────────────────
+//  mythos-router :: cache.ts
+//  Deterministic Response Cache — SQLite-backed
+//
+//  Rules:
+//  - Cache is DISABLED for `chat` (external state changes)
+//  - Cache is ACTIVE for `verify` and `dream` (pure reasoning)
+//  - Tool invocations BYPASS the cache entirely
+//  - Keys use canonical JSON (sorted keys) + SHA-256
+//  - TTL-based expiration (default: 1 hour)
+// ─────────────────────────────────────────────────────────────
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { createHash } from 'node:crypto';
+// ── Constants ────────────────────────────────────────────────
+const CACHE_DIR = path.join(os.homedir(), '.mythos-router');
+const CACHE_DB_FILE = path.join(CACHE_DIR, 'cache.db');
+const DEFAULT_TTL_MS = 60 * 60 * 1000; // 1 hour
+// ── Canonical JSON Stringify (sorted keys) ───────────────────
+// Ensures identical objects always produce the same string,
+// regardless of key insertion order.
+function canonicalStringify(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return JSON.stringify(obj);
+    }
+    if (Array.isArray(obj)) {
+        return '[' + obj.map(item => canonicalStringify(item)).join(',') + ']';
+    }
+    const sorted = Object.keys(obj).sort();
+    const pairs = sorted.map(key => {
+        const val = obj[key];
+        return `${JSON.stringify(key)}:${canonicalStringify(val)}`;
+    });
+    return '{' + pairs.join(',') + '}';
+}
+export function generateCacheKey(input) {
+    const payload = canonicalStringify(input);
+    return createHash('sha256').update(payload).digest('hex');
+}
+// ── Response Cache ───────────────────────────────────────────
+export class ResponseCache {
+    db = null;
+    ttlMs;
+    enabled;
+    constructor(ttlMs = DEFAULT_TTL_MS, enabled = true) {
+        this.ttlMs = ttlMs;
+        this.enabled = enabled;
+    }
+    // ── Lazy Initialization ──────────────────────────────────
+    ensureDb() {
+        if (this.db)
+            return this.db;
+        // Dynamic import to avoid crash if sqlite is unavailable
+        try {
+            const { DatabaseSync } = require('node:sqlite');
+            if (!fs.existsSync(CACHE_DIR)) {
+                fs.mkdirSync(CACHE_DIR, { recursive: true });
+            }
+            this.db = new DatabaseSync(CACHE_DB_FILE);
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS cache_entries (
+          key TEXT PRIMARY KEY,
+          response TEXT NOT NULL,
+          model TEXT NOT NULL,
+          created_at INTEGER NOT NULL,
+          hit_count INTEGER DEFAULT 0
+        );
+        CREATE INDEX IF NOT EXISTS idx_cache_created ON cache_entries(created_at);
+      `);
+            return this.db;
+        }
+        catch {
+            // SQLite not available — cache is a no-op
+            this.enabled = false;
+            throw new Error('SQLite not available for caching');
+        }
+    }
+    // ── Get cached response ──────────────────────────────────
+    get(key) {
+        if (!this.enabled)
+            return null;
+        try {
+            const db = this.ensureDb();
+            const now = Date.now();
+            const cutoff = now - this.ttlMs;
+            const stmt = db.prepare('SELECT response, created_at FROM cache_entries WHERE key = ? AND created_at > ?');
+            const row = stmt.get(key, cutoff);
+            if (!row)
+                return null;
+            // Update hit count
+            db.prepare('UPDATE cache_entries SET hit_count = hit_count + 1 WHERE key = ?').run(key);
+            return JSON.parse(row.response);
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── Store response in cache ──────────────────────────────
+    // INVARIANT: Responses with tool calls are NEVER cached.
+    set(key, response, model) {
+        if (!this.enabled)
+            return;
+        // Tool Invocation Bypass — never cache responses with tool calls
+        if (response.toolCalls.length > 0)
+            return;
+        try {
+            const db = this.ensureDb();
+            const serialized = JSON.stringify(response);
+            db.prepare('INSERT OR REPLACE INTO cache_entries (key, response, model, created_at, hit_count) VALUES (?, ?, ?, ?, 0)').run(key, serialized, model, Date.now());
+        }
+        catch {
+            // Fail silently — caching is non-critical
+        }
+    }
+    // ── Evict expired entries ────────────────────────────────
+    evictExpired() {
+        if (!this.enabled)
+            return 0;
+        try {
+            const db = this.ensureDb();
+            const cutoff = Date.now() - this.ttlMs;
+            const result = db.prepare('DELETE FROM cache_entries WHERE created_at <= ?').run(cutoff);
+            return result.changes ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ── Clear entire cache ───────────────────────────────────
+    clear() {
+        if (!this.enabled)
+            return;
+        try {
+            const db = this.ensureDb();
+            db.prepare('DELETE FROM cache_entries').run();
+        }
+        catch {
+            // Fail silently
+        }
+    }
+    // ── Stats ────────────────────────────────────────────────
+    stats() {
+        if (!this.enabled)
+            return { entries: 0, totalHits: 0, oldestMs: 0 };
+        try {
+            const db = this.ensureDb();
+            const countRow = db.prepare('SELECT COUNT(*) as cnt FROM cache_entries').get();
+            const hitsRow = db.prepare('SELECT COALESCE(SUM(hit_count), 0) as total FROM cache_entries').get();
+            const oldestRow = db.prepare('SELECT MIN(created_at) as oldest FROM cache_entries').get();
+            return {
+                entries: countRow.cnt,
+                totalHits: hitsRow.total,
+                oldestMs: oldestRow.oldest ? Date.now() - oldestRow.oldest : 0,
+            };
+        }
+        catch {
+            return { entries: 0, totalHits: 0, oldestMs: 0 };
+        }
+    }
+    // ── Close ────────────────────────────────────────────────
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/cli.js

@@ -14,7 +14,7 @@ program
     .name('mythos')
     .description('Capybara-tier CLI router — Claude Opus 4.7 with Adaptive Thinking, ' +
     'Strict Write Discipline, and Self-Healing Memory.')
-    .version('1.2.0');
+    .version('1.2.1');
 // ── mythos chat ──────────────────────────────────────────────
 program
     .command('chat')
@@ -26,6 +26,9 @@ program
     .option('--dry-run', 'Preview all file operations without executing them')
     .option('--verbose', 'Show detailed SWD traces and memory operations')
     .option('-b, --branch <name>', 'Run session in a new git branch for sandboxed reasoning')
+    .option('-t, --test-cmd <cmd>', 'Command to run after successful SWD execution (WARNING: assumes a trusted environment and executes arbitrary shell commands)')
+    .option('--max-test-retries <n>', 'Maximum number of times Claude can attempt to fix failing tests', '3')
+    .option('-s, --skill <names...>', 'Inject specific expert skills (e.g., -s mcp -s react)')
     .action(async (options) => {
     await chatCommand(options);
 });

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -1,17 +1,30 @@
-import Anthropic from '@anthropic-ai/sdk';
+import { ProviderOrchestrator } from './providers/orchestrator.js';
 import { type EffortLevel } from './config.js';
-export interface Message {
-    role: 'user' | 'assistant';
-    content: string;
-}
+export type { Message } from './providers/types.js';
 export interface MythosResponse {
     thinking: string;
     text: string;
     inputTokens: number;
     outputTokens: number;
+    /** Provider metadata (new — optional for backward compat) */
+    _orchestration?: {
+        providerId: string;
+        modelId: string;
+        fallbackTriggered: boolean;
+        incomplete: boolean;
+        latencyMs: number;
+    };
 }
+export declare function getOrchestrator(): ProviderOrchestrator;
+import Anthropic from '@anthropic-ai/sdk';
 export declare function getClient(): Anthropic;
-export declare function streamMessage(messages: Message[], effort?: EffortLevel, onThinkingDelta?: (text: string) => void, onTextDelta?: (text: string) => void): Promise<MythosResponse>;
-export declare function sendMessage(messages: Message[], effort?: EffortLevel, systemOverride?: string): Promise<MythosResponse>;
+export declare function streamMessage(messages: {
+    role: 'user' | 'assistant';
+    content: string;
+}[], effort?: EffortLevel, onThinkingDelta?: (text: string) => void, onTextDelta?: (text: string) => void): Promise<MythosResponse>;
+export declare function sendMessage(messages: {
+    role: 'user' | 'assistant';
+    content: string;
+}[], effort?: EffortLevel, systemOverride?: string): Promise<MythosResponse>;
 export declare function formatTokenUsage(resp: MythosResponse): string;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAiBrB,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD,wBAAgB,SAAS,IAAI,SAAS,CAMrC;AAoBD,wBAAsB,aAAa,CACjC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,GAAE,WAAoB,EAC5B,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACxC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACnC,OAAO,CAAC,cAAc,CAAC,CAmDzB;AAGD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,GAAE,WAAmB,EAC3B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,CAoCzB;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAO7D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAIrB,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,cAAc,CAAC,EAAE;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAKD,wBAAgB,eAAe,IAAI,oBAAoB,CAyCtD;AAGD,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,wBAAgB,SAAS,IAAI,SAAS,CAMrC;AAoBD,wBAAsB,aAAa,CACjC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3D,MAAM,GAAE,WAAoB,EAC5B,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACxC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACnC,OAAO,CAAC,cAAc,CAAC,CAYzB;AAGD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3D,MAAM,GAAE,WAAmB,EAC3B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,CAUzB;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAe7D"}

package/dist/client.js

@@ -1,11 +1,51 @@
 // ─────────────────────────────────────────────────────────────
 //  mythos-router :: client.ts
-//  Anthropic SDK client with adaptive thinking
+//  Backward-compatible facade over the Provider Orchestrator
+//
+//  This file preserves the original API surface so that existing
+//  consumers (chat.ts, dream.ts, verify.ts, SDK users) continue
+//  to work without changes. Under the hood, it delegates to the
+//  ProviderOrchestrator for retry, fallback, and scoring.
 // ─────────────────────────────────────────────────────────────
-import Anthropic from '@anthropic-ai/sdk';
-import { MODELS, CAPYBARA_SYSTEM_PROMPT, validateApiKey, } from './config.js';
+import { AnthropicProvider } from './providers/anthropic.js';
+import { OpenAIProvider } from './providers/openai.js';
+import { ProviderOrchestrator } from './providers/orchestrator.js';
+import { CAPYBARA_SYSTEM_PROMPT, validateApiKey, getOpenAIKey, getDeepSeekKey, } from './config.js';
 import { c } from './utils.js';
-// ── Client Factory ───────────────────────────────────────────
+// ── Singleton Orchestrator ───────────────────────────────────
+let _orchestrator = null;
+export function getOrchestrator() {
+    if (!_orchestrator) {
+        const apiKey = validateApiKey();
+        _orchestrator = new ProviderOrchestrator();
+        // Primary: Anthropic (always registered)
+        _orchestrator.registerProvider(new AnthropicProvider(apiKey), { priority: 0 });
+        // Fallback: OpenAI (if OPENAI_API_KEY is set)
+        const openaiKey = getOpenAIKey();
+        if (openaiKey) {
+            _orchestrator.registerProvider(new OpenAIProvider({
+                id: 'openai',
+                apiKey: openaiKey,
+                baseUrl: 'https://api.openai.com/v1',
+                defaultModel: 'gpt-4o',
+            }), { priority: 1 });
+        }
+        // Fallback: DeepSeek (if DEEPSEEK_API_KEY is set)
+        const deepseekKey = getDeepSeekKey();
+        if (deepseekKey) {
+            _orchestrator.registerProvider(new OpenAIProvider({
+                id: 'deepseek',
+                apiKey: deepseekKey,
+                baseUrl: 'https://api.deepseek.com/v1',
+                defaultModel: 'deepseek-chat',
+                supportsThinking: true,
+            }), { priority: 2 });
+        }
+    }
+    return _orchestrator;
+}
+// ── Legacy getClient() (for direct SDK access if needed) ─────
+import Anthropic from '@anthropic-ai/sdk';
 let _client = null;
 export function getClient() {
     if (!_client) {
@@ -14,113 +54,56 @@ export function getClient() {
     }
     return _client;
 }
-// ── Input Validation ─────────────────────────────────────────
-function sanitizeMessages(messages) {
-    return messages.map((m, i) => {
-        if (m.role !== 'user' && m.role !== 'assistant') {
-            throw new Error(`Invalid role at message[${i}]: ${String(m.role)}`);
-        }
-        if (typeof m.content !== 'string') {
-            throw new Error(`Message[${i}] content must be a string`);
-        }
-        const trimmed = m.content.trim();
-        if (trimmed.length === 0) {
-            throw new Error(`Empty message content at message[${i}]`);
-        }
-        return { role: m.role, content: trimmed };
-    });
-}
-// ── Streaming Message ────────────────────────────────────────
-export async function streamMessage(messages, effort = 'high', onThinkingDelta, onTextDelta) {
-    const client = getClient();
-    const apiMessages = sanitizeMessages(messages);
-    let thinkingText = '';
-    let responseText = '';
-    let inputTokens = 0;
-    let outputTokens = 0;
-    let stream;
-    try {
-        stream = await client.messages.stream({
-            model: MODELS[effort],
-            max_tokens: 16384,
-            thinking: { type: 'adaptive' },
-            output_config: { effort },
-            system: CAPYBARA_SYSTEM_PROMPT,
-            messages: apiMessages,
-        });
-    }
-    catch (err) {
-        throw new Error(`Failed to start stream: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    try {
-        for await (const event of stream) {
-            if (event.type === 'content_block_delta') {
-                const delta = event.delta;
-                if (delta.type === 'thinking_delta') {
-                    thinkingText += delta.thinking;
-                    onThinkingDelta?.(delta.thinking);
-                }
-                else if (delta.type === 'text_delta') {
-                    responseText += delta.text;
-                    onTextDelta?.(delta.text);
-                }
-            }
-        }
-    }
-    catch (err) {
-        throw new Error(`Stream interrupted: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    const finalMessage = await stream.finalMessage();
-    inputTokens = finalMessage.usage?.input_tokens ?? 0;
-    outputTokens = finalMessage.usage?.output_tokens ?? 0;
+// ── Convert UnifiedResponse → MythosResponse ─────────────────
+function toMythosResponse(unified) {
     return {
-        thinking: thinkingText,
-        text: responseText,
-        inputTokens,
-        outputTokens,
+        thinking: unified.thinking,
+        text: unified.text,
+        inputTokens: unified.usage.inputTokens,
+        outputTokens: unified.usage.outputTokens,
+        _orchestration: {
+            providerId: unified.metadata.providerId,
+            modelId: unified.metadata.modelId,
+            fallbackTriggered: unified.metadata.fallbackTriggered,
+            incomplete: unified.metadata.incomplete,
+            latencyMs: unified.usage.latencyMs,
+        },
     };
 }
-// ── Non-streaming Message (for Dream/Verify) ─────────────────
+// ── Streaming Message (backward-compatible API) ──────────────
+export async function streamMessage(messages, effort = 'high', onThinkingDelta, onTextDelta) {
+    const orchestrator = getOrchestrator();
+    const unified = await orchestrator.streamMessage(messages, {
+        systemPrompt: CAPYBARA_SYSTEM_PROMPT,
+        maxTokens: 16384,
+        effort,
+        onThinkingDelta,
+        onTextDelta,
+    });
+    return toMythosResponse(unified);
+}
+// ── Non-streaming Message (backward-compatible API) ──────────
 export async function sendMessage(messages, effort = 'low', systemOverride) {
-    const client = getClient();
-    const apiMessages = sanitizeMessages(messages);
-    let response;
-    try {
-        response = await client.messages.create({
-            model: MODELS[effort],
-            max_tokens: 8192,
-            thinking: { type: 'adaptive' },
-            output_config: { effort },
-            system: systemOverride ?? CAPYBARA_SYSTEM_PROMPT,
-            messages: apiMessages,
-        });
-    }
-    catch (err) {
-        throw new Error(`API request failed: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    let thinkingText = '';
-    let responseText = '';
-    for (const block of response.content) {
-        if (block.type === 'thinking') {
-            const thinkingBlock = block;
-            thinkingText += thinkingBlock.thinking ?? '';
-        }
-        else if (block.type === 'text') {
-            responseText += block.text;
-        }
-    }
-    return {
-        thinking: thinkingText,
-        text: responseText,
-        inputTokens: response.usage?.input_tokens ?? 0,
-        outputTokens: response.usage?.output_tokens ?? 0,
-    };
+    const orchestrator = getOrchestrator();
+    const unified = await orchestrator.sendMessage(messages, {
+        systemPrompt: systemOverride ?? CAPYBARA_SYSTEM_PROMPT,
+        maxTokens: 8192,
+        effort,
+    });
+    return toMythosResponse(unified);
 }
 // ── Token cost display ───────────────────────────────────────
 export function formatTokenUsage(resp) {
     const total = resp.inputTokens + resp.outputTokens;
+    const providerInfo = resp._orchestration
+        ? ` ${c.dim}via ${c.cyan}${resp._orchestration.providerId}${c.dim}/${resp._orchestration.modelId}${c.reset}`
+        : '';
+    const fallbackInfo = resp._orchestration?.fallbackTriggered
+        ? ` ${c.yellow}(fallback)${c.reset}`
+        : '';
     return (`${c.dim}tokens: ${c.cyan}${resp.inputTokens.toLocaleString()}${c.dim} in · ` +
         `${c.cyan}${resp.outputTokens.toLocaleString()}${c.dim} out · ` +
-        `${c.yellow}${total.toLocaleString()}${c.dim} total${c.reset}`);
+        `${c.yellow}${total.toLocaleString()}${c.dim} total${c.reset}` +
+        providerInfo + fallbackInfo);
 }
 //# sourceMappingURL=client.js.map