adaptive-memory-multi-model-router 2.13.14 → 2.13.16

package/CHANGELOG.md

@@ -1,122 +1,24 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.9.5] - 2026-05-17
-
-### Added
-- 🔒 **Security Module**: Input validation, prompt injection detection, PII detection
-- 🎯 **GEO Module**: Generative Engine Optimization for AI discoverability
-- 🛡️ Content filtering for hate speech, self-harm, illegal content
-- 📊 Rate limiting with configurable thresholds
-- 🤖 Intent-to-code mapping for AI assistants
-- 📰 6 new articles for LLM discoverability
-- 🎨 SVG logo, banner, and social preview assets
-- 📝 CONTRIBUTING.md, CHANGELOG.md, CODE_OF_CONDUCT.md
-- 🐛 GitHub issue templates and PR template
-- ⚙️ GitHub Action for NPM stats validation
-
-### Changed
-- 📈 Updated README with visual assets and better structure
-- 🔍 Added 17 new keywords for security and GEO
-- 📦 156 total keywords for maximum discoverability
-
-## [1.9.4] - 2026-05-17
-
-### Added
-- 📱 WhatsApp integration export
-- 💬 WhatsApp-Telegram bridge example
-- 🎮 Interactive bridge demo
-
-## [1.9.3] - 2026-05-17
-
-### Added
-- 🧪 Comprehensive test framework (33 tests)
-- 📊 Provider benchmark script
-- 🏥 Provider health check functionality
-
-## [1.9.2] - 2026-05-17
-
-### Added
-- ⚙️ Generic provider configuration system
-- 🔧 User-configurable providers via JSON
-- 📝 Runtime provider registration
-- 🔄 Dynamic model profiles
-
-## [1.9.1] - 2026-05-17
-
-### Added
-- 🎯 Advanced routing with learned algorithm
-- 💰 Cost estimation and tracking
-- 🔄 Automatic fallback chains
-- 📦 12 provider support (API, CLI, Local)
-
-## [1.9.0] - 2026-05-17
-
-### Added
-- ✅ 133 comprehensive tests passing
-- 🎨 139 keywords for discoverability
-- 🔌 116 integrations
-- 📤 76 exports
-- 🖥️ 15 CLI commands
-- 🧠 Memory tree, auto-fetch, obsidian vault
-- 💾 Response caching, prefix caching
-- 🚀 Speculative decoding, batch processing
-
-## [1.8.1] - 2026-05-16
-
-### Fixed
-- 🔍 Memory tree search with punctuation
-- 🔤 Minimum word length for search (2 chars)
-
-## [1.8.0] - 2026-05-16
-
-### Fixed
-- 🐛 14 critical bugs including exports, CLI, cost tracking
-- 📝 CLI rewrite with proper commands
-- 💰 Cost command returning NaN
-
-## [1.7.3] - 2026-05-16
-
-### Added
-- 🔌 Providers subpath export
-
-## [1.7.2] - 2026-05-16
-
-### Added
-- 🧠 Memory API improvements
-
-## [1.7.1] - 2026-05-16
-
-### Added
-- 🏭 createA3MRouter factory function
-- 📤 Proper module exports
-
-## [1.7.0] - 2026-05-16
-
-### Added
-- 🏷️ 139 keywords for AI discoverability
-
-## [1.6.0] - 2026-05-15
-
-### Added
-- 🎉 Initial release
-- 🚀 Core routing functionality
-- 💾 Caching and cost tracking
-- 🔁 Retry and circuit breaker patterns
-
----
-
-## Release Statistics
-
-| Version | Downloads | Key Feature |
-|---------|-----------|-------------|
-| 1.9.5 | 320/day | Security + GEO |
-| 1.9.0 | 552/day | 133 tests passing |
-| 1.8.0 | Growing | Bug fixes |
-| 1.7.0 | Initial | 139 keywords |
-
-*Total: 872+ weekly downloads*
+## v2.13.x — TUI & DX (May 2026)
+- 🎨 **Sakura light pink terminal UI** — overlay box with `/route`, `/cost`, `/health`, `/models`, `/model`
+- 🏷️ **20 GitHub topics** — ai-gateway, caching, nvidia, tui, terminal
+- 📦 **54 npm keywords** — expanded discoverability
+- ⭐ **Star CTA** in README
+
+## v2.12.x — NVIDIA NIM + DeepSeek (May 2026)
+- 🚀 **NVIDIA NIM** — 10 free models (llama-3.1, nemotron, gemma, qwen)
+- 🇨🇳 **DeepSeek V4** — flash + pro models, cost-optimized routing
+- 💰 **Cost tracking** — `/cost` endpoint with by-provider breakdown
+- 📊 **npm visibility** — 10K downloads in 14 days
+
+## v2.9.x–v2.11.x — Growth (May 2026)
+- 📈 **npm search optimization** — keyword refinement, daily publishes
+- 🧪 **CI pipeline** — github actions build + test
+- 📖 **Documentation** — QUICK_START, USE_CASES, multi-language README
+
+## v2.0.x — Launch (May 2026)
+- 🔀 **47+ providers** with auto-routing
+- 🧠 **99.5% routing accuracy** with UCB1 + MCTS
+- 💾 **Semantic cache** with 30%+ hit rate
+- 📉 **62% cost savings** vs all-premium routing

