adaptive-memory-multi-model-router 2.14.49 → 2.14.52

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/.dockerignore +82 -0
  2. package/.env.example +303 -0
  3. package/.github/DISCUSSIONS_WELCOME.md +27 -0
  4. package/.github/DISCUSSION_TEMPLATE.yml +5 -0
  5. package/.github/FUNDING.yml +2 -0
  6. package/.github/ISSUE_TEMPLATE/bug_report.md +94 -0
  7. package/.github/ISSUE_TEMPLATE/config.yml +17 -0
  8. package/.github/ISSUE_TEMPLATE/feature_request.md +71 -0
  9. package/.github/PULL_REQUEST_TEMPLATE.md +71 -0
  10. package/.github/dependabot.yml +9 -0
  11. package/.github/workflows/ci.yml +263 -0
  12. package/.github/workflows/codeql.yml +38 -0
  13. package/.github/workflows/npm-publish.yml +20 -0
  14. package/.github/workflows/pages.yml +37 -0
  15. package/.github/workflows/stale.yml +54 -0
  16. package/.publish-tick +1 -0
  17. package/.well-known/ai-plugin.json +16 -0
  18. package/AGENT_COUNCIL_FINDINGS.md +142 -0
  19. package/ARCHITECTURE.md +346 -0
  20. package/AUDIT_REPORT.md +28 -0
  21. package/CODE_OF_CONDUCT.md +128 -0
  22. package/CONTRIBUTING.md +50 -0
  23. package/CONTRIBUTORS.md +20 -0
  24. package/Dockerfile +53 -0
  25. package/Dockerfile.proxy +33 -0
  26. package/HEALTH_REPORT.md +118 -0
  27. package/IMPROVEMENT_PLAN.md +107 -0
  28. package/LANDING.md +43 -0
  29. package/LAUNCH-PAIN-DRIVEN.md +339 -0
  30. package/LAUNCH.md +337 -0
  31. package/LAUNCH_CHECKLIST.md +141 -0
  32. package/LAUNCH_SNAPSHOT.md +260 -0
  33. package/MANIFESTO.md +41 -0
  34. package/POPULARITY_BOOSTERS.md +285 -0
  35. package/PR_STATUS_REPORT.md +148 -0
  36. package/README.md +25 -14
  37. package/REDESIGN.md +95 -0
  38. package/RUNKIT.md +83 -0
  39. package/SECURITY.md +29 -0
  40. package/SUBMISSIONS.md +43 -0
  41. package/_schema.html +53 -0
  42. package/ai-plugin.json +16 -0
  43. package/articles/AI_AGENT_LLM_ROUTING.md +150 -0
  44. package/articles/CHINESE_DIRECTORIES.md +100 -0
  45. package/articles/CHINESE_SUBMISSIONS_READY.md +322 -0
  46. package/articles/COMPETITOR_ALERTS.md +31 -0
  47. package/articles/COMPLETE_POSTING_DIRECTORY.md +147 -0
  48. package/articles/CONTENT_STRUCTURE.md +292 -0
  49. package/articles/DEVTO_COST_GUIDE.md +473 -0
  50. package/articles/DEVTO_FINAL.md +416 -0
  51. package/articles/DEVTO_MULTI_PROVIDER.md +542 -0
  52. package/articles/DEVTO_READY.md +255 -0
  53. package/articles/DEVTO_V2_ANNOUNCEMENT.md +160 -0
  54. package/articles/DEVTO_VIRAL_GROWTH.md +280 -0
  55. package/articles/FRESH_devto.md +460 -0
  56. package/articles/FRESH_devto_2026_05.md +73 -0
  57. package/articles/FRESH_hackernews.md +14 -0
  58. package/articles/FRESH_reddit_ml.md +90 -0
  59. package/articles/FRESH_reddit_node.md +198 -0
  60. package/articles/FRESH_reddit_sideproject.md +72 -0
  61. package/articles/FRESH_reddit_webdev.md +130 -0
  62. package/articles/FROM_ZERO_TO_10K.md +107 -0
  63. package/articles/HN_10X_BETTER.md +430 -0
  64. package/articles/HN_ACCOUNT_GUIDE.md +21 -0
  65. package/articles/HN_CHINESE_STYLE.md +308 -0
  66. package/articles/HN_FINAL.md +148 -0
  67. package/articles/HN_POSTED_VERSION.md +56 -0
  68. package/articles/HN_POST_READY.md +137 -0
  69. package/articles/HN_RESEARCH.md +364 -0
  70. package/articles/HN_SHOW_routerarena.md +17 -0
  71. package/articles/HN_TIMING_GUIDE.md +52 -0
  72. package/articles/INDIEHACKERS_POST.md +52 -0
  73. package/articles/INDIEHACKERS_READY.md +120 -0
  74. package/articles/LLM_BENCHMARK_DEEP_DIVE.md +153 -0
  75. package/articles/MASTER_POSTING_DIRECTORY.md +189 -0
  76. package/articles/NEWSLETTER_SEND_NOW.md +259 -0
  77. package/articles/NEWSLETTER_SUBMISSIONS.md +112 -0
  78. package/articles/PAIN-DRIVEN-devto-v2.md +308 -0
  79. package/articles/PAIN-DRIVEN-devto-v3.md +268 -0
  80. package/articles/PAIN-DRIVEN-devto.md +242 -0
  81. package/articles/PAIN-DRIVEN-hackernews-v2.md +138 -0
  82. package/articles/PAIN-DRIVEN-hackernews-v3.md +151 -0
  83. package/articles/PAIN-DRIVEN-hackernews.md +131 -0
  84. package/articles/PAIN-DRIVEN-reddit-v2.md +301 -0
  85. package/articles/PAIN-DRIVEN-reddit-v3.md +236 -0
  86. package/articles/PAIN-DRIVEN-reddit.md +218 -0
  87. package/articles/PAIN-DRIVEN-twitter-v2.md +110 -0
  88. package/articles/PAIN-DRIVEN-twitter-v3.md +121 -0
  89. package/articles/PAIN-DRIVEN-twitter.md +120 -0
  90. package/articles/PORTKEY_VS_A3M.md +147 -0
  91. package/articles/POSTING_KIT_2026_05.md +67 -0
  92. package/articles/PRESS_KIT_routerarena.md +77 -0
  93. package/articles/PRODUCTHUNT_LISTING.md +48 -0
  94. package/articles/PRODUCTHUNT_READY.md +106 -0
  95. package/articles/PR_PLAN_vault.md +125 -0
  96. package/articles/REDDIT_FINAL.md +232 -0
  97. package/articles/REDDIT_POST.md +67 -0
  98. package/articles/REDDIT_SUBMISSION_READY.md +348 -0
  99. package/articles/ROUTERARENA_9677.md +78 -0
  100. package/articles/ROUTERARENA_LEADER.md +45 -0
  101. package/articles/SHOW_HN_FINAL.md +29 -0
  102. package/articles/TWEETS_10K_DOWNLOADS.md +47 -0
  103. package/articles/TWEETS_BENCHMARK_FIRST.md +46 -0
  104. package/articles/TWEETS_MCP_PLAY.md +51 -0
  105. package/articles/TWEETS_SEQUENTIAL_BROKEN.md +49 -0
  106. package/articles/TWEETS_WHY_BUILD.md +54 -0
  107. package/articles/TWEETS_routerarena_leader.md +53 -0
  108. package/articles/TWEET_STORM_READY.md +165 -0
  109. package/articles/TWITTER_FINAL.md +167 -0
  110. package/articles/WHY_10X_BETTER.md +261 -0
  111. package/articles/WHY_CHINESE_STYLE_BETTER.md +323 -0
  112. package/articles/ai-discoverability-llm-routing.md +210 -0
  113. package/articles/devto-llm-routing.md +138 -0
  114. package/articles/hackernews-show-hn.md +54 -0
  115. package/articles/hashnode-llm-cost-optimization.md +125 -0
  116. package/articles/hn_show_2026_05.md +11 -0
  117. package/articles/medium-building-llm-router.md +205 -0
  118. package/articles/reddit-ml.md +76 -0
  119. package/articles/twitter-thread-cost-savings.md +50 -0
  120. package/articles/youtube-tutorial-script.md +262 -0
  121. package/assets/a3m_3blue1brown.mp4 +0 -0
  122. package/assets/banner.svg +109 -0
  123. package/assets/chart-cost-v2.svg +91 -0
  124. package/assets/chart-cost-v3.svg +143 -0
  125. package/assets/chart-features-v2.svg +132 -0
  126. package/assets/chart-features-v3.svg +211 -0
  127. package/assets/chart-growth-v2.svg +122 -0
  128. package/assets/chart-growth-v3.svg +189 -0
  129. package/assets/cost-comparison.svg +134 -0
  130. package/assets/cost-simple.svg +64 -0
  131. package/assets/demo-hn.gif +0 -0
  132. package/assets/feature-matrix.svg +136 -0
  133. package/assets/growth-chart-animated.svg +76 -0
  134. package/assets/growth-chart.svg +82 -0
  135. package/assets/growth-simple.svg +69 -0
  136. package/assets/hero-diagram.svg +81 -0
  137. package/assets/logo-new.svg +21 -0
  138. package/assets/logo.svg +68 -0
  139. package/assets/provider-comparison.svg +121 -0
  140. package/assets/social-preview-new.svg +100 -0
  141. package/assets/social-preview.svg +194 -0
  142. package/assets/social-v2.svg +130 -0
  143. package/assets/social-v3.svg +212 -0
  144. package/benchmark-provider-results.json +245 -0
  145. package/benchmark-results.json +54 -0
  146. package/council-votes/architecture-vote.md +121 -0
  147. package/council-votes/coverage-vote.md +93 -0
  148. package/data/adaptive-benchmark.json +92 -0
  149. package/data/benchmark-results.json +47 -0
  150. package/data/labeled-benchmark.json +88 -0
  151. package/demo/3blue1brown_video.py +285 -0
  152. package/demo/3blue1brown_video_v2.py +310 -0
  153. package/demo/IMPROVED_PROMPTS.md +229 -0
  154. package/demo/VEO3_PROMPTS.md +269 -0
  155. package/demo/VIDEO_PRODUCTION_GUIDE.md +333 -0
  156. package/demo/a3m_3blue1brown.mp4 +0 -0
  157. package/demo/asciinema-demo.sh +195 -0
  158. package/demo/demo-hn.tape +74 -0
  159. package/demo/demo-script.md +53 -0
  160. package/demo/demo-script.sh +62 -0
  161. package/demo/demo.svg +75 -0
  162. package/demo/frame1_ai_data_center.png +0 -0
  163. package/demo/frame1_sunset_video.mp4 +0 -0
  164. package/demo/frame2_cost_comparison.png +0 -0
  165. package/demo/frame2_cost_comparison_fallback.png +0 -0
  166. package/demo/frame3_parallel_execution.png +0 -0
  167. package/demo/frame3_parallel_execution_fallback.png +0 -0
  168. package/demo/frame4_providers.png +0 -0
  169. package/demo/frame4_providers_fallback.png +0 -0
  170. package/demo/frame5_endcard.png +0 -0
  171. package/demo/frame5_endcard_fallback.png +0 -0
  172. package/demo/new_frame1_hook.png +0 -0
  173. package/demo/new_frame2_proof.png +0 -0
  174. package/demo/new_frame3_wow.png +0 -0
  175. package/demo/new_frame4_social.png +0 -0
  176. package/demo/new_frame5_cta.png +0 -0
  177. package/demo/package.json +13 -0
  178. package/demo/product-video-final.mp4 +0 -0
  179. package/demo/product-video-hype-v1.mp4 +0 -0
  180. package/demo/product-video-v1.mp4 +0 -0
  181. package/demo/public/index.html +762 -0
  182. package/demo/recording.cast +55 -0
  183. package/demo/server.js +405 -0
  184. package/demo-new.tape +71 -0
  185. package/demo-real.sh +198 -0
  186. package/demo-simple.tape +205 -0
  187. package/demo.html +520 -0
  188. package/demo.sh +85 -0
  189. package/demo.tape +259 -0
  190. package/dist/analytics/costAnalytics.d.ts.map +1 -0
  191. package/dist/analytics/costAnalytics.js.map +1 -0
  192. package/dist/benchmark/comprehensive.js.map +1 -0
  193. package/dist/benchmark/reproducible.d.ts.map +1 -0
  194. package/dist/benchmark/reproducible.js.map +1 -0
  195. package/dist/cache/prefixCache.d.ts.map +1 -0
  196. package/dist/cache/prefixCache.js.map +1 -0
  197. package/dist/cache/responseCache.d.ts.map +1 -0
  198. package/dist/cache/responseCache.js.map +1 -0
  199. package/dist/cache/semanticCache.d.ts.map +1 -0
  200. package/dist/cache/semanticCache.js.map +1 -0
  201. package/dist/cli/setupWizard.d.ts.map +1 -0
  202. package/dist/cli/setupWizard.js.map +1 -0
  203. package/dist/cost/budgetEnforcer.d.ts.map +1 -0
  204. package/dist/cost/budgetEnforcer.js.map +1 -0
  205. package/dist/cost/costTracker.d.ts.map +1 -0
  206. package/dist/cost/costTracker.js.map +1 -0
  207. package/dist/ensemble/multiRoundDialog.js.map +1 -0
  208. package/dist/ensemble/shapleyValue.js.map +1 -0
  209. package/dist/integrations/langchainAdapter.d.ts.map +1 -0
  210. package/dist/integrations/langchainAdapter.js.map +1 -0
  211. package/dist/integrations/oauth.d.ts.map +1 -0
  212. package/dist/integrations/oauth.js.map +1 -0
  213. package/dist/integrations/scienceAdapter.js.map +1 -0
  214. package/dist/memory/autoFetch.d.ts.map +1 -0
  215. package/dist/memory/autoFetch.js.map +1 -0
  216. package/dist/memory/episodicMemory.d.ts.map +1 -0
  217. package/dist/memory/episodicMemory.js.map +1 -0
  218. package/dist/memory/hybridMemory.js.map +1 -0
  219. package/dist/memory/memoryTree.d.ts.map +1 -0
  220. package/dist/memory/memoryTree.js.map +1 -0
  221. package/dist/memory/obsidianVault.d.ts.map +1 -0
  222. package/dist/memory/obsidianVault.js.map +1 -0
  223. package/dist/memory/reasoningBank.js.map +1 -0
  224. package/dist/observability/changeWatch.d.ts.map +1 -0
  225. package/dist/observability/changeWatch.js.map +1 -0
  226. package/dist/observability/fatigueDetector.d.ts.map +1 -0
  227. package/dist/observability/fatigueDetector.js.map +1 -0
  228. package/dist/observability/index.d.ts.map +1 -0
  229. package/dist/observability/index.js.map +1 -0
  230. package/dist/observability/metrics.d.ts.map +1 -0
  231. package/dist/observability/metrics.js.map +1 -0
  232. package/dist/observability/middleware.d.ts.map +1 -0
  233. package/dist/observability/middleware.js.map +1 -0
  234. package/dist/observability/tracer.d.ts.map +1 -0
  235. package/dist/observability/tracer.js.map +1 -0
  236. package/dist/observability/types.d.ts.map +1 -0
  237. package/dist/observability/types.js.map +1 -0
  238. package/dist/orchestration/haloOrchestrator.d.ts.map +1 -0
  239. package/dist/orchestration/haloOrchestrator.js.map +1 -0
  240. package/dist/orchestration/mctsWorkflow.d.ts.map +1 -0
  241. package/dist/orchestration/mctsWorkflow.js.map +1 -0
  242. package/dist/providers/localProvider.d.ts.map +1 -0
  243. package/dist/providers/localProvider.js.map +1 -0
  244. package/dist/providers/providerConfig.d.ts.map +1 -0
  245. package/dist/providers/providerConfig.js.map +1 -0
  246. package/dist/providers/registry.d.ts.map +1 -0
  247. package/dist/providers/registry.js.map +1 -0
  248. package/dist/routing/advancedRouter.d.ts.map +1 -0
  249. package/dist/routing/advancedRouter.js +1 -1
  250. package/dist/routing/advancedRouter.js.map +1 -0
  251. package/dist/routing/crossModelValidation.d.ts.map +1 -0
  252. package/dist/routing/crossModelValidation.js.map +1 -0
  253. package/dist/routing/providerHealth.d.ts.map +1 -0
  254. package/dist/routing/providerHealth.js.map +1 -0
  255. package/dist/routing/providerRetry.d.ts.map +1 -0
  256. package/dist/routing/providerRetry.js.map +1 -0
  257. package/dist/scripts/banner.js +29 -0
  258. package/dist/security/guardrails.d.ts.map +1 -0
  259. package/dist/security/guardrails.js.map +1 -0
  260. package/dist/server/dashboard.d.ts.map +1 -0
  261. package/dist/server/dashboard.js.map +1 -0
  262. package/dist/server/modelMapper.d.ts.map +1 -0
  263. package/dist/server/modelMapper.js.map +1 -0
  264. package/dist/server/proxyServer.d.ts.map +1 -0
  265. package/dist/server/proxyServer.js.map +1 -0
  266. package/dist/skills/__tests__/skill_manager.test.d.ts +2 -0
  267. package/dist/skills/__tests__/skill_manager.test.d.ts.map +1 -0
  268. package/dist/skills/__tests__/skill_manager.test.js +268 -0
  269. package/dist/skills/__tests__/skill_manager.test.js.map +1 -0
  270. package/dist/tools/tmlpdTools.d.ts.map +1 -0
  271. package/dist/tools/tmlpdTools.js.map +1 -0
  272. package/dist/tui/dashboard.d.ts.map +1 -0
  273. package/dist/tui/dashboard.js.map +1 -0
  274. package/dist/tui/index.d.ts.map +1 -0
  275. package/dist/tui/index.js.map +1 -0
  276. package/dist/utils/batchProcessor.d.ts.map +1 -0
  277. package/dist/utils/batchProcessor.js.map +1 -0
  278. package/dist/utils/compression.d.ts.map +1 -0
  279. package/dist/utils/compression.js.map +1 -0
  280. package/dist/utils/costUtils.d.ts.map +1 -0
  281. package/dist/utils/costUtils.js.map +1 -0
  282. package/dist/utils/reliability.d.ts.map +1 -0
  283. package/dist/utils/reliability.js.map +1 -0
  284. package/dist/utils/sorting.d.ts.map +1 -0
  285. package/dist/utils/sorting.js.map +1 -0
  286. package/dist/utils/speculativeDecoding.d.ts.map +1 -0
  287. package/dist/utils/speculativeDecoding.js.map +1 -0
  288. package/dist/utils/tokenUtils.d.ts.map +1 -0
  289. package/dist/utils/tokenUtils.js.map +1 -0
  290. package/docs/.nojekyll +0 -0
  291. package/docs/ANALYSIS_PRINCIPLES.md +162 -0
  292. package/docs/API.md +855 -0
  293. package/docs/ARCHITECTURAL-IMPROVEMENTS-2025.md +1391 -0
  294. package/docs/ARCHITECTURAL-IMPROVEMENTS-REVISED-2025.md +1051 -0
  295. package/docs/BENCHMARK.md +170 -0
  296. package/docs/CHINESE_PROVIDER_RELIABILITY.md +37 -0
  297. package/docs/CITATIONS.md +74 -0
  298. package/docs/CLAIMS_AND_EVIDENCE.md +58 -0
  299. package/docs/CONFIGURATION.md +476 -0
  300. package/docs/COUNCIL_DECISION.json +816 -0
  301. package/docs/COUNCIL_SUMMARY.md +319 -0
  302. package/docs/COUNCIL_V2.2_DECISION.md +416 -0
  303. package/docs/ENGINEERING_SPEC.md +55 -0
  304. package/docs/FACTORY_RESET.md +34 -0
  305. package/docs/GEO.md +66 -0
  306. package/docs/GEO_OPTIMIZATION.md +30 -0
  307. package/docs/GEO_ROOT_CAUSE.md +136 -0
  308. package/docs/GEO_STATUS.md +85 -0
  309. package/docs/GEO_TEST_RESULTS.md +176 -0
  310. package/docs/HN_CHECKLIST.md +38 -0
  311. package/docs/HN_FOUNDER_COMMENT.md +17 -0
  312. package/docs/HN_SUBMISSION_FINAL.md +180 -0
  313. package/docs/HN_SUBMISSION_V3.md +56 -0
  314. package/docs/IMPROVEMENT_ROADMAP.md +515 -0
  315. package/docs/INTEGRATIONS.md +420 -0
  316. package/docs/LANGCHAIN_INTEGRATION.md +147 -0
  317. package/docs/LLM_COUNCIL_DECISION.md +508 -0
  318. package/docs/MIDDLEWARE_CHAIN.md +35 -0
  319. package/docs/PROMO_CHECKLIST.md +200 -0
  320. package/docs/QUICKSTART.md +271 -0
  321. package/docs/QUICK_START.md +43 -0
  322. package/docs/QUICK_START_VISIBILITY.md +782 -0
  323. package/docs/REDDIT_GAP_ANALYSIS.md +299 -0
  324. package/docs/RELEASE_CHECKLIST.md +32 -0
  325. package/docs/REPRODUCIBILITY.md +63 -0
  326. package/docs/RESEARCH_BACKED_IMPROVEMENTS.md +1180 -0
  327. package/docs/ROUTING_RUBRIC.md +197 -0
  328. package/docs/SEO_AUDIT.md +186 -0
  329. package/docs/SOCIAL_LISTENING.md +219 -0
  330. package/docs/TMLPD_QNA.md +751 -0
  331. package/docs/TMLPD_V2.1_COMPLETE.md +763 -0
  332. package/docs/TMLPD_V2.2_RESEARCH_ROADMAP.md +754 -0
  333. package/docs/UPDATE_TOPICS.md +15 -0
  334. package/docs/USE_CASES.md +59 -0
  335. package/docs/V2.2_IMPLEMENTATION_COMPLETE.md +446 -0
  336. package/docs/V2_IMPLEMENTATION_GUIDE.md +388 -0
  337. package/docs/VERCEL_AI_SDK.md +209 -0
  338. package/docs/VISIBILITY_ADOPTION_PLAN.md +1005 -0
  339. package/docs/_config.yml +49 -0
  340. package/docs/ai-plugin.json +16 -0
  341. package/docs/api.html +513 -0
  342. package/docs/architecture-diagram.md +40 -0
  343. package/docs/benchmark-chart.png +0 -0
  344. package/docs/benchmark.html +387 -0
  345. package/docs/blog/routerarena-9677.html +92 -0
  346. package/docs/blog/routerarena-number-one.html +73 -0
  347. package/docs/cli-cheatsheet.md +339 -0
  348. package/docs/compare.md +109 -0
  349. package/docs/comparison-litellm.md +88 -0
  350. package/docs/comparison.md +108 -0
  351. package/docs/cost-chart-ascii.md +42 -0
  352. package/docs/cost-comparison-chart.svg +88 -0
  353. package/docs/curl-examples.md +247 -0
  354. package/docs/demo-auto.html +264 -0
  355. package/docs/demo.html +416 -0
  356. package/docs/geo/GENERATIVE_ENGINE_OPTIMIZATION.md +232 -0
  357. package/docs/index.html +507 -0
  358. package/docs/launch-content/LAUNCH_EXECUTION_CHECKLIST.md +421 -0
  359. package/docs/launch-content/README.md +457 -0
  360. package/docs/launch-content/assets/cost_comparison_100_tasks.png +0 -0
  361. package/docs/launch-content/assets/cumulative_savings.png +0 -0
  362. package/docs/launch-content/assets/parallel_speedup.png +0 -0
  363. package/docs/launch-content/assets/provider_pricing_comparison.png +0 -0
  364. package/docs/launch-content/assets/task_breakdown_comparison.png +0 -0
  365. package/docs/launch-content/generate_charts.py +313 -0
  366. package/docs/launch-content/hn_show_post.md +139 -0
  367. package/docs/launch-content/partner_outreach_templates.md +745 -0
  368. package/docs/launch-content/reddit_posts.md +467 -0
  369. package/docs/launch-content/twitter_thread.txt +460 -0
  370. package/{llms.txt.bak → docs/llms.txt} +6 -6
  371. package/docs/npm-downloads-chart.svg +43 -0
  372. package/docs/openapi.json +139 -0
  373. package/docs/openapi.yaml +1318 -0
  374. package/docs/quick-start.html +366 -0
  375. package/docs/robots.txt +52 -0
  376. package/docs/sitemap.xml +57 -0
  377. package/docs/styles.css +682 -0
  378. package/docs/well-known/ai-plugin.json +16 -0
  379. package/docs/wellknown/ai-plugin.json +16 -0
  380. package/docs-site/assets/og-banner.svg +194 -0
  381. package/docs-site/index.html +632 -0
  382. package/eval/README.md +46 -0
  383. package/eval/baselines/main.json +12 -0
  384. package/eval/benchmark_dataset.jsonl +16 -0
  385. package/eval/check_golden_routes.js +64 -0
  386. package/eval/datasets/catalog.json +33 -0
  387. package/eval/datasets/slices/cn_provider_reliability_v1.jsonl +3 -0
  388. package/eval/datasets/slices/cost_pressure_v1.jsonl +3 -0
  389. package/eval/datasets/slices/safety_guardrails_v1.jsonl +3 -0
  390. package/eval/evals.json +199 -0
  391. package/eval/fault_injection_thresholds.json +3 -0
  392. package/eval/generate_report.js +128 -0
  393. package/eval/golden_routes.json +114 -0
  394. package/eval/lib/experiment_registry.js +24 -0
  395. package/eval/run_eval.js +197 -0
  396. package/eval/run_fault_injection.js +201 -0
  397. package/eval/run_shadow_eval.js +85 -0
  398. package/eval/thresholds.json +9 -0
  399. package/examples/QUICKSTART.md +183 -0
  400. package/examples/README.md +61 -0
  401. package/examples/a3m-sdk.js +124 -0
  402. package/examples/basic-route.js +54 -0
  403. package/examples/chat-loop.js +202 -0
  404. package/examples/classify-then-route.js +102 -0
  405. package/examples/cost-compare.js +120 -0
  406. package/examples/ensemble.js +160 -0
  407. package/examples/whatsapp-telegram-bridge-demo.js +302 -0
  408. package/examples/whatsapp-telegram-bridge.js +269 -0
  409. package/hf-space/README.md +23 -0
  410. package/hf-space/app.py +240 -0
  411. package/hf-space/requirements.txt +1 -0
  412. package/huggingface_space/README.md +35 -0
  413. package/huggingface_space/app.py +126 -0
  414. package/huggingface_space/create_space.py +208 -0
  415. package/huggingface_space/requirements.txt +1 -0
  416. package/index.html +1 -1
  417. package/mcp-server/README.md +188 -0
  418. package/mcp-server/package.json +29 -0
  419. package/mcp-server/src/index.ts +744 -0
  420. package/mcp-server/tsconfig.json +19 -0
  421. package/openclaw-alexa-bridge/ALL_REMAINING_FIXES_PLAN.md +313 -0
  422. package/openclaw-alexa-bridge/REMAINING_FIXES_SUMMARY.md +277 -0
  423. package/openclaw-alexa-bridge/src/alexa_handler_no_tmlpd.js +1234 -0
  424. package/openclaw-alexa-bridge/test_fixes.js +77 -0
  425. package/package.json +76 -272
  426. package/playground/README.md +51 -0
  427. package/playground/codesandbox.json +12 -0
  428. package/playground/index.js +39 -0
  429. package/proxy/README.md +227 -0
  430. package/proxy/package-lock.json +831 -0
  431. package/proxy/package.json +17 -0
  432. package/proxy/rate-limit.js +145 -0
  433. package/proxy/rate-limit.test.js +311 -0
  434. package/proxy/server.js +970 -0
  435. package/python/README.md +102 -0
  436. package/python/a3m/__init__.py +6 -0
  437. package/python/a3m/client.py +190 -0
  438. package/python/a3m/models.py +40 -0
  439. package/python/a3m/sync_client.py +61 -0
  440. package/python/examples.py +53 -0
  441. package/python/integrations.py +330 -0
  442. package/python/pyproject.toml +23 -0
  443. package/python/setup.py +28 -0
  444. package/python/tmlpd.py +369 -0
  445. package/qna/REDDIT_GAP_ANALYSIS.md +299 -0
  446. package/qna/TMLPD_QNA.md +751 -0
  447. package/research/FINDING_001_safety.md +28 -0
  448. package/research/FINDING_002_error_diversity.md +32 -0
  449. package/research/FINDING_003_confidence_weighted_voting.md +32 -0
  450. package/research/FINDING_004_cross_model_semantic_detection.md +37 -0
  451. package/research/FINDING_005_knowledge_gap_orthogonality.md +34 -0
  452. package/research/HALLUCINATION_RESEARCH.md +27 -0
  453. package/research/ensemble-voting.md +324 -0
  454. package/research/loss-functions.md +545 -0
  455. package/research-log.md +49 -0
  456. package/scripts/banner.js +29 -0
  457. package/scripts/benchmark-local-routerarena.ts +176 -0
  458. package/scripts/benchmark.js +145 -0
  459. package/scripts/benchmark.sh +61 -0
  460. package/scripts/compare-providers.sh +230 -0
  461. package/scripts/content-planner.js +25 -0
  462. package/scripts/create-labeled-benchmark.ts +105 -0
  463. package/scripts/cross_post.py +443 -0
  464. package/scripts/local-router-benchmark.ts +154 -0
  465. package/scripts/post-all.sh +41 -0
  466. package/scripts/publish_fcc.py +106 -0
  467. package/scripts/push-to-gitee.sh +25 -0
  468. package/scripts/routerarena_ensemble.js +144 -0
  469. package/scripts/routing-benchmark-v2.js +373 -0
  470. package/scripts/routing-benchmark-v3.js +118 -0
  471. package/scripts/routing-benchmark.js +462 -0
  472. package/scripts/run-labeled-benchmark.mjs +104 -0
  473. package/scripts/run-mmlu-benchmark.js +176 -0
  474. package/scripts/run-provider-benchmark.js +244 -0
  475. package/scripts/update-npm-badges.js +158 -0
  476. package/skill/SKILL.md +238 -0
  477. package/src/__tests__/integration/tmpld_integration.test.py +540 -0
  478. package/src/ensemble.ts +2 -0
  479. package/src/routing/advancedRouter.ts +1 -1
  480. package/src/skills/__tests__/skill_manager.test.ts +328 -0
  481. package/submissions/benchmarks/ALL_PLATFORMS_SUBMISSION.md +94 -0
  482. package/submissions/benchmarks/LLMROUTERBENCH_SUBMISSION.md +121 -0
  483. package/submissions/benchmarks/MMRBENCH_SUBMISSION.md +94 -0
  484. package/submissions/benchmarks/ROUTERARENA_UPDATE.md +83 -0
  485. package/submissions/benchmarks/ROUTERBENCH_SUBMISSION.md +225 -0
  486. package/test-council/1-structure-tests.test.js +353 -0
  487. package/test-council/1-structure-tests.test.ts +353 -0
  488. package/test-council/2-edge-case-tests.test.ts +361 -0
  489. package/test-council/3-performance-tests.test.ts +652 -0
  490. package/test-council/4-integration-tests.test.ts +391 -0
  491. package/test-council/5-agent-council-eval.test.ts +413 -0
  492. package/test-council/AGENT_COUNCIL_ARCHITECTURE.md +349 -0
  493. package/test-council/TEST_COUNCIL_REPORT.md +201 -0
  494. package/test-council/agents/edge-case-agent.ts +363 -0
  495. package/test-council/agents/performance-agent.ts +426 -0
  496. package/test-council/agents/structure-agent.ts +227 -0
  497. package/test-council/council.md +183 -0
  498. package/tests/__mocks__/tokenUtils.ts +8 -0
  499. package/tests/memory/episodicMemory.test.ts +227 -0
  500. package/tests/package-lock.json +1785 -0
  501. package/tests/package.json +19 -0
  502. package/tests/routing/ensembleVoting.test.ts +236 -0
  503. package/tests/routing/providerRetry.test.ts +360 -0
  504. package/tests/routing/queryTypePresets.test.ts +208 -0
  505. package/tests/security/guardrailEngine.test.ts +700 -0
  506. package/tests/tsconfig.json +21 -0
  507. package/tests/vitest.config.ts +18 -0
  508. package/tmlpd-pi-extension/README.md +66 -0
  509. package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts +114 -0
  510. package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts.map +1 -0
  511. package/tmlpd-pi-extension/dist/cache/prefixCache.js +285 -0
  512. package/tmlpd-pi-extension/dist/cache/prefixCache.js.map +1 -0
  513. package/tmlpd-pi-extension/dist/cache/responseCache.d.ts +58 -0
  514. package/tmlpd-pi-extension/dist/cache/responseCache.d.ts.map +1 -0
  515. package/tmlpd-pi-extension/dist/cache/responseCache.js +153 -0
  516. package/tmlpd-pi-extension/dist/cache/responseCache.js.map +1 -0
  517. package/tmlpd-pi-extension/dist/cli.js +59 -0
  518. package/tmlpd-pi-extension/dist/cost/costTracker.d.ts +95 -0
  519. package/tmlpd-pi-extension/dist/cost/costTracker.d.ts.map +1 -0
  520. package/tmlpd-pi-extension/dist/cost/costTracker.js +240 -0
  521. package/tmlpd-pi-extension/dist/cost/costTracker.js.map +1 -0
  522. package/tmlpd-pi-extension/dist/index.d.ts +723 -0
  523. package/tmlpd-pi-extension/dist/index.d.ts.map +1 -0
  524. package/tmlpd-pi-extension/dist/index.js +239 -0
  525. package/tmlpd-pi-extension/dist/index.js.map +1 -0
  526. package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts +82 -0
  527. package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts.map +1 -0
  528. package/tmlpd-pi-extension/dist/memory/episodicMemory.js +145 -0
  529. package/tmlpd-pi-extension/dist/memory/episodicMemory.js.map +1 -0
  530. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts +102 -0
  531. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts.map +1 -0
  532. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js +207 -0
  533. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js.map +1 -0
  534. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts +85 -0
  535. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts.map +1 -0
  536. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js +210 -0
  537. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js.map +1 -0
  538. package/tmlpd-pi-extension/dist/providers/localProvider.d.ts +102 -0
  539. package/tmlpd-pi-extension/dist/providers/localProvider.d.ts.map +1 -0
  540. package/tmlpd-pi-extension/dist/providers/localProvider.js +338 -0
  541. package/tmlpd-pi-extension/dist/providers/localProvider.js.map +1 -0
  542. package/tmlpd-pi-extension/dist/providers/registry.d.ts +55 -0
  543. package/tmlpd-pi-extension/dist/providers/registry.d.ts.map +1 -0
  544. package/tmlpd-pi-extension/dist/providers/registry.js +138 -0
  545. package/tmlpd-pi-extension/dist/providers/registry.js.map +1 -0
  546. package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts +68 -0
  547. package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts.map +1 -0
  548. package/tmlpd-pi-extension/dist/routing/advancedRouter.js +332 -0
  549. package/tmlpd-pi-extension/dist/routing/advancedRouter.js.map +1 -0
  550. package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts +101 -0
  551. package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts.map +1 -0
  552. package/tmlpd-pi-extension/dist/tools/tmlpdTools.js +368 -0
  553. package/tmlpd-pi-extension/dist/tools/tmlpdTools.js.map +1 -0
  554. package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts +96 -0
  555. package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts.map +1 -0
  556. package/tmlpd-pi-extension/dist/utils/batchProcessor.js +170 -0
  557. package/tmlpd-pi-extension/dist/utils/batchProcessor.js.map +1 -0
  558. package/tmlpd-pi-extension/dist/utils/compression.d.ts +61 -0
  559. package/tmlpd-pi-extension/dist/utils/compression.d.ts.map +1 -0
  560. package/tmlpd-pi-extension/dist/utils/compression.js +281 -0
  561. package/tmlpd-pi-extension/dist/utils/compression.js.map +1 -0
  562. package/tmlpd-pi-extension/dist/utils/reliability.d.ts +74 -0
  563. package/tmlpd-pi-extension/dist/utils/reliability.d.ts.map +1 -0
  564. package/tmlpd-pi-extension/dist/utils/reliability.js +177 -0
  565. package/tmlpd-pi-extension/dist/utils/reliability.js.map +1 -0
  566. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts +117 -0
  567. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts.map +1 -0
  568. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js +246 -0
  569. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js.map +1 -0
  570. package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts +50 -0
  571. package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts.map +1 -0
  572. package/tmlpd-pi-extension/dist/utils/tokenUtils.js +124 -0
  573. package/tmlpd-pi-extension/dist/utils/tokenUtils.js.map +1 -0
  574. package/tmlpd-pi-extension/examples/QUICKSTART.md +183 -0
  575. package/tmlpd-pi-extension/package-lock.json +79 -0
  576. package/tmlpd-pi-extension/package.json +172 -0
  577. package/tmlpd-pi-extension/python/examples.py +53 -0
  578. package/tmlpd-pi-extension/python/integrations.py +330 -0
  579. package/tmlpd-pi-extension/python/setup.py +28 -0
  580. package/tmlpd-pi-extension/python/tmlpd.py +369 -0
  581. package/tmlpd-pi-extension/qna/REDDIT_GAP_ANALYSIS.md +299 -0
  582. package/tmlpd-pi-extension/qna/TMLPD_QNA.md +751 -0
  583. package/tmlpd-pi-extension/skill/SKILL.md +238 -0
  584. package/tmlpd-pi-extension/src/cache/responseCache.ts +147 -0
  585. package/tmlpd-pi-extension/src/cost/costTracker.ts +302 -0
  586. package/tmlpd-pi-extension/src/index.ts +232 -0
  587. package/tmlpd-pi-extension/src/memory/episodicMemory.ts +257 -0
  588. package/tmlpd-pi-extension/src/orchestration/haloOrchestrator.ts +266 -0
  589. package/tmlpd-pi-extension/src/orchestration/mctsWorkflow.ts +262 -0
  590. package/tmlpd-pi-extension/src/providers/localProvider.ts +406 -0
  591. package/tmlpd-pi-extension/src/providers/registry.ts +164 -0
  592. package/tmlpd-pi-extension/src/routing/ensembleVoting.ts +159 -0
  593. package/tmlpd-pi-extension/src/routing/queryTypePresets.ts +136 -0
  594. package/tmlpd-pi-extension/src/tools/tmlpdTools.ts +433 -0
  595. package/tmlpd-pi-extension/src/utils/batchProcessor.ts +232 -0
  596. package/tmlpd-pi-extension/src/utils/compression.ts +325 -0
  597. package/tmlpd-pi-extension/src/utils/reliability.ts +221 -0
  598. package/tmlpd-pi-extension/src/utils/tokenUtils.ts +145 -0
  599. package/tmlpd-pi-extension/tsconfig.json +18 -0
  600. package/tsconfig.build.json +29 -0
  601. package/tsconfig.json +18 -0
  602. package/README.md.bak +0 -1185
  603. package/src/routing/advancedRouter.ts.bak +0 -650
  604. package/test.js.bak +0 -376
  605. /package/{llms-full.txt.bak → docs/llms-full.txt} +0 -0
