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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (598) hide show
  1. package/{docs/llms.txt → llms.txt.bak} +6 -6
  2. package/package.json +270 -72
  3. package/src/routing/advancedRouter.ts.bak +650 -0
  4. package/test.js.bak +376 -0
  5. package/.dockerignore +0 -82
  6. package/.env.example +0 -303
  7. package/.github/DISCUSSIONS_WELCOME.md +0 -27
  8. package/.github/DISCUSSION_TEMPLATE.yml +0 -5
  9. package/.github/FUNDING.yml +0 -2
  10. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -94
  11. package/.github/ISSUE_TEMPLATE/config.yml +0 -17
  12. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -71
  13. package/.github/PULL_REQUEST_TEMPLATE.md +0 -71
  14. package/.github/dependabot.yml +0 -9
  15. package/.github/workflows/auto-publish.yml +0 -51
  16. package/.github/workflows/ci.yml +0 -263
  17. package/.github/workflows/codeql.yml +0 -38
  18. package/.github/workflows/npm-publish.yml +0 -20
  19. package/.github/workflows/pages.yml +0 -37
  20. package/.github/workflows/stale.yml +0 -54
  21. package/.publish-tick +0 -1
  22. package/.well-known/ai-plugin.json +0 -16
  23. package/AGENT_COUNCIL_FINDINGS.md +0 -142
  24. package/ARCHITECTURE.md +0 -346
  25. package/AUDIT_REPORT.md +0 -28
  26. package/CODE_OF_CONDUCT.md +0 -128
  27. package/CONTRIBUTING.md +0 -50
  28. package/CONTRIBUTORS.md +0 -20
  29. package/Dockerfile +0 -53
  30. package/Dockerfile.proxy +0 -33
  31. package/HEALTH_REPORT.md +0 -118
  32. package/IMPROVEMENT_PLAN.md +0 -107
  33. package/LANDING.md +0 -43
  34. package/LAUNCH-PAIN-DRIVEN.md +0 -339
  35. package/LAUNCH.md +0 -337
  36. package/LAUNCH_CHECKLIST.md +0 -141
  37. package/LAUNCH_SNAPSHOT.md +0 -260
  38. package/MANIFESTO.md +0 -41
  39. package/POPULARITY_BOOSTERS.md +0 -285
  40. package/PR_STATUS_REPORT.md +0 -148
  41. package/REDESIGN.md +0 -95
  42. package/RUNKIT.md +0 -83
  43. package/SECURITY.md +0 -29
  44. package/SUBMISSIONS.md +0 -43
  45. package/_schema.html +0 -53
  46. package/ai-plugin.json +0 -16
  47. package/articles/AI_AGENT_LLM_ROUTING.md +0 -150
  48. package/articles/CHINESE_DIRECTORIES.md +0 -100
  49. package/articles/CHINESE_SUBMISSIONS_READY.md +0 -322
  50. package/articles/COMPETITOR_ALERTS.md +0 -31
  51. package/articles/COMPLETE_POSTING_DIRECTORY.md +0 -147
  52. package/articles/CONTENT_STRUCTURE.md +0 -292
  53. package/articles/DEVTO_COST_GUIDE.md +0 -473
  54. package/articles/DEVTO_FINAL.md +0 -416
  55. package/articles/DEVTO_MULTI_PROVIDER.md +0 -542
  56. package/articles/DEVTO_READY.md +0 -255
  57. package/articles/DEVTO_V2_ANNOUNCEMENT.md +0 -160
  58. package/articles/DEVTO_VIRAL_GROWTH.md +0 -280
  59. package/articles/FRESH_devto.md +0 -460
  60. package/articles/FRESH_devto_2026_05.md +0 -73
  61. package/articles/FRESH_hackernews.md +0 -14
  62. package/articles/FRESH_reddit_ml.md +0 -90
  63. package/articles/FRESH_reddit_node.md +0 -198
  64. package/articles/FRESH_reddit_sideproject.md +0 -72
  65. package/articles/FRESH_reddit_webdev.md +0 -130
  66. package/articles/FROM_ZERO_TO_10K.md +0 -107
  67. package/articles/HN_10X_BETTER.md +0 -430
  68. package/articles/HN_ACCOUNT_GUIDE.md +0 -21
  69. package/articles/HN_CHINESE_STYLE.md +0 -308
  70. package/articles/HN_FINAL.md +0 -148
  71. package/articles/HN_POSTED_VERSION.md +0 -56
  72. package/articles/HN_POST_READY.md +0 -137
  73. package/articles/HN_RESEARCH.md +0 -364
  74. package/articles/HN_SHOW_routerarena.md +0 -17
  75. package/articles/HN_TIMING_GUIDE.md +0 -52
  76. package/articles/INDIEHACKERS_POST.md +0 -52
  77. package/articles/INDIEHACKERS_READY.md +0 -120
  78. package/articles/LLM_BENCHMARK_DEEP_DIVE.md +0 -153
  79. package/articles/MASTER_POSTING_DIRECTORY.md +0 -189
  80. package/articles/NEWSLETTER_SEND_NOW.md +0 -259
  81. package/articles/NEWSLETTER_SUBMISSIONS.md +0 -112
  82. package/articles/PAIN-DRIVEN-devto-v2.md +0 -308
  83. package/articles/PAIN-DRIVEN-devto-v3.md +0 -268
  84. package/articles/PAIN-DRIVEN-devto.md +0 -242
  85. package/articles/PAIN-DRIVEN-hackernews-v2.md +0 -138
  86. package/articles/PAIN-DRIVEN-hackernews-v3.md +0 -151
  87. package/articles/PAIN-DRIVEN-hackernews.md +0 -131
  88. package/articles/PAIN-DRIVEN-reddit-v2.md +0 -301
  89. package/articles/PAIN-DRIVEN-reddit-v3.md +0 -236
  90. package/articles/PAIN-DRIVEN-reddit.md +0 -218
  91. package/articles/PAIN-DRIVEN-twitter-v2.md +0 -110
  92. package/articles/PAIN-DRIVEN-twitter-v3.md +0 -121
  93. package/articles/PAIN-DRIVEN-twitter.md +0 -120
  94. package/articles/PORTKEY_VS_A3M.md +0 -147
  95. package/articles/POSTING_KIT_2026_05.md +0 -67
  96. package/articles/PRESS_KIT_routerarena.md +0 -77
  97. package/articles/PRODUCTHUNT_LISTING.md +0 -48
  98. package/articles/PRODUCTHUNT_READY.md +0 -106
  99. package/articles/PR_PLAN_vault.md +0 -125
  100. package/articles/REDDIT_FINAL.md +0 -232
  101. package/articles/REDDIT_POST.md +0 -67
  102. package/articles/REDDIT_SUBMISSION_READY.md +0 -348
  103. package/articles/ROUTERARENA_LEADER.md +0 -45
  104. package/articles/SHOW_HN_FINAL.md +0 -29
  105. package/articles/TWEETS_10K_DOWNLOADS.md +0 -47
  106. package/articles/TWEETS_BENCHMARK_FIRST.md +0 -46
  107. package/articles/TWEETS_MCP_PLAY.md +0 -51
  108. package/articles/TWEETS_SEQUENTIAL_BROKEN.md +0 -49
  109. package/articles/TWEETS_WHY_BUILD.md +0 -54
  110. package/articles/TWEETS_routerarena_leader.md +0 -53
  111. package/articles/TWEET_STORM_READY.md +0 -165
  112. package/articles/TWITTER_FINAL.md +0 -167
  113. package/articles/WHY_10X_BETTER.md +0 -261
  114. package/articles/WHY_CHINESE_STYLE_BETTER.md +0 -323
  115. package/articles/ai-discoverability-llm-routing.md +0 -210
  116. package/articles/devto-llm-routing.md +0 -138
  117. package/articles/hackernews-show-hn.md +0 -54
  118. package/articles/hashnode-llm-cost-optimization.md +0 -125
  119. package/articles/hn_show_2026_05.md +0 -11
  120. package/articles/medium-building-llm-router.md +0 -205
  121. package/articles/reddit-ml.md +0 -76
  122. package/articles/twitter-thread-cost-savings.md +0 -50
  123. package/articles/youtube-tutorial-script.md +0 -262
  124. package/assets/a3m_3blue1brown.mp4 +0 -0
  125. package/assets/banner.svg +0 -109
  126. package/assets/chart-cost-v2.svg +0 -91
  127. package/assets/chart-cost-v3.svg +0 -143
  128. package/assets/chart-features-v2.svg +0 -132
  129. package/assets/chart-features-v3.svg +0 -211
  130. package/assets/chart-growth-v2.svg +0 -122
  131. package/assets/chart-growth-v3.svg +0 -189
  132. package/assets/cost-comparison.svg +0 -134
  133. package/assets/cost-simple.svg +0 -64
  134. package/assets/demo-hn.gif +0 -0
  135. package/assets/feature-matrix.svg +0 -136
  136. package/assets/growth-chart-animated.svg +0 -76
  137. package/assets/growth-chart.svg +0 -82
  138. package/assets/growth-simple.svg +0 -69
  139. package/assets/hero-diagram.svg +0 -81
  140. package/assets/logo-new.svg +0 -21
  141. package/assets/logo.svg +0 -68
  142. package/assets/provider-comparison.svg +0 -121
  143. package/assets/social-preview-new.svg +0 -100
  144. package/assets/social-preview.svg +0 -194
  145. package/assets/social-v2.svg +0 -130
  146. package/assets/social-v3.svg +0 -212
  147. package/benchmark-provider-results.json +0 -245
  148. package/benchmark-results.json +0 -54
  149. package/council-votes/architecture-vote.md +0 -121
  150. package/council-votes/coverage-vote.md +0 -93
  151. package/data/adaptive-benchmark.json +0 -92
  152. package/data/benchmark-results.json +0 -47
  153. package/data/labeled-benchmark.json +0 -88
  154. package/demo/3blue1brown_video.py +0 -285
  155. package/demo/3blue1brown_video_v2.py +0 -310
  156. package/demo/IMPROVED_PROMPTS.md +0 -229
  157. package/demo/VEO3_PROMPTS.md +0 -269
  158. package/demo/VIDEO_PRODUCTION_GUIDE.md +0 -333
  159. package/demo/a3m_3blue1brown.mp4 +0 -0
  160. package/demo/asciinema-demo.sh +0 -195
  161. package/demo/demo-hn.tape +0 -74
  162. package/demo/demo-script.md +0 -53
  163. package/demo/demo-script.sh +0 -62
  164. package/demo/demo.svg +0 -75
  165. package/demo/frame1_ai_data_center.png +0 -0
  166. package/demo/frame1_sunset_video.mp4 +0 -0
  167. package/demo/frame2_cost_comparison.png +0 -0
  168. package/demo/frame2_cost_comparison_fallback.png +0 -0
  169. package/demo/frame3_parallel_execution.png +0 -0
  170. package/demo/frame3_parallel_execution_fallback.png +0 -0
  171. package/demo/frame4_providers.png +0 -0
  172. package/demo/frame4_providers_fallback.png +0 -0
  173. package/demo/frame5_endcard.png +0 -0
  174. package/demo/frame5_endcard_fallback.png +0 -0
  175. package/demo/new_frame1_hook.png +0 -0
  176. package/demo/new_frame2_proof.png +0 -0
  177. package/demo/new_frame3_wow.png +0 -0
  178. package/demo/new_frame4_social.png +0 -0
  179. package/demo/new_frame5_cta.png +0 -0
  180. package/demo/package.json +0 -13
  181. package/demo/product-video-final.mp4 +0 -0
  182. package/demo/product-video-hype-v1.mp4 +0 -0
  183. package/demo/product-video-v1.mp4 +0 -0
  184. package/demo/public/index.html +0 -762
  185. package/demo/recording.cast +0 -55
  186. package/demo/server.js +0 -405
  187. package/demo-new.tape +0 -71
  188. package/demo-real.sh +0 -198
  189. package/demo-simple.tape +0 -205
  190. package/demo.html +0 -520
  191. package/demo.sh +0 -85
  192. package/demo.tape +0 -259
  193. package/dist/analytics/costAnalytics.d.ts.map +0 -1
  194. package/dist/analytics/costAnalytics.js.map +0 -1
  195. package/dist/benchmark/comprehensive.js.map +0 -1
  196. package/dist/benchmark/reproducible.d.ts.map +0 -1
  197. package/dist/benchmark/reproducible.js.map +0 -1
  198. package/dist/cache/prefixCache.d.ts.map +0 -1
  199. package/dist/cache/prefixCache.js.map +0 -1
  200. package/dist/cache/responseCache.d.ts.map +0 -1
  201. package/dist/cache/responseCache.js.map +0 -1
  202. package/dist/cache/semanticCache.d.ts.map +0 -1
  203. package/dist/cache/semanticCache.js.map +0 -1
  204. package/dist/cli/setupWizard.d.ts.map +0 -1
  205. package/dist/cli/setupWizard.js.map +0 -1
  206. package/dist/cost/budgetEnforcer.d.ts.map +0 -1
  207. package/dist/cost/budgetEnforcer.js.map +0 -1
  208. package/dist/cost/costTracker.d.ts.map +0 -1
  209. package/dist/cost/costTracker.js.map +0 -1
  210. package/dist/ensemble/multiRoundDialog.js.map +0 -1
  211. package/dist/ensemble/shapleyValue.js.map +0 -1
  212. package/dist/integrations/langchainAdapter.d.ts.map +0 -1
  213. package/dist/integrations/langchainAdapter.js.map +0 -1
  214. package/dist/integrations/oauth.d.ts.map +0 -1
  215. package/dist/integrations/oauth.js.map +0 -1
  216. package/dist/integrations/scienceAdapter.js.map +0 -1
  217. package/dist/memory/autoFetch.d.ts.map +0 -1
  218. package/dist/memory/autoFetch.js.map +0 -1
  219. package/dist/memory/episodicMemory.d.ts.map +0 -1
  220. package/dist/memory/episodicMemory.js.map +0 -1
  221. package/dist/memory/hybridMemory.js.map +0 -1
  222. package/dist/memory/memoryTree.d.ts.map +0 -1
  223. package/dist/memory/memoryTree.js.map +0 -1
  224. package/dist/memory/obsidianVault.d.ts.map +0 -1
  225. package/dist/memory/obsidianVault.js.map +0 -1
  226. package/dist/memory/reasoningBank.js.map +0 -1
  227. package/dist/observability/changeWatch.d.ts.map +0 -1
  228. package/dist/observability/changeWatch.js.map +0 -1
  229. package/dist/observability/fatigueDetector.d.ts.map +0 -1
  230. package/dist/observability/fatigueDetector.js.map +0 -1
  231. package/dist/observability/index.d.ts.map +0 -1
  232. package/dist/observability/index.js.map +0 -1
  233. package/dist/observability/metrics.d.ts.map +0 -1
  234. package/dist/observability/metrics.js.map +0 -1
  235. package/dist/observability/middleware.d.ts.map +0 -1
  236. package/dist/observability/middleware.js.map +0 -1
  237. package/dist/observability/tracer.d.ts.map +0 -1
  238. package/dist/observability/tracer.js.map +0 -1
  239. package/dist/observability/types.d.ts.map +0 -1
  240. package/dist/observability/types.js.map +0 -1
  241. package/dist/orchestration/haloOrchestrator.d.ts.map +0 -1
  242. package/dist/orchestration/haloOrchestrator.js.map +0 -1
  243. package/dist/orchestration/mctsWorkflow.d.ts.map +0 -1
  244. package/dist/orchestration/mctsWorkflow.js.map +0 -1
  245. package/dist/providers/localProvider.d.ts.map +0 -1
  246. package/dist/providers/localProvider.js.map +0 -1
  247. package/dist/providers/providerConfig.d.ts.map +0 -1
  248. package/dist/providers/providerConfig.js.map +0 -1
  249. package/dist/providers/registry.d.ts.map +0 -1
  250. package/dist/providers/registry.js.map +0 -1
  251. package/dist/routing/advancedRouter.d.ts.map +0 -1
  252. package/dist/routing/advancedRouter.js.map +0 -1
  253. package/dist/routing/crossModelValidation.d.ts.map +0 -1
  254. package/dist/routing/crossModelValidation.js.map +0 -1
  255. package/dist/routing/providerHealth.d.ts.map +0 -1
  256. package/dist/routing/providerHealth.js.map +0 -1
  257. package/dist/routing/providerRetry.d.ts.map +0 -1
  258. package/dist/routing/providerRetry.js.map +0 -1
  259. package/dist/scripts/banner.js +0 -29
  260. package/dist/security/guardrails.d.ts.map +0 -1
  261. package/dist/security/guardrails.js.map +0 -1
  262. package/dist/server/dashboard.d.ts.map +0 -1
  263. package/dist/server/dashboard.js.map +0 -1
  264. package/dist/server/modelMapper.d.ts.map +0 -1
  265. package/dist/server/modelMapper.js.map +0 -1
  266. package/dist/server/proxyServer.d.ts.map +0 -1
  267. package/dist/server/proxyServer.js.map +0 -1
  268. package/dist/skills/__tests__/skill_manager.test.d.ts +0 -2
  269. package/dist/skills/__tests__/skill_manager.test.d.ts.map +0 -1
  270. package/dist/skills/__tests__/skill_manager.test.js +0 -268
  271. package/dist/skills/__tests__/skill_manager.test.js.map +0 -1
  272. package/dist/tools/tmlpdTools.d.ts.map +0 -1
  273. package/dist/tools/tmlpdTools.js.map +0 -1
  274. package/dist/tui/dashboard.d.ts.map +0 -1
  275. package/dist/tui/dashboard.js.map +0 -1
  276. package/dist/tui/index.d.ts.map +0 -1
  277. package/dist/tui/index.js.map +0 -1
  278. package/dist/utils/batchProcessor.d.ts.map +0 -1
  279. package/dist/utils/batchProcessor.js.map +0 -1
  280. package/dist/utils/compression.d.ts.map +0 -1
  281. package/dist/utils/compression.js.map +0 -1
  282. package/dist/utils/costUtils.d.ts.map +0 -1
  283. package/dist/utils/costUtils.js.map +0 -1
  284. package/dist/utils/reliability.d.ts.map +0 -1
  285. package/dist/utils/reliability.js.map +0 -1
  286. package/dist/utils/sorting.d.ts.map +0 -1
  287. package/dist/utils/sorting.js.map +0 -1
  288. package/dist/utils/speculativeDecoding.d.ts.map +0 -1
  289. package/dist/utils/speculativeDecoding.js.map +0 -1
  290. package/dist/utils/tokenUtils.d.ts.map +0 -1
  291. package/dist/utils/tokenUtils.js.map +0 -1
  292. package/docs/.nojekyll +0 -0
  293. package/docs/ANALYSIS_PRINCIPLES.md +0 -162
  294. package/docs/API.md +0 -855
  295. package/docs/ARCHITECTURAL-IMPROVEMENTS-2025.md +0 -1391
  296. package/docs/ARCHITECTURAL-IMPROVEMENTS-REVISED-2025.md +0 -1051
  297. package/docs/BENCHMARK.md +0 -170
  298. package/docs/CHINESE_PROVIDER_RELIABILITY.md +0 -37
  299. package/docs/CITATIONS.md +0 -74
  300. package/docs/CLAIMS_AND_EVIDENCE.md +0 -58
  301. package/docs/CONFIGURATION.md +0 -476
  302. package/docs/COUNCIL_DECISION.json +0 -816
  303. package/docs/COUNCIL_SUMMARY.md +0 -319
  304. package/docs/COUNCIL_V2.2_DECISION.md +0 -416
  305. package/docs/ENGINEERING_SPEC.md +0 -55
  306. package/docs/FACTORY_RESET.md +0 -34
  307. package/docs/GEO.md +0 -66
  308. package/docs/GEO_OPTIMIZATION.md +0 -30
  309. package/docs/GEO_ROOT_CAUSE.md +0 -136
  310. package/docs/GEO_STATUS.md +0 -85
  311. package/docs/GEO_TEST_RESULTS.md +0 -176
  312. package/docs/HN_CHECKLIST.md +0 -38
  313. package/docs/HN_FOUNDER_COMMENT.md +0 -17
  314. package/docs/HN_SUBMISSION_FINAL.md +0 -180
  315. package/docs/HN_SUBMISSION_V3.md +0 -56
  316. package/docs/IMPROVEMENT_ROADMAP.md +0 -515
  317. package/docs/INTEGRATIONS.md +0 -420
  318. package/docs/LANGCHAIN_INTEGRATION.md +0 -147
  319. package/docs/LLM_COUNCIL_DECISION.md +0 -508
  320. package/docs/MIDDLEWARE_CHAIN.md +0 -35
  321. package/docs/PROMO_CHECKLIST.md +0 -200
  322. package/docs/QUICKSTART.md +0 -271
  323. package/docs/QUICK_START.md +0 -43
  324. package/docs/QUICK_START_VISIBILITY.md +0 -782
  325. package/docs/REDDIT_GAP_ANALYSIS.md +0 -299
  326. package/docs/RELEASE_CHECKLIST.md +0 -32
  327. package/docs/REPRODUCIBILITY.md +0 -63
  328. package/docs/RESEARCH_BACKED_IMPROVEMENTS.md +0 -1180
  329. package/docs/ROUTING_RUBRIC.md +0 -197
  330. package/docs/SEO_AUDIT.md +0 -186
  331. package/docs/SOCIAL_LISTENING.md +0 -219
  332. package/docs/TMLPD_QNA.md +0 -751
  333. package/docs/TMLPD_V2.1_COMPLETE.md +0 -763
  334. package/docs/TMLPD_V2.2_RESEARCH_ROADMAP.md +0 -754
  335. package/docs/UPDATE_TOPICS.md +0 -15
  336. package/docs/USE_CASES.md +0 -59
  337. package/docs/V2.2_IMPLEMENTATION_COMPLETE.md +0 -446
  338. package/docs/V2_IMPLEMENTATION_GUIDE.md +0 -388
  339. package/docs/VERCEL_AI_SDK.md +0 -209
  340. package/docs/VISIBILITY_ADOPTION_PLAN.md +0 -1005
  341. package/docs/_config.yml +0 -49
  342. package/docs/ai-plugin.json +0 -16
  343. package/docs/api.html +0 -513
  344. package/docs/architecture-diagram.md +0 -40
  345. package/docs/benchmark-chart.png +0 -0
  346. package/docs/benchmark.html +0 -387
  347. package/docs/blog/routerarena-number-one.html +0 -73
  348. package/docs/cli-cheatsheet.md +0 -339
  349. package/docs/compare.md +0 -109
  350. package/docs/comparison-litellm.md +0 -88
  351. package/docs/comparison.md +0 -108
  352. package/docs/cost-chart-ascii.md +0 -42
  353. package/docs/cost-comparison-chart.svg +0 -88
  354. package/docs/curl-examples.md +0 -247
  355. package/docs/demo-auto.html +0 -264
  356. package/docs/demo.html +0 -416
  357. package/docs/geo/GENERATIVE_ENGINE_OPTIMIZATION.md +0 -232
  358. package/docs/index.html +0 -507
  359. package/docs/launch-content/LAUNCH_EXECUTION_CHECKLIST.md +0 -421
  360. package/docs/launch-content/README.md +0 -457
  361. package/docs/launch-content/assets/cost_comparison_100_tasks.png +0 -0
  362. package/docs/launch-content/assets/cumulative_savings.png +0 -0
  363. package/docs/launch-content/assets/parallel_speedup.png +0 -0
  364. package/docs/launch-content/assets/provider_pricing_comparison.png +0 -0
  365. package/docs/launch-content/assets/task_breakdown_comparison.png +0 -0
  366. package/docs/launch-content/generate_charts.py +0 -313
  367. package/docs/launch-content/hn_show_post.md +0 -139
  368. package/docs/launch-content/partner_outreach_templates.md +0 -745
  369. package/docs/launch-content/reddit_posts.md +0 -467
  370. package/docs/launch-content/twitter_thread.txt +0 -460
  371. package/docs/npm-downloads-chart.svg +0 -43
  372. package/docs/openapi.json +0 -139
  373. package/docs/openapi.yaml +0 -1318
  374. package/docs/quick-start.html +0 -366
  375. package/docs/robots.txt +0 -52
  376. package/docs/sitemap.xml +0 -57
  377. package/docs/styles.css +0 -682
  378. package/docs/well-known/ai-plugin.json +0 -16
  379. package/docs/wellknown/ai-plugin.json +0 -16
  380. package/docs-site/assets/og-banner.svg +0 -194
  381. package/docs-site/index.html +0 -632
  382. package/eval/README.md +0 -46
  383. package/eval/baselines/main.json +0 -12
  384. package/eval/benchmark_dataset.jsonl +0 -16
  385. package/eval/check_golden_routes.js +0 -64
  386. package/eval/datasets/catalog.json +0 -33
  387. package/eval/datasets/slices/cn_provider_reliability_v1.jsonl +0 -3
  388. package/eval/datasets/slices/cost_pressure_v1.jsonl +0 -3
  389. package/eval/datasets/slices/safety_guardrails_v1.jsonl +0 -3
  390. package/eval/evals.json +0 -199
  391. package/eval/fault_injection_thresholds.json +0 -3
  392. package/eval/generate_report.js +0 -128
  393. package/eval/golden_routes.json +0 -114
  394. package/eval/lib/experiment_registry.js +0 -24
  395. package/eval/run_eval.js +0 -197
  396. package/eval/run_fault_injection.js +0 -201
  397. package/eval/run_shadow_eval.js +0 -85
  398. package/eval/thresholds.json +0 -9
  399. package/examples/QUICKSTART.md +0 -183
  400. package/examples/README.md +0 -61
  401. package/examples/a3m-sdk.js +0 -124
  402. package/examples/basic-route.js +0 -54
  403. package/examples/chat-loop.js +0 -202
  404. package/examples/classify-then-route.js +0 -102
  405. package/examples/cost-compare.js +0 -120
  406. package/examples/ensemble.js +0 -160
  407. package/examples/whatsapp-telegram-bridge-demo.js +0 -302
  408. package/examples/whatsapp-telegram-bridge.js +0 -269
  409. package/hf-space/README.md +0 -23
  410. package/hf-space/app.py +0 -240
  411. package/hf-space/requirements.txt +0 -1
  412. package/huggingface_space/README.md +0 -35
  413. package/huggingface_space/app.py +0 -126
  414. package/huggingface_space/create_space.py +0 -208
  415. package/huggingface_space/requirements.txt +0 -1
  416. package/mcp-server/README.md +0 -188
  417. package/mcp-server/package.json +0 -29
  418. package/mcp-server/src/index.ts +0 -744
  419. package/mcp-server/tsconfig.json +0 -19
  420. package/openclaw-alexa-bridge/ALL_REMAINING_FIXES_PLAN.md +0 -313
  421. package/openclaw-alexa-bridge/REMAINING_FIXES_SUMMARY.md +0 -277
  422. package/openclaw-alexa-bridge/src/alexa_handler_no_tmlpd.js +0 -1234
  423. package/openclaw-alexa-bridge/test_fixes.js +0 -77
  424. package/playground/README.md +0 -51
  425. package/playground/codesandbox.json +0 -12
  426. package/playground/index.js +0 -39
  427. package/proxy/README.md +0 -227
  428. package/proxy/package-lock.json +0 -831
  429. package/proxy/package.json +0 -17
  430. package/proxy/rate-limit.js +0 -145
  431. package/proxy/rate-limit.test.js +0 -311
  432. package/proxy/server.js +0 -970
  433. package/python/README.md +0 -102
  434. package/python/a3m/__init__.py +0 -6
  435. package/python/a3m/client.py +0 -190
  436. package/python/a3m/models.py +0 -40
  437. package/python/a3m/sync_client.py +0 -61
  438. package/python/examples.py +0 -53
  439. package/python/integrations.py +0 -330
  440. package/python/pyproject.toml +0 -23
  441. package/python/setup.py +0 -28
  442. package/python/tmlpd.py +0 -369
  443. package/qna/REDDIT_GAP_ANALYSIS.md +0 -299
  444. package/qna/TMLPD_QNA.md +0 -751
  445. package/research/FINDING_001_safety.md +0 -28
  446. package/research/FINDING_002_error_diversity.md +0 -32
  447. package/research/FINDING_003_confidence_weighted_voting.md +0 -32
  448. package/research/FINDING_004_cross_model_semantic_detection.md +0 -37
  449. package/research/FINDING_005_knowledge_gap_orthogonality.md +0 -34
  450. package/research/HALLUCINATION_RESEARCH.md +0 -27
  451. package/research/ensemble-voting.md +0 -324
  452. package/research/loss-functions.md +0 -545
  453. package/research-log.md +0 -49
  454. package/scripts/banner.js +0 -29
  455. package/scripts/benchmark-local-routerarena.ts +0 -176
  456. package/scripts/benchmark.js +0 -145
  457. package/scripts/benchmark.sh +0 -61
  458. package/scripts/compare-providers.sh +0 -230
  459. package/scripts/content-planner.js +0 -25
  460. package/scripts/create-labeled-benchmark.ts +0 -105
  461. package/scripts/cross_post.py +0 -443
  462. package/scripts/local-router-benchmark.ts +0 -154
  463. package/scripts/post-all.sh +0 -41
  464. package/scripts/publish_fcc.py +0 -106
  465. package/scripts/push-to-gitee.sh +0 -25
  466. package/scripts/routerarena_ensemble.js +0 -144
  467. package/scripts/routing-benchmark-v2.js +0 -373
  468. package/scripts/routing-benchmark-v3.js +0 -118
  469. package/scripts/routing-benchmark.js +0 -462
  470. package/scripts/run-labeled-benchmark.mjs +0 -104
  471. package/scripts/run-mmlu-benchmark.js +0 -176
  472. package/scripts/run-provider-benchmark.js +0 -244
  473. package/scripts/update-npm-badges.js +0 -158
  474. package/skill/SKILL.md +0 -238
  475. package/src/__tests__/integration/tmpld_integration.test.py +0 -540
  476. package/src/skills/__tests__/skill_manager.test.ts +0 -328
  477. package/submissions/benchmarks/ALL_PLATFORMS_SUBMISSION.md +0 -94
  478. package/submissions/benchmarks/LLMROUTERBENCH_SUBMISSION.md +0 -121
  479. package/submissions/benchmarks/MMRBENCH_SUBMISSION.md +0 -94
  480. package/submissions/benchmarks/ROUTERARENA_UPDATE.md +0 -83
  481. package/submissions/benchmarks/ROUTERBENCH_SUBMISSION.md +0 -225
  482. package/test-council/1-structure-tests.test.js +0 -353
  483. package/test-council/1-structure-tests.test.ts +0 -353
  484. package/test-council/2-edge-case-tests.test.ts +0 -361
  485. package/test-council/3-performance-tests.test.ts +0 -669
  486. package/test-council/4-integration-tests.test.ts +0 -391
  487. package/test-council/5-agent-council-eval.test.ts +0 -413
  488. package/test-council/AGENT_COUNCIL_ARCHITECTURE.md +0 -349
  489. package/test-council/TEST_COUNCIL_REPORT.md +0 -201
  490. package/test-council/agents/edge-case-agent.ts +0 -363
  491. package/test-council/agents/performance-agent.ts +0 -426
  492. package/test-council/agents/structure-agent.ts +0 -227
  493. package/test-council/council.md +0 -183
  494. package/tests/__mocks__/tokenUtils.ts +0 -8
  495. package/tests/memory/episodicMemory.test.ts +0 -227
  496. package/tests/package-lock.json +0 -1628
  497. package/tests/package.json +0 -18
  498. package/tests/routing/ensembleVoting.test.ts +0 -236
  499. package/tests/routing/providerRetry.test.ts +0 -360
  500. package/tests/routing/queryTypePresets.test.ts +0 -208
  501. package/tests/security/guardrailEngine.test.ts +0 -700
  502. package/tests/tsconfig.json +0 -21
  503. package/tests/vitest.config.ts +0 -18
  504. package/tmlpd-pi-extension/README.md +0 -66
  505. package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts +0 -114
  506. package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts.map +0 -1
  507. package/tmlpd-pi-extension/dist/cache/prefixCache.js +0 -285
  508. package/tmlpd-pi-extension/dist/cache/prefixCache.js.map +0 -1
  509. package/tmlpd-pi-extension/dist/cache/responseCache.d.ts +0 -58
  510. package/tmlpd-pi-extension/dist/cache/responseCache.d.ts.map +0 -1
  511. package/tmlpd-pi-extension/dist/cache/responseCache.js +0 -153
  512. package/tmlpd-pi-extension/dist/cache/responseCache.js.map +0 -1
  513. package/tmlpd-pi-extension/dist/cli.js +0 -59
  514. package/tmlpd-pi-extension/dist/cost/costTracker.d.ts +0 -95
  515. package/tmlpd-pi-extension/dist/cost/costTracker.d.ts.map +0 -1
  516. package/tmlpd-pi-extension/dist/cost/costTracker.js +0 -240
  517. package/tmlpd-pi-extension/dist/cost/costTracker.js.map +0 -1
  518. package/tmlpd-pi-extension/dist/index.d.ts +0 -723
  519. package/tmlpd-pi-extension/dist/index.d.ts.map +0 -1
  520. package/tmlpd-pi-extension/dist/index.js +0 -239
  521. package/tmlpd-pi-extension/dist/index.js.map +0 -1
  522. package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts +0 -82
  523. package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts.map +0 -1
  524. package/tmlpd-pi-extension/dist/memory/episodicMemory.js +0 -145
  525. package/tmlpd-pi-extension/dist/memory/episodicMemory.js.map +0 -1
  526. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts +0 -102
  527. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts.map +0 -1
  528. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js +0 -207
  529. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js.map +0 -1
  530. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts +0 -85
  531. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts.map +0 -1
  532. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js +0 -210
  533. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js.map +0 -1
  534. package/tmlpd-pi-extension/dist/providers/localProvider.d.ts +0 -102
  535. package/tmlpd-pi-extension/dist/providers/localProvider.d.ts.map +0 -1
  536. package/tmlpd-pi-extension/dist/providers/localProvider.js +0 -338
  537. package/tmlpd-pi-extension/dist/providers/localProvider.js.map +0 -1
  538. package/tmlpd-pi-extension/dist/providers/registry.d.ts +0 -55
  539. package/tmlpd-pi-extension/dist/providers/registry.d.ts.map +0 -1
  540. package/tmlpd-pi-extension/dist/providers/registry.js +0 -138
  541. package/tmlpd-pi-extension/dist/providers/registry.js.map +0 -1
  542. package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts +0 -68
  543. package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts.map +0 -1
  544. package/tmlpd-pi-extension/dist/routing/advancedRouter.js +0 -332
  545. package/tmlpd-pi-extension/dist/routing/advancedRouter.js.map +0 -1
  546. package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts +0 -101
  547. package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts.map +0 -1
  548. package/tmlpd-pi-extension/dist/tools/tmlpdTools.js +0 -368
  549. package/tmlpd-pi-extension/dist/tools/tmlpdTools.js.map +0 -1
  550. package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts +0 -96
  551. package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts.map +0 -1
  552. package/tmlpd-pi-extension/dist/utils/batchProcessor.js +0 -170
  553. package/tmlpd-pi-extension/dist/utils/batchProcessor.js.map +0 -1
  554. package/tmlpd-pi-extension/dist/utils/compression.d.ts +0 -61
  555. package/tmlpd-pi-extension/dist/utils/compression.d.ts.map +0 -1
  556. package/tmlpd-pi-extension/dist/utils/compression.js +0 -281
  557. package/tmlpd-pi-extension/dist/utils/compression.js.map +0 -1
  558. package/tmlpd-pi-extension/dist/utils/reliability.d.ts +0 -74
  559. package/tmlpd-pi-extension/dist/utils/reliability.d.ts.map +0 -1
  560. package/tmlpd-pi-extension/dist/utils/reliability.js +0 -177
  561. package/tmlpd-pi-extension/dist/utils/reliability.js.map +0 -1
  562. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts +0 -117
  563. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts.map +0 -1
  564. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js +0 -246
  565. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js.map +0 -1
  566. package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts +0 -50
  567. package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts.map +0 -1
  568. package/tmlpd-pi-extension/dist/utils/tokenUtils.js +0 -124
  569. package/tmlpd-pi-extension/dist/utils/tokenUtils.js.map +0 -1
  570. package/tmlpd-pi-extension/examples/QUICKSTART.md +0 -183
  571. package/tmlpd-pi-extension/package-lock.json +0 -79
  572. package/tmlpd-pi-extension/package.json +0 -172
  573. package/tmlpd-pi-extension/python/examples.py +0 -53
  574. package/tmlpd-pi-extension/python/integrations.py +0 -330
  575. package/tmlpd-pi-extension/python/setup.py +0 -28
  576. package/tmlpd-pi-extension/python/tmlpd.py +0 -369
  577. package/tmlpd-pi-extension/qna/REDDIT_GAP_ANALYSIS.md +0 -299
  578. package/tmlpd-pi-extension/qna/TMLPD_QNA.md +0 -751
  579. package/tmlpd-pi-extension/skill/SKILL.md +0 -238
  580. package/tmlpd-pi-extension/src/cache/responseCache.ts +0 -147
  581. package/tmlpd-pi-extension/src/cost/costTracker.ts +0 -302
  582. package/tmlpd-pi-extension/src/index.ts +0 -232
  583. package/tmlpd-pi-extension/src/memory/episodicMemory.ts +0 -257
  584. package/tmlpd-pi-extension/src/orchestration/haloOrchestrator.ts +0 -266
  585. package/tmlpd-pi-extension/src/orchestration/mctsWorkflow.ts +0 -262
  586. package/tmlpd-pi-extension/src/providers/localProvider.ts +0 -406
  587. package/tmlpd-pi-extension/src/providers/registry.ts +0 -164
  588. package/tmlpd-pi-extension/src/routing/ensembleVoting.ts +0 -159
  589. package/tmlpd-pi-extension/src/routing/queryTypePresets.ts +0 -136
  590. package/tmlpd-pi-extension/src/tools/tmlpdTools.ts +0 -433
  591. package/tmlpd-pi-extension/src/utils/batchProcessor.ts +0 -232
  592. package/tmlpd-pi-extension/src/utils/compression.ts +0 -325
  593. package/tmlpd-pi-extension/src/utils/reliability.ts +0 -221
  594. package/tmlpd-pi-extension/src/utils/tokenUtils.ts +0 -145
  595. package/tmlpd-pi-extension/tsconfig.json +0 -18
  596. package/tsconfig.build.json +0 -29
  597. package/tsconfig.json +0 -18
  598. /package/{docs/llms-full.txt → llms-full.txt.bak} +0 -0
