adaptive-memory-multi-model-router 2.14.49 → 2.14.52

package/openclaw-alexa-bridge/test_fixes.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+/**
+ * Quick test to verify fixes
+ */
+
+const TwitterTestHelper = require('./comprehensive_quantum_claw_alexa_test/utils/twitter-test-helper');
+const ConversationTestHelper = require('./comprehensive_quantum_claw_alexa_test/utils/conversation-test-helper');
+
+async function testFixes() {
+    console.log('🧪 Testing Fixes...\n');
+
+    // Test 1: Twitter Hindi language detection
+    console.log('Test 1: Twitter Hindi Language Detection');
+    const hindiResult = await TwitterTestHelper.testTwitterIntegration('Show me tweets in Hindi');
+    console.log('  Query:', hindiResult.query);
+    console.log('  Success:', hindiResult.success);
+    if (hindiResult.tweets && hindiResult.tweets.length > 0) {
+        console.log('  Tweet 1 text:', hindiResult.tweets[0].text);
+        console.log('  Tweet 1 language:', hindiResult.tweets[0].language);
+        console.log('  Tweet 1 expectedLanguage:', hindiResult.tweets[0].expectedLanguage);
+
+        const validation = TwitterTestHelper.validateTweetLanguageDetection(hindiResult, 'hi');
+        console.log('  Validation passed:', validation.passed);
+        console.log('  Match rate:', validation.details.matchRate);
+    }
+    console.log('');
+
+    // Test 2: Twitter no results search
+    console.log('Test 2: Twitter No Results Search');
+    const noResultsResult = await TwitterTestHelper.testTweetSearch('xyz123nonexistent', 0);
+    console.log('  Success:', noResultsResult.success);
+    console.log('  Expected:', noResultsResult.expectedResults);
+    console.log('  Actual:', noResultsResult.actualResults);
+    console.log('');
+
+    // Test 3: Twitter very_long_topic edge case
+    console.log('Test 3: Twitter very_long_topic Edge Case');
+    const longTopicResult = await TwitterTestHelper.testTwitterIntegration('a'.repeat(100));
+    console.log('  Success:', longTopicResult.success);
+    console.log('  Error:', longTopicResult.error || 'None');
+    console.log('');
+
+    // Test 4: Conversation context session persistence
+    console.log('Test 4: Conversation Context Session Persistence');
+    const mockSession = {
+        id: 'test-session',
+        userId: 'test-user',
+        state: {
+            lastQuery: 'What is AI?',
+            totalTurns: 2,
+            duration: 5000,
+            name: 'Test Session'
+        },
+        metadata: {
+            duration: 5000,
+            turnCount: 2,
+            language: 'en',
+            complexity: 'simple'
+        }
+    };
+
+    const expectedState = {
+        state: { name: 'Test' },
+        fields: ['duration', 'turnCount']
+    };
+
+    const validation = ConversationTestHelper.validateSessionPersistence(mockSession, expectedState);
+    console.log('  Validation passed:', validation.passed);
+    console.log('  State match:', validation.details.stateMatch);
+    console.log('  Context preserved:', validation.details.contextPreserved);
+    console.log('');
+
+    console.log('✅ All tests complete!');
+}
+
+testFixes().catch(console.error);

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "adaptive-memory-multi-model-router",
-  "version": "2.14.49",
+  "version": "2.14.52",
   "shortName": "A3M Router",
   "displayName": "A3M Router - Adaptive Memory Multi-Model Router",
