fix

app.py

@@ -29,7 +29,14 @@ VEGETABLE_DB = ["broccoli", "celery", "lettuce", "sweet potato", "basil", "aspar
 
 @tool
 def serper_search(query: str) -> str:
-    """Search the web using Serper API with result caching"""
+    """Search the web using Serper API with result caching
+    
+    Args:
+        query: The search query string to look up on the web
+    
+    Returns:
+        A formatted string containing search results including knowledge graph and organic results
+    """
     try:
         return _cached_serper_search(query)
     except Exception as e:
@@ -64,7 +71,15 @@ def _cached_serper_search(query: str) -> str:
 
 @tool
 def wikipedia_detailed(query: str, section: str = None) -> str:
-    """Fetch detailed Wikipedia content with section extraction"""
+    """Fetch detailed Wikipedia content with optional section extraction
+    
+    Args:
+        query: The Wikipedia page title or search term to look up
+        section: Optional specific section name to extract from the page
+    
+    Returns:
+        Wikipedia page content, either full summary with sections or specific section content
+    """
     try:
         wiki_wiki = wikipediaapi.Wikipedia('en')
         page = wiki_wiki.page(query)
@@ -87,7 +102,14 @@ def wikipedia_detailed(query: str, section: str = None) -> str:
 
 @tool
 def youtube_transcript(video_id: str) -> str:
-    """Get YouTube video transcript"""
+    """Get YouTube video transcript by video ID
+    
+    Args:
+        video_id: The YouTube video ID (the part after 'v=' in the URL)
+    
+    Returns:
+        The full transcript text of the video as a single string
+    """
     try:
         transcript = YouTubeTranscriptApi.get_transcript(video_id)
         return " ".join([entry['text'] for entry in transcript])
@@ -96,7 +118,14 @@ def youtube_transcript(video_id: str) -> str:
 
 @tool
 def transcribe_audio(audio_url: str) -> str:
-    """Transcribe audio using Whisper"""
+    """Transcribe audio from URL using Whisper speech recognition
+    
+    Args:
+        audio_url: URL pointing to an audio file (mp3, wav, etc.)
+    
+    Returns:
+        The transcribed text content of the audio file
+    """
     try:
         response = requests.get(audio_url, timeout=30)
         audio_data = io.BytesIO(response.content)
@@ -110,7 +139,14 @@ def transcribe_audio(audio_url: str) -> str:
 
 @tool
 def analyze_operation_table(table_md: str) -> str:
-    """Parse markdown tables and check commutativity"""
+    """Parse markdown operation tables and check for commutativity violations
+    
+    Args:
+        table_md: A markdown-formatted table string defining a mathematical operation
+    
+    Returns:
+        Comma-separated list of elements that violate commutativity in the operation
+    """
     try:
         # Parse markdown table
         lines = table_md.strip().split('\n')
@@ -141,7 +177,14 @@ def analyze_operation_table(table_md: str) -> str:
 
 @tool
 def parse_excel(file_url: str) -> str:
-    """Extract and process Excel data"""
+    """Extract and process data from Excel files via URL
+    
+    Args:
+        file_url: URL pointing to an Excel file (.xlsx or .xls)
+    
+    Returns:
+        String representation of the Excel data content
+    """
     try:
         response = requests.get(file_url, timeout=30)
         wb = openpyxl.load_workbook(io.BytesIO(response.content))
@@ -158,7 +201,14 @@ def parse_excel(file_url: str) -> str:
 
 @tool
 def execute_python(code: str) -> str:
-    """Safely execute Python code"""
+    """Safely execute Python code in a restricted environment
+    
+    Args:
+        code: Python code string to execute, should define a 'result' variable
+    
+    Returns:
+        The value of the 'result' variable after code execution, or error message
+    """
     try:
         # Create safe environment
         safe_globals = {'__builtins__': None}
@@ -176,7 +226,14 @@ def execute_python(code: str) -> str:
 
 @tool
 def classify_botanical(items: str) -> str:
-    """Classify items as botanical vegetables"""
+    """Classify food items as botanical vegetables from a predefined database
+    
+    Args:
+        items: Comma-separated string of food items to classify
+    
+    Returns:
+        Comma-separated list of items that are classified as botanical vegetables
+    """
     try:
         vegetable_list = []
         for item in items.split(','):