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

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 (605) hide show
  1. package/dist/index.d.ts +4 -0
  2. package/dist/index.js +8 -2
  3. package/dist/memory/hybridMemory.d.ts +71 -0
  4. package/dist/memory/hybridMemory.js +124 -0
  5. package/dist/memory/reasoningBank.d.ts +88 -0
  6. package/dist/memory/reasoningBank.js +303 -0
  7. package/{docs/llms.txt → llms.txt.bak} +6 -6
  8. package/package.json +13 -84
  9. package/src/index.ts +8 -0
  10. package/src/memory/hybridMemory.ts +155 -0
  11. package/src/memory/reasoningBank.ts +335 -0
  12. package/src/routing/advancedRouter.ts.bak +650 -0
  13. package/test.js.bak +376 -0
  14. package/.dockerignore +0 -82
  15. package/.env.example +0 -303
  16. package/.github/DISCUSSIONS_WELCOME.md +0 -27
  17. package/.github/DISCUSSION_TEMPLATE.yml +0 -5
  18. package/.github/FUNDING.yml +0 -2
  19. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -94
  20. package/.github/ISSUE_TEMPLATE/config.yml +0 -17
  21. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -71
  22. package/.github/PULL_REQUEST_TEMPLATE.md +0 -71
  23. package/.github/dependabot.yml +0 -9
  24. package/.github/workflows/auto-publish.yml +0 -51
  25. package/.github/workflows/ci.yml +0 -263
  26. package/.github/workflows/codeql.yml +0 -38
  27. package/.github/workflows/npm-publish.yml +0 -20
  28. package/.github/workflows/pages.yml +0 -37
  29. package/.github/workflows/stale.yml +0 -54
  30. package/.publish-tick +0 -1
  31. package/.well-known/ai-plugin.json +0 -16
  32. package/AGENT_COUNCIL_FINDINGS.md +0 -142
  33. package/ARCHITECTURE.md +0 -346
  34. package/AUDIT_REPORT.md +0 -28
  35. package/CODE_OF_CONDUCT.md +0 -128
  36. package/CONTRIBUTING.md +0 -50
  37. package/CONTRIBUTORS.md +0 -20
  38. package/Dockerfile +0 -53
  39. package/Dockerfile.proxy +0 -33
  40. package/HEALTH_REPORT.md +0 -118
  41. package/IMPROVEMENT_PLAN.md +0 -107
  42. package/LANDING.md +0 -43
  43. package/LAUNCH-PAIN-DRIVEN.md +0 -339
  44. package/LAUNCH.md +0 -337
  45. package/LAUNCH_CHECKLIST.md +0 -141
  46. package/LAUNCH_SNAPSHOT.md +0 -260
  47. package/MANIFESTO.md +0 -41
  48. package/POPULARITY_BOOSTERS.md +0 -285
  49. package/PR_STATUS_REPORT.md +0 -148
  50. package/REDESIGN.md +0 -95
  51. package/RUNKIT.md +0 -83
  52. package/SECURITY.md +0 -29
  53. package/SUBMISSIONS.md +0 -43
  54. package/_schema.html +0 -53
  55. package/ai-plugin.json +0 -16
  56. package/articles/AI_AGENT_LLM_ROUTING.md +0 -150
  57. package/articles/CHINESE_DIRECTORIES.md +0 -100
  58. package/articles/CHINESE_SUBMISSIONS_READY.md +0 -322
  59. package/articles/COMPETITOR_ALERTS.md +0 -31
  60. package/articles/COMPLETE_POSTING_DIRECTORY.md +0 -147
  61. package/articles/CONTENT_STRUCTURE.md +0 -292
  62. package/articles/DEVTO_COST_GUIDE.md +0 -473
  63. package/articles/DEVTO_FINAL.md +0 -416
  64. package/articles/DEVTO_MULTI_PROVIDER.md +0 -542
  65. package/articles/DEVTO_READY.md +0 -255
  66. package/articles/DEVTO_V2_ANNOUNCEMENT.md +0 -160
  67. package/articles/DEVTO_VIRAL_GROWTH.md +0 -280
  68. package/articles/FRESH_devto.md +0 -460
  69. package/articles/FRESH_devto_2026_05.md +0 -73
  70. package/articles/FRESH_hackernews.md +0 -14
  71. package/articles/FRESH_reddit_ml.md +0 -90
  72. package/articles/FRESH_reddit_node.md +0 -198
  73. package/articles/FRESH_reddit_sideproject.md +0 -72
  74. package/articles/FRESH_reddit_webdev.md +0 -130
  75. package/articles/FROM_ZERO_TO_10K.md +0 -107
  76. package/articles/HN_10X_BETTER.md +0 -430
  77. package/articles/HN_ACCOUNT_GUIDE.md +0 -21
  78. package/articles/HN_CHINESE_STYLE.md +0 -308
  79. package/articles/HN_FINAL.md +0 -148
  80. package/articles/HN_POSTED_VERSION.md +0 -56
  81. package/articles/HN_POST_READY.md +0 -137
  82. package/articles/HN_RESEARCH.md +0 -364
  83. package/articles/HN_SHOW_routerarena.md +0 -17
  84. package/articles/HN_TIMING_GUIDE.md +0 -52
  85. package/articles/INDIEHACKERS_POST.md +0 -52
  86. package/articles/INDIEHACKERS_READY.md +0 -120
  87. package/articles/LLM_BENCHMARK_DEEP_DIVE.md +0 -153
  88. package/articles/MASTER_POSTING_DIRECTORY.md +0 -189
  89. package/articles/NEWSLETTER_SEND_NOW.md +0 -259
  90. package/articles/NEWSLETTER_SUBMISSIONS.md +0 -112
  91. package/articles/PAIN-DRIVEN-devto-v2.md +0 -308
  92. package/articles/PAIN-DRIVEN-devto-v3.md +0 -268
  93. package/articles/PAIN-DRIVEN-devto.md +0 -242
  94. package/articles/PAIN-DRIVEN-hackernews-v2.md +0 -138
  95. package/articles/PAIN-DRIVEN-hackernews-v3.md +0 -151
  96. package/articles/PAIN-DRIVEN-hackernews.md +0 -131
  97. package/articles/PAIN-DRIVEN-reddit-v2.md +0 -301
  98. package/articles/PAIN-DRIVEN-reddit-v3.md +0 -236
  99. package/articles/PAIN-DRIVEN-reddit.md +0 -218
  100. package/articles/PAIN-DRIVEN-twitter-v2.md +0 -110
  101. package/articles/PAIN-DRIVEN-twitter-v3.md +0 -121
  102. package/articles/PAIN-DRIVEN-twitter.md +0 -120
  103. package/articles/PORTKEY_VS_A3M.md +0 -147
  104. package/articles/POSTING_KIT_2026_05.md +0 -67
  105. package/articles/PRESS_KIT_routerarena.md +0 -77
  106. package/articles/PRODUCTHUNT_LISTING.md +0 -48
  107. package/articles/PRODUCTHUNT_READY.md +0 -106
  108. package/articles/PR_PLAN_vault.md +0 -125
  109. package/articles/REDDIT_FINAL.md +0 -232
  110. package/articles/REDDIT_POST.md +0 -67
  111. package/articles/REDDIT_SUBMISSION_READY.md +0 -348
  112. package/articles/ROUTERARENA_LEADER.md +0 -45
  113. package/articles/SHOW_HN_FINAL.md +0 -29
  114. package/articles/TWEETS_10K_DOWNLOADS.md +0 -47
  115. package/articles/TWEETS_BENCHMARK_FIRST.md +0 -46
  116. package/articles/TWEETS_MCP_PLAY.md +0 -51
  117. package/articles/TWEETS_SEQUENTIAL_BROKEN.md +0 -49
  118. package/articles/TWEETS_WHY_BUILD.md +0 -54
  119. package/articles/TWEETS_routerarena_leader.md +0 -53
  120. package/articles/TWEET_STORM_READY.md +0 -165
  121. package/articles/TWITTER_FINAL.md +0 -167
  122. package/articles/WHY_10X_BETTER.md +0 -261
  123. package/articles/WHY_CHINESE_STYLE_BETTER.md +0 -323
  124. package/articles/ai-discoverability-llm-routing.md +0 -210
  125. package/articles/devto-llm-routing.md +0 -138
  126. package/articles/hackernews-show-hn.md +0 -54
  127. package/articles/hashnode-llm-cost-optimization.md +0 -125
  128. package/articles/hn_show_2026_05.md +0 -11
  129. package/articles/medium-building-llm-router.md +0 -205
  130. package/articles/reddit-ml.md +0 -76
  131. package/articles/twitter-thread-cost-savings.md +0 -50
  132. package/articles/youtube-tutorial-script.md +0 -262
  133. package/assets/a3m_3blue1brown.mp4 +0 -0
  134. package/assets/banner.svg +0 -109
  135. package/assets/chart-cost-v2.svg +0 -91
  136. package/assets/chart-cost-v3.svg +0 -143
  137. package/assets/chart-features-v2.svg +0 -132
  138. package/assets/chart-features-v3.svg +0 -211
  139. package/assets/chart-growth-v2.svg +0 -122
  140. package/assets/chart-growth-v3.svg +0 -189
  141. package/assets/cost-comparison.svg +0 -134
  142. package/assets/cost-simple.svg +0 -64
  143. package/assets/demo-hn.gif +0 -0
  144. package/assets/feature-matrix.svg +0 -136
  145. package/assets/growth-chart-animated.svg +0 -76
  146. package/assets/growth-chart.svg +0 -82
  147. package/assets/growth-simple.svg +0 -69
  148. package/assets/hero-diagram.svg +0 -81
  149. package/assets/logo-new.svg +0 -21
  150. package/assets/logo.svg +0 -68
  151. package/assets/provider-comparison.svg +0 -121
  152. package/assets/social-preview-new.svg +0 -100
  153. package/assets/social-preview.svg +0 -194
  154. package/assets/social-v2.svg +0 -130
  155. package/assets/social-v3.svg +0 -212
  156. package/benchmark-provider-results.json +0 -245
  157. package/benchmark-results.json +0 -54
  158. package/council-votes/architecture-vote.md +0 -121
  159. package/council-votes/coverage-vote.md +0 -93
  160. package/data/adaptive-benchmark.json +0 -92
  161. package/data/benchmark-results.json +0 -47
  162. package/data/labeled-benchmark.json +0 -88
  163. package/demo/3blue1brown_video.py +0 -285
  164. package/demo/3blue1brown_video_v2.py +0 -310
  165. package/demo/IMPROVED_PROMPTS.md +0 -229
  166. package/demo/VEO3_PROMPTS.md +0 -269
  167. package/demo/VIDEO_PRODUCTION_GUIDE.md +0 -333
  168. package/demo/a3m_3blue1brown.mp4 +0 -0
  169. package/demo/asciinema-demo.sh +0 -195
  170. package/demo/demo-hn.tape +0 -74
  171. package/demo/demo-script.md +0 -53
  172. package/demo/demo-script.sh +0 -62
  173. package/demo/demo.svg +0 -75
  174. package/demo/frame1_ai_data_center.png +0 -0
  175. package/demo/frame1_sunset_video.mp4 +0 -0
  176. package/demo/frame2_cost_comparison.png +0 -0
  177. package/demo/frame2_cost_comparison_fallback.png +0 -0
  178. package/demo/frame3_parallel_execution.png +0 -0
  179. package/demo/frame3_parallel_execution_fallback.png +0 -0
  180. package/demo/frame4_providers.png +0 -0
  181. package/demo/frame4_providers_fallback.png +0 -0
  182. package/demo/frame5_endcard.png +0 -0
  183. package/demo/frame5_endcard_fallback.png +0 -0
  184. package/demo/new_frame1_hook.png +0 -0
  185. package/demo/new_frame2_proof.png +0 -0
  186. package/demo/new_frame3_wow.png +0 -0
  187. package/demo/new_frame4_social.png +0 -0
  188. package/demo/new_frame5_cta.png +0 -0
  189. package/demo/package.json +0 -13
  190. package/demo/product-video-final.mp4 +0 -0
  191. package/demo/product-video-hype-v1.mp4 +0 -0
  192. package/demo/product-video-v1.mp4 +0 -0
  193. package/demo/public/index.html +0 -762
  194. package/demo/recording.cast +0 -55
  195. package/demo/server.js +0 -405
  196. package/demo-new.tape +0 -71
  197. package/demo-real.sh +0 -198
  198. package/demo-simple.tape +0 -205
  199. package/demo.html +0 -520
  200. package/demo.sh +0 -85
  201. package/demo.tape +0 -259
  202. package/dist/analytics/costAnalytics.d.ts.map +0 -1
  203. package/dist/analytics/costAnalytics.js.map +0 -1
  204. package/dist/benchmark/comprehensive.js.map +0 -1
  205. package/dist/benchmark/reproducible.d.ts.map +0 -1
  206. package/dist/benchmark/reproducible.js.map +0 -1
  207. package/dist/cache/prefixCache.d.ts.map +0 -1
  208. package/dist/cache/prefixCache.js.map +0 -1
  209. package/dist/cache/responseCache.d.ts.map +0 -1
  210. package/dist/cache/responseCache.js.map +0 -1
  211. package/dist/cache/semanticCache.d.ts.map +0 -1
  212. package/dist/cache/semanticCache.js.map +0 -1
  213. package/dist/cli/setupWizard.d.ts.map +0 -1
  214. package/dist/cli/setupWizard.js.map +0 -1
  215. package/dist/cost/budgetEnforcer.d.ts.map +0 -1
  216. package/dist/cost/budgetEnforcer.js.map +0 -1
  217. package/dist/cost/costTracker.d.ts.map +0 -1
  218. package/dist/cost/costTracker.js.map +0 -1
  219. package/dist/ensemble/multiRoundDialog.js.map +0 -1
  220. package/dist/ensemble/shapleyValue.js.map +0 -1
  221. package/dist/integrations/langchainAdapter.d.ts.map +0 -1
  222. package/dist/integrations/langchainAdapter.js.map +0 -1
  223. package/dist/integrations/oauth.d.ts.map +0 -1
  224. package/dist/integrations/oauth.js.map +0 -1
  225. package/dist/integrations/scienceAdapter.js.map +0 -1
  226. package/dist/memory/autoFetch.d.ts.map +0 -1
  227. package/dist/memory/autoFetch.js.map +0 -1
  228. package/dist/memory/episodicMemory.d.ts.map +0 -1
  229. package/dist/memory/episodicMemory.js.map +0 -1
  230. package/dist/memory/memoryTree.d.ts.map +0 -1
  231. package/dist/memory/memoryTree.js.map +0 -1
  232. package/dist/memory/obsidianVault.d.ts.map +0 -1
  233. package/dist/memory/obsidianVault.js.map +0 -1
  234. package/dist/observability/changeWatch.d.ts.map +0 -1
  235. package/dist/observability/changeWatch.js.map +0 -1
  236. package/dist/observability/fatigueDetector.d.ts.map +0 -1
  237. package/dist/observability/fatigueDetector.js.map +0 -1
  238. package/dist/observability/index.d.ts.map +0 -1
  239. package/dist/observability/index.js.map +0 -1
  240. package/dist/observability/metrics.d.ts.map +0 -1
  241. package/dist/observability/metrics.js.map +0 -1
  242. package/dist/observability/middleware.d.ts.map +0 -1
  243. package/dist/observability/middleware.js.map +0 -1
  244. package/dist/observability/tracer.d.ts.map +0 -1
  245. package/dist/observability/tracer.js.map +0 -1
  246. package/dist/observability/types.d.ts.map +0 -1
  247. package/dist/observability/types.js.map +0 -1
  248. package/dist/orchestration/haloOrchestrator.d.ts.map +0 -1
  249. package/dist/orchestration/haloOrchestrator.js.map +0 -1
  250. package/dist/orchestration/mctsWorkflow.d.ts.map +0 -1
  251. package/dist/orchestration/mctsWorkflow.js.map +0 -1
  252. package/dist/providers/localProvider.d.ts.map +0 -1
  253. package/dist/providers/localProvider.js.map +0 -1
  254. package/dist/providers/providerConfig.d.ts.map +0 -1
  255. package/dist/providers/providerConfig.js.map +0 -1
  256. package/dist/providers/registry.d.ts.map +0 -1
  257. package/dist/providers/registry.js.map +0 -1
  258. package/dist/routing/advancedRouter.d.ts.map +0 -1
  259. package/dist/routing/advancedRouter.js.map +0 -1
  260. package/dist/routing/crossModelValidation.d.ts.map +0 -1
  261. package/dist/routing/crossModelValidation.js.map +0 -1
  262. package/dist/routing/providerHealth.d.ts.map +0 -1
  263. package/dist/routing/providerHealth.js.map +0 -1
  264. package/dist/routing/providerRetry.d.ts.map +0 -1
  265. package/dist/routing/providerRetry.js.map +0 -1
  266. package/dist/scripts/banner.js +0 -29
  267. package/dist/security/guardrails.d.ts.map +0 -1
  268. package/dist/security/guardrails.js.map +0 -1
  269. package/dist/server/dashboard.d.ts.map +0 -1
  270. package/dist/server/dashboard.js.map +0 -1
  271. package/dist/server/modelMapper.d.ts.map +0 -1
  272. package/dist/server/modelMapper.js.map +0 -1
  273. package/dist/server/proxyServer.d.ts.map +0 -1
  274. package/dist/server/proxyServer.js.map +0 -1
  275. package/dist/skills/__tests__/skill_manager.test.d.ts +0 -2
  276. package/dist/skills/__tests__/skill_manager.test.d.ts.map +0 -1
  277. package/dist/skills/__tests__/skill_manager.test.js +0 -268
  278. package/dist/skills/__tests__/skill_manager.test.js.map +0 -1
  279. package/dist/tools/tmlpdTools.d.ts.map +0 -1
  280. package/dist/tools/tmlpdTools.js.map +0 -1
  281. package/dist/tui/dashboard.d.ts.map +0 -1
  282. package/dist/tui/dashboard.js.map +0 -1
  283. package/dist/tui/index.d.ts.map +0 -1
  284. package/dist/tui/index.js.map +0 -1
  285. package/dist/utils/batchProcessor.d.ts.map +0 -1
  286. package/dist/utils/batchProcessor.js.map +0 -1
  287. package/dist/utils/compression.d.ts.map +0 -1
  288. package/dist/utils/compression.js.map +0 -1
  289. package/dist/utils/costUtils.d.ts.map +0 -1
  290. package/dist/utils/costUtils.js.map +0 -1
  291. package/dist/utils/reliability.d.ts.map +0 -1
  292. package/dist/utils/reliability.js.map +0 -1
  293. package/dist/utils/sorting.d.ts.map +0 -1
  294. package/dist/utils/sorting.js.map +0 -1
  295. package/dist/utils/speculativeDecoding.d.ts.map +0 -1
  296. package/dist/utils/speculativeDecoding.js.map +0 -1
  297. package/dist/utils/tokenUtils.d.ts.map +0 -1
  298. package/dist/utils/tokenUtils.js.map +0 -1
  299. package/docs/.nojekyll +0 -0
  300. package/docs/ANALYSIS_PRINCIPLES.md +0 -162
  301. package/docs/API.md +0 -855
  302. package/docs/ARCHITECTURAL-IMPROVEMENTS-2025.md +0 -1391
  303. package/docs/ARCHITECTURAL-IMPROVEMENTS-REVISED-2025.md +0 -1051
  304. package/docs/BENCHMARK.md +0 -170
  305. package/docs/CHINESE_PROVIDER_RELIABILITY.md +0 -37
  306. package/docs/CITATIONS.md +0 -74
  307. package/docs/CLAIMS_AND_EVIDENCE.md +0 -58
  308. package/docs/CONFIGURATION.md +0 -476
  309. package/docs/COUNCIL_DECISION.json +0 -816
  310. package/docs/COUNCIL_SUMMARY.md +0 -319
  311. package/docs/COUNCIL_V2.2_DECISION.md +0 -416
  312. package/docs/ENGINEERING_SPEC.md +0 -55
  313. package/docs/FACTORY_RESET.md +0 -34
  314. package/docs/GEO.md +0 -66
  315. package/docs/GEO_OPTIMIZATION.md +0 -30
  316. package/docs/GEO_ROOT_CAUSE.md +0 -136
  317. package/docs/GEO_STATUS.md +0 -85
  318. package/docs/GEO_TEST_RESULTS.md +0 -176
  319. package/docs/HN_CHECKLIST.md +0 -38
  320. package/docs/HN_FOUNDER_COMMENT.md +0 -17
  321. package/docs/HN_SUBMISSION_FINAL.md +0 -180
  322. package/docs/HN_SUBMISSION_V3.md +0 -56
  323. package/docs/IMPROVEMENT_ROADMAP.md +0 -515
  324. package/docs/INTEGRATIONS.md +0 -420
  325. package/docs/LANGCHAIN_INTEGRATION.md +0 -147
  326. package/docs/LLM_COUNCIL_DECISION.md +0 -508
  327. package/docs/MIDDLEWARE_CHAIN.md +0 -35
  328. package/docs/PROMO_CHECKLIST.md +0 -200
  329. package/docs/QUICKSTART.md +0 -271
  330. package/docs/QUICK_START.md +0 -43
  331. package/docs/QUICK_START_VISIBILITY.md +0 -782
  332. package/docs/REDDIT_GAP_ANALYSIS.md +0 -299
  333. package/docs/RELEASE_CHECKLIST.md +0 -32
  334. package/docs/REPRODUCIBILITY.md +0 -63
  335. package/docs/RESEARCH_BACKED_IMPROVEMENTS.md +0 -1180
  336. package/docs/ROUTING_RUBRIC.md +0 -197
  337. package/docs/SEO_AUDIT.md +0 -186
  338. package/docs/SOCIAL_LISTENING.md +0 -219
  339. package/docs/TMLPD_QNA.md +0 -751
  340. package/docs/TMLPD_V2.1_COMPLETE.md +0 -763
  341. package/docs/TMLPD_V2.2_RESEARCH_ROADMAP.md +0 -754
  342. package/docs/UPDATE_TOPICS.md +0 -15
  343. package/docs/USE_CASES.md +0 -59
  344. package/docs/V2.2_IMPLEMENTATION_COMPLETE.md +0 -446
  345. package/docs/V2_IMPLEMENTATION_GUIDE.md +0 -388
  346. package/docs/VERCEL_AI_SDK.md +0 -209
  347. package/docs/VISIBILITY_ADOPTION_PLAN.md +0 -1005
  348. package/docs/_config.yml +0 -49
  349. package/docs/ai-plugin.json +0 -16
  350. package/docs/api.html +0 -513
  351. package/docs/architecture-diagram.md +0 -40
  352. package/docs/benchmark-chart.png +0 -0
  353. package/docs/benchmark.html +0 -387
  354. package/docs/blog/routerarena-number-one.html +0 -73
  355. package/docs/cli-cheatsheet.md +0 -339
  356. package/docs/compare.md +0 -109
  357. package/docs/comparison-litellm.md +0 -88
  358. package/docs/comparison.md +0 -108
  359. package/docs/cost-chart-ascii.md +0 -42
  360. package/docs/cost-comparison-chart.svg +0 -88
  361. package/docs/curl-examples.md +0 -247
  362. package/docs/demo-auto.html +0 -264
  363. package/docs/demo.html +0 -416
  364. package/docs/geo/GENERATIVE_ENGINE_OPTIMIZATION.md +0 -232
  365. package/docs/index.html +0 -507
  366. package/docs/launch-content/LAUNCH_EXECUTION_CHECKLIST.md +0 -421
  367. package/docs/launch-content/README.md +0 -457
  368. package/docs/launch-content/assets/cost_comparison_100_tasks.png +0 -0
  369. package/docs/launch-content/assets/cumulative_savings.png +0 -0
  370. package/docs/launch-content/assets/parallel_speedup.png +0 -0
  371. package/docs/launch-content/assets/provider_pricing_comparison.png +0 -0
  372. package/docs/launch-content/assets/task_breakdown_comparison.png +0 -0
  373. package/docs/launch-content/generate_charts.py +0 -313
  374. package/docs/launch-content/hn_show_post.md +0 -139
  375. package/docs/launch-content/partner_outreach_templates.md +0 -745
  376. package/docs/launch-content/reddit_posts.md +0 -467
  377. package/docs/launch-content/twitter_thread.txt +0 -460
  378. package/docs/npm-downloads-chart.svg +0 -43
  379. package/docs/openapi.json +0 -139
  380. package/docs/openapi.yaml +0 -1318
  381. package/docs/quick-start.html +0 -366
  382. package/docs/robots.txt +0 -52
  383. package/docs/sitemap.xml +0 -57
  384. package/docs/styles.css +0 -682
  385. package/docs/well-known/ai-plugin.json +0 -16
  386. package/docs/wellknown/ai-plugin.json +0 -16
  387. package/docs-site/assets/og-banner.svg +0 -194
  388. package/docs-site/index.html +0 -632
  389. package/eval/README.md +0 -46
  390. package/eval/baselines/main.json +0 -12
  391. package/eval/benchmark_dataset.jsonl +0 -16
  392. package/eval/check_golden_routes.js +0 -64
  393. package/eval/datasets/catalog.json +0 -33
  394. package/eval/datasets/slices/cn_provider_reliability_v1.jsonl +0 -3
  395. package/eval/datasets/slices/cost_pressure_v1.jsonl +0 -3
  396. package/eval/datasets/slices/safety_guardrails_v1.jsonl +0 -3
  397. package/eval/evals.json +0 -199
  398. package/eval/fault_injection_thresholds.json +0 -3
  399. package/eval/generate_report.js +0 -128
  400. package/eval/golden_routes.json +0 -114
  401. package/eval/lib/experiment_registry.js +0 -24
  402. package/eval/run_eval.js +0 -197
  403. package/eval/run_fault_injection.js +0 -201
  404. package/eval/run_shadow_eval.js +0 -85
  405. package/eval/thresholds.json +0 -9
  406. package/examples/QUICKSTART.md +0 -183
  407. package/examples/README.md +0 -61
  408. package/examples/a3m-sdk.js +0 -124
  409. package/examples/basic-route.js +0 -54
  410. package/examples/chat-loop.js +0 -202
  411. package/examples/classify-then-route.js +0 -102
  412. package/examples/cost-compare.js +0 -120
  413. package/examples/ensemble.js +0 -160
  414. package/examples/whatsapp-telegram-bridge-demo.js +0 -302
  415. package/examples/whatsapp-telegram-bridge.js +0 -269
  416. package/hf-space/README.md +0 -23
  417. package/hf-space/app.py +0 -240
  418. package/hf-space/requirements.txt +0 -1
  419. package/huggingface_space/README.md +0 -35
  420. package/huggingface_space/app.py +0 -126
  421. package/huggingface_space/create_space.py +0 -208
  422. package/huggingface_space/requirements.txt +0 -1
  423. package/mcp-server/README.md +0 -188
  424. package/mcp-server/package.json +0 -29
  425. package/mcp-server/src/index.ts +0 -744
  426. package/mcp-server/tsconfig.json +0 -19
  427. package/openclaw-alexa-bridge/ALL_REMAINING_FIXES_PLAN.md +0 -313
  428. package/openclaw-alexa-bridge/REMAINING_FIXES_SUMMARY.md +0 -277
  429. package/openclaw-alexa-bridge/src/alexa_handler_no_tmlpd.js +0 -1234
  430. package/openclaw-alexa-bridge/test_fixes.js +0 -77
  431. package/playground/README.md +0 -51
  432. package/playground/codesandbox.json +0 -12
  433. package/playground/index.js +0 -39
  434. package/proxy/README.md +0 -227
  435. package/proxy/package-lock.json +0 -831
  436. package/proxy/package.json +0 -17
  437. package/proxy/rate-limit.js +0 -145
  438. package/proxy/rate-limit.test.js +0 -311
  439. package/proxy/server.js +0 -970
  440. package/python/README.md +0 -102
  441. package/python/a3m/__init__.py +0 -6
  442. package/python/a3m/client.py +0 -190
  443. package/python/a3m/models.py +0 -40
  444. package/python/a3m/sync_client.py +0 -61
  445. package/python/examples.py +0 -53
  446. package/python/integrations.py +0 -330
  447. package/python/pyproject.toml +0 -23
  448. package/python/setup.py +0 -28
  449. package/python/tmlpd.py +0 -369
  450. package/qna/REDDIT_GAP_ANALYSIS.md +0 -299
  451. package/qna/TMLPD_QNA.md +0 -751
  452. package/research/FINDING_001_safety.md +0 -28
  453. package/research/FINDING_002_error_diversity.md +0 -32
  454. package/research/FINDING_003_confidence_weighted_voting.md +0 -32
  455. package/research/FINDING_004_cross_model_semantic_detection.md +0 -37
  456. package/research/FINDING_005_knowledge_gap_orthogonality.md +0 -34
  457. package/research/HALLUCINATION_RESEARCH.md +0 -27
  458. package/research/ensemble-voting.md +0 -324
  459. package/research/loss-functions.md +0 -545
  460. package/research-log.md +0 -49
  461. package/scripts/banner.js +0 -29
  462. package/scripts/benchmark-local-routerarena.ts +0 -176
  463. package/scripts/benchmark.js +0 -145
  464. package/scripts/benchmark.sh +0 -61
  465. package/scripts/compare-providers.sh +0 -230
  466. package/scripts/content-planner.js +0 -25
  467. package/scripts/create-labeled-benchmark.ts +0 -105
  468. package/scripts/cross_post.py +0 -443
  469. package/scripts/local-router-benchmark.ts +0 -154
  470. package/scripts/post-all.sh +0 -41
  471. package/scripts/publish_fcc.py +0 -106
  472. package/scripts/push-to-gitee.sh +0 -25
  473. package/scripts/routerarena_ensemble.js +0 -144
  474. package/scripts/routing-benchmark-v2.js +0 -373
  475. package/scripts/routing-benchmark-v3.js +0 -118
  476. package/scripts/routing-benchmark.js +0 -462
  477. package/scripts/run-labeled-benchmark.mjs +0 -104
  478. package/scripts/run-mmlu-benchmark.js +0 -176
  479. package/scripts/run-provider-benchmark.js +0 -244
  480. package/scripts/update-npm-badges.js +0 -158
  481. package/skill/SKILL.md +0 -238
  482. package/src/__tests__/integration/tmpld_integration.test.py +0 -540
  483. package/src/skills/__tests__/skill_manager.test.ts +0 -328
  484. package/submissions/benchmarks/ALL_PLATFORMS_SUBMISSION.md +0 -94
  485. package/submissions/benchmarks/LLMROUTERBENCH_SUBMISSION.md +0 -121
  486. package/submissions/benchmarks/MMRBENCH_SUBMISSION.md +0 -94
  487. package/submissions/benchmarks/ROUTERARENA_UPDATE.md +0 -83
  488. package/submissions/benchmarks/ROUTERBENCH_SUBMISSION.md +0 -225
  489. package/test-council/1-structure-tests.test.js +0 -353
  490. package/test-council/1-structure-tests.test.ts +0 -353
  491. package/test-council/2-edge-case-tests.test.ts +0 -361
  492. package/test-council/3-performance-tests.test.ts +0 -669
  493. package/test-council/4-integration-tests.test.ts +0 -391
  494. package/test-council/5-agent-council-eval.test.ts +0 -413
  495. package/test-council/AGENT_COUNCIL_ARCHITECTURE.md +0 -349
  496. package/test-council/TEST_COUNCIL_REPORT.md +0 -201
  497. package/test-council/agents/edge-case-agent.ts +0 -363
  498. package/test-council/agents/performance-agent.ts +0 -426
  499. package/test-council/agents/structure-agent.ts +0 -227
  500. package/test-council/council.md +0 -183
  501. package/tests/__mocks__/tokenUtils.ts +0 -8
  502. package/tests/memory/episodicMemory.test.ts +0 -227
  503. package/tests/package-lock.json +0 -1628
  504. package/tests/package.json +0 -18
  505. package/tests/routing/ensembleVoting.test.ts +0 -236
  506. package/tests/routing/providerRetry.test.ts +0 -360
  507. package/tests/routing/queryTypePresets.test.ts +0 -208
  508. package/tests/security/guardrailEngine.test.ts +0 -700
  509. package/tests/tsconfig.json +0 -21
  510. package/tests/vitest.config.ts +0 -18
  511. package/tmlpd-pi-extension/README.md +0 -66
  512. package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts +0 -114
  513. package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts.map +0 -1
  514. package/tmlpd-pi-extension/dist/cache/prefixCache.js +0 -285
  515. package/tmlpd-pi-extension/dist/cache/prefixCache.js.map +0 -1
  516. package/tmlpd-pi-extension/dist/cache/responseCache.d.ts +0 -58
  517. package/tmlpd-pi-extension/dist/cache/responseCache.d.ts.map +0 -1
  518. package/tmlpd-pi-extension/dist/cache/responseCache.js +0 -153
  519. package/tmlpd-pi-extension/dist/cache/responseCache.js.map +0 -1
  520. package/tmlpd-pi-extension/dist/cli.js +0 -59
  521. package/tmlpd-pi-extension/dist/cost/costTracker.d.ts +0 -95
  522. package/tmlpd-pi-extension/dist/cost/costTracker.d.ts.map +0 -1
  523. package/tmlpd-pi-extension/dist/cost/costTracker.js +0 -240
  524. package/tmlpd-pi-extension/dist/cost/costTracker.js.map +0 -1
  525. package/tmlpd-pi-extension/dist/index.d.ts +0 -723
  526. package/tmlpd-pi-extension/dist/index.d.ts.map +0 -1
  527. package/tmlpd-pi-extension/dist/index.js +0 -239
  528. package/tmlpd-pi-extension/dist/index.js.map +0 -1
  529. package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts +0 -82
  530. package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts.map +0 -1
  531. package/tmlpd-pi-extension/dist/memory/episodicMemory.js +0 -145
  532. package/tmlpd-pi-extension/dist/memory/episodicMemory.js.map +0 -1
  533. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts +0 -102
  534. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts.map +0 -1
  535. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js +0 -207
  536. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js.map +0 -1
  537. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts +0 -85
  538. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts.map +0 -1
  539. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js +0 -210
  540. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js.map +0 -1
  541. package/tmlpd-pi-extension/dist/providers/localProvider.d.ts +0 -102
  542. package/tmlpd-pi-extension/dist/providers/localProvider.d.ts.map +0 -1
  543. package/tmlpd-pi-extension/dist/providers/localProvider.js +0 -338
  544. package/tmlpd-pi-extension/dist/providers/localProvider.js.map +0 -1
  545. package/tmlpd-pi-extension/dist/providers/registry.d.ts +0 -55
  546. package/tmlpd-pi-extension/dist/providers/registry.d.ts.map +0 -1
  547. package/tmlpd-pi-extension/dist/providers/registry.js +0 -138
  548. package/tmlpd-pi-extension/dist/providers/registry.js.map +0 -1
  549. package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts +0 -68
  550. package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts.map +0 -1
  551. package/tmlpd-pi-extension/dist/routing/advancedRouter.js +0 -332
  552. package/tmlpd-pi-extension/dist/routing/advancedRouter.js.map +0 -1
  553. package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts +0 -101
  554. package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts.map +0 -1
  555. package/tmlpd-pi-extension/dist/tools/tmlpdTools.js +0 -368
  556. package/tmlpd-pi-extension/dist/tools/tmlpdTools.js.map +0 -1
  557. package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts +0 -96
  558. package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts.map +0 -1
  559. package/tmlpd-pi-extension/dist/utils/batchProcessor.js +0 -170
  560. package/tmlpd-pi-extension/dist/utils/batchProcessor.js.map +0 -1
  561. package/tmlpd-pi-extension/dist/utils/compression.d.ts +0 -61
  562. package/tmlpd-pi-extension/dist/utils/compression.d.ts.map +0 -1
  563. package/tmlpd-pi-extension/dist/utils/compression.js +0 -281
  564. package/tmlpd-pi-extension/dist/utils/compression.js.map +0 -1
  565. package/tmlpd-pi-extension/dist/utils/reliability.d.ts +0 -74
  566. package/tmlpd-pi-extension/dist/utils/reliability.d.ts.map +0 -1
  567. package/tmlpd-pi-extension/dist/utils/reliability.js +0 -177
  568. package/tmlpd-pi-extension/dist/utils/reliability.js.map +0 -1
  569. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts +0 -117
  570. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts.map +0 -1
  571. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js +0 -246
  572. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js.map +0 -1
  573. package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts +0 -50
  574. package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts.map +0 -1
  575. package/tmlpd-pi-extension/dist/utils/tokenUtils.js +0 -124
  576. package/tmlpd-pi-extension/dist/utils/tokenUtils.js.map +0 -1
  577. package/tmlpd-pi-extension/examples/QUICKSTART.md +0 -183
  578. package/tmlpd-pi-extension/package-lock.json +0 -79
  579. package/tmlpd-pi-extension/package.json +0 -172
  580. package/tmlpd-pi-extension/python/examples.py +0 -53
  581. package/tmlpd-pi-extension/python/integrations.py +0 -330
  582. package/tmlpd-pi-extension/python/setup.py +0 -28
  583. package/tmlpd-pi-extension/python/tmlpd.py +0 -369
  584. package/tmlpd-pi-extension/qna/REDDIT_GAP_ANALYSIS.md +0 -299
  585. package/tmlpd-pi-extension/qna/TMLPD_QNA.md +0 -751
  586. package/tmlpd-pi-extension/skill/SKILL.md +0 -238
  587. package/tmlpd-pi-extension/src/cache/responseCache.ts +0 -147
  588. package/tmlpd-pi-extension/src/cost/costTracker.ts +0 -302
  589. package/tmlpd-pi-extension/src/index.ts +0 -232
  590. package/tmlpd-pi-extension/src/memory/episodicMemory.ts +0 -257
  591. package/tmlpd-pi-extension/src/orchestration/haloOrchestrator.ts +0 -266
  592. package/tmlpd-pi-extension/src/orchestration/mctsWorkflow.ts +0 -262
  593. package/tmlpd-pi-extension/src/providers/localProvider.ts +0 -406
  594. package/tmlpd-pi-extension/src/providers/registry.ts +0 -164
  595. package/tmlpd-pi-extension/src/routing/ensembleVoting.ts +0 -159
  596. package/tmlpd-pi-extension/src/routing/queryTypePresets.ts +0 -136
  597. package/tmlpd-pi-extension/src/tools/tmlpdTools.ts +0 -433
  598. package/tmlpd-pi-extension/src/utils/batchProcessor.ts +0 -232
  599. package/tmlpd-pi-extension/src/utils/compression.ts +0 -325
  600. package/tmlpd-pi-extension/src/utils/reliability.ts +0 -221
  601. package/tmlpd-pi-extension/src/utils/tokenUtils.ts +0 -145
  602. package/tmlpd-pi-extension/tsconfig.json +0 -18
  603. package/tsconfig.build.json +0 -29
  604. package/tsconfig.json +0 -18
  605. /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