sakit 0.0.1__tar.gz

sakit-0.0.1/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Bevan Hunt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

sakit-0.0.1/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.3
+Name: sakit
+Version: 0.0.1
+Summary: Solana Agent Kit
+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: requests (>=2.32.3,<3.0.0)
+Requires-Dist: solana-agent (>=11.3.0,<12.0.0)
+Project-URL: Repository, https://github.com/truemagic-coder/solana-agent-kit
+Description-Content-Type: text/markdown
+
+# Solana Agent Kit
+
+[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent-kit)](https://pypi.org/project/solana-agent-kit/)
+[![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/)
+
+A collection of powerful plugins to extend the capabilities of Solana Agent.
+
+## 🚀 Features
+Solana Agent Kit provides a growing library of plugins that enhance your Solana Agent with new capabilities:
+
+🔍 Internet Search - Search the internet in real-time using Perplexity AI
+
+📝 More plugins coming soon!
+
+## 📦 Installation
+
+```bash
+# Using pip
+pip install sakit
+
+# Using Poetry
+poetry add sakit
+```
+
+🔌 Plugins
+Internet Search Plugin
+This plugin enables Solana Agent to search the internet for up-to-date information using Perplexity AI.
+
+Configuration
+Add your Perplexity API key to your Solana Agent configuration:
+
+```python
+config = {
+    # Standard Solana Agent config
+    "openai": {
+        "api_key": "your-openai-key",
+        "default_model": "gpt-4o-mini"
+    },
+    
+    # Required for the internet search plugin
+    "perplexity_api_key": "your-perplexity-key",
+    
+    # Optional: Configure default search model
+    "tools": {
+        "search_internet": {
+            "default_model": "sonar-reasoning-pro"  # Optional, defaults to "sonar"
+        }
+    },
+    
+    # Grant access to specific agents
+    "ai_agents": [
+        {
+            "name": "research_specialist",
+            "tools": ["search_internet"],  # Enable the tool for this agent
+            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
+            "specialization": "Research and knowledge synthesis",
+            "model": "gpt-4o-mini"
+        }
+    ]
+}
+```
+
+**Available Search Models**
+* sonar: Fast, general-purpose search
+* sonar-pro: Enhanced search capabilities
+* sonar-reasoning-pro: Advanced reasoning with search
+* sonar-reasoning: Basic reasoning with search
+
+## Usage Examples
+
+### Direct command:
+
+`!search_internet What are the latest developments in quantum computing?`
+
+### #With model parameter:
+`!search_internet --model=sonar-pro What is the current Bitcoin price?`
+
+### Automatic usage by agents:
+
+AI agents with access to the tool will automatically use it when they determine current information is necessary to answer a query.
+
+### Programmatic usage:
+
+```python
+# Execute the search tool directly
+result = await solana_agent.get_tool_service().execute_tool(
+    "search_internet",
+    user_id="user123",
+    params={
+        "query": "Latest developments in AI",
+        "model": "sonar-reasoning-pro"  # Optional, overrides default
+    }
+)
+```
+
+## 🧩 Plugin Development
+Want to add your own plugins to Solana Agent Kit? Follow these guidelines:
+
+1. Create a new plugin directory under solana_agent_kit/
+2. Implement a plugin class that follows Solana Agent's plugin architecture
+3. Add your plugin to the list in __init__.py
+4. Test thoroughly
+5. Submit a PR!
+
+## 📄 License
+This project is licensed under the MIT License - see the LICENSE file for details.
+

sakit-0.0.1/README.md

@@ -0,0 +1,107 @@
+# Solana Agent Kit
+
+[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent-kit)](https://pypi.org/project/solana-agent-kit/)
+[![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/)
+
+A collection of powerful plugins to extend the capabilities of Solana Agent.
+
+## 🚀 Features
+Solana Agent Kit provides a growing library of plugins that enhance your Solana Agent with new capabilities:
+
+🔍 Internet Search - Search the internet in real-time using Perplexity AI
+
+📝 More plugins coming soon!
+
+## 📦 Installation
+
+```bash
+# Using pip
+pip install sakit
+
+# Using Poetry
+poetry add sakit
+```
+
+🔌 Plugins
+Internet Search Plugin
+This plugin enables Solana Agent to search the internet for up-to-date information using Perplexity AI.
+
+Configuration
+Add your Perplexity API key to your Solana Agent configuration:
+
+```python
+config = {
+    # Standard Solana Agent config
+    "openai": {
+        "api_key": "your-openai-key",
+        "default_model": "gpt-4o-mini"
+    },
+    
+    # Required for the internet search plugin
+    "perplexity_api_key": "your-perplexity-key",
+    
+    # Optional: Configure default search model
+    "tools": {
+        "search_internet": {
+            "default_model": "sonar-reasoning-pro"  # Optional, defaults to "sonar"
+        }
+    },
+    
+    # Grant access to specific agents
+    "ai_agents": [
+        {
+            "name": "research_specialist",
+            "tools": ["search_internet"],  # Enable the tool for this agent
+            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
+            "specialization": "Research and knowledge synthesis",
+            "model": "gpt-4o-mini"
+        }
+    ]
+}
+```
+
+**Available Search Models**
+* sonar: Fast, general-purpose search
+* sonar-pro: Enhanced search capabilities
+* sonar-reasoning-pro: Advanced reasoning with search
+* sonar-reasoning: Basic reasoning with search
+
+## Usage Examples
+
+### Direct command:
+
+`!search_internet What are the latest developments in quantum computing?`
+
+### #With model parameter:
+`!search_internet --model=sonar-pro What is the current Bitcoin price?`
+
+### Automatic usage by agents:
+
+AI agents with access to the tool will automatically use it when they determine current information is necessary to answer a query.
+
+### Programmatic usage:
+
+```python
+# Execute the search tool directly
+result = await solana_agent.get_tool_service().execute_tool(
+    "search_internet",
+    user_id="user123",
+    params={
+        "query": "Latest developments in AI",
+        "model": "sonar-reasoning-pro"  # Optional, overrides default
+    }
+)
+```
+
+## 🧩 Plugin Development
+Want to add your own plugins to Solana Agent Kit? Follow these guidelines:
+
+1. Create a new plugin directory under solana_agent_kit/
+2. Implement a plugin class that follows Solana Agent's plugin architecture
+3. Add your plugin to the list in __init__.py
+4. Test thoroughly
+5. Submit a PR!
+
+## 📄 License
+This project is licensed under the MIT License - see the LICENSE file for details.

sakit-0.0.1/pyproject.toml

@@ -0,0 +1,26 @@
+[tool.poetry]
+name = "sakit"
+version = "0.0.1"
+description = "Solana Agent Kit"
+authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
+license = "MIT"
+readme = "README.md"
+repository = "https://github.com/truemagic-coder/solana-agent-kit"
+keywords = ["ai", "openai", "ai agents", "agi"]
+classifiers = [
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+packages = [{ include = "sakit" }]
+
+[tool.poetry.dependencies]
+python = ">=3.12,<4.0"
+requests = "^2.32.3"
+solana-agent = "^11.3.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.plugins."solana_agent.plugins"]
+search_internet = "sakit.search_internet:SolanaPlugin"

sakit-0.0.1/sakit/search_internet/__init__.py

@@ -0,0 +1,5 @@
+"""Search Internet plugin for Solana Agent."""
+
+from .plugin import SolanaPlugin
+
+__all__ = ["SolanaPlugin"]

sakit-0.0.1/sakit/search_internet/plugin.py

@@ -0,0 +1,148 @@
+"""
+Search Internet Plugin for Solana Agent
+Uses Perplexity AI API to search the web and provide results
+"""
+
+import requests
+from typing import Dict, Any, Optional, Literal, List
+from solana_agent import Tool
+
+
+class SearchInternetTool(Tool):
+    """Tool for searching the internet using Perplexity AI."""
+
+    def __init__(self, config=None):
+        """Initialize with optional config."""
+        self._config = config or {}
+        self._api_key = self._config.get("perplexity_api_key")
+        self._default_model = (
+            self._config.get("tools", {})
+            .get("search_internet", {})
+            .get("default_model", "sonar")
+        )
+
+    @property
+    def name(self) -> str:
+        """Return the tool name."""
+        return "search_internet"
+
+    @property
+    def description(self) -> str:
+        """Return the tool description."""
+        return "Search the internet for current information on any topic using Perplexity AI"
+
+    @property
+    def parameters_schema(self) -> Dict[str, Any]:
+        """Return the JSON schema for the tool parameters."""
+        return {
+            "type": "object",
+            "properties": {
+                "query": {
+                    "type": "string",
+                    "description": "The search query to look up online",
+                },
+                "model": {
+                    "type": "string",
+                    "enum": [
+                        "sonar",
+                        "sonar-pro",
+                        "sonar-reasoning-pro",
+                        "sonar-reasoning",
+                    ],
+                    "description": f"The Perplexity model to use for search (default: {self._default_model})",
+                },
+            },
+            "required": ["query"],
+        }
+
+    def execute(self, query: str, model: Optional[str] = None) -> Dict[str, Any]:
+        """Execute the search and return results.
+
+        Args:
+            query: The search query string
+            model: Optional Perplexity model to use, overrides default if specified
+
+        Returns:
+            Dictionary containing search results or error message
+        """
+        # Use specified model or fall back to default
+        search_model = model if model else self._default_model
+
+        result = self._search_internet(query, search_model)
+
+        if result.startswith("Failed") or result.startswith("Error"):
+            return {"status": "error", "message": result}
+
+        return {"status": "success", "result": result, "model_used": search_model}
+
+    def _search_internet(
+        self,
+        query: str,
+        model: Literal[
+            "sonar", "sonar-pro", "sonar-reasoning-pro", "sonar-reasoning"
+        ] = "sonar",
+    ) -> str:
+        """Perform the internet search using Perplexity AI API.
+
+        Args:
+            query: Search query string
+            model: Perplexity model to use
+                - sonar: Fast, general-purpose search
+                - sonar-pro: Enhanced search capabilities
+                - sonar-reasoning-pro: Advanced reasoning with search
+                - sonar-reasoning: Basic reasoning with search
+
+        Returns:
+            Search results or error message if search fails
+        """
+        try:
+            if not self._api_key:
+                return "Error: Perplexity API key not configured. Please add 'perplexity_api_key' to your configuration."
+
+            url = "https://api.perplexity.ai/chat/completions"
+
+            payload = {
+                "model": model,
+                "messages": [
+                    {
+                        "role": "system",
+                        "content": "You answer the user's query by searching the internet for current information. Provide sources when available.",
+                    },
+                    {
+                        "role": "user",
+                        "content": query,
+                    },
+                ],
+            }
+            headers = {
+                "Authorization": f"Bearer {self._api_key}",
+                "Content-Type": "application/json",
+            }
+
+            response = requests.post(url, json=payload, headers=headers)
+            if response.status_code == 200:
+                data = response.json()
+                content = data["choices"][0]["message"]["content"]
+                return content
+            else:
+                return (
+                    f"Failed to search Perplexity. Status code: {response.status_code}"
+                )
+        except Exception as e:
+            return f"Failed to search Perplexity. Error: {e}"
+
+
+class SolanaPlugin:
+    """Plugin provider for Solana Agent."""
+
+    def __init__(self):
+        """Initialize the plugin."""
+        self.config = None
+
+    def initialize(self, config: Dict[str, Any]) -> None:
+        """Initialize with config from Solana Agent."""
+        self.config = config
+
+    def get_tools(self) -> List[Tool]:
+        """Return the list of tools provided by this plugin."""
+        return [SearchInternetTool(self.config)]