solana-agent 28.3.0__py3-none-any.whl → 28.3.2__py3-none-any.whl

{solana_agent-28.3.0.dist-info → solana_agent-28.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 28.3.0
+Version: 28.3.2
 Summary: AI Agents for Solana
 License: MIT
 Keywords: solana,solana ai,solana agent,ai,ai agent,ai agents
@@ -14,20 +14,20 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Dist: instructor (>=1.7.9,<2.0.0)
-Requires-Dist: llama-index-core (>=0.12.32,<0.13.0)
-Requires-Dist: llama-index-embeddings-openai (>=0.3.1,<0.4.0)
-Requires-Dist: logfire (>=3.14.0,<4.0.0)
-Requires-Dist: openai (>=1.75.0,<2.0.0)
-Requires-Dist: pillow (>=11.2.1,<12.0.0)
-Requires-Dist: pinecone (>=6.0.2,<7.0.0)
+Requires-Dist: instructor (==1.7.9)
+Requires-Dist: llama-index-core (==0.12.32)
+Requires-Dist: llama-index-embeddings-openai (==0.3.1)
+Requires-Dist: logfire (==3.14.1)
+Requires-Dist: openai (==1.76.2)
+Requires-Dist: pillow (==11.2.1)
+Requires-Dist: pinecone (==6.0.2)
 Requires-Dist: pydantic (>=2)
-Requires-Dist: pymongo (>=4.12.0,<5.0.0)
-Requires-Dist: pypdf (>=5.4.0,<6.0.0)
-Requires-Dist: rich (>=13)
-Requires-Dist: scrubadub (>=2.0.1,<3.0.0)
-Requires-Dist: typer (>=0.15.2,<0.16.0)
-Requires-Dist: zep-cloud (>=2.10.2,<3.0.0)
+Requires-Dist: pymongo (==4.12.1)
+Requires-Dist: pypdf (==5.4.0)
+Requires-Dist: rich (>=13,<14.0)
+Requires-Dist: scrubadub (==2.0.1)
+Requires-Dist: typer (==0.15.3)
+Requires-Dist: zep-cloud (==2.11.0)
 Project-URL: Documentation, https://docs.solana-agent.com
 Project-URL: Homepage, https://solana-agent.com
 Project-URL: Repository, https://github.com/truemagic-coder/solana-agent
@@ -64,9 +64,11 @@ Build your AI agents in three lines of code!
 * Business Alignment
 * Extensible Tooling
 * Automatic Tool Workflows
+* Autonomous Operation
 * Knowledge Base
 * MCP Support
 * Guardrails
+* Image Generation
 * Pydantic Logfire
 * Tested & Secure
 * Built in Python
@@ -91,7 +93,9 @@ 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
+* Generate custom images based on text prompts with storage on S3 compatible services
 * Automatic sequential tool workflows allowing agents to chain multiple tools
+* Combine with event-driven systems to create autonomous agents
 
 ## Stack
 
@@ -113,6 +117,7 @@ Build your AI agents in three lines of code!
 * [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)
+* [gpt-image-1](https://platform.openai.com/docs/models/gpt-image-1) (image generation)
 
 ## Installation
 
@@ -603,6 +608,8 @@ class MyOutputGuardrail(OutputGuardrail):
 
 ## Tools
 
+Tools empower agents to interact with external systems, fetch data, or perform actions. They can be used reactively within a user conversation or proactively when an agent is triggered autonomously.
+
 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 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)
@@ -705,6 +712,45 @@ async for response in solana_agent.process("user123", "Send an email to bob@bob.
     print(response, end="")
 ```
 
+### Image Generation
+
+Generate images using OpenAI's `gpt-image-1` and upload them to S3-compatible storage.
+
+`pip install sakit`
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
+    "openai": {
+        "api_key": "your-openai-api-key" # Required: Your OpenAI API key
+    },
+    "tools": {
+        "image_gen": {
+            "s3_endpoint_url": "https://your-s3-endpoint.com",           # Required: e.g., https://nyc3.digitaloceanspaces.com
+            "s3_access_key_id": "YOUR_S3_ACCESS_KEY",                    # Required: Your S3 access key ID
+            "s3_secret_access_key": "YOUR_S3_SECRET_KEY",                # Required: Your S3 secret access key
+            "s3_bucket_name": "your-bucket-name",                        # Required: The name of your S3 bucket
+            "s3_region_name": "your-region",                             # Optional: e.g., "nyc3", needed by some providers
+            "s3_public_url_base": "https://your-cdn-or-bucket-url.com/", # Optional: Custom base URL for public links (include trailing slash). If omitted, a standard URL is constructed.
+        }
+    },
+    "agents": [
+        {
+            "name": "image_creator",
+            "instructions": "You are a creative assistant that generates images based on user descriptions. Use the image_gen tool to create and store the image.",
+            "specialization": "Image generation and storage",
+            "tools": ["image_gen"],  # Enable the tool for this agent
+        }
+    ]
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "Generate an image of a smiling unicorn!"):
+    print(response, end="")
+```
+
 ### Inline Tool Example
 
 ```python
@@ -785,6 +831,19 @@ async for response in solana_agent.process("user123", "What are the latest AI de
     print(response, end="")
 ```
 
+## Autonomous Operation & Event-Driven Agents
+
+While Solana Agent facilitates request-response interactions, the underlying architecture supports building autonomous agents. You can achieve autonomy by orchestrating calls based on external triggers rather than direct user input.
+
+**Key Concepts:**
+
+*   **External Triggers:** Use schedulers like cron, message queues (RabbitMQ, Kafka), monitoring systems, webhooks, or other event sources to initiate agent actions.
+*   **Programmatic Calls:** Instead of a user typing a message, your triggering system calls with a specific message (acting as instructions or data for the task) and potentially a dedicated user representing the autonomous process.
+*   **Tool-Centric Tasks:** Autonomous agents often focus on executing specific tools. The prompt can instruct the agent to use a particular tool with given parameters derived from the triggering event.
+*   **Example Scenario:** An agent could be triggered hourly by a scheduler. The `message` could be "Check the SOL balance for wallet X using the `solana` tool." The agent executes the tool, and the result could be logged or trigger another tool (e.g., using `mcp` to send an alert if the balance is low).
+
+By combining Solana Agent's agent definitions, tool integration, and routing with external orchestration, you can create sophisticated autonomous systems.
+
 ## Advanced Customization
 
 ### Runtime Prompt Injection

{solana_agent-28.3.0.dist-info → solana_agent-28.3.2.dist-info}/RECORD

@@ -36,8 +36,8 @@ solana_agent/services/agent.py,sha256=QoeQq_OEWyLdBS0FPa-lXm5qiE0RnRfrCKiFTfOSGE
 solana_agent/services/knowledge_base.py,sha256=D4QNGC3Z8E7iX-CEGpRks0lW4wWJt-WorO3J8mu6ayU,35318
 solana_agent/services/query.py,sha256=ENUfs4WSTpODMRXppDVW-Y3li9jYn8pOfQIHIPerUdQ,18498
 solana_agent/services/routing.py,sha256=C5Ku4t9TqvY7S8wlUPMTC04HCrT4Ib3E8Q8yX0lVU_s,7137
-solana_agent-28.3.0.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
-solana_agent-28.3.0.dist-info/METADATA,sha256=d0bjKGS6LRao_sJXWyCizuoN4aoGNRBoQDXht8HcqGQ,29305
-solana_agent-28.3.0.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-solana_agent-28.3.0.dist-info/entry_points.txt,sha256=-AuT_mfqk8dlZ0pHuAjx1ouAWpTRjpqvEUa6YV3lmc0,53
-solana_agent-28.3.0.dist-info/RECORD,,
+solana_agent-28.3.2.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
+solana_agent-28.3.2.dist-info/METADATA,sha256=QWPRNGmX7hnlD7qYTBE6Nq72_NegfDRCc2yulDDy8Do,32731
+solana_agent-28.3.2.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+solana_agent-28.3.2.dist-info/entry_points.txt,sha256=-AuT_mfqk8dlZ0pHuAjx1ouAWpTRjpqvEUa6YV3lmc0,53
+solana_agent-28.3.2.dist-info/RECORD,,