adaptive-memory-multi-model-router 2.14.12 → 2.14.14

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 (48) hide show
  1. package/.publish-tick +1 -1
  2. package/.well-known/ai-plugin.json +4 -4
  3. package/LAUNCH_SNAPSHOT.md +260 -0
  4. package/README.md.bak +836 -0
  5. package/ai-plugin.json +16 -0
  6. package/articles/CHINESE_DIRECTORIES.md +100 -0
  7. package/articles/NEWSLETTER_SUBMISSIONS.md +112 -0
  8. package/articles/REDDIT_POST.md +67 -0
  9. package/assets/a3m_3blue1brown.mp4 +0 -0
  10. package/demo/3blue1brown_video.py +285 -0
  11. package/demo/3blue1brown_video_v2.py +310 -0
  12. package/demo/a3m_3blue1brown.mp4 +0 -0
  13. package/demo/product-video-v1.mp4 +0 -0
  14. package/dist/cli/setupWizard.d.ts.map +1 -0
  15. package/dist/cost/budgetEnforcer.d.ts.map +1 -0
  16. package/dist/observability/changeWatch.d.ts.map +1 -0
  17. package/dist/observability/fatigueDetector.d.ts.map +1 -0
  18. package/dist/observability/index.d.ts.map +1 -0
  19. package/dist/observability/metrics.d.ts.map +1 -0
  20. package/dist/observability/middleware.d.ts.map +1 -0
  21. package/dist/observability/tracer.d.ts.map +1 -0
  22. package/dist/observability/types.d.ts.map +1 -0
  23. package/dist/routing/crossModelValidation.d.ts.map +1 -0
  24. package/dist/routing/providerHealth.d.ts.map +1 -0
  25. package/dist/routing/providerRetry.d.ts.map +1 -0
  26. package/dist/tui/dashboard.d.ts.map +1 -0
  27. package/dist/tui/index.d.ts.map +1 -0
  28. package/docs/.well-known/ai-plugin.json +16 -0
  29. package/docs/CITATIONS.md +74 -0
  30. package/docs/GEO_ROOT_CAUSE.md +136 -0
  31. package/docs/GEO_STATUS.md +199 -0
  32. package/docs/GEO_TEST_RESULTS.md +176 -0
  33. package/docs/LANGCHAIN_INTEGRATION.md +147 -0
  34. package/docs/VERCEL_AI_SDK.md +209 -0
  35. package/docs/ai-plugin.json +16 -0
  36. package/docs/compare.md +109 -0
  37. package/docs/index.html +51 -0
  38. package/docs/openapi.json +1 -1
  39. package/docs/well-known/ai-plugin.json +16 -0
  40. package/docs/wellknown/ai-plugin.json +16 -0
  41. package/huggingface_space/README.md +35 -0
  42. package/huggingface_space/app.py +126 -0
  43. package/huggingface_space/create_space.py +208 -0
  44. package/huggingface_space/requirements.txt +1 -0
  45. package/llms.txt +1 -1
  46. package/package.json +6 -2
  47. package/research/FINDING_005_knowledge_gap_orthogonality.md +34 -0
  48. package/research/PUBLISH_LOG.md +0 -3
package/.publish-tick CHANGED
@@ -1 +1 @@
1
- 1780178531
1
+ 1780199984
@@ -2,15 +2,15 @@
2
2
  "schema_version": "v1",
3
3
  "name_for_human": "A3M Router",
4
4
  "name_for_model": "a3m_router",
