solana-agent 10.0.0__py3-none-any.whl → 11.0.1__py3-none-any.whl

solana_agent/ai.py

@@ -13,7 +13,6 @@ This module implements a clean architecture approach with:
 import asyncio
 import datetime
 import json
-import os
 import re
 import traceback
 import uuid
@@ -39,10 +38,6 @@ from zep_python.client import AsyncZep
 from zep_cloud.types import Message
 from pinecone import Pinecone
 from abc import ABC, abstractmethod
-import sys
-import importlib
-import subprocess
-from pathlib import Path
 
 
 #############################################
@@ -4268,9 +4263,8 @@ class SolanaAgentFactory:
             llm_adapter, task_planning_service
         )
 
-        # Initialize plugin system if plugins directory is configured
-        plugins_dir = config.get("plugins_dir", "plugins")
-        agent_service.plugin_manager = PluginManager(plugins_dir)
+        # Initialize plugin system if plugins directory is configured)
+        agent_service.plugin_manager = PluginManager()
         loaded_plugins = agent_service.plugin_manager.load_all_plugins()
         print(f"Loaded {loaded_plugins} plugins")
 
@@ -5033,182 +5027,47 @@ tool_registry = ToolRegistry()
 class PluginManager:
     """Manages discovery, loading and execution of plugins."""
 
-    def __init__(self, plugins_dir: str = "plugins"):
-        self.plugins_dir = Path(plugins_dir)
-        self.loaded_plugins = {}
-        self.plugin_envs = {}
-
-    def discover_plugins(self) -> List[Dict[str, Any]]:
-        """Find all plugins in the plugins directory."""
-        plugins = []
-
-        if not self.plugins_dir.exists():
-            return plugins
-
-        for plugin_dir in self.plugins_dir.iterdir():
-            if not plugin_dir.is_dir():
-                continue
-
-            metadata_file = plugin_dir / "plugin.json"
-
-            if metadata_file.exists():
-                try:
-                    with open(metadata_file, "r") as f:
-                        metadata = json.load(f)
-
-                    metadata["path"] = str(plugin_dir)
-                    plugins.append(metadata)
-                except Exception as e:
-                    print(
-                        f"Error loading plugin metadata from {metadata_file}: {e}")
-
-        return plugins
-
-    def setup_plugin_environment(self, plugin_metadata: Dict[str, Any]) -> str:
-        """Setup virtual environment for a plugin and install its dependencies.
+    def __init__(self):
+        self.tools = {}
 
-        Args:
-            plugin_metadata: Plugin metadata including path
+    def load_all_plugins(self) -> int:
+        """Load all plugins using setuptools entry points.
 
