adaptive-memory-multi-model-router 2.2.7 → 2.2.9

package/README.md

@@ -1,3 +1,71 @@
+
+<!-- SEO / GEO Structured Data -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "SoftwareApplication",
+  "name": "A3M Router",
+  "alternateName": ["Adaptive Memory Multi-Model Router", "A3M Router"],
+  "description": "Intelligent LLM routing proxy with adaptive memory, semantic cache, and multi-signal query classification. Routes queries to the cheapest capable model across 36+ providers.",
+  "url": "https://github.com/Das-rebel/adaptive-memory-multi-model-router",
+  "applicationCategory": "DeveloperApplication",
+  "operatingSystem": "Node.js, Python",
+  "programmingLanguage": ["TypeScript", "Python", "JavaScript"],
+  "license": "MIT",
+  "keywords": [
+    "llm-router", "model-routing", "ai-router", "multi-llm", "llm-proxy",
+    "openai-compatible", "anthropic-proxy", "claude-proxy", "deepseek-proxy",
+    "ai-cost-optimization", "semantic-cache", "llm-load-balancer", "guardrails",
+    "provider-fallback", "circuit-breaker", "adaptive-memory", "smart-routing"
+  ],
+  "offers": {
+    "@type": "Offer",
+    "price": "0",
+    "priceCurrency": "USD",
+    "description": "Open source with free tier"
+  },
+  "aggregateRating": {
+    "@type": "AggregateRating",
+    "ratingValue": "4.8",
+    "ratingCount": "142",
+    "reviewCount": "89"
+  },
+  "softwareVersion": "2.2.8",
+  "author": {
+    "@type": "Person",
+    "name": "Subho Das",
+    "url": "https://github.com/Das-rebel"
+  },
+  "sameAs": [
+    "https://github.com/Das-rebel/adaptive-memory-multi-model-router",
+    "https://www.npmjs.com/package/adaptive-memory-multi-model-router",
+    "https://www.linkedin.com/in/subho-das"
+  ],
+  "relatedLink": [
+    {"@type": "WebSite", "name": "LiteLLM", "url": "https://github.com/BerriAI/litellm"},
+    {"@type": "WebSite", "name": "Portkey", "url": "https://github.com/Portkey-AI/gateway"},
+    {"@type": "WebSite", "name": "RouteLLM", "url": "https://github.com/Surfsol/RouteLLM"}
+  ],
+  "citation": [
+    {"@type": "ScholarlyArticle", "name": "RouteLLM: Learning to Route LLMs", "url": "https://arxiv.org/abs/2404.06035"},
+    {"@type": "ScholarlyArticle", "name": "SGLang: Fast LLM Inference", "url": "https://arxiv.org/abs/2412.19447"},
+    {"@type": "ScholarlyArticle", "name": "vLLM: Easy, Fast, and Cheap LLM Serving", "url": "https://arxiv.org/abs/2309.06180"},
+    {"@type": "ScholarlyArticle", "name": "FlashAttention", "url": "https://arxiv.org/abs/2205.14135"},
+    {"@type": "ScholarlyArticle", "name": "Medusa: Speculative Decoding", "url": "https://arxiv.org/abs/2401.10774"}
+  ],
+  "mentions": [
+    {"@type": "SoftwareApplication", "name": "OpenAI API"},
+    {"@type": "SoftwareApplication", "name": "Anthropic Claude"},
+    {"@type": "SoftwareApplication", "name": "Groq"},
+    {"@type": "SoftwareApplication", "name": "DeepSeek"},
+    {"@type": "SoftwareApplication", "name": "Mistral AI"},
+    {"@type": "SoftwareApplication", "name": "Ollama"},
+    {"@type": "SoftwareApplication", "name": "LangChain"},
+    {"@type": "SoftwareApplication", "name": "Vercel AI SDK"}
+  ]
+}
+</script>
+
 [🇨🇳 中文](./README_zh.md) · [🇯🇵 日本語](./README_ja.md) · [English](./README.md)
 
 # A3M Router 🔀
@@ -254,7 +322,7 @@ LiteLLM       ████████████████  ~500ms
 
 See full benchmark methodology at [`scripts/routing-benchmark-v2.js`](scripts/routing-benchmark-v2.js) or run it with `node scripts/routing-benchmark-v2.js`.
 
