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
package/proxy/server.js DELETED
@@ -1,970 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * A3M Router — OpenAI-Compatible API Proxy
5
- *
6
- * Standalone Express server that accepts OpenAI API requests and routes them
7
- * through the A3M Router engine. Drop-in replacement for api.openai.com.
8
- *
9
- * Usage:
10
- * node proxy/server.js
11
- * curl http://localhost:8787/v1/chat/completions -H "Content-Type: application/json" \
12
- * -d '{"model":"a3m-auto","messages":[{"role":"user","content":"Hello"}]}'
13
- *
14
- * Model names:
15
- * a3m-auto — Intelligent routing (default, best model for query)
16
- * a3m-cheapest — Cheapest available provider
17
- * a3m-fastest — Fastest available provider
18
- * a3m-ensemble — Parallel multi-LLM execution + merged result
19
- * gpt-4, gpt-4o — Standard OpenAI aliases (maps through A3M)
20
- * provider/model — Direct provider/model (groq/llama-3.3-70b-versatile)
21
- */
22
-
23
- const express = require("express");
24
- const path = require("path");
25
-
26
- // ============================================================
27
- // A3M ROUTER IMPORTS (compiled dist modules)
28
- // ============================================================
29
-
30
- const A3M_ROOT = path.resolve(__dirname, "..");
31
-
32
- const {
33
- getAvailableProviders,
34
- findCheapestAvailableProvider,
35
- findFastestAvailableProvider,
36
- loadConfig,
37
- } = require(path.join(A3M_ROOT, "dist/providers/providerConfig"));
38
-
39
- const {
40
- resolveModel,
41
- listAvailableModels,
42
- } = require(path.join(A3M_ROOT, "dist/server/modelMapper"));
43
-
44
- const { routeQuery } = require(path.join(A3M_ROOT, "dist/routing/advancedRouter"));
45
-
46
- const RateLimiter = require("./rate-limit");
47
-
48
- // ============================================================
49
- // BOOTSTRAP — Load config & API keys from env
50
- // ============================================================
51
-
52
- loadConfig();
53
-
54
- // ============================================================
55
- // CONSTANTS
56
- // ============================================================
57
-
58
- const PORT = parseInt(process.env.PORT || "8787", 10);
59
-
60
- const MODEL_STRATEGIES = {
61
- "a3m-auto": "auto",
62
- "a3m-cheapest": "cheapest",
63
- "a3m-fastest": "fastest",
64
- "a3m-ensemble": "ensemble",
65
- };
66
-
67
- // ============================================================
68
- // HELPERS
69
- // ============================================================
70
-
71
- function generateId() {
72
- return (
73
- "chatcmpl-" +
74
- Math.random().toString(36).substring(2, 14) +
75
- Date.now().toString(36)
76
- );
77
- }
78
-
79
- function openAIError(status, message, type) {
80
- return {
81
- error: {
82
- message,
83
- type: type || "server_error",
84
- code: status,
85
- },
86
- };
87
- }
88
-
89
- // ============================================================
90
- // PROVIDER API CALLS
91
- // ============================================================
92
-
93
- /**
94
- * Call any OpenAI-compatible provider (most providers).
95
- */
96
- async function callOpenAICompatible(baseUrl, apiKey, model, messages, opts) {
97
- const body = {
98
- model,
99
- messages,
100
- max_tokens: opts.max_tokens || 4096,
101
- temperature: opts.temperature,
102
- top_p: opts.top_p,
103
- stop: opts.stop,
104
- stream: opts.stream || false,
105
- };
106
- // Remove undefined keys
107
- Object.keys(body).forEach((k) => body[k] === undefined && delete body[k]);
108
-
109
- const headers = { "Content-Type": "application/json" };
110
- if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
111
-
112
- const resp = await fetch(baseUrl, {
113
- method: "POST",
114
- headers,
115
- body: JSON.stringify(body),
116
- });
117
-
118
- if (opts.stream) {
119
- return { stream: true, response: resp };
120
- }
121
-
122
- const data = await resp.json();
123
- if (data.error) {
124
- throw new Error(data.error.message || JSON.stringify(data.error));
125
- }
126
- return { stream: false, data };
127
- }
128
-
129
- /**
130
- * Call a provider determined by a ModelMapping.
131
- */
132
- async function callMapping(mapping, messages, opts) {
133
- const { providerId, model, baseUrl, apiKey, type } = mapping;
134
-
135
- // Local providers (Ollama / vLLM / LM Studio) — OpenAI-compatible
136
- if (type === "local" || type === "cli") {
137
- const ollamaUrl = (baseUrl || "http://127.0.0.1:11434/api/chat").replace(
138
- "/api/generate",
139
- "/api/chat"
140
- );
141
- const body = {
142
- model,
143
- messages,
144
- stream: opts.stream || false,
145
- options: { num_predict: opts.max_tokens || 4096 },
146
- };
147
- const resp = await fetch(ollamaUrl, {
148
- method: "POST",
149
- headers: { "Content-Type": "application/json" },
150
- body: JSON.stringify(body),
151
- });
152
-
153
- if (opts.stream) return { stream: true, response: resp, isOllama: true };
154
-
155
- const data = await resp.json();
156
- return {
157
- stream: false,
158
- data: {
159
- choices: [
160
- {
161
- message: { role: "assistant", content: data.message?.content || "" },
162
- finish_reason: "stop",
163
- },
164
- ],
165
- usage: {
166
- prompt_tokens: data.prompt_eval_count || 0,
167
- completion_tokens: data.eval_count || 0,
168
- total_tokens:
169
- (data.prompt_eval_count || 0) + (data.eval_count || 0),
170
- },
171
- model,
172
- },
173
- };
174
- }
175
-
176
- // Anthropic has a different API
177
- if (providerId === "anthropic") {
178
- return callAnthropic(mapping, messages, opts);
179
- }
180
-
181
- // Google has a different API
182
- if (providerId === "google") {
183
- return callGoogle(mapping, messages, opts);
184
- }
185
-
186
- // Everything else — OpenAI-compatible
187
- return callOpenAICompatible(baseUrl, apiKey, model, messages, opts);
188
- }
189
-
190
- async function callAnthropic(mapping, messages, opts) {
191
- const { model, apiKey } = mapping;
192
- let systemPrompt = "";
193
- const anthropicMessages = [];
194
-
195
- for (const msg of messages) {
196
- if (msg.role === "system") {
197
- systemPrompt += (systemPrompt ? "\n" : "") + msg.content;
198
- } else {
199
- anthropicMessages.push({ role: msg.role, content: msg.content });
200
- }
201
- }
202
-
203
- const body = {
204
- model,
205
- messages: anthropicMessages,
206
- max_tokens: opts.max_tokens || 4096,
207
- stream: opts.stream || false,
208
- };
209
- if (systemPrompt) body.system = systemPrompt;
210
- if (opts.temperature !== undefined) body.temperature = opts.temperature;
211
-
212
- const resp = await fetch("https://api.anthropic.com/v1/messages", {
213
- method: "POST",
214
- headers: {
215
- "Content-Type": "application/json",
216
- "x-api-key": apiKey || "",
217
- "anthropic-version": "2023-06-01",
218
- },
219
- body: JSON.stringify(body),
220
- });
221
-
222
- if (opts.stream) return { stream: true, response: resp, isAnthropic: true };
223
-
224
- const data = await resp.json();
225
- if (data.error) throw new Error(data.error.message || JSON.stringify(data.error));
226
-
227
- const content = data.content?.[0]?.text || "";
228
- return {
229
- stream: false,
230
- data: {
231
- choices: [
232
- { message: { role: "assistant", content }, finish_reason: data.stop_reason || "stop" },
233
- ],
234
- usage: {
235
- prompt_tokens: data.usage?.input_tokens || 0,
236
- completion_tokens: data.usage?.output_tokens || 0,
237
- total_tokens:
238
- (data.usage?.input_tokens || 0) + (data.usage?.output_tokens || 0),
239
- },
240
- model: data.model || model,
241
- },
242
- };
243
- }
244
-
245
- async function callGoogle(mapping, messages, opts) {
246
- const { model, apiKey } = mapping;
247
- const contents = [];
248
- let systemInstruction = null;
249
-
250
- for (const msg of messages) {
251
- if (msg.role === "system") {
252
- systemInstruction = { parts: [{ text: msg.content }] };
253
- } else {
254
- contents.push({
255
- role: msg.role === "assistant" ? "model" : "user",
256
- parts: [{ text: msg.content }],
257
- });
258
- }
259
- }
260
-
261
- const body = {
262
- contents,
263
- generationConfig: { maxOutputTokens: opts.max_tokens || 4096 },
264
- };
265
- if (systemInstruction) body.systemInstruction = systemInstruction;
266
- if (opts.temperature !== undefined)
267
- body.generationConfig.temperature = opts.temperature;
268
-
269
- const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
270
- const resp = await fetch(url, {
271
- method: "POST",
272
- headers: { "Content-Type": "application/json" },
273
- body: JSON.stringify(body),
274
- });
275
-
276
- const data = await resp.json();
277
- if (data.error) throw new Error(data.error.message || JSON.stringify(data.error));
278
-
279
- const content = data.candidates?.[0]?.content?.parts?.[0]?.text || "";
280
- return {
281
- stream: false,
282
- data: {
283
- choices: [
284
- { message: { role: "assistant", content }, finish_reason: "stop" },
285
- ],
286
- usage: {
287
- prompt_tokens: data.usageMetadata?.promptTokenCount || 0,
288
- completion_tokens: data.usageMetadata?.candidatesTokenCount || 0,
289
- total_tokens:
290
- (data.usageMetadata?.promptTokenCount || 0) +
291
- (data.usageMetadata?.candidatesTokenCount || 0),
292
- },
293
- model,
294
- },
295
- };
296
- }
297
-
298
- // ============================================================
299
- // STREAMING (SSE)
300
- // ============================================================
301
-
302
- /**
303
- * Stream a response from the upstream provider as SSE chunks.
304
- */
305
- async function streamResponse(res, mapping, messages, opts, requestId, modelName) {
306
- // Set SSE headers
307
- res.writeHead(200, {
308
- "Content-Type": "text/event-stream",
309
- "Cache-Control": "no-cache",
310
- Connection: "keep-alive",
311
- "Access-Control-Allow-Origin": "*",
312
- "X-A3M-Proxy": "true",
313
- "X-A3M-Model": modelName,
314
- "X-A3M-Provider": mapping.providerId,
315
- "X-A3M-Resolved": mapping.model,
316
- });
317
-
318
- try {
319
- const upstreamOpts = { ...opts, stream: true };
320
- const result = await callMapping(mapping, messages, upstreamOpts);
321
-
322
- if (!result.stream) {
323
- // Non-streaming fallback — send as single SSE chunk
324
- const chunk = {
325
- id: requestId,
326
- object: "chat.completion.chunk",
327
- created: Math.floor(Date.now() / 1000),
328
- model: result.data.model,
329
- choices: [
330
- {
331
- index: 0,
332
- delta: { content: result.data.choices?.[0]?.message?.content || "" },
333
- finish_reason: null,
334
- },
335
- ],
336
- };
337
- res.write(`data: ${JSON.stringify(chunk)}\n\n`);
338
- const done = {
339
- id: requestId,
340
- object: "chat.completion.chunk",
341
- created: Math.floor(Date.now() / 1000),
342
- model: result.data.model,
343
- choices: [{ index: 0, delta: {}, finish_reason: "stop" }],
344
- };
345
- res.write(`data: ${JSON.stringify(done)}\n\n`);
346
- res.write("data: [DONE]\n\n");
347
- res.end();
348
- return;
349
- }
350
-
351
- const upstreamResp = result.response;
352
- if (!upstreamResp.ok) {
353
- const errText = await upstreamResp.text();
354
- res.write(
355
- `data: ${JSON.stringify({
356
- id: requestId,
357
- object: "chat.completion.chunk",
358
- created: Math.floor(Date.now() / 1000),
359
- model: mapping.model,
360
- choices: [
361
- {
362
- index: 0,
363
- delta: { content: `Error: ${upstreamResp.status} ${errText.substring(0, 200)}` },
364
- finish_reason: "stop",
365
- },
366
- ],
367
- })}\n\n`
368
- );
369
- res.write("data: [DONE]\n\n");
370
- res.end();
371
- return;
372
- }
373
-
374
- if (!upstreamResp.body) {
375
- // No streaming body
376
- res.write("data: [DONE]\n\n");
377
- res.end();
378
- return;
379
- }
380
-
381
- const reader = upstreamResp.body.getReader();
382
- const decoder = new TextDecoder();
383
- let buffer = "";
384
- const isAnthropic = result.isAnthropic;
385
- const isOllama = result.isOllama;
386
-
387
- while (true) {
388
- const { done, value } = await reader.read();
389
- if (done) break;
390
-
391
- buffer += decoder.decode(value, { stream: true });
392
-
393
- const lines = buffer.split("\n");
394
- buffer = lines.pop() || "";
395
-
396
- for (const line of lines) {
397
- const trimmed = line.trim();
398
- if (!trimmed || trimmed.startsWith(":")) continue;
399
-
400
- if (trimmed.startsWith("data: ")) {
401
- const payload = trimmed.substring(6);
402
- if (payload === "[DONE]") {
403
- res.write("data: [DONE]\n\n");
404
- continue;
405
- }
406
-
407
- try {
408
- const parsed = JSON.parse(payload);
409
-
410
- // Normalize to OpenAI SSE format
411
- const chunk = {
412
- id: requestId,
413
- object: "chat.completion.chunk",
414
- created: Math.floor(Date.now() / 1000),
415
- model: parsed.model || mapping.model,
416
- choices: [],
417
- };
418
-
419
- // OpenAI-compatible format
420
- if (parsed.choices?.[0]?.delta) {
421
- chunk.choices = parsed.choices;
422
- } else if (parsed.choices?.[0]?.text) {
423
- chunk.choices = [
424
- {
425
- index: 0,
426
- delta: { content: parsed.choices[0].text },
427
- finish_reason: null,
428
- },
429
- ];
430
- }
431
- // Anthropic streaming
432
- else if (parsed.type === "content_block_delta" && parsed.delta?.text) {
433
- chunk.choices = [
434
- {
435
- index: 0,
436
- delta: { content: parsed.delta.text },
437
- finish_reason: null,
438
- },
439
- ];
440
- } else if (parsed.type === "message_stop") {
441
- chunk.choices = [{ index: 0, delta: {}, finish_reason: "stop" }];
442
- }
443
- // Ollama streaming
444
- else if (parsed.message?.content) {
445
- chunk.choices = [
446
- {
447
- index: 0,
448
- delta: { content: parsed.message.content },
449
- finish_reason: parsed.done ? "stop" : null,
450
- },
451
- ];
452
- } else {
453
- continue; // Skip unknown format chunks
454
- }
455
-
456
- res.write(`data: ${JSON.stringify(chunk)}\n\n`);
457
- } catch {
458
- // Non-JSON payload — skip
459
- }
460
- }
461
- }
462
- }
463
-
464
- // Ensure [DONE]
465
- res.write("data: [DONE]\n\n");
466
- res.end();
467
- } catch (err) {
468
- // Send error as SSE
469
- res.write(
470
- `data: ${JSON.stringify({
471
- id: requestId,
472
- object: "chat.completion.chunk",
473
- created: Math.floor(Date.now() / 1000),
474
- model: mapping.model,
475
- choices: [
476
- {
477
- index: 0,
478
- delta: { content: `Error: ${err.message}` },
479
- finish_reason: "stop",
480
- },
481
- ],
482
- })}\n\n`
483
- );
484
- res.write("data: [DONE]\n\n");
485
- res.end();
486
- }
487
- }
488
-
489
- // ============================================================
490
- // ENSEMBLE — Parallel multi-LLM execution
491
- // ============================================================
492
-
493
- /**
494
- * Run multiple providers in parallel and merge their responses.
495
- * Returns the best result based on confidence scoring.
496
- */
497
- async function callEnsemble(messages, opts, prompt) {
498
- const available = getAvailableProviders();
499
- const providers = Object.keys(available);
500
-
501
- // Pick top 3 providers by priority (lowest = best)
502
- const topProviders = providers.slice(0, 3);
503
- if (topProviders.length === 0) {
504
- throw new Error("No providers available for ensemble routing");
505
- }
506
-
507
- // Resolve a model for each provider
508
- const mappings = [];
509
- for (const providerId of topProviders) {
510
- const provider = available[providerId];
511
- if (!provider.models || provider.models.length === 0) continue;
512
- const modelName = provider.models[0];
513
- mappings.push({
514
- providerId,
515
- model: modelName,
516
- baseUrl: provider.baseUrl || "",
517
- apiKey: provider.apiKey || null,
518
- costPerK: provider.costPerK || { input: 0, output: 0 },
519
- type: provider.type || "api",
520
- });
521
- }
522
-
523
- if (mappings.length === 0) {
524
- throw new Error("No models available for ensemble routing");
525
- }
526
-
527
- // Run all in parallel — first successful response wins
528
- const results = await Promise.allSettled(
529
- mappings.map((m) => callMapping(m, messages, { ...opts, stream: false }))
530
- );
531
-
532
- // Collect successful results
533
- const successes = [];
534
- for (let i = 0; i < results.length; i++) {
535
- const r = results[i];
536
- if (r.status === "fulfilled" && !r.value.stream) {
537
- successes.push({
538
- mapping: mappings[i],
539
- data: r.value.data,
540
- });
541
- }
542
- }
543
-
544
- if (successes.length === 0) {
545
- // Collect error messages
546
- const errors = results
547
- .filter((r) => r.status === "rejected")
548
- .map((r) => r.reason?.message)
549
- .join("; ");
550
- throw new Error(`All ensemble providers failed: ${errors}`);
551
- }
552
-
553
- // Pick the first successful result (could upgrade to confidence voting)
554
- const best = successes[0];
555
-
556
- return {
557
- choices: best.data.choices,
558
- usage: best.data.usage,
559
- model: best.data.model || best.mapping.model,
560
- provider: best.mapping.providerId,
561
- ensemble_count: successes.length,
562
- };
563
- }
564
-
565
- // ============================================================
566
- // ROUTE RESOLUTION
567
- // ============================================================
568
-
569
- /**
570
- * Route a model name to the correct strategy and resolve the provider mapping.
571
- */
572
- function resolveRoute(modelName, prompt) {
573
- // Check for A3M special model names
574
- const strategy = MODEL_STRATEGIES[modelName];
575
-
576
- if (strategy === "cheapest") {
577
- const provider = findCheapestAvailableProvider();
578
- if (!provider) return null;
579
- return {
580
- strategy: "direct",
581
- mapping: {
582
- providerId: provider.id,
583
- model: provider.models[0] || "unknown",
584
- baseUrl: provider.baseUrl || "",
585
- apiKey: provider.apiKey || null,
586
- costPerK: provider.costPerK || { input: 0, output: 0 },
587
- type: provider.type || "api",
588
- },
589
- };
590
- }
591
-
592
- if (strategy === "fastest") {
593
- const provider = findFastestAvailableProvider();
594
- if (!provider) return null;
595
- return {
596
- strategy: "direct",
597
- mapping: {
598
- providerId: provider.id,
599
- model: provider.models[0] || "unknown",
600
- baseUrl: provider.baseUrl || "",
601
- apiKey: provider.apiKey || null,
602
- costPerK: provider.costPerK || { input: 0, output: 0 },
603
- type: provider.type || "api",
604
- },
605
- };
606
- }
607
-
608
- if (strategy === "ensemble") {
609
- return { strategy: "ensemble" };
610
- }
611
-
612
- // Default: use resolveModel (handles "auto", provider/model, OpenAI aliases)
613
- const mapping = resolveModel(modelName, prompt);
614
- if (!mapping) return null;
615
-
616
- return { strategy: "direct", mapping };
617
- }
618
-
619
- // ============================================================
620
- // EXPRESS APP
621
- // ============================================================
622
-
623
- const app = express();
624
-
625
- // CORS headers for all requests
626
- app.use((req, res, next) => {
627
- res.setHeader("Access-Control-Allow-Origin", "*");
628
- res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
629
- res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
630
- res.setHeader("X-A3M-Proxy", "true");
631
- res.setHeader("X-A3M-Version", "2.0.0");
632
- if (req.method === "OPTIONS") {
633
- res.status(204).end();
634
- return;
635
- }
636
- next();
637
- });
638
-
639
- // Raw body parsing for streaming detection
640
- app.use(express.json({ type: "application/json" }));
641
-
642
- // Rate limiting
643
- const rateLimiter = new RateLimiter();
644
- app.use(rateLimiter.middleware());
645
-
646
- // ============================================================
647
- // POST /v1/chat/completions
648
- // ============================================================
649
-
650
- app.post("/v1/chat/completions", async (req, res) => {
651
- const startTime = Date.now();
652
- const requestId = generateId();
653
-
654
- try {
655
- const request = req.body;
656
- if (!request?.messages || !Array.isArray(request.messages) || request.messages.length === 0) {
657
- res.status(400).json(openAIError(400, "messages is required and must be a non-empty array", "invalid_request_error"));
658
- return;
659
- }
660
-
661
- const modelName = request.model || "a3m-auto";
662
- const stream = !!request.stream;
663
- const messages = request.messages;
664
- const promptForRouting = messages.map((m) => m.content || "").join(" ");
665
-
666
- const opts = {
667
- max_tokens: request.max_tokens || 4096,
668
- temperature: request.temperature,
669
- top_p: request.top_p,
670
- stop: request.stop,
671
- };
672
-
673
- // Resolve route
674
- const route = resolveRoute(modelName, promptForRouting);
675
-
676
- if (!route) {
677
- res.status(503).json(
678
- openAIError(503, `No provider available for model "${modelName}". Check your API keys.`, "server_error")
679
- );
680
- return;
681
- }
682
-
683
- // ---- ENSEMBLE STRATEGY ----
684
- if (route.strategy === "ensemble") {
685
- if (stream) {
686
- // Streaming ensemble — fall back to non-streaming for simplicity,
687
- // then stream the result as a single SSE response
688
- try {
689
- const result = await callEnsemble(messages, opts, promptForRouting);
690
- // Send as SSE stream
691
- res.writeHead(200, {
692
- "Content-Type": "text/event-stream",
693
- "Cache-Control": "no-cache",
694
- Connection: "keep-alive",
695
- "Access-Control-Allow-Origin": "*",
696
- });
697
-
698
- const content = result.choices?.[0]?.message?.content || "";
699
- const chunk = {
700
- id: requestId,
701
- object: "chat.completion.chunk",
702
- created: Math.floor(Date.now() / 1000),
703
- model: result.model,
704
- choices: [
705
- { index: 0, delta: { content }, finish_reason: null },
706
- ],
707
- };
708
- res.write(`data: ${JSON.stringify(chunk)}\n\n`);
709
- res.write(
710
- `data: ${JSON.stringify({
711
- id: requestId,
712
- object: "chat.completion.chunk",
713
- created: Math.floor(Date.now() / 1000),
714
- model: result.model,
715
- choices: [{ index: 0, delta: {}, finish_reason: "stop" }],
716
- })}\n\n`
717
- );
718
- res.write("data: [DONE]\n\n");
719
- res.end();
720
- } catch (err) {
721
- res.status(502).json(openAIError(502, err.message, "upstream_error"));
722
- }
723
- } else {
724
- // Non-streaming ensemble
725
- try {
726
- const result = await callEnsemble(messages, opts, promptForRouting);
727
-
728
- const response = {
729
- id: requestId,
730
- object: "chat.completion",
731
- created: Math.floor(Date.now() / 1000),
732
- model: result.model,
733
- choices: result.choices,
734
- usage: result.usage,
735
- _a3m: {
736
- strategy: "ensemble",
737
- provider_count: result.ensemble_count,
738
- selected_provider: result.provider,
739
- },
740
- };
741
-
742
- const latencyMs = Date.now() - startTime;
743
- console.log(
744
- `[a3m-proxy] ${requestId} ensemble model=${modelName} providers=${result.ensemble_count} selected=${result.provider} latency=${latencyMs}ms`
745
- );
746
- res.json(response);
747
- } catch (err) {
748
- res.status(502).json(openAIError(502, err.message, "upstream_error"));
749
- }
750
- }
751
- return;
752
- }
753
-
754
- // ---- DIRECT STRATEGY (single provider) ----
755
- const mapping = route.mapping;
756
- const resolvedModel = mapping.model;
757
-
758
- if (stream) {
759
- // Streaming response
760
- res.setHeader("X-A3M-Provider", mapping.providerId);
761
- res.setHeader("X-A3M-Resolved", resolvedModel);
762
-
763
- await streamResponse(res, mapping, messages, opts, requestId, modelName);
764
-
765
- const latencyMs = Date.now() - startTime;
766
- console.log(
767
- `[a3m-proxy] ${requestId} stream model=${modelName}->${mapping.providerId}/${resolvedModel} latency=${latencyMs}ms`
768
- );
769
- } else {
770
- // Non-streaming response
771
- try {
772
- const result = await callMapping(mapping, messages, { ...opts, stream: false });
773
-
774
- if (result.stream) {
775
- // Shouldn't happen, but handle gracefully
776
- res.status(502).json(openAIError(502, "Unexpected streaming response", "upstream_error"));
777
- return;
778
- }
779
-
780
- const data = result.data;
781
-
782
- const response = {
783
- id: requestId,
784
- object: "chat.completion",
785
- created: Math.floor(Date.now() / 1000),
786
- model: data.model || resolvedModel,
787
- choices: data.choices || [
788
- {
789
- index: 0,
790
- message: { role: "assistant", content: data.content || "" },
791
- finish_reason: data.finish_reason || "stop",
792
- },
793
- ],
794
- usage: data.usage || {
795
- prompt_tokens: 0,
796
- completion_tokens: 0,
797
- total_tokens: 0,
798
- },
799
- _a3m: {
800
- strategy: "direct",
801
- provider: mapping.providerId,
802
- resolved_model: resolvedModel,
803
- },
804
- };
805
-
806
- const latencyMs = Date.now() - startTime;
807
- console.log(
808
- `[a3m-proxy] ${requestId} model=${modelName}->${mapping.providerId}/${resolvedModel} latency=${latencyMs}ms tokens=${response.usage.total_tokens}`
809
- );
810
-
811
- // Include provider info in headers
812
- res.setHeader("X-A3M-Provider", mapping.providerId);
813
- res.setHeader("X-A3M-Resolved", resolvedModel);
814
- res.json(response);
815
- } catch (err) {
816
- const latencyMs = Date.now() - startTime;
817
- console.error(
818
- `[a3m-proxy] ${requestId} ERROR model=${modelName}->${mapping.providerId}/${resolvedModel} latency=${latencyMs}ms error=${err.message}`
819
- );
820
- res.status(502).json(openAIError(502, `Upstream error: ${err.message}`, "upstream_error"));
821
- }
822
- }
823
- } catch (err) {
824
- console.error(`[a3m-proxy] ${requestId} UNHANDLED: ${err.message}`);
825
- res.status(500).json(openAIError(500, err.message));
826
- }
827
- });
828
-
829
- // ============================================================
830
- // GET /v1/models — List available models
831
- // ============================================================
832
-
833
- app.get("/v1/models", (_req, res) => {
834
- const models = listAvailableModels();
835
-
836
- // Add A3M strategy models
837
- const a3mModels = [
838
- {
839
- id: "a3m-auto",
840
- object: "model",
841
- created: Math.floor(Date.now() / 1000),
842
- owned_by: "a3m-router",
843
- description: "Intelligent routing — selects best model for your query",
844
- },
845
- {
846
- id: "a3m-cheapest",
847
- object: "model",
848
- created: Math.floor(Date.now() / 1000),
849
- owned_by: "a3m-router",
850
- description: "Cheapest available provider",
851
- },
852
- {
853
- id: "a3m-fastest",
854
- object: "model",
855
- created: Math.floor(Date.now() / 1000),
856
- owned_by: "a3m-router",
857
- description: "Fastest available provider",
858
- },
859
- {
860
- id: "a3m-ensemble",
861
- object: "model",
862
- created: Math.floor(Date.now() / 1000),
863
- owned_by: "a3m-router",
864
- description: "Parallel multi-LLM execution with merged results",
865
- },
866
- ];
867
-
868
- // Add any A3M strategy models not already in the list
869
- const existingIds = new Set(models.map((m) => m.id));
870
- for (const m of a3mModels) {
871
- if (!existingIds.has(m.id)) {
872
- models.push(m);
873
- }
874
- }
875
-
876
- res.json({ object: "list", data: models });
877
- });
878
-
879
- // ============================================================
880
- // GET /health — Health check
881
- // ============================================================
882
-
883
- app.get("/health", (_req, res) => {
884
- const available = getAvailableProviders();
885
- const providerCount = Object.keys(available).length;
886
-
887
- res.json({
888
- status: "ok",
889
- version: "2.0.0",
890
- proxy_type: "express",
891
- providers_available: providerCount,
892
- providers: Object.keys(available),
893
- model_strategies: Object.keys(MODEL_STRATEGIES),
894
- uptime_seconds: process.uptime(),
895
- });
896
- });
897
-
898
- // ============================================================
899
- // Root — Welcome
900
- // ============================================================
901
-
902
- app.get("/", (_req, res) => {
903
- res.json({
904
- name: "A3M Router Proxy",
905
- version: "2.0.0",
906
- description: "OpenAI-compatible API proxy with intelligent LLM routing",
907
- endpoints: {
908
- "POST /v1/chat/completions": "OpenAI chat completions",
909
- "GET /v1/models": "List available models",
910
- "GET /health": "Health check",
911
- },
912
- model_strategies: {
913
- "a3m-auto": "Intelligent routing — best model for your query",
914
- "a3m-cheapest": "Cheapest available provider",
915
- "a3m-fastest": "Fastest available provider",
916
- "a3m-ensemble": "Parallel multi-LLM execution with merged results",
917
- },
918
- usage: {
919
- curl: `curl http://localhost:${PORT}/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"a3m-auto","messages":[{"role":"user","content":"Hello"}]}'`,
920
- openai_sdk: `new OpenAI({ baseURL: 'http://localhost:${PORT}/v1' })`,
921
- },
922
- });
923
- });
924
-
925
- // ============================================================
926
- // 404 handler
927
- // ============================================================
928
-
929
- app.use((_req, res) => {
930
- res.status(404).json(openAIError(404, "Not found. Available endpoints: GET /, GET /v1/models, GET /health, POST /v1/chat/completions", "not_found"));
931
- });
932
-
933
- // ============================================================
934
- // START
935
- // ============================================================
936
-
937
- function start() {
938
- app.listen(PORT, () => {
939
- console.log("");
940
- console.log(" A3M Router Proxy Server (Express)");
941
- console.log(" ---------------------------------------");
942
- console.log(` Listening: http://localhost:${PORT}`);
943
- console.log(" Endpoints:");
944
- console.log(" POST /v1/chat/completions (OpenAI chat)");
945
- console.log(" GET /v1/models (List models)");
946
- console.log(" GET /health (Health check)");
947
- console.log("");
948
- console.log(" Model strategies:");
949
- console.log(" a3m-auto Intelligent routing (default)");
950
- console.log(" a3m-cheapest Cheapest provider");
951
- console.log(" a3m-fastest Fastest provider");
952
- console.log(" a3m-ensemble Parallel multi-LLM execution");
953
- console.log("");
954
- console.log(" Example:");
955
- console.log(` curl http://localhost:${PORT}/v1/chat/completions \\`);
956
- console.log(' -H "Content-Type: application/json" \\');
957
- console.log(' -d \'{"model":"a3m-auto","messages":[{"role":"user","content":"Hello"}]}\'');
958
- console.log("");
959
- console.log(" OpenAI SDK:");
960
- console.log(` new OpenAI({ baseURL: 'http://localhost:${PORT}/v1' })`);
961
- console.log("");
962
- });
963
- }
964
-
965
- // Allow running directly or importing
966
- if (require.main === module) {
967
- start();
968
- }
969
-
970
- module.exports = { app, start };