adaptive-memory-multi-model-router 2.15.4 → 2.16.0
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.
- package/AGENT_COUNCIL_FINDINGS.md +123 -98
- package/CAMPAIGN_SUMMARY.md +87 -0
- package/CHANGELOG.md +7 -1
- package/ENTERPRISE_INTEGRATIONS.md +94 -0
- package/INTEGRATION_PROGRESS.md +96 -0
- package/OPPORTUNITIES_100.md +277 -0
- package/POPULARITY_BOOSTERS.md +1 -1
- package/README.md +147 -275
- package/README_ja.md +17 -21
- package/README_zh.md +13 -17
- package/TODO_BROWSER_AUTOMATION.md +87 -0
- package/a3m-integrations-summary.md +73 -0
- package/apps/cost-calculator/README.md +72 -0
- package/apps/cost-calculator/calculator.css +280 -0
- package/apps/cost-calculator/calculator.js +150 -0
- package/apps/cost-calculator/index.html +321 -0
- package/apps/cost-calculator/package.json +13 -0
- package/articles/ANNOUNCEMENT_reddit_ml.md +76 -0
- package/articles/ANNOUNCEMENT_vc/347/244/276/345/214/272.md +71 -0
- package/articles/ANNOUNCEMENT_vercel.md +85 -0
- package/articles/CHINESE_DIRECTORIES.md +2 -2
- package/articles/CHINESE_SUBMISSIONS_READY.md +5 -5
- package/articles/HN_POST_READY.md +16 -20
- package/articles/INDIEHACKERS_READY.md +19 -34
- package/dist/analytics/costAnalytics.d.ts +0 -1
- package/dist/benchmark/reproducible.d.ts +0 -1
- package/dist/cache/semanticCache.d.ts +0 -1
- package/dist/cost/budgetEnforcer.d.ts +0 -1
- package/dist/cost/costTracker.d.ts +0 -1
- package/dist/ensemble/multiRoundDialog.d.ts +0 -1
- package/dist/ensemble/shapleyValue.d.ts +0 -1
- package/dist/ensemble.d.ts +0 -1
- package/dist/index.d.ts +0 -1
- package/dist/integrations/oauth.d.ts +0 -1
- package/dist/integrations/scienceAdapter.d.ts +0 -1
- package/dist/memory/autoFetch.d.ts +0 -1
- package/dist/memory/hybridMemory.d.ts +0 -1
- package/dist/memory/memoryTree.d.ts +0 -1
- package/dist/memory/obsidianVault.d.ts +0 -1
- package/dist/memory/reasoningBank.d.ts +0 -1
- package/dist/observability/changeWatch.d.ts +0 -1
- package/dist/observability/fatigueDetector.d.ts +0 -1
- package/dist/observability/index.d.ts +0 -1
- package/dist/observability/metrics.d.ts +0 -1
- package/dist/observability/middleware.d.ts +0 -1
- package/dist/observability/tracer.d.ts +0 -1
- package/dist/observability/types.d.ts +0 -1
- package/dist/providers/providerConfig.d.ts +5 -2
- package/dist/providers/providerConfig.js +1006 -1
- package/dist/providers/providerConfig.js.map +1 -1
- package/dist/routing/advancedRouter.d.ts +1 -2
- package/dist/routing/advancedRouter.js +84 -0
- package/dist/routing/advancedRouter.js.map +1 -1
- package/dist/routing/crossModelValidation.d.ts +0 -1
- package/dist/routing/providerHealth.d.ts +77 -2
- package/dist/routing/providerHealth.js +190 -4
- package/dist/routing/providerHealth.js.map +1 -1
- package/dist/routing/providerRetry.d.ts +0 -1
- package/dist/routing/shadowSampler.d.ts +187 -0
- package/dist/routing/shadowSampler.js +306 -0
- package/dist/routing/shadowSampler.js.map +1 -0
- package/dist/sdk.d.ts +0 -1
- package/dist/security/guardrails.d.ts +0 -1
- package/dist/server/dashboard.d.ts +0 -1
- package/dist/server/handlers/chatHandler.d.ts +0 -1
- package/dist/server/handlers/completionsHandler.d.ts +0 -1
- package/dist/server/handlers/embeddingsHandler.d.ts +0 -1
- package/dist/server/handlers/healthHandler.d.ts +0 -1
- package/dist/server/handlers/metricsHandler.d.ts +0 -1
- package/dist/server/handlers/modelsHandler.d.ts +0 -1
- package/dist/server/metrics.d.ts +0 -1
- package/dist/server/modelMapper.d.ts +0 -1
- package/dist/server/proxyServer.d.ts +0 -1
- package/dist/server/router.d.ts +0 -1
- package/dist/server/state.d.ts +0 -1
- package/dist/tui/dashboard.d.ts +0 -1
- package/dist/utils/costUtils.d.ts +0 -1
- package/dist/utils/sorting.d.ts +0 -1
- package/dist/utils/tokenUtils.d.ts +0 -1
- package/docs/llms-full.txt +153 -286
- package/docs/llms.txt +71 -112
- package/integrations/browser-use/README.md +155 -0
- package/integrations/browser-use/examples/form-filling.ts +179 -0
- package/integrations/browser-use/index.ts +145 -0
- package/integrations/browser-use/package.json +34 -0
- package/integrations/browser-use/tsconfig.json +17 -0
- package/integrations/mcp-browser/README.md +177 -0
- package/integrations/mcp-browser/package.json +38 -0
- package/integrations/mcp-browser/src/index.ts +297 -0
- package/integrations/sota-browser/README.md +191 -0
- package/integrations/sota-browser/package.json +34 -0
- package/llms-full.txt +6 -6
- package/llms.txt +62 -112
- package/package.json +92 -13
- package/packages/a3m-vercel-ai/README.md +161 -0
- package/packages/a3m-vercel-ai/dist/a3m-language-model.d.ts +12 -0
- package/packages/a3m-vercel-ai/dist/a3m-language-model.d.ts.map +1 -0
- package/packages/a3m-vercel-ai/dist/a3m-language-model.js +289 -0
- package/packages/a3m-vercel-ai/dist/a3m-language-model.js.map +1 -0
- package/packages/a3m-vercel-ai/dist/index.d.ts +82 -0
- package/packages/a3m-vercel-ai/dist/index.d.ts.map +1 -0
- package/packages/a3m-vercel-ai/dist/index.js +79 -0
- package/packages/a3m-vercel-ai/dist/index.js.map +1 -0
- package/packages/a3m-vercel-ai/dist/types.d.ts +97 -0
- package/packages/a3m-vercel-ai/dist/types.d.ts.map +1 -0
- package/packages/a3m-vercel-ai/dist/types.js +5 -0
- package/packages/a3m-vercel-ai/dist/types.js.map +1 -0
- package/packages/a3m-vercel-ai/package-lock.json +969 -0
- package/packages/a3m-vercel-ai/package.json +46 -0
- package/packages/a3m-vercel-ai/src/a3m-language-model.ts +381 -0
- package/packages/a3m-vercel-ai/src/index.ts +104 -0
- package/packages/a3m-vercel-ai/src/types.ts +116 -0
- package/packages/a3m-vercel-ai/tsconfig.json +20 -0
- package/src/providers/providerConfig.ts +1053 -1
- package/summary.txt +38 -0
- package/.github/ISSUE_TEMPLATE/bug_report.md +0 -94
- package/.github/ISSUE_TEMPLATE/config.yml +0 -17
- package/.github/ISSUE_TEMPLATE/feature_request.md +0 -71
- package/.well-known/ai-plugin.json +0 -16
- package/adapters/README.md +0 -36
- package/adapters/__init__.py +0 -25
- package/adapters/a3m_adapter/__init__.py +0 -15
- package/adapters/a3m_adapter/adapter/__init__.py +0 -7
- package/adapters/a3m_adapter/adapter/config.py +0 -100
- package/adapters/a3m_adapter/adapter/langchain.py +0 -155
- package/adapters/a3m_adapter/adapter/llamaindex.py +0 -162
- package/adapters/a3m_adapter/tests/__init__.py +0 -1
- package/adapters/a3m_adapter/tests/test_adapters.py +0 -120
- package/adapters/setup.py +0 -23
|
@@ -1,162 +0,0 @@
|
|
|
1
|
-
"""
|
|
2
|
-
A3M Router Adapter for LlamaIndex.
|
|
3
|
-
|
|
4
|
-
Drop-in replacement for LlamaIndex's BaseLLM that routes through A3M Router
|
|
5
|
-
for intelligent, cost-optimized model selection.
|
|
6
|
-
"""
|
|
7
|
-
|
|
8
|
-
from __future__ import annotations
|
|
9
|
-
|
|
10
|
-
import logging
|
|
11
|
-
from typing import Any, Dict, List, Optional, Sequence
|
|
12
|
-
|
|
13
|
-
logger = logging.getLogger(__name__)
|
|
14
|
-
|
|
15
|
-
# Check availability
|
|
16
|
-
LLAMAINDEX_AVAILABLE = False
|
|
17
|
-
_llama_metadata_class = None
|
|
18
|
-
try:
|
|
19
|
-
from llama_index.core.base.llms.base import BaseLLM, CompletionResponse
|
|
20
|
-
from llama_index.core.base.llms.types import ChatMessage
|
|
21
|
-
LLAMAINDEX_AVAILABLE = True
|
|
22
|
-
try:
|
|
23
|
-
from llama_index.core.base.llms.base import LLMMetadata
|
|
24
|
-
_llama_metadata_class = LLMMetadata
|
|
25
|
-
except ImportError:
|
|
26
|
-
pass
|
|
27
|
-
except ImportError:
|
|
28
|
-
logger.warning("LlamaIndex not installed. Install with: pip install llama-index")
|
|
29
|
-
|
|
30
|
-
A3M_AVAILABLE = False
|
|
31
|
-
try:
|
|
32
|
-
from a3m.router import A3MRouter, RouteResponse
|
|
33
|
-
A3M_AVAILABLE = True
|
|
34
|
-
except ImportError:
|
|
35
|
-
logger.warning("A3M Router not installed. Install with: pip install adaptive-memory-multi-model-router")
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
class A3MLlamaIndexAdapter:
|
|
39
|
-
"""
|
|
40
|
-
A3M Router adapter for LlamaIndex's BaseLLM interface.
|
|
41
|
-
|
|
42
|
-
Routes prompts through A3M Router to automatically select the cheapest
|
|
43
|
-
capable model across 47+ LLM providers.
|
|
44
|
-
"""
|
|
45
|
-
|
|
46
|
-
def __init__(
|
|
47
|
-
self,
|
|
48
|
-
model: str = "auto",
|
|
49
|
-
temperature: float = 0.0,
|
|
50
|
-
max_tokens: Optional[int] = 4096,
|
|
51
|
-
parallel_ensemble: int = 1,
|
|
52
|
-
api_key: Optional[str] = None,
|
|
53
|
-
**kwargs: Any,
|
|
54
|
-
) -> None:
|
|
55
|
-
"""
|
|
56
|
-
Initialize A3M Router adapter.
|
|
57
|
-
"""
|
|
58
|
-
self.model = model
|
|
59
|
-
self.temperature = temperature
|
|
60
|
-
self.max_tokens = max_tokens
|
|
61
|
-
self.parallel_ensemble = parallel_ensemble
|
|
62
|
-
self.api_key = api_key
|
|
63
|
-
self._a3m_router = None
|
|
64
|
-
self._initialized = False
|
|
65
|
-
|
|
66
|
-
def _ensure_router(self) -> None:
|
|
67
|
-
"""Lazily initialize the A3M router."""
|
|
68
|
-
if self._initialized:
|
|
69
|
-
return
|
|
70
|
-
|
|
71
|
-
if not A3M_AVAILABLE:
|
|
72
|
-
raise ImportError(
|
|
73
|
-
"A3M Router is not installed. "
|
|
74
|
-
"Install with: pip install adaptive-memory-multi-model-router"
|
|
75
|
-
)
|
|
76
|
-
|
|
77
|
-
self._a3m_router = A3MRouter(
|
|
78
|
-
model=self.model,
|
|
79
|
-
temperature=self.temperature,
|
|
80
|
-
parallel_ensemble=self.parallel_ensemble,
|
|
81
|
-
)
|
|
82
|
-
self._initialized = True
|
|
83
|
-
logger.info(
|
|
84
|
-
"A3M Router initialized: model=%s, ensemble=%d",
|
|
85
|
-
self.model,
|
|
86
|
-
self.parallel_ensemble,
|
|
87
|
-
)
|
|
88
|
-
|
|
89
|
-
@property
|
|
90
|
-
def metadata(self) -> Dict[str, Any]:
|
|
91
|
-
"""Return LLM metadata as a dict (framework-agnostic)."""
|
|
92
|
-
return {
|
|
93
|
-
"context_window": 128000,
|
|
94
|
-
"num_output": self.max_tokens or 4096,
|
|
95
|
-
"model_name": self.model,
|
|
96
|
-
"is_chat_model": True,
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
def complete(self, prompt: str, **kwargs: Any) -> CompletionResponse:
|
|
100
|
-
"""Complete a prompt using A3M Router."""
|
|
101
|
-
self._ensure_router()
|
|
102
|
-
|
|
103
|
-
messages = [{"role": "user", "content": prompt}]
|
|
104
|
-
|
|
105
|
-
import asyncio
|
|
106
|
-
loop = asyncio.get_event_loop()
|
|
107
|
-
route_result = loop.run_in_executor(
|
|
108
|
-
None,
|
|
109
|
-
lambda: self._a3m_router.route(
|
|
110
|
-
messages=messages,
|
|
111
|
-
temperature=self.temperature,
|
|
112
|
-
max_tokens=self.max_tokens,
|
|
113
|
-
**kwargs,
|
|
114
|
-
),
|
|
115
|
-
)
|
|
116
|
-
|
|
117
|
-
return CompletionResponse(text=route_result.content, raw=route_result)
|
|
118
|
-
|
|
119
|
-
def chat(self, messages: Sequence[ChatMessage], **kwargs: Any) -> CompletionResponse:
|
|
120
|
-
"""Chat completion using A3M Router."""
|
|
121
|
-
self._ensure_router()
|
|
122
|
-
|
|
123
|
-
a3m_messages = self._convert_messages(messages)
|
|
124
|
-
|
|
125
|
-
import asyncio
|
|
126
|
-
loop = asyncio.get_event_loop()
|
|
127
|
-
route_result = loop.run_in_executor(
|
|
128
|
-
None,
|
|
129
|
-
lambda: self._a3m_router.route(
|
|
130
|
-
messages=a3m_messages,
|
|
131
|
-
temperature=self.temperature,
|
|
132
|
-
max_tokens=self.max_tokens,
|
|
133
|
-
**kwargs,
|
|
134
|
-
),
|
|
135
|
-
)
|
|
136
|
-
|
|
137
|
-
return CompletionResponse(text=route_result.content, raw=route_result)
|
|
138
|
-
|
|
139
|
-
def _convert_messages(self, messages: Sequence[ChatMessage]) -> List[Dict[str, Any]]:
|
|
140
|
-
"""Convert LlamaIndex ChatMessages to A3M format."""
|
|
141
|
-
a3m_messages = []
|
|
142
|
-
for msg in messages:
|
|
143
|
-
role = msg.role.value if hasattr(msg.role, 'value') else str(msg.role).lower()
|
|
144
|
-
role_map = {
|
|
145
|
-
"system": "system",
|
|
146
|
-
"user": "user",
|
|
147
|
-
"assistant": "assistant",
|
|
148
|
-
"tool": "tool",
|
|
149
|
-
"function": "function",
|
|
150
|
-
}
|
|
151
|
-
a3m_role = role_map.get(role, "user")
|
|
152
|
-
a3m_messages.append({"role": a3m_role, "content": msg.content})
|
|
153
|
-
return a3m_messages
|
|
154
|
-
|
|
155
|
-
def __repr__(self) -> str:
|
|
156
|
-
return (
|
|
157
|
-
f"A3MLlamaIndexAdapter("
|
|
158
|
-
f"model={self.model!r}, "
|
|
159
|
-
f"temperature={self.temperature}, "
|
|
160
|
-
f"max_tokens={self.max_tokens}, "
|
|
161
|
-
f"ensemble={self.parallel_ensemble})"
|
|
162
|
-
)
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
"""Tests for A3M adapters."""
|
|
@@ -1,120 +0,0 @@
|
|
|
1
|
-
"""
|
|
2
|
-
Test script for A3M Router adapters.
|
|
3
|
-
|
|
4
|
-
Tests the LangChain and LlamaIndex adapters to ensure they:
|
|
5
|
-
1. Initialize correctly
|
|
6
|
-
2. Route requests properly
|
|
7
|
-
3. Return expected response types
|
|
8
|
-
4. Handle errors gracefully
|
|
9
|
-
"""
|
|
10
|
-
|
|
11
|
-
import sys
|
|
12
|
-
import os
|
|
13
|
-
import logging
|
|
14
|
-
|
|
15
|
-
# Add current directory to path
|
|
16
|
-
sys.path.insert(0, '.')
|
|
17
|
-
|
|
18
|
-
logging.basicConfig(level=logging.INFO)
|
|
19
|
-
logger = logging.getLogger(__name__)
|
|
20
|
-
|
|
21
|
-
def test_langchain_adapter():
|
|
22
|
-
"""Test LangChain adapter."""
|
|
23
|
-
print("Testing LangChain adapter...")
|
|
24
|
-
|
|
25
|
-
try:
|
|
26
|
-
from a3m_llm_adapter import A3MChatModel
|
|
27
|
-
|
|
28
|
-
# Initialize
|
|
29
|
-
llm = A3MChatModel(model="auto", temperature=0.7)
|
|
30
|
-
print(f"��✅ Initialized: {llm}")
|
|
31
|
-
|
|
32
|
-
# Test simple generation
|
|
33
|
-
# Note: This would make actual API calls - we'll skip for now
|
|
34
|
-
# In a real test, we'd mock the A3M router
|
|
35
|
-
print("��✅ LangChain adapter structure OK")
|
|
36
|
-
return True
|
|
37
|
-
|
|
38
|
-
except Exception as e:
|
|
39
|
-
print(f"��❌ LangChain adapter failed: {e}")
|
|
40
|
-
return False
|
|
41
|
-
|
|
42
|
-
def test_llamaindex_adapter():
|
|
43
|
-
"""Test LlamaIndex adapter."""
|
|
44
|
-
print("Testing LlamaIndex adapter...")
|
|
45
|
-
|
|
46
|
-
try:
|
|
47
|
-
from a3m_llama_index_adapter import A3MLlamaIndexLLM
|
|
48
|
-
|
|
49
|
-
# Initialize
|
|
50
|
-
llm = A3MLlamaIndexLLM(model="auto", temperature=0.5)
|
|
51
|
-
print(f"��✅ Initialized: {llm}")
|
|
52
|
-
|
|
53
|
-
# Check metadata
|
|
54
|
-
metadata = llm.metadata
|
|
55
|
-
print(f"��✅ Metadata: {metadata.model_name}, tokens: {metadata.num_output}")
|
|
56
|
-
return True
|
|
57
|
-
|
|
58
|
-
except Exception as e:
|
|
59
|
-
print(f"��❌ LlamaIndex adapter failed: {e}")
|
|
60
|
-
return False
|
|
61
|
-
|
|
62
|
-
def test_config():
|
|
63
|
-
"""Test configuration."""
|
|
64
|
-
print("Testing configuration...")
|
|
65
|
-
|
|
66
|
-
try:
|
|
67
|
-
from a3m_adapter_config import A3MConfig
|
|
68
|
-
|
|
69
|
-
# Test defaults
|
|
70
|
-
config = A3MConfig()
|
|
71
|
-
print(f"��✅ Default config: model={config.model}")
|
|
72
|
-
|
|
73
|
-
# Test to_dict
|
|
74
|
-
data = config.to_dict()
|
|
75
|
-
assert 'model' in data
|
|
76
|
-
print("��✅ Config to_dict works")
|
|
77
|
-
|
|
78
|
-
# Test JSON serialization
|
|
79
|
-
json_str = config.to_json()
|
|
80
|
-
assert '"model"' in json_str
|
|
81
|
-
print("��✅ Config JSON serialization works")
|
|
82
|
-
|
|
83
|
-
return True
|
|
84
|
-
|
|
85
|
-
except Exception as e:
|
|
86
|
-
print(f"��❌ Config test failed: {e}")
|
|
87
|
-
return False
|
|
88
|
-
|
|
89
|
-
def main():
|
|
90
|
-
"""Run all tests."""
|
|
91
|
-
print("=" * 50)
|
|
92
|
-
print("A3M Router Adapter Tests")
|
|
93
|
-
print("=" * 50)
|
|
94
|
-
|
|
95
|
-
tests = [
|
|
96
|
-
test_config,
|
|
97
|
-
test_langchain_adapter,
|
|
98
|
-
test_llamaindex_adapter,
|
|
99
|
-
]
|
|
100
|
-
|
|
101
|
-
passed = 0
|
|
102
|
-
total = len(tests)
|
|
103
|
-
|
|
104
|
-
for test in tests:
|
|
105
|
-
if test():
|
|
106
|
-
passed += 1
|
|
107
|
-
print()
|
|
108
|
-
|
|
109
|
-
print("=" * 50)
|
|
110
|
-
print(f"Results: {passed}/{total} tests passed")
|
|
111
|
-
|
|
112
|
-
if passed == total:
|
|
113
|
-
print("���🎉 All tests passed!")
|
|
114
|
-
return 0
|
|
115
|
-
else:
|
|
116
|
-
print("��❌ Some tests failed")
|
|
117
|
-
return 1
|
|
118
|
-
|
|
119
|
-
if __name__ == "__main__":
|
|
120
|
-
sys.exit(main())
|
package/adapters/setup.py
DELETED
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
from setuptools import setup, find_packages
|
|
2
|
-
import os
|
|
3
|
-
|
|
4
|
-
setup(
|
|
5
|
-
name="a3m_adapter",
|
|
6
|
-
version="1.0.0",
|
|
7
|
-
description="A3M Router adapters for LangChain, LlamaIndex, and other LLM frameworks",
|
|
8
|
-
long_description=open("README.md").read() if os.path.exists("README.md") else "",
|
|
9
|
-
long_description_content_type="text/markdown",
|
|
10
|
-
author="A3M Team",
|
|
11
|
-
author_email="hello@a3m.ai",
|
|
12
|
-
packages=find_packages(),
|
|
13
|
-
install_requires=[
|
|
14
|
-
"requests>=2.25.1",
|
|
15
|
-
"pydantic>=1.9.0",
|
|
16
|
-
],
|
|
17
|
-
extras_require={
|
|
18
|
-
"langchain": ["langchain>=0.0.365", "langchain-core>=0.0.365"],
|
|
19
|
-
"llamaindex": ["llama-index>=0.8.0"],
|
|
20
|
-
"dev": ["pytest>=6.0"],
|
|
21
|
-
},
|
|
22
|
-
python_requires=">=3.8",
|
|
23
|
-
)
|