roon-mcp 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to this project will be documented in this file.
 
 The version history source of truth is git tags in the format `vMAJOR.MINOR.PATCH`.
 
+## [0.2.0] - 2026-06-21
+
+### Added
+
+- `now_playing`, `control_playback`, `set_volume`, and `mute` tools to expose
+  Roon's transport controls and current-track state. Previously the server
+  could only start playback, not steer it.
+- `search_music({ type: "artist", includeStreaming: true })` now appends a
+  streaming track mix by the requested artist (via a track search filtered
+  to that artist's subtitle), so requests like "queue multiple *Artist*
+  songs" work even when the artist is missing from the local library or
+  has zero library albums. The streaming path mirrors the existing
+  genre `includeStreaming` flow: library candidates first, then
+  ready-to-play streaming tracks appended with `sourceGroup: "Streaming"`.
+- `search_music({ type: "artist" })` now reports an artist with no library
+  content (e.g. `subtitle: "0 Albums"`) via the result's `message` field,
+  so the agent can opt in to the streaming fallback up front instead of
+  discovering the dead end at `get_tracks_for` time.
+
 ## [0.1.0] - 2026-06-21
 
 ### Added

package/README.md

@@ -60,12 +60,16 @@ npm install -g roon-mcp
 | Tool | Purpose |
 | --- | --- |
 | `list_zones()` | List playable zones/outputs (id, name, state, output ids). |
-| `search_music({ query, type?, limit?, includeStreaming? })` | Resolve a text query into ranked browse candidates (opaque, session-scoped item keys). `type` (`artist`/`album`/`track`/`genre`/`playlist`/`radio`) restricts the category; for non-genre types an empty typed search broadens to all categories. See [Genre search](#genre-search) for `type:"genre"` and `includeStreaming`. |
+| `search_music({ query, type?, limit?, includeStreaming? })` | Resolve a text query into ranked browse candidates (opaque, session-scoped item keys). `type` (`artist`/`album`/`track`/`genre`/`playlist`/`radio`) restricts the category; for non-genre types an empty typed search broadens to all categories. See [Streaming search](#streaming-search-genre-and-artist) for `type:"genre"`/`type:"artist"` and `includeStreaming`. |
 | `get_tracks_for({ itemKey, limit? })` | Expand an artist/album/genre/playlist candidate into concrete playable tracks. |
 | `play_now({ zoneId?, itemKey, shuffle? })` | Immediately play one search candidate; `zoneId` optional (defaults as above). |
 | `enqueue_and_play({ zoneId?, itemKeys, shuffle? })` | Build an ad-hoc queue from curated item keys and start it (**replaces** the zone's queue); reports queued/skipped. |
+| `now_playing({ zoneId? })` | Snapshot of the zone's current track — state, title, artist, album, seek position. `title`/`artist`/`album` are undefined when nothing is playing. |
+| `control_playback({ zoneId?, action })` | Run a transport verb: `pause` / `resume` / `next` / `previous` / `stop`. |
+| `set_volume({ zoneId?, level })` | Set the zone's volume to `level` percent (0–100). Rescales to each output's native range; incremental outputs are reported as skipped. |
+| `mute({ zoneId?, muted })` | Mute (`muted: true`) or unmute (`muted: false`) every output in the zone. |
 
-### Genre search
+### Streaming search (genre and artist)
 
 Genres don't appear in Roon's flat search hierarchy, so `search_music({ type: "genre" })`
 is handled specially: the server walks Roon's dedicated **Genres** tree (cached per
@@ -75,15 +79,47 @@ never silently broadens to artists/albums. These candidates are **library-scoped
 (genres present in your collection, including TIDAL albums you've added). Expand one
 with `get_tracks_for` to get a cross-album mix of that genre.
 
-Pass **`includeStreaming: true`** (only meaningful for `type:"genre"`) to also pull a
-track mix from streaming services for discovery beyond your library. The server takes
-the genre-relevant **albums** the flat search surfaces and samples tracks across them.
-The result lists library genre nodes first, then ready-to-play streaming tracks (each a
-`track` candidate, source group `Streaming`) appended after. Default is `false`
-(library only).
-
-> Cost: with `includeStreaming` on, each sampled album re-navigates the flat search, so
-> an opt-in streaming genre search does a handful of extra browse round-trips.
+Artist search is library-scoped too: `search_music({ type: "artist" })` returns artists
+present in your collection. When the top-ranked artist has no library content — e.g. a
+node with `subtitle: "0 Albums"` because all albums were removed, or an artist not in
+your library at all but available on TIDAL — the result's `message` field carries a
+hint so the agent can opt in to the streaming path (see below) without having to
+discover the dead end at `get_tracks_for` time.
+
+Pass **`includeStreaming: true`** (meaningful for both `type:"genre"` and
+`type:"artist"`) to also pull a track mix from streaming services for discovery beyond
+your library:
+
+- For `type:"genre"`, the server takes the genre-relevant **albums** the flat search
+  surfaces and samples tracks across them. Library genre nodes come first, then
+  ready-to-play streaming tracks (each a `track` candidate, source group `Streaming`)
+  appended after.
+- For `type:"artist"`, the server runs a track search and filters to entries by that
+  artist (matching the track's subtitle, which Roon uses for the artist on track rows).
+  Library artist candidates come first, then streaming tracks by the same artist
+  appended after. This is the path that unblocks "play/queue multiple *Artist* songs"
+  for an artist with no library content: the streaming tracks are queue-playable
+  directly via `enqueue_and_play`. Results are best-effort — a small fraction may be
+  features or compilations; the agent's per-artist cap / dedupe handles that.
+
+Default is `false` (library only).
+
+> Cost: with `includeStreaming` on, each sampled album/track re-navigates the flat
+> search, so an opt-in streaming search does a handful of extra browse round-trips.
+
+### Now playing & transport
+
+`now_playing({ zoneId? })` returns a structured snapshot (state, title, artist,
+album, seek position) so the agent can confirm what's on and where before
+running a transport verb. `control_playback` takes one verb at a time
+(`pause`, `resume`, `next`, `previous`, `stop`) — there is no compound
+"pause and skip." For "louder" / "softer" without a number, `set_volume` is
+absolute, so the agent should ask for a target percent or apply a default
+delta; volume isn't reported in `now_playing`. Volume and mute fan out to
+every output in the resolved zone and rescale per output, so a single
+`set_volume({ level: 50 })` works correctly across a grouped zone with mixed
+dB / numeric devices; incremental outputs (IR blasters and the like) are
+reported as `skipped` in the result.
 
 ## Assumptions
 

package/dist/RoonMcpServer.d.ts

@@ -2,6 +2,7 @@ import { PlaybackService } from "./PlaybackService.js";
 import { RoonClient } from "./RoonClient.js";
 import { SearchService } from "./SearchService.js";
 import { TrackExpansionService } from "./TrackExpansionService.js";
+import { TransportService } from "./TransportService.js";
 import { ZoneService } from "./ZoneService.js";
 /**
  * Owns MCP startup and tool registration, and maps tool calls to services.
@@ -13,8 +14,9 @@ export declare class RoonMcpServer {
     private readonly search;
     private readonly tracks;
     private readonly playback;
+    private readonly transport;
     private readonly server;
-    constructor(roon: RoonClient, zones: ZoneService, search: SearchService, tracks: TrackExpansionService, playback: PlaybackService);
+    constructor(roon: RoonClient, zones: ZoneService, search: SearchService, tracks: TrackExpansionService, playback: PlaybackService, transport: TransportService);
     registerTools(): void;
     start(): Promise<void>;
     stop(): Promise<void>;

package/dist/RoonMcpServer.js

@@ -21,13 +21,15 @@ export class RoonMcpServer {
     search;
     tracks;
     playback;
+    transport;
     server;
-    constructor(roon, zones, search, tracks, playback) {
+    constructor(roon, zones, search, tracks, playback, transport) {
         this.roon = roon;
         this.zones = zones;
         this.search = search;
         this.tracks = tracks;
         this.playback = playback;
+        this.transport = transport;
         this.server = new McpServer({
             name: "roon-mcp",
             version: "0.1.0",
@@ -37,8 +39,12 @@ export class RoonMcpServer {
     registerTools() {
         this.server.registerTool("list_zones", {
             title: "List Roon zones",
-            description: "List the playable zones/outputs exposed by the paired Roon Core. " +
-                "Returns each zone's id, display name, playback state, and output ids.",
+            description: "Use this when the user asks which rooms, speakers, or outputs Roon can " +
+                "play to, or before starting playback when the target zone is unclear " +
+                "(e.g. \"what zones are on?\", \"play in the kitchen\", \"which speaker is " +
+                "in the office?\"). Lists every zone/output the paired Core exposes with " +
+                "its id, display name, current playback state, and output ids. Call this " +
+                "first if no zone is obvious and ROON_DEFAULT_ZONE is not set.",
             inputSchema: {},
         }, async () => {
             try {
@@ -52,24 +58,38 @@ export class RoonMcpServer {
         });
         this.server.registerTool("search_music", {
             title: "Search Roon music",
-            description: "Resolve a text query into ranked Roon browse candidates. Optionally " +
-                "filter by item type (artist, album, track, genre, playlist, radio); " +
-                "for non-genre types, an empty typed search broadens to all categories. " +
-                "type:\"genre\" is special: genres don't appear in Roon's flat search, so " +
-                "the server walks the dedicated Genres tree and returns the nearest-match " +
-                "genre nodes (with their parent path in the subtitle) without broadening — " +
-                "e.g. \"Psychedelic Trance\" yields \"Psytrance\"/\"Trance\". Set " +
-                "includeStreaming:true (only meaningful for type:\"genre\") to also pull a " +
-                "track mix from streaming services (e.g. TIDAL): the server takes the " +
-                "genre-relevant albums and samples tracks across them, so library genre " +
-                "nodes are listed first and ready-to-play streaming tracks appended after. " +
-                "Returns opaque, session-scoped item keys for use by playback tools.",
+            description: "Use this when the user names music to find — an artist, album, track, " +
+                "playlist, radio station, or genre (e.g. \"find Tycho\", \"look up the " +
+                "album In Rainbows\", \"play some Psytrance\", \"anything by Ryuichi " +
+                "Sakamoto?\"). Resolves a free-text query into ranked Roon browse " +
+                "candidates. Optionally restrict to one item type (artist, album, track, " +
+                "genre, playlist, radio); for non-genre types, an empty typed search " +
+                "broadens to all categories. type:\"genre\" is special — genres don't " +
+                "appear in Roon's flat search, so the server walks the dedicated Genres " +
+                "tree and returns the nearest-match genre nodes (with parent path in the " +
+                "subtitle) without broadening; e.g. \"Psychedelic Trance\" yields " +
+                "\"Psytrance\"/\"Trance\". Set includeStreaming:true (meaningful for " +
+                "type:\"genre\" and type:\"artist\") to also pull a track mix from " +
+                "streaming services (e.g. TIDAL): for a genre the server takes the " +
+                "genre-relevant albums and samples tracks across them; for an artist " +
+                "the server runs a track search and filters to entries by that artist. " +
+                "Library candidates come first, then ready-to-play streaming tracks " +
+                "(each a `track` candidate, source group `Streaming`) appended after. " +
+                "An artist with no library content (e.g. subtitle \"0 Albums\") is " +
+                "reported via the result's `message` so the agent can opt in. Returns " +
+                "opaque, session-scoped item keys for use by the playback tools — pair " +
+                "with get_tracks_for to expand, then play_now or enqueue_and_play.",
             inputSchema: {
-                query: z.string().min(1).describe("Free-text search, e.g. 'Dark Ambient' or 'Tycho'."),
+                query: z
+                    .string()
+                    .min(1)
+                    .describe("What to search for — an artist, album, track, playlist, radio, or " +
+                    "genre name (e.g. 'Tycho', 'In Rainbows', 'Dark Ambient')."),
                 type: z
                     .enum(MUSIC_ITEM_TYPES)
                     .optional()
-                    .describe("Restrict results to this item type."),
+                    .describe("Restrict the search to one item type. Omit to broaden across all " +
+                    "non-genre categories. Use 'genre' for music-genre lookups."),
                 limit: z
                     .number()
                     .int()
@@ -80,9 +100,11 @@ export class RoonMcpServer {
                 includeStreaming: z
                     .boolean()
                     .optional()
-                    .describe("Also pull a track mix from streaming services. " +
-                    "Only applies when type is \"genre\": library genre nodes come first, " +
-                    "then tracks sampled across genre-relevant streaming albums. Default false."),
+                    .describe("Meaningful for type 'genre' and type 'artist': also pull a track " +
+                    "mix from streaming services (e.g. TIDAL). For a genre, library " +
+                    "genre nodes come first, then sampled streaming tracks. For an " +
+                    "artist, library candidates come first, then streaming tracks by " +
+                    "that artist. Default false (library only)."),
             },
         }, async (args) => {
             try {
@@ -95,16 +117,21 @@ export class RoonMcpServer {
         });
         this.server.registerTool("get_tracks_for", {
             title: "Expand a Roon item into tracks",
-            description: "Expand an artist, album, genre, or playlist candidate into concrete " +
-                "playable tracks. Pass an itemKey from a recent search_music result. " +
-                "Returns track candidates with session-scoped item keys (use them " +
-                "promptly with enqueue_and_play). Non-expandable items return empty " +
-                "tracks with a skipped reason rather than an error.",
+            description: "Use this after search_music when the user wants a concrete list of " +
+                "songs — to preview tracks, build a queue, or pick one to start with " +
+                "(e.g. \"what tracks are on this album?\", \"give me 5 tracks of " +
+                "Dark Ambient\", \"what's on this playlist?\"). Expands an artist, " +
+                "album, genre, or playlist candidate into concrete playable tracks. " +
+                "Pass an itemKey from a recent search_music result. Returns track " +
+                "candidates with session-scoped item keys (use them promptly with " +
+                "enqueue_and_play). Non-expandable items return empty tracks with a " +
+                "skipped reason rather than an error.",
             inputSchema: {
                 itemKey: z
                     .string()
                     .min(1)
-                    .describe("Opaque item key from a recent search_music result."),
+                    .describe("Item key to expand — from a recent search_music candidate (artist, " +
+                    "album, genre, or playlist)."),
                 limit: z
                     .number()
                     .int()
@@ -124,22 +151,30 @@ export class RoonMcpServer {
         });
         this.server.registerTool("play_now", {
             title: "Play an item now in a Roon zone",
-            description: "Immediately play a single search candidate in the target zone. Pass an " +
-                "itemKey from a recent search_music result (item keys are session-scoped, " +
-                "so use a fresh one). zoneId is optional: omit it to use the configured " +
-                "default zone (ROON_DEFAULT_ZONE) or the single/Office/playing fallback; " +
-                "an ambiguous result returns ZONE_AMBIGUOUS so you can ask. Optionally " +
-                "shuffle. Returns a PlaybackResult.",
+            description: "Use this when the user wants one specific thing playing right now — " +
+                "an album, artist, playlist, genre mix, or single track (e.g. \"play " +
+                "Tycho\", \"put on In Rainbows\", \"start some Psytrance in the office\", " +
+                "\"play that track\"). Immediately plays a single search candidate in " +
+                "the target zone and replaces whatever was queued. Pass an itemKey from " +
+                "a recent search_music (or get_tracks_for) result — item keys are " +
+                "session-scoped, so use a fresh one. zoneId is optional: omit it to use " +
+                "ROON_DEFAULT_ZONE, or fall back to the only zone / an \"Office\" zone / " +
+                "the currently-playing zone; if it still can't decide it returns " +
+                "ZONE_AMBIGUOUS so the agent can ask the user or call list_zones. " +
+                "Optionally shuffle. Returns a PlaybackResult.",
             inputSchema: {
                 zoneId: z
                     .string()
                     .min(1)
                     .optional()
-                    .describe("Target zone id or output id (from list_zones). Omit to use the default zone."),
+                    .describe("Target zone id or output id from list_zones (e.g. an id, or a name " +
+                    "substring like 'Office'). Omit to use ROON_DEFAULT_ZONE or fall " +
+                    "back automatically."),
                 itemKey: z
                     .string()
                     .min(1)
-                    .describe("Opaque item key from a recent search_music result."),
+                    .describe("What to play — item key from a recent search_music or get_tracks_for " +
+                    "result (album, artist, playlist, genre, track, etc.)."),
                 shuffle: z
                     .boolean()
                     .optional()
@@ -156,10 +191,15 @@ export class RoonMcpServer {
         });
         this.server.registerTool("enqueue_and_play", {
             title: "Build and start a curated Roon queue",
-            description: "Build an ad-hoc queue from an ordered list of curated item keys and " +
-                "start playback in the target zone. This replaces the zone's current " +
+            description: "Use this when the user wants a custom lineup — a mix of artists, a " +
+                "shuffled selection across albums, a hand-picked set of tracks, or any " +
+                "time \"queue\", \"setlist\", \"mix of\", or \"play these in order\" comes " +
+                "up (e.g. \"queue up five Tycho tracks then some Boards of Canada\", " +
+                "\"shuffle 10 ambient tracks\", \"build a set: artist A, then B, then C\"). " +
+                "Builds an ad-hoc queue from an ordered list of curated item keys and " +
+                "starts playback in the target zone. This replaces the zone's current " +
                 "queue: the first playable item starts immediately (Play Now), the rest " +
-                "are appended in order. Pass itemKeys from recent get_tracks_for/" +
+                "are appended in order. Pass itemKeys from recent get_tracks_for / " +
                 "search_music results (use them promptly — they are session-scoped). " +
                 "zoneId is optional (omit to use the default zone; see play_now). " +
                 "Optionally shuffle. Returns a PlaybackResult with queued/skipped counts " +
@@ -169,11 +209,13 @@ export class RoonMcpServer {
                     .string()
                     .min(1)
                     .optional()
-                    .describe("Target zone id or output id (from list_zones). Omit to use the default zone."),
+                    .describe("Target zone id or output id from list_zones. Omit to use the default " +
+                    "zone (see play_now)."),
                 itemKeys: z
                     .array(z.string().min(1))
                     .min(1)
-                    .describe("Ordered item keys to queue (from get_tracks_for/search_music)."),
+                    .describe("Ordered item keys to queue, from recent get_tracks_for or " +
+                    "search_music results (tracks, albums, artists, etc.)."),
                 shuffle: z
                     .boolean()
                     .optional()
@@ -188,6 +230,140 @@ export class RoonMcpServer {
                 return toToolError(err);
             }
         });
+        this.server.registerTool("now_playing", {
+            title: "Get the currently-playing track in a Roon zone",
+            description: "Use this when the user asks what is currently playing, what song is " +
+                "on, who's singing, what just started, or wants a snapshot before " +
+                "skipping or pausing (e.g. \"what's playing?\", \"what's playing in " +
+                "the kitchen?\", \"who's this?\", \"what's the current track?\", " +
+                "\"what song is this?\"). Returns a structured snapshot: zone id and " +
+                "name, playback state (playing/paused/loading/stopped), title, " +
+                "artist, album, and the current seek position when available. " +
+                "`title`/`artist`/`album` are undefined when nothing is playing. " +
+                "Call this before pause/skip/volume changes when the user hasn't " +
+                "named a zone — it confirms where to act and what the state is. " +
+                "zoneId is optional: omit to use ROON_DEFAULT_ZONE, or fall back " +
+                "to the only zone / an \"Office\" zone / the currently-playing zone; " +
+                "if it still can't decide it returns ZONE_AMBIGUOUS so the agent " +
+                "can ask the user or call list_zones.",
+            inputSchema: {
+                zoneId: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe("Target zone id or output id from list_zones (e.g. an id, or a " +
+                    "name substring like 'Office'). Omit to use ROON_DEFAULT_ZONE " +
+                    "or fall back automatically."),
+            },
+        }, async (args) => {
+            try {
+                const info = await this.transport.getNowPlaying(args.zoneId);
+                return structured(info);
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
+        this.server.registerTool("control_playback", {
+            title: "Run a Roon transport verb (pause/resume/next/previous/stop)",
+            description: "Use this for the common transport verbs — pause, resume, skip, " +
+                "next track, previous track, stop (e.g. \"pause\", \"pause the " +
+                "kitchen\", \"skip\", \"next track\", \"next song\", \"play the " +
+                "next song\", \"resume\", \"resume in the office\", \"stop\", " +
+                "\"stop the music\"). Runs one transport verb against the resolved " +
+                "zone. For \"louder\"/\"softer\" without a number, call now_playing " +
+                "first to read the current state, then set_volume with a target " +
+                "percent — this tool is verbs only. zoneId is optional and resolves " +
+                "like now_playing. Returns the resolved zoneId, the action taken, " +
+                "and the resulting playback state.",
+            inputSchema: {
+                zoneId: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe("Target zone id or output id from list_zones. Omit to use " +
+                    "ROON_DEFAULT_ZONE or fall back automatically (see now_playing)."),
+                action: z
+                    .enum(["pause", "resume", "next", "previous", "stop"])
+                    .describe("Transport verb to run: 'pause' to stop playback, 'resume' to " +
+                    "restart it, 'next' to skip to the next track, 'previous' to " +
+                    "go back, 'stop' to release the audio device."),
+            },
+        }, async (args) => {
+            try {
+                const result = await this.transport.control(args.zoneId, args.action);
+                return structured(result);
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
+        this.server.registerTool("set_volume", {
+            title: "Set a Roon zone's volume to a target percent",
+            description: "Use this when the user wants to change how loud a zone is — turn " +
+                "it up, turn it down, set the volume, or pick a level for a " +
+                "specific room (e.g. \"turn it up to 60\", \"volume to 30 in the " +
+                "office\", \"set the kitchen to 50\", \"louder\" — see note). Sets " +
+                "the zone's volume to `level` percent (0 = silent, 100 = max). The " +
+                "server rescales to each output's native range, so a single value " +
+                "works across mixed devices in a grouped zone. Incremental " +
+                "outputs (IR blasters with no numeric range) are reported as " +
+                "skipped rather than guessed at. zoneId is optional and resolves " +
+                "like now_playing. NOTE on relative changes (\"louder\" / \"softer\" " +
+                "without a number): this tool is absolute — read the current " +
+                "state with now_playing isn't enough on its own (volume isn't " +
+                "exposed there), so for relative changes, ask the user for a " +
+                "target percent or apply a reasonable default delta.",
+            inputSchema: {
+                zoneId: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe("Target zone id or output id from list_zones. Omit to use " +
+                    "ROON_DEFAULT_ZONE or fall back automatically."),
+                level: z
+                    .number()
+                    .min(0)
+                    .max(100)
+                    .describe("Target volume in percent (0 = silent, 100 = max). Mapped to " +
+                    "each output's native range."),
+            },
+        }, async (args) => {
+            try {
+                const result = await this.transport.setVolume(args.zoneId, args.level);
+                return structured(result);
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
+        this.server.registerTool("mute", {
+            title: "Mute or unmute a Roon zone",
+            description: "Use this when the user wants to mute or unmute a zone (e.g. " +
+                "\"mute\", \"mute the kitchen\", \"unmute\", \"silence the " +
+                "office\", \"stop the noise\"). Mutes (or unmutes) every output " +
+                "in the resolved zone. zoneId is optional and resolves like " +
+                "now_playing. `muted: true` mutes, `muted: false` unmutes.",
+            inputSchema: {
+                zoneId: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe("Target zone id or output id from list_zones. Omit to use " +
+                    "ROON_DEFAULT_ZONE or fall back automatically."),
+                muted: z
+                    .boolean()
+                    .describe("`true` to mute, `false` to unmute."),
+            },
+        }, async (args) => {
+            try {
+                const result = await this.transport.mute(args.zoneId, args.muted);
+                return structured(result);
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
     }
     async start() {
         this.roon.start();

package/dist/RoonMcpServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"RoonMcpServer.js","sourceRoot":"","sources":["../src/RoonMcpServer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RoonMcpServer.js","sourceRoot":"","sources":["../src/RoonMcpServer.ts"],"names":[],"mappings":"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"}

package/dist/SearchService.d.ts

@@ -21,6 +21,18 @@ export declare class SearchService {
      * opt-in cost we accept for the streaming path.
      */
     private collectStreamingGenreTracks;
+    /**
+     * Artist discovery beyond the library. The library album search that
+     * collectStreamingGenreTracks leans on returns nothing for an artist that
+     * has been fully removed from the library, so we go one level shallower: a
+     * track search, filtered to entries whose subtitle (the track's artist in
+     * Roon's flat search) matches the queried artist. On a TIDAL Core this
+     * surfaces the artist's streaming catalog as ready-to-play tracks. The
+     * result is best-effort: a small fraction may be features or compilations
+     * — the agent's per-artist cap / dedupe (see README "Curation is
+     * agent-side") handles that.
+     */
+    private collectStreamingArtistTracks;
     private performSearch;
     /** Indices (into the top-level group list) to scan for the requested type. */
     private selectGroupIndices;

package/dist/SearchService.js

@@ -46,7 +46,24 @@ export class SearchService {
         }
         // Search builds its own item keys inside performSearch, so a stale-session
         // failure is recoverable with one reset-and-replay (see runExclusiveWithRetry).
-        return this.browse.runExclusiveWithRetry(() => this.performSearch(input, limit));
+        const library = await this.browse.runExclusiveWithRetry(() => this.performSearch(input, limit));
+        // Artist search is library-only: when the artist has no library content
+        // (subtitle "0 Albums") or isn't in the library at all, optionally append a
+        // streaming track mix so the user request "play/queue <artist>" doesn't
+        // dead-end at get_tracks_for. Mirrors the genre streaming path's shape:
+        // library results first, streaming tracks appended with sourceGroup
+        // "Streaming". See collectStreamingArtistTracks.
+        if (input.type === "artist" && input.includeStreaming) {
+            const streaming = await this.collectStreamingArtistTracks(input.query, limit);
+            if (streaming.length > 0) {
+                const candidates = [...library.candidates, ...streaming];
+                const message = library.message
+                    ? `${library.message} Also showing ${streaming.length} streaming track(s).`
+                    : `No library artist matched "${input.query}"; showing streaming tracks.`;
+                return { query: input.query, candidates, broadened: library.broadened, message };
+            }
+        }
+        return library;
     }
     async searchGenres(query, limit, includeStreaming) {
         const libraryGenres = await this.genres.searchGenres(query, limit);
@@ -107,6 +124,42 @@ export class SearchService {
         }
         return out;
     }
+    /**
+     * Artist discovery beyond the library. The library album search that
+     * collectStreamingGenreTracks leans on returns nothing for an artist that
+     * has been fully removed from the library, so we go one level shallower: a
+     * track search, filtered to entries whose subtitle (the track's artist in
+     * Roon's flat search) matches the queried artist. On a TIDAL Core this
+     * surfaces the artist's streaming catalog as ready-to-play tracks. The
+     * result is best-effort: a small fraction may be features or compilations
+     * — the agent's per-artist cap / dedupe (see README "Curation is
+     * agent-side") handles that.
+     */
+    async collectStreamingArtistTracks(query, limit) {
+        const trackSearch = await this.browse.runExclusiveWithRetry(() => this.performSearch({ query, type: "track" }, limit));
+        const tracks = trackSearch.candidates.filter((c) => c.type === "track");
+        if (tracks.length === 0)
+            return [];
+        const q = normalize(query);
+        const matched = tracks.filter((t) => {
+            const artist = normalize(t.subtitle ?? "");
+            // Substring is enough: Roon track subtitles are the artist (sometimes
+            // "Artist / Album"); a fuller match doesn't help here. We fall back to
+            // the track's own title as a last resort so a query that exactly
+            // matches a single-song single (e.g. a self-titled track) still
+            // surfaces something.
+            return artist === q || artist.includes(q) || normalize(t.title) === q;
+        });
+        return matched.slice(0, limit).map((t) => ({
+            itemKey: t.itemKey,
+            title: t.title,
+            subtitle: t.subtitle,
+            type: "track",
+            score: t.score,
+            available: t.available,
+            sourceGroup: "Streaming",
+        }));
+    }
     async performSearch(input, limit) {
         // Roon only registers the search when `input` and `pop_all` ride in the
         // same browse call; submitting `input` after a separate reset yields a
@@ -148,6 +201,15 @@ export class SearchService {
         else if (ranked.length === 0) {
             message = "No results.";
         }
+        // When an artist search surfaces a candidate with no library content,
+        // surface that up front so the agent doesn't have to discover the dead
+        // end at get_tracks_for time. The streaming-artist fallback in
+        // searchMusic picks this up.
+        if (input.type === "artist" && /^\s*0\s+albums?\s*$/i.test(ranked[0]?.subtitle ?? "")) {
+            const name = ranked[0].title;
+            const hint = `Artist "${name}" has no library albums; pass includeStreaming:true to sample streaming tracks.`;
+            message = message ? `${message} ${hint}` : hint;
+        }
         return { query: input.query, candidates: ranked, broadened, message };
     }
     /** Indices (into the top-level group list) to scan for the requested type. */