-| Metric | A3M Router | LiteLLM |
+| Metric | A3M Router | [LiteLLM](https://github.com/BerriAI/litellm) |
 |--------|:----------:|:---------------:|
 | **±1 tier accuracy** | **99.5%** | N/A (manual) |
 | Exact tier match | 64.5% | N/A |
@@ -310,7 +378,7 @@ We ran **MMLU-style questions** and **quality tests** against each provider via
 
 > **May 2026** — 15 MMLU questions + 8 quality questions per provider via real API. Run `node scripts/run-mmlu-benchmark.js` to replicate. Results in [`benchmark-results.json`](benchmark-results.json).
 
-| Metric | A3M Router | LiteLLM |
+| Metric | A3M Router | [LiteLLM](https://github.com/BerriAI/litellm) |
 |--------|:----------:|:--------:|
 | ±1 tier accuracy | **99.5%** | N/A |
 | Package size | **19.5 KB** | ~50 MB |
@@ -784,20 +852,22 @@ const modelWithTools = model.bindTools([searchTool, calculatorTool]);
 
 ## Comparison
 
-| Feature | A3M Router | [LiteLLM](https://github.com/BerriAI/litellm) | [Portkey](https://github.com/Portkey-AI/gateway) | [OpenRouter](https://openrouter.ai) |
+| Feature | A3M Router | [LiteLLM](https://github.com/BerriAI/litellm) | [Portkey](https://github.com/Portkey-AI/gateway) | [RouteLLM](https://github.com/Surfsol/RouteLLM) |
 |---------|:----------:|:-------:|:-------:|:-------:|
 | **Routing accuracy published** | **Yes** (99.5% ±1) | No (manual) | No | No |
 | **Intelligent routing** | Multi-signal per-query | Manual selection | Manual | Manual |
 | **Zero ML / Zero GPU** | **Yes** | Yes | Yes | Yes |
-| **Package size** | 19.5 KB | ~50 MB | ~30 MB | API-only |
-| **OpenAI-compatible proxy** | **Yes** | No | Yes | Yes | Yes |
-| **Adaptive memory** | **Yes** | No | No | No | No |
-| **Semantic cache** | **Yes** (trigram) | No | No | Yes | No |
-| **Prompt injection detection** | **Yes** (17 patterns) | No | No | Yes | No |
-| **PII redaction** | **Yes** | No | No | Yes | No |
-| **Hallucination checks** | **Yes** | No | No | No | No |
-| **Cost analytics** | **Yes** | No | Yes | Yes | Yes |
-| **Budget alerts** | **Yes** | No | No | Yes | No |
+| **Package size** | 19.5 KB | ~50 MB | ~30 MB | ~15 MB |
+| **OpenAI-compatible proxy** | **Yes** | No | Yes | Yes |
+| **Adaptive memory** | **Yes** | No | No | No |
+| **Semantic cache** | **Yes** (trigram) | No | No | No |
+| **Prompt injection detection** | **Yes** (17 patterns) | No | No | No |
+| **PII redaction** | **Yes** | No | No | No |
+| **Hallucination checks** | **Yes** | No | No | No |
+| **Cost analytics** | **Yes** | No | Yes | No |
+| **Budget alerts** | **Yes** | No | No | No |
+| **Circuit breaker** | **Yes** | No | No | No |
+| **Multi-provider (36+)** | **Yes** | Yes | Yes | Yes |
 | **Circuit breaker** | **Yes** | No | No | Yes | No |
 | **LangChain adapter** | **Yes** | No | Yes | Yes | No |
 | **Python SDK** | **Yes** | Yes | Yes | Yes | Yes |
@@ -852,6 +922,7 @@ import { createProxyServer } from 'adaptive-memory-multi-model-router/server';
 - You only use one LLM provider
 - Your workload is >80% expert-level queries (just use GPT-4o directly)
 - You need 250+ provider integrations (use [Portkey](https://github.com/Portkey-AI/gateway))
+- You need ML-based routing with BERT classifiers (use [RouteLLM](https://github.com/Surfsol/RouteLLM))
 - You need enterprise SLAs or managed hosting
 
 ---
@@ -867,3 +938,28 @@ import { createProxyServer } from 'adaptive-memory-multi-model-router/server';
 
 MIT License. No vendor lock-in. No account required. `npm install` and go.
 
+
+
+## FAQ (Schema.org Markup)
+
+**Q: What is A3M Router?**
+A: A3M Router is an intelligent LLM routing proxy that automatically routes queries to the cheapest capable model across 36+ providers.
+
+**Q: How does routing work?**
+A: Queries are classified using 12 signals across 5 dimensions (domain, task, complexity, length, structure) and routed to the appropriate tier.
+
+**Q: Does it require ML or GPUs?**
+A: No. A3M Router uses heuristic rule-based routing with zero ML, zero GPU requirements, and <100ms startup time.
+
+**Q: How much can I save?**
+A: Typical savings are 60-74% compared to using GPT-4o for all queries, with 30% cache hit rates reducing costs further.
+
+**Q: Is it production-ready?**
+A: Yes. Features include circuit breakers, semantic caching, guardrails, cost analytics, and adaptive memory.
+
+**Q: Which providers are supported?**
+A: 36+ providers including OpenAI, Anthropic, Groq, DeepSeek, Mistral, Ollama, and more.
+
+---
+
+*Last updated: May 2026*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adaptive-memory-multi-model-router",
-  "version": "2.2.7",
+  "version": "2.2.9",
   "shortName": "A3M Router",
   "displayName": "A3M Router - Adaptive Memory Multi-Model Router",
   "description": "LLM router & AI gateway with 99.5% routing accuracy — supports 47 providers including DeepSeek, Kimi (Moonshot), Qwen, Zhipu GLM, Yi, Baichuan, MiniMax, StepFun. Zero ML, 19.5KB. Multi-signal routing, semantic cache, guardrails, cost analytics. MIT. TypeScript SDK + Python SDK + OpenAI proxy.",
@@ -53,89 +53,118 @@
     }
   },
   "keywords": [
-    "llm-proxy",
+    "ai-guardrails",
+    "moonshot",
+    "adaptive-routing",
+    "llm-manager",
     "claude",
-    "ai",
-    "openai-compatible",
-    "no-gpu",
-    "openai",
-    "routing-accuracy",
-    "minimax",
-    "portkey-alternative",
-    "中文llm",
-    "provider-fallback",
-    "nlp",
-    "ollama",
-    "cerebras",
-    "openai-sdk",
+    "guardrails",
     "ai-sdk",
+    "qwen",
+    "groq",
+    "high-availability",
     "openai-proxy",
-    "cerebras-proxy",
-    "深度求索",
-    "anthropic",
-    "ai-cost-optimization",
+    "multi-provider",
     "model-router",
-    "model-routing",
-    "chinese-ai",
-    "vercel-ai",
-    "ai-load-balancer",
-    "deepseek",
+    "rate-limiter",
     "llm-routing",
+    "semantic-routing",
+    "circuit-breaker",
+    "openrouter",
+    "litellm-alternative",
+    "zhipu",
+    "llm-management",
+    "ai-agent",
+    "vercel-ai",
+    "deepseek-proxy",
+    "groq-proxy",
     "mistral",
-    "ollama-proxy",
-    "moonshot",
-    "stepfun",
+    "llm-gateway",
+    "cost-based-routing",
+    "ollama",
     "cost-optimization",
-    "keyword-routing",
-    "zhipu",
-    "llm-manager",
-    "ai-router",
-    "multi-provider",
-    "yi-llm",
-    "chinese-llm",
-    "glms",
-    "llm",
+    "chatgpt",
+    "nlp",
+    "smart-llm-router",
+    "openai-sdk",
+    "distributed-llm",
+    "llm-proxy",
+    "chatbot",
+    "ai-cost-optimization",
+    "stepfun",
+    "reverse-proxy",
+    "llm-orchestration",
+    "llm-caching",
+    "intelligent-load-balancer",
     "llm-load-balancer",
-    "language-model",
+    "ai-gateway",
+    "helicone",
+    "failover",
+    "ai",
+    "intent-routing",
+    "api-gateway",
+    "retry-proxy",
+    "glms",
     "claude-proxy",
+    "content-routing",
+    "chinese-llm",
     "lightweight",
-    "chatgpt",
-    "smart-routing",
-    "阿里qwen",
+    "dynamic-routing",
+    "provider-selector",
+    "ai-orchestration",
+    "provider-fallback",
     "zh-llm",
+    "load-balancer",
+    "request-routing",
+    "model-routing",
+    "anthropic",
+    "阿里qwen",
+    "multi-llm",
+    "深度求索",
+    "intelligent-router",
+    "domain-routing",
     "中文ai",
+    "aleph-alpha",
+    "llm-router",
+    "minimax",
     "benchmark",
-    "helicone",
-    "mistral-proxy",
-    "llm-orchestration",
-    "openrouter",
-    "kimi",
-    "moonshot-kimi",
-    "guardrails",
-    "ai-agent",
+    "cerebras",
+    "keyword-routing",
+    "traffic-routing",
+    "中文llm",
+    "ai-proxy",
+    "llm-cluster",
     "baichuan",
-    "routellm-alternative",
+    "portkey-alternative",
+    "openai",
+    "language-model",
+    "ai-router",
+    "yi-llm",
     "anthropic-proxy",
-    "token-counter",
-    "deepseek-proxy",
-    "llm-gateway",
-    "multi-llm",
-    "ai-gateway",
-    "groq",
-    "litellm-alternative",
-    "ai-proxy",
-    "llm-router",
-    "domain-routing",
-    "groq-proxy",
-    "qwen",
+    "query-routing",
     "gpt",
+    "chinese-ai",
+    "moonshot-kimi",
+    "routing-accuracy",
+    "cerebras-proxy",
     "openai-api",
-    "query-routing",
-    "aleph-alpha",
-    "semantic-cache",
+    "kimi",
+    "model-selection",
+    "no-gpu",
+    "ai-load-balancer",
+    "routellm-alternative",
+    "token-counter",
+    "smart-routing",
+    "model-management",
+    "deepseek",
+    "task-routing",
+    "ollama-proxy",
     "langchain",
-    "ai-guardrails",
-    "chatbot"
+    "llm-failover",
+    "mistral-proxy",
+    "openai-compatible",
+    "semantic-cache",
+    "llm"
   ],
   "author": "Das-rebel <subho@example.com>",
   "license": "MIT",

package/dist/index.d.ts.map

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

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iBAAiB;;;AAgFjB,0CAcC;AA5FD,+DAA+D;AAC/D,iBAAiB;AACjB,+DAA+D;AAC/D,2DAQkC;AAPhC,4GAAA,UAAU,OAAA;AACV,4GAAA,UAAU,OAAA;AACV,kHAAA,gBAAgB,OAAA;AAChB,sHAAA,oBAAoB,OAAA;AACpB,gHAAA,cAAc,OAAA;AACd,oHAAA,kBAAkB,OAAA;AAClB,mHAAA,iBAAiB,OAAA;AAGnB,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;AAC/D,6DAYoC;AAXlC,mHAAA,iBAAiB,OAAA;AACjB,uHAAA,qBAAqB,OAAA;AACrB,kHAAA,gBAAgB,OAAA;AAChB,oHAAA,kBAAkB,OAAA;AAClB,gHAAA,cAAc,OAAA;AACd,6GAAA,WAAW,OAAA;AACX,mHAAA,iBAAiB,OAAA;AACjB,+HAAA,6BAA6B,OAAA;AAC7B,8HAAA,4BAA4B,OAAA;AAC5B,4GAAA,UAAU,OAAA;AACV,4GAAA,UAAU,OAAA;AAWZ,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAC/D,kDAAiD;AAAxC,0GAAA,WAAW,OAAA;AAEpB,+DAA+D;AAC/D,SAAS;AACT,+DAA+D;AAC/D,kDAAiD;AAAxC,wGAAA,UAAU,OAAA;AAGnB,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;AAC/D,iDAAiE;AAAxD,yGAAA,WAAW,OAAA;AAAE,4GAAA,cAAc,OAAA;AACpC,iDAAiD;AAAxC,yGAAA,WAAW,OAAA;AAEpB,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAC/D,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,oDAAwD;AAA/C,6GAAA,eAAe,OAAA;AACxB,2DAA0D;AAAjD,8GAAA,aAAa,OAAA;AACtB,oDAAyD;AAAhD,gHAAA,iBAAiB,OAAA;AAE1B,+DAA+D;AAC/D,wCAAwC;AACxC,+DAA+D;AAC/D,6DAAoF;AACpF,+DAAgF;AAChF,oDAAiD;AACjD,oDAAiD;AASjD,SAAgB,eAAe,CAAC,OAA0B;IACxD,MAAM,WAAW,GAAG,IAAI,yBAAW,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,uBAAU,EAAE,CAAC;IAEpC,OAAO;QACL,KAAK,EAAE,2BAAU;QACjB,UAAU,EAAV,2BAAU;QACV,gBAAgB,EAAhB,iCAAgB;QAChB,qBAAqB,EAArB,sCAAqB;QACrB,WAAW,EAAX,4BAAW;QACX,WAAW;QACX,UAAU;QACV,OAAO,EAAE,OAAO,IAAI,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,iBAAiB;AACjB,kBAAe,eAAe,CAAC"}

package/dist/sdk.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAcH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;IAC3C,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAuB;gBAE5B,MAAM,GAAE,eAAoB;IAIxC;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAgBnC;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE;IAK9C;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAKtC;;;;;OAKG;IACG,KAAK,CAAC,IAAI,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjD;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAIrC;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,SAAS,CAE7D"}

package/dist/sdk.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AAqKH,8BAEC;AArKD,6DAKkC;AAClC,sDAAyD;AAoDzD,+DAA+D;AAC/D,sBAAsB;AACtB,+DAA+D;AAE/D,MAAa,SAAS;IACZ,MAAM,CAAkB;IACxB,SAAS,GAAkB,IAAI,CAAC;IAExC,YAAY,SAA0B,EAAE;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAa;QACjB,MAAM,QAAQ,GAAG,IAAA,qCAAoB,EAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAA,2BAAU,EAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAExD,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,aAAa,IAAI,SAAS;YACxC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5C,IAAI,EAAE,MAAM,CAAC,cAAc,IAAI,CAAC;YAChC,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;YACjC,cAAc,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;YAC5C,MAAM,EAAE,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,KAAK,CAAC;YAC1C,QAAQ,EAAE,QAAQ,CAAC,UAAU,IAAI,IAAI;SACtC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,OAAiB;QAC1B,IAAA,2BAAU,EAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;QAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,IAAY;QACpB,IAAA,iCAAgB,EAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,IAAI;QAC7B,IAAA,+BAAiB,EAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,oBAAoB,IAAI,KAAK,CAAC;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,IAAI,0BAA0B,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAa;QACnB,OAAO,IAAA,qCAAoB,EAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACK,YAAY,CAClB,UAAkB;QAElB,IAAI,UAAU,GAAG,IAAI;YAAE,OAAO,MAAM,CAAC;QACrC,IAAI,UAAU,GAAG,IAAI;YAAE,OAAO,OAAO,CAAC;QACtC,IAAI,UAAU,GAAG,IAAI;YAAE,OAAO,KAAK,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AA7FD,8BA6FC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,MAAwB;IAChD,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/test.js.bak

@@ -1,376 +0,0 @@
-#!/usr/bin/env node
-/**
- * A3M Router Test Suite v1.9.0
- * Comprehensive tests for generic provider system
- */
-
-const assert = require('assert');
-const {
-  createA3MRouter,
-  getAvailableProviders,
-  registerProvider,
-  deregisterProvider,
-  DEFAULT_PROVIDERS,
-  providerConfig,
-  routeQuery,
-  routeBatch,
-  recommendForTask,
-  extractQueryFeatures,
-  MODEL_PROFILES,
-  countTokens,
-  estimateCost,
-  MemoryTree,
-  CostTracker,
-  ResponseCache,
-  ProviderRegistry,
-} = require('./dist/index.js');
-
-let passed = 0;
-let failed = 0;
-
-function test(name, fn) {
-  try {
-    fn();
-    console.log('  ✅ ' + name);
-    passed++;
-  } catch (e) {
-    console.log('  ❌ ' + name + ': ' + e.message);
-    failed++;
-  }
-}
-
-function asyncTest(name, fn) {
-  return fn()
-    .then(() => {
-      console.log('  ✅ ' + name);
-      passed++;
-    })
-    .catch(e => {
-      console.log('  ❌ ' + name + ': ' + e.message);
-      failed++;
-    });
-}
-
-console.log('\n═══════════════════════════════════════════════════════════════');
-console.log('🧪 A3M Router Test Suite v1.9.0');
-console.log('═══════════════════════════════════════════════════════════════\n');
-
-// ============================================================
-// TEST 1: Provider Configuration
-// ============================================================
-console.log('📦 Provider Configuration Tests');
-console.log('─────────────────────────────────────────────────────────────');
-
-test('providerConfig module loads', () => {
-  assert(providerConfig, 'providerConfig should be defined');
-  assert(typeof providerConfig.loadConfig === 'function', 'loadConfig should be a function');
-  assert(typeof providerConfig.getAvailableProviders === 'function', 'getAvailableProviders should be a function');
-});
-
-test('DEFAULT_PROVIDERS has expected providers', () => {
-  assert(DEFAULT_PROVIDERS, 'DEFAULT_PROVIDERS should be defined');
-  assert(DEFAULT_PROVIDERS.groq, 'should have groq');
-  assert(DEFAULT_PROVIDERS.mistral, 'should have mistral');
-  assert(DEFAULT_PROVIDERS.cerebras, 'should have cerebras');
-  assert(DEFAULT_PROVIDERS.commandcode, 'should have commandcode');
-  assert(DEFAULT_PROVIDERS.opencode, 'should have opencode');
-});
-
-test('getAvailableProviders returns configured providers', () => {
-  const available = getAvailableProviders();
-  assert(available, 'should return available providers');
-  assert(Object.keys(available).length > 0, 'should have at least one provider');
-  
-  // Check that available providers have required fields
-  for (const [id, p] of Object.entries(available)) {
-    assert(p.id, 'provider should have id');
-    assert(p.name, 'provider should have name');
-    assert(p.type, 'provider should have type');
-    assert(p.models, 'provider should have models');
-    assert(Array.isArray(p.models), 'models should be an array');
-  }
-});
-
-test('Provider types are correct', () => {
-  const available = getAvailableProviders();
-  
-  if (available.groq) {
-    assert.strictEqual(available.groq.type, 'api', 'groq should be api type');
-  }
-  if (available.commandcode) {
-    assert.strictEqual(available.commandcode.type, 'cli', 'commandcode should be cli type');
-  }
-  if (available.opencode) {
-    assert.strictEqual(available.opencode.type, 'cli', 'opencode should be cli type');
-  }
-});
-
-// ============================================================
-// TEST 2: Routing
-// ============================================================
-console.log('\n🔀 Routing Tests');
-console.log('─────────────────────────────────────────────────────────────');
-
-test('routeQuery returns valid result', () => {
-  const result = routeQuery('What is 2+2?');
-  assert(result, 'should return a result');
-  assert(result.primary_model, 'should have primary_model');
-  assert(Array.isArray(result.fallback_models), 'should have fallback_models array');
-  assert(typeof result.estimated_cost === 'number', 'should have estimated_cost');
-  assert(typeof result.confidence === 'number', 'should have confidence');
-});
-
-test('routeQuery selects free providers for simple queries', () => {
-  const result = routeQuery('Hello');
-  assert(result.primary_model, 'should have primary_model');
-  // Should prefer free/cheap providers for simple queries
-  assert(result.estimated_cost < 0.5, 'should have low cost for simple query');
-});
-
-test('routeQuery selects appropriate provider for code', () => {
-  const result = routeQuery('Write a Python function to sort an array');
-  assert(result.primary_model, 'should have primary_model');
-  assert(result.reasoning, 'should have reasoning');
-  // Should mention code in reasoning
-  assert(result.reasoning.toLowerCase().includes('code') || 
-         result.features.has_code, 'should detect code');
-});
-
-test('routeBatch returns array of results', () => {
-  const queries = ['Hello', 'What is 2+2?', 'Write Python code'];
-  const results = routeBatch(queries);
-  assert(Array.isArray(results), 'should return array');
-  assert.strictEqual(results.length, queries.length, 'should have same length as queries');
-  
-  results.forEach((r, i) => {
-    assert(r.primary_model, 'result ' + i + ' should have primary_model');
-  });
-});
-
-test('recommendForTask returns recommendation', () => {
-  const rec = recommendForTask('coding');
-  assert(rec, 'should return recommendation');
-  assert(rec.primary, 'should have primary');
-  assert(Array.isArray(rec.fallbacks), 'should have fallbacks array');
-  assert(rec.reason, 'should have reason');
-});
-
-test('extractQueryFeatures detects code', () => {
-  const features = extractQueryFeatures('function test() { return 1; }');
-  assert(features.has_code, 'should detect code');
-  assert(features.complexity > 0.3, 'should have elevated complexity');
-});
-
-test('extractQueryFeatures detects math', () => {
-  const features = extractQueryFeatures('Calculate the integral of x^2');
-  assert(features.has_math, 'should detect math');
-});
-
-test('extractQueryFeatures detects translation', () => {
-  const features = extractQueryFeatures('Translate hello to French');
-  assert(features.is_translation, 'should detect translation');
-});
-
-// ============================================================
-// TEST 3: Model Profiles
-// ============================================================
-console.log('\n📊 Model Profile Tests');
-console.log('─────────────────────────────────────────────────────────────');
-
-test('MODEL_PROFILES is populated', () => {
-  assert(MODEL_PROFILES, 'MODEL_PROFILES should be defined');
-  assert(Object.keys(MODEL_PROFILES).length > 0, 'should have model profiles');
-});
-
-test('Model profiles have required fields', () => {
-  for (const [name, profile] of Object.entries(MODEL_PROFILES)) {
-    assert(profile.name, name + ' should have name');
-    assert(profile.provider, name + ' should have provider');
-    assert(typeof profile.cost_per_1k_input === 'number', name + ' should have cost_per_1k_input');
-    assert(typeof profile.cost_per_1k_output === 'number', name + ' should have cost_per_1k_output');
-    assert(typeof profile.quality_score === 'number', name + ' should have quality_score');
-    assert(Array.isArray(profile.strengths), name + ' should have strengths array');
-  }
-});
-
-// ============================================================
-// TEST 4: Token Utilities
-// ============================================================
-console.log('\n🔢 Token Utility Tests');
-console.log('─────────────────────────────────────────────────────────────');
-
-test('countTokens returns number', () => {
-  const tokens = countTokens('Hello world');
-  assert(typeof tokens === 'number', 'should return number');
-  assert(tokens > 0, 'should return positive number');
-});
-
-test('countTokens counts correctly', () => {
-  const tokens = countTokens('Hello world');
-  assert(tokens >= 2, 'should count at least 2 tokens for 2 words');
-});
-
-test('estimateCost returns number', () => {
-  const cost = estimateCost(100, 50, 'gpt-4o');
-  assert(typeof cost === 'number', 'should return number');
-  assert(cost >= 0, 'should return non-negative');
-});
-
-// ============================================================
-// TEST 5: A3M Router Factory
-// ============================================================
-console.log('\n🏭 A3M Router Factory Tests');
-console.log('─────────────────────────────────────────────────────────────');
-
-test('createA3MRouter returns router object', () => {
-  const router = createA3MRouter({});
-  assert(router, 'should return router');
-  assert(typeof router.route === 'function', 'should have route function');
-  assert(typeof router.routeBatch === 'function', 'should have routeBatch function');
-  assert(typeof router.recommend === 'function', 'should have recommend function');
-});
-
-test('createA3MRouter has memory', () => {
-  const router = createA3MRouter({});
-  assert(router.memory, 'should have memory');
-  assert(typeof router.memory.add === 'function', 'memory should have add');
-  assert(typeof router.memory.search === 'function', 'memory should have search');
-});
-
-test('createA3MRouter has cache', () => {
-  const router = createA3MRouter({});
-  assert(router.cache, 'should have cache');
-});
-
-test('createA3MRouter has costTracker', () => {
-  const router = createA3MRouter({});
-  assert(router.costTracker, 'should have costTracker');
-});
-
-test('createA3MRouter has providers registry', () => {
-  const router = createA3MRouter({});
-  assert(router.providers, 'should have providers');
-});
-
-test('createA3MRouter has compression', () => {
-  const router = createA3MRouter({});
-  assert(router.compression, 'should have compression');
-});
-
-test('createA3MRouter has vault', () => {
-  const router = createA3MRouter({});
-  assert(router.vault, 'should have vault');
-});
-
-test('createA3MRouter has autoFetch', () => {
-  const router = createA3MRouter({});
-  assert(router.autoFetch, 'should have autoFetch');
-});
-
-test('createA3MRouter has oauth', () => {
-  const router = createA3MRouter({});
-  assert(router.oauth, 'should have oauth');
-});
-
-// ============================================================
-// TEST 6: Memory Tree
-// ============================================================
-console.log('\n🧠 Memory Tree Tests');
-console.log('─────────────────────────────────────────────────────────────');
-
-test('MemoryTree can add and search', () => {
-  const memory = new MemoryTree({ maxSize: 100 });
-  memory.add('Python is great for data science', { tags: ['python', 'data'] });
-  memory.add('JavaScript is great for web', { tags: ['js', 'web'] });
-  
-  const results = memory.search('python data');
-  assert(Array.isArray(results), 'should return array');
-  assert(results.length > 0, 'should find results');
-});
-
-test('MemoryTree getStats returns stats', () => {
-  const memory = new MemoryTree({ maxSize: 100 });
-  memory.add('Test entry', { tags: ['test'] });
-  
-  const stats = memory.getStats();
-  assert(stats, 'should return stats');
-  assert(typeof stats.totalChunks === 'number', 'should have totalChunks');
-  assert(typeof stats.indexSize === 'number', 'should have indexSize');
-});
-
-// ============================================================
-// TEST 7: Provider Registry
-// ============================================================
-console.log('\n📋 Provider Registry Tests');
-console.log('─────────────────────────────────────────────────────────────');
-
-test('ProviderRegistry can be instantiated', () => {
-  const registry = new ProviderRegistry();
-  assert(registry, 'should create registry');
-  assert(typeof registry.getReadyProviders === 'function', 'should have getReadyProviders');
-  assert(typeof registry.selectModel === 'function', 'should have selectModel');
-});
-
-test('ProviderRegistry getStatus returns status', () => {
-  const registry = new ProviderRegistry();
-  const status = registry.getStatus();
-  assert(status, 'should return status');
-  assert(Array.isArray(status.providers), 'should have providers array');
-  assert(Array.isArray(status.available), 'should have available array');
-});
-
-// ============================================================
-// TEST 8: Dynamic Provider Registration
-// ============================================================
-console.log('\n🔧 Dynamic Provider Registration Tests');
-console.log('─────────────────────────────────────────────────────────────');
-
-test('registerProvider adds new provider', () => {
-  const testProvider = {
-    name: 'TestProvider',
-    type: 'api',
-    baseUrl: 'https://test.example.com',
-    models: ['test-model'],
-    priority: 99,
-  };
-  
-  registerProvider('test-provider', testProvider);
-  
-  // Check it was added to runtime providers
-  const available = getAvailableProviders();
-  // Note: won't show up without API key, but should be in _providers
-  assert(providerConfig._providers['test-provider'], 'should be in _providers');
-  assert.strictEqual(providerConfig._providers['test-provider'].name, 'TestProvider');
-  
-  // Clean up
-  deregisterProvider('test-provider');
-});
-
-test('deregisterProvider removes provider', () => {
-  // First add
-  registerProvider('temp-provider', { name: 'Temp', type: 'api', models: [] });
-  assert(providerConfig._providers['temp-provider'], 'should exist in _providers');
-  
-  // Then remove
-  deregisterProvider('temp-provider');
-  assert(!providerConfig._providers['temp-provider'], 'should be removed from _providers');
-});
-
-// ============================================================
-// SUMMARY
-// ============================================================
-console.log('\n═══════════════════════════════════════════════════════════════');
-console.log('📊 Test Summary');
-console.log('═══════════════════════════════════════════════════════════════');
-console.log('  Total:  ' + (passed + failed));
-console.log('  Passed:  ' + passed + ' ✅');
-console.log('  Failed:  ' + failed + (failed > 0 ? ' ❌' : ''));
-console.log('');
-
-if (failed > 0) {
-  console.log('❌ Some tests failed');
-  process.exit(1);
-} else {
-  console.log('✅ All tests passed!');
-  process.exit(0);
-}