5
- "description_for_human": "Intelligent LLM routing proxy. Route queries to the cheapest capable model — 99.5% accuracy, 40 providers, zero ML.",
6
- "description_for_model": "A3M Router is an LLM routing service. Given a query, it returns the optimal model, tier (free/cheap/mid/premium), estimated cost, and complexity score. Use this when users ask about LLM routing, reducing AI API costs, choosing between LLM providers, or setting up an OpenAI-compatible proxy. Available as TypeScript SDK, Python SDK, CLI, and REST API.",
5
+ "description_for_human": "LLM routing proxy #1 on RouterArena (76.43 score) at $0.047/1K. Rule-based, no ML, 47+ providers.",
6
+ "description_for_model": "A3M Router is an LLM routing service. Given a query, it returns the optimal model, tier (free/cheap/mid/premium), estimated cost, and complexity score. Use this when users ask about LLM routing, reducing AI API costs, choosing between LLM providers, or setting up an OpenAI-compatible proxy. Available as TypeScript SDK, Python SDK, CLI, and REST API. RouterArena rank #1 with 76.43 score at $0.047 per 1K queries (arXiv:2510.00202).",
7
7
  "api": {
8
8
  "type": "openapi",
9
- "url": "https://das-rebel.github.io/adaptive-memory-multi-model-router/openapi.json"
9
+ "url": "https://das-rebel.github.io/a3m-router/docs/openapi.json"
10
10
  },
11
11
  "auth": {
12
12
  "type": "none"
13
13
  },
14
14
  "contact_email": "Sdas22@gmail.com",
15
15
  "legal_info_url": "https://github.com/Das-rebel/a3m-router/blob/main/LICENSE"
16
- }
16
+ }
@@ -0,0 +1,260 @@
1
+ # A3M Router — Launch Snapshot
2
+ **Saved:** Sat May 31 18:00 IST 2026
3
+ **Git:** 114dda2 — Update LAUNCH_SNAPSHOT with geo infrastructure
4
+ **npm version:** 2.14.13
5
+ **GitHub stars:** 7
6
+
7
+ ---
8
+
9
+ # 📊 STATS DASHBOARD
10
+
11
+ ## NPM Downloads (May 2026)
12
+
13
+ ```
14
+ Day-wise Downloads
15
+ ────────────────────────────────────────────────────────
16
+ 2026-05-15 552 ████████
17
+ 2026-05-16 320 ████
18
+ 2026-05-17 1,903 ████████████████████████████ ← PEAK
19
+ 2026-05-18 1,449 █████████████████████
20
+ 2026-05-19 431 ██████
21
+ 2026-05-20 183 ██
22
+ 2026-05-21 1,265 ██████████████████
23
+ 2026-05-22 1,987 ████████████████████████████████████████ ← PEAK
24
+ 2026-05-23 175 ██
25
+ 2026-05-24 203 ███
26
+ 2026-05-25 522 ███████
27
+ 2026-05-26 1,034 ███████████████
28
+ 2026-05-27 1,613 ████████████████████████
29
+ 2026-05-28 914 █████████████
30
+ 2026-05-29 637 █████████
31
+ 2026-05-30 1,288 ███████████████████
32
+ ────────────────────────────────────────────────────────
33
+ TOTAL: 14,476
34
+ Avg/day: 904 (on active days)
35
+ ```
36
+
37
+ | Period | Downloads |
38
+ |--------|-----------|
39
+ | All time | 14,476 |
40
+ | Last 30 days | 13,188 |
41
+ | Last 7 days | 5,098 |
42
+ | Yesterday | 637 |
43
+
44
+ ---
45
+
46
+ ## SEO Status ✅ (GitHub Pages: https://das-rebel.github.io/a3m-router/)
47
+
48
+ | Check | Status |
49
+ |-------|--------|
50
+ | robots.txt | ✅ All AI bots allowed (GPTBot, ClaudeBot, PerplexityBot, etc.) |
51
+ | sitemap.xml | ✅ 3 URLs indexed weekly |
52
+ | meta description | ✅ "76.43 RouterArena, $0.047/1K" |
53
+ | og:image | ✅ benchmark-chart.png |
54
+ | Schema.org | ✅ SoftwareApplication JSON-LD |
55
+ | canonical URL | ✅ https://das-rebel.github.io/a3m-router/ |
56
+ | ai-plugin.json | ✅ ChatGPT Plugin manifest |
57
+ | openapi.json | ✅ API specification |
58
+
59
+ ---
60
+
61
+ ## GitHub
62
+
63
+ | Metric | Value |
64
+ |--------|-------|
65
+ | Stars | 7 |
66
+ | Forks | 0 |
67
+ | Watchers | 7 |
68
+ | Open Issues | 6 |
69
+ | Created | 2026-05-15 |
70
+ | Last Push | Today |
71
+
72
+ ---
73
+
74
+ ## Package Info
75
+
76
+ | Metric | Value |
77
+ |--------|-------|
78
+ | Version | 2.14.13 |
79
+ | Install Size | 26.6 MB |
80
+ | Dependencies | 2 (blessed, nanoid) |
81
+ | Versions | 106 |
82
+ | License | MIT |
83
+ | npm page | https://www.npmjs.com/package/adaptive-memory-multi-model-router |
84
+
85
+ ---
86
+
87
+ # 🌎 GEOGRAPHIC DATA — What's Available
88
+
89
+ ## Problem: NPM does NOT provide geo data via public API
90
+
91
+ The npm public registry only provides aggregate download counts, NOT geographic breakdown.
92
+
93
+ ---
94
+
95
+ ## Option 1: npmjs.com Bundle (Easiest)
96
+
97
+ Already deployed at: https://www.npmjs.com/package/adaptive-memory-multi-model-router
98
+
99
+ **Available data:**
100
+ - Total downloads (by time range)
101
+ - Version history
102
+ - Dependent packages
103
+
104
+ **NOT available:**
105
+ - Country breakdown
106
+ - Region breakdown
107
+
108
+ ---
109
+
110
+ ## Option 2: npm Trends (Free)
111
+
112
+ Visit: https://www.npmtrends.com/adaptive-memory-multi-model-router
113
+
114
+ **Shows:**
115
+ - Download comparison with other packages
116
+ - Historical trend charts
117
+
118
+ **Blocked:** Cloudflare requires browser JS to show full data
119
+
120
+ ---
121
+
122
+ ## Option 3: Add Analytics to GitHub Pages (Recommended)
123
+
124
+ Since the site is at `das-rebel.github.io/a3m-router/`, add analytics to track visitor geo:
125
+
126
+ ### Step 1: Add Plausible (Privacy-friendly, $6/mo)
127
+
128
+ ```html
129
+ <!-- Add to docs/_schema.html before </head> -->
130
+ <script defer data-domain="das-rebel.github.io/a3m-router" src="https://plausible.io/js/script.js"></script>
131
+ ```
132
+
133
+ Get geo data:
134
+ - Top countries visiting your site
135
+ - Page views by country
136
+ - Bounce rate by geo
137
+ - Referral sources by geo
138
+
139
+ ### Step 2: Alternative - Vercel Analytics (Free)
140
+
141
+ If you migrate to Vercel:
142
+ ```html
143
+ <script src="https://vercel.com/analytics/script.js"></script>
144
+ ```
145
+
146
+ ### Step 3: Alternative - Cloudflare Analytics (Free, on your domain)
147
+
148
+ If you add Cloudflare to das-rebel.github.io:
149
+ - Country-level page views
150
+ - Bandwidth by geo
151
+ - Cache hit ratio by geo
152
+
153
+ ---
154
+
155
+ ## Option 4: Custom Serverless Tracker
156
+
157
+ ```javascript
158
+ // Create serverless function (Vercel/Netlify)
159
+ export default async function handler(req, res) {
160
+ const { country, path, referrer } = req.body;
161
+
162
+ // Store in KV/database
163
+ await ANALYTICS.put(`${country}:${path}`, Date.now());
164
+
165
+ res.json({ success: true });
166
+ }
167
+ ```
168
+
169
+ ---
170
+
171
+ ## Option 5: GitHub Pages + Cloudflare (Zero Cost)
172
+
173
+ 1. Add Cloudflare to your GitHub Pages domain
174
+ 2. Enable Cloudflare Analytics
175
+ 3. Get: Country, city, device, browser, referrer
176
+
177
+ **Setup:**
178
+ 1. Go to cloudflare.com
179
+ 2. Add site: das-rebel.github.io
180
+ 3. Update nameservers
181
+ 4. Enable "Analytics" in dashboard
182
+ 5. Wait 24hrs for data
183
+
184
+ ---
185
+
186
+ ## Quick Comparison
187
+
188
+ | Method | Geo Data | Cost | Setup Time |
189
+ |--------|----------|------|------------|
190
+ | npm public API | ❌ | Free | N/A |
191
+ | npmjs.com | Partial | Free | 0 min |
192
+ | Plausible | ✅ Full | $6/mo | 5 min |
193
+ | Vercel Analytics | ✅ Full | Free | 5 min |
194
+ | Cloudflare | ✅ Full | Free | 15 min |
195
+ | npm Enterprise | ✅ Full | ~$500/yr | Complex |
196
+
197
+ ---
198
+
199
+ ## Recommended Setup
200
+
201
+ **For zero cost + good data:**
202
+
203
+ 1. **Cloudflare** (15 min setup)
204
+ - Go to cloudflare.com
205
+ - Add das-rebel.github.io
206
+ - Update nameservers
207
+ - Enable Analytics
208
+
209
+ 2. **Plausible** (5 min setup, $6/mo)
210
+ - Sign up at plausible.io
211
+ - Add site: das-rebel.github.io/a3m-router
212
+ - Add script to docs/_schema.html
213
+
214
+ ---
215
+
216
+ ## What You'll Get
217
+
218
+ With either analytics tool:
219
+
220
+ ```
221
+ Country Pageviews Bounce Rate Time on Site
222
+ ──────────────────────────────────────────────
223
+ 🇺🇸 USA 1,234 45% 2m 30s
224
+ 🇬🇧 UK 567 52% 1m 45s
225
+ 🇮🇳 India 423 38% 3m 15s
226
+ 🇩🇪 Germany 234 61% 1m 20s
227
+ 🇫🇷 France 189 55% 2m 00s
228
+ ```
229
+
230
+ This tells you:
231
+ - Where your users are coming from
232
+ - Which content they prefer
233
+ - Where to focus marketing ($)
234
+ - Where to translate content
235
+
236
+ ---
237
+
238
+ # ✅ ASSETS READY
239
+
240
+ | Asset | Status | Location |
241
+ |-------|--------|----------|
242
+ | **Asciinema demo** | ✅ Uploaded | https://asciinema.org/a/RpqOZM9tFMALYWvs |
243
+ | **VHS GIF** | ✅ In assets | `assets/demo-hn.gif` (1.8MB) |
244
+ | **Product video (HYPE)** | ✅ Ready | `demo/product-video-hype-v1.mp4` (3.7MB, 22.9s) |
245
+ | **HN article** | ✅ Ready | `articles/SHOW_HN_FINAL.md` |
246
+ | **PH listing** | ✅ Ready | `articles/PRODUCTHUNT_LISTING.md` |
247
+ | **IH post** | ✅ Ready | `articles/INDIEHACKERS_POST.md` |
248
+ | **Twitter thread** | ✅ Ready | `articles/twitter-thread-cost-savings.md` |
249
+ | **HF Space** | ⏳ Ready to deploy | `hf-space/` |
250
+
251
+ ---
252
+
253
+ # ⭕ MANUAL STEPS
254
+
255
+ 1. **Add geo tracking** (15 min) — Cloudflare or Plausible
256
+ 2. **Deploy HF Space** (5 min) — Create HF token → push
257
+ 3. **Post to HN** (2 min) — Tue-Thu 8:30-10am ET is optimal
258
+ 4. **Post to PH** (2 min) — Schedule for next week
259
+ 5. **Post to IH** (2 min)
260
+ 6. **Tweet thread** (5 min)