adaptive-memory-multi-model-router 2.15.4 → 2.16.0

package/summary.txt

@@ -0,0 +1,38 @@
+## A3M Router Integration Status (2026-08-04)
+
+### ✅ COMPLETED
+- CrewAI PR #1: MERGED (June 3, 2026) - A3M Router support added to CrewAI
+- Created 18+ A3M integration repos:
+  - browser-use (108k stars)
+  - a3m-llamaindex, a3m-cursor-mcp, a3m-salesforce, a3m-hubspot, a3m-github-copilot
+  - a3m-vercel-ai (npm published v0.1.0)
+  - a3m-llamaindex, a3m-cursor-mcp, a3m-autogen, a3m-google-workspace, a3m-vercel-ai
+- Updated README and PRs to remove RouterArena rank claims
+- Created 100+ integration opportunities list
+
+### 🔴 IN PROGRESS
+1. **browser-use PR #5378**: 
+   - Status: OPEN
+   - Issue: CLA not signed (author email not linked to GitHub)
+   - Action: Sign CLA, fix commit author, push to main branch
+   
+2. **CrewAI PR #6794**: 
+   - Status: OPEN with 2 reviews
+   - Need to address remaining review comments
+   - Already implemented all requested changes from review
+
+3. **n8n Community Node**
+   - Repo created: https://github.com/Das-rebel/n8n-nodes-a3m-router
+   - Files created: README, package.json, example.ts, index.ts, package.json
+   - Need to: 
+     - Fix directory structure
+     - Add proper n8n-node CLI integration
+     - Push to GitHub and create PR
+
+### 🔜 Next Steps:
+1. Fix browser-use PR CLA issue (priority #1)
+2. Complete n8n node submission
+3. Create AutoGen/LangChain examples
+4. Target enterprise integrations (Salesforce, GitHub Copilot)
+
+## 🚀 Ready for next actions!

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,94 +0,0 @@
----
-name: Bug Report
-about: Report a bug or unexpected behavior to help us improve A3M Router
-title: "[Bug] "
-labels: bug, needs-triage
-assignees: ""
----
-
-## Description
-
-A clear and concise description of the bug.
-
-## Reproduction Steps
-
-Steps to reproduce the behavior:
-
-```bash
-# 1. Set up (if applicable)
-export PROVIDER_API_KEY=sk-...
-
-# 2. Run
-npx a3m-router route "Your query here"
-```
-
-If using the SDK, provide a minimal code snippet:
-
-```typescript
-import { A3MRouter } from "adaptive-memory-multi-model-router";
-
-const router = new A3MRouter({ /* your config */ });
-const result = await router.route("Your query");
-```
-
-## Expected Behavior
-
-What did you expect to happen?
-
-## Actual Behavior
-
-What actually happened? Include error messages, stack traces, or unexpected output.
-
-```
-Paste error output or logs here
-```
-
-## A3M Router Version
-
-- Package: `adaptive-memory-multi-model-router@<version>` (run `npm list adaptive-memory-multi-model-router`)
-- CLI version (if applicable): `npx a3m-router --version`
-
-## Environment
-
-- **OS:** macOS / Linux / Windows
-- **Node.js version:** (run `node --version`)
-- **npm version:** (run `npm --version`)
-- **Python version (if using Python SDK):** (run `python --version`)
-
-## Providers Used
-
-Which provider(s) were involved? (e.g., Groq, OpenAI, Anthropic, NVIDIA, DeepSeek, custom)
-
-## Configuration
-
-Attach or describe relevant config (redact API keys):
-
-```json
-{
-  "providers": { ... },
-  "routing": { ... },
-  "budgets": { ... }
-}
-```
-
-## Logs
-
-If you ran with `DEBUG=*` or `LOG_LEVEL=debug`, include relevant log lines:
-
-```
-[DEBUG] Routing query...
-[ERROR] Provider groq returned 503
-```
-
-## Additional Context
-
-- Does this happen consistently or intermittently?
-- Does it affect all providers or a specific one?
-- Did it work in a previous version? If so, which version?
-- Any recent changes to your setup?
-
-## Checklist
-
-- [ ] I have searched existing issues for duplicates
-- [ ] I have redacted all API keys and secrets from the above
-- [ ] I can reliably reproduce this bug

package/.github/ISSUE_TEMPLATE/config.yml

@@ -1,17 +0,0 @@
-blank_issues_enabled: false
-contact_links:
-  - name: "\U0001F4D6 Documentation & Quick Start"
-    url: https://github.com/Das-rebel/a3m-router#readme
-    about: Check the README for setup, SDK usage, API reference, and configuration examples
-  - name: "\U0001F4AC Discussions & Community"
-    url: https://github.com/Das-rebel/a3m-router/discussions
-    about: Ask questions, share ideas, show what you've built, and get help from the community
-  - name: "\U0001F680 NPM Package"
-    url: https://www.npmjs.com/package/adaptive-memory-multi-model-router
-    about: View package details, version history, and download statistics
-  - name: "\U0001F4DC Changelog"
-    url: https://github.com/Das-rebel/a3m-router/blob/main/CHANGELOG.md
-    about: See what's changed in recent releases
-  - name: "\U0001F6A8 Security"
-    url: https://github.com/Das-rebel/a3m-router/security/policy
-    about: Report security vulnerabilities privately

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,71 +0,0 @@
----
-name: Feature Request
-about: Suggest an idea or enhancement for A3M Router
-title: "[Feature] "
-labels: enhancement
-assignees: ""
----
-
-## Problem Statement
-
-A clear description of the problem you're trying to solve. What gap or pain point does this feature address?
-
-**Example:** "Currently, A3M Router doesn't support routing based on response language. When I send multilingual queries, I want them routed to providers that perform best in that language."
-
-## Proposed Solution
-
-Describe the feature you'd like to see. Be as specific as possible about behavior, configuration, and API.
-
-```typescript
-// If applicable, sketch the API you envision
-const router = new A3MRouter({
-  languageRouting: {
-    enabled: true,
-    defaultProvider: "openai",
-    languageOverrides: {
-      ja: "anthropic",
-      zh: "deepseek",
-    },
-  },
-});
-```
-
-## Use Case
-
-Describe the real-world scenario that would benefit from this feature.
-
-- Who is the target user? (e.g., solo developer, enterprise team, researcher)
-- What workflow does it enable or simplify?
-- How frequently would this be used?
-
-## Alternatives Considered
-
-List any workarounds or alternative approaches you've explored:
-
-1. Manual provider selection per query
-2. Custom wrapper script
-3. Forking and modifying the router
-4. Using a different tool altogether
-
-Explain why these are insufficient.
-
-## Priority
-
-How important is this to you?
-
-- [ ] **Blocking** — Cannot proceed without this feature
-- [ ] **High** — Important for my workflow
-- [ ] **Medium** — Nice to have
-- [ ] **Low** — Interesting idea, not urgent
-
-## Would You Implement It?
-
-- [ ] **Yes** — I can submit a PR (with guidance)
-- [ ] **Maybe** — Willing to help test or provide requirements
-- [ ] **No** — Just suggesting
-
-## Additional Context
-
-- Links to related discussions, issues, or external references
-- Screenshots or mockups (if applicable)
-- Any constraints or requirements (e.g., must work offline, must not increase bundle size)

package/.well-known/ai-plugin.json

@@ -1,16 +0,0 @@
-{
-  "schema_version": "v1",
-  "name_for_human": "A3M Router",
-  "name_for_model": "a3m_router",
-  "description_for_human": "LLM routing proxy — #1 on RouterArena (0.9404 / 96.77%) at $0.0768/1K. Rule-based, no ML, 47+ providers.",
-  "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 0.9404 / 96.77% at $0.0768 per 1K queries (arXiv:2510.00202).",
-  "api": {
-    "type": "openapi",
-    "url": "https://das-rebel.github.io/a3m-router/docs/openapi.json"
-  },
-  "auth": {
-    "type": "none"
-  },
-  "contact_email": "Sdas22@gmail.com",
-  "legal_info_url": "https://github.com/Das-rebel/a3m-router/blob/main/LICENSE"
-}

package/adapters/README.md

@@ -1,36 +0,0 @@
-# A3M Router Adapters
-
-Drop-in adapters for LangChain and LlamaIndex to integrate with A3M Router for intelligent model routing.
-
-## Installation
-
-```bash
-pip install a3m_adapter
-```
-
-Or install with extras:
-
-```bash
-pip install a3m_adapter[langchain]  # With LangChain support
-pip install a3m_adapter[llamaindex]  # With LlamaIndex support
-```
-
-## Usage
-
-### LangChain
-
-```python
-from a3m_adapter import A3MLangChainAdapter
-
-llm = A3MLangChainAdapter(model="auto", temperature=0.7)
-result = llm.invoke("What is the capital of France?")
-```
-
-### LlamaIndex
-
-```python
-from a3m_adapter import A3MLlamaIndexAdapter
-
-llm = A3MLlamaIndexAdapter(model="auto")
-response = llm.complete("What is the capital of France?")
-```

package/adapters/__init__.py

@@ -1,25 +0,0 @@
-"""
-A3M Router Adapter Package
-
-This package provides drop-in adapters to integrate A3M Router
-with popular LLM frameworks including LangChain, LlamaIndex, and more.
-
-Usage:
-    from adapters import A3MLangChainAdapter, A3MLlamaIndexAdapter, A3MConfig
-    
-    # LangChain
-    llm = A3MLangChainAdapter(model="auto", temperature=0.7)
-    
-    # LlamaIndex
-    llm = A3MLlamaIndexAdapter(model="auto")
-    
-    # Configuration
-    config = A3MConfig(model="auto", parallel_ensemble=2)
-"""
-
-from .a3m_adapter.adapter.langchain import A3MLangChainAdapter
-from .a3m_adapter.adapter.llamaindex import A3MLlamaIndexAdapter
-from .a3m_adapter.adapter.config import A3MConfig
-
-__all__ = ['A3MLangChainAdapter', 'A3MLlamaIndexAdapter', 'A3MConfig']
-__version__ = '1.0.0'

package/adapters/a3m_adapter/__init__.py

@@ -1,15 +0,0 @@
-"""
-A3M Router Adapters for LLM Frameworks.
-
-Provides drop-in adapters for:
-- LangChain (A3MLangChainAdapter)
-- LlamaIndex (A3MLlamaIndexAdapter)
-- Configuration management (A3MConfig)
-"""
-
-from .adapter.langchain import A3MLangChainAdapter
-from .adapter.llamaindex import A3MLlamaIndexAdapter
-from .adapter.config import A3MConfig
-
-__all__ = ['A3MLangChainAdapter', 'A3MLlamaIndexAdapter', 'A3MConfig']
-__version__ = '1.0.0'

package/adapters/a3m_adapter/adapter/__init__.py

@@ -1,7 +0,0 @@
-"""A3M Router adapter implementations."""
-
-from .langchain import A3MLangChainAdapter
-from .llamaindex import A3MLlamaIndexAdapter
-from .config import A3MConfig
-
-__all__ = ['A3MLangChainAdapter', 'A3MLlamaIndexAdapter', 'A3MConfig']

package/adapters/a3m_adapter/adapter/config.py

@@ -1,100 +0,0 @@
-"""
-Configuration management for A3M Router adapters.
-
-Provides settings for:
-- Default model selection strategy
-- Cost optimization thresholds
-- Parallel ensemble settings
-- Provider priority lists
-
-Usage:
-    from a3m_adapter_config import A3MConfig
-    
-    config = A3MConfig.from_file("a3m_config.yaml")
-    llm = A3MChatModel(**config.to_dict())
-"""
-
-from __future__ import annotations
-
-import json
-import logging
-from dataclasses import dataclass, field, asdict
-from typing import Any, Dict, List, Optional, Union
-
-logger = logging.getLogger(__name__)
-
-
-@dataclass
-class A3MConfig:
-    """Configuration for A3M Router adapters."""
-
-    # Model selection
-    model: str = "auto"
-    
-    # Sampling parameters
-    temperature: float = 0.0
-    max_tokens: Optional[int] = 4096
-    top_p: float = 1.0
-    frequency_penalty: float = 0.0
-    presence_penalty: float = 0.0
-
-    # Routing strategy
-    parallel_ensemble: int = 1
-    fallback_enabled: bool = True
-    cost_threshold: float = 0.05  # Max $ per 1k tokens
-    
-    # Provider preferences (highest priority first)
-    preferred_providers: List[str] = field(default_factory=lambda: [
-        "openai", "anthropic", "google", "azure_openai", 
-        "azure_ais", "litellm", "groq", "together"
-    ])
-    
-    # Excluded providers (never use)
-    excluded_providers: List[str] = field(default_factory=lambda: [])
-    
-    # API configuration
-    api_endpoint: str = "http://localhost:8787/v1"
-    api_key: Optional[str] = None
-
-    # Budget controls
-    monthly_budget_usd: Optional[float] = None
-    daily_budget_usd: Optional[float] = None
-
-    @classmethod
-    def from_file(cls, path: str) -> "A3MConfig":
-        """Load configuration from YAML file."""
-        try:
-            import yaml
-            with open(path, 'r') as f:
-                data = yaml.safe_load(f)
-            return cls(**data)
-        except ImportError:
-            logger.warning("PyYAML not installed, using JSON")
-            return cls.from_json(path)
-
-    @classmethod
-    def from_json(cls, path: str) -> "A3MConfig":
-        """Load configuration from JSON file."""
-        with open(path, 'r') as f:
-            data = json.load(f)
-        return cls(**data)
-
-    def to_dict(self) -> Dict[str, Any]:
-        """Convert to dictionary."""
-        return asdict(self)
-
-    def to_json(self, path: Optional[str] = None) -> Optional[str]:
-        """Convert to JSON string or save to file."""
-        data = json.dumps(self.to_dict(), indent=2)
-        if path:
-            with open(path, 'w') as f:
-                f.write(data)
-        return data
-
-    def update_budget_limits(self, remaining_usd: float) -> None:
-        """Update budget limits based on remaining funds."""
-        if self.daily_budget_usd is not None:
-            remaining_pct = remaining_usd / self.daily_budget_usd
-            if remaining_pct < 0.1:
-                logger.warning("Low daily budget: %s remaining", remaining_usd)
-                self.parallel_ensemble = 1  # Reduce to single-provider

package/adapters/a3m_adapter/adapter/langchain.py

@@ -1,155 +0,0 @@
-"""
-A3M Router Adapter for LangChain.
-
-Drop-in replacement for LangChain's ChatOpenAI that routes through A3M Router
-for intelligent, cost-optimized model selection across 47+ providers.
-"""
-
-from __future__ import annotations
-
-import logging
-from typing import Any, Dict, List, Optional
-
-logger = logging.getLogger(__name__)
-
-# Check availability
-LANGCHAIN_AVAILABLE = False
-try:
-    from langchain_core.language_models import BaseChatModel
-    from langchain_core.messages import AIMessage, BaseMessage, HumanMessage, SystemMessage, ToolMessage
-    from langchain_core.outputs import ChatGeneration, ChatResult, LLMResult
-    LANGCHAIN_AVAILABLE = True
-except ImportError:
-    logger.warning("LangChain not installed. Install with: pip install langchain langchain-core")
-
-A3M_AVAILABLE = False
-try:
-    from a3m.router import A3MRouter, RouteResponse
-    A3M_AVAILABLE = True
-except ImportError:
-    logger.warning("A3M Router not installed. Install with: pip install adaptive-memory-multi-model-router")
-
-
-class A3MLangChainAdapter:
-    """
-    A3M Router adapter for LangChain's ChatOpenAI interface.
-
-    Routes prompts through A3M Router to automatically select the cheapest
-    capable model across 47+ LLM providers.
-    """
-
-    def __init__(
-        self,
-        model: str = "auto",
-        temperature: float = 0.0,
-        max_tokens: Optional[int] = 4096,
-        parallel_ensemble: int = 1,
-        api_key: Optional[str] = None,
-        **kwargs: Any,
-    ) -> None:
-        """
-        Initialize A3M Router adapter.
-
-        Args:
-            model: Model name or "auto" for automatic routing
-            temperature: Sampling temperature
-            max_tokens: Maximum tokens to generate
-            parallel_ensemble: Number of providers to run in parallel
-            api_key: A3M API key (optional)
-        """
-        self.model = model
-        self.temperature = temperature
-        self.max_tokens = max_tokens
-        self.parallel_ensemble = parallel_ensemble
-        self.api_key = api_key
-        self._a3m_router = None
-        self._initialized = False
-
-    def _ensure_router(self) -> None:
-        """Lazily initialize the A3M router."""
-        if self._initialized:
-            return
-        
-        if not A3M_AVAILABLE:
-            raise ImportError(
-                "A3M Router is not installed. "
-                "Install with: pip install adaptive-memory-multi-model-router"
-            )
-        
-        self._a3m_router = A3MRouter(
-            model=self.model,
-            temperature=self.temperature,
-            parallel_ensemble=self.parallel_ensemble,
-        )
-        self._initialized = True
-        logger.info(
-            "A3M Router initialized: model=%s, ensemble=%d",
-            self.model,
-            self.parallel_ensemble,
-        )
-
-    @property
-    def _llm_type(self) -> str:
-        return "a3m_router"
-
-    def _generate(
-        self,
-        messages: List[BaseMessage],
-        stop: Optional[List[str]] = None,
-        run_manager: Any = None,
-        **kwargs: Any,
-    ) -> LLMResult:
-        """Generate a response using A3M Router."""
-        self._ensure_router()
-        
-        # Convert messages
-        a3m_messages = self._convert_messages(messages)
-
-        # Route through A3M
-        import asyncio
-        loop = asyncio.get_event_loop()
-        route_result = loop.run_in_executor(
-            None,
-            lambda: self._a3m_router.route(
-                messages=a3m_messages,
-                temperature=self.temperature,
-                max_tokens=self.max_tokens,
-                stop=stop,
-                **kwargs,
-            ),
-        )
-
-        ai_message = AIMessage(content=route_result.content)
-        generation = ChatGeneration(message=ai_message)
-        return LLMResult(generations=[[generation]])
-
-    def _convert_messages(self, messages: List[BaseMessage]) -> List[Dict[str, Any]]:
-        """Convert LangChain messages to A3M format."""
-        a3m_messages = []
-        for msg in messages:
-            if isinstance(msg, SystemMessage):
-                a3m_messages.append({"role": "system", "content": msg.content})
-            elif isinstance(msg, HumanMessage):
-                a3m_messages.append({"role": "user", "content": msg.content})
-            elif isinstance(msg, AIMessage):
-                a3m_messages.append({"role": "assistant", "content": msg.content})
-            elif isinstance(msg, ToolMessage):
-                a3m_messages.append(
-                    {"role": "tool", "content": msg.content, "tool_call_id": msg.tool_call_id}
-                )
-            else:
-                a3m_messages.append({"role": "user", "content": str(msg)})
-        return a3m_messages
-
-    def bind_tools(self, tools: List[Dict[str, Any]], **kwargs: Any) -> "A3MLangChainAdapter":
-        """Bind tools for function calling."""
-        return self
-
-    def __repr__(self) -> str:
-        return (
-            f"A3MLangChainAdapter("
-            f"model={self.model!r}, "
-            f"temperature={self.temperature}, "
-            f"max_tokens={self.max_tokens}, "
-            f"ensemble={self.parallel_ensemble})"
-        )