package/CONTRIBUTING.md

@@ -1,38 +1,50 @@
 # Contributing to A3M Router
 
-Thank you for your interest in contributing! 
+Thanks for helping build the fastest-growing open-source LLM router! 🚀
 
-## Quick Start
+## Quick Setup
 
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+```bash
+git clone https://github.com/Das-rebel/a3m-router.git
+cd a3m-router
+npm install
+npm run build
+```
 
-## Areas We Need Help
+## Project Structure
 
-- 🌍 **New providers**: Add support for more LLM providers
-- 🧪 **Tests**: Improve test coverage
-- 📖 **Documentation**: Fix typos, add examples
-- 🐛 **Bug fixes**: Check open issues
-- 🎨 **Examples**: Add real-world usage examples
+```
+src/
+├── providers/     # 47+ LLM provider configurations
+├── routing/       # UCB1 + MCTS routing engine
+├── cache/         # Semantic deduplication cache
+├── proxy/         # OpenAI-compatible proxy server
+└── tui/           # Terminal UI overlay
+```
 
-## Development Setup
+## Development
 
 ```bash
-git clone https://github.com/Das-rebel/a3m-router.git
-cd adaptive-memory-multi-model-router
-npm install
-npm test
+npm run build      # Compile TypeScript
+npm test           # Run tests
+node dist/tui/dashboard.js  # Launch TUI
 ```
 
-## Code Style
+## PR Guidelines
+
+- Keep the package under 20KB (no ML deps)
+- Add provider configs in `src/providers/`
+- Route logic in `src/routing/`
+- TUI changes in `src/tui/`
+- Update CHANGELOG.md
+
+## Adding a Provider
 
-- TypeScript strict mode
-- No external dependencies in core routing logic
-- Keep the package small (<25 KB)
+1. Add config in `src/providers/providerConfig.ts`
+2. Set tier: `free` / `cheap` / `mid` / `premium`
+3. Add to `PROVIDER_TIERS` map
+4. PR with latency benchmarks
 
-## License
+## Questions?
 
-By contributing, you agree that your contributions will be licensed under the MIT License.
+Open an issue or reach out on [GitHub Discussions](https://github.com/Das-rebel/a3m-router/discussions).

package/README.md

@@ -17,6 +17,34 @@
 
 ### Quick Start: [`docs/QUICK_START.md`](./docs/QUICK_START.md)
 
+> **⭐ If A3M Router saves you money, star the repo!** → [github.com/Das-rebel/a3m-router](https://github.com/Das-rebel/a3m-router)
+
+### 💅 Terminal UI
+
+```bash
+node dist/tui/dashboard.js
+```
+
+Sakura pink overlay box. `/route` `/cost` `/health` `/models` `/model <provider>`. Type to auto-route.
+
+```
+╭──────────────────────────────────────────────────────────────────────╮
+│ ⚡ A3M Router  ·  nvidia/llama-3.1-8b  ·  4 req  ·  $0.000087       │
+│ ──────────────────────────────────────────────────────────────────── │
+│                                                                      │
+│   Type a query — auto-routed to cheapest model.                      │
+│                                                                      │
+│   Commands:                                                          │
+│   /route <query>       /cost              /model nvidia               │
+│   /health              /models            /clear                      │
+│   /exit                /help                                          │
+│                                                                      │
+│   nvidia (free)  ·  groq (free)  ·  deepseek ($9.46)                 │
+│                                                                      │
+│  ▸ _                                                                 │
+╰──────────────────────────────────────────────────────────────────────╯
+```
+
 ### 📊 By the Numbers
 
 | Metric | Value | Context |

package/dist/cli.js

@@ -17,6 +17,7 @@
  *   npx a3m-router models                  List known models
  *   npx a3m-router memory add/search/stats Memory operations
  *   npx a3m-router status                  Show router status
+ *   npx a3m-router tui                    Launch terminal UI overlay
  */
 
 const { execSync } = require('child_process');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adaptive-memory-multi-model-router",
-  "version": "2.13.14",
+  "version": "2.13.16",
   "shortName": "A3M Router",
   "displayName": "A3M Router - Adaptive Memory Multi-Model Router",
   "description": "🔥 Fastest-growing npm LLM router — 0 to 10K downloads in 14 days. Parallel multi-LLM execution with independent benchmark validation (138ms baseline, +96ms proxy overhead), 47+ providers, 99.5% routing accuracy, 62% cost savings. Open-source AI gateway with ensemble voting, semantic cache, budget enforcement. 19.5 KB, zero ML.",
@@ -55,46 +55,60 @@
     }
   },
   "keywords": [
-    "llm-router",
     "ai-gateway",
-    "llm-gateway",
-    "multi-llm",
-    "parallel-llm",
-    "openai-proxy",
-    "llm-proxy",
-    "cost-optimization",
     "ai-infrastructure",
-    "routing",
-    "provider-routing",
-    "model-routing",
-    "llm-routing",
-    "parallel-execution",
-    "ensemble-voting",
-    "confidence-scoring",
-    "semantic-cache",
-    "circuit-breaker",
-    "budget-enforcement",
-    "prompt-guardrails",
-    "llm-security",
-    "groq",
     "anthropic",
-    "openai",
+    "api-gateway",
+    "artificial-intelligence",
+    "budget",
+    "budget-control",
+    "budget-enforcement",
+    "caching",
+    "chat",
+    "circuit-breaker",
+    "cli-tool",
+    "confidence-scoring",
+    "cost-optimization",
+    "cost-tracker",
+    "cross-provider",
     "deepseek",
-    "nvidia",
+    "devtools",
+    "ensemble-voting",
+    "free-llm",
     "gemini",
+    "groq",
+    "independent-benchmark",
+    "llm",
+    "llm-cost",
+    "llm-gateway",
+    "llm-proxy",
+    "llm-router",
+    "llm-routing",
+    "llm-security",
+    "machine-learning",
     "mistral",
-    "typescript",
+    "model-routing",
+    "multi-llm",
+    "multi-provider",
     "nodejs",
+    "nvidia",
+    "nvidia-free",
+    "nvidia-nim",
     "open-source",
-    "llm",
-    "artificial-intelligence",
-    "machine-learning",
-    "api-gateway",
-    "devtools",
-    "independent-benchmark",
+    "openai",
+    "openai-proxy",
+    "overlay",
+    "parallel-execution",
+    "parallel-llm",
+    "prompt-guardrails",
+    "provider-routing",
+    "repl",
+    "routing",
+    "semantic-cache",
+    "terminal-ui",
     "third-party-validation",
-    "multi-provider",
-    "cross-provider"
+    "tui",
+    "typescript"
   ],
   "author": "Das-rebel <subho@example.com>",
   "license": "MIT",