new fix for tools

app.py

@@ -55,8 +55,14 @@ def download_file(file_name: str) -> None:
 @tool
 def open_file_as_text(file_name: str, filetype: Optional[str] = "txt") -> str:
     """
-    Opens and reads a file of the given type (txt, json, csv, xlsx, mp3).
-    Returns its content as readable text or transcription for audio files.
+    Opens and reads a file based on its type.
+
+    Args:
+        file_name (str): The name of the file to open (should be available after download).
+        filetype (Optional[str]): The type of file - one of 'txt', 'json', 'csv', 'xlsx', or 'mp3'. Defaults to 'txt'.
+
+    Returns:
+        str: File content as text, or transcription if an audio file.
     """
     download_file(file_name)
     try:
@@ -88,16 +94,17 @@ def open_file_as_text(file_name: str, filetype: Optional[str] = "txt") -> str:
     except Exception as e:
         return f"Error opening file '{file_name}': {str(e)}"
 
+
 @tool
 def web_search(query: str) -> str:
     """
     Performs a web search using DuckDuckGo and returns the top results.
 
     Args:
-        query: Search query string.
+        query (str): Search query string.
 
     Returns:
-        Top search results formatted as title, snippet, and URL.
+        str: Top search results formatted as title, snippet, and URL.
     """
     try:
         with DDGS() as ddgs:
@@ -108,16 +115,17 @@ def web_search(query: str) -> str:
     except Exception as e:
         return f"Error during search: {str(e)}"
 
+
 @tool
 def read_wikipedia_page(url: str) -> str:
     """
     Reads and extracts clean text content from a Wikipedia page.
 
     Args:
-        url: Full URL to the Wikipedia page.
+        url (str): Full URL to the Wikipedia page.
 
     Returns:
-        Sectioned and readable content from the page, including paragraphs, lists, and tables.
+        str: Sectioned and readable content from the page, including paragraphs, lists, and tables.
     """
     headers = {"User-Agent": "Mozilla/5.0"}
     resp = requests.get(url, headers=headers, timeout=10)
@@ -134,17 +142,18 @@ def read_wikipedia_page(url: str) -> str:
             parts.append(parse_wikipedia_table(elem))
     return "\n".join(parts)
 
+
 @tool
 def smart_paginate_around_query(full_text: str, query: str) -> list:
     """
     Splits full text into focused windows surrounding the query keyword.
 
     Args:
-        full_text: The large text content to paginate.
-        query: Keyword or phrase to center each window on.
+        full_text (str): The large text content to paginate.
+        query (str): Keyword or phrase to center each window on.
 
     Returns:
-        List of substrings centered around the query within the original text.
+        list: List of substrings centered around the query within the original text.
     """
     before_chars = 1000
     after_chars = 3000
@@ -162,29 +171,31 @@ def smart_paginate_around_query(full_text: str, query: str) -> list:
         start = e
     return pages
 
+
 @tool
 def reverse_sentence(text: str) -> str:
     """
     Reverses the input text string.
 
     Args:
-        text: A string to reverse.
+        text (str): A string to reverse.
 
     Returns:
-        Reversed string.
+        str: Reversed string.
     """
     return text[::-1]
 
+
 @tool
 def run_python_code(file_name: str) -> str:
     """
     Executes a Python script and returns the output.
 
     Args:
-        file_name: Name of the Python file to execute.
+        file_name (str): Name of the Python file to execute.
 
     Returns:
-        Printed standard output or error message from the script.
+        str: Printed standard output or error message from the script.
     """
     download_file(file_name)
     try: