Update tools.py

tools.py

@@ -21,9 +21,16 @@ import re
 @tool
 def extract_number_from_text(text: str) -> str:
     """
-    Extract the most relevant number (e.g., counts or totals) from a given text.
-    Use this after a Wikipedia or document summary to pull quantities like album counts, dates, etc.
+    extract_number_from_text(text: str) -> str:
+    Extract the most relevant number (e.g., totals, counts, or dates) from a block of text.
+
+    Args:
+        text: A string containing the text from which to extract a number (e.g., Wikipedia summary or document).
+
+    Returns:
+        A string representing the extracted number or a message if no number is found.
     """
+    
     print(f"🛠️ extract_number_from_text called with: {text[:80]}...")
     try:
         matches = re.findall(r"\b\d+\b", text)
@@ -36,9 +43,16 @@ def extract_number_from_text(text: str) -> str:
 @tool
 def search_wikipedia(query: str) -> str:
     """
-    Search English Wikipedia and return a summary of the most relevant page.
-    Use this for questions about people, dates, history, science, or named concepts.
+    search_wikipedia(query: str) -> str:
+    Search English Wikipedia and return the summary of the most relevant article.
+
+    Args:
+        query: A query string about a person, event, scientific term, or concept.
+
+    Returns:
+        A concise summary of the corresponding Wikipedia page or a disambiguation notice.
     """
+
     print(f"🛠️ search_wikipedia called with: {query}")
     try:
         page = wikipedia.page(query)
@@ -54,8 +68,16 @@ def search_wikipedia(query: str) -> str:
 @tool
 def analyze_youtube_video(url: str) -> str:
     """
-    Analyze a YouTube video using only its title and description via OpenAI/GPT.
+    analyze_youtube_video(url: str) -> str:
+    Analyze a YouTube video based on its title and description metadata.
+
+    Args:
+        url: A full YouTube video URL.
+
+    Returns:
+        An analysis of the video's topic, audience, and themes using its metadata.
     """
+
     # Extract YouTube URL from text if embedded
     match = re.search(r"https?://(?:www\.)?(?:youtube\.com/watch\?v=|youtu\.be/)[\w-]+", url)
     if match:
@@ -125,8 +147,16 @@ def fetch_video_metadata(video_id: str) -> str:
 @tool
 def check_commutativity_table(table_text: str) -> str:
     """
-    Parse a multiplication table from markdown-like text and return the set of elements involved in counter-examples to commutativity.
+    check_commutativity_table(table_text: str) -> str:
+    Check if a binary operation table (in markdown-style) is commutative.
+
+    Args:
+        table_text: A markdown-style multiplication table with headers and rows.
+
+    Returns:
+        A comma-separated list of elements that violate commutativity, or a message if none found.
     """
+
     try:
         lines = [line.strip() for line in table_text.strip().splitlines() if '|' in line]
         header = [e.strip() for e in lines[0].split('|')[1:] if e.strip()]  # skip first column label