add tool doc

src/tools/scout_toolkit.py

@@ -83,9 +83,33 @@ class ScoutToolkit(Toolkit):
 
     def search_and_offload(self, task_list_json: str) -> str:
         """
-        Search places and offload to DB.
+    Performs a proximity search for POIs based on the provided tasks and global context, then offloads results to the DB.
+
+    CRITICAL: The input JSON **MUST** include the 'global_info' section containing 'start_location' (lat, lng) to ensure searches are performed nearby the user's starting point, not in a random location.
+
+    Args:
+        task_list_json (str): A JSON formatted string. The structure must be:
+        {
+            "global_info": {
+                "start_location": ...,
+                "departure_time": str,
+                ...
+            },
+            "tasks": [
+                {
+                    "task_id": int,
+                    "location_hint": str,  # e.g. "Post Office", "7-11"
+                    "priority": str,
+                    ...
+                },
+                ...
+            ]
+        }
+        Returns:
+        str: A Ref_id of DB system.
         """
         try:
+            print("task_list_json", task_list_json)
             data = self._robust_parse_json(task_list_json)
             tasks = data.get("tasks", [])
             global_info = data.get("global_info", {})
@@ -108,8 +132,9 @@ class ScoutToolkit(Toolkit):
             return lat, lng
 
         start_loc = global_info.get("start_location")
-        anchor_point = None
+        logger.info(f"🕵️ Scout: Start Location - {start_loc}")
 
+        anchor_point = None
         if isinstance(start_loc, str):
             logger.debug(f"🕵️ Scout: Resolving Start Location Name '{start_loc}'...")
             try: