adaptive-memory-multi-model-router 2.0.6 → 2.0.8

package/docs/assets/cost-comparison.svg

@@ -0,0 +1,134 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="780" height="520" viewBox="0 0 780 520">
+  <defs>
+    <linearGradient id="gpt4bar" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#f85149"/>
+      <stop offset="100%" stop-color="#da3633"/>
+    </linearGradient>
+    <linearGradient id="a3mbar" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#3fb950"/>
+      <stop offset="100%" stop-color="#238636"/>
+    </linearGradient>
+    <linearGradient id="header" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#161b22"/>
+      <stop offset="100%" stop-color="#0d1117"/>
+    </linearGradient>
+  </defs>
+  
+  <!-- Background -->
+  <rect width="780" height="520" rx="12" fill="#0d1117" stroke="#30363d" stroke-width="1"/>
+  
+  <!-- Header -->
+  <rect width="780" height="56" rx="12" fill="url(#header)"/>
+  <rect y="44" width="780" height="12" fill="url(#header)"/>
+  <text x="24" y="28" font-family="-apple-system,system-ui,sans-serif" font-size="18" fill="#c9d1d9" font-weight="700">💰 Cost Comparison</text>
+  <text x="24" y="46" font-family="-apple-system,system-ui,sans-serif" font-size="12" fill="#8b949e">10,000 queries/month · Real provider pricing · Mixed query complexity</text>
+  
+  <!-- Legend -->
+  <rect x="580" y="16" width="14" height="14" rx="3" fill="url(#gpt4bar)"/>
+  <text x="600" y="27" font-family="-apple-system,system-ui,sans-serif" font-size="12" fill="#f85149">All → GPT-4o</text>
+  <rect x="680" y="16" width="14" height="14" rx="3" fill="url(#a3mbar)"/>
+  <text x="700" y="27" font-family="-apple-system,system-ui,sans-serif" font-size="12" fill="#3fb950">A3M Routed</text>
+  
+  <!-- Chart rows -->
+  <g font-family="'SF Mono','Fira Code',monospace" font-size="12">
+    
+    <!-- Row 1: Simple Q&A -->
+    <text x="24" y="82" fill="#8b949e">Simple Q&A</text>
+    <text x="24" y="96" fill="#484f58" font-size="10">47% of traffic · "What is 2+2?"</text>
+    <rect x="140" y="78" width="200" height="20" rx="4" fill="url(#gpt4bar)" opacity="0.9">
+      <animate attributeName="width" from="0" to="200" dur="0.6s" fill="freeze"/>
+    </rect>
+    <text x="346" y="93" fill="#f85149" font-size="11">$4.94</text>
+    <rect x="140" y="100" width="2" height="14" rx="2" fill="url(#a3mbar)">
+      <animate attributeName="width" from="0" to="2" dur="0.4s" fill="freeze"/>
+    </rect>
+    <text x="148" y="112" fill="#3fb950" font-size="11">$0.00 → CommandCode (FREE)</text>
+    <text x="720" y="96" fill="#3fb950" font-weight="bold" font-size="13">100% ✓</text>
+    
+    <!-- Row 2: Code generation -->
+    <text x="24" y="148" fill="#8b949e">Code generation</text>
+    <text x="24" y="162" fill="#484f58" font-size="10">15% of traffic · "Write Python sort"</text>
+    <rect x="140" y="144" width="198" height="20" rx="4" fill="url(#gpt4bar)" opacity="0.9">
+      <animate attributeName="width" from="0" to="198" dur="0.6s" begin="0.15s" fill="freeze"/>
+    </rect>
+    <text x="344" y="159" fill="#f85149" font-size="11">$4.88</text>
+    <rect x="140" y="166" width="7" height="14" rx="2" fill="url(#a3mbar)">
+      <animate attributeName="width" from="0" to="7" dur="0.4s" begin="0.15s" fill="freeze"/>
+    </rect>
+    <text x="153" y="178" fill="#3fb950" font-size="11">$0.17 → DeepSeek v3</text>
+    <text x="720" y="162" fill="#3fb950" font-weight="bold" font-size="13">97% ✓</text>
+    
+    <!-- Row 3: Summarization -->
+    <text x="24" y="214" fill="#8b949e">Summarization</text>
+    <text x="24" y="228" fill="#484f58" font-size="10">18% of traffic · "Summarize this doc"</text>
+    <rect x="140" y="210" width="292" height="20" rx="4" fill="url(#gpt4bar)" opacity="0.9">
+      <animate attributeName="width" from="0" to="292" dur="0.6s" begin="0.3s" fill="freeze"/>
+    </rect>
+    <text x="438" y="225" fill="#f85149" font-size="11">$7.20</text>
+    <rect x="140" y="232" width="17" height="14" rx="2" fill="url(#a3mbar)">
+      <animate attributeName="width" from="0" to="17" dur="0.4s" begin="0.3s" fill="freeze"/>
+    </rect>
+    <text x="163" y="244" fill="#3fb950" font-size="11">$0.43 → GPT-4o-mini</text>
+    <text x="720" y="228" fill="#3fb950" font-weight="bold" font-size="13">94% ✓</text>
+    
+    <!-- Row 4: Complex reasoning -->
+    <text x="24" y="280" fill="#8b949e">Complex reasoning</text>
+    <text x="24" y="294" fill="#484f58" font-size="10">12% of traffic · "Analyze economics of..."</text>
+    <rect x="140" y="276" width="352" height="20" rx="4" fill="url(#gpt4bar)" opacity="0.9">
+      <animate attributeName="width" from="0" to="352" dur="0.6s" begin="0.45s" fill="freeze"/>
+    </rect>
+    <text x="498" y="291" fill="#f85149" font-size="11">$8.70</text>
+    <rect x="140" y="298" width="136" height="14" rx="2" fill="url(#a3mbar)">
+      <animate attributeName="width" from="0" to="136" dur="0.4s" begin="0.45s" fill="freeze"/>
+    </rect>
+    <text x="282" y="310" fill="#3fb950" font-size="11">$3.36 → Claude Haiku</text>
+    <text x="720" y="294" fill="#ffa657" font-weight="bold" font-size="13">61% ✓</text>
+    
+    <!-- Row 5: Expert analysis -->
+    <text x="24" y="346" fill="#8b949e">Expert analysis</text>
+    <text x="24" y="360" fill="#484f58" font-size="10">8% of traffic · "Legal contract review"</text>
+    <rect x="140" y="342" width="340" height="20" rx="4" fill="url(#gpt4bar)" opacity="0.9">
+      <animate attributeName="width" from="0" to="340" dur="0.6s" begin="0.6s" fill="freeze"/>
+    </rect>
+    <text x="486" y="357" fill="#f85149" font-size="11">$8.40</text>
+    <rect x="140" y="364" width="340" height="14" rx="2" fill="url(#a3mbar)" opacity="0.5">
+      <animate attributeName="width" from="0" to="340" dur="0.4s" begin="0.6s" fill="freeze"/>
+    </rect>
+    <text x="486" y="376" fill="#8b949e" font-size="11">$8.40 → GPT-4o (no shortcut)</text>
+    <text x="720" y="360" fill="#8b949e" font-weight="bold" font-size="13">0%</text>
+  </g>
+  
+  <!-- Divider -->
+  <line x1="24" y1="396" x2="756" y2="396" stroke="#30363d" stroke-width="1"/>
+  
+  <!-- Total -->
+  <g font-family="-apple-system,system-ui,sans-serif">
+    <text x="24" y="418" fill="#c9d1d9" font-size="16" font-weight="700">Total: 10,000 queries</text>
+    <text x="380" y="418" fill="#f85149" font-size="16" font-weight="700">$34.11/mo</text>
+    <text x="470" y="418" fill="#484f58" font-size="16">→</text>
+    <text x="498" y="418" fill="#3fb950" font-size="16" font-weight="700">$12.36/mo</text>
+    <text x="600" y="418" fill="#3fb950" font-size="20" font-weight="800">Save 64%</text>
+  </g>
+  
+  <!-- Scale projections -->
+  <g font-family="'SF Mono','Fira Code',monospace" font-size="11">
+    <text x="24" y="448" fill="#8b949e">At scale:</text>
+    <text x="24" y="468" fill="#484f58">  100K queries/mo</text>
+    <text x="200" y="468" fill="#f85149">$341</text>
+    <text x="240" y="468" fill="#484f58">→</text>
+    <text x="260" y="468" fill="#3fb950">$124</text>
+    <text x="310" y="468" fill="#3fb950">save $218/mo</text>
+    
+    <text x="420" y="468" fill="#484f58">  1M queries/mo</text>
+    <text x="580" y="468" fill="#f85149">$3,411</text>
+    <text x="630" y="468" fill="#484f58">→</text>
+    <text x="650" y="468" fill="#3fb950">$1,236</text>
+    <text x="700" y="468" fill="#3fb950">save $2,175/mo</text>
+  </g>
+  
+  <!-- Bottom note -->
+  <rect x="16" y="488" width="748" height="24" rx="4" fill="#161b22"/>
+  <text x="390" y="504" text-anchor="middle" font-family="-apple-system,system-ui,sans-serif" font-size="11" fill="#8b949e">
+    Based on real provider pricing from providerConfig.ts · RouteLLM query distribution (47% simple) · Savings vary by usage
+  </text>
+</svg>

package/docs/assets/growth-chart-animated.svg

@@ -0,0 +1,76 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="600" height="280" viewBox="0 0 600 280">
+  <style>
+    .label { font-family: 'SF Mono', monospace; font-size: 12px; fill: #8b949e; }
+    .value { font-family: 'SF Mono', monospace; font-size: 14px; font-weight: bold; }
+    .title { font-family: -apple-system, system-ui, sans-serif; font-size: 16px; fill: #c9d1d9; font-weight: 600; }
+    .subtitle { font-family: -apple-system, system-ui, sans-serif; font-size: 12px; fill: #8b949e; }
+  </style>
+  
+  <!-- Background -->
+  <rect width="600" height="280" rx="12" fill="#0d1117" stroke="#30363d" stroke-width="1"/>
+  
+  <!-- Title -->
+  <text x="300" y="30" text-anchor="middle" class="title">📈 Downloads Over 3 Days</text>
+  <text x="300" y="48" text-anchor="middle" class="subtitle">Zero marketing budget. Pure npm keyword discovery + word-of-mouth.</text>
+  
+  <!-- Chart area -->
+  <g transform="translate(80, 70)">
+    <!-- Grid lines -->
+    <line x1="0" y1="0" x2="440" y2="0" stroke="#21262d" stroke-width="1"/>
+    <line x1="0" y1="40" x2="440" y2="40" stroke="#21262d" stroke-width="1" stroke-dasharray="4"/>
+    <line x1="0" y1="80" x2="440" y2="80" stroke="#21262d" stroke-width="1" stroke-dasharray="4"/>
+    <line x1="0" y1="120" x2="440" y2="120" stroke="#21262d" stroke-width="1" stroke-dasharray="4"/>
+    <line x1="0" y1="160" x2="440" y2="160" stroke="#21262d" stroke-width="1"/>
+    
+    <!-- Y-axis labels -->
+    <text x="-10" y="4" text-anchor="end" class="label">2000</text>
+    <text x="-10" y="44" text-anchor="end" class="label">1500</text>
+    <text x="-10" y="84" text-anchor="end" class="label">1000</text>
+    <text x="-10" y="124" text-anchor="end" class="label">500</text>
+    <text x="-10" y="164" text-anchor="end" class="label">0</text>
+    
+    <!-- Area fill -->
+    <polygon points="73,116 220,134 367,8 367,160 73,160" fill="#238636" fill-opacity="0.15">
+      <animate attributeName="fill-opacity" from="0" to="0.15" dur="1s" fill="freeze"/>
+    </polygon>
+    
+    <!-- Line -->
+    <polyline points="73,116 220,134 367,8" fill="none" stroke="#3fb950" stroke-width="3" stroke-linecap="round" stroke-linejoin="round">
+      <animate attributeName="stroke-dashoffset" from="400" to="0" dur="1.5s" fill="freeze"/>
+      <set attributeName="stroke-dasharray" to="400"/>
+    </polyline>
+    
+    <!-- Data points -->
+    <circle cx="73" cy="116" r="6" fill="#0d1117" stroke="#3fb950" stroke-width="3">
+      <animate attributeName="r" from="0" to="6" dur="0.3s" begin="0.5s" fill="freeze"/>
+    </circle>
+    <circle cx="220" cy="134" r="6" fill="#0d1117" stroke="#f0883e" stroke-width="3">
+      <animate attributeName="r" from="0" to="6" dur="0.3s" begin="1s" fill="freeze"/>
+    </circle>
+    <circle cx="367" cy="8" r="6" fill="#0d1117" stroke="#3fb950" stroke-width="3">
+      <animate attributeName="r" from="0" to="6" dur="0.3s" begin="1.5s" fill="freeze"/>
+    </circle>
+    
+    <!-- Value labels -->
+    <text x="73" y="106" text-anchor="middle" class="value" fill="#c9d1d9">552</text>
+    <text x="220" y="152" text-anchor="middle" class="value" fill="#f0883e">320</text>
+    <text x="367" y="-4" text-anchor="middle" class="value" fill="#3fb950">1,903</text>
+    
+    <!-- X-axis labels -->
+    <text x="73" y="180" text-anchor="middle" class="label">Day 1</text>
+    <text x="73" y="194" text-anchor="middle" class="subtitle">May 15</text>
+    <text x="220" y="180" text-anchor="middle" class="label">Day 2</text>
+    <text x="220" y="194" text-anchor="middle" class="subtitle">May 16</text>
+    <text x="367" y="180" text-anchor="middle" class="label">Day 3</text>
+    <text x="367" y="194" text-anchor="middle" class="subtitle">May 17</text>
+    
+    <!-- Annotations -->
+    <text x="147" y="105" text-anchor="middle" class="subtitle" fill="#f0883e">-42%</text>
+    <text x="293" y="60" text-anchor="middle" class="subtitle" fill="#3fb950">+495%</text>
+  </g>
+  
+  <!-- Bottom stats -->
+  <text x="150" y="270" text-anchor="middle" class="value" fill="#3fb950">2,775 total</text>
+  <text x="300" y="270" text-anchor="middle" class="value" fill="#79c0ff">245% growth</text>
+  <text x="450" y="270" text-anchor="middle" class="value" fill="#d2a8ff">$0 budget</text>
+</svg>

package/docs/assets/og-banner.svg

@@ -0,0 +1,194 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630" width="1200" height="630">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0d1117"/>
+      <stop offset="40%" style="stop-color:#101822"/>
+      <stop offset="100%" style="stop-color:#0d1117"/>
+    </linearGradient>
+    <linearGradient id="accentGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#58a6ff"/>
+      <stop offset="50%" style="stop-color:#a78bfa"/>
+      <stop offset="100%" style="stop-color:#2ea043"/>
+    </linearGradient>
+    <linearGradient id="greenPill" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#238636"/>
+      <stop offset="100%" style="stop-color:#2ea043"/>
+    </linearGradient>
+    <linearGradient id="bluePill" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#1f6feb"/>
+      <stop offset="100%" style="stop-color:#58a6ff"/>
+    </linearGradient>
+    <linearGradient id="purplePill" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#7c3aed"/>
+      <stop offset="100%" style="stop-color:#a78bfa"/>
+    </linearGradient>
+    <linearGradient id="growthArrow" x1="0%" y1="100%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#238636"/>
+      <stop offset="100%" style="stop-color:#2ea043"/>
+    </linearGradient>
+    <filter id="glow">
+      <feGaussianBlur stdDeviation="4" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <filter id="cardShadow" x="-5%" y="-5%" width="110%" height="115%">
+      <feDropShadow dx="0" dy="3" stdDeviation="6" flood-color="#000000" flood-opacity="0.4"/>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="630" fill="url(#bgGrad)"/>
+
+  <!-- Decorative grid -->
+  <g opacity="0.025">
+    <line x1="0" y1="0" x2="1200" y2="630" stroke="#58a6ff" stroke-width="1"/>
+    <line x1="1200" y1="0" x2="0" y2="630" stroke="#58a6ff" stroke-width="1"/>
+    <circle cx="600" cy="315" r="180" fill="none" stroke="#58a6ff" stroke-width="0.5"/>
+    <circle cx="600" cy="315" r="300" fill="none" stroke="#58a6ff" stroke-width="0.5"/>
+  </g>
+
+  <!-- Top accent line -->
+  <rect x="0" y="0" width="1200" height="4" fill="url(#accentGrad)"/>
+  <!-- Left accent line -->
+  <rect x="0" y="0" width="4" height="630" fill="url(#accentGrad)" opacity="0.6"/>
+
+  <!-- Shuffle emoji -->
+  <text x="90" y="108" font-size="56" opacity="0.85">🔀</text>
+
+  <!-- Main title -->
+  <text x="160" y="100" font-family="'SF Pro Display', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="64" font-weight="800" fill="url(#accentGrad)" filter="url(#glow)">
+    A3M Router
+  </text>
+
+  <!-- Tagline -->
+  <text x="90" y="145" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="22" fill="#8b949e" font-weight="400">
+    Intelligent LLM routing · Drop-in OpenAI-compatible proxy
+  </text>
+
+  <!-- Day-by-day breakdown section -->
+  <g transform="translate(90, 185)">
+    <!-- Section label -->
+    <text x="0" y="12" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" fill="#484f58" font-weight="600" letter-spacing="2">
+      LAUNCH TRAJECTORY
+    </text>
+
+    <!-- Day cards -->
+    <!-- Day 1 -->
+    <g filter="url(#cardShadow)">
+      <rect x="0" y="30" width="300" height="100" rx="12" fill="#161b22" stroke="#30363d" stroke-width="1.5"/>
+      <rect x="0" y="30" width="300" height="3" rx="1.5" fill="url(#greenPill)"/>
+      <text x="24" y="68" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58" font-weight="600">DAY 1</text>
+      <text x="24" y="110" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="40" font-weight="800" fill="#2ea043">552</text>
+      <text x="160" y="110" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58">downloads</text>
+    </g>
+
+    <!-- Arrow between Day 1 and Day 2 -->
+    <g transform="translate(316, 60)">
+      <polygon points="0,20 16,35 0,50" fill="#30363d"/>
+    </g>
+
+    <!-- Day 2 -->
+    <g filter="url(#cardShadow)">
+      <rect x="345" y="30" width="300" height="100" rx="12" fill="#161b22" stroke="#30363d" stroke-width="1.5"/>
+      <rect x="345" y="30" width="300" height="3" rx="1.5" fill="url(#bluePill)"/>
+      <text x="369" y="68" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58" font-weight="600">DAY 2</text>
+      <text x="369" y="110" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="40" font-weight="800" fill="#58a6ff">320</text>
+      <text x="505" y="110" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58">downloads</text>
+    </g>
+
+    <!-- Arrow between Day 2 and Day 3 -->
+    <g transform="translate(661, 55)">
+      <polygon points="0,15 18,35 0,55" fill="#2ea043"/>
+    </g>
+
+    <!-- Day 3 (highlighted) -->
+    <g filter="url(#cardShadow)">
+      <rect x="690" y="30" width="320" height="100" rx="12" fill="#161b22" stroke="#2ea043" stroke-width="2"/>
+      <rect x="690" y="30" width="320" height="3" rx="1.5" fill="url(#greenPill)"/>
+      <!-- Glow badge -->
+      <rect x="910" y="42" width="84" height="22" rx="11" fill="#238636" opacity="0.2"/>
+      <text x="952" y="57" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#2ea043" text-anchor="middle" font-weight="700">+494%</text>
+      <text x="714" y="68" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58" font-weight="600">DAY 3</text>
+      <text x="714" y="110" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="40" font-weight="800" fill="#2ea043">1,903</text>
+      <text x="878" y="110" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58">downloads</text>
+    </g>
+  </g>
+
+  <!-- Growth highlight banner -->
+  <g transform="translate(90, 355)">
+    <rect x="0" y="0" width="1020" height="60" rx="12" fill="#161b22" stroke="#30363d" stroke-width="1"/>
+    <rect x="0" y="0" width="6" height="60" rx="3" fill="url(#accentGrad)"/>
+    <text x="510" y="28" font-family="'SF Pro Display', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="22" fill="#c9d1d9" text-anchor="middle" font-weight="700">
+      245% growth. Zero budget.
+    </text>
+    <text x="510" y="48" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58" text-anchor="middle">
+      2,775 total downloads · 39 providers · 100% organic
+    </text>
+  </g>
+
+  <!-- Bottom section -->
+  <g transform="translate(90, 445)">
+    <!-- npm install box -->
+    <rect x="0" y="0" width="520" height="52" rx="10" fill="#161b22" stroke="#30363d" stroke-width="1.5"/>
+    <circle cx="26" cy="26" r="6" fill="#238636"/>
+    <circle cx="26" cy="26" r="3" fill="#0d1117"/>
+    <text x="46" y="32" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="16" fill="#c9d1d9" font-weight="500">
+      $ npm install adaptive-memory-router
+    </text>
+
+    <!-- GitHub link -->
+    <rect x="560" y="0" width="460" height="52" rx="10" fill="#161b22" stroke="#30363d" stroke-width="1.5"/>
+    <text x="580" y="22" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#484f58" font-weight="600" letter-spacing="1">
+      GITHUB
+    </text>
+    <text x="580" y="42" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="15" fill="#58a6ff" font-weight="500">
+      github.com/Das-rebel/adaptive-memory-router
+    </text>
+  </g>
+
+  <!-- Provider strip at very bottom -->
+  <g transform="translate(0, 530)">
+    <rect x="0" y="0" width="1200" height="100" fill="#080b10"/>
+    <rect x="0" y="0" width="1200" height="1" fill="#21262d"/>
+
+    <!-- Mini provider badges -->
+    <g transform="translate(90, 24)">
+      <rect x="0" y="0" width="80" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="40" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">OpenAI</text>
+
+      <rect x="96" y="0" width="95" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="143" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">Anthropic</text>
+
+      <rect x="207" y="0" width="68" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="241" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">Groq</text>
+
+      <rect x="289" y="0" width="88" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="333" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">Cerebras</text>
+
+      <rect x="391" y="0" width="78" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="430" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">Mistral</text>
+
+      <rect x="483" y="0" width="92" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="529" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">DeepSeek</text>
+
+      <rect x="589" y="0" width="76" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="627" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">Ollama</text>
+
+      <rect x="680" y="0" width="76" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="718" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">Gemini</text>
+
+      <rect x="770" y="0" width="62" height="28" rx="14" fill="#1a1f27" stroke="#30363d" stroke-width="0.5"/>
+      <text x="801" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#8b949e" text-anchor="middle" font-weight="600">SGLang</text>
+
+      <rect x="846" y="0" width="86" height="28" rx="14" fill="none" stroke="#30363d" stroke-width="0.5" stroke-dasharray="3 2"/>
+      <text x="889" y="19" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#484f58" text-anchor="middle" font-weight="500">+30 more</text>
+    </g>
+
+    <!-- Bottom tagline -->
+    <text x="600" y="75" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" fill="#30363d" text-anchor="middle" letter-spacing="3" font-weight="500">
+      ONE API KEY · EVERY PROVIDER · ZERO LOCK-IN
+    </text>
+  </g>
+</svg>

package/docs/assets/social-preview.svg

@@ -0,0 +1,194 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 640" width="1280" height="640">
+  <defs>
+    <!-- Background gradient -->
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0d1117"/>
+      <stop offset="50%" style="stop-color:#111820"/>
+      <stop offset="100%" style="stop-color:#0d1117"/>
+    </linearGradient>
+    <!-- Green accent gradient -->
+    <linearGradient id="greenGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#238636"/>
+      <stop offset="100%" style="stop-color:#2ea043"/>
+    </linearGradient>
+    <!-- Blue accent gradient -->
+    <linearGradient id="blueGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#1f6feb"/>
+      <stop offset="100%" style="stop-color:#58a6ff"/>
+    </linearGradient>
+    <!-- Purple accent gradient -->
+    <linearGradient id="purpleGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#8b5cf6"/>
+      <stop offset="100%" style="stop-color:#a78bfa"/>
+    </linearGradient>
+    <!-- Title gradient -->
+    <linearGradient id="titleGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#58a6ff"/>
+      <stop offset="40%" style="stop-color:#a78bfa"/>
+      <stop offset="100%" style="stop-color:#2ea043"/>
+    </linearGradient>
+    <!-- Glow filter -->
+    <filter id="glow">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <!-- Subtle shadow for cards -->
+    <filter id="cardShadow" x="-5%" y="-5%" width="110%" height="115%">
+      <feDropShadow dx="0" dy="4" stdDeviation="8" flood-color="#000000" flood-opacity="0.3"/>
+    </filter>
+    <!-- Emoji glow -->
+    <filter id="emojiGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="6" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1280" height="640" fill="url(#bgGrad)" rx="0"/>
+
+  <!-- Subtle grid pattern -->
+  <g opacity="0.03">
+    <line x1="0" y1="0" x2="1280" y2="640" stroke="#58a6ff" stroke-width="1"/>
+    <line x1="1280" y1="0" x2="0" y2="640" stroke="#58a6ff" stroke-width="1"/>
+    <line x1="640" y1="0" x2="640" y2="640" stroke="#58a6ff" stroke-width="0.5"/>
+    <line x1="0" y1="320" x2="1280" y2="320" stroke="#58a6ff" stroke-width="0.5"/>
+    <circle cx="640" cy="320" r="200" fill="none" stroke="#58a6ff" stroke-width="0.5"/>
+    <circle cx="640" cy="320" r="350" fill="none" stroke="#58a6ff" stroke-width="0.5"/>
+  </g>
+
+  <!-- Decorative accent lines -->
+  <rect x="0" y="0" width="6" height="640" fill="url(#titleGrad)" opacity="0.8"/>
+  <rect x="1274" y="0" width="6" height="640" fill="url(#titleGrad)" opacity="0.4"/>
+
+  <!-- Top decorative bar -->
+  <rect x="80" y="28" width="1120" height="2" fill="url(#titleGrad)" opacity="0.3" rx="1"/>
+
+  <!-- Emoji shuffle icon -->
+  <text x="120" y="130" font-size="72" filter="url(#emojiGlow)" opacity="0.9">🔀</text>
+
+  <!-- Main title -->
+  <text x="200" y="122" font-family="'SF Pro Display', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="72" font-weight="800" fill="url(#titleGrad)" filter="url(#glow)">
+    A3M Router
+  </text>
+
+  <!-- Subtitle -->
+  <text x="120" y="170" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="24" fill="#8b949e" font-weight="400">
+    Drop-in OpenAI proxy · 39 providers · 245% growth in 3 days
+  </text>
+
+  <!-- Stat cards row -->
+  <!-- Card 1: Downloads -->
+  <g filter="url(#cardShadow)">
+    <rect x="120" y="210" width="320" height="160" rx="16" fill="#161b22" stroke="#238636" stroke-width="2" opacity="0.95"/>
+    <rect x="120" y="210" width="320" height="4" rx="2" fill="url(#greenGrad)"/>
+    <text x="280" y="268" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="52" font-weight="800" fill="#2ea043" text-anchor="middle">
+      2,775
+    </text>
+    <text x="280" y="305" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="16" fill="#8b949e" text-anchor="middle" font-weight="500">
+      npm downloads
+    </text>
+    <text x="280" y="340" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58" text-anchor="middle">
+      in first 3 days
+    </text>
+  </g>
+
+  <!-- Card 2: Growth -->
+  <g filter="url(#cardShadow)">
+    <rect x="480" y="210" width="320" height="160" rx="16" fill="#161b22" stroke="#1f6feb" stroke-width="2" opacity="0.95"/>
+    <rect x="480" y="210" width="320" height="4" rx="2" fill="url(#blueGrad)"/>
+    <text x="640" y="268" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="52" font-weight="800" fill="#58a6ff" text-anchor="middle">
+      245%
+    </text>
+    <text x="640" y="305" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="16" fill="#8b949e" text-anchor="middle" font-weight="500">
+      day-over-day growth
+    </text>
+    <text x="640" y="340" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58" text-anchor="middle">
+      organic, no marketing
+    </text>
+  </g>
+
+  <!-- Card 3: Budget -->
+  <g filter="url(#cardShadow)">
+    <rect x="840" y="210" width="320" height="160" rx="16" fill="#161b22" stroke="#8b5cf6" stroke-width="2" opacity="0.95"/>
+    <rect x="840" y="210" width="320" height="4" rx="2" fill="url(#purpleGrad)"/>
+    <text x="1000" y="268" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="52" font-weight="800" fill="#a78bfa" text-anchor="middle">
+      $0
+    </text>
+    <text x="1000" y="305" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="16" fill="#8b949e" text-anchor="middle" font-weight="500">
+      marketing budget
+    </text>
+    <text x="1000" y="340" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58" text-anchor="middle">
+      100% community driven
+    </text>
+  </g>
+
+  <!-- Provider logos row -->
+  <g transform="translate(0, 420)">
+    <text x="640" y="10" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" fill="#484f58" text-anchor="middle" letter-spacing="3" font-weight="600">
+      SUPPORTED PROVIDERS
+    </text>
+
+    <!-- Provider pills -->
+    <!-- OpenAI -->
+    <rect x="68" y="26" width="130" height="38" rx="19" fill="#1a1f27" stroke="#30363d" stroke-width="1"/>
+    <circle cx="95" cy="45" r="8" fill="#10a37f"/>
+    <text x="108" y="51" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="14" fill="#c9d1d9" font-weight="600">OpenAI</text>
+
+    <!-- Anthropic -->
+    <rect x="218" y="26" width="140" height="38" rx="19" fill="#1a1f27" stroke="#30363d" stroke-width="1"/>
+    <circle cx="248" cy="45" r="8" fill="#d4a574"/>
+    <text x="262" y="51" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="14" fill="#c9d1d9" font-weight="600">Anthropic</text>
+
+    <!-- Groq -->
+    <rect x="378" y="26" width="110" height="38" rx="19" fill="#1a1f27" stroke="#30363d" stroke-width="1"/>
+    <circle cx="405" cy="45" r="8" fill="#f55036"/>
+    <text x="418" y="51" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="14" fill="#c9d1d9" font-weight="600">Groq</text>
+
+    <!-- Cerebras -->
+    <rect x="508" y="26" width="130" height="38" rx="19" fill="#1a1f27" stroke="#30363d" stroke-width="1"/>
+    <circle cx="538" cy="45" r="8" fill="#7c3aed"/>
+    <text x="552" y="51" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="14" fill="#c9d1d9" font-weight="600">Cerebras</text>
+
+    <!-- Mistral -->
+    <rect x="658" y="26" width="120" height="38" rx="19" fill="#1a1f27" stroke="#30363d" stroke-width="1"/>
+    <circle cx="685" cy="45" r="8" fill="#ff7000"/>
+    <text x="698" y="51" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="14" fill="#c9d1d9" font-weight="600">Mistral</text>
+
+    <!-- DeepSeek -->
+    <rect x="798" y="26" width="140" height="38" rx="19" fill="#1a1f27" stroke="#30363d" stroke-width="1"/>
+    <circle cx="828" cy="45" r="8" fill="#4d6bfe"/>
+    <text x="842" y="51" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="14" fill="#c9d1d9" font-weight="600">DeepSeek</text>
+
+    <!-- Ollama -->
+    <rect x="958" y="26" width="120" height="38" rx="19" fill="#1a1f27" stroke="#30363d" stroke-width="1"/>
+    <circle cx="985" cy="45" r="8" fill="#6366f1"/>
+    <text x="998" y="51" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="14" fill="#c9d1d9" font-weight="600">Ollama</text>
+
+    <!-- +32 more -->
+    <rect x="1098" y="26" width="110" height="38" rx="19" fill="none" stroke="#30363d" stroke-width="1" stroke-dasharray="4 3"/>
+    <text x="1153" y="51" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" fill="#484f58" text-anchor="middle" font-weight="500">+32 more</text>
+  </g>
+
+  <!-- Bottom bar -->
+  <rect x="80" y="530" width="1120" height="1" fill="#21262d" rx="0.5"/>
+
+  <!-- Bottom tagline -->
+  <text x="640" y="570" font-family="'SF Mono', 'Fira Code', 'Consolas', monospace" font-size="15" fill="#484f58" text-anchor="middle">
+    $ npx adaptive-memory-router --provider auto
+  </text>
+
+  <!-- Bottom right badge -->
+  <rect x="1020" y="585" width="180" height="30" rx="15" fill="#161b22" stroke="#30363d" stroke-width="1"/>
+  <text x="1110" y="605" font-family="'SF Pro Text', -apple-system, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" fill="#8b949e" text-anchor="middle" font-weight="500">
+    github.com/Das-rebel
+  </text>
+
+  <!-- Bottom decorative bar -->
+  <rect x="80" y="610" width="1120" height="2" fill="url(#titleGrad)" opacity="0.3" rx="1"/>
+</svg>