@@ -0,0 +1,105 @@
1
+ /**
2
+ * Create labeled benchmark dataset for local testing
3
+ *
4
+ * Each query has an "actualTier" based on the model's required capability.
5
+ */
6
+
7
+ const BENCHMARK_QUERIES = [
8
+ // === FREE TIER (simple factual, definitions, basic math) ===
9
+ { query: "What is 2+2?", actualTier: "free" },
10
+ { query: "What is the capital of France?", actualTier: "free" },
11
+ { query: "How do you say hello in Spanish?", actualTier: "free" },
12
+ { query: "What day is it today?", actualTier: "free" },
13
+ { query: "Convert 100 Celsius to Fahrenheit", actualTier: "free" },
14
+ { query: "What is the largest planet in the solar system?", actualTier: "free" },
15
+ { query: "How many ounces in a pound?", actualTier: "free" },
16
+ { query: "What is the speed of light?", actualTier: "free" },
17
+ { query: "Who wrote Romeo and Juliet?", actualTier: "free" },
18
+ { query: "What is photosynthesis?", actualTier: "free" },
19
+ { query: "What is the square root of 144?", actualTier: "free" },
20
+ { query: "Name three primary colors", actualTier: "free" },
21
+ { query: "What is the chemical symbol for gold?", actualTier: "free" },
22
+ { query: "How many continents are there?", actualTier: "free" },
23
+ { query: "What is gravity?", actualTier: "free" },
24
+ { query: "Define 'ubiquitous'", actualTier: "free" },
25
+ { query: "What does 'benevolent' mean?", actualTier: "free" },
26
+ { query: "How many bytes in a kilobyte?", actualTier: "free" },
27
+ { query: "What is H2O commonly known as?", actualTier: "free" },
28
+ { query: "Translate 'good morning' to French", actualTier: "free" },
29
+
30
+ // === CHEAP TIER (simple tasks, short code, basic translation) ===
31
+ { query: "Write a Python function to sort a list", actualTier: "cheap" },
32
+ { query: "Explain the difference between TCP and UDP", actualTier: "cheap" },
33
+ { query: "Write a SQL query to find duplicate records", actualTier: "cheap" },
34
+ { query: "Create a REST API endpoint in Express.js", actualTier: "cheap" },
35
+ { query: "Explain Docker containers vs virtual machines", actualTier: "cheap" },
36
+ { query: "Write a regex to validate email addresses", actualTier: "cheap" },
37
+ { query: "Describe the water cycle in simple terms", actualTier: "cheap" },
38
+ { query: "Summarize this article about climate change in 3 bullet points", actualTier: "cheap" },
39
+ { query: "Translate this paragraph from English to French", actualTier: "cheap" },
40
+ { query: "How do I reverse a string in JavaScript?", actualTier: "cheap" },
41
+ { query: "Write a for loop in Python", actualTier: "cheap" },
42
+ { query: "What is the difference between let and const in JavaScript?", actualTier: "cheap" },
43
+ { query: "Explain what an API is to a non-technical person", actualTier: "cheap" },
44
+ { query: "How do I center a div in CSS?", actualTier: "cheap" },
45
+ { query: "Write a basic HTML form", actualTier: "cheap" },
46
+ { query: "Explain git merge vs rebase", actualTier: "cheap" },
47
+ { query: "What is a RESTful API?", actualTier: "cheap" },
48
+ { query: "How do I read a file in Node.js?", actualTier: "cheap" },
49
+ { query: "Write a simple unit test in Jest", actualTier: "cheap" },
50
+ { query: "Explain what a database index does", actualTier: "cheap" },
51
+ { query: "How do I parse JSON in Python?", actualTier: "cheap" },
52
+
53
+ // === MID TIER (multi-step, domain knowledge, system design basics) ===
54
+ { query: "Design a REST API for a blog with users, posts, and comments", actualTier: "mid" },
55
+ { query: "Explain how OAuth 2.0 authentication works", actualTier: "mid" },
56
+ { query: "Design a rate limiting system for a web API", actualTier: "mid" },
57
+ { query: "How would you implement a caching layer for a web application?", actualTier: "mid" },
58
+ { query: "Compare and contrast SQL and NoSQL databases", actualTier: "mid" },
59
+ { query: "Design a user authentication system with JWT tokens", actualTier: "mid" },
60
+ { query: "Explain the CAP theorem and its implications", actualTier: "mid" },
61
+ { query: "How do you design a URL shortening service like bit.ly?", actualTier: "mid" },
62
+ { query: "Design a real-time notification system", actualTier: "mid" },
63
+ { query: "Explain the pros and cons of microservices vs monolith", actualTier: "mid" },
64
+ { query: "How would you implement search functionality in a web app?", actualTier: "mid" },
65
+ { query: "Design a payment processing system", actualTier: "mid" },
66
+ { query: "Explain how blockchain achieves consensus", actualTier: "mid" },
67
+ { query: "Design a multi-tenant SaaS architecture", actualTier: "mid" },
68
+ { query: "How do you handle database migrations in production?", actualTier: "mid" },
69
+ { query: "Design a logging and monitoring system", actualTier: "mid" },
70
+ { query: "Explain load balancing algorithms", actualTier: "mid" },
71
+ { query: "How would you design a file upload system?", actualTier: "mid" },
72
+ { query: "Design a chat application with WebSockets", actualTier: "mid" },
73
+ { query: "Explain event-driven architecture patterns", actualTier: "mid" },
74
+
75
+ // === PREMIUM TIER (complex reasoning, architecture, novel problems) ===
76
+ { query: "Design a distributed system that handles 10 million requests per second", actualTier: "premium" },
77
+ { query: "Architect a real-time collaboration system like Google Docs", actualTier: "premium" },
78
+ { query: "Design a machine learning pipeline from data ingestion to model serving", actualTier: "premium" },
79
+ { query: "Create a comprehensive technical design for a social media platform at scale", actualTier: "premium" },
80
+ { query: "Design a zero-downtime deployment strategy for a distributed system", actualTier: "premium" },
81
+ { query: "Architect a system that processes streaming data with sub-second latency", actualTier: "premium" },
82
+ { query: "Design a fraud detection system using machine learning", actualTier: "premium" },
83
+ { query: "Create an architecture for a global CDN with edge computing", actualTier: "premium" },
84
+ { query: "Design a multi-region active-active database architecture", actualTier: "premium" },
85
+ { query: "Architect a system for real-time video transcoding at scale", actualTier: "premium" },
86
+ { query: "Design a privacy-preserving data analytics system", actualTier: "premium" },
87
+ { query: "Create a comprehensive security architecture for a fintech application", actualTier: "premium" },
88
+ { query: "Design a system that handles 1 billion events per day", actualTier: "premium" },
89
+ { query: "Architect a serverless system with consistent performance", actualTier: "premium" },
90
+ { query: "Design a data warehouse architecture for petabyte-scale analytics", actualTier: "premium" },
91
+ { query: "Create a multi-cloud hybrid architecture strategy", actualTier: "premium" },
92
+ { query: "Design a system for real-time anomaly detection in financial transactions", actualTier: "premium" },
93
+ { query: "Architect a mesh network for IoT at scale", actualTier: "premium" },
94
+ { query: "Design a comprehensive disaster recovery strategy", actualTier: "premium" },
95
+ { query: "Create an architecture for autonomous vehicle sensor fusion", actualTier: "premium" },
96
+ ];
97
+
98
+ import * as fs from 'fs';
99
+ const output = { queries: BENCHMARK_QUERIES };
100
+ fs.writeFileSync('./data/labeled-benchmark.json', JSON.stringify(output, null, 2));
101
+ console.log(`Created benchmark with ${BENCHMARK_QUERIES.length} labeled queries`);
102
+ console.log(`Free: ${BENCHMARK_QUERIES.filter(q => q.actualTier === 'free').length}`);
103
+ console.log(`Cheap: ${BENCHMARK_QUERIES.filter(q => q.actualTier === 'cheap').length}`);
104
+ console.log(`Mid: ${BENCHMARK_QUERIES.filter(q => q.actualTier === 'mid').length}`);
105
+ console.log(`Premium: ${BENCHMARK_QUERIES.filter(q => q.actualTier === 'premium').length}`);
@@ -0,0 +1,443 @@
1
+ """
2
+ Cross-post A3M Router article to multiple platforms using Playwright (headless)
3
+ """
4
+ import sys, json, time, os, re
5
+ from playwright.sync_api import sync_playwright, TimeoutError as PwTimeout
6
+
7
+ PROFILE_PATH = "/var/folders/l9/4016_h694kdbx1wvdg5881bh0000gp/T/chrome_profile_100llyqq"
8
+
9
+ def get_article_text():
10
+ path = "/Users/Subho/adaptive-memory-multi-model-router/articles/FRESH_devto_2026_05.md"
11
+ with open(path) as f:
12
+ return f.read()
13
+
14
+ def safe_screenshot(page, name):
15
+ try:
16
+ page.screenshot(path=f"/tmp/{name}.png")
17
+ except:
18
+ pass
19
+
20
+ def try_fcc(browser):
21
+ """Try to publish on FreeCodeCamp"""
22
+ page = browser.new_page()
23
+ results = []
24
+
25
+ try:
26
+ print("\n=== FCC: Starting ===")
27
+ page.goto("https://www.freecodecamp.org/news/settings/publishing", timeout=30000, wait_until="domcontentloaded")
28
+ time.sleep(3)
29
+ safe_screenshot(page, "fcc_1_landing")
30
+
31
+ # Check if we're on login page
32
+ if "login" in page.url.lower() or page.query_selector('input[type="email"]'):
33
+ print("[FCC] Login page detected, logging in...")
34
+ email_input = page.wait_for_selector('input[type="email"]', timeout=5000)
35
+ email_input.fill("subho.matteragent@gmail.com")
36
+
37
+ pw_input = page.wait_for_selector('input[type="password"]', timeout=5000)
38
+ pw_input.fill("YourChance2025!")
39
+
40
+ submit = page.query_selector('button[type="submit"]')
41
+ if submit:
42
+ submit.click()
43
+ time.sleep(5)
44
+ safe_screenshot(page, "fcc_2_after_login")
45
+
46
+ # Navigate to publishing page again
47
+ page.goto("https://www.freecodecamp.org/news/settings/publishing", timeout=30000, wait_until="domcontentloaded")
48
+ time.sleep(3)
49
+
50
+ # Check page content
51
+ html = page.content()
52
+ if "draft" in html.lower():
53
+ print("[FCC] Found drafts!")
54
+ results.append("FCC: Found drafts page, check screenshots for details")
55
+
56
+ # Try clicking any edit/publish link for the A3M article
57
+ for link in page.query_selector_all('a'):
58
+ href = link.get_attribute('href') or ''
59
+ text = link.inner_text() or ''
60
+ if 'draft' in href or 'edit' in href:
61
+ print(f" Link: {text[:80]} -> {href}")
62
+
63
+ # Try finding publish buttons
64
+ for btn in page.query_selector_all('button'):
65
+ text = (btn.inner_text() or '').lower()
66
+ if 'publish' in text or 'submit' in text:
67
+ print(f" Button: {btn.inner_text()}")
68
+ btn.click()
69
+ time.sleep(3)
70
+ safe_screenshot(page, "fcc_3_publish_clicked")
71
+ results.append("FCC: Publish button clicked")
72
+ break
73
+ else:
74
+ print(f"[FCC] No drafts section - page title: {page.title()}")
75
+ results.append(f"FCC: No drafts accessible. Page: {page.title()}")
76
+
77
+ except Exception as e:
78
+ print(f"[FCC] Error: {e}")
79
+ results.append(f"FCC Error: {str(e)[:100]}")
80
+ safe_screenshot(page, "fcc_error")
81
+
82
+ page.close()
83
+ return results
84
+
85
+ def try_hackernoon(browser):
86
+ """Try to post on HackerNoon"""
87
+ page = browser.new_page()
88
+ results = []
89
+
90
+ try:
91
+ print("\n=== HackerNoon: Starting ===")
92
+ page.goto("https://hackernoon.com/", timeout=30000, wait_until="domcontentloaded")
93
+ time.sleep(3)
94
+ safe_screenshot(page, "hn_1_landing")
95
+
96
+ # Try to find login button
97
+ login_selectors = [
98
+ 'a[href*="login"]', 'a[href*="signin"]', 'a[href*="sign-up"]',
99
+ 'button:has-text("Log in")', 'button:has-text("Sign in")',
100
+ 'a:has-text("Log in")', 'a:has-text("Sign in")',
101
+ '[data-cy="login-button"]', '[test-id="login"]'
102
+ ]
103
+
104
+ clicked_login = False
105
+ for sel in login_selectors:
106
+ try:
107
+ btn = page.wait_for_selector(sel, timeout=2000)
108
+ if btn and btn.is_visible():
109
+ print(f"[HN] Found login button: {sel}")
110
+ btn.click()
111
+ time.sleep(3)
112
+ clicked_login = True
113
+ break
114
+ except:
115
+ continue
116
+
117
+ if not clicked_login:
118
+ # Try JavaScript click on all possible login elements
119
+ try:
120
+ page.evaluate("""
121
+ [...document.querySelectorAll('a, button')].find(el =>
122
+ el.innerText.toLowerCase().includes('log in') ||
123
+ el.innerText.toLowerCase().includes('sign in') ||
124
+ el.href?.includes('login')
125
+ )?.click()
126
+ """)
127
+ time.sleep(3)
128
+ except:
129
+ pass
130
+
131
+ safe_screenshot(page, "hn_2_login_clicked")
132
+
133
+ # Fill in credentials if login form appears
134
+ try:
135
+ email_input = page.wait_for_selector('input[type="email"], input[name="email"]', timeout=5000)
136
+ email_input.fill("subho.matteragent@gmail.com")
137
+ time.sleep(1)
138
+
139
+ pw_input = page.wait_for_selector('input[type="password"]', timeout=3000)
140
+ pw_input.fill("YourChance2025!")
141
+ time.sleep(1)
142
+
143
+ submit = page.query_selector('button[type="submit"]')
144
+ if submit:
145
+ submit.click()
146
+ time.sleep(5)
147
+ safe_screenshot(page, "hn_3_logged_in")
148
+ results.append("HN: Login attempted")
149
+ else:
150
+ print("[HN] No submit button found")
151
+ except:
152
+ print("[HN] No login form appeared")
153
+ results.append("HN: Login form did not appear (React/Cloudflare issue)")
154
+
155
+ # Try navigating to write/create post
156
+ page.goto("https://hackernoon.com/new-story", timeout=30000, wait_until="domcontentloaded")
157
+ time.sleep(3)
158
+ safe_screenshot(page, "hn_4_new_story")
159
+
160
+ # Check if we can write
161
+ html = page.content()
162
+ if "new-story" in page.url or "write" in page.url or "create" in page.url:
163
+ results.append("HN: On story creation page")
164
+
165
+ # Try to fill in title and content
166
+ title_input = page.query_selector('input[placeholder*="title" i], textarea[placeholder*="title" i], [contenteditable="true"]')
167
+ if title_input:
168
+ article = get_article_text()
169
+ lines = article.strip().split('\n')
170
+ title = lines[0].replace('#', '').strip() if lines[0].startswith('#') else "Three LLM Infrastructure Problems That Shouldn't Exist in 2026"
171
+
172
+ title_input.fill(title)
173
+ print(f"[HN] Filled title: {title}")
174
+ time.sleep(1)
175
+
176
+ # Try content area
177
+ content_area = page.query_selector('[contenteditable="true"], textarea, .ProseMirror, [data-lexical-editor]')
178
+ if content_area:
179
+ content_area.fill(article)
180
+ results.append("HN: Content filled")
181
+ safe_screenshot(page, "hn_5_content_filled")
182
+ else:
183
+ results.append("HN: Could not find content area")
184
+ else:
185
+ results.append("HN: No title input found")
186
+ else:
187
+ results.append(f"HN: Not on create page. URL: {page.url}")
188
+
189
+ except Exception as e:
190
+ print(f"[HN] Error: {e}")
191
+ results.append(f"HN Error: {str(e)[:100]}")
192
+ safe_screenshot(page, "hn_error")
193
+
194
+ page.close()
195
+ return results
196
+
197
+ def try_linkedin(browser):
198
+ """Try to post on LinkedIn using Chrome profile cookies"""
199
+ page = browser.new_page()
200
+ results = []
201
+
202
+ try:
203
+ print("\n=== LinkedIn: Starting ===")
204
+ page.goto("https://www.linkedin.com", timeout=30000, wait_until="domcontentloaded")
205
+ time.sleep(3)
206
+ safe_screenshot(page, "li_1_landing")
207
+
208
+ # Check if already logged in
209
+ if "feed" in page.url or "/in/" in page.url:
210
+ print("[LI] Already logged in!")
211
+ results.append("LI: Already logged in")
212
+ else:
213
+ # Try logging in
214
+ try:
215
+ email_input = page.wait_for_selector('input#session_key, input[name="session_key"], input[autocomplete="username"]', timeout=5000)
216
+ email_input.fill("subho.matteragent@gmail.com")
217
+ time.sleep(1)
218
+
219
+ pw_input = page.wait_for_selector('input#session_password, input[name="session_password"]', timeout=3000)
220
+ pw_input.fill("YourChance2025!")
221
+ time.sleep(1)
222
+
223
+ submit = page.query_selector('button[type="submit"]')
224
+ if submit:
225
+ submit.click()
226
+ time.sleep(5)
227
+ safe_screenshot(page, "li_2_logged_in")
228
+ results.append("LI: Login attempted")
229
+ except:
230
+ print("[LI] No login form found or already logged in")
231
+
232
+ # Try to write an article
233
+ page.goto("https://www.linkedin.com/post/new/", timeout=30000, wait_until="domcontentloaded")
234
+ time.sleep(3)
235
+ safe_screenshot(page, "li_3_new_post")
236
+
237
+ # Check if we're on the post page
238
+ if "post" in page.url:
239
+ # Try clicking "Write article" or similar
240
+ for selector in ['button:has-text("Write article")', 'a:has-text("Write article")', 'button:has-text("Create post")']:
241
+ try:
242
+ btn = page.wait_for_selector(selector, timeout=3000)
243
+ if btn:
244
+ btn.click()
245
+ time.sleep(3)
246
+ break
247
+ except:
248
+ continue
249
+
250
+ safe_screenshot(page, "li_4_article_editor")
251
+
252
+ # Try to find contenteditable area
253
+ editor = page.query_selector('[contenteditable="true"][aria-label*="editor" i]')
254
+ if editor:
255
+ article = get_article_text()
256
+ editor.fill(article)
257
+ results.append("LI: Content filled in editor")
258
+ safe_screenshot(page, "li_5_content_filled")
259
+ else:
260
+ results.append("LI: Could not find article editor")
261
+ else:
262
+ results.append(f"LI: Not on post page. URL: {page.url}")
263
+
264
+ except Exception as e:
265
+ print(f"[LI] Error: {e}")
266
+ results.append(f"LI Error: {str(e)[:100]}")
267
+ safe_screenshot(page, "li_error")
268
+
269
+ page.close()
270
+ return results
271
+
272
+ def try_devto(browser):
273
+ """Write and publish a SECOND article on dev.to"""
274
+ page = browser.new_page()
275
+ results = []
276
+
277
+ second_article = """---
278
+ title: Why Sequential LLM Fallback Is a Lie
279
+ published: false
280
+ description: How parallel LLM execution with confidence scoring replaces the illusion of sequential fallback with actual better results
281
+ tags: llm, ai, infrastructure, javascript
282
+ ---
283
+
284
+ ## The Lie
285
+
286
+ Every LLM gateway does the same thing: try Provider A, wait, fail, try Provider B, wait, fail, try Provider C. They call this "fallback." But what it really means is you always get whatever Provider A returns — good or bad — and only try the others when A is completely broken.
287
+
288
+ This isn't a sophisticated strategy. It's basic error handling dressed up as infrastructure.
289
+
290
+ ## The Math
291
+
292
+ Here's something no one talks about: **running 3 providers in parallel costs less than running 2 in sequence.**
293
+
294
+ Why? Timeout waste.
295
+
296
+ If Provider A has a 5-second timeout and you're running sequentially, you burn 5 seconds waiting before even touching Provider B. In a parallel setup, all 3 run simultaneously. You pay for all 3, but you get results in the time of the fastest provider.
297
+
298
+ Worst-case sequential: 5s (A timeout) + 5s (B timeout) + 5s (C timeout) = 15s
299
+ Worst-case parallel: 5s (all run simultaneously)
300
+
301
+ For many use cases — especially with providers averaging 300-700ms — parallel execution is both faster AND more reliable.
302
+
303
+ ## How A3M Does It
304
+
305
+ Our router doesn't do fallback. It does **ensemble execution**:
306
+
307
+ 1. Classify the query by type (code, creative, analytical, simple)
308
+ 2. Route to 3 appropriate providers in parallel
309
+ 3. Score every result on specificity, structure, and relevance
310
+ 4. Return the best result with confidence scores attached
311
+
312
+ The result is you get the **best** answer, not the **first** answer. And you get it faster than most sequential fallback setups.
313
+
314
+ ## The Bottom Line
315
+
316
+ Sequential fallback is a crutch from the era when LLM providers were unreliable. In 2026, most providers have >99% uptime. The bottleneck isn't reliability — it's picking the right provider for the right query.
317
+
318
+ Parallel ensemble execution solves the actual problem: getting the best possible answer in the shortest possible time.
319
+
320
+ ---
321
+
322
+ *A3M Router — npm: `adaptive-memory-multi-model-router`*
323
+ *GitHub: [github.com/Das-rebel/a3m-router](https://github.com/Das-rebel/a3m-router)*
324
+ """
325
+
326
+ try:
327
+ print("\n=== dev.to: Starting second article ===")
328
+ page.goto("https://dev.to/", timeout=30000, wait_until="domcontentloaded")
329
+ time.sleep(3)
330
+ safe_screenshot(page, "dev_1_landing")
331
+
332
+ # Try logging in
333
+ if "sign-in" in page.url.lower() or page.query_selector('input[type="email"]'):
334
+ print("[dev] Login page, signing in...")
335
+ try:
336
+ email_input = page.wait_for_selector('input[type="email"], input[name="user[email]"], input[autocomplete="email"]', timeout=5000)
337
+ email_input.fill("subho.matteragent@gmail.com")
338
+ time.sleep(1)
339
+
340
+ pw_input = page.wait_for_selector('input[type="password"], input[name="user[password]"]', timeout=3000)
341
+ pw_input.fill("YourChance2025!")
342
+ time.sleep(1)
343
+
344
+ submit = page.query_selector('button[type="submit"], input[type="submit"]')
345
+ if submit:
346
+ submit.click()
347
+ time.sleep(5)
348
+ safe_screenshot(page, "dev_2_logged_in")
349
+ except Exception as e:
350
+ print(f"[dev] Login form interaction failed: {e}")
351
+
352
+ # Navigate to write a post
353
+ page.goto("https://dev.to/new", timeout=30000, wait_until="domcontentloaded")
354
+ time.sleep(3)
355
+ safe_screenshot(page, "dev_3_new_post")
356
+
357
+ # Check if we're on the new post page
358
+ if "new" in page.url:
359
+ # Fill title
360
+ title_input = page.query_selector('input[placeholder*="title" i], input#article_title, textarea#article_title')
361
+ if title_input:
362
+ title_input.fill("Why Sequential LLM Fallback Is a Lie")
363
+ print("[dev] Title filled")
364
+
365
+ time.sleep(1)
366
+
367
+ # Fill body - dev.to uses a textarea or contenteditable
368
+ body_editor = page.query_selector('textarea#article_body_markdown, [contenteditable="true"][aria-label*="content" i], textarea[aria-label*="content" i]')
369
+ if body_editor:
370
+ body_editor.fill(second_article)
371
+ print("[dev] Body filled")
372
+
373
+ time.sleep(1)
374
+
375
+ # Try to publish
376
+ publish_btn = page.query_selector('button:has-text("Publish"), input[value*="Publish"]')
377
+ if publish_btn:
378
+ publish_btn.click()
379
+ time.sleep(3)
380
+ safe_screenshot(page, "dev_4_published")
381
+ results.append("dev.to: Publish attempted")
382
+ else:
383
+ # Try save as draft
384
+ save_btn = page.query_selector('button:has-text("Save"), button:has-text("Draft")')
385
+ if save_btn:
386
+ save_btn.click()
387
+ time.sleep(3)
388
+ safe_screenshot(page, "dev_4_saved")
389
+ results.append("dev.to: Saved as draft")
390
+ else:
391
+ results.append("dev.to: Could not find publish or save button")
392
+
393
+ safe_screenshot(page, "dev_final")
394
+ else:
395
+ results.append(f"dev.to: Not on new post page. URL: {page.url}")
396
+ # Maybe we need to click "Write a post" or similar
397
+ write_links = page.query_selector_all('a[href="/new"], a:has-text("Write"), a:has-text("Create")')
398
+ for link in write_links:
399
+ print(f" Write link: {link.inner_text()} -> {link.get_attribute('href')}")
400
+ link.click()
401
+ time.sleep(3)
402
+ break
403
+
404
+ except Exception as e:
405
+ print(f"[dev] Error: {e}")
406
+ results.append(f"dev.to Error: {str(e)[:100]}")
407
+ safe_screenshot(page, "dev_error")
408
+
409
+ page.close()
410
+ return results
411
+
412
+ def main():
413
+ print("=== Cross-Posting A3M Router Article ===\n")
414
+
415
+ all_results = {}
416
+
417
+ with sync_playwright() as p:
418
+ # Use persistent context with Chrome profile for cookies
419
+ context = p.chromium.launch_persistent_context(
420
+ PROFILE_PATH,
421
+ headless=True,
422
+ args=["--no-sandbox", "--disable-blink-features=AutomationControlled"],
423
+ user_agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
424
+ )
425
+
426
+ # Try each platform
427
+ all_results["fcc"] = try_fcc(context)
428
+ all_results["hackernoon"] = try_hackernoon(context)
429
+ all_results["linkedin"] = try_linkedin(context)
430
+ all_results["devto"] = try_devto(context)
431
+
432
+ context.close()
433
+
434
+ print("\n\n=== RESULTS SUMMARY ===")
435
+ for platform, results in all_results.items():
436
+ print(f"\n--- {platform.upper()} ---")
437
+ for r in results:
438
+ print(f" {r}")
439
+
440
+ print("\nScreenshots saved to /tmp/*.png")
441
+
442
+ if __name__ == "__main__":
443
+ main()