-  "description": "🥇 Cheapest LLM router on RouterArena ($0.05/1K) · 15K+ downloads in 2 weeks · Open-source AI gateway with parallel multi-LLM execution across 47+ providers, ensemble voting, semantic cache, and budget enforcement",
+  "description": "🥇 LLM router on RouterArena at 96.77% official accuracy ($0.0768/1K) · 21K+ downloads · ⭐ Star on GitHub: https://github.com/Das-rebel/a3m-router · Open-source AI gateway with parallel multi-LLM execution across 47+ providers, ensemble voting, semantic cache, and budget enforcement",
   "main": "dist/index.js",
   "bin": {
     "a3m-router": "dist/cli.js",
@@ -58,303 +58,103 @@
     "a3m",
     "a3m-router",
     "adaptive-memory-multi-model-router",
-    "multi-model-router",
     "llm-router",
+    "llm-routing",
+    "model-routing",
+    "ai-router",
+    "ai-gateway",
+    "ai-routing",
     "routing",
     "router",
     "gateway",
-    "ai-gateway",
-    "ai-router",
-    "model-routing",
-    "llm-routing",
-    "ai-routing",
-    "smart-routing",
-    "dynamic-routing",
-    "adaptive-routing",
-    "semantic-routing",
-    "intent-routing",
-    "content-routing",
-    "tier-routing",
-    "cost-routing",
-    "latency-routing",
-    "quality-routing",
-    "multi-provider",
-    "provider-routing",
-    "llm",
-    "large-language-model",
-    "ai",
-    "artificial-intelligence",
-    "machine-learning",
-    "ml",
-    "deep-learning",
-    "neural-network",
-    "natural-language-processing",
-    "nlp",
-    "text-generation",
-    "chatgpt",
+    "multi-llm",
+    "openai",
+    "anthropic",
+    "gemini",
+    "claude",
     "gpt",
     "gpt-4",
-    "gpt-4o",
-    "gpt-3",
-    "gpt-3.5",
-    "claude",
-    "claude-3",
-    "claude-sonnet",
-    "claude-opus",
-    "claude-haiku",
-    "gemini",
-    "gemini-pro",
-    "gemini-ultra",
     "llama",
-    "llama-2",
     "llama-3",
+    "deepseek",
     "mistral",
-    "mixtral",
-    "phi",
-    "gemma",
+    "groq",
     "qwen",
-    "yi",
-    "command-r",
-    "deepseek",
     "kimi",
-    "grok",
-    "palm",
-    "bedrock",
-    "openai",
-    "anthropic",
-    "google-ai",
-    "google-cloud",
-    "vertex-ai",
-    "azure-openai",
-    "aws-bedrock",
+    "xai",
     "cohere",
-    "huggingface",
-    "replicate",
-    "together-ai",
-    "fireworks-ai",
-    "anyscale",
-    "perplexity",
-    "mistral-ai",
-    "groq",
-    "cerebras",
-    "sambanova",
-    "nvidia-nim",
-    "vllm",
-    "ollama",
-    "lm-studio",
-    "jan",
-    "text-generation-webui",
-    "koboldcpp",
-    "openrouter",
-    "litellm",
-    "portkey",
-    "helicone",
-    "langfuse",
-    "cost-optimization",
-    "cost-reduction",
+    "langchain",
+    "vercel-ai",
+    "llamaindex",
+    "llamaindex-gateway",
     "cost-savings",
-    "cost-tracking",
-    "cost-analytics",
-    "budget-management",
-    "budget-alerts",
-    "token-optimization",
-    "token-saving",
-    "llm-cost",
-    "api-cost-reduction",
-    "cheap-llm",
-    "low-cost-llm",
-    "free-llm",
-    "cost-effective",
-    "price-comparison",
-    "rate-limiting",
-    "quota-management",
-    "usage-tracking",
-    "billing",
+    "cost-reduction",
     "caching",
     "semantic-cache",
-    "response-cache",
-    "prompt-cache",
     "context-cache",
-    "embedding-cache",
-    "vector-cache",
-    "redis-cache",
-    "in-memory-cache",
-    "distributed-cache",
-    "cache-invalidation",
-    "cache-strategy",
-    "llm-cache",
-    "ai-cache",
-    "request-dedup",
+    "prompt-cache",
     "fallback",
     "failover",
     "smart-fallback",
     "smart-failover",
+    "guardrails",
+    "ai-guardrails",
     "circuit-breaker",
+    "streaming",
+    "streaming-llm",
     "retry",
-    "retry-logic",
-    "exponential-backoff",
-    "health-check",
-    "provider-health",
-    "uptime",
-    "high-availability",
-    "resilience",
-    "fault-tolerance",
-    "error-handling",
-    "graceful-degradation",
-    "load-balancing",
+    "ai-agent",
+    "multi-agent",
+    "autonomous-agents",
+    "rag",
+    "chatbot",
+    "ai-coding",
+    "code-generation",
+    "text-generation",
+    "extraction",
+    "summarization",
+    "smart-routing",
+    "semantic-routing",
+    "tier-routing",
+    "intent-routing",
+    "content-routing",
+    "dynamic-routing",
+    "adaptive-routing",
     "load-balancer",
-    "throttling",
+    "load-balancing",
     "parallel-execution",
-    "concurrent-requests",
-    "batch-processing",
-    "streaming",
-    "streaming-llm",
-    "server-sent-events",
-    "sse",
-    "low-latency",
-    "high-throughput",
-    "performance-optimization",
-    "connection-pooling",
-    "keep-alive",
-    "http2",
-    "grpc",
-    "edge-computing",
-    "edge-deployment",
+    "multi-model",
+    "multi-provider",
+    "openai-compatible",
+    "openai-gateway",
+    "openai-proxy",
+    "openrouter",
     "monitoring",
     "metrics",
     "observability",
-    "tracing",
-    "opentelemetry",
-    "prometheus",
-    "grafana",
-    "logging",
-    "structured-logging",
-    "debug",
-    "telemetry",
-    "analytics",
-    "dashboard",
-    "security",
-    "api-key-management",
-    "key-rotation",
-    "vault",
-    "secret-management",
-    "encryption",
-    "tls",
-    "ssl",
-    "authentication",
-    "authorization",
-    "rbac",
-    "audit-log",
-    "compliance",
-    "pii-detection",
-    "content-filtering",
-    "guardrails",
-    "ai-guardrails",
-    "safety",
-    "langchain",
-    "llamaindex",
-    "vercel-ai",
-    "vercel-ai-sdk",
-    "nextjs",
-    "next.js",
-    "react",
-    "vue",
-    "angular",
-    "svelte",
-    "express",
-    "fastify",
-    "koa",
-    "hono",
-    "nestjs",
-    "typescript",
-    "javascript",
-    "node.js",
-    "nodejs",
-    "deno",
-    "bun",
-    "python",
-    "fastapi",
-    "flask",
-    "django",
-    "docker",
-    "kubernetes",
-    "k8s",
-    "serverless",
-    "lambda",
-    "cloud-functions",
-    "vercel",
-    "netlify",
-    "railway",
-    "render",
-    "fly.io",
-    "aws",
-    "gcp",
-    "azure",
-    "digitalocean",
-    "heroku",
+    "health-check",
+    "open-source",
     "self-hosted",
-    "on-premise",
-    "hybrid-cloud",
-    "chatbot",
-    "virtual-assistant",
-    "ai-agent",
-    "autonomous-agents",
-    "multi-agent",
-    "rag",
-    "retrieval-augmented-generation",
-    "question-answering",
-    "summarization",
-    "translation",
-    "code-generation",
-    "text-extraction",
-    "sentiment-analysis",
-    "classification",
-    "content-generation",
-    "copywriting",
-    "data-analysis",
-    "research",
-    "tutoring",
-    "customer-support",
-    "automation",
-    "rest-api",
-    "graphql",
-    "websocket",
-    "json",
-    "openapi",
-    "swagger",
-    "streaming-api",
-    "http",
-    "https",
-    "oauth",
-    "jwt",
-    "api-key",
-    "sdk",
-    "api-client",
-    "cli",
-    "command-line",
-    "terminal",
-    "tui",
-    "configuration",
-    "yaml",
-    "json-config",
-    "environment-variables",
-    "typescript-types",
-    "type-safety",
-    "intellisense",
-    "autocomplete",
-    "documentation",
-    "examples",
-    "quickstart",
-    "boilerplate",
-    "starter-template",
-    "scaffold",
-    "testing",
-    "unit-test",
-    "integration-test",
-    "mock",
-    "stub",
-    "benchmark",
-    "performance-test"
+    "local-llm",
+    "serverless",
+    "cost-optimization",
+    "token-optimization",
+    "llm-cost",
+    "token-saving",
+    "cost-analytics",
+    "cost-tracking",
+    "budget-alerts",
+    "cache",
+    "chatgpt",
+    "agent",
+    "low-cost-llm",
+    "cheaper-llm",
+    "provider-failover",
+    "response-cache",
+    "llm-failover",
+    "api-cost-reduction",
+    "multi-llm-router",
+    "multi-model-router"
   ],
   "author": "Das-rebel <subho@example.com>",
   "license": "MIT",
