Release v3.11.14

Author: MervinPraison

docker/Dockerfile.chat

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.11.13" \
+    "praisonai>=3.11.14" \
     "praisonai[chat]" \
     "embedchain[github,youtube]"
 

docker/Dockerfile.dev

@@ -20,7 +20,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.11.13" \
+    "praisonai>=3.11.14" \
     "praisonai[ui]" \
     "praisonai[chat]" \
     "praisonai[realtime]" \

docker/Dockerfile.ui

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.11.13" \
+    "praisonai>=3.11.14" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

src/praisonai-agents/AGENTS.md

@@ -372,6 +372,9 @@ class MyTool(BaseTool):
 - `praisonaiagents/tools/decorator.py` - @tool decorator
 - `praisonaiagents/tools/registry.py` - Tool registry
 
+> [!IMPORTANT]
+> **Agents only recognize parameters.** When creating tools, always expose all options as function parameters—agents cannot discover env vars or config files.
+
 ### 6.2 Hooks & Middleware
 
 ```python

src/praisonai-agents/praisonaiagents/llm/llm.py

@@ -799,15 +799,26 @@ def _generate_ollama_tool_summary(self, tool_results: List[Any], response_text:
         # For Ollama, always generate summary when we have tool results
         # This prevents infinite loops caused by empty/minimal responses
 
-        # Filter out error results first
+        # Filter out error results and collect error messages
         valid_results = []
+        error_messages = []
         for result in tool_results:
-            # Skip error responses
+            # Check for error responses
             if isinstance(result, dict) and 'error' in result:
+                error_messages.append(result.get('error', 'Unknown error'))
                 continue
+            if isinstance(result, list) and len(result) > 0:
+                first_item = result[0]
+                if isinstance(first_item, dict) and 'error' in first_item:
+                    error_messages.append(first_item.get('error', 'Unknown error'))
+                    continue
             valid_results.append(result)
 
-        # If no valid results, return None to continue
+        # If no valid results but we have errors, return a friendly error message
+        if not valid_results and error_messages:
+            return "I'm sorry, but I wasn't able to complete the search. The service encountered some issues. Please try again later or try a different search query."
+        
+        # If no valid results at all, return None to let the loop continue
         if not valid_results:
             return None
 
@@ -845,16 +856,43 @@ def _format_ollama_tool_result_message(self, function_name: str, tool_result: An
         """
         Format tool result message for Ollama provider.
         Enhanced to instruct model to use the result for final answer.
+        Handles error results with specific instructions to provide user-friendly responses.
         """
-        tool_result_str = str(tool_result)
-        return {
-            "role": "user",
-            "content": f"""Tool execution complete.
+        # Check if the result is an error
+        is_error = False
+        error_message = None
+        
+        if isinstance(tool_result, dict) and 'error' in tool_result:
+            is_error = True
+            error_message = tool_result.get('error', 'Unknown error')
+        elif isinstance(tool_result, list) and len(tool_result) > 0:
+            first_item = tool_result[0]
+            if isinstance(first_item, dict) and 'error' in first_item:
+                is_error = True
+                error_message = first_item.get('error', 'Unknown error')
+        
+        if is_error:
+            # For errors, provide clear instructions to give a helpful response
+            return {
+                "role": "user",
+                "content": f"""The tool "{function_name}" encountered an error:
+{error_message}
+
+Please provide a helpful response to the user explaining that the operation could not be completed. 
+Be apologetic and suggest alternatives if possible. Do NOT repeat the raw error message.
+Give a natural, conversational response."""
+            }
+        else:
+            # For successful results, format normally
+            tool_result_str = str(tool_result)
+            return {
+                "role": "user",
+                "content": f"""Tool execution complete.
 Function: {function_name}
 Result: {tool_result_str}
 
-Now provide your final answer using this result."""
-        }
+Now provide your final answer using this result. Summarize the information naturally for the user."""
+            }
 
     def _get_tool_names_for_prompt(self, formatted_tools: Optional[List]) -> str:
         """Extract tool names from formatted tools for prompts."""
@@ -2254,10 +2292,19 @@ def get_response(
                                 messages.append(self._format_ollama_tool_result_message(function_name, tool_result))
                             else:
                                 # For other providers, use tool role with tool_call_id
+                                # Format error results more clearly
+                                if tool_result is None:
+                                    content = "Function returned an empty output"
+                                elif isinstance(tool_result, dict) and 'error' in tool_result:
+                                    content = f"Error: {tool_result.get('error', 'Unknown error')}. Please inform the user that the operation could not be completed."
+                                elif isinstance(tool_result, list) and len(tool_result) > 0 and isinstance(tool_result[0], dict) and 'error' in tool_result[0]:
+                                    content = f"Error: {tool_result[0].get('error', 'Unknown error')}. Please inform the user that the operation could not be completed."
+                                else:
+                                    content = json.dumps(tool_result)
                                 messages.append({
                                     "role": "tool",
                                     "tool_call_id": tool_call_id,
-                                    "content": json.dumps(tool_result) if tool_result is not None else "Function returned an empty output"
+                                    "content": content
                                 })
 
                             # Check if we should continue (for tools like sequential thinking)
@@ -3281,10 +3328,19 @@ async def get_response_async(
                             messages.append(self._format_ollama_tool_result_message(function_name, tool_result))
                         else:
                             # For other providers, use tool role with tool_call_id
+                            # Format error results more clearly
+                            if tool_result is None:
+                                content = "Function returned an empty output"
+                            elif isinstance(tool_result, dict) and 'error' in tool_result:
+                                content = f"Error: {tool_result.get('error', 'Unknown error')}. Please inform the user that the operation could not be completed."
+                            elif isinstance(tool_result, list) and len(tool_result) > 0 and isinstance(tool_result[0], dict) and 'error' in tool_result[0]:
+                                content = f"Error: {tool_result[0].get('error', 'Unknown error')}. Please inform the user that the operation could not be completed."
+                            else:
+                                content = json.dumps(tool_result)
                             messages.append({
                                 "role": "tool",
                                 "tool_call_id": tool_call_id,
-                                "content": json.dumps(tool_result) if tool_result is not None else "Function returned an empty output"
+                                "content": content
                             })
 
                     # For Ollama, add explicit prompt if we need a final answer