tools update

app.py

@@ -54,6 +54,10 @@ 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.
+    """
     download_file(file_name)
     try:
         if filetype == "txt":
@@ -86,6 +90,15 @@ def open_file_as_text(file_name: str, filetype: Optional[str] = "txt") -> str:
 
 @tool
 def web_search(query: str) -> str:
+    """
+    Performs a web search using DuckDuckGo and returns the top results.
+
+    Args:
+        query: Search query string.
+
+    Returns:
+        Top search results formatted as title, snippet, and URL.
+    """
     try:
         with DDGS() as ddgs:
             results = ddgs.text(query, max_results=3)
@@ -95,25 +108,17 @@ def web_search(query: str) -> str:
     except Exception as e:
         return f"Error during search: {str(e)}"
 
-def parse_wikipedia_table(table) -> str:
-    rows = []
-    headers = []
-    thead = table.find('thead')
-    if thead:
-        for th in thead.find_all('th'):
-            headers.append(th.get_text(separator=" ", strip=True))
-        if headers:
-            rows.append(" | ".join(headers))
-    tbody = table.find('tbody') or table
-    for tr in tbody.find_all('tr'):
-        cells = tr.find_all(['th', 'td'])
-        cell_texts = [cell.get_text(separator=" ", strip=True) for cell in cells if cell]
-        if cell_texts:
-            rows.append(" | ".join(cell_texts))
-    return "\n".join(rows)
-
 @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.
+
+    Returns:
+        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)
     resp.raise_for_status()
@@ -131,6 +136,16 @@ def read_wikipedia_page(url: str) -> str:
 
 @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.
+
+    Returns:
+        List of substrings centered around the query within the original text.
+    """
     before_chars = 1000
     after_chars = 3000
     q = query.lower()
@@ -149,10 +164,28 @@ def smart_paginate_around_query(full_text: str, query: str) -> list:
 
 @tool
 def reverse_sentence(text: str) -> str:
+    """
+    Reverses the input text string.
+
+    Args:
+        text: A string to reverse.
+
+    Returns:
+        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.
+
+    Returns:
+        Printed standard output or error message from the script.
+    """
     download_file(file_name)
     try:
         result = subprocess.run(["python", file_name], capture_output=True, text=True, timeout=10)