deep-roon-mcp 0.3.0 → 0.3.6

package/dist/deep-roon-mcp.js

@@ -15525,7 +15525,7 @@ var require_lib2 = __commonJS({
 var version2;
 var init_package = __esm({
   "package.json"() {
-    version2 = "0.3.0";
+    version2 = "0.3.6";
   }
 });
 
@@ -15852,6 +15852,11 @@ function field2(o, name) {
   for (const [k, v] of Object.entries(f)) if (k.endsWith("::" + name)) return v;
   return void 0;
 }
+function imageKey(c, o, name = "Image") {
+  const url2 = field2(obj(c, field2(o, name)), "Url");
+  const m = /^broker:\/\/\/image\/([^.]+)\./.exec(String(url2 ?? ""));
+  return m ? m[1] : void 0;
+}
 function dateParts(v) {
   if (!Buffer.isBuffer(v) || v.length < 2) return void 0;
   const n = new BinaryReader(Uint8Array.from(v)).flexInt();
@@ -15953,6 +15958,8 @@ function albumRow(c, o) {
   if (flag(field2(o, "IsListenLater"))) r.listen_later = true;
   const p = field2(o, "Popularity");
   if (typeof p === "number") r.popularity = Math.round(p * 100) / 100;
+  const img = imageKey(c, o);
+  if (img) r.image = img;
   return r;
 }
 function resultRow(c, o) {
@@ -15962,6 +15969,8 @@ function resultRow(c, o) {
     const r = { kind: "artist", key: String(field2(o, "PerformerId") ?? ""), name: field2(o, "Name") ?? "" };
     const n = field2(o, "MainPerformerAlbumCount");
     if (typeof n === "number" && n > 0) r.albums_in_library = n;
+    const img = imageKey(c, o, "Photo") ?? imageKey(c, o, "Avatar");
+    if (img) r.image = img;
     return r;
   }
   if (t === "TrackLite" || t === "Track") {
@@ -15976,6 +15985,8 @@ function resultRow(c, o) {
     const l = field2(o, "LengthSeconds");
     if (typeof l === "number") r.length = duration3(l);
     r.source = sourceOf(o, al) ?? "library";
+    const img = imageKey(c, al) ?? imageKey(c, o);
+    if (img) r.image = img;
     return r;
   }
   return { kind: t, title: field2(o, "Title") ?? field2(o, "Name") ?? "" };
@@ -15996,6 +16007,7 @@ var init_graph = __esm({
       return (o?.fields?.$items ?? o?.$items ?? []).filter((x) => typeof x === "string");
     }, "strings");
     flag = /* @__PURE__ */ __name((v) => v === true || Buffer.isBuffer(v) && v.length > 1 && v[0] >= 1, "flag");
+    __name(imageKey, "imageKey");
     __name(dateParts, "dateParts");
     yearOf = /* @__PURE__ */ __name((v) => dateParts(v)?.[0], "yearOf");
     __name(dateText, "dateText");
@@ -16357,6 +16369,8 @@ async function bio(key, max, wiki) {
     }
     const g = list("Genres").filter((x) => typeof x === "string");
     if (g.length) artist.genres = g;
+    const img = imageKey(c, p, "Photo") ?? imageKey(c, p, "Avatar");
+    if (img) artist.image = img;
     return {
       artist,
       texts,
@@ -16388,6 +16402,8 @@ async function discography(key, wanted) {
     if (typeof n === "number") artist.albums_in_library = n;
     const from = field2(p, "BirthPlace");
     if (from) artist.from = from;
+    const img = imageKey(c, p, "Photo") ?? imageKey(c, p, "Avatar");
+    if (img) artist.image = img;
     return { service: SERVICE_NAME[service2], artist, albums };
   });
 }
@@ -49384,6 +49400,8 @@ async function nowPlaying() {
         r.volume_max = v.max;
         if (v.is_muted) r.muted = true;
       }
+      const img = off?.now_playing?.image_key;
+      if (img) r.image = img;
       const outs = c.graph.findByType("Endpoint").filter((e) => {
         const zz = field2(e, "Zone");
         return isRef2(zz) && String(zz.$ref) === String(z2.oid);
@@ -49397,17 +49415,23 @@ async function nowPlaying() {
       if (r.state === "stopped") return r;
       const np = obj(c, field2(z2, "NowPlaying"));
       const tr = obj(c, field2(items(c, field2(np, "Tracks"))[0], "Track"));
-      if (tr && field2(tr, "Title")) {
+      const lines = off?.now_playing?.three_line;
+      const t = String(field2(tr, "Title") ?? "").toLowerCase(), l1 = String(lines?.line1 ?? "").toLowerCase();
+      const stream = !!l1 && !!t && !l1.includes(t) && !t.includes(l1);
+      if (tr && field2(tr, "Title") && !stream) {
         const al = obj(c, field2(tr, "Album"));
         r.title = field2(tr, "Title");
         r.artist = clean(field2(al, "PerformedBy"));
         r.album = field2(al, "Title");
+        const tk = field2(tr, "TrackId");
+        if (tk !== void 0 && tk !== null) r.track_key = String(tk);
+        const ak = field2(al, "AlbumId");
+        if (ak !== void 0 && ak !== null) r.album_key = String(ak);
         const f = field2(tr, "Format");
         if (f) r.format = f;
         const l = field2(tr, "LengthSeconds");
         if (typeof l === "number") r.length = duration3(l);
       } else {
-        const lines = off?.now_playing?.three_line;
         if (lines?.line1) {
           r.title = lines.line1;
           if (lines.line2) r.artist = lines.line2;
@@ -49418,7 +49442,7 @@ async function nowPlaying() {
       const pos = field2(z2, "SeekPosition");
       if (typeof pos === "number") r.position = duration3(pos);
       const left = field2(obj(c, field2(z2, "Queue")), "TrackCountRemaining");
-      if (typeof left === "number") r.tracks_left_in_queue = left;
+      if (typeof left === "number" && !r.source) r.tracks_left_in_queue = left;
       return r;
     });
     return { zones: out };
@@ -49659,7 +49683,7 @@ function registerReadTools(server, internal = true) {
   const reg = /* @__PURE__ */ __name(((name, cfg, cb) => R(name) ? server.registerTool.call(server, name, cfg, cb) : void 0), "reg");
   reg("roon_search", {
     title: "Search Roon",
-    description: 'Search Roon \u2014 the user\'s Roon library and the catalogues of the streaming services signed in (Qobuz, TIDAL) at once; each row says its `source` (library, Qobuz, TIDAL). Returns albums (with format, e.g. FLAC 96kHz 24bit), artists and tracks. `kind` narrows to album, track or artist \u2014 use `kind: "track"` with the song title (and artist) to find one specific track; a broad query without `kind` can fill up with artists. Albums and tracks carry a `key` for `roon_album`; artists carry a `key` for `roon_artist` and `roon_bio`. Albums say their `year`, and `in_library` when the user has them in Roon. Keys stay valid between calls.',
+    description: 'Search Roon \u2014 the user\'s Roon library and the catalogues of the streaming services signed in (Qobuz, TIDAL) at once; each row says its `source` (library, Qobuz, TIDAL). Rows carry `image`, the key of the cover: the Core serves it at http://<core address>:9330/image/<key>.jpg, or scaled at /image/<key>.300.jpg (for clients that draw; a chat shows covers with roon_cover). The `image` of roon_now_playing is an official key, served at /api/image/<key>?scale=fit&width=600&height=600. Returns albums (with format, e.g. FLAC 96kHz 24bit), artists and tracks. `kind` narrows to album, track or artist \u2014 use `kind: "track"` with the song title (and artist) to find one specific track; a broad query without `kind` can fill up with artists. Albums and tracks carry a `key` for `roon_album`; artists carry a `key` for `roon_artist` and `roon_bio`. Albums say their `year`, and `in_library` when the user has them in Roon. Keys stay valid between calls.',
     inputSchema: { query: external_exports.string().min(1), kind: external_exports.enum(["album", "track", "artist"]).optional(), limit: limit(100, 30) },
     annotations: READ
   }, ({ query, kind, limit: n }) => run(() => search(query, n ?? 30, kind)));
@@ -49866,6 +49890,14 @@ async function playTracks(keys, zoneName, how) {
 __name(playTracks, "playTracks");
 var BUTTONS = { pause: "Pause", play: "Play", playpause: "PlayPause", stop: "Stop", next: "Next", previous: "Previous" };
 async function control2(zoneName, action) {
+  if (action === "release") {
+    return withCore(async (c) => {
+      const z2 = findZone(c, zoneName);
+      c.remoting.callMethodNoReply(z2.oid, formatMethodSignature("Zone", "Suspend", []), Buffer.alloc(0));
+      log(`control: Suspend on ${z2.name}`);
+      return { ok: true, zone: z2.name, action };
+    });
+  }
   const m = BUTTONS[action];
   if (!m) throw new RoonError(`Unknown action; choose from ${Object.keys(BUTTONS).join(", ")}`, "invalid");
   const r = await withCore(async (c) => {
@@ -49948,6 +49980,10 @@ function queueRow(c, oid) {
   if (album2) r.album = album2;
   const l = field2(tr, "LengthSeconds");
   if (typeof l === "number") r.length = duration3(l);
+  const k = field2(tr, "TrackId");
+  if (k !== void 0 && k !== null) r.key = String(k);
+  const img = imageKey(c, al) ?? imageKey(c, tr);
+  if (img) r.image = img;
   return r;
 }
 __name(queueRow, "queueRow");
@@ -50128,10 +50164,10 @@ function registerControlTools(server, internal = true) {
   }, ({ keys, zone: zn, mode: m }) => run(() => playTracks(keys, zn, m ?? "now")));
   reg("roon_control", {
     title: "Transport",
-    description: "The buttons of a Roon zone: pause, play (resume), playpause, stop, next, previous. Only on an explicit request, never as a probe.",
-    inputSchema: { zone, action: external_exports.enum(["pause", "play", "playpause", "stop", "next", "previous"]) },
+    description: "The buttons of a Roon zone: pause, play (resume), playpause, stop, next, previous \u2014 and release: let go of the audio device right away (what Roon does by itself a few seconds after a pause), so another source can use the speaker. Only on an explicit request, never as a probe.",
+    inputSchema: { zone, action: external_exports.enum(["pause", "play", "playpause", "stop", "next", "previous", "release"]) },
     annotations: PLAYS
-  }, ({ zone: zn, action }) => run(() => internal ? control2(zn, action) : control(zn, action)));
+  }, ({ zone: zn, action }) => run(() => internal ? control2(zn, action) : action === "release" ? Promise.reject(new Error("release needs Roon's internal protocol (switched off)")) : control(zn, action)));
   reg("roon_seek", {
     title: "Seek",
     description: "Jump to a position in the track that plays on a Roon zone, in seconds from the start. Only on an explicit request.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deep-roon-mcp",
-  "version": "0.3.0",
+  "version": "0.3.6",
   "description": "An MCP server for Roon that reaches the parts the official API doesn't: reviews, biographies, Qobuz's and TIDAL's shelves, TIDAL's playlists, your history, search across your library and the streaming services",
   "license": "Apache-2.0",
   "author": "René Bouwmeester <21277119+renebouwmeester@users.noreply.github.com>",