add last_fm currently listening api

app.py

@@ -4,9 +4,17 @@ import requests
 import pytz
 import yaml
 from tools.final_answer import FinalAnswerTool
+import time
 
 from Gradio_UI import GradioUI
 
+lastfm_api_root = 'http://ws.audioscrobbler.com/2.0/'
+cache = {
+    "current_track": None,
+    "last_fetched": 0,
+    "listening": False
+}
+
 # Below is an example of a tool that does nothing. Amaze us with your creativity !
 @tool
 def my_custom_tool(arg1:str, arg2:int)-> str: #it's import to specify the return type
@@ -33,6 +41,60 @@ def get_current_time_in_timezone(timezone: str) -> str:
     except Exception as e:
         return f"Error fetching time for timezone '{timezone}': {str(e)}"
 
+@tool
+def get_recent_tracks(user: str) -> str:
+    """Retrieves the currently playing or most recently played track for a given user from Last.fm.
+
+    This function uses a cache to store the most recent track information and only fetches
+    new data from the Last.fm API if the cache is empty or older than 60 seconds.
+
+    Args:
+        user (str): The Last.fm username for which to retrieve track information.
+
+    Returns:
+        str: A string describing the user's current or recent listening activity.
+             
+             The format of the returned string is:
+             - "Currently listening: {track_title} by {artist_name}" if currently playing.
+             - "Recently listened: {track_title} by {artist_name}" if recently played.
+             - "No recent track information available for {user}." if no track information is found.
+    
+    Example:
+        >>> get_recent_tracks('rj')
+        'Currently listening: Bohemian Rhapsody by Queen'
+
+    Notes:
+        - Requires the environment variable `LASTFM_API_KEY` to be set with your Last.fm API key.
+        - Uses a cache to avoid unnecessary API calls. The cache is updated every 60 seconds.
+        - If the Last.fm API is unavailable or returns an error, a message indicating no track information is returned.
+    """
+    global cache
+
+    current_time = time.time()
+    # Fetch new data if cache is empty or expired
+    if cache['current_track'] is None or current_time - cache['last_fetched'] > 60:
+        params = {"method": "user.getrecenttracks",
+                "user": USER,
+                "api_key": os.getenv('LASTFM_API_KEY'),
+                "limit": 1,
+                "format": "json"}
+        response = requests.get(lastfm_api_root, params=params)
+        if response.status_code == 200:
+            track = response.json()['recenttracks']['track'][0]
+            artist = track['artist']['#text']
+            title = track['name']
+            if track.get('@attr') and track.get('@attr').get('nowplaying') == 'true':
+                cache['current_track'] = f'{title} by {artist}'
+                cache['last_fetched'] = current_time
+                cache['listening'] = True
+
+    #If the cache current_track is still None it means that the user has no recent tracks 
+    if cache['current_track'] is None:
+        return f"No recent track information available for {user}."
+    
+    return_prompt = f'Currently listening: {cache["current_track"]}' if cache['listening'] else f'Recently listened: {cache["current_track"]}'
+    return return_prompt
+
 
 final_answer = FinalAnswerTool()
 
@@ -55,7 +117,7 @@ with open("prompts.yaml", 'r') as stream:
     
 agent = CodeAgent(
     model=model,
-    tools=[final_answer], ## add your tools here (don't remove final answer)
+    tools=[final_answer, get_current_time_in_timezone, image_generation_tool, get_recent_tracks], ## add your tools here (don't remove final answer)
     max_steps=6,
     verbosity_level=1,
     grammar=None,