solana-agent 27.3.1__tar.gz → 27.3.3__tar.gz

{solana_agent-27.3.1 → solana_agent-27.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 27.3.1
+Version: 27.3.3
 Summary: Agentic IQ
 License: MIT
 Keywords: ai,openai,ai agents,agi
@@ -47,7 +47,7 @@ Build your AI business in three lines of code!
 ## Why?
 * Three lines of code setup
 * Fast Responses
-* Solana Integration
+* Solana Ecosystem Integration
 * Multi-Agent Swarm
 * Multi-Modal Streaming (Text & Audio)
 * Conversational Memory & History
@@ -65,7 +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)
+* Solana Ecosystem 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
@@ -454,88 +454,63 @@ 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
+### Solana
 
 `pip install sakit`
 
 ```python
-from solana_agent import SolanaAgent
-
 config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
     "tools": {
-        "search_internet": {
-            "api_key": "your-openai-api-key",
+        "solana": {
+            "private_key": "your-solana-wallet-private-key", # base58 encoded string
+            "rpc_url": "your-solana-rpc-url",
         },
     },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly. You use your search_internet tool to get the latest information.",
-            "specialization": "Research and knowledge synthesis",
-            "tools": ["search_internet"],
-        },
+    "ai_agents": [
         {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
+            "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 is my SOL balance?"):
+    print(response, end="")
 ```
 
-### Solana Actions
+### Internet Search
 
 `pip install sakit`
 
 ```python
+from solana_agent import SolanaAgent
+
 config = {
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
     "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.
+        "search_internet": {
+            "api_key": "your-openai-api-key",
         },
     },
-    "ai_agents": [
+    "agents": [
         {
-            "name": "solana_expert",
-            "instructions": """
-                You are an expert Solana blockchain assistant. 
-                Use the solana tool to perform any action on the Solana blockchain.
-                Always perform the solana tool actions when requested and not use your memory.
-            """,
-            "specialization": "Solana blockchain interaction",
-            "tools": ["solana"],  # Enable the tool for this agent
+            "name": "news_specialist",
+            "instructions": "You are an expert news agent. You use your search_internet tool to get the latest information.",
+            "specialization": "News researcher and specialist",
+            "tools": ["search_internet"], # Enable the tool for this agent
         }
-    ]
+    ],
 }
 
 solana_agent = SolanaAgent(config=config)
 
-async for response in solana_agent.process("user123", "What is my SOL balance?"):
+async for response in solana_agent.process("user123", "What is the latest news on Elon Musk?"):
     print(response, end="")
 ```
 

{solana_agent-27.3.1 → solana_agent-27.3.3}/README.md

@@ -18,7 +18,7 @@ Build your AI business in three lines of code!
 ## Why?
 * Three lines of code setup
 * Fast Responses
-* Solana Integration
+* Solana Ecosystem Integration
 * Multi-Agent Swarm
 * Multi-Modal Streaming (Text & Audio)
 * Conversational Memory & History
@@ -36,7 +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)
+* Solana Ecosystem 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
@@ -425,88 +425,63 @@ 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
+### Solana
 
 `pip install sakit`
 
 ```python
-from solana_agent import SolanaAgent
-
 config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
     "tools": {
-        "search_internet": {
-            "api_key": "your-openai-api-key",
+        "solana": {
+            "private_key": "your-solana-wallet-private-key", # base58 encoded string
+            "rpc_url": "your-solana-rpc-url",
         },
     },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly. You use your search_internet tool to get the latest information.",
-            "specialization": "Research and knowledge synthesis",
-            "tools": ["search_internet"],
-        },
+    "ai_agents": [
         {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
+            "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 is my SOL balance?"):
+    print(response, end="")
 ```
 
-### Solana Actions
+### Internet Search
 
 `pip install sakit`
 
 ```python
+from solana_agent import SolanaAgent
+
 config = {
+    "openai": {
+        "api_key": "your-openai-api-key",
+    },
     "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.
+        "search_internet": {
+            "api_key": "your-openai-api-key",
         },
     },
-    "ai_agents": [
+    "agents": [
         {
-            "name": "solana_expert",
-            "instructions": """
-                You are an expert Solana blockchain assistant. 
-                Use the solana tool to perform any action on the Solana blockchain.
-                Always perform the solana tool actions when requested and not use your memory.
-            """,
-            "specialization": "Solana blockchain interaction",
-            "tools": ["solana"],  # Enable the tool for this agent
+            "name": "news_specialist",
+            "instructions": "You are an expert news agent. You use your search_internet tool to get the latest information.",
+            "specialization": "News researcher and specialist",
+            "tools": ["search_internet"], # Enable the tool for this agent
         }
-    ]
+    ],
 }
 
 solana_agent = SolanaAgent(config=config)
 
-async for response in solana_agent.process("user123", "What is my SOL balance?"):
+async for response in solana_agent.process("user123", "What is the latest news on Elon Musk?"):
     print(response, end="")
 ```
 

{solana_agent-27.3.1 → solana_agent-27.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "27.3.1"
+version = "27.3.3"
 description = "Agentic IQ"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"

{solana_agent-27.3.1 → solana_agent-27.3.3}/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.1 → solana_agent-27.3.3}/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