solana-agent 27.5.0__tar.gz → 28.0.0__tar.gz

{solana_agent-27.5.0 → solana_agent-28.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 27.5.0
+Version: 28.0.0
 Summary: AI Agents for Solana
 License: MIT
 Keywords: solana,solana ai,solana agent,ai,ai agent,ai agents
@@ -59,6 +59,7 @@ Build your AI agents in three lines of code!
 * Intelligent Routing
 * Business Alignment
 * Extensible Tooling
+* Automatic Tool Workflows
 * Knowledge Base
 * MCP Support
 * Guardrails
@@ -84,26 +85,25 @@ Build your AI agents in three lines of code!
 * Assigned tools are utilized by agents automatically and effectively
 * Integrated Knowledge Base with semantic search and automatic PDF chunking
 * Input and output guardrails for content filtering, safety, and data sanitization
+* Automatic sequential tool workflows allowing agents to chain multiple tools
 
 ## Stack
 
 ### Tech
 
 * [Python](https://python.org) - Programming Language
-* [OpenAI](https://openai.com), [Google](https://ai.google.dev), [xAI](https://x.ai) - LLM Providers
+* [OpenAI](https://openai.com) - AI Provider
 * [MongoDB](https://mongodb.com) - Conversational History (optional)
 * [Zep Cloud](https://getzep.com) - Conversational Memory (optional)
 * [Pinecone](https://pinecone.io) - Knowledge Base (optional)
 
-### LLMs
+### AI Models Used
 
-* [gpt-4.1-mini](https://platform.openai.com/docs/models/gpt-4.1-mini) (agent)
+* [gpt-4.1](https://platform.openai.com/docs/models/gpt-4.1) (agent)
 * [gpt-4.1-nano](https://platform.openai.com/docs/models/gpt-4.1-nano) (router)
 * [text-embedding-3-large](https://platform.openai.com/docs/models/text-embedding-3-large) or [text-embedding-3-small](https://platform.openai.com/docs/models/text-embedding-3-small) (embedding)
 * [tts-1](https://platform.openai.com/docs/models/tts-1) (audio TTS)
 * [gpt-4o-mini-transcribe](https://platform.openai.com/docs/models/gpt-4o-mini-transcribe) (audio transcription)
-* [gemini-2.5-flash-preview](https://ai.google.dev/gemini-api/docs/models#gemini-2.5-flash-preview) (optional)
-* [grok-3-mini-fast-beta](https://docs.x.ai/docs/models#models-and-pricing) (optional)
 
 ## Installation
 
@@ -113,13 +113,13 @@ You can install Solana Agent using pip:
 
 ## Flows
 
-In both flows of single and multiple agents - it is one user query to one agent using one tool (if needed).
+In both flows of single and multiple agents - it is one user query to one agent using one or many tools (if needed).
 
-An agent can have multiple tools and will choose the best one to answer the user query.
+An agent can have multiple tools and will choose the best ones to fulfill the user's query.
 
-Routing is determined by optimal domain expertise of the agent for the user query.
+Routing is determined by optimal domain expertise of the agent for the user's query.
 
-When the agent uses a tool it feeds the tool output back to itself to generate the final response.
+When the agent uses tools it feeds the tools output back to itself to generate the final response.
 
 This is important as tools generally output unstructured and unformatted data that the agent needs to prepare for the user.
 
@@ -128,13 +128,13 @@ Keep this in mind while designing your agentic systems using Solana Agent.
 ```ascii
                        Single Agent                                     
                                                                         
-     ┌────────┐        ┌─────────┐        ┌────────┐                    
-     │        │        │         │        │        │                    
-     │        │        │         │        │        │                    
-     │  User  │◄──────►│  Agent  │◄──────►│  Tool  │                    
-     │        │        │         │        │        │                    
-     │        │        │         │        │        │                    
-     └────────┘        └─────────┘        └────────┘                    
+     ┌────────┐        ┌─────────┐        ┌────────-┐                    
+     │        │        │         │        │         │                    
+     │        │        │         │        │         │                    
+     │  User  │◄──────►│  Agent  │◄──────►│  Tools  │                    
+     │        │        │         │        │         │                    
+     │        │        │         │        │         │                    
+     └────────┘        └─────────┘        └────────-┘                    
                                                                         
                                                                         
                                                                         
@@ -142,13 +142,13 @@ Keep this in mind while designing your agentic systems using Solana Agent.
                                                                         
                       Multiple Agents                                   
                                                                         
-     ┌────────┐        ┌──────────┐        ┌─────────┐        ┌────────┐
-     │        │        │          │        │         │        │        │
-     │        │        │          │        │         │        │        │
-┌───►│  User  ├───────►│  Router  ├───────►│  Agent  │◄──────►│  Tool  │
-│    │        │        │          │        │         │        │        │
-│    │        │        │          │        │         │        │        │
-│    └────────┘        └──────────┘        └────┬────┘        └────────┘
+     ┌────────┐        ┌──────────┐        ┌─────────┐        ┌────────-┐
+     │        │        │          │        │         │        │         │
+     │        │        │          │        │         │        │         │
+┌───►│  User  ├───────►│  Router  ├───────►│  Agent  │◄──────►│  Tools  │
+│    │        │        │          │        │         │        │         │
+│    │        │        │          │        │         │        │         │
+│    └────────┘        └──────────┘        └────┬────┘        └────────-┘
 │                                               │                       
 │                                               │                       
 │                                               │                       
@@ -319,30 +319,6 @@ config = {
 }
 ```
 
-### Gemini
-
-This allows Gemini to replace OpenAI for agent and router.
-
-```python
-config = {
-    "gemini": {
-        "api_key": "your-gemini-api-key",
-    },
-}
-```
-
-### Grok
-
-This allows Grok to replace OpenAI (or Gemini) for agent.
-
-```python
-config = {
-    "grok": {
-        "api_key": "your-grok-api-key",
-    },
-}
-```
-
 ### Knowledge Base
 
 The Knowledge Base (KB) is meant to store text values and/or small PDFs.
@@ -533,8 +509,8 @@ class MyOutputGuardrail(OutputGuardrail):
 
 Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
 
-* Agents can only call one tool per response
-* Agents choose the best tool for the job
+* Agents can use multiple tools per response and should apply the right sequential order (like send an email to bob@bob.com with the latest news on Solana)
+* Agents choose the best tools for the job
 * Solana Agent doesn't use OpenAI function calling (tools) as they don't support async functions
 * Solana Agent tools are async functions
 

{solana_agent-27.5.0 → solana_agent-28.0.0}/README.md

@@ -28,6 +28,7 @@ Build your AI agents in three lines of code!
 * Intelligent Routing
 * Business Alignment
 * Extensible Tooling
+* Automatic Tool Workflows
 * Knowledge Base
 * MCP Support
 * Guardrails
@@ -53,26 +54,25 @@ Build your AI agents in three lines of code!
 * Assigned tools are utilized by agents automatically and effectively
 * Integrated Knowledge Base with semantic search and automatic PDF chunking
 * Input and output guardrails for content filtering, safety, and data sanitization
+* Automatic sequential tool workflows allowing agents to chain multiple tools
 
 ## Stack
 
 ### Tech
 
 * [Python](https://python.org) - Programming Language
-* [OpenAI](https://openai.com), [Google](https://ai.google.dev), [xAI](https://x.ai) - LLM Providers
+* [OpenAI](https://openai.com) - AI Provider
 * [MongoDB](https://mongodb.com) - Conversational History (optional)
 * [Zep Cloud](https://getzep.com) - Conversational Memory (optional)
 * [Pinecone](https://pinecone.io) - Knowledge Base (optional)
 
-### LLMs
+### AI Models Used
 
-* [gpt-4.1-mini](https://platform.openai.com/docs/models/gpt-4.1-mini) (agent)
+* [gpt-4.1](https://platform.openai.com/docs/models/gpt-4.1) (agent)
 * [gpt-4.1-nano](https://platform.openai.com/docs/models/gpt-4.1-nano) (router)
 * [text-embedding-3-large](https://platform.openai.com/docs/models/text-embedding-3-large) or [text-embedding-3-small](https://platform.openai.com/docs/models/text-embedding-3-small) (embedding)
 * [tts-1](https://platform.openai.com/docs/models/tts-1) (audio TTS)
 * [gpt-4o-mini-transcribe](https://platform.openai.com/docs/models/gpt-4o-mini-transcribe) (audio transcription)
-* [gemini-2.5-flash-preview](https://ai.google.dev/gemini-api/docs/models#gemini-2.5-flash-preview) (optional)
-* [grok-3-mini-fast-beta](https://docs.x.ai/docs/models#models-and-pricing) (optional)
 
 ## Installation
 
@@ -82,13 +82,13 @@ You can install Solana Agent using pip:
 
 ## Flows
 
-In both flows of single and multiple agents - it is one user query to one agent using one tool (if needed).
+In both flows of single and multiple agents - it is one user query to one agent using one or many tools (if needed).
 
-An agent can have multiple tools and will choose the best one to answer the user query.
+An agent can have multiple tools and will choose the best ones to fulfill the user's query.
 
-Routing is determined by optimal domain expertise of the agent for the user query.
+Routing is determined by optimal domain expertise of the agent for the user's query.
 
-When the agent uses a tool it feeds the tool output back to itself to generate the final response.
+When the agent uses tools it feeds the tools output back to itself to generate the final response.
 
 This is important as tools generally output unstructured and unformatted data that the agent needs to prepare for the user.
 
@@ -97,13 +97,13 @@ Keep this in mind while designing your agentic systems using Solana Agent.
 ```ascii
                        Single Agent                                     
                                                                         
-     ┌────────┐        ┌─────────┐        ┌────────┐                    
-     │        │        │         │        │        │                    
-     │        │        │         │        │        │                    
-     │  User  │◄──────►│  Agent  │◄──────►│  Tool  │                    
-     │        │        │         │        │        │                    
-     │        │        │         │        │        │                    
-     └────────┘        └─────────┘        └────────┘                    
+     ┌────────┐        ┌─────────┐        ┌────────-┐                    
+     │        │        │         │        │         │                    
+     │        │        │         │        │         │                    
+     │  User  │◄──────►│  Agent  │◄──────►│  Tools  │                    
+     │        │        │         │        │         │                    
+     │        │        │         │        │         │                    
+     └────────┘        └─────────┘        └────────-┘                    
                                                                         
                                                                         
                                                                         
@@ -111,13 +111,13 @@ Keep this in mind while designing your agentic systems using Solana Agent.
                                                                         
                       Multiple Agents                                   
                                                                         
-     ┌────────┐        ┌──────────┐        ┌─────────┐        ┌────────┐
-     │        │        │          │        │         │        │        │
-     │        │        │          │        │         │        │        │
-┌───►│  User  ├───────►│  Router  ├───────►│  Agent  │◄──────►│  Tool  │
-│    │        │        │          │        │         │        │        │
-│    │        │        │          │        │         │        │        │
-│    └────────┘        └──────────┘        └────┬────┘        └────────┘
+     ┌────────┐        ┌──────────┐        ┌─────────┐        ┌────────-┐
+     │        │        │          │        │         │        │         │
+     │        │        │          │        │         │        │         │
+┌───►│  User  ├───────►│  Router  ├───────►│  Agent  │◄──────►│  Tools  │
+│    │        │        │          │        │         │        │         │
+│    │        │        │          │        │         │        │         │
+│    └────────┘        └──────────┘        └────┬────┘        └────────-┘
 │                                               │                       
 │                                               │                       
 │                                               │                       
@@ -288,30 +288,6 @@ config = {
 }
 ```
 
-### Gemini
-
-This allows Gemini to replace OpenAI for agent and router.
-
-```python
-config = {
-    "gemini": {
-        "api_key": "your-gemini-api-key",
-    },
-}
-```
-
-### Grok
-
-This allows Grok to replace OpenAI (or Gemini) for agent.
-
-```python
-config = {
-    "grok": {
-        "api_key": "your-grok-api-key",
-    },
-}
-```
-
 ### Knowledge Base
 
 The Knowledge Base (KB) is meant to store text values and/or small PDFs.
@@ -502,8 +478,8 @@ class MyOutputGuardrail(OutputGuardrail):
 
 Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
 
-* Agents can only call one tool per response
-* Agents choose the best tool for the job
+* Agents can use multiple tools per response and should apply the right sequential order (like send an email to bob@bob.com with the latest news on Solana)
+* Agents choose the best tools for the job
 * Solana Agent doesn't use OpenAI function calling (tools) as they don't support async functions
 * Solana Agent tools are async functions
 

{solana_agent-27.5.0 → solana_agent-28.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "27.5.0"
+version = "28.0.0"
 description = "AI Agents for Solana"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"

{solana_agent-27.5.0 → solana_agent-28.0.0}/solana_agent/adapters/openai_adapter.py

@@ -15,7 +15,7 @@ from solana_agent.interfaces.providers.llm import LLMProvider
 
 T = TypeVar("T", bound=BaseModel)
 
-DEFAULT_CHAT_MODEL = "gpt-4.1-mini"
+DEFAULT_CHAT_MODEL = "gpt-4.1"
 DEFAULT_PARSE_MODEL = "gpt-4.1-nano"
 DEFAULT_EMBEDDING_MODEL = "text-embedding-3-large"
 DEFAULT_EMBEDDING_DIMENSIONS = 3072
@@ -129,45 +129,41 @@ class OpenAIAdapter(LLMProvider):
         api_key: Optional[str] = None,
         base_url: Optional[str] = None,
         model: Optional[str] = None,
-    ) -> AsyncGenerator[str, None]:  # pragma: no cover
-        """Generate text from OpenAI models."""
+    ) -> str:  # pragma: no cover
+        """Generate text from OpenAI models as a single string."""
         messages = []
-
         if system_prompt:
             messages.append({"role": "system", "content": system_prompt})
-
         messages.append({"role": "user", "content": prompt})
 
-        # Prepare request parameters
+        # Prepare request parameters - stream is always False now
         request_params = {
             "messages": messages,
-            "stream": True,
-            "model": self.text_model,
+            "stream": False,  # Hardcoded to False
+            "model": model or self.text_model,
         }
 
+        # Determine client based on provided api_key/base_url
         if api_key and base_url:
             client = AsyncOpenAI(api_key=api_key, base_url=base_url)
         else:
             client = self.client
 
-        if model:
-            request_params["model"] = model
-
         try:
+            # Make the non-streaming API call
             response = await client.chat.completions.create(**request_params)
 
-            async for chunk in response:
-                if chunk.choices:
-                    if chunk.choices[0].delta.content:
-                        text = chunk.choices[0].delta.content
-                        yield text
+            # Handle non-streaming response
+            if response.choices and response.choices[0].message.content:
+                full_text = response.choices[0].message.content
+                return full_text  # Return the complete string
+            else:
+                print("Received non-streaming response with no content.")
+                return ""  # Return empty string if no content
 
         except Exception as e:
-            print(f"Error in generate_text: {str(e)}")
-            import traceback
-
-            print(traceback.format_exc())
-            yield f"I apologize, but I encountered an error: {str(e)}"
+            # Log the error and return an error message string
+            print(f"Error in generate_text: {e}")
 
     async def parse_structured_output(
         self,

{solana_agent-27.5.0 → solana_agent-28.0.0}/solana_agent/factories/agent_factory.py

@@ -130,90 +130,19 @@ class SolanaAgentFactory:
             f"Loaded {len(input_guardrails)} input guardrails and {len(output_guardrails)} output guardrails."
         )
 
-        if (
-            "gemini" in config
-            and "api_key" in config["gemini"]
-            and "grok" not in config
-        ):
-            # Create primary services
-            agent_service = AgentService(
-                llm_provider=llm_adapter,
-                business_mission=business_mission,
-                config=config,
-                api_key=config["gemini"]["api_key"],
-                base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
-                model="gemini-2.5-flash-preview-04-17",
-                output_guardrails=output_guardrails,
-            )
-
-            # Create routing service
-            routing_service = RoutingService(
-                llm_provider=llm_adapter,
-                agent_service=agent_service,
-                api_key=config["gemini"]["api_key"],
-                base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
-                model="gemini-2.5-flash-preview-04-17",
-            )
-
-        elif (
-            "gemini" in config
-            and "api_key" in config["gemini"]
-            and "grok" in config
-            and "api_key" in config["grok"]
-        ):
-            # Create primary services
-            agent_service = AgentService(
-                llm_provider=llm_adapter,
-                business_mission=business_mission,
-                config=config,
-                api_key=config["grok"]["api_key"],
-                base_url="https://api.x.ai/v1",
-                model="grok-3-mini-fast-beta",
-                output_guardrails=output_guardrails,
-            )
-            # Create routing service
-            routing_service = RoutingService(
-                llm_provider=llm_adapter,
-                agent_service=agent_service,
-                api_key=config["gemini"]["api_key"],
-                base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
-                model="gemini-2.5-flash-preview-04-17",
-            )
-
-        elif (
-            "grok" in config and "api_key" in config["grok"] and "gemini" not in config
-        ):
-            # Create primary services
-            agent_service = AgentService(
-                llm_provider=llm_adapter,
-                business_mission=business_mission,
-                config=config,
-                api_key=config["grok"]["api_key"],
-                base_url="https://api.x.ai/v1",
-                model="grok-3-mini-fast-beta",
-                output_guardrails=output_guardrails,
-            )
-
-            # Create routing service
-            routing_service = RoutingService(
-                llm_provider=llm_adapter,
-                agent_service=agent_service,
-            )
-
-        else:
-            # Create primary services
-            agent_service = AgentService(
-                llm_provider=llm_adapter,
-                business_mission=business_mission,
-                config=config,
-                output_guardrails=output_guardrails,
-            )
+        # Create primary services
+        agent_service = AgentService(
+            llm_provider=llm_adapter,
+            business_mission=business_mission,
+            config=config,
+            output_guardrails=output_guardrails,
+        )
 
-            # Create routing service
-            routing_service = RoutingService(
-                llm_provider=llm_adapter,
-                agent_service=agent_service,
-            )
+        # Create routing service
+        routing_service = RoutingService(
+            llm_provider=llm_adapter,
+            agent_service=agent_service,
+        )
 
         # Debug the agent service tool registry
         print(

{solana_agent-27.5.0 → solana_agent-28.0.0}/solana_agent/interfaces/providers/llm.py

@@ -25,7 +25,7 @@ class LLMProvider(ABC):
         api_key: Optional[str] = None,
         base_url: Optional[str] = None,
         model: Optional[str] = None,
-    ) -> AsyncGenerator[str, None]:
+    ) -> str:
         """Generate text from the language model."""
         pass