-        Returns:
-            Path to the plugin's virtual environment
+        Returns the number of plugins loaded for backwards compatibility.
         """
-        plugin_name = plugin_metadata["name"]
-        plugin_path = Path(plugin_metadata["path"])
-
-        # Create virtual environment for plugin
-        env_dir = Path(self.plugins_dir) / f"{plugin_name}_env"
-
-        # If environment already exists, return its path
-        if env_dir.exists():
-            return str(env_dir)
-
-        print(f"Creating virtual environment for plugin {plugin_name}")
-
-        # Check if requirements file exists
-        requirements_file = plugin_path / "requirements.txt"
-        pyproject_file = plugin_path / "pyproject.toml"
+        import importlib.metadata
 
-        # Create virtual environment
-        import venv
-        venv.create(env_dir, with_pip=True)
-
-        # Determine package installation command (prefer uv if available)
-        try:
-            # Try to import uv to check if it's installed
-            import importlib.util
-            uv_spec = importlib.util.find_spec("uv")
-            use_uv = uv_spec is not None
-        except ImportError:
-            use_uv = False
-
-        # Install dependencies if requirements file exists
-        if requirements_file.exists() or pyproject_file.exists():
-            print(f"Installing requirements for plugin {plugin_name}")
-
-            # Prepare pip command
-            if sys.platform == "win32":
-                pip_path = env_dir / "Scripts" / "pip"
-            else:
-                pip_path = env_dir / "bin" / "pip"
-
-            # Install dependencies using uv if available
+        count = 0
+        # Discover plugins registered via entry_points
+        for entry_point in importlib.metadata.entry_points(group='solana_agent.plugins'):
             try:
-                if use_uv:
-                    # Use UV for faster dependency installation
-                    target_file = "pyproject.toml" if pyproject_file.exists() else "requirements.txt"
-                    subprocess.check_call([
-                        "uv", "pip", "install",
-                        "-r" if target_file == "requirements.txt" else ".",
-                        str(plugin_path / target_file)
-                    ])
-                else:
-                    # Fall back to regular pip
-                    if requirements_file.exists():
-                        subprocess.check_call([
-                            str(pip_path), "install", "-r",
-                            str(requirements_file)
-                        ])
-                    elif pyproject_file.exists():
-                        subprocess.check_call([
-                            str(pip_path), "install",
-                            str(plugin_path)
-                        ])
-            except subprocess.CalledProcessError as e:
-                print(
-                    f"Failed to install dependencies for plugin {plugin_name}: {e}")
-
-        return str(env_dir)
-
-    def load_plugin(self, plugin_metadata: Dict[str, Any]) -> bool:
-        """Load a plugin and register its tools."""
-        plugin_name = plugin_metadata["name"]
-        plugin_path = plugin_metadata["path"]
-
-        # Setup environment for plugin
-        env_dir = self.setup_plugin_environment(plugin_metadata)
-        self.plugin_envs[plugin_name] = env_dir
-
-        # Add plugin directory to path temporarily (fix for import discovery)
-        # We need to add the parent directory, not just the plugin directory itself
-        parent_dir = os.path.dirname(str(plugin_path))
-        sys.path.insert(0, parent_dir)
-
-        try:
-            # Import the plugin module
-            plugin_module = importlib.import_module(plugin_name)
-
-            # Call the plugin's setup function if it exists
-            if hasattr(plugin_module, "register_tools"):
-                plugin_module.register_tools(tool_registry)
-
-            self.loaded_plugins[plugin_name] = plugin_metadata
-            return True
-
-        except Exception as e:
-            print(f"Error loading plugin {plugin_name}: {e}")
-            import traceback
-            traceback.print_exc()  # This will help debug import issues
-            return False
-
-        finally:
-            # Remove the plugin directory from path
-            if parent_dir in sys.path:
-                sys.path.remove(parent_dir)
+                plugin_class = entry_point.load()
+                plugin = plugin_class()
+
+                # Register all tools from this plugin
+                for tool in plugin.get_tools():
+                    self.tools[tool.name] = tool
+                    print(f"Registered tool: {tool.name}")
+                count += 1
+            except Exception as e:
+                print(f"Error loading plugin {entry_point.name}: {e}")
 
-    def load_all_plugins(self) -> int:
-        """Discover and load all available plugins."""
-        plugins = self.discover_plugins()
-        loaded_count = 0
+        return count
 
-        for plugin_metadata in plugins:
-            if self.load_plugin(plugin_metadata):
-                loaded_count += 1
+    def get_tool(self, name):
+        """Get a tool by name."""
+        return self.tools.get(name)
 
-        return loaded_count
+    def list_tools(self):
+        """List all available tools."""
+        return list(self.tools.keys())
 
     def execute_tool(self, tool_name: str, **kwargs) -> Dict[str, Any]:
         """Execute a tool with provided parameters."""
-        tool = tool_registry.get_tool(tool_name)
+        tool = self.tools.get(tool_name)
         if not tool:
             raise ValueError(f"Tool {tool_name} not found")
 
-        # Get the plugin name for this tool
-        plugin_name = None
-        for name, metadata in self.loaded_plugins.items():
-            tool_list = metadata.get("tools", [])
-            if isinstance(tool_list, list) and tool_name in tool_list:
-                plugin_name = name
-                break
-
-        if not plugin_name or plugin_name not in self.plugin_envs:
-            # If we can't identify the plugin, execute in the current environment
-            try:
-                return tool.execute(**kwargs)
-            except Exception as e:
-                return {"error": str(e), "status": "error"}
-
-        # Execute in isolated environment
         try:
             return tool.execute(**kwargs)
         except Exception as e:

{solana_agent-10.0.0.dist-info → solana_agent-11.0.1.dist-info}/METADATA

@@ -1,30 +1,27 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 10.0.0
+Version: 11.0.1
 Summary: The Future of Work
 License: MIT
 Keywords: ai,openai,ai agents,agi
 Author: Bevan Hunt
 Author-email: bevan@bevanhunt.com
-Requires-Python: >=3.9,<4.0
+Requires-Python: >=3.12,<4.0
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 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: ntplib (>=0.4.0,<0.5.0)
-Requires-Dist: openai (>=1.65.5,<2.0.0)
+Requires-Dist: openai (>=1.66.1,<2.0.0)
 Requires-Dist: pandas (>=2.2.3,<3.0.0)
 Requires-Dist: pinecone (>=6.0.1,<7.0.0)
 Requires-Dist: pydantic (>=2.10.6,<3.0.0)
 Requires-Dist: pymongo (>=4.11.2,<5.0.0)
 Requires-Dist: qdrant-client (>=1.13.3,<2.0.0)
 Requires-Dist: requests (>=2.32.3,<3.0.0)
-Requires-Dist: zep-cloud (>=2.5.0,<3.0.0)
+Requires-Dist: zep-cloud (>=2.6.1,<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
@@ -33,7 +30,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-orange.svg)](https://www.python.org/downloads/)
+[![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/test.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/test.yml)
 
@@ -246,15 +243,15 @@ Solana Agent transforms organizations into living systems that continuously lear
     Standardized interfaces across all tenants.  
     Efficient multi-tenant scaling with shared infrastructure.
 
-- **🔌 Plugin System:**  
-    Extensible architecture with dynamic tool loading capabilities.  
-    Isolated plugin environments with dependency management.  
+- **🔌 Standard Python Plugin System:**  
+    Extensible architecture using Python's native package ecosystem.  
+    PyPI-compatible plugin distribution with standard dependency management.  
+    Entry point registration (`solana_agent.plugins`) for seamless discovery.  
     Tool registry for AI agent capability extension.  
     Permission-based tool access for security and control.  
-    Standard interface for third-party integrations.  
+    Clean interface for third-party integrations through standard Python APIs.  
     Built-in internet search capabilities via Perplexity API.  
-    Seamless AI agent interaction with external services.  
-    Runtime tool discovery without code modification.
+    Runtime tool discovery without service restarts.
 
 ## Implementation Technologies
 
@@ -281,7 +278,7 @@ You can install Solana Agent using pip:
 
 Each public method has a docstring for real-time IDE hinting.
 
-## Example Setup
+## Example App
 
 ```python
 from solana_agent import SolanaAgent
@@ -315,7 +312,6 @@ config = {
         "api_key": "your-pinecone-key",
         "index": "your-index"
     },
-    "plugins_dir": "plugins",
     "ai_agents": [
         {
             "name": "research_specialist",
@@ -356,6 +352,55 @@ async for response in solana_agent.process("user123", "What are the latest AI de
     print(response, end="")
 ```
 
+## Example Plugin
+
+`my_plugin/plugin.py`
+
+```python
+from solana_agent import Tool
+
+class MyCustomTool(Tool):
+    @property
+    def name(self) -> str:
+        return "my_custom_tool"
+    
+    @property
+    def description(self) -> str:
+        return "Does something amazing"
+    
+    @property
+    def parameters_schema(self) -> dict:
+        return {
+            "type": "object",
+            "properties": {
+                "parameter1": {"type": "string", "description": "First parameter"}
+            }
+        }
+    
+    def execute(self, **kwargs) -> dict:
+        # Tool implementation here
+        return {"result": "success", "data": "Something amazing"}
+
+class SolanaPlugin:
+    def get_tools(self):
+        return [MyCustomTool()]
+```
+
+`pyproject.toml`
+
+```toml
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "my-solana-plugin"
+version = "0.1.0"
+
+[project.entry-points."solana_agent.plugins"]
+my_plugin = "my_plugin.plugin:SolanaPlugin"
+```
+
 ## Example App
 
 [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)

solana_agent-11.0.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+solana_agent/__init__.py,sha256=zpfnWqANd3OHGWm7NCF5Y6m01BWG4NkNk8SK9Ex48nA,18
+solana_agent/ai.py,sha256=zhJAPg8fFGlCToQEC0XczSPmOPS_DJ97upHLAYwvhDI,187870
+solana_agent-11.0.1.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
+solana_agent-11.0.1.dist-info/METADATA,sha256=ArtGnRtBJUKKqr2DYn4DfL-bgV4_axjNLOAJvwAbEAY,17731
+solana_agent-11.0.1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+solana_agent-11.0.1.dist-info/RECORD,,

solana_agent-10.0.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-solana_agent/__init__.py,sha256=zpfnWqANd3OHGWm7NCF5Y6m01BWG4NkNk8SK9Ex48nA,18
-solana_agent/ai.py,sha256=434Wvowzpw48_fGlMWsBUo9oZswwK7DCcsmI_e9bcyI,193201
-solana_agent-10.0.0.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
-solana_agent-10.0.0.dist-info/METADATA,sha256=q1dcqNEPYC3wX8dcSoe08z5SWnKkO2qvAIeK1EQC-4E,16816
-solana_agent-10.0.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-solana_agent-10.0.0.dist-info/RECORD,,