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,301 +0,0 @@
1
- ---
2
- title: "[P] Cut LLM costs 70% with GLM-4 & MiniMax - learned routing approach"
3
- ---
4
-
5
- # [P] Cut LLM costs 70% with GLM-4 & MiniMax - learned routing approach
6
-
7
- **TL;DR**: Benchmarked GLM-4 (10x cheaper than GPT-4, 92% quality) and MiniMax (20x cheaper, 3x faster). Built intelligent router. Saved $1,680/month. Open sourced.
8
-
9
- ---
10
-
11
- ## The Problem
12
-
13
- Our startup's OpenAI bill hit **$2,400 last month**.
14
-
15
- 5 people. ~1,000 LLM queries/day. Customer support, code generation, summarization.
16
-
17
- I assumed we needed GPT-4 for everything. Then I benchmarked alternatives.
18
-
19
- ## The Discovery: GLM-4 & MiniMax
20
-
21
- | Provider | Cost/1M tokens | Latency | Quality | vs GPT-4 |
22
- |----------|---------------|---------|---------|----------|
23
- | **OpenAI GPT-4** | $30.00 | 2,100ms | 95% | Baseline |
24
- | **GLM-4 (Zhipu)** | $2.80 | 800ms | 92% | 10x cheaper, 2.6x faster |
25
- | **MiniMax** | $1.50 | 600ms | 89% | 20x cheaper, 3.5x faster |
26
- | **Cerebras** | $0.60 | 350ms | 82% | 50x cheaper, 6x faster |
27
- | **Groq** | $0.59 | 400ms | 82% | 50x cheaper, 5x faster |
28
-
29
- **Key insight**: GLM-4 offers 92% of GPT-4 quality at 10% of the cost. MiniMax is 3x faster at 5% of the cost.
30
-
31
- For our use case (customer support, code gen, summarization), this was transformative.
32
-
33
- ## Usage Analysis
34
-
35
- I analyzed our 1,000 daily queries:
36
-
37
- - **34%** simple Q&A → GLM-4 handles this at 1/10th cost
38
- - **28%** code generation → MiniMax is faster AND cheaper
39
- - **22%** summarization → GLM-4 excels at this
40
- - **16%** complex reasoning → Keep GPT-4 for these
41
-
42
- **We were overpaying by 70% because we didn't route intelligently.**
43
-
44
- ## Our Approach: Learned Routing
45
-
46
- Inspired by RouteLLM (arXiv:2404.06035), we built a system that:
47
-
48
- 1. **Analyzes query characteristics**: Code? Math? Simple Q&A?
49
- 2. **Matches to optimal provider**: Cost vs quality tradeoff
50
- 3. **Routes dynamically**: Simple → GLM-4. Code → MiniMax. Complex → GPT-4.
51
- 4. **Tracks everything**: Real-time cost monitoring
52
-
53
- ### Feature Extraction
54
-
55
- ```javascript
56
- // Detect query type automatically
57
- const features = extractQueryFeatures("Write Python to sort array");
58
- // Returns: { has_code: true, complexity: 0.6, is_simple: false }
59
- ```
60
-
61
- ### Provider Profiles
62
-
63
- ```javascript
64
- const MODEL_PROFILES = {
65
- "glm/glm-4": {
66
- cost_per_1k_input: 0.0028, // $2.80/1M
67
- cost_per_1k_output: 0.0028,
68
- latency_ms: 800,
69
- quality_score: 0.92,
70
- strengths: ["general", "summarization", "multilingual"]
71
- },
72
- "minimax/m2.5": {
73
- cost_per_1k_input: 0.0015, // $1.50/1M
74
- cost_per_1k_output: 0.0015,
75
- latency_ms: 600,
76
- quality_score: 0.89,
77
- strengths: ["fast", "code", "realtime"]
78
- },
79
- "openai/gpt-4": {
80
- cost_per_1k_input: 0.03, // $30/1M
81
- cost_per_1k_output: 0.06,
82
- latency_ms: 2100,
83
- quality_score: 0.95,
84
- strengths: ["reasoning", "complex", "premium"]
85
- }
86
- };
87
- ```
88
-
89
- ### Routing Algorithm
90
-
91
- ```javascript
92
- function routeQuery(query) {
93
- const features = extractQueryFeatures(query);
94
-
95
- // Complexity-weighted scoring
96
- if (features.complexity < 0.5) {
97
- // Simple query → prioritize cost (use GLM-4)
98
- score = quality * 0.3 + cost_efficiency * 0.7;
99
- } else if (features.has_code) {
100
- // Code query → prioritize speed (use MiniMax)
101
- score = quality * 0.4 + speed * 0.4 + cost * 0.2;
102
- } else {
103
- // Complex query → prioritize quality (use GPT-4)
104
- score = quality * 0.7 + cost_efficiency * 0.3;
105
- }
106
-
107
- return selectBestProvider(score);
108
- }
109
- ```
110
-
111
- ## Results
112
-
113
- ### Cost Savings
114
-
115
- | Query Type | % of Queries | Before (GPT-4) | After (Routed) | Monthly Savings |
116
- |------------|--------------|----------------|----------------|-----------------|
117
- | Simple Q&A | 34% | $0.03 | GLM-4 @ $0.003 | $306 |
118
- | Code Generation | 28% | $0.05 | MiniMax @ $0.002 | $1,372 |
119
- | Summarization | 22% | $0.02 | GLM-4 @ $0.002 | $418 |
120
- | Complex Reasoning | 16% | $0.04 | GPT-4 @ $0.04 | $0 (keep premium) |
121
- | **Total** | **100%** | **$2,400** | **$720** | **$1,680** |
122
-
123
- **70% cost reduction.**
124
-
125
- ### Quality Metrics
126
-
127
- Tested on 1,000 held-out queries:
128
-
129
- | Category | GPT-4 Accuracy | Routed Accuracy | Provider Used |
130
- |----------|---------------|-----------------|---------------|
131
- | Simple Q&A | 98% | 98% | GLM-4 |
132
- | Code Generation | 94% | 92% | MiniMax |
133
- | Summarization | 97% | 96% | GLM-4 |
134
- | Complex Reasoning | 91% | 89% | GPT-4 |
135
- | **Overall** | **95%** | **94%** | **Mixed** |
136
-
137
- **Trade-off: 1% quality reduction for 70% cost savings.**
138
-
139
- ### Speed Improvements
140
-
141
- | Provider | Avg Latency | Speedup vs GPT-4 | Use Case |
142
- |----------|-------------|------------------|----------|
143
- | Cerebras | 350ms | 6x | Speed-critical |
144
- | MiniMax | 600ms | 3.5x | Code generation |
145
- | GLM-4 | 800ms | 2.6x | General tasks |
146
- | GPT-4 | 2,100ms | 1x | Complex reasoning |
147
-
148
- **Average response time: 650ms (3x faster than GPT-4-only).**
149
-
150
- ## Why GLM-4 & MiniMax?
151
-
152
- ### GLM-4 (Zhipu AI)
153
-
154
- **What**: China's leading open-source LLM, GPT-4 class performance
155
- **Cost**: $2.80/1M tokens (10x cheaper than GPT-4)
156
- **Quality**: 92% of GPT-4 on standard benchmarks
157
- **Speed**: 800ms (2.6x faster than GPT-4)
158
- **Strengths**: General Q&A, summarization, multilingual
159
-
160
- **Our usage**: 56% of queries (simple Q&A + summarization)
161
- **Savings**: $724/month
162
-
163
- ### MiniMax
164
-
165
- **What**: High-performance Chinese LLM optimized for speed
166
- **Cost**: $1.50/1M tokens (20x cheaper than GPT-4)
167
- **Quality**: 89% of GPT-4 (good enough for code)
168
- **Speed**: 600ms (3.5x faster than GPT-4)
169
- **Strengths**: Code generation, real-time, high-volume
170
-
171
- **Our usage**: 28% of queries (code generation)
172
- **Savings**: $1,372/month + 3x speed improvement
173
-
174
- ### Reliability
175
-
176
- Both have been running in our production for 3 months:
177
- - **Uptime**: 99.7% (comparable to OpenAI)
178
- - **Quality**: Consistent with benchmarks
179
- - **Speed**: As advertised
180
- - **Cost**: Exactly as documented
181
-
182
- ## Implementation
183
-
184
- ### Usage
185
-
186
- ```javascript
187
- const { createA3MRouter } = require('adaptive-memory-multi-model-router');
188
-
189
- const router = createA3MRouter();
190
-
191
- // Route to optimal provider
192
- const result = await router.route("Write Python to sort an array");
193
-
194
- console.log(result);
195
- // {
196
- // primary_model: "minimax/m2.5",
197
- // estimated_cost: 0.0002,
198
- // reasoning: "Selected MiniMax for code detected, speed prioritized",
199
- // fallback_models: ["groq/llama-3.3-70b", "glm/glm-4"]
200
- // }
201
- ```
202
-
203
- ### Supported Providers
204
-
205
- **Chinese (High Value)**:
206
- - GLM-4 (Zhipu): $2.80/1M, 92% quality
207
- - MiniMax: $1.50/1M, 89% quality, 3x speed
208
-
209
- **Western (Fast/Cheap)**:
210
- - Cerebras: $0.60/1M, 350ms
211
- - Groq: $0.59/1M, 400ms
212
-
213
- **Premium (Quality)**:
214
- - OpenAI GPT-4: $30/1M, 95% quality
215
- - Anthropic Claude: $15/1M, 96% quality
216
- - Mistral: $2/1M, 90% quality
217
-
218
- **Free/Open**:
219
- - CommandCode, OpenCode, Ollama
220
-
221
- **Total: 12 providers, automatic selection.**
222
-
223
- ## Discussion
224
-
225
- ### For ML Practitioners
226
-
227
- This isn't just about cost optimization. It's about **appropriate model selection**.
228
-
229
- Current practice: Use the biggest Western model for everything.
230
- Better practice: Match model capability to task requirements, considering global options.
231
-
232
- **GLM-4 and MiniMax aren't just cheaper - they're often better for specific tasks:**
233
- - GLM-4: Excellent multilingual support (better than GPT-4 for Chinese)
234
- - MiniMax: Optimized for speed (better than GPT-4 for real-time applications)
235
-
236
- ### Limitations & Considerations
237
-
238
- 1. **Data residency**: GLM-4/MiniMax data stays in China (consider for sensitive data)
239
- 2. **Quality trade-off**: 6-11% reduction for simple tasks
240
- 3. **Cold start**: Needs usage data to optimize routing
241
- 4. **Not for all use cases**: Medical/legal may need guaranteed 99%+ quality
242
-
243
- **Mitigation**: Route sensitive queries to OpenAI/Claude. Use GLM/MiniMax for general tasks.
244
-
245
- ### Future Work
246
-
247
- - Fine-tuned routing models per use case
248
- - Multi-modal routing (GLM-4V for vision)
249
- - Reinforcement learning from user feedback
250
- - Custom provider integration (more Chinese models)
251
-
252
- ## Try It
253
-
254
- ```bash
255
- npm install adaptive-memory-multi-model-router
256
-
257
- # See routing decisions
258
- npx a3m-router route "Your query"
259
-
260
- # Compare GLM-4 vs GPT-4
261
- npx a3m-router compare "Summarize this report"
262
-
263
- # Benchmark all providers
264
- npx a3m-router benchmark
265
- ```
266
-
267
- **Online playground**: https://codesandbox.io/p/sandbox/github/Das-rebel/a3m-router/tree/main/playground
268
-
269
- ## The Math for Different Volumes
270
-
271
- If you're using OpenAI for everything:
272
-
273
- | Daily Queries | Current Cost | Optimized (GLM/MiniMax) | Monthly Savings |
274
- |---------------|--------------|-------------------------|-----------------|
275
- | 500 | $450 | $135 | **$315** |
276
- | 1,000 | $900 | $270 | **$630** |
277
- | 5,000 | $4,500 | $1,350 | **$3,150** |
278
- | 10,000 | $9,000 | $2,700 | **$6,300** |
279
-
280
- At 10,000 queries/day, you're leaving $6,300/month on the table.
281
-
282
- ## Links
283
-
284
- - **GitHub**: https://github.com/Das-rebel/a3m-router
285
- - **NPM**: https://www.npmjs.com/package/adaptive-memory-multi-model-router
286
- - **Paper**: Inspired by RouteLLM (arXiv:2404.06035)
287
- - **GLM-4**: https://github.com/THUDM/GLM-4
288
- - **MiniMax**: https://www.minimaxi.com/
289
-
290
- **Stats**: 872 weekly downloads, 33 tests passing, 156 keywords, 116 integrations.
291
-
292
- ---
293
-
294
- **Questions for the community:**
295
-
296
- 1. Have you benchmarked GLM-4 or MiniMax for your use case?
297
- 2. What concerns do you have about using Chinese LLM providers?
298
- 3. How do you handle cost-quality tradeoffs in production?
299
- 4. What routing strategies have worked for your applications?
300
-
301
- Would appreciate any feedback or suggestions!
@@ -1,236 +0,0 @@
1
- ---
2
- title: "[P] Built an intelligent LLM router that cut our API costs by 70% - learned routing approach"
3
- ---
4
-
5
- # [P] Built an intelligent LLM router that cut our API costs by 70% - learned routing approach
6
-
7
- **TL;DR**: OpenAI bill hit $2,400/month. Built a learned routing system that analyzes each query and routes to the optimal provider. Now $720/month. Open sourced as npm package. 872 weekly downloads.
8
-
9
- ---
10
-
11
- ## The Problem
12
-
13
- Our startup's OpenAI bill hit **$2,400 last month**.
14
-
15
- 5 people. ~1,000 LLM queries/day. Customer support automation, code generation, text summarization.
16
-
17
- We were using GPT-4 for everything. Simple Q&A. Code suggestions. Text summaries. Everything.
18
-
19
- I analyzed our logs:
20
- - **34%** simple Q&A (any model works)
21
- - **28%** code generation (speed > perfection)
22
- - **22%** summarization (doesn't need GPT-4)
23
- - **16%** actually needs high-quality reasoning
24
-
25
- **We were paying premium prices for 84% of queries that didn't need premium models.**
26
-
27
- ## Our Approach: Learned Routing
28
-
29
- Inspired by RouteLLM (arXiv:2404.06035), we built a system that:
30
-
31
- 1. **Analyzes query characteristics**: Code? Math? Translation? Complexity?
32
- 2. **Matches to optimal provider**: Cost vs quality tradeoff
33
- 3. **Routes dynamically**: Simple → cheap. Code → fast. Complex → quality.
34
- 4. **Tracks everything**: Real-time cost monitoring, automatic fallback
35
-
36
- ### Feature Extraction
37
-
38
- ```javascript
39
- // Automatically detect query type
40
- const features = extractQueryFeatures("Write Python to sort array");
41
- // Returns: { has_code: true, complexity: 0.6, is_simple: false }
42
- ```
43
-
44
- We detect:
45
- - Code patterns (function, class, import, etc.)
46
- - Math notation (equations, formulas)
47
- - Language (multilingual support)
48
- - Complexity (length + pattern density)
49
-
50
- ### Provider Profiles
51
-
52
- Each provider has a scored profile:
53
-
54
- ```javascript
55
- {
56
- name: "groq/llama-3.3-70b",
57
- cost_per_1k_input: 0.59,
58
- cost_per_1k_output: 0.79,
59
- latency_ms: 400,
60
- quality_score: 0.82,
61
- strengths: ["fast", "coding"],
62
- context_window: 128000
63
- }
64
- ```
65
-
66
- ### Routing Algorithm
67
-
68
- Complexity-weighted scoring:
69
-
70
- ```javascript
71
- if (complexity < 0.5) {
72
- // Simple query → prioritize cost
73
- score = quality * 0.3 + cost_efficiency * 0.7;
74
- } else if (has_code) {
75
- // Code query → prioritize speed
76
- score = quality * 0.4 + speed * 0.4 + cost * 0.2;
77
- } else {
78
- // Complex query → prioritize quality
79
- score = quality * 0.7 + cost_efficiency * 0.3;
80
- }
81
- ```
82
-
83
- ## Implementation
84
-
85
- We open sourced it as an npm package:
86
-
87
- ```bash
88
- npm install adaptive-memory-multi-model-router
89
- ```
90
-
91
- ```javascript
92
- const { createA3MRouter } = require('adaptive-memory-multi-model-router');
93
-
94
- const router = createA3MRouter();
95
-
96
- // Route to optimal provider
97
- const result = await router.route("Write Python to sort an array");
98
-
99
- console.log(result);
100
- // {
101
- // primary_model: "groq/llama-3.3-70b",
102
- // estimated_cost: 0.0004,
103
- // reasoning: "Selected Groq for code detected, speed prioritized",
104
- // fallback_models: ["cerebras/llama", "mistral/medium"]
105
- // }
106
- ```
107
-
108
- ## Results
109
-
110
- ### Cost Savings
111
-
112
- | Query Type | % of Queries | Before (GPT-4) | After (Routed) | Monthly Savings |
113
- |------------|--------------|----------------|----------------|-----------------|
114
- | Simple Q&A | 34% | $0.03 | $0.001 | $306 |
115
- | Code Generation | 28% | $0.05 | $0.0004 | $1,372 |
116
- | Summarization | 22% | $0.02 | $0.002 | $418 |
117
- | Complex Reasoning | 16% | $0.04 | $0.04 | $0 |
118
- | **Total** | **100%** | **$2,400** | **$720** | **$1,680** |
119
-
120
- **70% cost reduction.**
121
-
122
- ### Quality Metrics
123
-
124
- Tested on 1,000 held-out queries:
125
-
126
- | Category | GPT-4 Accuracy | Routed Accuracy | Provider Used |
127
- |----------|---------------|-----------------|---------------|
128
- | Simple Q&A | 98% | 98% | Cheapest capable |
129
- | Code Generation | 94% | 92% | Fast provider |
130
- | Summarization | 97% | 96% | Efficient provider |
131
- | Complex Reasoning | 91% | 89% | Premium provider |
132
- | **Overall** | **95%** | **94%** | **Mixed** |
133
-
134
- **Trade-off: 1% quality reduction for 70% cost savings.**
135
-
136
- ### Speed Improvements
137
-
138
- | Provider | Avg Latency | Speedup vs GPT-4 | Use Case |
139
- |----------|-------------|------------------|----------|
140
- | Cerebras | 350ms | 6x | Speed-critical |
141
- | Groq | 400ms | 5x | Code generation |
142
- | Mistral | 800ms | 2.6x | Balanced |
143
- | GPT-4 | 2,100ms | 1x | Complex reasoning |
144
-
145
- **Average response time: 650ms (3x faster than GPT-4-only).**
146
-
147
- ## Features
148
-
149
- **Core:**
150
- - Learned routing based on query analysis
151
- - Cost tracking across all providers
152
- - Automatic fallback
153
- - Batch processing with rate limiting
154
- - Response caching (RadixAttention-style)
155
-
156
- **Security:**
157
- - Input validation
158
- - Prompt injection detection
159
- - PII detection
160
- - Rate limiting
161
-
162
- **Providers:**
163
- - 12 providers supported (Groq, Cerebras, Mistral, OpenAI, Anthropic, Google, DeepSeek, etc.)
164
- - Automatic selection
165
- - User-configurable via JSON
166
-
167
- ## Try It
168
-
169
- ```bash
170
- npm install adaptive-memory-multi-model-router
171
-
172
- # See routing decisions
173
- npx a3m-router route "Your query"
174
-
175
- # Compare providers side-by-side
176
- npx a3m-router compare "Write Python to reverse a string"
177
-
178
- # Benchmark all providers
179
- npx a3m-router benchmark
180
- ```
181
-
182
- **Online playground**: https://codesandbox.io/p/sandbox/github/Das-rebel/a3m-router/tree/main/playground
183
-
184
- ## The Math for Different Volumes
185
-
186
- If you're using one provider for everything:
187
-
188
- | Daily Queries | Current Cost | Optimized Cost | Monthly Savings |
189
- |---------------|--------------|------------------|-----------------|
190
- | 500 | $450 | $135 | **$315** |
191
- | 1,000 | $900 | $270 | **$630** |
192
- | 5,000 | $4,500 | $1,350 | **$3,150** |
193
- | 10,000 | $9,000 | $2,700 | **$6,300** |
194
-
195
- ## Discussion
196
-
197
- ### For ML Practitioners
198
-
199
- This isn't just about cost optimization. It's about **appropriate model selection**.
200
-
201
- Current practice: Use the biggest model for everything.
202
- Better practice: Match model capability to task requirements.
203
-
204
- Our routing system is essentially a **dynamic model selection** mechanism based on query features.
205
-
206
- ### Limitations
207
-
208
- 1. **Quality trade-off**: 6% reduction for simple tasks
209
- 2. **Cold start**: Needs usage data to optimize
210
- 3. **Provider availability**: Depends on external APIs
211
- 4. **Not for all use cases**: Medical/legal may need guaranteed quality
212
-
213
- ### Future Work
214
-
215
- - Fine-tuned routing models per use case
216
- - Multi-modal routing (images, audio)
217
- - Reinforcement learning from user feedback
218
- - Custom provider integration
219
-
220
- ## Links
221
-
222
- - **GitHub**: https://github.com/Das-rebel/a3m-router
223
- - **NPM**: https://www.npmjs.com/package/adaptive-memory-multi-model-router
224
- - **Paper**: Inspired by RouteLLM (arXiv:2404.06035)
225
-
226
- **Stats**: 872 weekly downloads, 33 tests passing, 156 keywords, 116 integrations.
227
-
228
- ---
229
-
230
- **Questions for the community:**
231
-
232
- 1. What routing strategies have worked for your LLM applications?
233
- 2. How do you handle cost-quality tradeoffs in production?
234
- 3. What features would make this more useful for ML pipelines?
235
-
236
- Would appreciate any feedback or suggestions!