solana-agent 20.1.0__tar.gz → 20.1.2__tar.gz

{solana_agent-20.1.0 → solana_agent-20.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 20.1.0
+Version: 20.1.2
 Summary: Agentic IQ
 License: MIT
 Keywords: ai,openai,ai agents,agi
@@ -56,7 +56,7 @@ Build your AI business in three lines of code!
 * Seamless text and audio streaming with real-time multi-modal processing
 * Persistent memory that preserves context across all agent interactions
 * Streamlined message history for all agent interactions
-* Intelligent query routing to agents with optimal domain expertise
+* Intelligent query routing to agents with optimal domain expertise or your own custom routing
 * Unified value system ensuring brand-aligned agent responses
 * Powerful tool integration using standard Python packages and/or inline classes
 * Assigned tools are utilized by agents automatically and effectively
@@ -77,13 +77,11 @@ You can install Solana Agent using pip:
 
 ## Usage
 
-### Text/Text Streaming
+### Business Alignment Config - Optional
 
 ```python
-from solana_agent import SolanaAgent
-
 config = {
-    "business": { # optional
+    "business": {
         "mission": "To provide users with a one-stop shop for their queries.",
         "values": {
             "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
@@ -94,14 +92,37 @@ config = {
         ],
         "voice": "The voice of the brand is that of a research business."
     },
-    "mongo": { # optional
+}
+```
+
+### Conversational History Config - Optional
+
+```python
+config = {
+    "mongo": {
         "connection_string": "mongodb://localhost:27017",
         "database": "solana_agent"
     },
-    "zep": { # optional
+}
+```
+
+### Conversational Memory Config - Optional
+
+```python
+config = {
+    "zep": {
         "api_key": "your-zep-api-key",
         "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
     },
+}
+```
+
+### Text/Text Streaming
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
     "openai": {
         "api_key": "your-openai-api-key",
     },
@@ -368,12 +389,52 @@ async for response in solana_agent.process("user123", "What are the latest AI de
     print(response, end="")
 ```
 
+### Custom Routing
+
+```python
+from solana_agent import SolanaAgent
+from solana_agent.interfaces.services.routing import RoutingService as RoutingServiceInterface
+
+config = {
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
+    "agents": [
+        {
+            "name": "research_specialist",
+            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
+            "specialization": "Research and knowledge synthesis",
+        },
+        {
+            "name": "customer_support",
+            "instructions": "You provide friendly, helpful customer support responses.",
+            "specialization": "Customer inquiries",
+        }
+    ],
+}
+
+class Router(RoutingServiceInterface)
+    def __init__(self):
+        # your router initialization - delete the following pass
+        pass
+
+    async def route_query(self, query: str) -> str:
+        # a simple example to route always to customer_support agent
+        return "customer_support"
+
+router = Router()
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "What are the latest AI developments?", router=router):
+    print(response, end="")
+```
+
 ## Notes
 * Solana Agent agents can only call one tool per response.
 * Solana Agent agents choose the best tool for the job.
 * Solana Agent tools do not use OpenAI function calling.
 * Solana Agent tools are async functions.
-* Solana Agent will use OpenAI for audio and Ollama and for text if both config vars are set
 
 ## Local Setup
 

{solana_agent-20.1.0 → solana_agent-20.1.2}/README.md

@@ -31,7 +31,7 @@ Build your AI business in three lines of code!
 * Seamless text and audio streaming with real-time multi-modal processing
 * Persistent memory that preserves context across all agent interactions
 * Streamlined message history for all agent interactions
-* Intelligent query routing to agents with optimal domain expertise
+* Intelligent query routing to agents with optimal domain expertise or your own custom routing
 * Unified value system ensuring brand-aligned agent responses
 * Powerful tool integration using standard Python packages and/or inline classes
 * Assigned tools are utilized by agents automatically and effectively
@@ -52,13 +52,11 @@ You can install Solana Agent using pip:
 
 ## Usage
 
-### Text/Text Streaming
+### Business Alignment Config - Optional
 
 ```python
-from solana_agent import SolanaAgent
-
 config = {
-    "business": { # optional
+    "business": {
         "mission": "To provide users with a one-stop shop for their queries.",
         "values": {
             "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
@@ -69,14 +67,37 @@ config = {
         ],
         "voice": "The voice of the brand is that of a research business."
     },
-    "mongo": { # optional
+}
+```
+
+### Conversational History Config - Optional
+
+```python
+config = {
+    "mongo": {
         "connection_string": "mongodb://localhost:27017",
         "database": "solana_agent"
     },
-    "zep": { # optional
+}
+```
+
+### Conversational Memory Config - Optional
+
+```python
+config = {
+    "zep": {
         "api_key": "your-zep-api-key",
         "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
     },
+}
+```
+
+### Text/Text Streaming
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
     "openai": {
         "api_key": "your-openai-api-key",
     },
@@ -343,12 +364,52 @@ async for response in solana_agent.process("user123", "What are the latest AI de
     print(response, end="")
 ```
 
+### Custom Routing
+
+```python
+from solana_agent import SolanaAgent
+from solana_agent.interfaces.services.routing import RoutingService as RoutingServiceInterface
+
+config = {
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
+    "agents": [
+        {
+            "name": "research_specialist",
+            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
+            "specialization": "Research and knowledge synthesis",
+        },
+        {
+            "name": "customer_support",
+            "instructions": "You provide friendly, helpful customer support responses.",
+            "specialization": "Customer inquiries",
+        }
+    ],
+}
+
+class Router(RoutingServiceInterface)
+    def __init__(self):
+        # your router initialization - delete the following pass
+        pass
+
+    async def route_query(self, query: str) -> str:
+        # a simple example to route always to customer_support agent
+        return "customer_support"
+
+router = Router()
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "What are the latest AI developments?", router=router):
+    print(response, end="")
+```
+
 ## Notes
 * Solana Agent agents can only call one tool per response.
 * Solana Agent agents choose the best tool for the job.
 * Solana Agent tools do not use OpenAI function calling.
 * Solana Agent tools are async functions.
-* Solana Agent will use OpenAI for audio and Ollama and for text if both config vars are set
 
 ## Local Setup
 

{solana_agent-20.1.0 → solana_agent-20.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "20.1.0"
+version = "20.1.2"
 description = "Agentic IQ"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"
@@ -11,6 +11,7 @@ keywords = ["ai", "openai", "ai agents", "agi"]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",

{solana_agent-20.1.0 → solana_agent-20.1.2}/solana_agent/interfaces/services/routing.py

@@ -6,7 +6,7 @@ class RoutingService(ABC):
     """Interface for query routing services."""
 
     @abstractmethod
-    async def route_query(self, query: str) -> Tuple[str, Any]:
+    async def route_query(self, query: str) -> str:
         """Route a query to the appropriate agent.
 
         Args: