adaptive-memory-multi-model-router 2.2.6 → 2.2.8

package/dist/routing/advancedRouter.js

@@ -1,336 +1,453 @@
 "use strict";
 /**
- * TMLPD Advanced Routing - RouteLLM Style
- *
- * Learned routing based on arXiv:2404.06035 (RouteLLM)
- * Balances cost-quality tradeoff with confidence-based model selection
+ * A3M Router - Generic Adaptive Routing (RouteLLM Style)
+ * 
+ * Routes queries to the best available LLM based on:
+ * - Query features (code, math, creative, etc.)
+ * - Provider availability (checks API keys)
+ * - Cost optimization
+ * - Quality vs speed tradeoff
+ * 
+ * All provider references are dynamically loaded from providerConfig.
+ * Users can add/remove providers via environment variables or config files.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MODEL_PROFILES = void 0;
-exports.extractQueryFeatures = extractQueryFeatures;
-exports.routeQuery = routeQuery;
-exports.routeBatch = routeBatch;
-exports.recommendForTask = recommendForTask;
-exports.updateModelProfile = updateModelProfile;
+
+const { getAvailableProviders } = require("../providers/providerConfig");
 const tokenUtils_1 = require("../utils/tokenUtils");
-// Pre-configured model profiles
-exports.MODEL_PROFILES = {
-    "openai/gpt-4o": {
-        name: "openai/gpt-4o",
-        provider: "openai",
-        cost_per_1k_input: 2.50,
-        cost_per_1k_output: 10.00,
-        latency_ms: 2000,
-        quality_score: 0.95,
-        strengths: ["reasoning", "coding", "analysis"],
-        context_window: 128000
-    },
-    "openai/gpt-4o-mini": {
-        name: "openai/gpt-4o-mini",
-        provider: "openai",
-        cost_per_1k_input: 0.15,
-        cost_per_1k_output: 0.60,
-        latency_ms: 500,
-        quality_score: 0.85,
-        strengths: ["fast", "coding"],
-        context_window: 128000
-    },
-    "anthropic/claude-3.5-sonnet": {
-        name: "anthropic/claude-3.5-sonnet",
-        provider: "anthropic",
-        cost_per_1k_input: 3.00,
-        cost_per_1k_output: 15.00,
-        latency_ms: 2500,
-        quality_score: 0.96,
-        strengths: ["reasoning", "creative", "analysis"],
-        context_window: 200000
-    },
-    "anthropic/claude-3-haiku": {
-        name: "anthropic/claude-3-haiku",
-        provider: "anthropic",
-        cost_per_1k_input: 0.25,
-        cost_per_1k_output: 1.25,
-        latency_ms: 500,
-        quality_score: 0.80,
-        strengths: ["fast", "simple"],
-        context_window: 200000
+
+// ============================================================
+// DYNAMIC MODEL PROFILES (built from available providers)
+// ============================================================
+
+function buildModelProfiles() {
+  const profiles = {};
+  const available = getAvailableProviders();
+  
+  for (const [providerId, provider] of Object.entries(available)) {
+    for (const model of provider.models) {
+      const modelKey = model.includes('/') ? model : providerId + '/' + model;
+      const costPerKInput = provider.costPerK ? provider.costPerK.input : 0;
+      const costPerKOutput = provider.costPerK ? provider.costPerK.output : 0;
+      
+      // Assign strengths based on model characteristics
+      const strengths = [];
+      if (provider.type === 'cli') {
+        strengths.push('free', 'local');
+      }
+      if (costPerKInput < 0.3) {
+        strengths.push('budget', 'fast');
+      } else if (costPerKInput > 2) {
+        strengths.push('premium', 'reasoning');
+      }
+      if (provider.name === 'Mistral' || provider.name === 'Groq' || provider.name === 'Cerebras') {
+        strengths.push('fast', 'coding');
+      }
+      if (provider.name === 'CommandCode') {
+        strengths.push('code-aware', 'context-rich');
+      }
+      if (provider.name === 'OpenCode') {
+        strengths.push('free', 'multi-model');
+      }
+      if (provider.name === 'Google') {
+        strengths.push('multilingual', 'long-context');
+      }
+      if (provider.name === 'OpenAI') {
+        strengths.push('reasoning', 'coding', 'analysis');
+      }
+      if (provider.name === 'Anthropic') {
+        strengths.push('reasoning', 'creative', 'analysis');
+      }
+      
+      profiles[modelKey] = {
+        name: modelKey,
+        provider: providerId,
+        providerName: provider.name,
+        cost_per_1k_input: costPerKInput,
+        cost_per_1k_output: costPerKOutput,
+        latency_ms: provider.type === 'cli' ? 5000 : (provider.priority * 200 + 300),
+        quality_score: strengths.includes('premium') ? 0.95 : 
+                       strengths.includes('reasoning') ? 0.90 : 
+                       strengths.includes('fast') ? 0.82 : 0.80,
+        strengths,
+        context_window: provider.maxTokens || 8192,
+        type: provider.type,
+        priority: provider.priority,
+      };
+    }
+  }
+  
+  return profiles;
+}
+
+let MODEL_PROFILES = buildModelProfiles();
+
+// Refresh profiles when providers change
+function refreshModelProfiles() {
+  MODEL_PROFILES = buildModelProfiles();
+}
+
+exports.MODEL_PROFILES = MODEL_PROFILES;
+
+// ============================================================
+// FEATURE EXTRACTION (v3 — multi-signal complexity scorer)
+// ============================================================
+
+function extractQueryFeatures(prompt) {
+  const lower = prompt.toLowerCase();
+  const words = prompt.split(/\s+/);
+  const wordCount = words.length;
+  
+  // === SIGNAL 1: Domain Detection ===
+  // Professional domains that indicate expert-level queries
+  const domainSignals = {
+    legal: {
+      keywords: ['legal', 'law', 'contract', 'liability', 'litigation', 'patent', 'copyright',
+                  'regulation', 'compliance', 'constitutional', 'statute', 'jurisdiction',
+                  'court', 'ruling', 'precedent', 'attorney', 'amicus', 'sec ', 'fda ',
+                  'gdpr', 'ccpa', 'cfpr', 'due diligence', 'merger', 'acquisition',
+                  '10-k', 'sec filing', 'forensic', 'embezzlement', 'infringement'],
+      weight: 0.35
     },
-    "google/gemini-2.0-flash": {
-        name: "google/gemini-2.0-flash",
-        provider: "google",
-        cost_per_1k_input: 0.00, // Free
-        cost_per_1k_output: 0.00,
-        latency_ms: 800,
-        quality_score: 0.88,
-        strengths: ["fast", "multilingual"],
-        context_window: 1000000
+    medical: {
+      keywords: ['clinical', 'medical', 'pharmaceutical', 'oncology', 'drug', 'trial protocol',
+                  'diagnosis', 'treatment', 'epidemiolog', 'genome', 'cohort study',
+                  'biomarker', 'efficacy', 'pharmacoeconomic', 'biologic', 'vaccine',
+                  'sepsis', 'ehr ', 'surgical', 'patient safety', 'fda approval'],
+      weight: 0.35
     },
-    "google/gemini-1.5-pro": {
-        name: "google/gemini-1.5-pro",
-        provider: "google",
-        cost_per_1k_input: 1.25,
-        cost_per_1k_output: 5.00,
-        latency_ms: 1500,
-        quality_score: 0.92,
-        strengths: ["reasoning", "long-context"],
-        context_window: 2000000
+    finance: {
+      keywords: ['financial model', 'valuation', 'revenue', 'portfolio', 'derivative',
+                  'hedge fund', 'series a', 'series b', 'startup valuation', 'sensitivity analysis',
+                  'investment thesis', 'earnings', 'tax optimization', 'forensic accounting',
+                  'multinational', 'jurisdiction', 'risk assessment', 'monte carlo',
+                  'black-scholes', 'options pricing', 'credit risk'],
+      weight: 0.30
     },
-    "groq/llama-3.3-70b": {
-        name: "groq/llama-3.3-70b",
-        provider: "groq",
-        cost_per_1k_input: 0.59,
-        cost_per_1k_output: 0.79,
-        latency_ms: 400,
-        quality_score: 0.82,
-        strengths: ["fast", "coding"],
-        context_window: 128000
+    security: {
+      keywords: ['security audit', 'penetration', 'vulnerability', 'exploit', 'zero-trust',
+                  'threat model', 'incident response', 'malware', 'ransomware',
+                  'authentication flow', 'cryptograph', 'encryption', 'timing attack',
+                  'supply chain attack', 'owasp', 'compliance', 'risk assessment',
+                  'mfa', 'zero-day', 'firewall', 'intrusion'],
+      weight: 0.30
     },
-    "cerebras/llama-3.3-70b": {
-        name: "cerebras/llama-3.3-70b",
-        provider: "cerebras",
-        cost_per_1k_input: 0.60,
-        cost_per_1k_output: 0.60,
-        latency_ms: 350,
-        quality_score: 0.82,
-        strengths: ["fast", "budget"],
-        context_window: 128000
+    architecture: {
+      keywords: ['system design', 'microservice', 'distributed system', 'fault-tolerant',
+                  'event-sourced', 'cqrs', 'consensus algorithm', 'real-time pipeline',
+                  'high availability', 'multi-region', 'latency sla', 'kafka',
+                  'event-driven', 'data warehouse', 'etl', 'streaming', '1m events',
+                  'million events', 'scalab', 'infrastruct', 'deploy'],
+      weight: 0.25
     },
-    "local/llama-3.3-70b": {
-        name: "local/llama-3.3-70b",
-        provider: "ollama",
-        cost_per_1k_input: 0.00,
-        cost_per_1k_output: 0.00,
-        latency_ms: 100,
-        quality_score: 0.75,
-        strengths: ["privacy", "free"],
-        context_window: 128000
+    ml_research: {
+      keywords: ['neural network', 'transformer', 'backpropagation', 'gradient',
+                  'reinforcement learning', 'rlhf', 'fine-tun', 'bert ', 'gpt ',
+                  'attention mechanism', 'training pipeline', 'model monitoring',
+                  'data drift', 'feature engine', 'deep learn', 'benchmark',
+                  'ablation', 'sota', 'state of the art', 'paper', 'arxiv'],
+      weight: 0.25
     }
-};
-/**
- * Extract features from prompt for routing decision
- */
-function extractQueryFeatures(prompt) {
-    const lower = prompt.toLowerCase();
-    // Code patterns
-    const code_indicators = [
-        "function", "class ", "def ", "import ", "const ", "let ",
-        "python", "javascript", "typescript", "java", "cpp", "rust",
-        "```", "=>", "->", "async", "await"
-    ];
-    const has_code = code_indicators.some(pattern => lower.includes(pattern));
-    // Math patterns (expanded for unicode and common notation)
-    const math_indicators = [
-        "equation", "formula", "calculate", "sqrt", "^", "log",
-        "sin", "cos", "tan", "integral", "derivative", "$", "math",
-        "∫", "∂", "∑", "∏", "√", "∞", "π", "θ", "β",
-        "dx", "dy", "dz", "=", "solver", "compute"
-    ];
-    const has_math = math_indicators.some(pattern => prompt.includes(pattern));
-    // Multilingual
-    const lang_patterns = [
-        /[\u4e00-\u9fff]/, // Chinese
-        /[\u3040-\u309f\u30a0-\u30ff]/, // Japanese
-        /[\uac00-\ud7af]/, // Korean
-        /[а-яА-Я]/, // Russian
-        /[áéíóúñ]/ // Spanish accented
-    ];
-    const is_multilingual = lang_patterns.some(pattern => pattern.test(prompt));
-    // Creative writing
-    const creative_indicators = [
-        "write a", "story", "poem", "creative", "imagine",
-        "describe", "explain in", "tell me", "narrative"
-    ];
-    const is_creative = creative_indicators.some(pattern => lower.includes(pattern));
-    // Reasoning
-    const reasoning_indicators = [
-        "explain", "why", "because", "therefore", "thus",
-        "analyze", "think", "consider", "reason", "logic"
-    ];
-    const requires_reasoning = reasoning_indicators.some(pattern => lower.includes(pattern));
-    // Complexity estimation based on length and patterns
-    const tokens = (0, tokenUtils_1.countTokens)(prompt, "gpt-4o");
-    let complexity = 0.3;
-    if (tokens > 1000)
-        complexity += 0.2;
-    if (has_code)
-        complexity += 0.15;
-    if (has_math)
-        complexity += 0.2;
-    if (requires_reasoning)
-        complexity += 0.15;
-    if (is_creative)
-        complexity += 0.1;
-    complexity = Math.min(1.0, complexity);
-    return {
-        complexity,
-        length: tokens,
-        has_code,
-        has_math,
-        is_multilingual,
-        is_creative,
-        requires_reasoning
-    };
+  };
+  
+  let domainScore = 0;
+  let detectedDomain = '';
+  for (const [domain, config] of Object.entries(domainSignals)) {
+    const matchCount = config.keywords.filter(kw => lower.includes(kw)).length;
+    if (matchCount > 0) {
+      const score = config.weight * Math.min(matchCount / 2, 1.5); // cap at 1.5x
+      if (score > domainScore) {
+        domainScore = score;
+        detectedDomain = domain;
+      }
+    }
+  }
+  
+  // === SIGNAL 2: Task Complexity Indicators ===
+  const has_code = /function|class |def |import |const |let |python|javascript|typescript|java |cpp|rust|```|=>|->|async|await|sql|css|html|react|node|express|docker|kubernetes/i.test(prompt);
+  const has_math = /equation|formula|calculate|sqrt|\^|log|sin|cos|integral|derivative|math|∫|∂|∑|∏|√|∞|π|compute|theorem|proof|complexity|algorithm/i.test(prompt);
+  const requires_reasoning = /analyze|compare|contrast|evaluate|assess|implications|impact|consequence|why|because|therefore|reason|logic|argue|debate|critique|synthesize/i.test(prompt);
+  const is_creative = /write a|story|poem|creative|imagine|narrative|joke|compose|fiction/i.test(lower);
+  const is_translation = /translate|translation|in french|in spanish|in japanese|in chinese/i.test(lower);
+  const is_multilingual = /[\u4e00-\u9fff]|[\u3040-\u309f\u30a0-\u30ff]|[\uac00-\ud7af]|[а-яА-Я]/.test(prompt);
+  
+  // === SIGNAL 3: Query Structure ===
+  // Longer, more structured queries = more complex
+  const avgWordLength = words.reduce((sum, w) => sum + w.length, 0) / Math.max(wordCount, 1);
+  const hasMultipleClauses = (prompt.match(/[,;:]/g) || []).length >= 2;
+  const hasQualifiers = /detailed|comprehensive|thorough|in-depth|extensive|step-by-step|systematic|formal|rigorous/i.test(prompt);
+  
+  // === SIGNAL 4: Action Verb Intensity ===
+  // Expert verbs indicate higher cognitive demands
+  const expertVerbs = /design|architect|review|audit|investigate|diagnose|optimize|strategize|formulate|derive|prove|verify|validate/i;
+  const midVerbs = /analyze|evaluate|compare|assess|implement|create|build|develop|construct|derive|explain/i;
+  const simpleVerbs = /what is|who|when|where|how many|define|list|name|convert|translate|summarize briefly/i;
+  
+  let verbScore = 0;
+  if (expertVerbs.test(lower)) verbScore = 0.20;
+  else if (midVerbs.test(lower)) verbScore = 0.10;
+  if (simpleVerbs.test(lower)) verbScore = -0.10; // deboost simple questions
+  
+  // === SIGNAL 5: Specificity ===
+  // Specific details = more complex
+  const hasSpecifics = /\d+%|\$\d+|million|billion|specific|particular|given|according to|based on/i.test(prompt);
+  const hasMultiStep = /and then|first.*then|after that|next|finally|additionally|furthermore|moreover/i.test(prompt);
+  
+  // === COMPLEXITY SCORING (weighted multi-signal) ===
+  let complexity = 0.15; // Base: simple query
+  
+  // Domain signal (strongest predictor)
+  complexity += domainScore;
+  
+  // Length signal (longer = harder, but diminishing)
+  if (wordCount > 5) complexity += 0.03;
+  if (wordCount > 10) complexity += 0.05;
+  if (wordCount > 15) complexity += 0.05;
+  if (wordCount > 20) complexity += 0.03;
+  
+  // Feature signals
+  if (has_code) complexity += 0.10;
+  if (has_math) complexity += 0.12;
+  if (requires_reasoning) complexity += 0.08;
+  if (is_creative) complexity += 0.05;
+  if (is_translation) complexity += 0.02;
+  
+  // Structure signals
+  if (hasQualifiers) complexity += 0.08;
+  if (hasMultipleClauses) complexity += 0.05;
+  if (hasSpecifics) complexity += 0.05;
+  if (hasMultiStep) complexity += 0.05;
+  
+  // Verb intensity
+  complexity += verbScore;
+  
+  // Long words = technical language
+  if (avgWordLength > 6) complexity += 0.05;
+  if (avgWordLength > 8) complexity += 0.05;
+  
+  complexity = Math.max(0.10, Math.min(1.0, complexity));
+  
+  return {
+    complexity,
+    length: wordCount,
+    has_code,
+    has_math,
+    is_multilingual,
+    is_translation,
+    is_creative,
+    requires_reasoning,
+    is_security: /security|vulnerability|inject|exploit|attack|encryption|auth/i.test(lower),
+    is_devops: /ci\/cd|docker|kubernetes|k8s|deploy|pipeline|github action|terraform/i.test(lower),
+    is_data: /dataset|pandas|numpy|training|model|neural|transformer|bert|llm/i.test(lower),
+    detected_domain: detectedDomain,
+    domain_score: domainScore,
+  };
 }
-/**
- * Score model fit for query
- */
+
+exports.extractQueryFeatures = extractQueryFeatures;
+
+// ============================================================
+// SCORING FUNCTIONS
+// ============================================================
+
 function scoreModelFit(model, features) {
-    let score = model.quality_score * 0.4; // Base quality
-    // Strengths matching
-    if (features.has_code && model.strengths.includes("coding")) {
-        score += 0.2;
-    }
-    if (features.requires_reasoning && model.strengths.includes("reasoning")) {
-        score += 0.2;
-    }
-    if (features.is_creative && model.strengths.includes("creative")) {
-        score += 0.15;
-    }
-    if (features.is_multilingual && model.strengths.includes("multilingual")) {
-        score += 0.15;
-    }
-    if (features.has_math && model.strengths.includes("analysis")) {
-        score += 0.15;
-    }
-    // Speed bonus for simple tasks
-    if (features.complexity < 0.4 && model.latency_ms < 1000) {
-        score += 0.1;
-    }
-    return score;
+  let score = model.quality_score * 0.4; // Base quality
+  
+  if (features.has_code && model.strengths.includes("coding")) score += 0.2;
+  if (features.requires_reasoning && model.strengths.includes("reasoning")) score += 0.2;
+  if (features.is_creative && model.strengths.includes("creative")) score += 0.15;
+  if (features.is_multilingual && model.strengths.includes("multilingual")) score += 0.15;
+  if (features.has_math && model.strengths.includes("analysis")) score += 0.15;
+  if (features.is_security && model.strengths.includes("reasoning")) score += 0.1;
+  if (features.is_data && model.strengths.includes("analysis")) score += 0.1;
+  
+  // Free/local providers bonus for simple tasks
+  if (features.complexity < 0.4 && model.strengths.includes("free")) score += 0.15;
+  if (features.complexity < 0.4 && model.latency_ms < 1000) score += 0.1;
+  
+  // Code-aware providers for code tasks
+  if (features.has_code && model.strengths.includes("code-aware")) score += 0.2;
+  
+  return score;
 }
-/**
- * Cost efficiency score (inverse of normalized cost)
- */
+
 function costEfficiency(model, features) {
-    const avg_cost = (model.cost_per_1k_input + model.cost_per_1k_output) / 2;
-    // For simple tasks, prioritize cost efficiency
-    if (features.complexity < 0.5) {
-        return (1 - Math.min(avg_cost / 10, 1)) * 0.6;
-    }
-    // For complex tasks, deprioritize cost
-    return (1 - Math.min(avg_cost / 10, 1)) * 0.2;
+  const avg_cost = (model.cost_per_1k_input + model.cost_per_1k_output) / 2;
+  if (features.complexity < 0.5) {
+    return (1 - Math.min(avg_cost / 10, 1)) * 0.6;
+  }
+  return (1 - Math.min(avg_cost / 10, 1)) * 0.2;
 }
-/**
- * RouteLLM-style learned routing decision
- */
+
+// ============================================================
+// ROUTING
+// ============================================================
+
 function routeQuery(prompt, available_models, budget_multiplier = 1.0) {
-    const features = extractQueryFeatures(prompt);
-    const candidate_names = available_models || Object.keys(exports.MODEL_PROFILES);
-    const candidates = candidate_names
-        .filter(name => exports.MODEL_PROFILES[name])
-        .map(name => {
-        const profile = exports.MODEL_PROFILES[name];
-        const quality = scoreModelFit(profile, features);
-        const cost = costEfficiency(profile, features);
-        return {
-            name,
-            profile,
-            quality_score: quality,
-            cost_score: cost,
-            total_score: quality + cost
-        };
+  // Refresh profiles to ensure we have latest provider config
+  refreshModelProfiles();
+  
+  const features = extractQueryFeatures(prompt);
+  const candidate_names = available_models || Object.keys(MODEL_PROFILES);
+  
+  // Filter to available models
+  const candidates = candidate_names
+    .filter(name => MODEL_PROFILES[name])
+    .map(name => {
+      const profile = MODEL_PROFILES[name];
+      const quality = scoreModelFit(profile, features);
+      const cost = costEfficiency(profile, features);
+      return {
+        name,
+        profile,
+        quality_score: quality,
+        cost_score: cost,
+        total_score: quality + cost
+      };
     });
-    // Sort by total score (quality vs cost tradeoff based on complexity)
-    const complexity_bias = features.complexity > 0.6 ? 0.7 : 0.3; // High complexity = quality bias
-    candidates.sort((a, b) => {
-        const score_a = a.quality_score * complexity_bias + a.cost_score * (1 - complexity_bias);
-        const score_b = b.quality_score * complexity_bias + b.cost_score * (1 - complexity_bias);
-        return score_b - score_a;
-    });
-    const primary = candidates[0];
-    const secondary = candidates.slice(1, 3);
-    // Calculate confidence based on score gap
-    let confidence = 0.5;
-    if (candidates.length > 1) {
-        const gap = primary.total_score - candidates[1].total_score;
-        confidence = Math.min(0.95, 0.5 + gap * 2);
-    }
-    // Build reasoning
-    const reasons = [];
-    if (features.has_code)
-        reasons.push("code detected");
-    if (features.requires_reasoning)
-        reasons.push("reasoning needed");
-    if (features.complexity > 0.6)
-        reasons.push("high complexity");
-    if (features.is_multilingual)
-        reasons.push("multilingual");
-    const estimated_tokens = features.length * 1.5; // rough completion estimate
-    const estimated_cost = (0, tokenUtils_1.estimateCost)(features.length, estimated_tokens, primary.name);
+  
+  if (candidates.length === 0) {
     return {
-        primary_model: primary.name,
-        fallback_models: secondary.map(c => c.name),
-        confidence,
-        reasoning: `Selected ${primary.profile.provider}/${primary.name.split("/")[1]} for ${reasons.join(", ") || "general query"}`,
-        estimated_cost: estimated_cost * budget_multiplier,
-        estimated_latency_ms: primary.profile.latency_ms
+      primary_model: null,
+      fallback_models: [],
+      confidence: 0,
+      reasoning: "No providers available - configure API keys in ~/.config/a3m-router/providers.json",
+      estimated_cost: 0,
+      estimated_latency_ms: 0,
     };
+  }
+  
+  // Sort by total score (quality vs cost tradeoff based on complexity)
+  const complexity_bias = features.complexity > 0.6 ? 0.7 : 0.3;
+  candidates.sort((a, b) => {
+    const score_a = a.quality_score * complexity_bias + a.cost_score * (1 - complexity_bias);
+    const score_b = b.quality_score * complexity_bias + b.cost_score * (1 - complexity_bias);
+    return score_b - score_a;
+  });
+  
+  const primary = candidates[0];
+  const secondary = candidates.slice(1, 3);
+  
+  // Calculate confidence based on score gap
+  let confidence = 0.5;
+  if (candidates.length > 1) {
+    const gap = primary.total_score - candidates[1].total_score;
+    confidence = Math.min(0.95, 0.5 + gap * 2);
+  }
+  
+  // Build reasoning
+  const reasons = [];
+  if (features.has_code) reasons.push("code detected");
+  if (features.requires_reasoning) reasons.push("reasoning needed");
+  if (features.complexity > 0.6) reasons.push("high complexity");
+  if (features.is_multilingual) reasons.push("multilingual");
+  if (features.is_translation) reasons.push("translation");
+  if (primary.profile.strengths.includes("free")) reasons.push("free tier");
+  
+  const estimated_tokens = features.length * 1.5;
+  const estimated_cost = tokenUtils_1.estimateCost(features.length, estimated_tokens, primary.name);
+  
+  return {
+    primary_model: primary.name,
+    fallback_models: secondary.map(c => c.name),
+    confidence,
+    reasoning: `Selected ${primary.profile.providerName || primary.profile.provider}/${primary.name} for ${reasons.join(", ") || "general query"}`,
+    estimated_cost: estimated_cost * budget_multiplier,
+    estimated_latency_ms: primary.profile.latency_ms,
+    features,
+    provider_type: primary.profile.type,
+  };
 }
-/**
- * Batch routing for multiple prompts
- */
-function routeBatch(prompts, options) {
-    const decisions = prompts.map(p => routeQuery(p));
-    if (options?.same_model && decisions.length > 0) {
-        // Use first decision's model for all (for batch consistency)
-        const primary_model = decisions[0].primary_model;
-        decisions.forEach(d => {
-            d.primary_model = primary_model;
-            d.fallback_models = decisions[0].fallback_models;
-        });
-    }
-    if (options?.max_cost_per_prompt) {
-        decisions.forEach(d => {
-            if (d.estimated_cost > options.max_cost_per_prompt) {
-                // Route to cheaper alternative
-                const cheap = Object.entries(exports.MODEL_PROFILES)
-                    .find(([name, p]) => p.cost_per_1k_input < 0.5);
-                if (cheap) {
-                    d.primary_model = cheap[0];
-                    d.reasoning = `Budget-limited routing to ${cheap[1].provider}`;
-                }
-            }
-        });
-    }
-    return decisions;
+
+exports.routeQuery = routeQuery;
+
+// ============================================================
+// BATCH ROUTING
+// ============================================================
+
+function routeBatch(prompts, options = {}) {
+  const decisions = prompts.map(p => routeQuery(p));
+  
+  if (options.same_model && decisions.length > 0) {
+    const primary_model = decisions[0].primary_model;
+    decisions.forEach(d => {
+      d.primary_model = primary_model;
+      d.fallback_models = decisions[0].fallback_models;
+    });
+  }
+  
+  if (options.max_cost_per_prompt) {
+    decisions.forEach(d => {
+      if (d.estimated_cost > options.max_cost_per_prompt) {
+        const cheap = Object.entries(MODEL_PROFILES)
+          .find(([name, p]) => p.cost_per_1k_input < 0.5);
+        if (cheap) {
+          d.primary_model = cheap[0];
+          d.reasoning = `Budget-limited routing to ${cheap[1].providerName || cheap[1].provider}`;
+        }
+      }
+    });
+  }
+  
+  return decisions;
 }
-/**
- * Get model recommendation for task type
- */
+
+exports.routeBatch = routeBatch;
+
+// ============================================================
+// TASK RECOMMENDATIONS
+// ============================================================
+
 function recommendForTask(task) {
-    const features = extractQueryFeatures(task);
-    const decision = routeQuery(task);
-    // Return object format for backward compatibility
-    return {
-        primary: decision.primary_model,
-        fallbacks: decision.fallback_models || [],
-        reason: decision.reasoning || 'routed based on task'
-    };
+  refreshModelProfiles();
+  const features = extractQueryFeatures(task);
+  const decision = routeQuery(task);
+  return {
+    primary: decision.primary_model,
+    fallbacks: decision.fallback_models,
+    reason: decision.reasoning,
+    features,
+  };
 }
-/**
- * Update model profile from execution feedback (online learning)
- */
-function updateModelProfile(model_name, actual_latency_ms, actual_cost, quality_rating // 0-1
-) {
-    const profile = exports.MODEL_PROFILES[model_name];
-    if (!profile)
-        return;
-    // Exponential moving average update
-    const alpha = 0.2; // Learning rate
-    profile.latency_ms = profile.latency_ms * (1 - alpha) + actual_latency_ms * alpha;
-    profile.quality_score = profile.quality_score * (1 - alpha) + quality_rating * alpha;
-    // Adjust cost perception
-    const actual_cost_per_1k = actual_cost * 1000;
-    const current_avg_cost = (profile.cost_per_1k_input + profile.cost_per_1k_output) / 2;
-    // Keep stored costs as reference, but note actual in profile
-    console.log(`[RouteLLM] Updated ${model_name}: latency=${profile.latency_ms.toFixed(0)}ms, quality=${profile.quality_score.toFixed(2)}`);
+
+exports.recommendForTask = recommendForTask;
+
+// ============================================================
+// ONLINE LEARNING - Update model profiles from feedback
+// ============================================================
+
+function updateModelProfile(model_name, actual_latency_ms, actual_cost, quality_rating) {
+  refreshModelProfiles();
+  const profile = MODEL_PROFILES[model_name];
+  if (!profile) return;
+  
+  const alpha = 0.2; // Learning rate
+  profile.latency_ms = profile.latency_ms * (1 - alpha) + actual_latency_ms * alpha;
+  profile.quality_score = profile.quality_score * (1 - alpha) + quality_rating * alpha;
+}
+
+exports.updateModelProfile = updateModelProfile;
+
+// ============================================================
+// PROVIDER HEALTH CHECK
+// ============================================================
+
+async function getProviderHealth() {
+  const { checkAllProviders } = require("../providers/providerConfig");
+  return checkAllProviders();
 }
+
+exports.getProviderHealth = getProviderHealth;
+
+// ============================================================
+// Default export
+// ============================================================
+
 exports.default = {
-    extractQueryFeatures,
-    routeQuery,
-    routeBatch,
-    recommendForTask,
-    updateModelProfile,
-    MODEL_PROFILES: exports.MODEL_PROFILES
+  extractQueryFeatures,
+  routeQuery,
+  routeBatch,
+  recommendForTask,
+  updateModelProfile,
+  getProviderHealth,
+  MODEL_PROFILES,
 };
-//# sourceMappingURL=advancedRouter.js.map