solana-agent 27.3.0__tar.gz → 27.3.2__tar.gz

{solana_agent-27.3.0 → solana_agent-27.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 27.3.0
+Version: 27.3.2
 Summary: Agentic IQ
 License: MIT
 Keywords: ai,openai,ai agents,agi
@@ -19,7 +19,7 @@ Requires-Dist: llama-index-core (>=0.12.30,<0.13.0)
 Requires-Dist: llama-index-embeddings-openai (>=0.3.1,<0.4.0)
 Requires-Dist: openai (>=1.74.0,<2.0.0)
 Requires-Dist: pinecone (>=6.0.2,<7.0.0)
-Requires-Dist: pydantic (>=2.11.3,<3.0.0)
+Requires-Dist: pydantic (>=2)
 Requires-Dist: pymongo (>=4.12.0,<5.0.0)
 Requires-Dist: pypdf (>=5.4.0,<6.0.0)
 Requires-Dist: zep-cloud (>=2.10.1,<3.0.0)
@@ -47,6 +47,7 @@ Build your AI business in three lines of code!
 ## Why?
 * Three lines of code setup
 * Fast Responses
+* Solana Integration
 * Multi-Agent Swarm
 * Multi-Modal Streaming (Text & Audio)
 * Conversational Memory & History
@@ -64,6 +65,7 @@ Build your AI business in three lines of code!
 
 * Easy three lines of code setup
 * Fast AI responses
+* Solana Integration via [AgentiPy](https://github.com/niceberginc/agentipy)
 * Designed for a multi-agent swarm 
 * Seamless text and audio streaming with real-time multi-modal processing
 * Configurable audio voice characteristics via prompting
@@ -452,7 +454,7 @@ Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools
 * Solana Agent doesn't use OpenAI function calling (tools) as they don't support async functions
 * Solana Agent tools are async functions
 
-### Internet Search (Plugin Example)
+### Internet Search
 
 `pip install sakit`
 
@@ -482,10 +484,54 @@ config = {
         }
     ],
 }
+```
+
+### Solana Actions
+
+`pip install sakit`
+
+```python
+config = {
+    "tools": {
+        "solana": {
+            # Core Solana Settings
+            "private_key": "YOUR_SOLANA_WALLET_PRIVATE_KEY",       # Required (unless generate_wallet=True): Your wallet's private key (base58 encoded string).
+            "rpc_url": "https://api.mainnet-beta.solana.com",      # Optional: Defaults to Solana mainnet RPC.
+            "generate_wallet": False,                              # Optional: If True, ignores private_key and generates a new wallet. Defaults to False.
+
+            # Optional RPC/Service API Keys & URLs
+            "helius_api_key": "YOUR_HELIUS_API_KEY",               # Optional: Helius API key for enhanced data/RPC.
+            "helius_rpc_url": "YOUR_HELIUS_RPC_URL",               # Optional: Specific Helius RPC URL.
+            "quicknode_rpc_url": "YOUR_QUICKNODE_RPC_URL",         # Optional: QuickNode RPC URL.
+            "jito_block_engine_url": "YOUR_JITO_BLOCK_ENGINE_URL", # Optional: Jito block engine URL for bundles.
+            "jito_uuid": "YOUR_JITO_UUID",                         # Optional: Jito authentication UUID.
+
+            # Optional Integration API Keys
+            "openai_api_key": "YOUR_OPENAI_API_KEY",               # Optional: OpenAI API key (if needed by specific agentipy features).
+            "backpack_api_key": "YOUR_BACKPACK_API_KEY",           # Optional: Backpack Exchange API key.
+            "backpack_api_secret": "YOUR_BACKPACK_API_SECRET",     # Optional: Backpack Exchange API secret.
+            "stork_api_key": "YOUR_STORK_API_KEY",                 # Optional: Stork oracle API key.
+            "coingecko_api_key": "YOUR_COINGECKO_PRO_API_KEY",     # Optional: CoinGecko Pro API key.
+            "coingecko_demo_api_key": "YOUR_COINGECKO_DEMO_KEY",   # Optional: CoinGecko Demo API key.
+            "elfa_ai_api_key": "YOUR_ELFA_AI_API_KEY",             # Optional: Elfa AI API key.
+            "flexland_api_key": "YOUR_FLEXLAND_API_KEY",           # Optional: Flexlend API key.
+            "allora_api_key": "YOUR_ALLORA_API_KEY",               # Optional: Allora Network API key.
+            "solutiofi_api_key": "YOUR_SOLUTIOFI_API_KEY"          # Optional: Solutio Finance API key.
+        },
+    },
+    "ai_agents": [
+        {
+            "name": "solana_expert",
+            "instructions": "You are an expert Solana blockchain assistant. You always use the Solana tool to perform actions on the Solana blockchain.",
+            "specialization": "Solana blockchain interaction",
+            "tools": ["solana"],  # Enable the tool for this agent
+        }
+    ]
+}
 
 solana_agent = SolanaAgent(config=config)
 
-async for response in solana_agent.process("user123", "What are the latest AI developments?"):
+async for response in solana_agent.process("user123", "What is my SOL balance?"):
     print(response, end="")
 ```
 

{solana_agent-27.3.0 → solana_agent-27.3.2}/README.md

@@ -18,6 +18,7 @@ Build your AI business in three lines of code!
 ## Why?
 * Three lines of code setup
 * Fast Responses
+* Solana Integration
 * Multi-Agent Swarm
 * Multi-Modal Streaming (Text & Audio)
 * Conversational Memory & History
@@ -35,6 +36,7 @@ Build your AI business in three lines of code!
 
 * Easy three lines of code setup
 * Fast AI responses
+* Solana Integration via [AgentiPy](https://github.com/niceberginc/agentipy)
 * Designed for a multi-agent swarm 
 * Seamless text and audio streaming with real-time multi-modal processing
 * Configurable audio voice characteristics via prompting
@@ -423,7 +425,7 @@ Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools
 * Solana Agent doesn't use OpenAI function calling (tools) as they don't support async functions
 * Solana Agent tools are async functions
 
-### Internet Search (Plugin Example)
+### Internet Search
 
 `pip install sakit`
 
@@ -453,10 +455,54 @@ config = {
         }
     ],
 }
+```
+
+### Solana Actions
+
+`pip install sakit`
+
+```python
+config = {
+    "tools": {
+        "solana": {
+            # Core Solana Settings
+            "private_key": "YOUR_SOLANA_WALLET_PRIVATE_KEY",       # Required (unless generate_wallet=True): Your wallet's private key (base58 encoded string).
+            "rpc_url": "https://api.mainnet-beta.solana.com",      # Optional: Defaults to Solana mainnet RPC.
+            "generate_wallet": False,                              # Optional: If True, ignores private_key and generates a new wallet. Defaults to False.
+
+            # Optional RPC/Service API Keys & URLs
+            "helius_api_key": "YOUR_HELIUS_API_KEY",               # Optional: Helius API key for enhanced data/RPC.
+            "helius_rpc_url": "YOUR_HELIUS_RPC_URL",               # Optional: Specific Helius RPC URL.
+            "quicknode_rpc_url": "YOUR_QUICKNODE_RPC_URL",         # Optional: QuickNode RPC URL.
+            "jito_block_engine_url": "YOUR_JITO_BLOCK_ENGINE_URL", # Optional: Jito block engine URL for bundles.
+            "jito_uuid": "YOUR_JITO_UUID",                         # Optional: Jito authentication UUID.
+
+            # Optional Integration API Keys
+            "openai_api_key": "YOUR_OPENAI_API_KEY",               # Optional: OpenAI API key (if needed by specific agentipy features).
+            "backpack_api_key": "YOUR_BACKPACK_API_KEY",           # Optional: Backpack Exchange API key.
+            "backpack_api_secret": "YOUR_BACKPACK_API_SECRET",     # Optional: Backpack Exchange API secret.
+            "stork_api_key": "YOUR_STORK_API_KEY",                 # Optional: Stork oracle API key.
+            "coingecko_api_key": "YOUR_COINGECKO_PRO_API_KEY",     # Optional: CoinGecko Pro API key.
+            "coingecko_demo_api_key": "YOUR_COINGECKO_DEMO_KEY",   # Optional: CoinGecko Demo API key.
+            "elfa_ai_api_key": "YOUR_ELFA_AI_API_KEY",             # Optional: Elfa AI API key.
+            "flexland_api_key": "YOUR_FLEXLAND_API_KEY",           # Optional: Flexlend API key.
+            "allora_api_key": "YOUR_ALLORA_API_KEY",               # Optional: Allora Network API key.
+            "solutiofi_api_key": "YOUR_SOLUTIOFI_API_KEY"          # Optional: Solutio Finance API key.
+        },
+    },
+    "ai_agents": [
+        {
+            "name": "solana_expert",
+            "instructions": "You are an expert Solana blockchain assistant. You always use the Solana tool to perform actions on the Solana blockchain.",
+            "specialization": "Solana blockchain interaction",
+            "tools": ["solana"],  # Enable the tool for this agent
+        }
+    ]
+}
 
 solana_agent = SolanaAgent(config=config)
 
-async for response in solana_agent.process("user123", "What are the latest AI developments?"):
+async for response in solana_agent.process("user123", "What is my SOL balance?"):
     print(response, end="")
 ```
 

{solana_agent-27.3.0 → solana_agent-27.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "27.3.0"
+version = "27.3.2"
 description = "Agentic IQ"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"
@@ -24,7 +24,7 @@ python_paths = [".", "tests"]
 [tool.poetry.dependencies]
 python = ">=3.12,<4.0"
 openai = "^1.74.0"
-pydantic = "^2.11.3"
+pydantic = ">=2"
 pymongo = "^4.12.0"
 zep-cloud = "^2.10.1"
 instructor = "^1.7.9"

{solana_agent-27.3.0 → solana_agent-27.3.2}/solana_agent/services/agent.py

@@ -194,25 +194,41 @@ class AgentService(AgentServiceInterface):
             return
 
         try:
-            # Get system prompt
-            system_prompt = self.get_agent_system_prompt(agent_name)
+            # --- 1. Get Base System Prompt ---
+            system_prompt_parts = [self.get_agent_system_prompt(agent_name)]
 
-            # Add User ID and memory context
-            system_prompt += f"\n\nUser ID: {user_id}"
-            if memory_context:
-                system_prompt += f"\n\nMEMORY CONTEXT: {memory_context}"
-            if prompt:
-                system_prompt += f"\n\nADDITIONAL PROMPT: {prompt}"
-
-            # Add tool usage prompt if tools are available
-            tool_calling_system_prompt = deepcopy(system_prompt)
+            # --- 2. Add Tool Usage Instructions EARLY ---
+            tool_usage_prompt_text = ""
             if self.tool_registry:
-                tool_usage_prompt = self._get_tool_usage_prompt(agent_name)
-                if tool_usage_prompt:
-                    tool_calling_system_prompt += f"\n\nTOOL CALLING PROMPT: {tool_usage_prompt}"
+                tool_usage_prompt_text = self._get_tool_usage_prompt(
+                    agent_name)
+                if tool_usage_prompt_text:
+                    system_prompt_parts.append(
+                        f"\n\n--- TOOL USAGE INSTRUCTIONS ---{tool_usage_prompt_text}")
                     print(
                         f"Tools available to agent {agent_name}: {[t.get('name') for t in self.get_agent_tools(agent_name)]}")
 
+            # --- 3. Add User ID ---
+            system_prompt_parts.append(f"\n\n--- USER & SESSION INFO ---")
+            system_prompt_parts.append(f"User ID: {user_id}")
+
+            # --- 4. Add Memory Context ---
+            if memory_context:
+                # Make the header clearly separate it
+                system_prompt_parts.append(
+                    f"\n\n--- CONVERSATION HISTORY (Memory Context) ---")
+                system_prompt_parts.append(memory_context)
+
+            # --- 5. Add Additional Prompt (if provided) ---
+            if prompt:
+                # Make the header clearly separate it
+                system_prompt_parts.append(
+                    f"\n\n--- ADDITIONAL INSTRUCTIONS FOR THIS TURN ---")
+                system_prompt_parts.append(prompt)
+
+            # --- Assemble the final system prompt ---
+            final_system_prompt = "\n".join(system_prompt_parts)
+
             # Variables for tracking the complete response
             complete_text_response = ""
             full_response_buffer = ""
@@ -232,7 +248,7 @@ class AgentService(AgentServiceInterface):
                 f"Generating response with {len(query)} characters of query text")
             async for chunk in self.llm_provider.generate_text(
                 prompt=query,
-                system_prompt=tool_calling_system_prompt,
+                system_prompt=final_system_prompt,
                 api_key=self.api_key,
                 base_url=self.base_url,
                 model=self.model,
@@ -285,10 +301,36 @@ class AgentService(AgentServiceInterface):
                             f"Tool execution complete, result size: {len(response_text)}")
 
                         # Create new prompt with search/tool results
-                        # Using "Search Result" instead of "TOOL RESPONSE" to avoid model repeating "TOOL"
-                        user_prompt = f"{query}\n\nSearch Result: {response_text}"
-                        tool_system_prompt = system_prompt + \
-                            "\n DO NOT use the tool calling format again."
+                        # Ensure query is string
+                        user_prompt = f"{str(query)}\n\nTOOL RESULT: {response_text}"
+
+                        # --- REBUILD the system prompt for the follow-up call ---
+                        # Start with base prompt again
+                        follow_up_system_prompt_parts = [
+                            self.get_agent_system_prompt(agent_name)]
+                        # Add the instruction NOT to use tools again
+                        follow_up_system_prompt_parts.append(
+                            "\n\nCRITICAL: You have received the results from a tool. Base your response on the 'Search Result' provided in the user prompt. DO NOT use the tool calling format again for this turn.")
+                        follow_up_system_prompt_parts.append(
+                            f"\n\n--- USER & SESSION INFO ---")
+                        follow_up_system_prompt_parts.append(
+                            f"User ID: {user_id}")
+                        if memory_context:
+                            # Make the header clearly separate it
+                            follow_up_system_prompt_parts.append(
+                                f"\n\n--- CONVERSATION HISTORY (Memory Context) ---")
+                            follow_up_system_prompt_parts.append(
+                                memory_context)
+                        if prompt:
+                            # Make the header clearly separate it
+                            follow_up_system_prompt_parts.append(
+                                f"\n\n--- ADDITIONAL INSTRUCTIONS FOR THIS TURN ---")
+                            follow_up_system_prompt_parts.append(prompt)
+
+                        # --- Assemble the final follow_up prompt ---
+                        final_follow_up_system_prompt = "\n".join(
+                            follow_up_system_prompt_parts)
+                        # --- End Rebuild ---"
 
                         # Generate a new response with the tool results
                         print("Generating new response with tool results")
@@ -296,7 +338,7 @@ class AgentService(AgentServiceInterface):
                             # Stream the follow-up response for text output
                             async for processed_chunk in self.llm_provider.generate_text(
                                 prompt=user_prompt,
-                                system_prompt=tool_system_prompt,
+                                system_prompt=final_follow_up_system_prompt,
                                 api_key=self.api_key,
                                 base_url=self.base_url,
                                 model=self.model,
@@ -308,7 +350,7 @@ class AgentService(AgentServiceInterface):
                             tool_response = ""
                             async for processed_chunk in self.llm_provider.generate_text(
                                 prompt=user_prompt,
-                                system_prompt=tool_system_prompt,
+                                system_prompt=final_follow_up_system_prompt,
                             ):
                                 tool_response += processed_chunk
 
@@ -489,18 +531,18 @@ class AgentService(AgentServiceInterface):
         return f"""
         AVAILABLE TOOLS:
         {tools_json}
-        
+
         ⚠️ CRITICAL INSTRUCTION: When using a tool, NEVER include explanatory text.
         Only output the exact tool call format shown below with NO other text.
-        
+        Always call the necessary tool to give the latest information.
+
         TOOL USAGE FORMAT:
         [TOOL]
         name: tool_name
         parameters: key1=value1, key2=value2
         [/TOOL]
-        
+
         EXAMPLES:
-        
         ✅ CORRECT - ONLY the tool call with NOTHING else:
         [TOOL]
         name: search_internet
@@ -513,11 +555,12 @@ class AgentService(AgentServiceInterface):
         name: search_internet
         parameters: query=latest news on Solana
         [/TOOL]
-        
+
         REMEMBER:
         1. Output ONLY the exact tool call format with NO additional text
-        2. After seeing your tool call, I will execute it automatically
-        3. You will receive the tool results and can then respond to the user
+        2. If the query is time-sensitive (latest news, current status, etc.), ALWAYS use the tool.
+        3. After seeing your tool call, I will execute it automatically
+        4. You will receive the tool results and can then respond to the user
         """
 
     def _clean_for_audio(self, text: str) -> str:

{solana_agent-27.3.0 → solana_agent-27.3.2}/solana_agent/services/query.py

@@ -129,13 +129,19 @@ class QueryService(QueryServiceInterface):
             else:
                 agent_name = await self.routing_service.route_query(user_text)
 
-           # Combine context from memory and knowledge base
+            # Combine context from memory and knowledge base
             combined_context = ""
             if memory_context:
-                combined_context += f"CONVERSATION HISTORY:\n{memory_context}\n\n"
+                # Add a note about memory priority
+                combined_context += f"CONVERSATION HISTORY (Use for context, but prioritize tools/KB for facts):\n{memory_context}\n\n"
             if kb_context:
+                # Keep KB context strong
                 combined_context += f"{kb_context}\n"
 
+            # Add an overall instruction about prioritization if both are present
+            if memory_context or kb_context:
+                combined_context += "CRITICAL PRIORITIZATION GUIDE: For factual or current information, prioritize Knowledge Base results and Tool results (if applicable) over Conversation History.\n\n"
+
             print(f"Routed to agent: {agent_name}")
 
             # Generate response