Update app.py

app.py

@@ -11,7 +11,15 @@ import re
 # --- Enhanced Tools ---
 @tool
 def enhanced_search(query: str, num_results: int = 3) -> str:
-    """Improved web search with result filtering"""
+    """Performs web search with result filtering and quality checks.
+    
+    Args:
+        query: The search query string to look up.
+        num_results: Number of results to return (default 3).
+    
+    Returns:
+        A formatted string containing the search results or error message.
+    """
     try:
         with DDGS() as ddgs:
             results = ddgs.text(query, max_results=num_results)
@@ -29,7 +37,14 @@ def enhanced_search(query: str, num_results: int = 3) -> str:
 
 @tool
 def scientific_calculator(expression: str) -> str:
-    """Advanced calculator with math/science functions"""
+    """Evaluates mathematical expressions with scientific functions.
+    
+    Args:
+        expression: The mathematical expression to evaluate.
+    
+    Returns:
+        The result as a string or error message.
+    """
     allowed_names = {k: v for k, v in math.__dict__.items() if not k.startswith("__")}
     try:
         result = eval(expression, {"__builtins__": {}}, allowed_names)
@@ -39,12 +54,25 @@ def scientific_calculator(expression: str) -> str:
 
 @tool
 def get_current_date() -> str:
-    """Returns current date and time"""
+    """Gets the current date and time.
+    
+    Returns:
+        Current datetime in YYYY-MM-DD HH:MM:SS format.
+    """
     return datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
 @tool
 def unit_converter(amount: float, from_unit: str, to_unit: str) -> str:
-    """Converts between common units"""
+    """Converts between common measurement units.
+    
+    Args:
+        amount: The numerical value to convert.
+        from_unit: The source unit (e.g., 'miles').
+        to_unit: The target unit (e.g., 'kilometers').
+    
+    Returns:
+        The converted value with unit or error message.
+    """
     conversions = {
         ('miles', 'kilometers'): lambda x: x * 1.60934,
         ('pounds', 'kilograms'): lambda x: x * 0.453592,
@@ -59,6 +87,7 @@ def unit_converter(amount: float, from_unit: str, to_unit: str) -> str:
             return "Invalid amount"
     return f"Unsupported conversion: {from_unit} → {to_unit}"
 
+
 # --- Agent Core ---
 class GAIAAgent:
     def __init__(self):