Add support for creating playlists with song lists in player agent

[steveluc]

Summary

This PR adds support for creating playlists with lists of songs specified by title and artist, eliminating the need to first search for tracks and build a track list before creating or adding to playlists.

Changes

Schema Enhancements (playerSchema.ts)

1. Added SongSpecification interface

   • Allows specifying songs by trackName, optional artist, and optional albumName

2. Extended CreatePlaylistAction

   • Added optional songs?: SongSpecification[] parameter
   • Now supports creating a playlist with songs in one action
   • Maintains backward compatibility (songs parameter is optional)

3. Added AddSongsToPlaylistAction

   • New action for bulk adding songs to existing playlists
   • Takes playlist name and array of song specifications

Implementation (client.ts)

1. Added searchSongsAndGetUris helper function

   • Searches Spotify for each song specification
   • Builds optimal search queries using track name, artist, and album
   • Returns URIs for found songs and list of songs not found

2. Enhanced createPlaylist handler

   • Searches for songs if provided in parameters
   • Creates playlist with all found songs
   • Reports songs that couldn't be found

3. Implemented addSongsToPlaylist handler

   • Finds playlist by name
   • Searches for specified songs
   • Adds found tracks to playlist
   • Reports success with count and any songs not found

Validation Support (playerHandlers.ts)

• Added addSongsToPlaylist to playlist name validation autocomplete

Example Usage

Users can now make requests like:

• "Create a playlist called 'My Favorites' with these songs: Blinding Lights by The Weeknd, Shape of You by Ed Sheeran"
• "Add the top 10 current Spotify streaming songs to a new playlist called 'Top Hits'"
• "Add these songs to my 'Workout' playlist: Lose Yourself by Eminem, Till I Collapse by Eminem"

Testing

Successfully tested by creating a "Top Hits" playlist with 10 songs in a single request. The agent correctly:

• Parsed the natural language request
• Extracted all song titles and artists into SongSpecification objects
• Searched Spotify for each song
• Created the playlist with all 10 tracks
• Reported success

See test results in MCP server log showing the parsed action with all song specifications.

Benefits

✅ Create playlists with songs in one request
✅ Add multiple songs to playlists without building track lists first
✅ Flexible search with track name, artist, and album support
✅ Clear error reporting for songs not found
✅ Backward compatible - existing functionality unchanged
✅ Uses Spotify batch API for efficient operations