@@ -368,6 +168,8 @@
   "homepage": "https://das-rebel.github.io/a3m-router/",
   "scripts": {
     "test": "node test.js && node test/provider-test.js",
+    "test:py": "python3 -m pytest -q",
+    "test:all": "npm test && npm run test:py",
     "eval:routing": "node eval/run_eval.js",
     "eval:golden": "node eval/check_golden_routes.js",
     "eval:faults": "node eval/run_fault_injection.js",
@@ -395,9 +197,11 @@
     "nanoid": "^5.0.0"
   },
   "devDependencies": {
+    "@types/express": "^5.0.6",
     "@types/node": "^25.8.0",
+    "esbuild": "^0.28.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.9"
   },
   "types": "dist/index.d.ts"
 }

package/playground/README.md

@@ -0,0 +1,51 @@
+# A3M Router Playground
+
+Try A3M Router instantly in your browser!
+
+## 🎮 Live Playgrounds
+
+### CodeSandbox
+[![Open in CodeSandbox](https://img.shields.io/badge/Open%20in-CodeSandbox-blue?logo=codesandbox)](https://codesandbox.io/p/sandbox/github/Das-rebel/a3m-router/tree/main/playground)
+
+**Direct Link:** https://codesandbox.io/p/sandbox/github/Das-rebel/a3m-router/tree/main/playground
+
+### StackBlitz
+[![Open in StackBlitz](https://img.shields.io/badge/Open%20in-StackBlitz-blue?logo=stackblitz)](https://stackblitz.com/github/Das-rebel/a3m-router/tree/main/playground)
+
+**Direct Link:** https://stackblitz.com/github/Das-rebel/a3m-router/tree/main/playground
+
+### Repl.it
+[![Run on Repl.it](https://img.shields.io/badge/Run%20on-Replit-blue?logo=replit)](https://replit.com/@Das-rebel/a3m-router-playground)
+
+## 🚀 Quick Start
+
+1. Click one of the playground links above
+2. The code will load automatically
+3. Click "Run" to see routing in action
+4. Edit the queries and experiment!
+
+## 📝 What You Can Try
+
+```javascript
+// Route different types of queries
+routeQuery("What is 2+2?");                    // Simple → Free provider
+routeQuery("Write Python code");               // Code → Fast provider
+routeQuery("Explain quantum physics");         // Complex → Quality provider
+
+// Check available providers
+getAvailableProviders();
+
+// Batch processing
+routeBatch(["Q1", "Q2", "Q3"]);
+```
+
+## 🎯 Examples in the Playground
+
+The playground includes:
+- ✅ Provider listing
+- ✅ Simple query routing
+- ✅ Code query routing
+- ✅ Complex query routing
+- ✅ Cost estimation display
+
+No API keys required - uses built-in routing logic!

package/playground/codesandbox.json

@@ -0,0 +1,12 @@
+{
+  "name": "A3M Router Playground",
+  "description": "Interactive playground for A3M Router - test LLM routing live",
+  "version": "1.0.0",
+  "template": "node",
+  "dependencies": {
+    "adaptive-memory-multi-model-router": "latest"
+  },
+  "scripts": {
+    "start": "node index.js"
+  }
+}

package/playground/index.js

@@ -0,0 +1,39 @@
+// A3M Router Playground - Try it live!
+const { createA3MRouter, routeQuery, getAvailableProviders } = require('adaptive-memory-multi-model-router');
+
+console.log('🚀 A3M Router Playground\n');
+console.log('═══════════════════════════════════════════════════════════════\n');
+
+// Show available providers
+console.log('📡 Available Providers:');
+const providers = getAvailableProviders();
+for (const [id, p] of Object.entries(providers)) {
+  console.log(`  ✅ ${id}: ${p.models.length} models (${p.type})`);
+}
+
+console.log('\n🔀 Routing Examples:\n');
+
+// Example 1: Simple query
+const simple = routeQuery("What is 2+2?");
+console.log('1. "What is 2+2?"');
+console.log(`   → ${simple.primary_model}`);
+console.log(`   → Est. Cost: $${simple.estimated_cost.toFixed(6)}`);
+console.log(`   → Reason: ${simple.reasoning}\n`);
+
+// Example 2: Code query
+const code = routeQuery("Write Python to reverse a string");
+console.log('2. "Write Python to reverse a string"');
+console.log(`   → ${code.primary_model}`);
+console.log(`   → Est. Cost: $${code.estimated_cost.toFixed(6)}`);
+console.log(`   → Reason: ${code.reasoning}\n`);
+
+// Example 3: Complex query
+const complex = routeQuery("Explain quantum entanglement");
+console.log('3. "Explain quantum entanglement"');
+console.log(`   → ${complex.primary_model}`);
+console.log(`   → Est. Cost: $${complex.estimated_cost.toFixed(6)}`);
+console.log(`   → Reason: ${complex.reasoning}\n`);
+
+console.log('═══════════════════════════════════════════════════════════════');
+console.log('Try editing the queries above and see how routing changes!');
+console.log('═══════════════════════════════════════════════════════════════');