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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (598) hide show
  1. package/{docs/llms.txt → llms.txt.bak} +6 -6
  2. package/package.json +270 -72
  3. package/src/routing/advancedRouter.ts.bak +650 -0
  4. package/test.js.bak +376 -0
  5. package/.dockerignore +0 -82
  6. package/.env.example +0 -303
  7. package/.github/DISCUSSIONS_WELCOME.md +0 -27
  8. package/.github/DISCUSSION_TEMPLATE.yml +0 -5
  9. package/.github/FUNDING.yml +0 -2
  10. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -94
  11. package/.github/ISSUE_TEMPLATE/config.yml +0 -17
  12. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -71
  13. package/.github/PULL_REQUEST_TEMPLATE.md +0 -71
  14. package/.github/dependabot.yml +0 -9
  15. package/.github/workflows/auto-publish.yml +0 -51
  16. package/.github/workflows/ci.yml +0 -263
  17. package/.github/workflows/codeql.yml +0 -38
  18. package/.github/workflows/npm-publish.yml +0 -20
  19. package/.github/workflows/pages.yml +0 -37
  20. package/.github/workflows/stale.yml +0 -54
  21. package/.publish-tick +0 -1
  22. package/.well-known/ai-plugin.json +0 -16
  23. package/AGENT_COUNCIL_FINDINGS.md +0 -142
  24. package/ARCHITECTURE.md +0 -346
  25. package/AUDIT_REPORT.md +0 -28
  26. package/CODE_OF_CONDUCT.md +0 -128
  27. package/CONTRIBUTING.md +0 -50
  28. package/CONTRIBUTORS.md +0 -20
  29. package/Dockerfile +0 -53
  30. package/Dockerfile.proxy +0 -33
  31. package/HEALTH_REPORT.md +0 -118
  32. package/IMPROVEMENT_PLAN.md +0 -107
  33. package/LANDING.md +0 -43
  34. package/LAUNCH-PAIN-DRIVEN.md +0 -339
  35. package/LAUNCH.md +0 -337
  36. package/LAUNCH_CHECKLIST.md +0 -141
  37. package/LAUNCH_SNAPSHOT.md +0 -260
  38. package/MANIFESTO.md +0 -41
  39. package/POPULARITY_BOOSTERS.md +0 -285
  40. package/PR_STATUS_REPORT.md +0 -148
  41. package/REDESIGN.md +0 -95
  42. package/RUNKIT.md +0 -83
  43. package/SECURITY.md +0 -29
  44. package/SUBMISSIONS.md +0 -43
  45. package/_schema.html +0 -53
  46. package/ai-plugin.json +0 -16
  47. package/articles/AI_AGENT_LLM_ROUTING.md +0 -150
  48. package/articles/CHINESE_DIRECTORIES.md +0 -100
  49. package/articles/CHINESE_SUBMISSIONS_READY.md +0 -322
  50. package/articles/COMPETITOR_ALERTS.md +0 -31
  51. package/articles/COMPLETE_POSTING_DIRECTORY.md +0 -147
  52. package/articles/CONTENT_STRUCTURE.md +0 -292
  53. package/articles/DEVTO_COST_GUIDE.md +0 -473
  54. package/articles/DEVTO_FINAL.md +0 -416
  55. package/articles/DEVTO_MULTI_PROVIDER.md +0 -542
  56. package/articles/DEVTO_READY.md +0 -255
  57. package/articles/DEVTO_V2_ANNOUNCEMENT.md +0 -160
  58. package/articles/DEVTO_VIRAL_GROWTH.md +0 -280
  59. package/articles/FRESH_devto.md +0 -460
  60. package/articles/FRESH_devto_2026_05.md +0 -73
  61. package/articles/FRESH_hackernews.md +0 -14
  62. package/articles/FRESH_reddit_ml.md +0 -90
  63. package/articles/FRESH_reddit_node.md +0 -198
  64. package/articles/FRESH_reddit_sideproject.md +0 -72
  65. package/articles/FRESH_reddit_webdev.md +0 -130
  66. package/articles/FROM_ZERO_TO_10K.md +0 -107
  67. package/articles/HN_10X_BETTER.md +0 -430
  68. package/articles/HN_ACCOUNT_GUIDE.md +0 -21
  69. package/articles/HN_CHINESE_STYLE.md +0 -308
  70. package/articles/HN_FINAL.md +0 -148
  71. package/articles/HN_POSTED_VERSION.md +0 -56
  72. package/articles/HN_POST_READY.md +0 -137
  73. package/articles/HN_RESEARCH.md +0 -364
  74. package/articles/HN_SHOW_routerarena.md +0 -17
  75. package/articles/HN_TIMING_GUIDE.md +0 -52
  76. package/articles/INDIEHACKERS_POST.md +0 -52
  77. package/articles/INDIEHACKERS_READY.md +0 -120
  78. package/articles/LLM_BENCHMARK_DEEP_DIVE.md +0 -153
  79. package/articles/MASTER_POSTING_DIRECTORY.md +0 -189
  80. package/articles/NEWSLETTER_SEND_NOW.md +0 -259
  81. package/articles/NEWSLETTER_SUBMISSIONS.md +0 -112
  82. package/articles/PAIN-DRIVEN-devto-v2.md +0 -308
  83. package/articles/PAIN-DRIVEN-devto-v3.md +0 -268
  84. package/articles/PAIN-DRIVEN-devto.md +0 -242
  85. package/articles/PAIN-DRIVEN-hackernews-v2.md +0 -138
  86. package/articles/PAIN-DRIVEN-hackernews-v3.md +0 -151
  87. package/articles/PAIN-DRIVEN-hackernews.md +0 -131
  88. package/articles/PAIN-DRIVEN-reddit-v2.md +0 -301
  89. package/articles/PAIN-DRIVEN-reddit-v3.md +0 -236
  90. package/articles/PAIN-DRIVEN-reddit.md +0 -218
  91. package/articles/PAIN-DRIVEN-twitter-v2.md +0 -110
  92. package/articles/PAIN-DRIVEN-twitter-v3.md +0 -121
  93. package/articles/PAIN-DRIVEN-twitter.md +0 -120
  94. package/articles/PORTKEY_VS_A3M.md +0 -147
  95. package/articles/POSTING_KIT_2026_05.md +0 -67
  96. package/articles/PRESS_KIT_routerarena.md +0 -77
  97. package/articles/PRODUCTHUNT_LISTING.md +0 -48
  98. package/articles/PRODUCTHUNT_READY.md +0 -106
  99. package/articles/PR_PLAN_vault.md +0 -125
  100. package/articles/REDDIT_FINAL.md +0 -232
  101. package/articles/REDDIT_POST.md +0 -67
  102. package/articles/REDDIT_SUBMISSION_READY.md +0 -348
  103. package/articles/ROUTERARENA_LEADER.md +0 -45
  104. package/articles/SHOW_HN_FINAL.md +0 -29
  105. package/articles/TWEETS_10K_DOWNLOADS.md +0 -47
  106. package/articles/TWEETS_BENCHMARK_FIRST.md +0 -46
  107. package/articles/TWEETS_MCP_PLAY.md +0 -51
  108. package/articles/TWEETS_SEQUENTIAL_BROKEN.md +0 -49
  109. package/articles/TWEETS_WHY_BUILD.md +0 -54
  110. package/articles/TWEETS_routerarena_leader.md +0 -53
  111. package/articles/TWEET_STORM_READY.md +0 -165
  112. package/articles/TWITTER_FINAL.md +0 -167
  113. package/articles/WHY_10X_BETTER.md +0 -261
  114. package/articles/WHY_CHINESE_STYLE_BETTER.md +0 -323
  115. package/articles/ai-discoverability-llm-routing.md +0 -210
  116. package/articles/devto-llm-routing.md +0 -138
  117. package/articles/hackernews-show-hn.md +0 -54
  118. package/articles/hashnode-llm-cost-optimization.md +0 -125
  119. package/articles/hn_show_2026_05.md +0 -11
  120. package/articles/medium-building-llm-router.md +0 -205
  121. package/articles/reddit-ml.md +0 -76
  122. package/articles/twitter-thread-cost-savings.md +0 -50
  123. package/articles/youtube-tutorial-script.md +0 -262
  124. package/assets/a3m_3blue1brown.mp4 +0 -0
  125. package/assets/banner.svg +0 -109
  126. package/assets/chart-cost-v2.svg +0 -91
  127. package/assets/chart-cost-v3.svg +0 -143
  128. package/assets/chart-features-v2.svg +0 -132
  129. package/assets/chart-features-v3.svg +0 -211
  130. package/assets/chart-growth-v2.svg +0 -122
  131. package/assets/chart-growth-v3.svg +0 -189
  132. package/assets/cost-comparison.svg +0 -134
  133. package/assets/cost-simple.svg +0 -64
  134. package/assets/demo-hn.gif +0 -0
  135. package/assets/feature-matrix.svg +0 -136
  136. package/assets/growth-chart-animated.svg +0 -76
  137. package/assets/growth-chart.svg +0 -82
  138. package/assets/growth-simple.svg +0 -69
  139. package/assets/hero-diagram.svg +0 -81
  140. package/assets/logo-new.svg +0 -21
  141. package/assets/logo.svg +0 -68
  142. package/assets/provider-comparison.svg +0 -121
  143. package/assets/social-preview-new.svg +0 -100
  144. package/assets/social-preview.svg +0 -194
  145. package/assets/social-v2.svg +0 -130
  146. package/assets/social-v3.svg +0 -212
  147. package/benchmark-provider-results.json +0 -245
  148. package/benchmark-results.json +0 -54
  149. package/council-votes/architecture-vote.md +0 -121
  150. package/council-votes/coverage-vote.md +0 -93
  151. package/data/adaptive-benchmark.json +0 -92
  152. package/data/benchmark-results.json +0 -47
  153. package/data/labeled-benchmark.json +0 -88
  154. package/demo/3blue1brown_video.py +0 -285
  155. package/demo/3blue1brown_video_v2.py +0 -310
  156. package/demo/IMPROVED_PROMPTS.md +0 -229
  157. package/demo/VEO3_PROMPTS.md +0 -269
  158. package/demo/VIDEO_PRODUCTION_GUIDE.md +0 -333
  159. package/demo/a3m_3blue1brown.mp4 +0 -0
  160. package/demo/asciinema-demo.sh +0 -195
  161. package/demo/demo-hn.tape +0 -74
  162. package/demo/demo-script.md +0 -53
  163. package/demo/demo-script.sh +0 -62
  164. package/demo/demo.svg +0 -75
  165. package/demo/frame1_ai_data_center.png +0 -0
  166. package/demo/frame1_sunset_video.mp4 +0 -0
  167. package/demo/frame2_cost_comparison.png +0 -0
  168. package/demo/frame2_cost_comparison_fallback.png +0 -0
  169. package/demo/frame3_parallel_execution.png +0 -0
  170. package/demo/frame3_parallel_execution_fallback.png +0 -0
  171. package/demo/frame4_providers.png +0 -0
  172. package/demo/frame4_providers_fallback.png +0 -0
  173. package/demo/frame5_endcard.png +0 -0
  174. package/demo/frame5_endcard_fallback.png +0 -0
  175. package/demo/new_frame1_hook.png +0 -0
  176. package/demo/new_frame2_proof.png +0 -0
  177. package/demo/new_frame3_wow.png +0 -0
  178. package/demo/new_frame4_social.png +0 -0
  179. package/demo/new_frame5_cta.png +0 -0
  180. package/demo/package.json +0 -13
  181. package/demo/product-video-final.mp4 +0 -0
  182. package/demo/product-video-hype-v1.mp4 +0 -0
  183. package/demo/product-video-v1.mp4 +0 -0
  184. package/demo/public/index.html +0 -762
  185. package/demo/recording.cast +0 -55
  186. package/demo/server.js +0 -405
  187. package/demo-new.tape +0 -71
  188. package/demo-real.sh +0 -198
  189. package/demo-simple.tape +0 -205
  190. package/demo.html +0 -520
  191. package/demo.sh +0 -85
  192. package/demo.tape +0 -259
  193. package/dist/analytics/costAnalytics.d.ts.map +0 -1
  194. package/dist/analytics/costAnalytics.js.map +0 -1
  195. package/dist/benchmark/comprehensive.js.map +0 -1
  196. package/dist/benchmark/reproducible.d.ts.map +0 -1
  197. package/dist/benchmark/reproducible.js.map +0 -1
  198. package/dist/cache/prefixCache.d.ts.map +0 -1
  199. package/dist/cache/prefixCache.js.map +0 -1
  200. package/dist/cache/responseCache.d.ts.map +0 -1
  201. package/dist/cache/responseCache.js.map +0 -1
  202. package/dist/cache/semanticCache.d.ts.map +0 -1
  203. package/dist/cache/semanticCache.js.map +0 -1
  204. package/dist/cli/setupWizard.d.ts.map +0 -1
  205. package/dist/cli/setupWizard.js.map +0 -1
  206. package/dist/cost/budgetEnforcer.d.ts.map +0 -1
  207. package/dist/cost/budgetEnforcer.js.map +0 -1
  208. package/dist/cost/costTracker.d.ts.map +0 -1
  209. package/dist/cost/costTracker.js.map +0 -1
  210. package/dist/ensemble/multiRoundDialog.js.map +0 -1
  211. package/dist/ensemble/shapleyValue.js.map +0 -1
  212. package/dist/integrations/langchainAdapter.d.ts.map +0 -1
  213. package/dist/integrations/langchainAdapter.js.map +0 -1
  214. package/dist/integrations/oauth.d.ts.map +0 -1
  215. package/dist/integrations/oauth.js.map +0 -1
  216. package/dist/integrations/scienceAdapter.js.map +0 -1
  217. package/dist/memory/autoFetch.d.ts.map +0 -1
  218. package/dist/memory/autoFetch.js.map +0 -1
  219. package/dist/memory/episodicMemory.d.ts.map +0 -1
  220. package/dist/memory/episodicMemory.js.map +0 -1
  221. package/dist/memory/hybridMemory.js.map +0 -1
  222. package/dist/memory/memoryTree.d.ts.map +0 -1
  223. package/dist/memory/memoryTree.js.map +0 -1
  224. package/dist/memory/obsidianVault.d.ts.map +0 -1
  225. package/dist/memory/obsidianVault.js.map +0 -1
  226. package/dist/memory/reasoningBank.js.map +0 -1
  227. package/dist/observability/changeWatch.d.ts.map +0 -1
  228. package/dist/observability/changeWatch.js.map +0 -1
  229. package/dist/observability/fatigueDetector.d.ts.map +0 -1
  230. package/dist/observability/fatigueDetector.js.map +0 -1
  231. package/dist/observability/index.d.ts.map +0 -1
  232. package/dist/observability/index.js.map +0 -1
  233. package/dist/observability/metrics.d.ts.map +0 -1
  234. package/dist/observability/metrics.js.map +0 -1
  235. package/dist/observability/middleware.d.ts.map +0 -1
  236. package/dist/observability/middleware.js.map +0 -1
  237. package/dist/observability/tracer.d.ts.map +0 -1
  238. package/dist/observability/tracer.js.map +0 -1
  239. package/dist/observability/types.d.ts.map +0 -1
  240. package/dist/observability/types.js.map +0 -1
  241. package/dist/orchestration/haloOrchestrator.d.ts.map +0 -1
  242. package/dist/orchestration/haloOrchestrator.js.map +0 -1
  243. package/dist/orchestration/mctsWorkflow.d.ts.map +0 -1
  244. package/dist/orchestration/mctsWorkflow.js.map +0 -1
  245. package/dist/providers/localProvider.d.ts.map +0 -1
  246. package/dist/providers/localProvider.js.map +0 -1
  247. package/dist/providers/providerConfig.d.ts.map +0 -1
  248. package/dist/providers/providerConfig.js.map +0 -1
  249. package/dist/providers/registry.d.ts.map +0 -1
  250. package/dist/providers/registry.js.map +0 -1
  251. package/dist/routing/advancedRouter.d.ts.map +0 -1
  252. package/dist/routing/advancedRouter.js.map +0 -1
  253. package/dist/routing/crossModelValidation.d.ts.map +0 -1
  254. package/dist/routing/crossModelValidation.js.map +0 -1
  255. package/dist/routing/providerHealth.d.ts.map +0 -1
  256. package/dist/routing/providerHealth.js.map +0 -1
  257. package/dist/routing/providerRetry.d.ts.map +0 -1
  258. package/dist/routing/providerRetry.js.map +0 -1
  259. package/dist/scripts/banner.js +0 -29
  260. package/dist/security/guardrails.d.ts.map +0 -1
  261. package/dist/security/guardrails.js.map +0 -1
  262. package/dist/server/dashboard.d.ts.map +0 -1
  263. package/dist/server/dashboard.js.map +0 -1
  264. package/dist/server/modelMapper.d.ts.map +0 -1
  265. package/dist/server/modelMapper.js.map +0 -1
  266. package/dist/server/proxyServer.d.ts.map +0 -1
  267. package/dist/server/proxyServer.js.map +0 -1
  268. package/dist/skills/__tests__/skill_manager.test.d.ts +0 -2
  269. package/dist/skills/__tests__/skill_manager.test.d.ts.map +0 -1
  270. package/dist/skills/__tests__/skill_manager.test.js +0 -268
  271. package/dist/skills/__tests__/skill_manager.test.js.map +0 -1
  272. package/dist/tools/tmlpdTools.d.ts.map +0 -1
  273. package/dist/tools/tmlpdTools.js.map +0 -1
  274. package/dist/tui/dashboard.d.ts.map +0 -1
  275. package/dist/tui/dashboard.js.map +0 -1
  276. package/dist/tui/index.d.ts.map +0 -1
  277. package/dist/tui/index.js.map +0 -1
  278. package/dist/utils/batchProcessor.d.ts.map +0 -1
  279. package/dist/utils/batchProcessor.js.map +0 -1
  280. package/dist/utils/compression.d.ts.map +0 -1
  281. package/dist/utils/compression.js.map +0 -1
  282. package/dist/utils/costUtils.d.ts.map +0 -1
  283. package/dist/utils/costUtils.js.map +0 -1
  284. package/dist/utils/reliability.d.ts.map +0 -1
  285. package/dist/utils/reliability.js.map +0 -1
  286. package/dist/utils/sorting.d.ts.map +0 -1
  287. package/dist/utils/sorting.js.map +0 -1
  288. package/dist/utils/speculativeDecoding.d.ts.map +0 -1
  289. package/dist/utils/speculativeDecoding.js.map +0 -1
  290. package/dist/utils/tokenUtils.d.ts.map +0 -1
  291. package/dist/utils/tokenUtils.js.map +0 -1
  292. package/docs/.nojekyll +0 -0
  293. package/docs/ANALYSIS_PRINCIPLES.md +0 -162
  294. package/docs/API.md +0 -855
  295. package/docs/ARCHITECTURAL-IMPROVEMENTS-2025.md +0 -1391
  296. package/docs/ARCHITECTURAL-IMPROVEMENTS-REVISED-2025.md +0 -1051
  297. package/docs/BENCHMARK.md +0 -170
  298. package/docs/CHINESE_PROVIDER_RELIABILITY.md +0 -37
  299. package/docs/CITATIONS.md +0 -74
  300. package/docs/CLAIMS_AND_EVIDENCE.md +0 -58
  301. package/docs/CONFIGURATION.md +0 -476
  302. package/docs/COUNCIL_DECISION.json +0 -816
  303. package/docs/COUNCIL_SUMMARY.md +0 -319
  304. package/docs/COUNCIL_V2.2_DECISION.md +0 -416
  305. package/docs/ENGINEERING_SPEC.md +0 -55
  306. package/docs/FACTORY_RESET.md +0 -34
  307. package/docs/GEO.md +0 -66
  308. package/docs/GEO_OPTIMIZATION.md +0 -30
  309. package/docs/GEO_ROOT_CAUSE.md +0 -136
  310. package/docs/GEO_STATUS.md +0 -85
  311. package/docs/GEO_TEST_RESULTS.md +0 -176
  312. package/docs/HN_CHECKLIST.md +0 -38
  313. package/docs/HN_FOUNDER_COMMENT.md +0 -17
  314. package/docs/HN_SUBMISSION_FINAL.md +0 -180
  315. package/docs/HN_SUBMISSION_V3.md +0 -56
  316. package/docs/IMPROVEMENT_ROADMAP.md +0 -515
  317. package/docs/INTEGRATIONS.md +0 -420
  318. package/docs/LANGCHAIN_INTEGRATION.md +0 -147
  319. package/docs/LLM_COUNCIL_DECISION.md +0 -508
  320. package/docs/MIDDLEWARE_CHAIN.md +0 -35
  321. package/docs/PROMO_CHECKLIST.md +0 -200
  322. package/docs/QUICKSTART.md +0 -271
  323. package/docs/QUICK_START.md +0 -43
  324. package/docs/QUICK_START_VISIBILITY.md +0 -782
  325. package/docs/REDDIT_GAP_ANALYSIS.md +0 -299
  326. package/docs/RELEASE_CHECKLIST.md +0 -32
  327. package/docs/REPRODUCIBILITY.md +0 -63
  328. package/docs/RESEARCH_BACKED_IMPROVEMENTS.md +0 -1180
  329. package/docs/ROUTING_RUBRIC.md +0 -197
  330. package/docs/SEO_AUDIT.md +0 -186
  331. package/docs/SOCIAL_LISTENING.md +0 -219
  332. package/docs/TMLPD_QNA.md +0 -751
  333. package/docs/TMLPD_V2.1_COMPLETE.md +0 -763
  334. package/docs/TMLPD_V2.2_RESEARCH_ROADMAP.md +0 -754
  335. package/docs/UPDATE_TOPICS.md +0 -15
  336. package/docs/USE_CASES.md +0 -59
  337. package/docs/V2.2_IMPLEMENTATION_COMPLETE.md +0 -446
  338. package/docs/V2_IMPLEMENTATION_GUIDE.md +0 -388
  339. package/docs/VERCEL_AI_SDK.md +0 -209
  340. package/docs/VISIBILITY_ADOPTION_PLAN.md +0 -1005
  341. package/docs/_config.yml +0 -49
  342. package/docs/ai-plugin.json +0 -16
  343. package/docs/api.html +0 -513
  344. package/docs/architecture-diagram.md +0 -40
  345. package/docs/benchmark-chart.png +0 -0
  346. package/docs/benchmark.html +0 -387
  347. package/docs/blog/routerarena-number-one.html +0 -73
  348. package/docs/cli-cheatsheet.md +0 -339
  349. package/docs/compare.md +0 -109
  350. package/docs/comparison-litellm.md +0 -88
  351. package/docs/comparison.md +0 -108
  352. package/docs/cost-chart-ascii.md +0 -42
  353. package/docs/cost-comparison-chart.svg +0 -88
  354. package/docs/curl-examples.md +0 -247
  355. package/docs/demo-auto.html +0 -264
  356. package/docs/demo.html +0 -416
  357. package/docs/geo/GENERATIVE_ENGINE_OPTIMIZATION.md +0 -232
  358. package/docs/index.html +0 -507
  359. package/docs/launch-content/LAUNCH_EXECUTION_CHECKLIST.md +0 -421
  360. package/docs/launch-content/README.md +0 -457
  361. package/docs/launch-content/assets/cost_comparison_100_tasks.png +0 -0
  362. package/docs/launch-content/assets/cumulative_savings.png +0 -0
  363. package/docs/launch-content/assets/parallel_speedup.png +0 -0
  364. package/docs/launch-content/assets/provider_pricing_comparison.png +0 -0
  365. package/docs/launch-content/assets/task_breakdown_comparison.png +0 -0
  366. package/docs/launch-content/generate_charts.py +0 -313
  367. package/docs/launch-content/hn_show_post.md +0 -139
  368. package/docs/launch-content/partner_outreach_templates.md +0 -745
  369. package/docs/launch-content/reddit_posts.md +0 -467
  370. package/docs/launch-content/twitter_thread.txt +0 -460
  371. package/docs/npm-downloads-chart.svg +0 -43
  372. package/docs/openapi.json +0 -139
  373. package/docs/openapi.yaml +0 -1318
  374. package/docs/quick-start.html +0 -366
  375. package/docs/robots.txt +0 -52
  376. package/docs/sitemap.xml +0 -57
  377. package/docs/styles.css +0 -682
  378. package/docs/well-known/ai-plugin.json +0 -16
  379. package/docs/wellknown/ai-plugin.json +0 -16
  380. package/docs-site/assets/og-banner.svg +0 -194
  381. package/docs-site/index.html +0 -632
  382. package/eval/README.md +0 -46
  383. package/eval/baselines/main.json +0 -12
  384. package/eval/benchmark_dataset.jsonl +0 -16
  385. package/eval/check_golden_routes.js +0 -64
  386. package/eval/datasets/catalog.json +0 -33
  387. package/eval/datasets/slices/cn_provider_reliability_v1.jsonl +0 -3
  388. package/eval/datasets/slices/cost_pressure_v1.jsonl +0 -3
  389. package/eval/datasets/slices/safety_guardrails_v1.jsonl +0 -3
  390. package/eval/evals.json +0 -199
  391. package/eval/fault_injection_thresholds.json +0 -3
  392. package/eval/generate_report.js +0 -128
  393. package/eval/golden_routes.json +0 -114
  394. package/eval/lib/experiment_registry.js +0 -24
  395. package/eval/run_eval.js +0 -197
  396. package/eval/run_fault_injection.js +0 -201
  397. package/eval/run_shadow_eval.js +0 -85
  398. package/eval/thresholds.json +0 -9
  399. package/examples/QUICKSTART.md +0 -183
  400. package/examples/README.md +0 -61
  401. package/examples/a3m-sdk.js +0 -124
  402. package/examples/basic-route.js +0 -54
  403. package/examples/chat-loop.js +0 -202
  404. package/examples/classify-then-route.js +0 -102
  405. package/examples/cost-compare.js +0 -120
  406. package/examples/ensemble.js +0 -160
  407. package/examples/whatsapp-telegram-bridge-demo.js +0 -302
  408. package/examples/whatsapp-telegram-bridge.js +0 -269
  409. package/hf-space/README.md +0 -23
  410. package/hf-space/app.py +0 -240
  411. package/hf-space/requirements.txt +0 -1
  412. package/huggingface_space/README.md +0 -35
  413. package/huggingface_space/app.py +0 -126
  414. package/huggingface_space/create_space.py +0 -208
  415. package/huggingface_space/requirements.txt +0 -1
  416. package/mcp-server/README.md +0 -188
  417. package/mcp-server/package.json +0 -29
  418. package/mcp-server/src/index.ts +0 -744
  419. package/mcp-server/tsconfig.json +0 -19
  420. package/openclaw-alexa-bridge/ALL_REMAINING_FIXES_PLAN.md +0 -313
  421. package/openclaw-alexa-bridge/REMAINING_FIXES_SUMMARY.md +0 -277
  422. package/openclaw-alexa-bridge/src/alexa_handler_no_tmlpd.js +0 -1234
  423. package/openclaw-alexa-bridge/test_fixes.js +0 -77
  424. package/playground/README.md +0 -51
  425. package/playground/codesandbox.json +0 -12
  426. package/playground/index.js +0 -39
  427. package/proxy/README.md +0 -227
  428. package/proxy/package-lock.json +0 -831
  429. package/proxy/package.json +0 -17
  430. package/proxy/rate-limit.js +0 -145
  431. package/proxy/rate-limit.test.js +0 -311
  432. package/proxy/server.js +0 -970
  433. package/python/README.md +0 -102
  434. package/python/a3m/__init__.py +0 -6
  435. package/python/a3m/client.py +0 -190
  436. package/python/a3m/models.py +0 -40
  437. package/python/a3m/sync_client.py +0 -61
  438. package/python/examples.py +0 -53
  439. package/python/integrations.py +0 -330
  440. package/python/pyproject.toml +0 -23
  441. package/python/setup.py +0 -28
  442. package/python/tmlpd.py +0 -369
  443. package/qna/REDDIT_GAP_ANALYSIS.md +0 -299
  444. package/qna/TMLPD_QNA.md +0 -751
  445. package/research/FINDING_001_safety.md +0 -28
  446. package/research/FINDING_002_error_diversity.md +0 -32
  447. package/research/FINDING_003_confidence_weighted_voting.md +0 -32
  448. package/research/FINDING_004_cross_model_semantic_detection.md +0 -37
  449. package/research/FINDING_005_knowledge_gap_orthogonality.md +0 -34
  450. package/research/HALLUCINATION_RESEARCH.md +0 -27
  451. package/research/ensemble-voting.md +0 -324
  452. package/research/loss-functions.md +0 -545
  453. package/research-log.md +0 -49
  454. package/scripts/banner.js +0 -29
  455. package/scripts/benchmark-local-routerarena.ts +0 -176
  456. package/scripts/benchmark.js +0 -145
  457. package/scripts/benchmark.sh +0 -61
  458. package/scripts/compare-providers.sh +0 -230
  459. package/scripts/content-planner.js +0 -25
  460. package/scripts/create-labeled-benchmark.ts +0 -105
  461. package/scripts/cross_post.py +0 -443
  462. package/scripts/local-router-benchmark.ts +0 -154
  463. package/scripts/post-all.sh +0 -41
  464. package/scripts/publish_fcc.py +0 -106
  465. package/scripts/push-to-gitee.sh +0 -25
  466. package/scripts/routerarena_ensemble.js +0 -144
  467. package/scripts/routing-benchmark-v2.js +0 -373
  468. package/scripts/routing-benchmark-v3.js +0 -118
  469. package/scripts/routing-benchmark.js +0 -462
  470. package/scripts/run-labeled-benchmark.mjs +0 -104
  471. package/scripts/run-mmlu-benchmark.js +0 -176
  472. package/scripts/run-provider-benchmark.js +0 -244
  473. package/scripts/update-npm-badges.js +0 -158
  474. package/skill/SKILL.md +0 -238
  475. package/src/__tests__/integration/tmpld_integration.test.py +0 -540
  476. package/src/skills/__tests__/skill_manager.test.ts +0 -328
  477. package/submissions/benchmarks/ALL_PLATFORMS_SUBMISSION.md +0 -94
  478. package/submissions/benchmarks/LLMROUTERBENCH_SUBMISSION.md +0 -121
  479. package/submissions/benchmarks/MMRBENCH_SUBMISSION.md +0 -94
  480. package/submissions/benchmarks/ROUTERARENA_UPDATE.md +0 -83
  481. package/submissions/benchmarks/ROUTERBENCH_SUBMISSION.md +0 -225
  482. package/test-council/1-structure-tests.test.js +0 -353
  483. package/test-council/1-structure-tests.test.ts +0 -353
  484. package/test-council/2-edge-case-tests.test.ts +0 -361
  485. package/test-council/3-performance-tests.test.ts +0 -669
  486. package/test-council/4-integration-tests.test.ts +0 -391
  487. package/test-council/5-agent-council-eval.test.ts +0 -413
  488. package/test-council/AGENT_COUNCIL_ARCHITECTURE.md +0 -349
  489. package/test-council/TEST_COUNCIL_REPORT.md +0 -201
  490. package/test-council/agents/edge-case-agent.ts +0 -363
  491. package/test-council/agents/performance-agent.ts +0 -426
  492. package/test-council/agents/structure-agent.ts +0 -227
  493. package/test-council/council.md +0 -183
  494. package/tests/__mocks__/tokenUtils.ts +0 -8
  495. package/tests/memory/episodicMemory.test.ts +0 -227
  496. package/tests/package-lock.json +0 -1628
  497. package/tests/package.json +0 -18
  498. package/tests/routing/ensembleVoting.test.ts +0 -236
  499. package/tests/routing/providerRetry.test.ts +0 -360
  500. package/tests/routing/queryTypePresets.test.ts +0 -208
  501. package/tests/security/guardrailEngine.test.ts +0 -700
  502. package/tests/tsconfig.json +0 -21
  503. package/tests/vitest.config.ts +0 -18
  504. package/tmlpd-pi-extension/README.md +0 -66
  505. package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts +0 -114
  506. package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts.map +0 -1
  507. package/tmlpd-pi-extension/dist/cache/prefixCache.js +0 -285
  508. package/tmlpd-pi-extension/dist/cache/prefixCache.js.map +0 -1
  509. package/tmlpd-pi-extension/dist/cache/responseCache.d.ts +0 -58
  510. package/tmlpd-pi-extension/dist/cache/responseCache.d.ts.map +0 -1
  511. package/tmlpd-pi-extension/dist/cache/responseCache.js +0 -153
  512. package/tmlpd-pi-extension/dist/cache/responseCache.js.map +0 -1
  513. package/tmlpd-pi-extension/dist/cli.js +0 -59
  514. package/tmlpd-pi-extension/dist/cost/costTracker.d.ts +0 -95
  515. package/tmlpd-pi-extension/dist/cost/costTracker.d.ts.map +0 -1
  516. package/tmlpd-pi-extension/dist/cost/costTracker.js +0 -240
  517. package/tmlpd-pi-extension/dist/cost/costTracker.js.map +0 -1
  518. package/tmlpd-pi-extension/dist/index.d.ts +0 -723
  519. package/tmlpd-pi-extension/dist/index.d.ts.map +0 -1
  520. package/tmlpd-pi-extension/dist/index.js +0 -239
  521. package/tmlpd-pi-extension/dist/index.js.map +0 -1
  522. package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts +0 -82
  523. package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts.map +0 -1
  524. package/tmlpd-pi-extension/dist/memory/episodicMemory.js +0 -145
  525. package/tmlpd-pi-extension/dist/memory/episodicMemory.js.map +0 -1
  526. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts +0 -102
  527. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts.map +0 -1
  528. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js +0 -207
  529. package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js.map +0 -1
  530. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts +0 -85
  531. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts.map +0 -1
  532. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js +0 -210
  533. package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js.map +0 -1
  534. package/tmlpd-pi-extension/dist/providers/localProvider.d.ts +0 -102
  535. package/tmlpd-pi-extension/dist/providers/localProvider.d.ts.map +0 -1
  536. package/tmlpd-pi-extension/dist/providers/localProvider.js +0 -338
  537. package/tmlpd-pi-extension/dist/providers/localProvider.js.map +0 -1
  538. package/tmlpd-pi-extension/dist/providers/registry.d.ts +0 -55
  539. package/tmlpd-pi-extension/dist/providers/registry.d.ts.map +0 -1
  540. package/tmlpd-pi-extension/dist/providers/registry.js +0 -138
  541. package/tmlpd-pi-extension/dist/providers/registry.js.map +0 -1
  542. package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts +0 -68
  543. package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts.map +0 -1
  544. package/tmlpd-pi-extension/dist/routing/advancedRouter.js +0 -332
  545. package/tmlpd-pi-extension/dist/routing/advancedRouter.js.map +0 -1
  546. package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts +0 -101
  547. package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts.map +0 -1
  548. package/tmlpd-pi-extension/dist/tools/tmlpdTools.js +0 -368
  549. package/tmlpd-pi-extension/dist/tools/tmlpdTools.js.map +0 -1
  550. package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts +0 -96
  551. package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts.map +0 -1
  552. package/tmlpd-pi-extension/dist/utils/batchProcessor.js +0 -170
  553. package/tmlpd-pi-extension/dist/utils/batchProcessor.js.map +0 -1
  554. package/tmlpd-pi-extension/dist/utils/compression.d.ts +0 -61
  555. package/tmlpd-pi-extension/dist/utils/compression.d.ts.map +0 -1
  556. package/tmlpd-pi-extension/dist/utils/compression.js +0 -281
  557. package/tmlpd-pi-extension/dist/utils/compression.js.map +0 -1
  558. package/tmlpd-pi-extension/dist/utils/reliability.d.ts +0 -74
  559. package/tmlpd-pi-extension/dist/utils/reliability.d.ts.map +0 -1
  560. package/tmlpd-pi-extension/dist/utils/reliability.js +0 -177
  561. package/tmlpd-pi-extension/dist/utils/reliability.js.map +0 -1
  562. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts +0 -117
  563. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts.map +0 -1
  564. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js +0 -246
  565. package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js.map +0 -1
  566. package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts +0 -50
  567. package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts.map +0 -1
  568. package/tmlpd-pi-extension/dist/utils/tokenUtils.js +0 -124
  569. package/tmlpd-pi-extension/dist/utils/tokenUtils.js.map +0 -1
  570. package/tmlpd-pi-extension/examples/QUICKSTART.md +0 -183
  571. package/tmlpd-pi-extension/package-lock.json +0 -79
  572. package/tmlpd-pi-extension/package.json +0 -172
  573. package/tmlpd-pi-extension/python/examples.py +0 -53
  574. package/tmlpd-pi-extension/python/integrations.py +0 -330
  575. package/tmlpd-pi-extension/python/setup.py +0 -28
  576. package/tmlpd-pi-extension/python/tmlpd.py +0 -369
  577. package/tmlpd-pi-extension/qna/REDDIT_GAP_ANALYSIS.md +0 -299
  578. package/tmlpd-pi-extension/qna/TMLPD_QNA.md +0 -751
  579. package/tmlpd-pi-extension/skill/SKILL.md +0 -238
  580. package/tmlpd-pi-extension/src/cache/responseCache.ts +0 -147
  581. package/tmlpd-pi-extension/src/cost/costTracker.ts +0 -302
  582. package/tmlpd-pi-extension/src/index.ts +0 -232
  583. package/tmlpd-pi-extension/src/memory/episodicMemory.ts +0 -257
  584. package/tmlpd-pi-extension/src/orchestration/haloOrchestrator.ts +0 -266
  585. package/tmlpd-pi-extension/src/orchestration/mctsWorkflow.ts +0 -262
  586. package/tmlpd-pi-extension/src/providers/localProvider.ts +0 -406
  587. package/tmlpd-pi-extension/src/providers/registry.ts +0 -164
  588. package/tmlpd-pi-extension/src/routing/ensembleVoting.ts +0 -159
  589. package/tmlpd-pi-extension/src/routing/queryTypePresets.ts +0 -136
  590. package/tmlpd-pi-extension/src/tools/tmlpdTools.ts +0 -433
  591. package/tmlpd-pi-extension/src/utils/batchProcessor.ts +0 -232
  592. package/tmlpd-pi-extension/src/utils/compression.ts +0 -325
  593. package/tmlpd-pi-extension/src/utils/reliability.ts +0 -221
  594. package/tmlpd-pi-extension/src/utils/tokenUtils.ts +0 -145
  595. package/tmlpd-pi-extension/tsconfig.json +0 -18
  596. package/tsconfig.build.json +0 -29
  597. package/tsconfig.json +0 -18
  598. /package/{docs/llms-full.txt → llms-full.txt.bak} +0 -0
