Update app.py

app.py

@@ -20,8 +20,12 @@ def my_cutom_tool(arg1: str, arg2: int) -> str:
 @tool
 def get_current_time_in_timezone(timezone: str) -> str:
     """A tool that fetches the current local time in a specified timezone.
+    
     Args:
         timezone: A string representing a valid timezone (e.g., 'America/New_York').
+    
+    Returns:
+        A string stating the current local time in the specified timezone.
     """
     try:
         tz = pytz.timezone(timezone)
@@ -84,7 +88,9 @@ def map_mood_to_params(mood: str, weather_condition: str = None) -> dict:
 @tool
 def get_user_location() -> str:
     """Fetches the user's location using ip-api.com.
-    Returns a string with city, country, and timezone.
+    
+    Returns:
+        A string containing the city, country, and timezone, or an error message.
     """
     city, country, timezone = fetch_user_location_data()
     if city and country and timezone:
@@ -94,8 +100,12 @@ def get_user_location() -> str:
 @tool
 def get_weather(city: str) -> str:
     """Fetches weather data for a given city using OpenWeatherMap API.
+    
     Args:
-        city: The city name.
+        city: The name of the city.
+    
+    Returns:
+        A string describing the current weather in the specified city, or an error message.
     """
     weather = fetch_weather_for_city(city)
     if weather:
@@ -106,15 +116,24 @@ def get_weather(city: str) -> str:
 def get_songs_by_mood(mood: str, local: bool = False) -> str:
     """Fetches a playlist of songs that fits the user's mood using Spotify's Recommendations API.
     
-    Mood is expressed in terms of target_valence and target_energy (energy replaces arousal).
-    The tool internally maps mood words (e.g., 'happy', 'sad', 'energetic', 'chill') to target parameters:
-      - "happy": target_valence ~ 0.9, target_energy ~ 0.8, seed_genre "pop"
-      - "sad": target_valence ~ 0.2, target_energy ~ 0.3, seed_genre "acoustic"
-      - "energetic": target_valence ~ 0.7, target_energy ~ 0.9, seed_genre "work-out"
-      - "chill": target_valence ~ 0.6, target_energy ~ 0.4, seed_genre "chill"
+    Args:
+        mood: A string representing the desired mood (e.g., "happy", "sad", "energetic", "chill").
+        local: A boolean flag. If True, the tool fetches the user's location and current weather 
+               to adjust the mood mapping accordingly.
+    
+    Returns:
+        A string containing a playlist of songs (each on a new line) that matches the mood parameters.
     
-    If the optional parameter 'local' is True, the tool also fetches the user's location and current weather,
-    and adjusts the mood mapping accordingly (e.g., reducing energy on rainy days).
+    Additional Details:
+        Mood is expressed in terms of target_valence and target_energy (energy replaces arousal).
+        The tool internally maps mood words to corresponding Spotify parameters. For example:
+          - "happy": target_valence ~ 0.9, target_energy ~ 0.8, seed_genre "pop"
+          - "sad": target_valence ~ 0.2, target_energy ~ 0.3, seed_genre "acoustic"
+          - "energetic": target_valence ~ 0.7, target_energy ~ 0.9, seed_genre "work-out"
+          - "chill": target_valence ~ 0.6, target_energy ~ 0.4, seed_genre "chill"
+          
+        If 'local' is True, the tool uses the user's location and weather to adjust the mapping
+        (e.g., reducing energy on rainy days).
     """
     weather_condition = None
     if local: