solana-agent 18.0.0__tar.gz → 19.0.0__tar.gz

solana_agent-19.0.0/PKG-INFO

@@ -0,0 +1,314 @@
+Metadata-Version: 2.3
+Name: solana-agent
+Version: 19.0.0
+Summary: Agentic IQ
+License: MIT
+Keywords: ai,openai,ai agents,agi
+Author: Bevan Hunt
+Author-email: bevan@bevanhunt.com
+Requires-Python: >=3.12,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+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.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
+
+# Solana Agent
+
+[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent?color=yellow)](https://pypi.org/project/solana-agent/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-orange.svg)](https://www.python.org/downloads/)
+[![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/truemagic-coder/solana-agent/ci.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/ci.yml)
+[![Lines of Code](https://tokei.rs/b1/github/truemagic-coder/solana-agent?type=python&category=code&style=flat)](https://github.com/truemagic-coder/solana-agent)
+
+![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
+
+## Agentic IQ
+
+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 (optional)
+* Intelligent query routing to agents with optimal domain expertise
+* 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
+* Simple business definition using JSON
+
+## Why?
+* Multi-Modal Streaming
+* Conversational Memory
+* Intelligent Routing
+* Business Alignment
+* Extensible Tooling
+* Simple Business Definition
+* Built using OOP & SOLID in Python - the language of AI
+* Batteries Included
+* Small Library: ~2,000 LOC of code & ~1,200 LOC of tests
+* Few Dependencies
+* Well Tested
+* Used in production by [CometHeart](https://cometheart.com) and [WalletBubbles](https://walletbubbles.com)
+
+## Stack
+
+* [Python](https://python.org) - Programming Language
+* [OpenAI](https://openai.com) - LLMs
+* [MongoDB](https://mongodb.com) - Database
+* [Zep](https://getzep.com) - Conversational Memory (optional)
+
+## Installation
+
+You can install Solana Agent using pip:
+
+`pip install solana-agent`
+
+## Basic Usage
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
+    "business": {
+        "mission": "To provide users with a one-stop shop for their queries.",
+        "values": {
+            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
+            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
+        },
+        "goals": [
+            "Empower users with great answers to their queries.",
+        ],
+        "voice": "The voice of the brand is that of a research business."
+    },
+    "mongo": {
+        "connection_string": "mongodb://localhost:27017",
+        "database": "solana_agent"
+    },
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
+    "zep": { # optional
+        "api_key": "your-zep-api-key",
+        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
+    },
+    "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",
+        }
+    ],
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "What are the latest AI developments?"):
+    print(response, end="")
+```
+
+## Plugin Usage
+
+Plugins like Solana Agent Kit (sakit) integrate automatically with Solana Agent.
+
+`pip install sakit`
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
+    "business": {
+        "mission": "To provide users with a one-stop shop for their queries.",
+        "values": {
+            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
+            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
+        },
+        "goals": [
+            "Empower users with great answers to their queries.",
+        ],
+        "voice": "The voice of the brand is that of a research business."
+    },
+    "mongo": {
+        "connection_string": "mongodb://localhost:27017",
+        "database": "solana_agent"
+    },
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
+    "zep": { # optional
+        "api_key": "your-zep-api-key",
+        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
+    },
+    "tools": {
+    "search_internet": {
+        "api_key": "your-perplexity-key", # Required
+        "citations": True, # Optional, defaults to True
+        "model": "sonar"  # Optional, defaults to "sonar"
+    },
+    },
+    "agents": [
+        {
+            "name": "research_specialist",
+            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
+            "specialization": "Research and knowledge synthesis",
+            "tools": ["search_internet"],
+        },
+        {
+            "name": "customer_support",
+            "instructions": "You provide friendly, helpful customer support responses.",
+            "specialization": "Customer inquiries",
+        }
+    ],
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "What are the latest AI developments?"):
+    print(response, end="")
+```
+
+To create a plugin like Solana Agent Kit - read the [code](https://github.com/truemagic-coder/solana-agent-kit)
+
+## Custom Inline Tool Usage
+
+```python
+from solana_agent import SolanaAgent
+from solana_agent.interfaces.plugins.plugins import Tool
+
+class TestTool(Tool):
+    def __init__(self):
+        # your tool initialization - delete the following pass
+        pass
+
+    @property
+    def name(self) -> str:
+        return "test_function"
+
+    @property
+    def description(self) -> str:
+        return "Test function for Solana Agent"
+
+    def configure(self, config: Dict[str, Any]) -> None:
+        """Configure with all possible API key locations."""
+        super().configure(config)
+
+        # read your config values - delete the following pass
+        pass
+
+    def get_schema(self) -> Dict[str, Any]:
+        # this is an example schema
+        return {
+            "type": "object",
+            "properties": {
+                "query": {"type": "string", "description": "Search query text"},
+                "user_id": {"type": "string", "description": "User ID for the search session"}
+            },
+            "required": ["query", "user_id"]
+        }
+
+    async def execute(self, **params) -> Dict[str, Any]:
+        try:
+            # your tool logic
+            result = "Your tool results"
+
+            return {
+                "status": "success",
+                "result": result,
+            }
+        except Exception as e:
+            return {
+                "status": "error",
+                "message": f"Error: {str(e)}",
+            }
+
+config = {
+    "business": {
+        "mission": "To provide users with a one-stop shop for their queries.",
+        "values": {
+            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
+            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
+        },
+        "goals": [
+            "Empower users with great answers to their queries.",
+        ],
+        "voice": "The voice of the brand is that of a research business."
+    },
+    "mongo": {
+        "connection_string": "mongodb://localhost:27017",
+        "database": "solana_agent"
+    },
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
+    "zep": { # optional
+        "api_key": "your-zep-api-key",
+        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
+    },
+    "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",
+        }
+    ],
+}
+
+solana_agent = SolanaAgent(config=config)
+
+test_tool = TestTool()
+
+solana_agent.register_tool(test_tool)
+
+async for response in solana_agent.process("user123", "What are the latest AI developments?"):
+    print(response, end="")
+```
+
+## Notes on Tools
+* 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.
+
+## API Documentation
+* Available at [Solana Agent Documentation Site](https://docs.solana-agent.com)
+
+## Solana Agent Kit
+
+A collection of Solana Agent tools
+
+[Solana Agent Kit](https://github.com/truemagic-coder/solana-agent-kit)
+
+## Example App
+
+A Solana Agent example app written in FastAPI and Next.js
+
+[Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+

solana_agent-19.0.0/README.md

@@ -0,0 +1,290 @@
+# Solana Agent
+
+[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent?color=yellow)](https://pypi.org/project/solana-agent/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-orange.svg)](https://www.python.org/downloads/)
+[![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/truemagic-coder/solana-agent/ci.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/ci.yml)
+[![Lines of Code](https://tokei.rs/b1/github/truemagic-coder/solana-agent?type=python&category=code&style=flat)](https://github.com/truemagic-coder/solana-agent)
+
+![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
+
+## Agentic IQ
+
+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 (optional)
+* Intelligent query routing to agents with optimal domain expertise
+* 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
+* Simple business definition using JSON
+
+## Why?
+* Multi-Modal Streaming
+* Conversational Memory
+* Intelligent Routing
+* Business Alignment
+* Extensible Tooling
+* Simple Business Definition
+* Built using OOP & SOLID in Python - the language of AI
+* Batteries Included
+* Small Library: ~2,000 LOC of code & ~1,200 LOC of tests
+* Few Dependencies
+* Well Tested
+* Used in production by [CometHeart](https://cometheart.com) and [WalletBubbles](https://walletbubbles.com)
+
+## Stack
+
+* [Python](https://python.org) - Programming Language
+* [OpenAI](https://openai.com) - LLMs
+* [MongoDB](https://mongodb.com) - Database
+* [Zep](https://getzep.com) - Conversational Memory (optional)
+
+## Installation
+
+You can install Solana Agent using pip:
+
+`pip install solana-agent`
+
+## Basic Usage
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
+    "business": {
+        "mission": "To provide users with a one-stop shop for their queries.",
+        "values": {
+            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
+            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
+        },
+        "goals": [
+            "Empower users with great answers to their queries.",
+        ],
+        "voice": "The voice of the brand is that of a research business."
+    },
+    "mongo": {
+        "connection_string": "mongodb://localhost:27017",
+        "database": "solana_agent"
+    },
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
+    "zep": { # optional
+        "api_key": "your-zep-api-key",
+        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
+    },
+    "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",
+        }
+    ],
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "What are the latest AI developments?"):
+    print(response, end="")
+```
+
+## Plugin Usage
+
+Plugins like Solana Agent Kit (sakit) integrate automatically with Solana Agent.
+
+`pip install sakit`
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
+    "business": {
+        "mission": "To provide users with a one-stop shop for their queries.",
+        "values": {
+            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
+            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
+        },
+        "goals": [
+            "Empower users with great answers to their queries.",
+        ],
+        "voice": "The voice of the brand is that of a research business."
+    },
+    "mongo": {
+        "connection_string": "mongodb://localhost:27017",
+        "database": "solana_agent"
+    },
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
+    "zep": { # optional
+        "api_key": "your-zep-api-key",
+        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
+    },
+    "tools": {
+    "search_internet": {
+        "api_key": "your-perplexity-key", # Required
+        "citations": True, # Optional, defaults to True
+        "model": "sonar"  # Optional, defaults to "sonar"
+    },
+    },
+    "agents": [
+        {
+            "name": "research_specialist",
+            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
+            "specialization": "Research and knowledge synthesis",
+            "tools": ["search_internet"],
+        },
+        {
+            "name": "customer_support",
+            "instructions": "You provide friendly, helpful customer support responses.",
+            "specialization": "Customer inquiries",
+        }
+    ],
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "What are the latest AI developments?"):
+    print(response, end="")
+```
+
+To create a plugin like Solana Agent Kit - read the [code](https://github.com/truemagic-coder/solana-agent-kit)
+
+## Custom Inline Tool Usage
+
+```python
+from solana_agent import SolanaAgent
+from solana_agent.interfaces.plugins.plugins import Tool
+
+class TestTool(Tool):
+    def __init__(self):
+        # your tool initialization - delete the following pass
+        pass
+
+    @property
+    def name(self) -> str:
+        return "test_function"
+
+    @property
+    def description(self) -> str:
+        return "Test function for Solana Agent"
+
+    def configure(self, config: Dict[str, Any]) -> None:
+        """Configure with all possible API key locations."""
+        super().configure(config)
+
+        # read your config values - delete the following pass
+        pass
+
+    def get_schema(self) -> Dict[str, Any]:
+        # this is an example schema
+        return {
+            "type": "object",
+            "properties": {
+                "query": {"type": "string", "description": "Search query text"},
+                "user_id": {"type": "string", "description": "User ID for the search session"}
+            },
+            "required": ["query", "user_id"]
+        }
+
+    async def execute(self, **params) -> Dict[str, Any]:
+        try:
+            # your tool logic
+            result = "Your tool results"
+
+            return {
+                "status": "success",
+                "result": result,
+            }
+        except Exception as e:
+            return {
+                "status": "error",
+                "message": f"Error: {str(e)}",
+            }
+
+config = {
+    "business": {
+        "mission": "To provide users with a one-stop shop for their queries.",
+        "values": {
+            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
+            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
+        },
+        "goals": [
+            "Empower users with great answers to their queries.",
+        ],
+        "voice": "The voice of the brand is that of a research business."
+    },
+    "mongo": {
+        "connection_string": "mongodb://localhost:27017",
+        "database": "solana_agent"
+    },
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
+    "zep": { # optional
+        "api_key": "your-zep-api-key",
+        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
+    },
+    "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",
+        }
+    ],
+}
+
+solana_agent = SolanaAgent(config=config)
+
+test_tool = TestTool()
+
+solana_agent.register_tool(test_tool)
+
+async for response in solana_agent.process("user123", "What are the latest AI developments?"):
+    print(response, end="")
+```
+
+## Notes on Tools
+* 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.
+
+## API Documentation
+* Available at [Solana Agent Documentation Site](https://docs.solana-agent.com)
+
+## Solana Agent Kit
+
+A collection of Solana Agent tools
+
+[Solana Agent Kit](https://github.com/truemagic-coder/solana-agent-kit)
+
+## Example App
+
+A Solana Agent example app written in FastAPI and Next.js
+
+[Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

{solana_agent-18.0.0 → solana_agent-19.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "18.0.0"
+version = "19.0.0"
 description = "Agentic IQ"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"
@@ -29,6 +29,10 @@ pytest = "^8.3.5"
 pytest-cov = "^6.0.0"
 pytest-asyncio = "^0.26.0"
 pytest-github-actions-annotate-failures = "^0.3.0"
+sphinx = "^8.2.3"
+sphinx-rtd-theme = "^3.0.2"
+myst-parser = "^4.0.1"
+sphinx-autobuild = "^2024.10.3"
 
 [build-system]
 requires = ["poetry-core>=1.0.0"]

{solana_agent-18.0.0 → solana_agent-19.0.0}/solana_agent/domains/agent.py

@@ -2,36 +2,34 @@
 Domain models for AI and human agents.
 
 This module defines the core domain models for representing
-AI agents, human agents, and organization mission/values.
+AI agents, human agents, and business mission/values.
 """
-from typing import List, Optional, Dict, Any, Union
-# Import the class directly, not the module
-from datetime import datetime
+from typing import List, Dict, Any
 from pydantic import BaseModel, Field, field_validator
 
 
-class OrganizationMission(BaseModel):
-    """Organization mission and values to guide agent behavior."""
+class BusinessMission(BaseModel):
+    """Business mission and values to guide agent behavior."""
 
-    mission_statement: str = Field(...,
-                                   description="Organization mission statement")
+    mission: str = Field(...,
+                         description="Business mission statement")
     values: List[Dict[str, str]] = Field(
         default_factory=list,
-        description="Organization values as name-description pairs"
+        description="Business values as name-description pairs"
     )
     goals: List[str] = Field(
         default_factory=list,
-        description="Organization goals"
+        description="Business goals"
     )
     voice: str = Field(
-        None, description="Organization voice or tone")
+        None, description="Business voice or tone")
 
-    @field_validator("mission_statement")
+    @field_validator("mission")
     @classmethod
-    def mission_statement_not_empty(cls, v: str) -> str:
-        """Validate that mission statement is not empty."""
+    def mission_not_empty(cls, v: str) -> str:
+        """Validate that mission is not empty."""
         if not v.strip():
-            raise ValueError("Mission statement cannot be empty")
+            raise ValueError("Mission cannot be empty")
         return v
 
     @field_validator("voice")

{solana_agent-18.0.0 → solana_agent-19.0.0}/solana_agent/factories/agent_factory.py

@@ -19,7 +19,7 @@ from solana_agent.adapters.llm_adapter import OpenAIAdapter
 from solana_agent.adapters.mongodb_adapter import MongoDBAdapter
 
 # Domain and plugin imports
-from solana_agent.domains.agent import OrganizationMission
+from solana_agent.domains.agent import BusinessMission
 from solana_agent.plugins.manager import PluginManager
 
 
@@ -46,12 +46,12 @@ class SolanaAgentFactory:
             api_key=config["openai"]["api_key"],
         )
 
-        # Create organization mission if specified in config
-        organization_mission = None
-        if "organization" in config:
-            org_config = config["organization"]
-            organization_mission = OrganizationMission(
-                mission_statement=org_config.get("mission_statement", ""),
+        # Create business mission if specified in config
+        business_mission = None
+        if "business" in config:
+            org_config = config["business"]
+            business_mission = BusinessMission(
+                mission=org_config.get("mission", ""),
                 values=[{"name": k, "description": v}
                         for k, v in org_config.get("values", {}).items()],
                 goals=org_config.get("goals", []),
@@ -68,7 +68,7 @@ class SolanaAgentFactory:
         # Create primary services
         agent_service = AgentService(
             llm_provider=llm_adapter,
-            organization_mission=organization_mission,
+            business_mission=business_mission,
             config=config,
         )
 

{solana_agent-18.0.0 → solana_agent-19.0.0}/solana_agent/services/agent.py

@@ -14,7 +14,7 @@ from solana_agent.interfaces.services.agent import AgentService as AgentServiceI
 from solana_agent.interfaces.providers.llm import LLMProvider
 from solana_agent.interfaces.plugins.plugins import ToolRegistry as ToolRegistryInterface
 from solana_agent.plugins.registry import ToolRegistry
-from solana_agent.domains.agent import AIAgent, OrganizationMission
+from solana_agent.domains.agent import AIAgent, BusinessMission
 
 
 class AgentService(AgentServiceInterface):
@@ -23,18 +23,18 @@ class AgentService(AgentServiceInterface):
     def __init__(
         self,
         llm_provider: LLMProvider,
-        organization_mission: Optional[OrganizationMission] = None,
+        business_mission: Optional[BusinessMission] = None,
         config: Optional[Dict[str, Any]] = None,
     ):
         """Initialize the agent service.
 
         Args:
             llm_provider: Provider for language model interactions
-            organization_mission: Optional organization mission and values
+            business_mission: Optional business mission and values
             config: Optional service configuration
         """
         self.llm_provider = llm_provider
-        self.organization_mission = organization_mission
+        self.business_mission = business_mission
         self.config = config or {}
         self.last_text_response = ""
         self.tool_registry = ToolRegistry(config=self.config)
@@ -81,22 +81,22 @@ class AgentService(AgentServiceInterface):
         system_prompt += f"\n\nThe current time is {datetime.now(tz=main_datetime.timezone.utc)}\n\n."
 
         # Add mission and values if available
-        if self.organization_mission:
-            system_prompt += f"\n\nORGANIZATION MISSION:\n{self.organization_mission.mission_statement}"
-            system_prompt += f"\n\nVOICE OF THE BRAND:\n{self.organization_mission.voice}"
+        if self.business_mission:
+            system_prompt += f"\n\nBUSINESS MISSION:\n{self.business_mission.mission}"
+            system_prompt += f"\n\nVOICE OF THE BRAND:\n{self.business_mission.voice}"
 
-            if self.organization_mission.values:
+            if self.business_mission.values:
                 values_text = "\n".join([
                     f"- {value.get('name', '')}: {value.get('description', '')}"
-                    for value in self.organization_mission.values
+                    for value in self.business_mission.values
                 ])
-                system_prompt += f"\n\nORGANIZATION VALUES:\n{values_text}"
+                system_prompt += f"\n\nBUSINESS VALUES:\n{values_text}"
 
-            # Add organization goals if available
-            if self.organization_mission.goals:
+            # Add goals if available
+            if self.business_mission.goals:
                 goals_text = "\n".join(
-                    [f"- {goal}" for goal in self.organization_mission.goals])
-                system_prompt += f"\n\nORGANIZATION GOALS:\n{goals_text}"
+                    [f"- {goal}" for goal in self.business_mission.goals])
+                system_prompt += f"\n\nBUSINESS GOALS:\n{goals_text}"
 
         return system_prompt
 

solana_agent-18.0.0/PKG-INFO

@@ -1,129 +0,0 @@
-Metadata-Version: 2.3
-Name: solana-agent
-Version: 18.0.0
-Summary: Agentic IQ
-License: MIT
-Keywords: ai,openai,ai agents,agi
-Author: Bevan Hunt
-Author-email: bevan@bevanhunt.com
-Requires-Python: >=3.12,<4.0
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3 :: Only
-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.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
-
-# Solana Agent
-
-[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent?color=yellow)](https://pypi.org/project/solana-agent/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-orange.svg)](https://www.python.org/downloads/)
-[![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/truemagic-coder/solana-agent/ci.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/ci.yml)
-
-![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
-
-## Agentic IQ
-
-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 (optional)
-* Intelligent query routing to agents with optimal domain expertise
-* 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
-* [OpenAI](https://openai.com) - LLMs
-* [MongoDB](https://mongodb.com) - Database
-* [Zep](https://getzep.com) - Conversational Memory (optional)
-
-## Installation
-
-You can install Solana Agent using pip:
-
-`pip install solana-agent`
-
-## Example App
-
-```python
-from solana_agent import SolanaAgent
-
-config = {
-    "organization": {
-        "mission_statement": "To provide users with a one-stop shop for their queries.",
-        "values": {
-            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
-            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
-        },
-        "goals": [
-            "Empower users with great answers to their queries.",
-        ],
-        "voice": "The voice of the brand is that of a research organization."
-    },
-    "mongo": {
-        "connection_string": "mongodb://localhost:27017",
-        "database": "solana_agent"
-    },
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "zep": { # optional
-        "api_key": "your-zep-api-key",
-        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-            "tools": ["some_tool"]
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-async for response in solana_agent.process("user123", "What are the latest AI developments?"):
-    print(response, end="")
-```
-
-## Solana Agent Kit
-
-A collection of Solana Agent tools
-
-[Solana Agent Kit](https://github.com/truemagic-coder/solana-agent-kit)
-
-## Example App
-
-A Solana Agent example app written in FastAPI and Next.js
-
-[Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
-
-## License
-
-This project is licensed under the MIT License - see the LICENSE file for details.
-

solana_agent-18.0.0/README.md

@@ -1,105 +0,0 @@
-# Solana Agent
-
-[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent?color=yellow)](https://pypi.org/project/solana-agent/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-orange.svg)](https://www.python.org/downloads/)
-[![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/truemagic-coder/solana-agent/ci.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/ci.yml)
-
-![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
-
-## Agentic IQ
-
-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 (optional)
-* Intelligent query routing to agents with optimal domain expertise
-* 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
-* [OpenAI](https://openai.com) - LLMs
-* [MongoDB](https://mongodb.com) - Database
-* [Zep](https://getzep.com) - Conversational Memory (optional)
-
-## Installation
-
-You can install Solana Agent using pip:
-
-`pip install solana-agent`
-
-## Example App
-
-```python
-from solana_agent import SolanaAgent
-
-config = {
-    "organization": {
-        "mission_statement": "To provide users with a one-stop shop for their queries.",
-        "values": {
-            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
-            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
-        },
-        "goals": [
-            "Empower users with great answers to their queries.",
-        ],
-        "voice": "The voice of the brand is that of a research organization."
-    },
-    "mongo": {
-        "connection_string": "mongodb://localhost:27017",
-        "database": "solana_agent"
-    },
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "zep": { # optional
-        "api_key": "your-zep-api-key",
-        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-            "tools": ["some_tool"]
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-async for response in solana_agent.process("user123", "What are the latest AI developments?"):
-    print(response, end="")
-```
-
-## Solana Agent Kit
-
-A collection of Solana Agent tools
-
-[Solana Agent Kit](https://github.com/truemagic-coder/solana-agent-kit)
-
-## Example App
-
-A Solana Agent example app written in FastAPI and Next.js
-
-[Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
-
-## License
-
-This project is licensed under the MIT License - see the LICENSE file for details.