fix

app.py

@@ -34,24 +34,74 @@ def serper_search(query: str) -> str:
         return "Serper key missing, please set SERPER_API_KEY."
 
 # --- Other Tools (unchanged) ---
+@tool
+def serper_search(query: str) -> str:
+    """
+    Search the web using the Serper API to find current factual information.
+
+    Args:
+        query (str): The search query string.
+
+    Returns:
+        str: A formatted string of top search results, or an error message.
+    """
+    api_key = os.getenv("SERPER_API_KEY")
+    if api_key:
+        try:
+            url = "https://google.serper.dev/search"
+            payload = {"q": query, "num": 10}
+            headers = {'X-API-KEY': api_key}
+            r = requests.post(url, headers=headers, json=payload, timeout=15)
+            r.raise_for_status()
+            data = r.json()
+            snippets = []
+            if kg := data.get("knowledgeGraph"):
+                snippets.append(f"{kg.get('title')}: {kg.get('description')}")
+            for item in data.get("organic", [])[:5]:
+                snippets.append(f"{item.get('title')}\n{item.get('snippet')}\n{item.get('link')}")
+            return "\n\n".join(snippets) if snippets else "No results."
+        except Exception as e:
+            return f"Serper error: {e}"
+    else:
+        return "Serper key missing, please set SERPER_API_KEY."
+
+
 @tool
 def wikipedia_search(query: str) -> str:
-    """Search Wikipedia for a summary or search results."""
+    """
+    Search Wikipedia for a summary or basic search results.
+
+    Args:
+        query (str): The search term to look up on Wikipedia.
+
+    Returns:
+        str: A summary of the topic or a list of search result snippets.
+    """
     try:
         url = "https://en.wikipedia.org/api/rest_v1/page/summary/" + query.replace(" ", "_")
         r = requests.get(url, timeout=10)
         if r.status_code == 200:
             d = r.json()
             return f"{d.get('title')}\n{d.get('extract')}\n{d['content_urls']['desktop']['page']}"
-        # fallback
         params = {"action": "query", "format": "json", "list": "search", "srsearch": query, "srlimit": 3}
         r = requests.get("https://en.wikipedia.org/w/api.php", params=params, timeout=10)
         return "\n\n".join(f"{i['title']}: {i['snippet']}" for i in r.json().get("query", {}).get("search", []))
     except Exception as e:
         return f"Wikipedia error: {e}"
 
+
 @tool
 def text_processor(text: str, operation: str = "analyze") -> str:
+    """
+    Perform a text operation like reversing or analyzing a string.
+
+    Args:
+        text (str): The input string to process.
+        operation (str): The operation to perform. Options: 'reverse', 'parse', 'analyze'.
+
+    Returns:
+        str: The result of the text processing.
+    """
     if operation == "reverse":
         return text[::-1]
     if operation == "parse":
@@ -59,14 +109,35 @@ def text_processor(text: str, operation: str = "analyze") -> str:
         return f"Words: {len(words)}; First: {words[0] if words else ''}; Last: {words[-1] if words else ''}"
     return f"Length: {len(text)}, words: {len(text.split())}"
 
+
 @tool
 def math_solver(problem: str) -> str:
+    """
+    Solve or explain a math-related problem in natural language.
+
+    Args:
+        problem (str): A math question or prompt.
+
+    Returns:
+        str: An explanation or analysis related to the math topic.
+    """
     if "commutative" in problem.lower():
         return "Check examples a*b vs b*a; look for counterexamples."
     return f"Need math analysis: {problem[:100]}..."
 
+
 @tool
 def data_extractor(source: str, target: str) -> str:
+    """
+    Extract data elements from a text source based on the target keyword.
+
+    Args:
+        source (str): The raw input text to extract data from.
+        target (str): The type of data to extract (e.g., 'botanical vegetables').
+
+    Returns:
+        str: A filtered list or extracted segment from the input.
+    """
     if "botanical" in target.lower() and "vegetable" in source:
         items = [i.strip() for i in source.split(",")]
         true_veg = sorted(i for i in items if i.lower() in ["broccoli", "celery", "lettuce", "basil", "sweet potato"])