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.
Files changed (129) hide show
  1. package/AGENT_COUNCIL_FINDINGS.md +123 -98
  2. package/CAMPAIGN_SUMMARY.md +87 -0
  3. package/CHANGELOG.md +7 -1
  4. package/ENTERPRISE_INTEGRATIONS.md +94 -0
  5. package/INTEGRATION_PROGRESS.md +96 -0
  6. package/OPPORTUNITIES_100.md +277 -0
  7. package/POPULARITY_BOOSTERS.md +1 -1
  8. package/README.md +147 -275
  9. package/README_ja.md +17 -21
  10. package/README_zh.md +13 -17
  11. package/TODO_BROWSER_AUTOMATION.md +87 -0
  12. package/a3m-integrations-summary.md +73 -0
  13. package/apps/cost-calculator/README.md +72 -0
  14. package/apps/cost-calculator/calculator.css +280 -0
  15. package/apps/cost-calculator/calculator.js +150 -0
  16. package/apps/cost-calculator/index.html +321 -0
  17. package/apps/cost-calculator/package.json +13 -0
  18. package/articles/ANNOUNCEMENT_reddit_ml.md +76 -0
  19. package/articles/ANNOUNCEMENT_vc/347/244/276/345/214/272.md +71 -0
  20. package/articles/ANNOUNCEMENT_vercel.md +85 -0
  21. package/articles/CHINESE_DIRECTORIES.md +2 -2
  22. package/articles/CHINESE_SUBMISSIONS_READY.md +5 -5
  23. package/articles/HN_POST_READY.md +16 -20
  24. package/articles/INDIEHACKERS_READY.md +19 -34
  25. package/dist/analytics/costAnalytics.d.ts +0 -1
  26. package/dist/benchmark/reproducible.d.ts +0 -1
  27. package/dist/cache/semanticCache.d.ts +0 -1
  28. package/dist/cost/budgetEnforcer.d.ts +0 -1
  29. package/dist/cost/costTracker.d.ts +0 -1
  30. package/dist/ensemble/multiRoundDialog.d.ts +0 -1
  31. package/dist/ensemble/shapleyValue.d.ts +0 -1
  32. package/dist/ensemble.d.ts +0 -1
  33. package/dist/index.d.ts +0 -1
  34. package/dist/integrations/oauth.d.ts +0 -1
  35. package/dist/integrations/scienceAdapter.d.ts +0 -1
  36. package/dist/memory/autoFetch.d.ts +0 -1
  37. package/dist/memory/hybridMemory.d.ts +0 -1
  38. package/dist/memory/memoryTree.d.ts +0 -1
  39. package/dist/memory/obsidianVault.d.ts +0 -1
  40. package/dist/memory/reasoningBank.d.ts +0 -1
  41. package/dist/observability/changeWatch.d.ts +0 -1
  42. package/dist/observability/fatigueDetector.d.ts +0 -1
  43. package/dist/observability/index.d.ts +0 -1
  44. package/dist/observability/metrics.d.ts +0 -1
  45. package/dist/observability/middleware.d.ts +0 -1
  46. package/dist/observability/tracer.d.ts +0 -1
  47. package/dist/observability/types.d.ts +0 -1
  48. package/dist/providers/providerConfig.d.ts +5 -2
  49. package/dist/providers/providerConfig.js +1006 -1
  50. package/dist/providers/providerConfig.js.map +1 -1
  51. package/dist/routing/advancedRouter.d.ts +1 -2
  52. package/dist/routing/advancedRouter.js +84 -0
  53. package/dist/routing/advancedRouter.js.map +1 -1
  54. package/dist/routing/crossModelValidation.d.ts +0 -1
  55. package/dist/routing/providerHealth.d.ts +77 -2
  56. package/dist/routing/providerHealth.js +190 -4
  57. package/dist/routing/providerHealth.js.map +1 -1
  58. package/dist/routing/providerRetry.d.ts +0 -1
  59. package/dist/routing/shadowSampler.d.ts +187 -0
  60. package/dist/routing/shadowSampler.js +306 -0
  61. package/dist/routing/shadowSampler.js.map +1 -0
  62. package/dist/sdk.d.ts +0 -1
  63. package/dist/security/guardrails.d.ts +0 -1
  64. package/dist/server/dashboard.d.ts +0 -1
  65. package/dist/server/handlers/chatHandler.d.ts +0 -1
  66. package/dist/server/handlers/completionsHandler.d.ts +0 -1
  67. package/dist/server/handlers/embeddingsHandler.d.ts +0 -1
  68. package/dist/server/handlers/healthHandler.d.ts +0 -1
  69. package/dist/server/handlers/metricsHandler.d.ts +0 -1
  70. package/dist/server/handlers/modelsHandler.d.ts +0 -1
  71. package/dist/server/metrics.d.ts +0 -1
  72. package/dist/server/modelMapper.d.ts +0 -1
  73. package/dist/server/proxyServer.d.ts +0 -1
  74. package/dist/server/router.d.ts +0 -1
  75. package/dist/server/state.d.ts +0 -1
  76. package/dist/tui/dashboard.d.ts +0 -1
  77. package/dist/utils/costUtils.d.ts +0 -1
  78. package/dist/utils/sorting.d.ts +0 -1
  79. package/dist/utils/tokenUtils.d.ts +0 -1
  80. package/docs/llms-full.txt +153 -286
  81. package/docs/llms.txt +71 -112
  82. package/integrations/browser-use/README.md +155 -0
  83. package/integrations/browser-use/examples/form-filling.ts +179 -0
  84. package/integrations/browser-use/index.ts +145 -0
  85. package/integrations/browser-use/package.json +34 -0
  86. package/integrations/browser-use/tsconfig.json +17 -0
  87. package/integrations/mcp-browser/README.md +177 -0
  88. package/integrations/mcp-browser/package.json +38 -0
  89. package/integrations/mcp-browser/src/index.ts +297 -0
  90. package/integrations/sota-browser/README.md +191 -0
  91. package/integrations/sota-browser/package.json +34 -0
  92. package/llms-full.txt +6 -6
  93. package/llms.txt +62 -112
  94. package/package.json +92 -13
  95. package/packages/a3m-vercel-ai/README.md +161 -0
  96. package/packages/a3m-vercel-ai/dist/a3m-language-model.d.ts +12 -0
  97. package/packages/a3m-vercel-ai/dist/a3m-language-model.d.ts.map +1 -0
  98. package/packages/a3m-vercel-ai/dist/a3m-language-model.js +289 -0
  99. package/packages/a3m-vercel-ai/dist/a3m-language-model.js.map +1 -0
  100. package/packages/a3m-vercel-ai/dist/index.d.ts +82 -0
  101. package/packages/a3m-vercel-ai/dist/index.d.ts.map +1 -0
  102. package/packages/a3m-vercel-ai/dist/index.js +79 -0
  103. package/packages/a3m-vercel-ai/dist/index.js.map +1 -0
  104. package/packages/a3m-vercel-ai/dist/types.d.ts +97 -0
  105. package/packages/a3m-vercel-ai/dist/types.d.ts.map +1 -0
  106. package/packages/a3m-vercel-ai/dist/types.js +5 -0
  107. package/packages/a3m-vercel-ai/dist/types.js.map +1 -0
  108. package/packages/a3m-vercel-ai/package-lock.json +969 -0
  109. package/packages/a3m-vercel-ai/package.json +46 -0
  110. package/packages/a3m-vercel-ai/src/a3m-language-model.ts +381 -0
  111. package/packages/a3m-vercel-ai/src/index.ts +104 -0
  112. package/packages/a3m-vercel-ai/src/types.ts +116 -0
  113. package/packages/a3m-vercel-ai/tsconfig.json +20 -0
  114. package/src/providers/providerConfig.ts +1053 -1
  115. package/summary.txt +38 -0
  116. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -94
  117. package/.github/ISSUE_TEMPLATE/config.yml +0 -17
  118. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -71
  119. package/.well-known/ai-plugin.json +0 -16
  120. package/adapters/README.md +0 -36
  121. package/adapters/__init__.py +0 -25
  122. package/adapters/a3m_adapter/__init__.py +0 -15
  123. package/adapters/a3m_adapter/adapter/__init__.py +0 -7
  124. package/adapters/a3m_adapter/adapter/config.py +0 -100
  125. package/adapters/a3m_adapter/adapter/langchain.py +0 -155
  126. package/adapters/a3m_adapter/adapter/llamaindex.py +0 -162
  127. package/adapters/a3m_adapter/tests/__init__.py +0 -1
  128. package/adapters/a3m_adapter/tests/test_adapters.py +0 -120
  129. 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
- )