Update tools.py

tools.py

@@ -38,6 +38,23 @@ WIKIPEDIA_PAGES = {
 
 @tool
 def extract_number_from_snippets(snippets: list[str]) -> Optional[int]:
+    """
+    Extracts the first integer number found in a list of text snippets.
+
+    This function scans each snippet in order and looks for the first standalone 
+    integer (1 to 4 digits). It returns the first match as an integer. If no 
+    match is found across all snippets, the function returns None.
+
+    Args:
+        snippets (list[str]): A list of strings, typically search result snippets.
+
+    Returns:
+        Optional[int]: The first integer found in the snippets, or None if none found.
+
+    Example:
+        >>> extract_number_from_snippets(["The Eiffel Tower was built in 1889.", "Height is 324m"])
+        1889
+    """
     for s in snippets:
         match = re.search(r"\b\d{1,4}\b", s)
         if match: