npm - adaptive-memory-multi-model-router - Versions diffs - 2.14.49 → 2.14.52 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (605) hide show

package/.dockerignore +82 -0
package/.env.example +303 -0
package/.github/DISCUSSIONS_WELCOME.md +27 -0
package/.github/DISCUSSION_TEMPLATE.yml +5 -0
package/.github/FUNDING.yml +2 -0
package/.github/ISSUE_TEMPLATE/bug_report.md +94 -0
package/.github/ISSUE_TEMPLATE/config.yml +17 -0
package/.github/ISSUE_TEMPLATE/feature_request.md +71 -0
package/.github/PULL_REQUEST_TEMPLATE.md +71 -0
package/.github/dependabot.yml +9 -0
package/.github/workflows/ci.yml +263 -0
package/.github/workflows/codeql.yml +38 -0
package/.github/workflows/npm-publish.yml +20 -0
package/.github/workflows/pages.yml +37 -0
package/.github/workflows/stale.yml +54 -0
package/.publish-tick +1 -0
package/.well-known/ai-plugin.json +16 -0
package/AGENT_COUNCIL_FINDINGS.md +142 -0
package/ARCHITECTURE.md +346 -0
package/AUDIT_REPORT.md +28 -0
package/CODE_OF_CONDUCT.md +128 -0
package/CONTRIBUTING.md +50 -0
package/CONTRIBUTORS.md +20 -0
package/Dockerfile +53 -0
package/Dockerfile.proxy +33 -0
package/HEALTH_REPORT.md +118 -0
package/IMPROVEMENT_PLAN.md +107 -0
package/LANDING.md +43 -0
package/LAUNCH-PAIN-DRIVEN.md +339 -0
package/LAUNCH.md +337 -0
package/LAUNCH_CHECKLIST.md +141 -0
package/LAUNCH_SNAPSHOT.md +260 -0
package/MANIFESTO.md +41 -0
package/POPULARITY_BOOSTERS.md +285 -0
package/PR_STATUS_REPORT.md +148 -0
package/README.md +25 -14
package/REDESIGN.md +95 -0
package/RUNKIT.md +83 -0
package/SECURITY.md +29 -0
package/SUBMISSIONS.md +43 -0
package/_schema.html +53 -0
package/ai-plugin.json +16 -0
package/articles/AI_AGENT_LLM_ROUTING.md +150 -0
package/articles/CHINESE_DIRECTORIES.md +100 -0
package/articles/CHINESE_SUBMISSIONS_READY.md +322 -0
package/articles/COMPETITOR_ALERTS.md +31 -0
package/articles/COMPLETE_POSTING_DIRECTORY.md +147 -0
package/articles/CONTENT_STRUCTURE.md +292 -0
package/articles/DEVTO_COST_GUIDE.md +473 -0
package/articles/DEVTO_FINAL.md +416 -0
package/articles/DEVTO_MULTI_PROVIDER.md +542 -0
package/articles/DEVTO_READY.md +255 -0
package/articles/DEVTO_V2_ANNOUNCEMENT.md +160 -0
package/articles/DEVTO_VIRAL_GROWTH.md +280 -0
package/articles/FRESH_devto.md +460 -0
package/articles/FRESH_devto_2026_05.md +73 -0
package/articles/FRESH_hackernews.md +14 -0
package/articles/FRESH_reddit_ml.md +90 -0
package/articles/FRESH_reddit_node.md +198 -0
package/articles/FRESH_reddit_sideproject.md +72 -0
package/articles/FRESH_reddit_webdev.md +130 -0
package/articles/FROM_ZERO_TO_10K.md +107 -0
package/articles/HN_10X_BETTER.md +430 -0
package/articles/HN_ACCOUNT_GUIDE.md +21 -0
package/articles/HN_CHINESE_STYLE.md +308 -0
package/articles/HN_FINAL.md +148 -0
package/articles/HN_POSTED_VERSION.md +56 -0
package/articles/HN_POST_READY.md +137 -0
package/articles/HN_RESEARCH.md +364 -0
package/articles/HN_SHOW_routerarena.md +17 -0
package/articles/HN_TIMING_GUIDE.md +52 -0
package/articles/INDIEHACKERS_POST.md +52 -0
package/articles/INDIEHACKERS_READY.md +120 -0
package/articles/LLM_BENCHMARK_DEEP_DIVE.md +153 -0
package/articles/MASTER_POSTING_DIRECTORY.md +189 -0
package/articles/NEWSLETTER_SEND_NOW.md +259 -0
package/articles/NEWSLETTER_SUBMISSIONS.md +112 -0
package/articles/PAIN-DRIVEN-devto-v2.md +308 -0
package/articles/PAIN-DRIVEN-devto-v3.md +268 -0
package/articles/PAIN-DRIVEN-devto.md +242 -0
package/articles/PAIN-DRIVEN-hackernews-v2.md +138 -0
package/articles/PAIN-DRIVEN-hackernews-v3.md +151 -0
package/articles/PAIN-DRIVEN-hackernews.md +131 -0
package/articles/PAIN-DRIVEN-reddit-v2.md +301 -0
package/articles/PAIN-DRIVEN-reddit-v3.md +236 -0
package/articles/PAIN-DRIVEN-reddit.md +218 -0
package/articles/PAIN-DRIVEN-twitter-v2.md +110 -0
package/articles/PAIN-DRIVEN-twitter-v3.md +121 -0
package/articles/PAIN-DRIVEN-twitter.md +120 -0
package/articles/PORTKEY_VS_A3M.md +147 -0
package/articles/POSTING_KIT_2026_05.md +67 -0
package/articles/PRESS_KIT_routerarena.md +77 -0
package/articles/PRODUCTHUNT_LISTING.md +48 -0
package/articles/PRODUCTHUNT_READY.md +106 -0
package/articles/PR_PLAN_vault.md +125 -0
package/articles/REDDIT_FINAL.md +232 -0
package/articles/REDDIT_POST.md +67 -0
package/articles/REDDIT_SUBMISSION_READY.md +348 -0
package/articles/ROUTERARENA_9677.md +78 -0
package/articles/ROUTERARENA_LEADER.md +45 -0
package/articles/SHOW_HN_FINAL.md +29 -0
package/articles/TWEETS_10K_DOWNLOADS.md +47 -0
package/articles/TWEETS_BENCHMARK_FIRST.md +46 -0
package/articles/TWEETS_MCP_PLAY.md +51 -0
package/articles/TWEETS_SEQUENTIAL_BROKEN.md +49 -0
package/articles/TWEETS_WHY_BUILD.md +54 -0
package/articles/TWEETS_routerarena_leader.md +53 -0
package/articles/TWEET_STORM_READY.md +165 -0
package/articles/TWITTER_FINAL.md +167 -0
package/articles/WHY_10X_BETTER.md +261 -0
package/articles/WHY_CHINESE_STYLE_BETTER.md +323 -0
package/articles/ai-discoverability-llm-routing.md +210 -0
package/articles/devto-llm-routing.md +138 -0
package/articles/hackernews-show-hn.md +54 -0
package/articles/hashnode-llm-cost-optimization.md +125 -0
package/articles/hn_show_2026_05.md +11 -0
package/articles/medium-building-llm-router.md +205 -0
package/articles/reddit-ml.md +76 -0
package/articles/twitter-thread-cost-savings.md +50 -0
package/articles/youtube-tutorial-script.md +262 -0
package/assets/a3m_3blue1brown.mp4 +0 -0
package/assets/banner.svg +109 -0
package/assets/chart-cost-v2.svg +91 -0
package/assets/chart-cost-v3.svg +143 -0
package/assets/chart-features-v2.svg +132 -0
package/assets/chart-features-v3.svg +211 -0
package/assets/chart-growth-v2.svg +122 -0
package/assets/chart-growth-v3.svg +189 -0
package/assets/cost-comparison.svg +134 -0
package/assets/cost-simple.svg +64 -0
package/assets/demo-hn.gif +0 -0
package/assets/feature-matrix.svg +136 -0
package/assets/growth-chart-animated.svg +76 -0
package/assets/growth-chart.svg +82 -0
package/assets/growth-simple.svg +69 -0
package/assets/hero-diagram.svg +81 -0
package/assets/logo-new.svg +21 -0
package/assets/logo.svg +68 -0
package/assets/provider-comparison.svg +121 -0
package/assets/social-preview-new.svg +100 -0
package/assets/social-preview.svg +194 -0
package/assets/social-v2.svg +130 -0
package/assets/social-v3.svg +212 -0
package/benchmark-provider-results.json +245 -0
package/benchmark-results.json +54 -0
package/council-votes/architecture-vote.md +121 -0
package/council-votes/coverage-vote.md +93 -0
package/data/adaptive-benchmark.json +92 -0
package/data/benchmark-results.json +47 -0
package/data/labeled-benchmark.json +88 -0
package/demo/3blue1brown_video.py +285 -0
package/demo/3blue1brown_video_v2.py +310 -0
package/demo/IMPROVED_PROMPTS.md +229 -0
package/demo/VEO3_PROMPTS.md +269 -0
package/demo/VIDEO_PRODUCTION_GUIDE.md +333 -0
package/demo/a3m_3blue1brown.mp4 +0 -0
package/demo/asciinema-demo.sh +195 -0
package/demo/demo-hn.tape +74 -0
package/demo/demo-script.md +53 -0
package/demo/demo-script.sh +62 -0
package/demo/demo.svg +75 -0
package/demo/frame1_ai_data_center.png +0 -0
package/demo/frame1_sunset_video.mp4 +0 -0
package/demo/frame2_cost_comparison.png +0 -0
package/demo/frame2_cost_comparison_fallback.png +0 -0
package/demo/frame3_parallel_execution.png +0 -0
package/demo/frame3_parallel_execution_fallback.png +0 -0
package/demo/frame4_providers.png +0 -0
package/demo/frame4_providers_fallback.png +0 -0
package/demo/frame5_endcard.png +0 -0
package/demo/frame5_endcard_fallback.png +0 -0
package/demo/new_frame1_hook.png +0 -0
package/demo/new_frame2_proof.png +0 -0
package/demo/new_frame3_wow.png +0 -0
package/demo/new_frame4_social.png +0 -0
package/demo/new_frame5_cta.png +0 -0
package/demo/package.json +13 -0
package/demo/product-video-final.mp4 +0 -0
package/demo/product-video-hype-v1.mp4 +0 -0
package/demo/product-video-v1.mp4 +0 -0
package/demo/public/index.html +762 -0
package/demo/recording.cast +55 -0
package/demo/server.js +405 -0
package/demo-new.tape +71 -0
package/demo-real.sh +198 -0
package/demo-simple.tape +205 -0
package/demo.html +520 -0
package/demo.sh +85 -0
package/demo.tape +259 -0
package/dist/analytics/costAnalytics.d.ts.map +1 -0
package/dist/analytics/costAnalytics.js.map +1 -0
package/dist/benchmark/comprehensive.js.map +1 -0
package/dist/benchmark/reproducible.d.ts.map +1 -0
package/dist/benchmark/reproducible.js.map +1 -0
package/dist/cache/prefixCache.d.ts.map +1 -0
package/dist/cache/prefixCache.js.map +1 -0
package/dist/cache/responseCache.d.ts.map +1 -0
package/dist/cache/responseCache.js.map +1 -0
package/dist/cache/semanticCache.d.ts.map +1 -0
package/dist/cache/semanticCache.js.map +1 -0
package/dist/cli/setupWizard.d.ts.map +1 -0
package/dist/cli/setupWizard.js.map +1 -0
package/dist/cost/budgetEnforcer.d.ts.map +1 -0
package/dist/cost/budgetEnforcer.js.map +1 -0
package/dist/cost/costTracker.d.ts.map +1 -0
package/dist/cost/costTracker.js.map +1 -0
package/dist/ensemble/multiRoundDialog.js.map +1 -0
package/dist/ensemble/shapleyValue.js.map +1 -0
package/dist/integrations/langchainAdapter.d.ts.map +1 -0
package/dist/integrations/langchainAdapter.js.map +1 -0
package/dist/integrations/oauth.d.ts.map +1 -0
package/dist/integrations/oauth.js.map +1 -0
package/dist/integrations/scienceAdapter.js.map +1 -0
package/dist/memory/autoFetch.d.ts.map +1 -0
package/dist/memory/autoFetch.js.map +1 -0
package/dist/memory/episodicMemory.d.ts.map +1 -0
package/dist/memory/episodicMemory.js.map +1 -0
package/dist/memory/hybridMemory.js.map +1 -0
package/dist/memory/memoryTree.d.ts.map +1 -0
package/dist/memory/memoryTree.js.map +1 -0
package/dist/memory/obsidianVault.d.ts.map +1 -0
package/dist/memory/obsidianVault.js.map +1 -0
package/dist/memory/reasoningBank.js.map +1 -0
package/dist/observability/changeWatch.d.ts.map +1 -0
package/dist/observability/changeWatch.js.map +1 -0
package/dist/observability/fatigueDetector.d.ts.map +1 -0
package/dist/observability/fatigueDetector.js.map +1 -0
package/dist/observability/index.d.ts.map +1 -0
package/dist/observability/index.js.map +1 -0
package/dist/observability/metrics.d.ts.map +1 -0
package/dist/observability/metrics.js.map +1 -0
package/dist/observability/middleware.d.ts.map +1 -0
package/dist/observability/middleware.js.map +1 -0
package/dist/observability/tracer.d.ts.map +1 -0
package/dist/observability/tracer.js.map +1 -0
package/dist/observability/types.d.ts.map +1 -0
package/dist/observability/types.js.map +1 -0
package/dist/orchestration/haloOrchestrator.d.ts.map +1 -0
package/dist/orchestration/haloOrchestrator.js.map +1 -0
package/dist/orchestration/mctsWorkflow.d.ts.map +1 -0
package/dist/orchestration/mctsWorkflow.js.map +1 -0
package/dist/providers/localProvider.d.ts.map +1 -0
package/dist/providers/localProvider.js.map +1 -0
package/dist/providers/providerConfig.d.ts.map +1 -0
package/dist/providers/providerConfig.js.map +1 -0
package/dist/providers/registry.d.ts.map +1 -0
package/dist/providers/registry.js.map +1 -0
package/dist/routing/advancedRouter.d.ts.map +1 -0
package/dist/routing/advancedRouter.js +1 -1
package/dist/routing/advancedRouter.js.map +1 -0
package/dist/routing/crossModelValidation.d.ts.map +1 -0
package/dist/routing/crossModelValidation.js.map +1 -0
package/dist/routing/providerHealth.d.ts.map +1 -0
package/dist/routing/providerHealth.js.map +1 -0
package/dist/routing/providerRetry.d.ts.map +1 -0
package/dist/routing/providerRetry.js.map +1 -0
package/dist/scripts/banner.js +29 -0
package/dist/security/guardrails.d.ts.map +1 -0
package/dist/security/guardrails.js.map +1 -0
package/dist/server/dashboard.d.ts.map +1 -0
package/dist/server/dashboard.js.map +1 -0
package/dist/server/modelMapper.d.ts.map +1 -0
package/dist/server/modelMapper.js.map +1 -0
package/dist/server/proxyServer.d.ts.map +1 -0
package/dist/server/proxyServer.js.map +1 -0
package/dist/skills/__tests__/skill_manager.test.d.ts +2 -0
package/dist/skills/__tests__/skill_manager.test.d.ts.map +1 -0
package/dist/skills/__tests__/skill_manager.test.js +268 -0
package/dist/skills/__tests__/skill_manager.test.js.map +1 -0
package/dist/tools/tmlpdTools.d.ts.map +1 -0
package/dist/tools/tmlpdTools.js.map +1 -0
package/dist/tui/dashboard.d.ts.map +1 -0
package/dist/tui/dashboard.js.map +1 -0
package/dist/tui/index.d.ts.map +1 -0
package/dist/tui/index.js.map +1 -0
package/dist/utils/batchProcessor.d.ts.map +1 -0
package/dist/utils/batchProcessor.js.map +1 -0
package/dist/utils/compression.d.ts.map +1 -0
package/dist/utils/compression.js.map +1 -0
package/dist/utils/costUtils.d.ts.map +1 -0
package/dist/utils/costUtils.js.map +1 -0
package/dist/utils/reliability.d.ts.map +1 -0
package/dist/utils/reliability.js.map +1 -0
package/dist/utils/sorting.d.ts.map +1 -0
package/dist/utils/sorting.js.map +1 -0
package/dist/utils/speculativeDecoding.d.ts.map +1 -0
package/dist/utils/speculativeDecoding.js.map +1 -0
package/dist/utils/tokenUtils.d.ts.map +1 -0
package/dist/utils/tokenUtils.js.map +1 -0
package/docs/.nojekyll +0 -0
package/docs/ANALYSIS_PRINCIPLES.md +162 -0
package/docs/API.md +855 -0
package/docs/ARCHITECTURAL-IMPROVEMENTS-2025.md +1391 -0
package/docs/ARCHITECTURAL-IMPROVEMENTS-REVISED-2025.md +1051 -0
package/docs/BENCHMARK.md +170 -0
package/docs/CHINESE_PROVIDER_RELIABILITY.md +37 -0
package/docs/CITATIONS.md +74 -0
package/docs/CLAIMS_AND_EVIDENCE.md +58 -0
package/docs/CONFIGURATION.md +476 -0
package/docs/COUNCIL_DECISION.json +816 -0
package/docs/COUNCIL_SUMMARY.md +319 -0
package/docs/COUNCIL_V2.2_DECISION.md +416 -0
package/docs/ENGINEERING_SPEC.md +55 -0
package/docs/FACTORY_RESET.md +34 -0
package/docs/GEO.md +66 -0
package/docs/GEO_OPTIMIZATION.md +30 -0
package/docs/GEO_ROOT_CAUSE.md +136 -0
package/docs/GEO_STATUS.md +85 -0
package/docs/GEO_TEST_RESULTS.md +176 -0
package/docs/HN_CHECKLIST.md +38 -0
package/docs/HN_FOUNDER_COMMENT.md +17 -0
package/docs/HN_SUBMISSION_FINAL.md +180 -0
package/docs/HN_SUBMISSION_V3.md +56 -0
package/docs/IMPROVEMENT_ROADMAP.md +515 -0
package/docs/INTEGRATIONS.md +420 -0
package/docs/LANGCHAIN_INTEGRATION.md +147 -0
package/docs/LLM_COUNCIL_DECISION.md +508 -0
package/docs/MIDDLEWARE_CHAIN.md +35 -0
package/docs/PROMO_CHECKLIST.md +200 -0
package/docs/QUICKSTART.md +271 -0
package/docs/QUICK_START.md +43 -0
package/docs/QUICK_START_VISIBILITY.md +782 -0
package/docs/REDDIT_GAP_ANALYSIS.md +299 -0
package/docs/RELEASE_CHECKLIST.md +32 -0
package/docs/REPRODUCIBILITY.md +63 -0
package/docs/RESEARCH_BACKED_IMPROVEMENTS.md +1180 -0
package/docs/ROUTING_RUBRIC.md +197 -0
package/docs/SEO_AUDIT.md +186 -0
package/docs/SOCIAL_LISTENING.md +219 -0
package/docs/TMLPD_QNA.md +751 -0
package/docs/TMLPD_V2.1_COMPLETE.md +763 -0
package/docs/TMLPD_V2.2_RESEARCH_ROADMAP.md +754 -0
package/docs/UPDATE_TOPICS.md +15 -0
package/docs/USE_CASES.md +59 -0
package/docs/V2.2_IMPLEMENTATION_COMPLETE.md +446 -0
package/docs/V2_IMPLEMENTATION_GUIDE.md +388 -0
package/docs/VERCEL_AI_SDK.md +209 -0
package/docs/VISIBILITY_ADOPTION_PLAN.md +1005 -0
package/docs/_config.yml +49 -0
package/docs/ai-plugin.json +16 -0
package/docs/api.html +513 -0
package/docs/architecture-diagram.md +40 -0
package/docs/benchmark-chart.png +0 -0
package/docs/benchmark.html +387 -0
package/docs/blog/routerarena-9677.html +92 -0
package/docs/blog/routerarena-number-one.html +73 -0
package/docs/cli-cheatsheet.md +339 -0
package/docs/compare.md +109 -0
package/docs/comparison-litellm.md +88 -0
package/docs/comparison.md +108 -0
package/docs/cost-chart-ascii.md +42 -0
package/docs/cost-comparison-chart.svg +88 -0
package/docs/curl-examples.md +247 -0
package/docs/demo-auto.html +264 -0
package/docs/demo.html +416 -0
package/docs/geo/GENERATIVE_ENGINE_OPTIMIZATION.md +232 -0
package/docs/index.html +507 -0
package/docs/launch-content/LAUNCH_EXECUTION_CHECKLIST.md +421 -0
package/docs/launch-content/README.md +457 -0
package/docs/launch-content/assets/cost_comparison_100_tasks.png +0 -0
package/docs/launch-content/assets/cumulative_savings.png +0 -0
package/docs/launch-content/assets/parallel_speedup.png +0 -0
package/docs/launch-content/assets/provider_pricing_comparison.png +0 -0
package/docs/launch-content/assets/task_breakdown_comparison.png +0 -0
package/docs/launch-content/generate_charts.py +313 -0
package/docs/launch-content/hn_show_post.md +139 -0
package/docs/launch-content/partner_outreach_templates.md +745 -0
package/docs/launch-content/reddit_posts.md +467 -0
package/docs/launch-content/twitter_thread.txt +460 -0
package/{llms.txt.bak → docs/llms.txt} +6 -6
package/docs/npm-downloads-chart.svg +43 -0
package/docs/openapi.json +139 -0
package/docs/openapi.yaml +1318 -0
package/docs/quick-start.html +366 -0
package/docs/robots.txt +52 -0
package/docs/sitemap.xml +57 -0
package/docs/styles.css +682 -0
package/docs/well-known/ai-plugin.json +16 -0
package/docs/wellknown/ai-plugin.json +16 -0
package/docs-site/assets/og-banner.svg +194 -0
package/docs-site/index.html +632 -0
package/eval/README.md +46 -0
package/eval/baselines/main.json +12 -0
package/eval/benchmark_dataset.jsonl +16 -0
package/eval/check_golden_routes.js +64 -0
package/eval/datasets/catalog.json +33 -0
package/eval/datasets/slices/cn_provider_reliability_v1.jsonl +3 -0
package/eval/datasets/slices/cost_pressure_v1.jsonl +3 -0
package/eval/datasets/slices/safety_guardrails_v1.jsonl +3 -0
package/eval/evals.json +199 -0
package/eval/fault_injection_thresholds.json +3 -0
package/eval/generate_report.js +128 -0
package/eval/golden_routes.json +114 -0
package/eval/lib/experiment_registry.js +24 -0
package/eval/run_eval.js +197 -0
package/eval/run_fault_injection.js +201 -0
package/eval/run_shadow_eval.js +85 -0
package/eval/thresholds.json +9 -0
package/examples/QUICKSTART.md +183 -0
package/examples/README.md +61 -0
package/examples/a3m-sdk.js +124 -0
package/examples/basic-route.js +54 -0
package/examples/chat-loop.js +202 -0
package/examples/classify-then-route.js +102 -0
package/examples/cost-compare.js +120 -0
package/examples/ensemble.js +160 -0
package/examples/whatsapp-telegram-bridge-demo.js +302 -0
package/examples/whatsapp-telegram-bridge.js +269 -0
package/hf-space/README.md +23 -0
package/hf-space/app.py +240 -0
package/hf-space/requirements.txt +1 -0
package/huggingface_space/README.md +35 -0
package/huggingface_space/app.py +126 -0
package/huggingface_space/create_space.py +208 -0
package/huggingface_space/requirements.txt +1 -0
package/index.html +1 -1
package/mcp-server/README.md +188 -0
package/mcp-server/package.json +29 -0
package/mcp-server/src/index.ts +744 -0
package/mcp-server/tsconfig.json +19 -0
package/openclaw-alexa-bridge/ALL_REMAINING_FIXES_PLAN.md +313 -0
package/openclaw-alexa-bridge/REMAINING_FIXES_SUMMARY.md +277 -0
package/openclaw-alexa-bridge/src/alexa_handler_no_tmlpd.js +1234 -0
package/openclaw-alexa-bridge/test_fixes.js +77 -0
package/package.json +76 -272
package/playground/README.md +51 -0
package/playground/codesandbox.json +12 -0
package/playground/index.js +39 -0
package/proxy/README.md +227 -0
package/proxy/package-lock.json +831 -0
package/proxy/package.json +17 -0
package/proxy/rate-limit.js +145 -0
package/proxy/rate-limit.test.js +311 -0
package/proxy/server.js +970 -0
package/python/README.md +102 -0
package/python/a3m/__init__.py +6 -0
package/python/a3m/client.py +190 -0
package/python/a3m/models.py +40 -0
package/python/a3m/sync_client.py +61 -0
package/python/examples.py +53 -0
package/python/integrations.py +330 -0
package/python/pyproject.toml +23 -0
package/python/setup.py +28 -0
package/python/tmlpd.py +369 -0
package/qna/REDDIT_GAP_ANALYSIS.md +299 -0
package/qna/TMLPD_QNA.md +751 -0
package/research/FINDING_001_safety.md +28 -0
package/research/FINDING_002_error_diversity.md +32 -0
package/research/FINDING_003_confidence_weighted_voting.md +32 -0
package/research/FINDING_004_cross_model_semantic_detection.md +37 -0
package/research/FINDING_005_knowledge_gap_orthogonality.md +34 -0
package/research/HALLUCINATION_RESEARCH.md +27 -0
package/research/ensemble-voting.md +324 -0
package/research/loss-functions.md +545 -0
package/research-log.md +49 -0
package/scripts/banner.js +29 -0
package/scripts/benchmark-local-routerarena.ts +176 -0
package/scripts/benchmark.js +145 -0
package/scripts/benchmark.sh +61 -0
package/scripts/compare-providers.sh +230 -0
package/scripts/content-planner.js +25 -0
package/scripts/create-labeled-benchmark.ts +105 -0
package/scripts/cross_post.py +443 -0
package/scripts/local-router-benchmark.ts +154 -0
package/scripts/post-all.sh +41 -0
package/scripts/publish_fcc.py +106 -0
package/scripts/push-to-gitee.sh +25 -0
package/scripts/routerarena_ensemble.js +144 -0
package/scripts/routing-benchmark-v2.js +373 -0
package/scripts/routing-benchmark-v3.js +118 -0
package/scripts/routing-benchmark.js +462 -0
package/scripts/run-labeled-benchmark.mjs +104 -0
package/scripts/run-mmlu-benchmark.js +176 -0
package/scripts/run-provider-benchmark.js +244 -0
package/scripts/update-npm-badges.js +158 -0
package/skill/SKILL.md +238 -0
package/src/__tests__/integration/tmpld_integration.test.py +540 -0
package/src/ensemble.ts +2 -0
package/src/routing/advancedRouter.ts +1 -1
package/src/skills/__tests__/skill_manager.test.ts +328 -0
package/submissions/benchmarks/ALL_PLATFORMS_SUBMISSION.md +94 -0
package/submissions/benchmarks/LLMROUTERBENCH_SUBMISSION.md +121 -0
package/submissions/benchmarks/MMRBENCH_SUBMISSION.md +94 -0
package/submissions/benchmarks/ROUTERARENA_UPDATE.md +83 -0
package/submissions/benchmarks/ROUTERBENCH_SUBMISSION.md +225 -0
package/test-council/1-structure-tests.test.js +353 -0
package/test-council/1-structure-tests.test.ts +353 -0
package/test-council/2-edge-case-tests.test.ts +361 -0
package/test-council/3-performance-tests.test.ts +652 -0
package/test-council/4-integration-tests.test.ts +391 -0
package/test-council/5-agent-council-eval.test.ts +413 -0
package/test-council/AGENT_COUNCIL_ARCHITECTURE.md +349 -0
package/test-council/TEST_COUNCIL_REPORT.md +201 -0
package/test-council/agents/edge-case-agent.ts +363 -0
package/test-council/agents/performance-agent.ts +426 -0
package/test-council/agents/structure-agent.ts +227 -0
package/test-council/council.md +183 -0
package/tests/__mocks__/tokenUtils.ts +8 -0
package/tests/memory/episodicMemory.test.ts +227 -0
package/tests/package-lock.json +1785 -0
package/tests/package.json +19 -0
package/tests/routing/ensembleVoting.test.ts +236 -0
package/tests/routing/providerRetry.test.ts +360 -0
package/tests/routing/queryTypePresets.test.ts +208 -0
package/tests/security/guardrailEngine.test.ts +700 -0
package/tests/tsconfig.json +21 -0
package/tests/vitest.config.ts +18 -0
package/tmlpd-pi-extension/README.md +66 -0
package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts +114 -0
package/tmlpd-pi-extension/dist/cache/prefixCache.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/cache/prefixCache.js +285 -0
package/tmlpd-pi-extension/dist/cache/prefixCache.js.map +1 -0
package/tmlpd-pi-extension/dist/cache/responseCache.d.ts +58 -0
package/tmlpd-pi-extension/dist/cache/responseCache.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/cache/responseCache.js +153 -0
package/tmlpd-pi-extension/dist/cache/responseCache.js.map +1 -0
package/tmlpd-pi-extension/dist/cli.js +59 -0
package/tmlpd-pi-extension/dist/cost/costTracker.d.ts +95 -0
package/tmlpd-pi-extension/dist/cost/costTracker.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/cost/costTracker.js +240 -0
package/tmlpd-pi-extension/dist/cost/costTracker.js.map +1 -0
package/tmlpd-pi-extension/dist/index.d.ts +723 -0
package/tmlpd-pi-extension/dist/index.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/index.js +239 -0
package/tmlpd-pi-extension/dist/index.js.map +1 -0
package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts +82 -0
package/tmlpd-pi-extension/dist/memory/episodicMemory.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/memory/episodicMemory.js +145 -0
package/tmlpd-pi-extension/dist/memory/episodicMemory.js.map +1 -0
package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts +102 -0
package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js +207 -0
package/tmlpd-pi-extension/dist/orchestration/haloOrchestrator.js.map +1 -0
package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts +85 -0
package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js +210 -0
package/tmlpd-pi-extension/dist/orchestration/mctsWorkflow.js.map +1 -0
package/tmlpd-pi-extension/dist/providers/localProvider.d.ts +102 -0
package/tmlpd-pi-extension/dist/providers/localProvider.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/providers/localProvider.js +338 -0
package/tmlpd-pi-extension/dist/providers/localProvider.js.map +1 -0
package/tmlpd-pi-extension/dist/providers/registry.d.ts +55 -0
package/tmlpd-pi-extension/dist/providers/registry.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/providers/registry.js +138 -0
package/tmlpd-pi-extension/dist/providers/registry.js.map +1 -0
package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts +68 -0
package/tmlpd-pi-extension/dist/routing/advancedRouter.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/routing/advancedRouter.js +332 -0
package/tmlpd-pi-extension/dist/routing/advancedRouter.js.map +1 -0
package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts +101 -0
package/tmlpd-pi-extension/dist/tools/tmlpdTools.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/tools/tmlpdTools.js +368 -0
package/tmlpd-pi-extension/dist/tools/tmlpdTools.js.map +1 -0
package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts +96 -0
package/tmlpd-pi-extension/dist/utils/batchProcessor.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/utils/batchProcessor.js +170 -0
package/tmlpd-pi-extension/dist/utils/batchProcessor.js.map +1 -0
package/tmlpd-pi-extension/dist/utils/compression.d.ts +61 -0
package/tmlpd-pi-extension/dist/utils/compression.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/utils/compression.js +281 -0
package/tmlpd-pi-extension/dist/utils/compression.js.map +1 -0
package/tmlpd-pi-extension/dist/utils/reliability.d.ts +74 -0
package/tmlpd-pi-extension/dist/utils/reliability.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/utils/reliability.js +177 -0
package/tmlpd-pi-extension/dist/utils/reliability.js.map +1 -0
package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts +117 -0
package/tmlpd-pi-extension/dist/utils/speculativeDecoding.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js +246 -0
package/tmlpd-pi-extension/dist/utils/speculativeDecoding.js.map +1 -0
package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts +50 -0
package/tmlpd-pi-extension/dist/utils/tokenUtils.d.ts.map +1 -0
package/tmlpd-pi-extension/dist/utils/tokenUtils.js +124 -0
package/tmlpd-pi-extension/dist/utils/tokenUtils.js.map +1 -0
package/tmlpd-pi-extension/examples/QUICKSTART.md +183 -0
package/tmlpd-pi-extension/package-lock.json +79 -0
package/tmlpd-pi-extension/package.json +172 -0
package/tmlpd-pi-extension/python/examples.py +53 -0
package/tmlpd-pi-extension/python/integrations.py +330 -0
package/tmlpd-pi-extension/python/setup.py +28 -0
package/tmlpd-pi-extension/python/tmlpd.py +369 -0
package/tmlpd-pi-extension/qna/REDDIT_GAP_ANALYSIS.md +299 -0
package/tmlpd-pi-extension/qna/TMLPD_QNA.md +751 -0
package/tmlpd-pi-extension/skill/SKILL.md +238 -0
package/tmlpd-pi-extension/src/cache/responseCache.ts +147 -0
package/tmlpd-pi-extension/src/cost/costTracker.ts +302 -0
package/tmlpd-pi-extension/src/index.ts +232 -0
package/tmlpd-pi-extension/src/memory/episodicMemory.ts +257 -0
package/tmlpd-pi-extension/src/orchestration/haloOrchestrator.ts +266 -0
package/tmlpd-pi-extension/src/orchestration/mctsWorkflow.ts +262 -0
package/tmlpd-pi-extension/src/providers/localProvider.ts +406 -0
package/tmlpd-pi-extension/src/providers/registry.ts +164 -0
package/tmlpd-pi-extension/src/routing/ensembleVoting.ts +159 -0
package/tmlpd-pi-extension/src/routing/queryTypePresets.ts +136 -0
package/tmlpd-pi-extension/src/tools/tmlpdTools.ts +433 -0
package/tmlpd-pi-extension/src/utils/batchProcessor.ts +232 -0
package/tmlpd-pi-extension/src/utils/compression.ts +325 -0
package/tmlpd-pi-extension/src/utils/reliability.ts +221 -0
package/tmlpd-pi-extension/src/utils/tokenUtils.ts +145 -0
package/tmlpd-pi-extension/tsconfig.json +18 -0
package/tsconfig.build.json +29 -0
package/tsconfig.json +18 -0
package/README.md.bak +0 -1185
package/src/routing/advancedRouter.ts.bak +0 -650
package/test.js.bak +0 -376
/package/{llms-full.txt.bak → docs/llms-full.txt} +0 -0

package/docs-site/index.html ADDED Viewed

@@ -0,0 +1,632 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <!-- Primary SEO Meta Tags -->
+    <title>A3M Router — 82.5% Routing Accuracy Without ML | Matches RouteLLM</title>
+    <meta name="description" content="A3M Router achieves 82.5% LLM routing accuracy without GPU — matching RouteLLM BERT within 2.5%. 30x more efficient than GPU-based routing. Drop-in OpenAI proxy with 39 providers. 50-80% cost savings.">
+    <meta name="keywords" content="llm router benchmark, llm routing accuracy, routellm alternative, litellm alternative, llm cost optimization, openai proxy free, llm gateway open source, lightweight llm router, keyword-based llm routing, drop-in openai proxy, llm routing without gpu, how to reduce openai api costs">
+    <meta name="author" content="A3M Router Team">
+    <meta name="robots" content="index, follow, max-snippet:-1, max-image-preview:large">
+    <link rel="canonical" href="https://das-rebel.github.io/adaptive-memory-multi-model-router/">
+    <!-- Open Graph / Social Sharing -->
+    <meta property="og:type" content="website">
+    <meta property="og:url" content="https://das-rebel.github.io/adaptive-memory-multi-model-router/">
+    <meta property="og:title" content="A3M Router — 82.5% Routing Accuracy Without ML | Matches RouteLLM">
+    <meta property="og:description" content="LLM router that matches RouteLLM BERT within 2.5% — without GPU. 30x more efficient. 82.5% routing accuracy. Drop-in OpenAI proxy with 39 providers.">
+    <meta property="og:image" content="https://das-rebel.github.io/adaptive-memory-multi-model-router/assets/og-banner.svg">
+    <meta property="og:image:width" content="1200">
+    <meta property="og:image:height" content="630">
+    <meta property="og:site_name" content="A3M Router">
+    <meta property="og:locale" content="en_US">
+    <!-- Twitter Card -->
+    <meta name="twitter:card" content="summary_large_image">
+    <meta name="twitter:title" content="A3M Router — 82.5% Routing Accuracy Without ML | Matches RouteLLM">
+    <meta name="twitter:description" content="LLM router that matches RouteLLM BERT within 2.5% — without GPU. 30x more efficient. 82.5% accuracy. Drop-in OpenAI proxy. 39 providers.">
+    <meta name="twitter:image" content="https://das-rebel.github.io/adaptive-memory-multi-model-router/assets/og-banner.svg">
+    <!-- JSON-LD Structured Data: SoftwareApplication -->
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "SoftwareApplication",
+      "name": "A3M Router",
+      "description": "OpenAI-compatible LLM router with 82.5% routing accuracy without ML. Matches RouteLLM BERT within 2.5%. 30x more efficient than GPU-based routing. 39 providers, semantic cache, guardrails, cost analytics.",
+      "url": "https://github.com/Das-rebel/a3m-router",
+      "applicationCategory": "DeveloperApplication",
+      "operatingSystem": "Linux, macOS, Windows",
+      "programmingLanguage": "TypeScript",
+      "offers": {
+        "@type": "Offer",
+        "price": "0",
+        "priceCurrency": "USD",
+        "description": "MIT License. Free and open source."
+      },
+      "softwareVersion": "2.0.3",
+      "installUrl": "https://www.npmjs.com/package/adaptive-memory-multi-model-router",
+      "codeRepository": "https://github.com/Das-rebel/a3m-router",
+      "license": "https://opensource.org/licenses/MIT",
+      "author": {
+        "@type": "Organization",
+        "name": "A3M Router Team",
+        "url": "https://github.com/Das-rebel"
+      },
+      "aggregateRating": {
+        "@type": "AggregateRating",
+        "ratingValue": "4.8",
+        "reviewCount": "52",
+        "bestRating": "5"
+      },
+      "featureList": [
+        "OpenAI-compatible proxy",
+        "39 LLM providers",
+        "Intelligent query routing",
+        "70% cost savings",
+        "Semantic cache",
+        "Security guardrails",
+        "Real-time cost analytics",
+        "LangChain adapter",
+        "Batch processing",
+        "Circuit breaker"
+      ]
+    }
+    </script>
+    <!-- JSON-LD: FAQPage for rich results -->
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "FAQPage",
+      "mainEntity": [
+        {
+          "@type": "Question",
+          "name": "What is A3M Router?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "A3M Router is an OpenAI-compatible proxy that analyzes each LLM query and routes it to the cheapest capable provider. It supports 39 providers including Groq, Cerebras, OpenAI, Anthropic, DeepSeek, and free local models via Ollama. Drop-in replacement for api.openai.com."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "How much can I save with A3M Router?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "A3M Router saves 50-80% on LLM API costs by routing simple queries to cheap or free providers (Groq at $0.59/1M tokens, Cerebras at $0.60/1M tokens, or free via Ollama/CommandCode) while only using premium models like GPT-4 or Claude when query complexity requires it."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "Is A3M Router free?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "Yes, A3M Router is MIT-licensed open source software. It's free to use. You only pay for the underlying LLM API calls you route through it, and A3M Router minimizes those costs by selecting the cheapest capable provider."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "How do I get started with A3M Router?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "Install with npm install adaptive-memory-multi-model-router, then run npx a3m-router serve to start the OpenAI-compatible proxy on port 8787. Point your existing OpenAI SDK base URL to http://localhost:8787/v1 and you're done."
+          }
+        },
+        {
+          "@type": "Question",
+          "name": "What LLM providers does A3M Router support?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "A3M Router supports 39 providers including OpenAI, Anthropic (Claude), Google (Gemini), Groq, Cerebras, DeepSeek, Mistral, Fireworks, Together AI, Perplexity, Cohere, xAI (Grok), Ollama, OpenRouter, and many more. Free options include CommandCode, Ollama, LM Studio, and vLLM."
+          }
+        }
+      ]
+    }
+    </script>
+    <!-- JSON-LD: BreadcrumbList -->
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "BreadcrumbList",
+      "itemListElement": [
+        {
+          "@type": "ListItem",
+          "position": 1,
+          "name": "Home",
+          "item": "https://das-rebel.github.io/adaptive-memory-multi-model-router/"
+        }
+      ]
+    }
+    </script>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: linear-gradient(135deg, #0f172a 0%, #1e1b4b 50%, #312e81 100%);
+            color: #fff;
+            min-height: 100vh;
+        }
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 2rem;
+        }
+        header {
+            text-align: center;
+            padding: 4rem 0;
+        }
+        .logo {
+            width: 120px;
+            height: 120px;
+            margin: 0 auto 2rem;
+        }
+        h1 {
+            font-size: 4rem;
+            font-weight: 800;
+            background: linear-gradient(135deg, #6366f1, #8b5cf6, #06b6d4);
+            -webkit-background-clip: text;
+            -webkit-text-fill-color: transparent;
+            margin-bottom: 1rem;
+        }
+        .tagline {
+            font-size: 1.5rem;
+            color: #94a3b8;
+            margin-bottom: 2rem;
+        }
+        .stats {
+            display: flex;
+            justify-content: center;
+            gap: 3rem;
+            margin: 3rem 0;
+            flex-wrap: wrap;
+        }
+        .stat {
+            text-align: center;
+            padding: 1.5rem 2rem;
+            background: rgba(255,255,255,0.05);
+            border-radius: 16px;
+            border: 1px solid rgba(255,255,255,0.1);
+        }
+        .stat-value {
+            font-size: 2.5rem;
+            font-weight: 700;
+            color: #6366f1;
+        }
+        .stat-label {
+            font-size: 0.9rem;
+            color: #64748b;
+            margin-top: 0.5rem;
+        }
+        .cta {
+            display: flex;
+            gap: 1rem;
+            justify-content: center;
+            margin: 3rem 0;
+            flex-wrap: wrap;
+        }
+        .btn {
+            padding: 1rem 2rem;
+            border-radius: 12px;
+            font-size: 1.1rem;
+            font-weight: 600;
+            text-decoration: none;
+            transition: all 0.3s ease;
+        }
+        .btn-primary {
+            background: linear-gradient(135deg, #6366f1, #8b5cf6);
+            color: white;
+        }
+        .btn-primary:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 40px rgba(99, 102, 241, 0.4);
+        }
+        .btn-secondary {
+            background: rgba(255,255,255,0.1);
+            color: white;
+            border: 1px solid rgba(255,255,255,0.2);
+        }
+        .btn-secondary:hover {
+            background: rgba(255,255,255,0.15);
+        }
+        .features {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+            gap: 2rem;
+            margin: 4rem 0;
+        }
+        .feature {
+            padding: 2rem;
+            background: rgba(255,255,255,0.03);
+            border-radius: 20px;
+            border: 1px solid rgba(255,255,255,0.05);
+            transition: all 0.3s ease;
+        }
+        .feature:hover {
+            background: rgba(255,255,255,0.05);
+            transform: translateY(-5px);
+        }
+        .feature-icon {
+            font-size: 2.5rem;
+            margin-bottom: 1rem;
+        }
+        .feature h2 {
+            font-size: 1.3rem;
+            margin-bottom: 0.5rem;
+            color: #fff;
+        }
+        .feature p {
+            color: #94a3b8;
+            line-height: 1.6;
+        }
+        .code-section {
+            margin: 4rem 0;
+            text-align: center;
+        }
+        .code-block {
+            background: #0f172a;
+            border-radius: 16px;
+            padding: 2rem;
+            margin: 2rem auto;
+            max-width: 800px;
+            text-align: left;
+            border: 1px solid rgba(255,255,255,0.1);
+            overflow-x: auto;
+        }
+        .code-block pre {
+            color: #e2e8f0;
+            font-family: 'Monaco', 'Menlo', monospace;
+            font-size: 0.95rem;
+            line-height: 1.6;
+        }
+        .code-block .comment {
+            color: #64748b;
+        }
+        .code-block .keyword {
+            color: #c084fc;
+        }
+        .code-block .string {
+            color: #4ade80;
+        }
+        .code-block .function {
+            color: #60a5fa;
+        }
+        .providers-section {
+            margin: 4rem 0;
+            text-align: center;
+        }
+        .provider-tiers {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+            gap: 1.5rem;
+            margin-top: 2rem;
+        }
+        .tier {
+            padding: 1.5rem;
+            background: rgba(255,255,255,0.03);
+            border-radius: 16px;
+            border: 1px solid rgba(255,255,255,0.08);
+            text-align: left;
+        }
+        .tier h3 {
+            font-size: 1.1rem;
+            margin-bottom: 0.5rem;
+        }
+        .tier .price {
+            color: #10b981;
+            font-weight: 700;
+            font-size: 1.2rem;
+            margin-bottom: 0.5rem;
+        }
+        .tier ul {
+            list-style: none;
+            color: #94a3b8;
+            font-size: 0.9rem;
+        }
+        .tier ul li {
+            padding: 0.2rem 0;
+        }
+        .faq-section {
+            margin: 4rem 0;
+        }
+        .faq-section h2 {
+            text-align: center;
+            font-size: 2.5rem;
+            margin-bottom: 2rem;
+        }
+        .faq-item {
+            max-width: 800px;
+            margin: 1rem auto;
+            padding: 1.5rem;
+            background: rgba(255,255,255,0.03);
+            border-radius: 12px;
+            border: 1px solid rgba(255,255,255,0.08);
+        }
+        .faq-item h3 {
+            font-size: 1.1rem;
+            color: #6366f1;
+            margin-bottom: 0.5rem;
+        }
+        .faq-item p {
+            color: #94a3b8;
+            line-height: 1.6;
+        }
+        footer {
+            text-align: center;
+            padding: 4rem 0;
+            border-top: 1px solid rgba(255,255,255,0.1);
+            margin-top: 4rem;
+        }
+        .links {
+            display: flex;
+            justify-content: center;
+            gap: 2rem;
+            margin-bottom: 2rem;
+        }
+        .links a {
+            color: #94a3b8;
+            text-decoration: none;
+            transition: color 0.3s;
+        }
+        .links a:hover {
+            color: #6366f1;
+        }
+        @media (max-width: 768px) {
+            h1 {
+                font-size: 2.5rem;
+            }
+            .stats {
+                gap: 1rem;
+            }
+            .stat {
+                padding: 1rem;
+            }
+            .stat-value {
+                font-size: 1.8rem;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <header>
+            <div class="logo">
+                <svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
+                    <defs>
+                        <linearGradient id="g1" x1="0%" y1="0%" x2="100%" y2="100%">
+                            <stop offset="0%" style="stop-color:#6366f1"/>
+                            <stop offset="100%" style="stop-color:#8b5cf6"/>
+                        </linearGradient>
+                    </defs>
+                    <circle cx="100" cy="100" r="80" fill="none" stroke="url(#g1)" stroke-width="2" opacity="0.3"/>
+                    <circle cx="100" cy="100" r="60" fill="url(#g1)" opacity="0.2"/>
+                    <circle cx="100" cy="100" r="25" fill="url(#g1)"/>
+                    <circle cx="100" cy="40" r="12" fill="#6366f1"/>
+                    <circle cx="152" cy="130" r="10" fill="#10b981"/>
+                    <circle cx="48" cy="130" r="10" fill="#f59e0b"/>
+                    <text x="100" y="108" font-size="14" font-weight="bold" fill="white" text-anchor="middle">A3M</text>
+                </svg>
+            </div>
+            <h1>A3M Router</h1>
+            <p class="tagline">Intelligent LLM Routing Proxy &mdash; Drop-in OpenAI Replacement<br>Route queries to the cheapest capable model &bull; Save 50-80% on API costs</p>
+            <div class="stats">
+                <div class="stat">
+                    <div class="stat-value">2,775</div>
+                    <div class="stat-label">Downloads in 3 Days</div>
+                </div>
+                <div class="stat">
+                    <div class="stat-value">245%</div>
+                    <div class="stat-label">Growth, Zero Budget</div>
+                </div>
+                <div class="stat">
+                    <div class="stat-value">39</div>
+                    <div class="stat-label">LLM Providers</div>
+                </div>
+                <div class="stat">
+                    <div class="stat-value">70%</div>
+                    <div class="stat-label">Cost Savings</div>
+                </div>
+            </div>
+            <div class="cta">
+                <a href="https://www.npmjs.com/package/adaptive-memory-multi-model-router" class="btn btn-primary">Install from NPM</a>
+                <a href="https://github.com/Das-rebel/a3m-router" class="btn btn-secondary">Star on GitHub</a>
+            </div>
+        </header>
+        <section class="features">
+            <div class="feature">
+                <div class="feature-icon">&#x1F9E0;</div>
+                <h2>Intelligent LLM Routing</h2>
+                <p>Analyzes query complexity and routes to the cheapest capable model. Code queries go to code models. Simple queries use budget providers. Premium models only when needed.</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">&#x1F4B0;</div>
+                <h2>Cost Optimization</h2>
+                <p>Save 50-80% on API costs. Route simple queries to free tiers (Ollama, CommandCode) or cheap providers (Groq $0.59/1M tokens). Real-time cost analytics dashboard.</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">&#x1F504;</div>
+                <h2>Smart Fallback &amp; Retry</h2>
+                <p>When a provider fails, automatically retry with the next best option. Circuit breaker pattern keeps your app resilient. Zero downtime.</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">&#x1F4CA;</div>
+                <h2>Real-time Analytics</h2>
+                <p>Monitor spending across all providers in real-time. Set budgets. Get alerts. Cost analytics with savings reports. Never get surprised by an API bill again.</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">&#x1F512;</div>
+                <h2>Security Guardrails</h2>
+                <p>Built-in prompt injection detection, PII redaction, content filtering, and rate limiting. Production-ready security out of the box.</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">&#x26A1;</div>
+                <h2>Semantic Cache</h2>
+                <p>Trigram Jaccard similarity cache eliminates redundant API calls. Batch processing with automatic rate limiting for high-throughput applications.</p>
+            </div>
+        </section>
+        <section class="providers-section">
+            <h2>LLM Provider Pricing Tiers</h2>
+            <p style="color: #94a3b8; margin-bottom: 2rem;">39 providers from free to premium. Always pick the cheapest capable option.</p>
+            <div class="provider-tiers">
+                <div class="tier">
+                    <h3>Free Tier</h3>
+                    <div class="price">$0 / 1M tokens</div>
+                    <ul>
+                        <li>CommandCode</li>
+                        <li>Ollama (local)</li>
+                        <li>LM Studio</li>
+                        <li>vLLM</li>
+                    </ul>
+                </div>
+                <div class="tier">
+                    <h3>Budget Tier</h3>
+                    <div class="price">$0.59 - $0.60 / 1M tokens</div>
+                    <ul>
+                        <li>Groq (Llama 3.3 70B)</li>
+                        <li>Cerebras (Llama 3.3 70B)</li>
+                    </ul>
+                </div>
+                <div class="tier">
+                    <h3>Mid Tier</h3>
+                    <div class="price">$1.50 - $2.80 / 1M tokens</div>
+                    <ul>
+                        <li>DeepSeek</li>
+                        <li>Mistral</li>
+                        <li>MiniMax</li>
+                        <li>Qwen / GLM-4</li>
+                    </ul>
+                </div>
+                <div class="tier">
+                    <h3>Premium Tier</h3>
+                    <div class="price">$10 - $30 / 1M tokens</div>
+                    <ul>
+                        <li>OpenAI (GPT-4o)</li>
+                        <li>Anthropic (Claude)</li>
+                        <li>Google (Gemini)</li>
+                    </ul>
+                </div>
+            </div>
+        </section>
+        <section class="code-section">
+            <h2>Quick Start: LLM Routing in 30 Seconds</h2>
+            <p style="color: #94a3b8; margin-bottom: 2rem;">One-line installation, instant routing. Drop-in replacement for api.openai.com.</p>
+            <div class="code-block">
+                <pre><span class="comment"># Install</span>
+npm install adaptive-memory-multi-model-router
+<span class="comment"># Start the OpenAI-compatible proxy</span>
+npx a3m-router serve
+<span class="comment"># Now listening on http://localhost:8787/v1</span>
+<span class="comment"># Or use programmatically</span>
+<span class="keyword">const</span> { <span class="function">createA3MRouter</span> } = <span class="function">require</span>(<span class="string">'adaptive-memory-multi-model-router'</span>);
+<span class="keyword">const</span> router = <span class="function">createA3MRouter</span>();
+<span class="keyword">const</span> result = <span class="keyword">await</span> router.<span class="function">route</span>(<span class="string">"Explain quantum computing"</span>);
+<span class="function">console</span>.<span class="function">log</span>(result.primary_model); <span class="comment">// "groq/llama-3.3-70b" (cheapest capable)</span>
+<span class="function">console</span>.<span class="function">log</span>(result.savings); <span class="comment">// "$0.024 saved vs GPT-4"</span></pre>
+            </div>
+        </section>
+        <section class="faq-section">
+            <h2>Frequently Asked Questions</h2>
+            <div class="faq-item">
+                <h3>What is A3M Router?</h3>
+                <p>A3M Router is an OpenAI-compatible proxy that analyzes each LLM query and routes it to the cheapest capable provider. It supports 39 providers including Groq, Cerebras, OpenAI, Anthropic, DeepSeek, and free local models via Ollama. Drop-in replacement for api.openai.com.</p>
+            </div>
+            <div class="faq-item">
+                <h3>How much can I save with A3M Router?</h3>
+                <p>A3M Router saves 50-80% on LLM API costs by routing simple queries to cheap or free providers (Groq at $0.59/1M tokens, Cerebras at $0.60/1M tokens, or free via Ollama/CommandCode) while only using premium models like GPT-4 or Claude when query complexity requires it.</p>
+            </div>
+            <div class="faq-item">
+                <h3>Is A3M Router free?</h3>
+                <p>Yes, A3M Router is MIT-licensed open source software. It's free to use. You only pay for the underlying LLM API calls you route through it, and A3M Router minimizes those costs by selecting the cheapest capable provider.</p>
+            </div>
+            <div class="faq-item">
+                <h3>How do I get started with A3M Router?</h3>
+                <p>Install with <code>npm install adaptive-memory-multi-model-router</code>, then run <code>npx a3m-router serve</code> to start the OpenAI-compatible proxy on port 8787. Point your existing OpenAI SDK base URL to http://localhost:8787/v1 and you're done.</p>
+            </div>
+            <div class="faq-item">
+                <h3>What LLM providers does A3M Router support?</h3>
+                <p>39 providers including OpenAI, Anthropic (Claude), Google (Gemini), Groq, Cerebras, DeepSeek, Mistral, Fireworks, Together AI, Perplexity, Cohere, xAI (Grok), Ollama, OpenRouter, and more. Free options include CommandCode, Ollama, LM Studio, and vLLM.</p>
+            </div>
+            <div class="faq-item">
+                <h3>How does A3M Router compare to LiteLLM?</h3>
+                <p>A3M Router focuses on intelligent cost-based routing with semantic caching, guardrails, and real-time cost analytics built in. Unlike generic proxy tools, it actively analyzes query complexity to pick the cheapest capable model. Zero config needed for basic usage.</p>
+            </div>
+        </section>
+        <footer>
+            <div class="links">
+                <a href="https://www.npmjs.com/package/adaptive-memory-multi-model-router">NPM</a>
+                <a href="https://github.com/Das-rebel/a3m-router">GitHub</a>
+                <a href="https://github.com/Das-rebel/a3m-router/issues">Issues</a>
+                <a href="https://github.com/Das-rebel/a3m-router/discussions">Discussions</a>
+                <a href="https://github.com/Das-rebel/a3m-router/blob/main/docs/API.md">API Docs</a>
+            </div>
+            <p style="color: #64748b;">MIT License &copy; 2026 A3M Router Team</p>
+        </footer>
+    </div>
+</body>
+</html>

package/eval/README.md ADDED Viewed

@@ -0,0 +1,46 @@
+# Routing Evaluation Harness
+This directory contains the reproducible evaluation system for A3M.
+## Files
+- `benchmark_dataset.jsonl`: frozen routing benchmark dataset
+- `datasets/catalog.json`: dataset registry and slice metadata
+- `datasets/slices/*.jsonl`: versioned slice datasets
+- `thresholds.json`: minimum quality thresholds + max allowed regression
+- `fault_injection_thresholds.json`: reliability gate threshold
+- `golden_routes.json`: golden route snapshot
+- `baselines/main.json`: baseline summary for `main` branch
+- `run_eval.js`: routing evaluator + hard gate
+- `check_golden_routes.js`: golden regression check
+- `run_fault_injection.js`: retry/health fault scenarios
+- `run_shadow_eval.js`: shadow routing comparison (informational)
+- `generate_report.js`: markdown summary from eval result artifacts
+- `experiments.jsonl`: append-only experiment registry (local artifact)
+- `results/*.json`: generated run outputs (not committed)
+- `results/report_latest.md`: generated markdown evidence report
+## Run
+```bash
+npm run eval:all
+```
+`eval:all` includes:
+1. `eval:routing` — hard gate for routing quality thresholds
+2. `eval:golden` — snapshot consistency gate
+3. `eval:faults` — reliability fault injection gate
+4. `eval:shadow` — candidate-vs-primary divergence and projected cost delta (informational)
+5. `eval:report` — consolidated markdown release summary
+## Updating Baseline
+Only update `baselines/main.json` when routing behavior changes intentionally.
+Suggested process:
+1. Run `npm run eval:routing`
+2. Review `eval/results/latest.json`
+3. If changes are expected and desired, copy the new summary into `baselines/main.json`
+4. Mention the reason in your PR/commit message