@@ -1,269 +0,0 @@
1
- # Frame-by-Frame Veo 3 Prompts for A3M Router Product Video
2
- # Copy each prompt into Gemini (Pro account) with Veo 3 enabled
3
- # Generate 8-12 second clips, then stitch with ffmpeg
4
-
5
- ---
6
-
7
- ## FRAME 1: "Routing Decision" (8-12 seconds)
8
-
9
- ### Step 1: Generate still image with Nano Banana Pro
10
-
11
- Open Gemini, paste:
12
-
13
- ```
14
- Generate a photorealistic image of a developer laptop screen in a dark room.
15
- The screen shows a terminal window with dark theme (#0d1117 background).
16
- The terminal is running an LLM router called "A3M Router".
17
- Text appears showing:
18
- - Input: "What is 2+2?" in white
19
- - Routing: "→ complexity: 8/100 (TRIVIAL)" in cyan
20
- - Decision: "→ routed to: groq/llama-3.3-70b" in green (#3fb950)
21
- - Cost: "→ cost: $0.000009" in green
22
- A glowing blue (#58a6ff) routing graph appears beside the terminal showing
23
- query → [complexity analysis] → [provider selection] → response.
24
- The laptop sits on a wooden desk with warm desk lamp lighting.
25
- Shallow depth of field. 16:9 aspect ratio. Photorealistic.
26
- JetBrains Mono font on the terminal.
27
- ```
28
-
29
- ### Step 2: Animate with Veo 3
30
-
31
- Upload the generated image as reference, then paste:
32
-
33
- ```json
34
- {
35
- "shot": {
36
- "composition": "Close-up of laptop screen, 50mm lens, shallow depth of field, warm desk lamp glow on right, cool monitor light",
37
- "camera_motion": "Slow dolly in from showing the full laptop to tight on the terminal text, then subtle rack focus from the terminal to the routing graph and back",
38
- "frame_rate": "24fps",
39
- "film_grain": "very subtle, Kodak 5219 emulation"
40
- },
41
- "subject": {
42
- "description": "A developer laptop showing an AI routing tool. Terminal text types in line by line. The routing path lights up with cyan and green glows as each decision is made. The routing graph on the side pulses with blue light along the decision path.",
43
- "motion": "Text appears line by line as if typed. Routing path illuminates sequentially. Green checkmark appears beside the selected provider. Cost number counts up briefly then locks in."
44
- },
45
- "environment": {
46
- "ambient_lighting": "Warm desk lamp from upper right casting soft shadows. Cool blue monitor glow illuminating the keyboard. Subtle plant shadow in background.",
47
- "atmosphere": "Late night productive coding session. Dark room. Focused."
48
- },
49
- "audio": {
50
- "type": "Subtle keyboard typing sounds as text appears. Soft ambient lo-fi beat. Gentle confirmation chime when provider is selected.",
51
- "mood": "calm, focused, productive, efficient"
52
- }
53
- }
54
- ```
55
-
56
- ---
57
-
58
- ## FRAME 2: "Cost Savings" (8-12 seconds)
59
-
60
- ### Step 1: Still image with Nano Banana Pro
61
-
62
- ```
63
- Generate a photorealistic image of a laptop screen showing a dark-themed (#0d1117) cost comparison infographic.
64
- Title at top: "Cost Per Query" in white text.
65
- Two vertical bar charts side by side:
66
- - Left bar: Tall RED bar labeled "GPT-4 (No A3M)" showing "$0.03" at the top
67
- - Right bar: Tiny GREEN bar labeled "A3M Router" showing "$0.0004" at the top
68
- Below the bars in large bold green (#3fb950) text: "213× cheaper"
69
- The laptop is on a dark desk. Warm desk lamp.
70
- Photorealistic. 16:9. Clean, minimal, Apple-style presentation.
71
- ```
72
-
73
- ### Step 2: Animate with Veo 3
74
-
75
- ```json
76
- {
77
- "shot": {
78
- "composition": "Medium shot of laptop screen, slight angle, 65mm lens, shallow depth of field",
79
- "camera_motion": "Static for 2 seconds, then subtle tilt down to reveal the '213× cheaper' text, then hold",
80
- "frame_rate": "24fps",
81
- "film_grain": "minimal"
82
- },
83
- "subject": {
84
- "description": "A cost comparison chart on a dark screen. The red bar animates growing upward to full height with a rising red glow. Then the green bar grows to its tiny height with a satisfying green flash. The '213× cheaper' text fades in with a subtle scale animation.",
85
- "motion": "Red bar rises first with ascending motion. Brief pause. Then green bar rises quickly with a satisfying pop. '213× cheaper' text scales from 0 to 100% with a subtle bounce. Numbers count up as each bar grows."
86
- },
87
- "environment": {
88
- "ambient_lighting": "Cool monitor glow on dark desk. No warm lamp this time - pure data visualization focus.",
89
- "atmosphere": "Clean, data-driven, confident. Like a financial report reveal."
90
- },
91
- "audio": {
92
- "type": "Subtle bass hit when red bar reaches top. Higher, satisfying chime when green bar arrives. Swoosh sound as '213×' text appears.",
93
- "mood": "impactful, surprising, satisfying"
94
- }
95
- }
96
- ```
97
-
98
- ---
99
-
100
- ## FRAME 3: "Parallel Execution" (8-12 seconds)
101
-
102
- ### Step 1: Still image with Nano Banana Pro
103
-
104
- ```
105
- Generate a dark-themed (#0d1117) technical diagram on a laptop screen showing parallel LLM execution.
106
- Left side: "Your Query" in a cyan (#58a6ff) circle.
107
- Center: 5 arrows branching out rightward simultaneously to 5 provider boxes:
108
- - "Groq" with green checkmark, showing "325ms, FREE"
109
- - "Cerebras" with green checkmark, showing "180ms, FREE"
110
- - "DeepSeek" with green checkmark, showing "800ms, $0.14/1M"
111
- - "Mistral" with green checkmark, showing "1.2s, $2.00/1M"
112
- - "OpenAI" with yellow clock, showing "2.1s, $2.50/1M"
113
- Right side: "Best Response ✓" in green (#3fb950) highlighting the Groq result.
114
- Below: "Latency: 180ms (fastest provider)" in green.
115
- All 5 arrows animate simultaneously (not sequentially).
116
- Photorealistic laptop on desk. 16:9. Dark room.
117
- ```
118
-
119
- ### Step 2: Animate with Veo 3
120
-
121
- ```json
122
- {
123
- "shot": {
124
- "composition": "Overhead angle looking down at laptop screen, 35mm lens, showing the full diagram clearly",
125
- "camera_motion": "Subtle slow zoom in on the diagram as it progresses. Camera stays relatively static to not distract from the data.",
126
- "frame_rate": "24fps",
127
- "film_grain": "minimal"
128
- },
129
- "subject": {
130
- "description": "A routing diagram on a dark screen. The 'Your Query' circle pulses cyan. All 5 arrows extend outward simultaneously (not one-by-one). Each provider box lights up as the arrow reaches it with a brief flash. Then the Groq box pulses brighter with a green glow and the 'Best Response' label appears on the right.",
131
- "motion": "Query circle pulses. 5 arrows extend simultaneously left-to-right. Provider boxes illuminate as arrows arrive (Groq and Cerebras arrive first). Green highlight travels down to the selected response. '180ms' counter appears and locks."
132
- },
133
- "environment": {
134
- "ambient_lighting": "Pure monitor glow. Dark desk. Technical presentation feel.",
135
- "atmosphere": "Efficient, fast, decisive"
136
- },
137
- "audio": {
138
- "type": "Subtle electronic/tech whoosh as arrows extend. Light ping as each provider lights up. Satisfying confirmation tone when Best Response appears.",
139
- "mood": "fast, efficient, smart"
140
- }
141
- }
142
- ```
143
-
144
- ---
145
-
146
- ## FRAME 4: "40 Providers" (8-12 seconds)
147
-
148
- ### Step 1: Still image with Nano Banana Pro
149
-
150
- ```
151
- Generate a dark-themed (#0d1117) terminal window on a laptop showing a provider status table.
152
- The table has columns: Provider | Status | Cost | Latency
153
- Rows visible:
154
- ✓ groq/llama-3.3-70b FREE 325ms
155
- ✓ cerebras/llama-3.3-70b FREE 180ms
156
- ✓ deepseek/chat $0.14/1M 800ms
157
- ✓ mistral/mistral-large $2.00/1M 1.2s
158
- ✓ openai/gpt-4o $2.50/1M 2.1s
159
- ... (35 more rows visible but dimmed)
160
- All green checkmarks. Title: "40 Providers — All Online ✓"
161
- Dark room, desk lamp, MacBook. Photorealistic. 16:9.
162
- ```
163
-
164
- ### Step 2: Animate with Veo 3
165
-
166
- ```json
167
- {
168
- "shot": {
169
- "composition": "Slight angle on laptop screen, 50mm lens, showing the provider table",
170
- "camera_motion": "Camera slowly tilts down as the table scrolls, revealing more providers. Settles on the bottom showing '... 35 more' with the '40 Providers' header.",
171
- "frame_rate": "24fps",
172
- "film_grain": "subtle"
173
- },
174
- "subject": {
175
- "description": "A terminal table listing AI providers. The table appears line by line with each row. Green checkmarks appear with a brief flash next to each provider name as it loads. The status shows 'All Online'. The table scrolls down smoothly to reveal more entries.",
176
- "motion": "Table rows load one by one from top to bottom. Checkmarks flash green as each appears. Subtle pulse on the 'All Online ✓' badge. Smooth scroll down revealing more providers."
177
- },
178
- "environment": {
179
- "ambient_lighting": "Warm desk lamp from side. Cool monitor glow.",
180
- "atmosphere": "Impressive scale. Professional. Technical."
181
- },
182
- "audio": {
183
- "type": "Subtle ticking/click sound as each row loads. Soft ambient hum. Final satisfying chord when full table is visible.",
184
- "mood": "impressive, professional, comprehensive"
185
- }
186
- }
187
- ```
188
-
189
- ---
190
-
191
- ## FRAME 5: "End Card" (8-12 seconds)
192
-
193
- ### Step 1: Still image with Nano Banana Pro
194
-
195
- ```
196
- Generate a dark-themed (#0d1117) product card on a laptop screen.
197
- Center: "A3M Router" in large white bold text with a subtle blue (#58a6ff) glow.
198
- Below in smaller text: "#1 on RouterArena · 213× cheaper than GPT-5 · 40 providers"
199
- Below that in a terminal-style box: "$ npm install adaptive-memory-multi-model-router"
200
- Bottom: GitHub logo and npm logo side by side.
201
- Very clean, minimal, dark. Apple-style presentation.
202
- Photorealistic laptop on dark desk. 16:9.
203
- ```
204
-
205
- ### Step 2: Animate with Veo 3
206
-
207
- ```json
208
- {
209
- "shot": {
210
- "composition": "Centered view of laptop screen, 50mm lens, clean and symmetrical",
211
- "camera_motion": "Camera slowly pushes in on the center text, creating a subtle zoom that focuses attention on the npm install command at the end",
212
- "frame_rate": "24fps",
213
- "film_grain": "very subtle"
214
- },
215
- "subject": {
216
- "description": "A clean dark product card. The 'A3M Router' title fades in first with a subtle glow. Then the tagline '#1 on RouterArena · 213× cheaper · 40 providers' appears below with a brief typewriter effect. Finally the npm install command types out character by character with a blinking cursor. GitHub and npm logos fade in at bottom.",
217
- "motion": "Title fades in with glow. Tagline types line by line. npm command types character by character. Cursor blinks at the end. Subtle continuous blue glow on the title."
218
- },
219
- "environment": {
220
- "ambient_lighting": "Pure monitor glow on a dark desk. Cinematic. Clean.",
221
- "atmosphere": "Confident, final, memorable"
222
- },
223
- "audio": {
224
- "type": "Soft ambient synth pad. Subtle typing sounds as npm command appears. Final soft confirmation tone.",
225
- "mood": "confident, complete, memorable"
226
- }
227
- }
228
- ```
229
-
230
- ---
231
-
232
- ## STITCH ALL 5 CLIPS (run after generating all 5 videos)
233
-
234
- ```bash
235
- # Download all 5 clips from Gemini/Veo to the demo/ folder
236
- # Naming: frame1-routing.mp4, frame2-cost.mp4, frame3-parallel.mp4, frame4-providers.mp4, frame5-endcard.mp4
237
-
238
- # Create concat file
239
- cat > demo/clips.txt << EOF
240
- file 'frame1-routing.mp4'
241
- file 'frame2-cost.mp4'
242
- file 'frame3-parallel.mp4'
243
- file 'frame4-providers.mp4'
244
- file 'frame5-endcard.mp4'
245
- EOF
246
-
247
- # Stitch all clips
248
- ffmpeg -f concat -safe 0 -i demo/clips.txt \
249
- -c:v libx264 -preset slow -crf 18 \
250
- -pix_fmt yuv420p -movflags +faststart \
251
- assets/a3m-product-demo.mp4
252
-
253
- # Generate GIF version (for Twitter/GitHub)
254
- ffmpeg -i assets/a3m-product-demo.mp4 \
255
- -vf "fps=15,scale=900:-1:flags=lanczos,split[s0][s1];[s0]palette=max_colors=128:stats_mode=diff[p];[s1][p]histogram=th=0.001" \
256
- -loop 0 \
257
- assets/a3m-product-demo.gif
258
-
259
- # Generate 30-second clip for ProductHunt
260
- ffmpeg -i assets/a3m-product-demo.mp4 -t 30 \
261
- -c:v libx264 -preset slow -crf 20 \
262
- -pix_fmt yuv420p -movflags +faststart \
263
- assets/a3m-ph-30s.mp4
264
-
265
- echo "✅ All videos generated!"
266
- echo " Full demo: assets/a3m-product-demo.mp4"
267
- echo " GIF: assets/a3m-product-demo.gif"
268
- echo " PH clip: assets/a3m-ph-30s.mp4"
269
- ```
@@ -1,333 +0,0 @@
1
- # A3M Router — Video Production Guide
2
- # Using: Nano Banana Pro (Google) + Veo 3 (Google Pro) + Asciinema + FFmpeg
3
-
4
- ## AVAILABLE TOOLS (you have Google Pro access)
5
-
6
- | Tool | What it does | Access |
7
- |------|-------------|--------|
8
- | **Nano Banana Pro** | Google's image gen (in Gemini) | ✅ Google Pro |
9
- | **Veo 3 / Veo 3.1** | Google's video gen (in Gemini) | ✅ Google Pro |
10
- | **Kling 2.1 / 3** | Video gen with start/end frames | Free tier |
11
- | **Hailuo 2** | Video generation | Free tier |
12
- | **asciinema** | Terminal recording | `brew install asciinema` |
13
- | **VHS** | Terminal recording → GIF | `brew install vhs` |
14
- | **ffmpeg** | Video stitching, conversion | Already installed ✅ |
15
- | **ElevenLabs** | Voiceover / music | Free tier |
16
-
17
- ---
18
-
19
- ## VIDEO 1: Terminal Demo (60s, for HN/GitHub README)
20
-
21
- ### METHOD A: Asciinema (recommended for HN)
22
-
23
- ```bash
24
- # 1. Install asciinema
25
- brew install asciinema
26
-
27
- # 2. Record the demo
28
- asciinema rec -c "bash demo/asciinema-demo.sh" demo/recording.cast
29
-
30
- # 3. Upload to asciinema.org (auto-embeds in HN comments)
31
- asciinema upload demo/recording.cast
32
- # → Returns URL like https://asciinema.org/a/ABC123
33
-
34
- # 4. Convert to GIF (for README)
35
- pip3 install agg
36
- agg demo/recording.cast assets/demo-hn.gif
37
-
38
- # OR install agg via cargo:
39
- cargo install agg
40
- agg --theme demo/recording.cast assets/demo-hn.gif
41
- ```
42
-
43
- ### METHOD B: VHS (GIF only, no asciinema needed)
44
-
45
- ```bash
46
- # 1. Install VHS
47
- brew install vhs
48
-
49
- # 2. Record from tape file
50
- vhs demo/demo-hn.tape
51
- # → outputs to assets/demo-hn.gif
52
- ```
53
-
54
- ### Embed in HN post:
55
- ```
56
- Asciinema: https://asciinema.org/a/YOUR_CAST_ID
57
- GIF for README: ![demo](assets/demo-hn.gif)
58
- ```
59
-
60
- ---
61
-
62
- ## VIDEO 2: Product Demo Video (60s, for ProductHunt + Twitter)
63
-
64
- ### Pipeline: Nano Banana Pro → Veo 3 → FFmpeg
65
-
66
- ### STEP 1: Generate key frames with Nano Banana Pro
67
-
68
- Open Gemini (you have Pro access) and use this system prompt:
69
-
70
- ```
71
- You are generating product showcase frames for a developer tool called A3M Router.
72
-
73
- For each scene, create a photorealistic image using these specifications:
74
- - Dark theme (#0d1117 background)
75
- - Terminal/IDE aesthetic
76
- - Screen-recording style, like a modern developer setup
77
- - JetBrains Mono font, macOS-style window chrome
78
- - Subtle green (#3fb950) and blue (#58a6ff) accents
79
- - Clean, minimal, Apple-style product photography feel
80
-
81
- Generate these 5 frames:
82
- ```
83
-
84
- Then generate each frame:
85
-
86
- **Frame 1: "Routing Decision" (0-12s)**
87
- ```
88
- Nano Banana Pro prompt:
89
- A developer laptop screen showing a terminal. The terminal shows:
90
- Lines of code being routed to different AI models.
91
- Left side: input queries in white text.
92
- Right side: provider names lighting up in green (Groq, DeepSeek, OpenAI).
93
- Center: a routing decision tree glowing with blue nodes.
94
- Dark background (#0d1117), JetBrains Mono font.
95
- Photorealistic screen recording, 16:9, shallow depth of field.
96
- ```
97
-
98
- **Frame 2: "Cost Savings" (12-24s)**
99
- ```
100
- Nano Banana Pro prompt:
101
- A clean dark-themed infographic on a laptop screen.
102
- Title: "Cost Comparison" in white text.
103
- Two bar charts side by side:
104
- Left: "Without A3M" showing a tall red bar ($0.03/query)
105
- Right: "With A3M" showing a tiny green bar ($0.0004/query)
106
- Below: "213× cheaper" in large bold green text.
107
- Background: #0d1117. Font: JetBrains Mono. Photorealistic, 16:9.
108
- ```
109
-
110
- **Frame 3: "Parallel Execution" (24-36s)**
111
- ```
112
- Nano Banana Pro prompt:
113
- A diagram on a dark terminal screen showing parallel LLM execution.
114
- Left: "Your Query" in a blue circle.
115
- Center: 5 arrows splitting out simultaneously to 5 provider boxes (Groq, Cerebras, DeepSeek, Mistral, OpenAI) — all lighting up at once.
116
- Right: "Best Response" selected with a green checkmark.
117
- Below: "Latency: 138ms" in green text.
118
- Background #0d1117, JetBrains Mono, photorealistic, 16:9.
119
- ```
120
-
121
- **Frame 4: "40 Providers" (36-48s)**
122
- ```
123
- Nano Banana Pro prompt:
124
- A terminal window on a dark themed screen showing a table of providers.
125
- Rows: "groq/llama-3.3-70b ✓ FREE 325ms", "cerebras/llama-3.3-70b ✓ FREE 180ms", "deepseek/chat ✓ $0.14/1M 800ms", "mistral/mistral-large ✓ $2.00/1M 1.2s", "openai/gpt-4o ✓ $2.50/1M 2.1s"
126
- ... 35 more rows dimmed below.
127
- Green checkmarks next to each. Status: all online.
128
- Background #0d1117, photorealistic, 16:9.
129
- ```
130
-
131
- **Frame 5: "End Card" (48-60s)**
132
- ```
133
- Nano Banana Pro prompt:
134
- A dark product card on a #0d1117 background.
135
- Center: "A3M Router" in large white bold text.
136
- Below: "#1 on RouterArena · 213× cheaper than GPT-5 · 40 providers"
137
- Bottom: "npm install adaptive-memory-multi-model-router"
138
- GitHub logo and npm logo at the bottom.
139
- Clean, minimal, photorealistic, 16:9.
140
- ```
141
-
142
- ### STEP 2: Animate frames into video with Veo 3
143
-
144
- For each frame, open Gemini and use Veo 3 to generate 8-12 second video clips:
145
-
146
- ```
147
- Veo 3 prompt (for each frame):
148
- {
149
- "shot": {
150
- "composition": "Close-up of laptop screen, 85mm lens, shallow depth of field, cinematic product showcase",
151
- "camera_motion": "Slow dolly in from wide to tight on the terminal output, then subtle pan across the data",
152
- "frame_rate": "24fps",
153
- "film_grain": "very subtle, Kodak 5219 emulation"
154
- },
155
- "subject": {
156
- "description": "A developer's laptop screen displaying an AI routing tool. The terminal shows queries being routed to different providers with green confirmation checkmarks appearing. Clean dark theme UI.",
157
- "motion": "Text appears line by line as if being typed. Data highlights pulse briefly. Provider names light up sequentially with green glow."
158
- },
159
- "environment": {
160
- "ambient_lighting": "Warm desk lamp from the right, cool monitor glow from the screen. Subtle desk plant shadow in background.",
161
- "atmosphere": "Late night coding session. Dark room with focused monitor light."
162
- },
163
- "audio": {
164
- "type": "subtle keyboard typing sounds, gentle ambient lo-fi beat",
165
- "mood": "calm, focused, productive"
166
- }
167
- }
168
- ```
169
-
170
- **Specific Veo 3 prompts per frame:**
171
-
172
- Frame 1 → Veo 3: Camera slowly zooms in on the terminal as routing decisions light up
173
- Frame 2 → Veo 3: The red bar animates growing tall, then the green bar grows to show savings, "213×" text zooms in
174
- Frame 3 → Veo 3: Arrows animate out from center simultaneously, providers light up at the same time, best response pulses green
175
- Frame 4 → Veo 3: Table scrolls down showing all providers, checkmarks appear one by one with subtle sound
176
- Frame 5 → Veo 3: Text fades in line by line, minimal and clean, npm command types out character by character
177
-
178
- ### STEP 3: Stitch with FFmpeg
179
-
180
- ```bash
181
- # Concatenate all clips
182
- ffmpeg -i frame1.mp4 -i frame2.mp4 -i frame3.mp4 -i frame4.mp4 -i frame5.mp4 \
183
- -filter_complex "[0:v][1:v][2:v][3:v][4:v]concat=n=5:v=1:a=0[outv]" \
184
- -map "[outv]" \
185
- -c:v libx264 -preset slow -crf 18 \
186
- -pix_fmt yuv420p \
187
- assets/a3m-product-demo.mp4
188
-
189
- # Generate GIF version for Twitter
190
- ffmpeg -i assets/a3m-product-demo.mp4 \
191
- -vf "fps=15,scale=900:-1:flags=lanczos,split[s0][s1];[s0]palette[p];[s1][p]histogram=th=0.001" \
192
- assets/a3m-product-demo.gif
193
-
194
- # Generate short clip for PH (30s)
195
- ffmpeg -i assets/a3m-product-demo.mp4 -t 30 \
196
- -c:v libx264 -preset slow -crf 20 \
197
- assets/a3m-ph-30s.mp4
198
- ```
199
-
200
- ### STEP 4: (Optional) Add voiceover with ElevenLabs
201
-
202
- ```bash
203
- # Script for voiceover (60 seconds):
204
- # "Every LLM router does the same thing. Try provider A. If it fails, try B.
205
- # That's sequential. And slow. A3M Router is different. It fires all providers
206
- # at the same time. Scores the responses. Returns the best one.
207
- # The result? 213 times cheaper than GPT-5. Number one on RouterArena.
208
- # 40 providers. Zero ML. Three megabyte install.
209
- # npm install adaptive-memory-multi-model-router."
210
- ```
211
-
212
- ---
213
-
214
- ## VIDEO 3: 30-Second Social Clip (Twitter/X, LinkedIn)
215
-
216
- ### Quick pipeline using existing assets
217
-
218
- ```bash
219
- # Take the animated SVG and convert to MP4
220
- ffmpeg -loop 1 -i assets/hero-diagram.svg \
221
- -vf "scale=1200:675,format=yuv420p" \
222
- -t 30 -r 30 \
223
- -c:v libx264 -preset fast -crf 23 \
224
- assets/social-30s.mp4
225
- ```
226
-
227
- Or use Veo 3 with a single frame:
228
- ```
229
- Veo 3 prompt:
230
- Single dark-themed product card showing "A3M Router - #1 on RouterArena".
231
- Camera slowly pushes in. Text animates in.
232
- "npm install adaptive-memory-multi-model-router" types out at bottom.
233
- 30 seconds. Dark theme. Clean. Minimal.
234
- ```
235
-
236
- ---
237
-
238
- ## VIDEO 4: YouTube Walkthrough (3 min, for ProductHunt + README)
239
-
240
- ### Record with asciinema + screen recording
241
-
242
- ```bash
243
- # Option 1: Full asciinema recording (3 min)
244
- asciinema rec demo/youtube-walkthrough.cast
245
-
246
- # In the recording:
247
- # 0:00-0:20 - Install and intro
248
- # 0:20-1:00 - Route queries (simple, code, complex)
249
- # 1:00-1:40 - Show cost comparison, benchmark data
250
- # 1:40-2:20 - Start proxy, show OpenAI compatibility
251
- # 2:20-3:00 - Show providers, circuit breaker, cache
252
-
253
- # Option 2: Use QuickTime screen recording
254
- # Open QuickTime → File → New Screen Recording → Select terminal area
255
- # Run: bash demo/asciinema-demo.sh
256
- # Record for 3 minutes
257
- # Export as demo/youtube-walkthrough.mov
258
- # Convert: ffmpeg -i youtube-walkthrough.mov -c:v libx264 -crf 18 assets/youtube-walkthrough.mp4
259
- ```
260
-
261
- ---
262
-
263
- ## POSTING GUIDE
264
-
265
- ### Hacker News
266
- - Embed asciinema link directly in Show HN text
267
- - Also add GIF to GitHub README
268
- - HN doesn't support embedded video — asciinema is the best format
269
-
270
- ### ProductHunt
271
- - Upload the 60s product demo video (MP4, under 100MB)
272
- - Also add the 30s clip as a secondary gallery item
273
- - Thumbnail: Frame 5 (end card) as 1200×675 PNG
274
-
275
- ### Twitter/X
276
- - Upload the 30s clip as native video
277
- - Or post the 60s demo as a thread with GIF
278
- - Quote tweet yourself with the YouTube walkthrough
279
-
280
- ### README.md
281
- - Add demo GIF at the very top (before the install command)
282
- - Add asciinema embed below
283
- - Add YouTube link in the badges section
284
-
285
- ---
286
-
287
- ## QUICK START (fastest path to video)
288
-
289
- ### 60-second terminal demo (5 minutes):
290
-
291
- ```bash
292
- # 1. Install asciinema
293
- brew install asciinema
294
-
295
- # 2. Record
296
- asciinema rec -c "bash demo/asciinema-demo.sh" demo/recording.cast
297
-
298
- # 3. Upload (for HN embed)
299
- asciinema upload demo/recording.cast
300
-
301
- # 4. Convert to GIF (for README)
302
- pip3 install agg
303
- agg demo/recording.cast assets/demo-hn.gif
304
- ```
305
-
306
- ### 60-second product video (30 minutes):
307
-
308
- 1. Open Gemini with Pro access
309
- 2. Generate 5 frames using the Nano Banana Pro prompts above
310
- 3. Use Veo 3 to animate each frame (8-12s each)
311
- 4. Download all 5 clips
312
- 5. Stitch with ffmpeg:
313
- ```bash
314
- ffmpeg -i clip1.mp4 -i clip2.mp4 -i clip3.mp4 -i clip4.mp4 -i clip5.mp4 \
315
- -filter_complex "[0:v][1:v][2:v][3:v][4:v]concat=n=5:v=1:a=0" \
316
- -c:v libx264 -crf 18 assets/a3m-product-demo.mp4
317
- ```
318
-
319
- ---
320
-
321
- ## CHECKLIST
322
-
323
- - [ ] Terminal demo: `asciinema rec -c "bash demo/asciinema-demo.sh" demo/recording.cast`
324
- - [ ] Upload asciinema: `asciinema upload demo/recording.cast`
325
- - [ ] Convert to GIF: `agg demo/recording.cast assets/demo-hn.gif`
326
- - [ ] Generate 5 product frames in Nano Banana Pro (Gemini)
327
- - [ ] Animate 5 clips in Veo 3 (Gemini Pro)
328
- - [ ] Stitch clips with ffmpeg
329
- - [ ] Add GIF to README.md hero section
330
- - [ ] Add asciinema link to HN post
331
- - [ ] Upload product video to ProductHunt
332
- - [ ] Upload 30s clip to Twitter
333
- - [ ] Record 3-min YouTube walkthrough
Binary file