solana-agent 28.3.0__tar.gz → 28.3.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. {solana_agent-28.3.0 → solana_agent-28.3.1}/PKG-INFO +18 -1
  2. {solana_agent-28.3.0 → solana_agent-28.3.1}/README.md +17 -0
  3. {solana_agent-28.3.0 → solana_agent-28.3.1}/pyproject.toml +1 -1
  4. {solana_agent-28.3.0 → solana_agent-28.3.1}/LICENSE +0 -0
  5. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/__init__.py +0 -0
  6. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/adapters/__init__.py +0 -0
  7. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/adapters/mongodb_adapter.py +0 -0
  8. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/adapters/openai_adapter.py +0 -0
  9. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/adapters/pinecone_adapter.py +0 -0
  10. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/cli.py +0 -0
  11. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/client/__init__.py +0 -0
  12. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/client/solana_agent.py +0 -0
  13. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/domains/__init__.py +0 -0
  14. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/domains/agent.py +0 -0
  15. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/domains/routing.py +0 -0
  16. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/factories/__init__.py +0 -0
  17. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/factories/agent_factory.py +0 -0
  18. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/guardrails/pii.py +0 -0
  19. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/__init__.py +0 -0
  20. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/client/client.py +0 -0
  21. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/guardrails/guardrails.py +0 -0
  22. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/plugins/plugins.py +0 -0
  23. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/providers/data_storage.py +0 -0
  24. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/providers/llm.py +0 -0
  25. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/providers/memory.py +0 -0
  26. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/providers/vector_storage.py +0 -0
  27. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/services/agent.py +0 -0
  28. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/services/knowledge_base.py +0 -0
  29. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/services/query.py +0 -0
  30. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/interfaces/services/routing.py +0 -0
  31. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/plugins/__init__.py +0 -0
  32. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/plugins/manager.py +0 -0
  33. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/plugins/registry.py +0 -0
  34. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/plugins/tools/__init__.py +0 -0
  35. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/plugins/tools/auto_tool.py +0 -0
  36. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/repositories/__init__.py +0 -0
  37. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/repositories/memory.py +0 -0
  38. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/services/__init__.py +0 -0
  39. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/services/agent.py +0 -0
  40. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/services/knowledge_base.py +0 -0
  41. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/services/query.py +0 -0
  42. {solana_agent-28.3.0 → solana_agent-28.3.1}/solana_agent/services/routing.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: solana-agent
3
- Version: 28.3.0
3
+ Version: 28.3.1
4
4
  Summary: AI Agents for Solana
5
5
  License: MIT
6
6
  Keywords: solana,solana ai,solana agent,ai,ai agent,ai agents
@@ -64,6 +64,7 @@ Build your AI agents in three lines of code!
64
64
  * Business Alignment
65
65
  * Extensible Tooling
66
66
  * Automatic Tool Workflows
67
+ * Autonomous Operation
67
68
  * Knowledge Base
68
69
  * MCP Support
69
70
  * Guardrails
@@ -92,6 +93,7 @@ Build your AI agents in three lines of code!
92
93
  * Integrated Knowledge Base with semantic search and automatic PDF chunking
93
94
  * Input and output guardrails for content filtering, safety, and data sanitization
94
95
  * Automatic sequential tool workflows allowing agents to chain multiple tools
96
+ * Combine with event-driven systems to create autonomous agents
95
97
 
96
98
  ## Stack
97
99
 
@@ -603,6 +605,8 @@ class MyOutputGuardrail(OutputGuardrail):
603
605
 
604
606
  ## Tools
605
607
 
608
+ 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.
609
+
606
610
  Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
607
611
 
608
612
  * 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)
@@ -785,6 +789,19 @@ async for response in solana_agent.process("user123", "What are the latest AI de
785
789
  print(response, end="")
786
790
  ```
787
791
 
792
+ ## Autonomous Operation & Event-Driven Agents
793
+
794
+ 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.
795
+
796
+ **Key Concepts:**
797
+
798
+ * **External Triggers:** Use schedulers like cron, message queues (RabbitMQ, Kafka), monitoring systems, webhooks, or other event sources to initiate agent actions.
799
+ * **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.
800
+ * **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.
801
+ * **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).
802
+
803
+ By combining Solana Agent's agent definitions, tool integration, and routing with external orchestration, you can create sophisticated autonomous systems.
804
+
788
805
  ## Advanced Customization
789
806
 
790
807
  ### Runtime Prompt Injection
@@ -29,6 +29,7 @@ Build your AI agents in three lines of code!
29
29
  * Business Alignment
30
30
  * Extensible Tooling
31
31
  * Automatic Tool Workflows
32
+ * Autonomous Operation
32
33
  * Knowledge Base
33
34
  * MCP Support
34
35
  * Guardrails
@@ -57,6 +58,7 @@ Build your AI agents in three lines of code!
57
58
  * Integrated Knowledge Base with semantic search and automatic PDF chunking
58
59
  * Input and output guardrails for content filtering, safety, and data sanitization
59
60
  * Automatic sequential tool workflows allowing agents to chain multiple tools
61
+ * Combine with event-driven systems to create autonomous agents
60
62
 
61
63
  ## Stack
62
64
 
@@ -568,6 +570,8 @@ class MyOutputGuardrail(OutputGuardrail):
568
570
 
569
571
  ## Tools
570
572
 
573
+ 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.
574
+
571
575
  Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
572
576
 
573
577
  * 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)
@@ -750,6 +754,19 @@ async for response in solana_agent.process("user123", "What are the latest AI de
750
754
  print(response, end="")
751
755
  ```
752
756
 
757
+ ## Autonomous Operation & Event-Driven Agents
758
+
759
+ 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.
760
+
761
+ **Key Concepts:**
762
+
763
+ * **External Triggers:** Use schedulers like cron, message queues (RabbitMQ, Kafka), monitoring systems, webhooks, or other event sources to initiate agent actions.
764
+ * **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.
765
+ * **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.
766
+ * **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).
767
+
768
+ By combining Solana Agent's agent definitions, tool integration, and routing with external orchestration, you can create sophisticated autonomous systems.
769
+
753
770
  ## Advanced Customization
754
771
 
755
772
  ### Runtime Prompt Injection
@@ -1,6 +1,6 @@
1
1
  [tool.poetry]
2
2
  name = "solana-agent"
3
- version = "28.3.0"
3
+ version = "28.3.1"
4
4
  description = "AI Agents for Solana"
5
5
  authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
6
6
  license = "MIT"
File without changes