solana-agent 17.0.7__tar.gz → 17.1.0__tar.gz

{solana_agent-17.0.7 → solana_agent-17.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 17.0.7
+Version: 17.1.0
 Summary: Agentic IQ
 License: MIT
 Keywords: ai,openai,ai agents,agi
@@ -16,7 +16,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Dist: openai (>=1.68.2,<2.0.0)
 Requires-Dist: pydantic (>=2.10.6,<3.0.0)
 Requires-Dist: pymongo (>=4.11.3,<5.0.0)
-Requires-Dist: zep-cloud (>=2.7.0,<3.0.0)
+Requires-Dist: zep-cloud (>=2.8.0,<3.0.0)
 Requires-Dist: zep-python (>=2.0.2,<3.0.0)
 Project-URL: Repository, https://github.com/truemagic-coder/solana-agent
 Description-Content-Type: text/markdown
@@ -34,35 +34,27 @@ Description-Content-Type: text/markdown
 
 ## Agentic IQ
 
-Solana Agent is an AI Agent framework defined on five key dimensions:
-
-* **Multi-Modal Intelligence:** Agents process both text and audio seamlessly. Users interact naturally through their preferred communication channel.
-
-* **Episodic Memory:** Agents remember past conversations with users. This eliminates repetitive explanations and builds meaningful relationships.
-
-* **Cognitive Routing:** Queries go to the most qualified agent automatically. Each specialist has domain-specific knowledge for optimal responses.
-
-* **Value Alignment:** Every agent follows clear organizational values and ethics. This ensures consistent, principled responses aligned with human priorities.
-
-* **Extensible Tooling:** Agents recognize when specialized tools are needed. They extend capabilities beyond conversation to take actions via Python package integration.
-
-This approach creates AI Agents that are intelligent, contextually aware, and aligned with organizational values.
+Power your business using Solana Agent!
 
+* **Brand:** AI agents will speak in your brand voice
+* **Expert:** The AI agent with the most expertise will answer your users' inquiries
+* **Extend:** Assign tools for your AI agents to perform actions
 
 ## Features
 
 * Seamless text and audio streaming with real-time multi-modal processing
 * Persistent memory that preserves context across all agent interactions
 * Intelligent query routing to agents with optimal domain expertise
-* Unified value system ensuring aligned, principled agent responses
-* Powerful tool integration that extends capabilities using standard Python packages
+* Unified value system ensuring brand-aligned agent responses
+* Powerful tool integration using standard Python packages
+* Assigned tools are utilized by agents automatically and effectively
 
 ## Stack
 
-* [Python](https://python.org) - programming language
+* [Python](https://python.org) - Programming Language
 * [OpenAI](https://openai.com) - LLMs
-* [MongoDB](https://mongodb.com) - database
-* [Zep](https://getzep.com) - conversational memory
+* [MongoDB](https://mongodb.com) - Database
+* [Zep](https://getzep.com) - Conversational Memory
 
 ## Installation
 
@@ -70,10 +62,6 @@ You can install Solana Agent using pip:
 
 `pip install solana-agent`
 
-## Documentation
-
-Each public method has a docstring for real-time IDE hinting.
-
 ## Example App
 
 ```python
@@ -81,19 +69,15 @@ from solana_agent import SolanaAgent
 
 config = {
     "organization": {
-        "mission_statement": "To revolutionize knowledge work through AI-human collaboration that puts people first.",
+        "mission_statement": "To provide users with a one-stop shop for their queries.",
         "values": {
-            "Human-Centered": "Always prioritize human well-being and augmentation over replacement.",
-            "Transparency": "Provide clear explanations for decisions and never hide information.",
-            "Collective Intelligence": "Value diverse perspectives and combine human and AI strengths.",
-            "Continuous Learning": "Embrace feedback and continuously improve based on experience."
+            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
+            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
         },
         "goals": [
-            "Enable human experts to focus on high-value creative work",
-            "Reduce administrative overhead through intelligent automation",
-            "Create seamless knowledge flow across the organization"
+            "Empower users with great answers to their queries.",
         ],
-        "guidance": "When making decisions, prioritize long-term user success over short-term efficiency."
+        "guidance": "Align all interactions with the success of the user while respecting human dignity."
     },
     "mongo": {
         "connection_string": "mongodb://localhost:27017",
@@ -117,19 +101,12 @@ config = {
     ],
 }
 
-# Create agent with configuration
 solana_agent = SolanaAgent(config=config)
 
-# Process a query that can use tools
 async for response in solana_agent.process("user123", "What are the latest AI developments?"):
     print(response, end="")
 ```
 
-## Models Used
-* `gpt-4o-mini`
-* `gpt-4o-mini-transcribe`
-* `tts-1`
-
 ## Solana Agent Kit
 
 A collection of Solana Agent tools

{solana_agent-17.0.7 → solana_agent-17.1.0}/README.md

@@ -11,35 +11,27 @@
 
 ## Agentic IQ
 
-Solana Agent is an AI Agent framework defined on five key dimensions:
-
-* **Multi-Modal Intelligence:** Agents process both text and audio seamlessly. Users interact naturally through their preferred communication channel.
-
-* **Episodic Memory:** Agents remember past conversations with users. This eliminates repetitive explanations and builds meaningful relationships.
-
-* **Cognitive Routing:** Queries go to the most qualified agent automatically. Each specialist has domain-specific knowledge for optimal responses.
-
-* **Value Alignment:** Every agent follows clear organizational values and ethics. This ensures consistent, principled responses aligned with human priorities.
-
-* **Extensible Tooling:** Agents recognize when specialized tools are needed. They extend capabilities beyond conversation to take actions via Python package integration.
-
-This approach creates AI Agents that are intelligent, contextually aware, and aligned with organizational values.
+Power your business using Solana Agent!
 
+* **Brand:** AI agents will speak in your brand voice
+* **Expert:** The AI agent with the most expertise will answer your users' inquiries
+* **Extend:** Assign tools for your AI agents to perform actions
 
 ## Features
 
 * Seamless text and audio streaming with real-time multi-modal processing
 * Persistent memory that preserves context across all agent interactions
 * Intelligent query routing to agents with optimal domain expertise
-* Unified value system ensuring aligned, principled agent responses
-* Powerful tool integration that extends capabilities using standard Python packages
+* Unified value system ensuring brand-aligned agent responses
+* Powerful tool integration using standard Python packages
+* Assigned tools are utilized by agents automatically and effectively
 
 ## Stack
 
-* [Python](https://python.org) - programming language
+* [Python](https://python.org) - Programming Language
 * [OpenAI](https://openai.com) - LLMs
-* [MongoDB](https://mongodb.com) - database
-* [Zep](https://getzep.com) - conversational memory
+* [MongoDB](https://mongodb.com) - Database
+* [Zep](https://getzep.com) - Conversational Memory
 
 ## Installation
 
@@ -47,10 +39,6 @@ You can install Solana Agent using pip:
 
 `pip install solana-agent`
 
-## Documentation
-
-Each public method has a docstring for real-time IDE hinting.
-
 ## Example App
 
 ```python
@@ -58,19 +46,15 @@ from solana_agent import SolanaAgent
 
 config = {
     "organization": {
-        "mission_statement": "To revolutionize knowledge work through AI-human collaboration that puts people first.",
+        "mission_statement": "To provide users with a one-stop shop for their queries.",
         "values": {
-            "Human-Centered": "Always prioritize human well-being and augmentation over replacement.",
-            "Transparency": "Provide clear explanations for decisions and never hide information.",
-            "Collective Intelligence": "Value diverse perspectives and combine human and AI strengths.",
-            "Continuous Learning": "Embrace feedback and continuously improve based on experience."
+            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
+            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
         },
         "goals": [
-            "Enable human experts to focus on high-value creative work",
-            "Reduce administrative overhead through intelligent automation",
-            "Create seamless knowledge flow across the organization"
+            "Empower users with great answers to their queries.",
         ],
-        "guidance": "When making decisions, prioritize long-term user success over short-term efficiency."
+        "guidance": "Align all interactions with the success of the user while respecting human dignity."
     },
     "mongo": {
         "connection_string": "mongodb://localhost:27017",
@@ -94,19 +78,12 @@ config = {
     ],
 }
 
-# Create agent with configuration
 solana_agent = SolanaAgent(config=config)
 
-# Process a query that can use tools
 async for response in solana_agent.process("user123", "What are the latest AI developments?"):
     print(response, end="")
 ```
 
-## Models Used
-* `gpt-4o-mini`
-* `gpt-4o-mini-transcribe`
-* `tts-1`
-
 ## Solana Agent Kit
 
 A collection of Solana Agent tools

{solana_agent-17.0.7 → solana_agent-17.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "17.0.7"
+version = "17.1.0"
 description = "Agentic IQ"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"
@@ -21,13 +21,14 @@ python = ">=3.12,<4.0"
 openai = "^1.68.2"
 pydantic = "^2.10.6"
 pymongo = "^4.11.3"
-zep-cloud = "^2.7.0"
+zep-cloud = "^2.8.0"
 zep-python = "^2.0.2"
 
 [tool.poetry.dev-dependencies]
 pytest = "^8.3.5"
 pytest-cov = "^6.0.0"
 pytest-asyncio = "^0.25.3"
+pytest-github-actions-annotate-failures = "^0.3.0"
 
 [build-system]
 requires = ["poetry-core>=1.0.0"]

{solana_agent-17.0.7 → solana_agent-17.1.0}/solana_agent/client/solana_agent.py

@@ -10,6 +10,7 @@ from typing import AsyncGenerator, Dict, Any, Literal, Optional, Union
 
 from solana_agent.factories.agent_factory import SolanaAgentFactory
 from solana_agent.interfaces.client.client import SolanaAgent as SolanaAgentInterface
+from solana_agent.interfaces.plugins.plugins import Tool
 
 
 class SolanaAgent(SolanaAgentInterface):
@@ -109,3 +110,28 @@ class SolanaAgent(SolanaAgentInterface):
         return await self.query_service.get_user_history(
             user_id, page_num, page_size, sort_order
         )
+
+    def register_tool(self, tool: Tool) -> bool:
+        """Register a custom tool for use by agents.
+
+        Args:
+            tool: Tool implementation following the Tool interface
+
+        Returns:
+            bool: True if registration was successful
+
+        Example:
+            ```python
+            from solana_agent import SolanaAgent
+            from my_tools import CustomTool
+
+            agent = SolanaAgent(config=config)
+            tool = CustomTool()
+            agent.register_tool(tool)
+            ```
+        """
+        try:
+            return self.query_service.agent_service.tool_registry.register_tool(tool)
+        except Exception as e:
+            print(f"Error registering tool: {str(e)}")
+            return False

{solana_agent-17.0.7 → solana_agent-17.1.0}/solana_agent/interfaces/client/client.py

@@ -1,6 +1,8 @@
 from abc import ABC, abstractmethod
 from typing import Any, AsyncGenerator, Dict, Literal, Union
 
+from solana_agent.interfaces.plugins.plugins import Tool
+
 
 class SolanaAgent(ABC):
     """Interface for the Solana agent system."""
@@ -33,3 +35,8 @@ class SolanaAgent(ABC):
     ) -> Dict[str, Any]:
         """Get paginated message history for a user."""
         pass
+
+    @abstractmethod
+    def register_tool(self, tool: Tool) -> bool:
+        """Register a tool in the registry."""
+        pass