@@ -1,632 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
-
7
- <!-- Primary SEO Meta Tags -->
8
- <title>A3M Router — 82.5% Routing Accuracy Without ML | Matches RouteLLM</title>
9
- <meta name="description" content="A3M Router achieves 82.5% LLM routing accuracy without GPU — matching RouteLLM BERT within 2.5%. 30x more efficient than GPU-based routing. Drop-in OpenAI proxy with 39 providers. 50-80% cost savings.">
10
- <meta name="keywords" content="llm router benchmark, llm routing accuracy, routellm alternative, litellm alternative, llm cost optimization, openai proxy free, llm gateway open source, lightweight llm router, keyword-based llm routing, drop-in openai proxy, llm routing without gpu, how to reduce openai api costs">
11
- <meta name="author" content="A3M Router Team">
12
- <meta name="robots" content="index, follow, max-snippet:-1, max-image-preview:large">
13
- <link rel="canonical" href="https://das-rebel.github.io/adaptive-memory-multi-model-router/">
14
-
15
- <!-- Open Graph / Social Sharing -->
16
- <meta property="og:type" content="website">
17
- <meta property="og:url" content="https://das-rebel.github.io/adaptive-memory-multi-model-router/">
18
- <meta property="og:title" content="A3M Router — 82.5% Routing Accuracy Without ML | Matches RouteLLM">
19
- <meta property="og:description" content="LLM router that matches RouteLLM BERT within 2.5% — without GPU. 30x more efficient. 82.5% routing accuracy. Drop-in OpenAI proxy with 39 providers.">
20
- <meta property="og:image" content="https://das-rebel.github.io/adaptive-memory-multi-model-router/assets/og-banner.svg">
21
- <meta property="og:image:width" content="1200">
22
- <meta property="og:image:height" content="630">
23
- <meta property="og:site_name" content="A3M Router">
24
- <meta property="og:locale" content="en_US">
25
-
26
- <!-- Twitter Card -->
27
- <meta name="twitter:card" content="summary_large_image">
28
- <meta name="twitter:title" content="A3M Router — 82.5% Routing Accuracy Without ML | Matches RouteLLM">
29
- <meta name="twitter:description" content="LLM router that matches RouteLLM BERT within 2.5% — without GPU. 30x more efficient. 82.5% accuracy. Drop-in OpenAI proxy. 39 providers.">
30
- <meta name="twitter:image" content="https://das-rebel.github.io/adaptive-memory-multi-model-router/assets/og-banner.svg">
31
-
32
- <!-- JSON-LD Structured Data: SoftwareApplication -->
33
- <script type="application/ld+json">
34
- {
35
- "@context": "https://schema.org",
36
- "@type": "SoftwareApplication",
37
- "name": "A3M Router",
38
- "description": "OpenAI-compatible LLM router with 82.5% routing accuracy without ML. Matches RouteLLM BERT within 2.5%. 30x more efficient than GPU-based routing. 39 providers, semantic cache, guardrails, cost analytics.",
39
- "url": "https://github.com/Das-rebel/a3m-router",
40
- "applicationCategory": "DeveloperApplication",
41
- "operatingSystem": "Linux, macOS, Windows",
42
- "programmingLanguage": "TypeScript",
43
- "offers": {
44
- "@type": "Offer",
45
- "price": "0",
46
- "priceCurrency": "USD",
47
- "description": "MIT License. Free and open source."
48
- },
49
- "softwareVersion": "2.0.3",
50
- "installUrl": "https://www.npmjs.com/package/adaptive-memory-multi-model-router",
51
- "codeRepository": "https://github.com/Das-rebel/a3m-router",
52
- "license": "https://opensource.org/licenses/MIT",
53
- "author": {
54
- "@type": "Organization",
55
- "name": "A3M Router Team",
56
- "url": "https://github.com/Das-rebel"
57
- },
58
- "aggregateRating": {
59
- "@type": "AggregateRating",
60
- "ratingValue": "4.8",
61
- "reviewCount": "52",
62
- "bestRating": "5"
63
- },
64
- "featureList": [
65
- "OpenAI-compatible proxy",
66
- "39 LLM providers",
67
- "Intelligent query routing",
68
- "70% cost savings",
69
- "Semantic cache",
70
- "Security guardrails",
71
- "Real-time cost analytics",
72
- "LangChain adapter",
73
- "Batch processing",
74
- "Circuit breaker"
75
- ]
76
- }
77
- </script>
78
-
79
- <!-- JSON-LD: FAQPage for rich results -->
80
- <script type="application/ld+json">
81
- {
82
- "@context": "https://schema.org",
83
- "@type": "FAQPage",
84
- "mainEntity": [
85
- {
86
- "@type": "Question",
87
- "name": "What is A3M Router?",
88
- "acceptedAnswer": {
89
- "@type": "Answer",
90
- "text": "A3M Router is an OpenAI-compatible proxy that analyzes each LLM query and routes it to the cheapest capable provider. It supports 39 providers including Groq, Cerebras, OpenAI, Anthropic, DeepSeek, and free local models via Ollama. Drop-in replacement for api.openai.com."
91
- }
92
- },
93
- {
94
- "@type": "Question",
95
- "name": "How much can I save with A3M Router?",
96
- "acceptedAnswer": {
97
- "@type": "Answer",
98
- "text": "A3M Router saves 50-80% on LLM API costs by routing simple queries to cheap or free providers (Groq at $0.59/1M tokens, Cerebras at $0.60/1M tokens, or free via Ollama/CommandCode) while only using premium models like GPT-4 or Claude when query complexity requires it."
99
- }
100
- },
101
- {
102
- "@type": "Question",
103
- "name": "Is A3M Router free?",
104
- "acceptedAnswer": {
105
- "@type": "Answer",
106
- "text": "Yes, A3M Router is MIT-licensed open source software. It's free to use. You only pay for the underlying LLM API calls you route through it, and A3M Router minimizes those costs by selecting the cheapest capable provider."
107
- }
108
- },
109
- {
110
- "@type": "Question",
111
- "name": "How do I get started with A3M Router?",
112
- "acceptedAnswer": {
113
- "@type": "Answer",
114
- "text": "Install with npm install adaptive-memory-multi-model-router, then run npx a3m-router serve to start the OpenAI-compatible proxy on port 8787. Point your existing OpenAI SDK base URL to http://localhost:8787/v1 and you're done."
115
- }
116
- },
117
- {
118
- "@type": "Question",
119
- "name": "What LLM providers does A3M Router support?",
120
- "acceptedAnswer": {
121
- "@type": "Answer",
122
- "text": "A3M Router supports 39 providers including OpenAI, Anthropic (Claude), Google (Gemini), Groq, Cerebras, DeepSeek, Mistral, Fireworks, Together AI, Perplexity, Cohere, xAI (Grok), Ollama, OpenRouter, and many more. Free options include CommandCode, Ollama, LM Studio, and vLLM."
123
- }
124
- }
125
- ]
126
- }
127
- </script>
128
-
129
- <!-- JSON-LD: BreadcrumbList -->
130
- <script type="application/ld+json">
131
- {
132
- "@context": "https://schema.org",
133
- "@type": "BreadcrumbList",
134
- "itemListElement": [
135
- {
136
- "@type": "ListItem",
137
- "position": 1,
138
- "name": "Home",
139
- "item": "https://das-rebel.github.io/adaptive-memory-multi-model-router/"
140
- }
141
- ]
142
- }
143
- </script>
144
-
145
- <style>
146
- * {
147
- margin: 0;
148
- padding: 0;
149
- box-sizing: border-box;
150
- }
151
-
152
- body {
153
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
154
- background: linear-gradient(135deg, #0f172a 0%, #1e1b4b 50%, #312e81 100%);
155
- color: #fff;
156
- min-height: 100vh;
157
- }
158
-
159
- .container {
160
- max-width: 1200px;
161
- margin: 0 auto;
162
- padding: 2rem;
163
- }
164
-
165
- header {
166
- text-align: center;
167
- padding: 4rem 0;
168
- }
169
-
170
- .logo {
171
- width: 120px;
172
- height: 120px;
173
- margin: 0 auto 2rem;
174
- }
175
-
176
- h1 {
177
- font-size: 4rem;
178
- font-weight: 800;
179
- background: linear-gradient(135deg, #6366f1, #8b5cf6, #06b6d4);
180
- -webkit-background-clip: text;
181
- -webkit-text-fill-color: transparent;
182
- margin-bottom: 1rem;
183
- }
184
-
185
- .tagline {
186
- font-size: 1.5rem;
187
- color: #94a3b8;
188
- margin-bottom: 2rem;
189
- }
190
-
191
- .stats {
192
- display: flex;
193
- justify-content: center;
194
- gap: 3rem;
195
- margin: 3rem 0;
196
- flex-wrap: wrap;
197
- }
198
-
199
- .stat {
200
- text-align: center;
201
- padding: 1.5rem 2rem;
202
- background: rgba(255,255,255,0.05);
203
- border-radius: 16px;
204
- border: 1px solid rgba(255,255,255,0.1);
205
- }
206
-
207
- .stat-value {
208
- font-size: 2.5rem;
209
- font-weight: 700;
210
- color: #6366f1;
211
- }
212
-
213
- .stat-label {
214
- font-size: 0.9rem;
215
- color: #64748b;
216
- margin-top: 0.5rem;
217
- }
218
-
219
- .cta {
220
- display: flex;
221
- gap: 1rem;
222
- justify-content: center;
223
- margin: 3rem 0;
224
- flex-wrap: wrap;
225
- }
226
-
227
- .btn {
228
- padding: 1rem 2rem;
229
- border-radius: 12px;
230
- font-size: 1.1rem;
231
- font-weight: 600;
232
- text-decoration: none;
233
- transition: all 0.3s ease;
234
- }
235
-
236
- .btn-primary {
237
- background: linear-gradient(135deg, #6366f1, #8b5cf6);
238
- color: white;
239
- }
240
-
241
- .btn-primary:hover {
242
- transform: translateY(-2px);
243
- box-shadow: 0 10px 40px rgba(99, 102, 241, 0.4);
244
- }
245
-
246
- .btn-secondary {
247
- background: rgba(255,255,255,0.1);
248
- color: white;
249
- border: 1px solid rgba(255,255,255,0.2);
250
- }
251
-
252
- .btn-secondary:hover {
253
- background: rgba(255,255,255,0.15);
254
- }
255
-
256
- .features {
257
- display: grid;
258
- grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
259
- gap: 2rem;
260
- margin: 4rem 0;
261
- }
262
-
263
- .feature {
264
- padding: 2rem;
265
- background: rgba(255,255,255,0.03);
266
- border-radius: 20px;
267
- border: 1px solid rgba(255,255,255,0.05);
268
- transition: all 0.3s ease;
269
- }
270
-
271
- .feature:hover {
272
- background: rgba(255,255,255,0.05);
273
- transform: translateY(-5px);
274
- }
275
-
276
- .feature-icon {
277
- font-size: 2.5rem;
278
- margin-bottom: 1rem;
279
- }
280
-
281
- .feature h2 {
282
- font-size: 1.3rem;
283
- margin-bottom: 0.5rem;
284
- color: #fff;
285
- }
286
-
287
- .feature p {
288
- color: #94a3b8;
289
- line-height: 1.6;
290
- }
291
-
292
- .code-section {
293
- margin: 4rem 0;
294
- text-align: center;
295
- }
296
-
297
- .code-block {
298
- background: #0f172a;
299
- border-radius: 16px;
300
- padding: 2rem;
301
- margin: 2rem auto;
302
- max-width: 800px;
303
- text-align: left;
304
- border: 1px solid rgba(255,255,255,0.1);
305
- overflow-x: auto;
306
- }
307
-
308
- .code-block pre {
309
- color: #e2e8f0;
310
- font-family: 'Monaco', 'Menlo', monospace;
311
- font-size: 0.95rem;
312
- line-height: 1.6;
313
- }
314
-
315
- .code-block .comment {
316
- color: #64748b;
317
- }
318
-
319
- .code-block .keyword {
320
- color: #c084fc;
321
- }
322
-
323
- .code-block .string {
324
- color: #4ade80;
325
- }
326
-
327
- .code-block .function {
328
- color: #60a5fa;
329
- }
330
-
331
- .providers-section {
332
- margin: 4rem 0;
333
- text-align: center;
334
- }
335
-
336
- .provider-tiers {
337
- display: grid;
338
- grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
339
- gap: 1.5rem;
340
- margin-top: 2rem;
341
- }
342
-
343
- .tier {
344
- padding: 1.5rem;
345
- background: rgba(255,255,255,0.03);
346
- border-radius: 16px;
347
- border: 1px solid rgba(255,255,255,0.08);
348
- text-align: left;
349
- }
350
-
351
- .tier h3 {
352
- font-size: 1.1rem;
353
- margin-bottom: 0.5rem;
354
- }
355
-
356
- .tier .price {
357
- color: #10b981;
358
- font-weight: 700;
359
- font-size: 1.2rem;
360
- margin-bottom: 0.5rem;
361
- }
362
-
363
- .tier ul {
364
- list-style: none;
365
- color: #94a3b8;
366
- font-size: 0.9rem;
367
- }
368
-
369
- .tier ul li {
370
- padding: 0.2rem 0;
371
- }
372
-
373
- .faq-section {
374
- margin: 4rem 0;
375
- }
376
-
377
- .faq-section h2 {
378
- text-align: center;
379
- font-size: 2.5rem;
380
- margin-bottom: 2rem;
381
- }
382
-
383
- .faq-item {
384
- max-width: 800px;
385
- margin: 1rem auto;
386
- padding: 1.5rem;
387
- background: rgba(255,255,255,0.03);
388
- border-radius: 12px;
389
- border: 1px solid rgba(255,255,255,0.08);
390
- }
391
-
392
- .faq-item h3 {
393
- font-size: 1.1rem;
394
- color: #6366f1;
395
- margin-bottom: 0.5rem;
396
- }
397
-
398
- .faq-item p {
399
- color: #94a3b8;
400
- line-height: 1.6;
401
- }
402
-
403
- footer {
404
- text-align: center;
405
- padding: 4rem 0;
406
- border-top: 1px solid rgba(255,255,255,0.1);
407
- margin-top: 4rem;
408
- }
409
-
410
- .links {
411
- display: flex;
412
- justify-content: center;
413
- gap: 2rem;
414
- margin-bottom: 2rem;
415
- }
416
-
417
- .links a {
418
- color: #94a3b8;
419
- text-decoration: none;
420
- transition: color 0.3s;
421
- }
422
-
423
- .links a:hover {
424
- color: #6366f1;
425
- }
426
-
427
- @media (max-width: 768px) {
428
- h1 {
429
- font-size: 2.5rem;
430
- }
431
-
432
- .stats {
433
- gap: 1rem;
434
- }
435
-
436
- .stat {
437
- padding: 1rem;
438
- }
439
-
440
- .stat-value {
441
- font-size: 1.8rem;
442
- }
443
- }
444
- </style>
445
- </head>
446
- <body>
447
- <div class="container">
448
- <header>
449
- <div class="logo">
450
- <svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
451
- <defs>
452
- <linearGradient id="g1" x1="0%" y1="0%" x2="100%" y2="100%">
453
- <stop offset="0%" style="stop-color:#6366f1"/>
454
- <stop offset="100%" style="stop-color:#8b5cf6"/>
455
- </linearGradient>
456
- </defs>
457
- <circle cx="100" cy="100" r="80" fill="none" stroke="url(#g1)" stroke-width="2" opacity="0.3"/>
458
- <circle cx="100" cy="100" r="60" fill="url(#g1)" opacity="0.2"/>
459
- <circle cx="100" cy="100" r="25" fill="url(#g1)"/>
460
- <circle cx="100" cy="40" r="12" fill="#6366f1"/>
461
- <circle cx="152" cy="130" r="10" fill="#10b981"/>
462
- <circle cx="48" cy="130" r="10" fill="#f59e0b"/>
463
- <text x="100" y="108" font-size="14" font-weight="bold" fill="white" text-anchor="middle">A3M</text>
464
- </svg>
465
- </div>
466
- <h1>A3M Router</h1>
467
- <p class="tagline">Intelligent LLM Routing Proxy &mdash; Drop-in OpenAI Replacement<br>Route queries to the cheapest capable model &bull; Save 50-80% on API costs</p>
468
-
469
- <div class="stats">
470
- <div class="stat">
471
- <div class="stat-value">2,775</div>
472
- <div class="stat-label">Downloads in 3 Days</div>
473
- </div>
474
- <div class="stat">
475
- <div class="stat-value">245%</div>
476
- <div class="stat-label">Growth, Zero Budget</div>
477
- </div>
478
- <div class="stat">
479
- <div class="stat-value">39</div>
480
- <div class="stat-label">LLM Providers</div>
481
- </div>
482
- <div class="stat">
483
- <div class="stat-value">70%</div>
484
- <div class="stat-label">Cost Savings</div>
485
- </div>
486
- </div>
487
-
488
- <div class="cta">
489
- <a href="https://www.npmjs.com/package/adaptive-memory-multi-model-router" class="btn btn-primary">Install from NPM</a>
490
- <a href="https://github.com/Das-rebel/a3m-router" class="btn btn-secondary">Star on GitHub</a>
491
- </div>
492
- </header>
493
-
494
- <section class="features">
495
- <div class="feature">
496
- <div class="feature-icon">&#x1F9E0;</div>
497
- <h2>Intelligent LLM Routing</h2>
498
- <p>Analyzes query complexity and routes to the cheapest capable model. Code queries go to code models. Simple queries use budget providers. Premium models only when needed.</p>
499
- </div>
500
- <div class="feature">
501
- <div class="feature-icon">&#x1F4B0;</div>
502
- <h2>Cost Optimization</h2>
503
- <p>Save 50-80% on API costs. Route simple queries to free tiers (Ollama, CommandCode) or cheap providers (Groq $0.59/1M tokens). Real-time cost analytics dashboard.</p>
504
- </div>
505
- <div class="feature">
506
- <div class="feature-icon">&#x1F504;</div>
507
- <h2>Smart Fallback &amp; Retry</h2>
508
- <p>When a provider fails, automatically retry with the next best option. Circuit breaker pattern keeps your app resilient. Zero downtime.</p>
509
- </div>
510
- <div class="feature">
511
- <div class="feature-icon">&#x1F4CA;</div>
512
- <h2>Real-time Analytics</h2>
513
- <p>Monitor spending across all providers in real-time. Set budgets. Get alerts. Cost analytics with savings reports. Never get surprised by an API bill again.</p>
514
- </div>
515
- <div class="feature">
516
- <div class="feature-icon">&#x1F512;</div>
517
- <h2>Security Guardrails</h2>
518
- <p>Built-in prompt injection detection, PII redaction, content filtering, and rate limiting. Production-ready security out of the box.</p>
519
- </div>
520
- <div class="feature">
521
- <div class="feature-icon">&#x26A1;</div>
522
- <h2>Semantic Cache</h2>
523
- <p>Trigram Jaccard similarity cache eliminates redundant API calls. Batch processing with automatic rate limiting for high-throughput applications.</p>
524
- </div>
525
- </section>
526
-
527
- <section class="providers-section">
528
- <h2>LLM Provider Pricing Tiers</h2>
529
- <p style="color: #94a3b8; margin-bottom: 2rem;">39 providers from free to premium. Always pick the cheapest capable option.</p>
530
- <div class="provider-tiers">
531
- <div class="tier">
532
- <h3>Free Tier</h3>
533
- <div class="price">$0 / 1M tokens</div>
534
- <ul>
535
- <li>CommandCode</li>
536
- <li>Ollama (local)</li>
537
- <li>LM Studio</li>
538
- <li>vLLM</li>
539
- </ul>
540
- </div>
541
- <div class="tier">
542
- <h3>Budget Tier</h3>
543
- <div class="price">$0.59 - $0.60 / 1M tokens</div>
544
- <ul>
545
- <li>Groq (Llama 3.3 70B)</li>
546
- <li>Cerebras (Llama 3.3 70B)</li>
547
- </ul>
548
- </div>
549
- <div class="tier">
550
- <h3>Mid Tier</h3>
551
- <div class="price">$1.50 - $2.80 / 1M tokens</div>
552
- <ul>
553
- <li>DeepSeek</li>
554
- <li>Mistral</li>
555
- <li>MiniMax</li>
556
- <li>Qwen / GLM-4</li>
557
- </ul>
558
- </div>
559
- <div class="tier">
560
- <h3>Premium Tier</h3>
561
- <div class="price">$10 - $30 / 1M tokens</div>
562
- <ul>
563
- <li>OpenAI (GPT-4o)</li>
564
- <li>Anthropic (Claude)</li>
565
- <li>Google (Gemini)</li>
566
- </ul>
567
- </div>
568
- </div>
569
- </section>
570
-
571
- <section class="code-section">
572
- <h2>Quick Start: LLM Routing in 30 Seconds</h2>
573
- <p style="color: #94a3b8; margin-bottom: 2rem;">One-line installation, instant routing. Drop-in replacement for api.openai.com.</p>
574
-
575
- <div class="code-block">
576
- <pre><span class="comment"># Install</span>
577
- npm install adaptive-memory-multi-model-router
578
-
579
- <span class="comment"># Start the OpenAI-compatible proxy</span>
580
- npx a3m-router serve
581
- <span class="comment"># Now listening on http://localhost:8787/v1</span>
582
-
583
- <span class="comment"># Or use programmatically</span>
584
- <span class="keyword">const</span> { <span class="function">createA3MRouter</span> } = <span class="function">require</span>(<span class="string">'adaptive-memory-multi-model-router'</span>);
585
- <span class="keyword">const</span> router = <span class="function">createA3MRouter</span>();
586
- <span class="keyword">const</span> result = <span class="keyword">await</span> router.<span class="function">route</span>(<span class="string">"Explain quantum computing"</span>);
587
- <span class="function">console</span>.<span class="function">log</span>(result.primary_model); <span class="comment">// "groq/llama-3.3-70b" (cheapest capable)</span>
588
- <span class="function">console</span>.<span class="function">log</span>(result.savings); <span class="comment">// "$0.024 saved vs GPT-4"</span></pre>
589
- </div>
590
- </section>
591
-
592
- <section class="faq-section">
593
- <h2>Frequently Asked Questions</h2>
594
- <div class="faq-item">
595
- <h3>What is A3M Router?</h3>
596
- <p>A3M Router is an OpenAI-compatible proxy that analyzes each LLM query and routes it to the cheapest capable provider. It supports 39 providers including Groq, Cerebras, OpenAI, Anthropic, DeepSeek, and free local models via Ollama. Drop-in replacement for api.openai.com.</p>
597
- </div>
598
- <div class="faq-item">
599
- <h3>How much can I save with A3M Router?</h3>
600
- <p>A3M Router saves 50-80% on LLM API costs by routing simple queries to cheap or free providers (Groq at $0.59/1M tokens, Cerebras at $0.60/1M tokens, or free via Ollama/CommandCode) while only using premium models like GPT-4 or Claude when query complexity requires it.</p>
601
- </div>
602
- <div class="faq-item">
603
- <h3>Is A3M Router free?</h3>
604
- <p>Yes, A3M Router is MIT-licensed open source software. It's free to use. You only pay for the underlying LLM API calls you route through it, and A3M Router minimizes those costs by selecting the cheapest capable provider.</p>
605
- </div>
606
- <div class="faq-item">
607
- <h3>How do I get started with A3M Router?</h3>
608
- <p>Install with <code>npm install adaptive-memory-multi-model-router</code>, then run <code>npx a3m-router serve</code> to start the OpenAI-compatible proxy on port 8787. Point your existing OpenAI SDK base URL to http://localhost:8787/v1 and you're done.</p>
609
- </div>
610
- <div class="faq-item">
611
- <h3>What LLM providers does A3M Router support?</h3>
612
- <p>39 providers including OpenAI, Anthropic (Claude), Google (Gemini), Groq, Cerebras, DeepSeek, Mistral, Fireworks, Together AI, Perplexity, Cohere, xAI (Grok), Ollama, OpenRouter, and more. Free options include CommandCode, Ollama, LM Studio, and vLLM.</p>
613
- </div>
614
- <div class="faq-item">
615
- <h3>How does A3M Router compare to LiteLLM?</h3>
616
- <p>A3M Router focuses on intelligent cost-based routing with semantic caching, guardrails, and real-time cost analytics built in. Unlike generic proxy tools, it actively analyzes query complexity to pick the cheapest capable model. Zero config needed for basic usage.</p>
617
- </div>
618
- </section>
619
-
620
- <footer>
621
- <div class="links">
622
- <a href="https://www.npmjs.com/package/adaptive-memory-multi-model-router">NPM</a>
623
- <a href="https://github.com/Das-rebel/a3m-router">GitHub</a>
624
- <a href="https://github.com/Das-rebel/a3m-router/issues">Issues</a>
625
- <a href="https://github.com/Das-rebel/a3m-router/discussions">Discussions</a>
626
- <a href="https://github.com/Das-rebel/a3m-router/blob/main/docs/API.md">API Docs</a>
627
- </div>
628
- <p style="color: #64748b;">MIT License &copy; 2026 A3M Router Team</p>
629
- </footer>
630
- </div>
631
- </body>
632
- </html>
package/eval/README.md DELETED
@@ -1,46 +0,0 @@
1
- # Routing Evaluation Harness
2
-
3
- This directory contains the reproducible evaluation system for A3M.
4
-
5
- ## Files
6
-
7
- - `benchmark_dataset.jsonl`: frozen routing benchmark dataset
8
- - `datasets/catalog.json`: dataset registry and slice metadata
9
- - `datasets/slices/*.jsonl`: versioned slice datasets
10
- - `thresholds.json`: minimum quality thresholds + max allowed regression
11
- - `fault_injection_thresholds.json`: reliability gate threshold
12
- - `golden_routes.json`: golden route snapshot
13
- - `baselines/main.json`: baseline summary for `main` branch
14
- - `run_eval.js`: routing evaluator + hard gate
15
- - `check_golden_routes.js`: golden regression check
16
- - `run_fault_injection.js`: retry/health fault scenarios
17
- - `run_shadow_eval.js`: shadow routing comparison (informational)
18
- - `generate_report.js`: markdown summary from eval result artifacts
19
- - `experiments.jsonl`: append-only experiment registry (local artifact)
20
- - `results/*.json`: generated run outputs (not committed)
21
- - `results/report_latest.md`: generated markdown evidence report
22
-
23
- ## Run
24
-
25
- ```bash
26
- npm run eval:all
27
- ```
28
-
29
- `eval:all` includes:
30
-
31
- 1. `eval:routing` — hard gate for routing quality thresholds
32
- 2. `eval:golden` — snapshot consistency gate
33
- 3. `eval:faults` — reliability fault injection gate
34
- 4. `eval:shadow` — candidate-vs-primary divergence and projected cost delta (informational)
35
- 5. `eval:report` — consolidated markdown release summary
36
-
37
- ## Updating Baseline
38
-
39
- Only update `baselines/main.json` when routing behavior changes intentionally.
40
-
41
- Suggested process:
42
-
43
- 1. Run `npm run eval:routing`
44
- 2. Review `eval/results/latest.json`
45
- 3. If changes are expected and desired, copy the new summary into `baselines/main.json`
46
- 4. Mention the reason in your PR/commit message