adaptive-memory-multi-model-router 2.14.46 → 2.14.47

package/openclaw-alexa-bridge/test_fixes.js

@@ -1,77 +0,0 @@
-#!/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/playground/README.md

@@ -1,51 +0,0 @@
-# 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

@@ -1,12 +0,0 @@
-{
-  "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

@@ -1,39 +0,0 @@
-// 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('═══════════════════════════════════════════════════════════════');

package/proxy/README.md

@@ -1,227 +0,0 @@
-# A3M Router Proxy
-
-OpenAI-compatible API proxy for the **A3M Router** — intelligent multi-LLM routing with 47+ providers.
-
-Drop-in replacement for `api.openai.com`. Point any OpenAI-compatible client at this proxy to get A3M's smart routing, cost optimization, and parallel ensemble execution.
-
-## Quick Start
-
-```bash
-# Install dependencies
-cd proxy
-npm install
-
-# Set API keys (at least one)
-export NVIDIA_API_KEY="nvapi-..."
-export GROQ_API_KEY="gsk_..."
-# ... or any of 40+ supported providers
-
-# Start the proxy
-node server.js
-```
-
-The proxy starts on `http://localhost:8787`.
-
-## Usage
-
-### curl
-
-```bash
-curl http://localhost:8787/v1/chat/completions \
-  -H "Content-Type: application/json" \
-  -d '{
-    "model": "a3m-auto",
-    "messages": [{"role": "user", "content": "What is the capital of France?"}]
-  }'
-```
-
-### OpenAI SDK (Node.js, Python, etc.)
-
-```javascript
-import OpenAI from "openai";
-
-const client = new OpenAI({
-  baseURL: "http://localhost:8787/v1",  // ← just change this
-  apiKey: "sk-unused",                   // A3M uses env vars, not this key
-});
-
-const response = await client.chat.completions.create({
-  model: "a3m-auto",
-  messages: [{ role: "user", content: "Hello" }],
-});
-
-console.log(response.choices[0].message.content);
-```
-
-### LangChain
-
-```javascript
-import { ChatOpenAI } from "@langchain/openai";
-
-const model = new ChatOpenAI({
-  model: "a3m-auto",
-  configuration: {
-    baseURL: "http://localhost:8787/v1",
-  },
-  apiKey: "sk-unused",
-});
-
-const response = await model.invoke([
-  { role: "user", content: "Explain quantum computing" },
-]);
-```
-
-### Vercel AI SDK
-
-```javascript
-import { openai } from "@ai-sdk/openai";
-
-const model = openai("a3m-auto", {
-  baseURL: "http://localhost:8787/v1",
-});
-
-const { text } = await generateText({
-  model,
-  prompt: "What is the meaning of life?",
-});
-```
-
-## Model Names
-
-| Model | Strategy | Description |
-|-------|----------|-------------|
-| `a3m-auto` | Intelligent routing | Best model for your query (default) |
-| `a3m-cheapest` | Cost optimization | Routes to cheapest available provider |
-| `a3m-fastest` | Speed optimization | Routes to fastest available provider |
-| `a3m-ensemble` | Parallel execution | Runs 3 providers in parallel, picks best result |
-| `gpt-4`, `gpt-4o` | OpenAI alias | Maps through A3M to best available premium model |
-| `gpt-3.5-turbo` | OpenAI alias | Maps through A3M to best available fast/cheap model |
-| `groq/llama-3.3-70b-versatile` | Direct | Specific provider/model pair |
-| `claude-3.5-sonnet` | Direct | Anthropic model (requires `ANTHROPIC_API_KEY`) |
-
-## Streaming
-
-Streaming is supported via Server-Sent Events (SSE). Just set `stream: true` in your request.
-
-```bash
-curl http://localhost:8787/v1/chat/completions \
-  -H "Content-Type: application/json" \
-  -d '{
-    "model": "a3m-auto",
-    "messages": [{"role": "user", "content": "Tell me a story"}],
-    "stream": true
-  }'
-```
-
-## Environment Variables
-
-Set API keys for the providers you want to use. A3M auto-detects available providers from env vars.
-
-| Variable | Provider |
-|----------|----------|
-| `NVIDIA_API_KEY` | NVIDIA NIM (free tier) |
-| `GROQ_API_KEY` | Groq (fast inference) |
-| `CEREBRAS_API_KEY` | Cerebras |
-| `OPENAI_API_KEY` | OpenAI |
-| `ANTHROPIC_API_KEY` | Anthropic |
-| `GOOGLE_API_KEY` | Google Gemini |
-| `MISTRAL_API_KEY` | Mistral |
-| `DEEPSEEK_API_KEY` | DeepSeek |
-| `TOGETHER_API_KEY` | Together AI |
-| `FIREWORKS_API_KEY` | Fireworks AI |
-| `OPENROUTER_API_KEY` | OpenRouter |
-| `PERPLEXITY_API_KEY` | Perplexity |
-| `XAI_API_KEY` | xAI (Grok) |
-| `DEEPINFRA_API_KEY` | DeepInfra |
-| `SAMBANOVA_API_KEY` | SambaNova |
-| `ANYSCALE_API_KEY` | Anyscale |
-| `REPLICATE_API_KEY` | Replicate |
-| `NOVITA_API_KEY` | Novita AI |
-| `COHERE_API_KEY` | Cohere |
-| `AI21_API_KEY` | AI21 Labs |
-| `ZHIPU_API_KEY` | Zhipu (GLM) |
-| `MOONSHOT_API_KEY` | Moonshot (Kimi) |
-| `DASHSCOPE_API_KEY` | Alibaba Qwen |
-| `YI_API_KEY` | Yi (01.AI) |
-| `MINIMAX_API_KEY` | MiniMax |
-
-No providers configured? A3M will try local providers (Ollama on port 11434, LM Studio on port 1234, vLLM on port 8000) automatically.
-
-## Port Configuration
-
-```bash
-# Via environment variable
-PORT=8080 node server.js
-
-# Or change in server.js (default: 8787)
-```
-
-## Provider Configuration File
-
-For advanced configuration (custom base URLs, model lists, cost overrides):
-
-Create `~/.config/a3m-router/providers.json`:
-
-```json
-{
-  "providers": {
-    "local-llama": {
-      "baseUrl": "http://192.168.1.100:8000/v1/chat/completions",
-      "models": ["llama-3.1-70b"],
-      "apiKeyEnv": "CUSTOM_API_KEY",
-      "tier": "free",
-      "costPerK": { "input": 0, "output": 0 }
-    }
-  }
-}
-```
-
-## Response Headers
-
-Every response includes diagnostic headers:
-
-| Header | Description |
-|--------|-------------|
-| `X-A3M-Proxy` | Always `true` |
-| `X-A3M-Provider` | Provider that served the request |
-| `X-A3M-Resolved` | Actual model name used |
-
-## Health Check
-
-```bash
-curl http://localhost:8787/health
-```
-
-Returns provider availability, uptime, and proxy version.
-
-## Architecture
-
-```
-┌──────────────┐     ┌───────────────────┐     ┌──────────────┐
-│  Any Client   │────▶│  A3M Proxy Server │────▶│  NVIDIA NIM  │
-│  (OpenAI SDK) │     │  localhost:8787   │     │  Groq         │
-│  LangChain    │     │  Express + Fetch  │     │  OpenAI       │
-│  Vercel AI    │     │  A3M Router Core  │     │  Anthropic    │
-│  curl         │     │  Route Resolution │     │  40+ more...  │
-└──────────────┘     └───────────────────┘     └──────────────┘
-                              │
-                    ┌─────────┴─────────┐
-                    │  Route Strategies │
-                    ├───────────────────┤
-                    │ a3m-auto          │
-                    │ a3m-cheapest      │
-                    │ a3m-fastest       │
-                    │ a3m-ensemble ◀───│ Unique: parallel
-                    │                   │  multi-LLM execution
-                    └───────────────────┘  with result merging
-```
-
-## Why A3M Proxy?
-
-**Nobody does parallel multi-LLM execution with result merging.** Everyone else does sequential fallback (try A -> B -> C). A3M's parallel ensemble with intelligent routing is unmatched.
-
-- **47+ providers** — one proxy, any LLM
-- **62% cost savings** — auto-routes to cheapest adequate model
-- **138ms baseline, +96ms proxy overhead** — benchmarked with llm-gateway-bench
-- **70.32 routing accuracy** — validated on golden test set
-- **Zero ML deps** — 19.5 KB, pure JS