deep-roon-mcp 0.4.0 → 0.4.5

package/README.md

@@ -22,7 +22,7 @@ server of its own and sends nothing anywhere else. What you ask goes to your MCP
 
 ## Status
 
-Version 0.4: fifty-six tools. Qobuz, TIDAL or both — whatever is signed in on your Core.
+Version 0.4: fifty-seven tools. Qobuz, TIDAL or both — whatever is signed in on your Core.
 
 **Reading** — changes nothing in Roon:
 
@@ -88,6 +88,7 @@ Version 0.4: fifty-six tools. Qobuz, TIDAL or both — whatever is signed in on
 | `roon_library_add` | A Qobuz or TIDAL album into your library |
 | `roon_playlist_create` | A new playlist from tracks |
 | `roon_dsp_set` | MUSE on or off, one part on or off, or a preset |
+| `roon_radio_favorite` | A station into My Live Radio, or out of it |
 
 ## Install
 
@@ -107,7 +108,7 @@ The settings (Claude Desktop › Settings › Extensions › Deep Roon MCP):
 | Setting | What it does |
 |---|---|
 | Roon Core address | Empty: found on your network. Fill in the Core's address for another subnet or a private VPN (Tailscale) |
-| Essentials only | Seventeen tools instead of fifty-six, for small models |
+| Essentials only | Seventeen tools instead of fifty-seven, for small models |
 | Use Roon's internal protocol | Off: only the official API — zones, playback, volume, grouping; no search, reviews, Focus or history |
 
 ### Other clients

package/dist/deep-roon-mcp.js

@@ -15525,7 +15525,7 @@ var require_lib2 = __commonJS({
 var version2;
 var init_package = __esm({
   "package.json"() {
-    version2 = "0.4.0";
+    version2 = "0.4.5";
   }
 });
 
@@ -15852,6 +15852,15 @@ function field2(o, name) {
   for (const [k, v] of Object.entries(f)) if (k.endsWith("::" + name)) return v;
   return void 0;
 }
+function imageKeys(c, o, name = "Images", max = 4) {
+  return items(c, field2(o, name)).map((im) => {
+    const m = /^broker:\/\/\/image\/([^.]+)\./.exec(String(field2(im, "Url") ?? ""));
+    return m ? m[1] : "";
+  }).filter(Boolean).slice(0, max);
+}
+function imageUrls(c, o, name = "Images", max = 4) {
+  return items(c, field2(o, name)).map((im) => String(field2(im, "Url") ?? "").replace(/^http:\/\//, "https://")).filter((u) => /^https:\/\//.test(u)).slice(0, max);
+}
 function imageKey(c, o, name = "Image") {
   const url2 = field2(obj(c, field2(o, name)), "Url");
   const m = /^broker:\/\/\/image\/([^.]+)\./.exec(String(url2 ?? ""));
@@ -15953,6 +15962,8 @@ function albumRow(c, o) {
   if (typeof st === "number" && st > 0) r.stars = st / 2;
   const lb = strings(c, field2(o, "Labels"));
   if (lb.length) r.label = lb.join(" / ");
+  const gs = strings(c, field2(o, "Genres"));
+  if (gs.length) r.genres = gs.slice(0, 8);
   if (field2(o, "Source") === 1) r.in_library = true;
   if (flag(field2(o, "IsFavorite"))) r.favorite = true;
   if (flag(field2(o, "IsListenLater"))) r.listen_later = true;
@@ -16007,6 +16018,8 @@ 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(imageKeys, "imageKeys");
+    __name(imageUrls, "imageUrls");
     __name(imageKey, "imageKey");
     __name(dateParts, "dateParts");
     yearOf = /* @__PURE__ */ __name((v) => dateParts(v)?.[0], "yearOf");
@@ -16478,6 +16491,7 @@ __export(focus_exports, {
   artists: () => artists,
   focus: () => focus,
   library: () => library2,
+  toplevelGenres: () => toplevelGenres,
   tracks: () => tracks,
   work: () => work,
   works: () => works
@@ -16576,6 +16590,28 @@ async function focusMembers(c, f, people = ["artist", "composer", "producer"]) {
   if (f.not_played_within_days) m.push({ name: "ExcludePlayedInLastNDays", propType: 10, value: maybeInt(f.not_played_within_days) });
   if (f.added_within_days) m.push({ name: "RequireImportedInLastNDays", propType: 10, value: maybeInt(f.added_within_days) });
   if (f.hires) m.push({ name: "RequireSampleRates", propType: 23, value: intList([88200, 96e3, 176400, 192e3, 352800, 384e3]) });
+  if (f.sample_rate) {
+    const hz = names(f.sample_rate).map((x) => Math.round(parseFloat(x) * (parseFloat(x) < 1e3 ? 1e3 : 1))).filter((x) => x > 0);
+    if (hz.length) m.push({ name: "RequireSampleRates", propType: 23, value: intList(hz) });
+  }
+  if (f.bits) {
+    const b = names(f.bits).map(Number).filter((x) => x > 0);
+    if (b.length) m.push({ name: "RequireBitsPerSample", propType: 23, value: intList(b) });
+  }
+  if (f.mqa === true) m.push(yes("RequireIsMQA"));
+  else if (f.mqa === false) m.push(yes("ExcludeIsMQA"));
+  if (f.storage) {
+    const whole = await albumInfo(c, []);
+    const want = f.storage.toLowerCase();
+    const locs = items(c, field2(whole, "Locations")).map((it) => field2(it, "Value")).filter(isRef2);
+    await untilLoaded(c, locs, 1500);
+    const hit = locs.find((v) => {
+      const n = String(field2(obj(c, v), "Name") ?? "").toLowerCase();
+      return want === "local" ? !/tidal|qobuz/.test(n) : n.includes(want);
+    });
+    if (!hit) throw new RoonError(`No "${f.storage}" in this library's locations`, "not_found");
+    m.push({ name: "RequireLocations", propType: 23, value: refList2([hit.$ref]) });
+  }
   if (f.live === true) m.push(yes("RequireIsLive"));
   else if (f.live === false) m.push(yes("ExcludeIsLive"));
   if (f.compilation === true) m.push(yes("RequireIsCompilation"));
@@ -16607,10 +16643,20 @@ function ordering(c, kind, table, sort, ascending, descendingByDefault) {
   if (sort === "random") members2.push({ name: "RandomSeed", propType: 0, value: new BinaryWriter().integer(Math.floor(Math.random() * 2147483647)).toBuffer() });
   return [{ name: "Ordering", propType: 23, value: c.structArg(`Sooloos.Broker.Api.${kind}QueryOrdering`, members2) }];
 }
+async function toplevelGenres(c) {
+  if (toplevelNames) return toplevelNames;
+  const { members: members2 } = await focusMembers(c, {});
+  const info = await albumInfo(c, members2);
+  const hist = items(c, field2(info, "ToplevelGenres")).map((it) => field2(it, "Value"));
+  await untilLoaded(c, hist.filter(isRef2), 2e3);
+  const names2 = hist.map((w) => isRef2(w) ? field2(obj(c, w), "Name") : w).filter((n) => typeof n === "string");
+  if (names2.length) toplevelNames = new Set(names2);
+  return new Set(names2);
+}
 async function library2(f, sort, ascending, limit3, offset2) {
   return withCore(async (c) => {
     const { members: members2, matched } = await focusMembers(c, f);
-    members2.push(...ordering(c, "Album", ALBUM_ORDER, sort, ascending, ["added", "most_played", "popular"]));
+    members2.push(...ordering(c, "Album", ALBUM_ORDER, sort, ascending, ["added", "released", "most_played", "popular"]));
     const out = await virtualQuery(c, "Album", members2, limit3, offset2, (o) => albumRow(c, o));
     return { ...out, matched };
   });
@@ -16652,7 +16698,13 @@ async function focus(f, more, search2, limit3) {
       bit_depths: numbers("BitsPerSample").map((x) => ({ bits: x.w, albums: x.n })),
       live: field2(info, "IsLiveCount") ?? 0,
       compilations: field2(info, "IsCompilationCount") ?? 0,
-      roon_picks: field2(info, "IsPickCount") ?? 0
+      roon_picks: field2(info, "IsPickCount") ?? 0,
+      mqa: field2(info, "IsMQACount") ?? 0,
+      // Raw histograms, to be named once measured (13 Oct 2026): where the albums live, and their file formats.
+      storage: hist("Locations").map((x) => {
+        const n = isRef2(x.w) ? String(field2(obj(c, x.w), "Name") ?? "") : String(x.w);
+        return { name: /tidal/i.test(n) ? "TIDAL" : /qobuz/i.test(n) ? "Qobuz" : "Local", albums: x.n };
+      })
     };
   });
 }
@@ -16673,7 +16725,7 @@ async function tracks(f, sort, ascending, limit3, offset2) {
       text: f.text
     }, ["artist", "composer"]);
     if (f.title) members2.push(text("TrackTitleTextFilter", f.title));
-    members2.push(...ordering(c, "Track", TRACK_ORDER, sort, ascending, ["most_played", "last_played", "added", "popular"]));
+    members2.push(...ordering(c, "Track", TRACK_ORDER, sort, ascending, ["released", "most_played", "last_played", "added", "popular"]));
     const out = await virtualQuery(c, "Track", members2, limit3, offset2, (o) => resultRow(c, o));
     return { ...out, matched };
   });
@@ -16711,6 +16763,8 @@ function workRow(c, w) {
   if (typeof l === "number" && l > 0) r.length = duration3(l);
   const n = field2(w, "PerformanceCount");
   if (typeof n === "number") r.performances = n;
+  const imgs = imageKeys(c, w);
+  if (imgs.length) r.images = imgs;
   return r;
 }
 async function works(f, sort, ascending, limit3, offset2) {
@@ -16777,7 +16831,7 @@ async function work(key, max, wiki) {
     };
   });
 }
-var intList, textList, refList2, maybeInt, dateValue, yes, text, names, english, PANEL, ALBUM_ORDER, TRACK_ORDER, ARTIST_ORDER, WORK_ORDER;
+var intList, textList, refList2, maybeInt, dateValue, yes, text, names, english, PANEL, ALBUM_ORDER, TRACK_ORDER, ARTIST_ORDER, WORK_ORDER, toplevelNames;
 var init_focus = __esm({
   "src/roon/focus.ts"() {
     "use strict";
@@ -16827,6 +16881,8 @@ var init_focus = __esm({
     TRACK_ORDER = { title: 0, released: 1, most_played: 2, last_played: 3, artist: 4, album: 5, length: 6, added: 7, popular: 14, random: 16 };
     ARTIST_ORDER = { name: 0, albums: 2, works: 3, most_played: 4, popular: 6 };
     WORK_ORDER = { title: 0, composer: 1, composed: 3, period: 4, performances: 5, popular: 9 };
+    toplevelNames = null;
+    __name(toplevelGenres, "toplevelGenres");
     __name(library2, "library");
     __name(focus, "focus");
     __name(tracks, "tracks");
@@ -49478,6 +49534,7 @@ __name(nowPlaying, "nowPlaying");
 init_intern();
 init_serializer();
 init_writer();
+init_signature();
 init_session();
 init_log();
 init_graph();
@@ -49935,6 +49992,8 @@ function stationRow(c, o) {
   if (field2(o, "IsInLibrary") === true) r.in_library = true;
   const img = imageKey(c, o);
   if (img) r.image = img;
+  const url2 = field2(obj(c, field2(o, "Image")), "Url");
+  if (typeof url2 === "string" && /^https?:/.test(url2)) r.image_url = url2;
   return r;
 }
 __name(stationRow, "stationRow");
@@ -50030,6 +50089,30 @@ async function playRadio(key, zoneName) {
   return { ok: true, ...r, ...await started2(r.zone, 0) };
 }
 __name(playRadio, "playRadio");
+async function radioFavorite(key, on) {
+  return withCore(async (c) => {
+    const st = await findStation(c, key);
+    const args = buildArgs([Arg.collection([buildArgs([Arg.ref(st.oid)])])]);
+    if (on) {
+      const res = await c.call("Radio", "AddToLibrary", [{ type: "IList<Channel>", name: "channels" }, { type: "ResultCallback", name: "cb_result" }], args, radioOid(c));
+      if (!res.success) throw new RoonError(`Roon refused (${res.status})`);
+    } else {
+      c.remoting.callMethodNoReply(radioOid(c), formatMethodSignature("Radio", "RemoveFromLibrary", [{ type: "IList<Channel>", name: "channels" }, { type: "ResultCallback", name: "cb_result" }]), args);
+    }
+    log(`radio_favorite: ${field2(st, "Name")} ${on ? "+" : "\u2212"}`);
+    await wait(800);
+    const id = hex3(field2(st, "ChannelId"));
+    const mine = await myStations(c).catch(() => null);
+    const now = mine ? mine.some((x) => hex3(field2(x, "ChannelId")) === id) : void 0;
+    return {
+      ok: now === void 0 || now === on,
+      station: field2(st, "Name"),
+      in_library: now ?? on,
+      note: now === void 0 ? "Roon said ok; it couldn't be read back" : now !== on ? "Roon said ok, but nothing changed" : void 0
+    };
+  });
+}
+__name(radioFavorite, "radioFavorite");
 
 // src/core/officialtools.ts
 init_errors();
@@ -50325,7 +50408,7 @@ function registerReadTools(server, internal = true) {
   }, () => run(() => internal ? nowPlaying() : nowPlaying2()));
   reg("roon_radio", {
     title: "Live Radio",
-    description: 'Roon\'s Live Radio directory. Without arguments: the user\'s own stations (`my_stations`) and the top categories (Music, News & Talk, Sports, Locations), each with a `key`. With `category` (a key): its sub-categories and stations. With `genre` (a category\'s name as written, e.g. "Jazz", "Classical"): stations of that genre. Stations carry a `key` for roon_play_radio, their location and `image`.',
+    description: 'Roon\'s Live Radio directory. Without arguments: the user\'s own stations (`my_stations`) and the top categories (Music, News & Talk, Sports, Locations), each with a `key`. With `category` (a key): its sub-categories and stations. With `genre` (a category\'s name as written, e.g. "Jazz", "Classical"): stations of that genre. Stations carry a `key` for roon_play_radio, their location, and their logo: `image_url` (a plain https picture) for the directory, `image` (a key at the Core) for an own station.',
     inputSchema: { category: external_exports.string().optional().describe("A category key from a previous answer."), genre: external_exports.string().optional().describe("A genre, as roon_radio names it (e.g. Jazz)."), limit: limit(100, 40) },
     annotations: READ
   }, ({ category, genre, limit: n }) => run(() => radio(category, genre, n ?? 40)));
@@ -50482,6 +50565,7 @@ init_writer();
 init_session();
 init_log();
 init_graph();
+init_focus();
 var localNow = /* @__PURE__ */ __name(() => {
   const d = /* @__PURE__ */ new Date(), t = /* @__PURE__ */ __name((n) => String(n).padStart(2, "0"), "t");
   return `${d.getFullYear()}-${t(d.getMonth() + 1)}-${t(d.getDate())}T${t(d.getHours())}:${t(d.getMinutes())}:${t(d.getSeconds())}`;
@@ -50526,14 +50610,25 @@ async function dailyPicks(perBox) {
   });
 }
 __name(dailyPicks, "dailyPicks");
-async function newForYou(limit3, offset2) {
+async function newForYou(limit3, offset2, genre) {
   return withCore(async (c) => {
     const res = await c.call("Library", "GetNewReleasesForYou", [{ type: "Sooid", name: "profileid" }, { type: "ResultCallback<DataList<AlbumWithExtras>>", name: "cb_result" }], buildArgs([Arg.sooid(c.profile())]), c.serviceOid("Library"));
     if (!res.success) throw new RoonError(`Roon refused New releases for you (${res.status})`);
-    const all = items(c, decoded2(c, res.payload));
+    let all = items(c, decoded2(c, res.payload));
+    await untilLoaded(c, all.map((x) => field2(x, "Album")).filter(isRef2), 4e3);
+    const top2 = await toplevelGenres(c);
+    const counts = /* @__PURE__ */ new Map();
+    for (const x of all) for (const n of new Set(strings(c, field2(obj(c, field2(x, "Album")), "Genres")))) if (top2.has(n)) counts.set(n, (counts.get(n) ?? 0) + 1);
+    const genres2 = [...counts].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([name, albums]) => ({ name, albums }));
+    if (genre) {
+      const g = genre.toLowerCase();
+      const names2 = /* @__PURE__ */ __name((x) => strings(c, field2(obj(c, field2(x, "Album")), "Genres")).map((n) => n.toLowerCase()), "names");
+      const exact = all.filter((x) => names2(x).includes(g));
+      all = exact.length ? exact : all.filter((x) => names2(x).some((n) => n.includes(g)));
+    }
     const part = all.slice(Math.max(0, offset2), Math.max(0, offset2) + Math.min(Math.max(1, limit3), 100));
     await untilLoaded(c, part.map((x) => field2(x, "Album")).filter(isRef2), 3e3);
-    return { total: all.length, offset: Math.max(0, offset2), rows: part.map((x) => {
+    return { total: all.length, offset: Math.max(0, offset2), genres: genres2, rows: part.map((x) => {
       const a = obj(c, field2(x, "Album"));
       if (!a || field2(a, "Title") === void 0) return null;
       const r = albumRow(c, a);
@@ -50567,10 +50662,43 @@ async function mixes() {
     const r = { key: mixKey(m), kind: gd && field2(gd, "GenreName") ? "genre" : "artist", name: mixName(c, m) };
     const ts = (obj(c, field2(pd ?? gd, "Touchstones"))?.fields?.$items ?? []).filter((x) => typeof x === "string").map(clean).slice(0, 8);
     if (ts.length) r.touchstones = ts;
+    const img = pd ? imageKey(c, pd, "Photo") ?? imageKey(c, pd, "Avatar") : void 0;
+    if (img) r.image = img;
+    const imgs = gd ? imageKeys(c, gd) : [];
+    if (imgs.length) r.images = imgs;
     return r;
   }) }));
 }
 __name(mixes, "mixes");
+async function mix(key, limit3) {
+  return withCore(async (c) => {
+    const all = await readMixes(c);
+    const m = all.find((x) => mixKey(x) === key) ?? all.find((x) => String(mixName(c, x)).toLowerCase() === key.toLowerCase());
+    if (!m?.oid) throw new RoonError("Unknown mix \u2014 read roon_mixes for today's keys", "not_found");
+    const res = await c.call("Mix", "GetItems", [{ type: "ResultCallback<DataList<MixItem>>", name: "cb_result" }], Buffer.alloc(0), m.oid);
+    if (!res.success) throw new RoonError(`Roon refused the mix (${res.status})`);
+    const its = items(c, decoded2(c, res.payload));
+    const refs = its.flatMap((it) => obj(c, field2(it, "Tracks"))?.fields?.$items ?? []);
+    await untilLoaded(c, refs, 3e3);
+    const tracks2 = its.flatMap((it) => items(c, field2(it, "Tracks"))).filter((t) => field2(t, "Title") !== void 0);
+    const pd = obj(c, field2(m, "PerformerMixDescription"));
+    const head = { key: mixKey(m), name: mixName(c, m) };
+    const img = pd ? imageKey(c, pd, "Photo") ?? imageKey(c, pd, "Avatar") : void 0;
+    if (img) head.image = img;
+    return { mix: head, total: tracks2.length, rows: tracks2.slice(0, Math.min(Math.max(1, limit3), 300)).map((t, i) => {
+      const al = obj(c, field2(t, "Album"));
+      const r = { n: i + 1, key: String(field2(t, "TrackId") ?? ""), title: field2(t, "Title") ?? "", artist: clean(field2(al, "PerformedBy") ?? field2(t, "PerformedBy") ?? ""), album: field2(al, "Title") ?? void 0 };
+      const ak = field2(al, "AlbumId");
+      if (ak !== void 0 && ak !== null) r.album_key = String(ak);
+      const l = field2(t, "LengthSeconds");
+      if (typeof l === "number" && l > 0) r.length = duration3(l);
+      const im = imageKey(c, al);
+      if (im) r.image = im;
+      return r;
+    }) };
+  });
+}
+__name(mix, "mix");
 async function playMix(key, zoneName, how) {
   const p = PRIORITY[how];
   const r = await withCore(async (c) => {
@@ -50660,6 +50788,10 @@ async function playlists(shelfName, genre, mood, limit3, offset2) {
       const key = playlistKey(p);
       seen.set(key, w);
       const r = { key, name: String(field2(p, "Name") ?? "").trim() };
+      const imgs = imageKeys(c, p);
+      if (imgs.length) r.images = imgs;
+      const urls = imageUrls(c, p);
+      if (urls.length) r.image_urls = urls;
       const d = field2(p, "Description");
       if (d) r.description = clean(d).replace(/\s+/g, " ").trim().slice(0, 240);
       const n = field2(p, "TrackCount") ?? field2(p, "ItemCount");
@@ -50705,13 +50837,24 @@ async function findPlaylist2(c, key) {
 }
 __name(findPlaylist2, "findPlaylist");
 async function playlists2() {
-  return withCore(async (c) => ({ playlists: allPlaylists(c).list.map((p) => ({
-    key: playlistKey(p),
-    name: field2(p, "Name") ?? "",
-    kind: PLAYLIST_KIND[field2(p, "Type")] ?? String(field2(p, "Type") ?? ""),
-    tracks: field2(p, "TrackCount") ?? field2(p, "ItemCount") ?? void 0,
-    read_only: field2(p, "IsReadOnly") === true || void 0
-  })) }));
+  return withCore(async (c) => ({ playlists: allPlaylists(c).list.map((p) => {
+    const r = {
+      key: playlistKey(p),
+      name: field2(p, "Name") ?? "",
+      kind: PLAYLIST_KIND[field2(p, "Type")] ?? String(field2(p, "Type") ?? ""),
+      tracks: field2(p, "TrackCount") ?? field2(p, "ItemCount") ?? void 0,
+      read_only: field2(p, "IsReadOnly") === true || void 0
+    };
+    const imgs = imageKeys(c, p);
+    if (imgs.length) r.images = imgs;
+    const l = field2(p, "LengthSeconds");
+    if (typeof l === "number" && l > 0) r.length = duration3(l);
+    const names2 = (obj(c, field2(p, "SampleArtistNames"))?.fields?.$items ?? []).filter((x) => typeof x === "string").slice(0, 4);
+    if (names2.length) r.artists = names2;
+    const d = field2(p, "Description");
+    if (d) r.description = clean(d).replace(/\s+/g, " ").slice(0, 240);
+    return r;
+  }) }));
 }
 __name(playlists2, "playlists");
 async function playlist(key, limit3) {
@@ -50731,7 +50874,14 @@ async function playlist(key, limit3) {
     return { name: field2(p, "Name"), total: list.length, rows: list.slice(0, n).map((x, i) => {
       const tr = obj(c, field2(obj(c, x), "Track"));
       const al = obj(c, field2(tr, "Album"));
-      return { n: i + 1, key: String(field2(tr, "TrackId") ?? ""), title: field2(tr, "Title") ?? null, artist: clean(field2(al, "PerformedBy") ?? ""), album: field2(al, "Title") ?? void 0 };
+      const r = { n: i + 1, key: String(field2(tr, "TrackId") ?? ""), title: field2(tr, "Title") ?? null, artist: clean(field2(al, "PerformedBy") ?? ""), album: field2(al, "Title") ?? void 0 };
+      const ak = field2(al, "AlbumId");
+      if (ak !== void 0 && ak !== null) r.album_key = String(ak);
+      const im = imageKey(c, al);
+      if (im) r.image = im;
+      const l = field2(tr, "LengthSeconds");
+      if (typeof l === "number" && l > 0) r.length = duration3(l);
+      return r;
     }) };
   });
 }
@@ -51248,6 +51398,10 @@ var FOCUS = {
   picks: external_exports.boolean().optional().describe("Roon's own picks."),
   text: external_exports.string().optional().describe("A word in the title or artist."),
   favorites: external_exports.boolean().optional(),
+  sample_rate: external_exports.string().optional().describe('Sample rates in kHz, comma-separated: "44.1, 96".'),
+  bits: external_exports.string().optional().describe('Bit depths, comma-separated: "16, 24".'),
+  mqa: external_exports.boolean().optional(),
+  storage: external_exports.enum(["tidal", "qobuz", "local"]).optional().describe("Where the albums live."),
   played_within_days: days,
   not_played_within_days: days,
   added_within_days: days
@@ -51336,12 +51490,18 @@ function registerLibraryTools(server) {
     inputSchema: { limit: limit2(30, 8) },
     annotations: READ2
   }, ({ limit: n }) => run(() => dailyPicks(n ?? 8)));
+  server.registerTool("roon_mix", {
+    title: "A Daily Mix's tracks",
+    description: "The tracks inside one of Roon's Daily Mixes (by `key` or name from roon_mixes), as Roon's mix page shows them before playing \u2014 each with a `key` for roon_play_tracks. To play the whole mix, roon_play_mix.",
+    inputSchema: { key: external_exports.string().describe("A mix key or its name, from roon_mixes."), limit: limit2(300, 100) },
+    annotations: READ2
+  }, ({ key, limit: n }) => run(() => mix(key, n ?? 100)));
   server.registerTool("roon_new_for_you", {
     title: "New releases for you",
-    description: '"New releases for you" from Roon\'s Home: new albums Roon picked for this user, from the artists and music they listen to \u2014 personal, unlike roon_new (the streaming services\' editorial shelf, the same for everyone). Use it for "my new releases", "what\'s new for me". Albums carry year, format, sometimes a `review`, and a `key`.',
-    inputSchema: { limit: limit2(100, 30), offset },
+    description: '"New releases for you" from Roon\'s Home: new albums Roon picked for this user, from the artists and music they listen to \u2014 personal, unlike roon_new (the streaming services\' editorial shelf, the same for everyone). Use it for "my new releases", "what\'s new for me". Albums carry year, format, `genres`, sometimes a `review`, and a `key`; `genres` at the top counts the shelf\'s top-level genres (the choices for `genre`).',
+    inputSchema: { limit: limit2(100, 30), offset, genre: external_exports.string().optional().describe("Only albums of this genre (a Roon genre name, e.g. Jazz; sub-genres match too).") },
     annotations: READ2
-  }, ({ limit: n, offset: o }) => run(() => newForYou(n ?? 30, o ?? 0)));
+  }, ({ limit: n, offset: o, genre }) => run(() => newForYou(n ?? 30, o ?? 0, genre)));
   server.registerTool("roon_mixes", {
     title: "Daily Mixes",
     description: 'Roon\'s own Daily Mixes, from Roon\'s Home \u2014 NOT TIDAL\'s mixes: for "TIDAL mixes", "My Mix", "My Daily Discovery" or TIDAL\'s daily mixes use roon_tidal_playlists with `shelf: "my_mixes"`. These are today\'s personal Roon mixes, each built around an artist (or genre) the user listens to, with a few `touchstones` and a `key` for roon_play_mix. They change every day.',
@@ -51396,6 +51556,12 @@ function registerLibraryTools(server) {
     inputSchema: { source: external_exports.enum(["roon", "qobuz", "tidal"]).optional(), limit: limit2(100, 50) },
     annotations: READ2
   }, ({ source, limit: n }) => run(() => favorites(source ?? "roon", n ?? 50)));
+  server.registerTool("roon_radio_favorite", {
+    title: "A station in My Live Radio",
+    description: "Put a Live Radio station in the user's own list (My Live Radio), or take it out (`on: false`). The `key` comes from roon_radio. Changes the user's library: only on an explicit request. Reads the result back.",
+    inputSchema: { key: external_exports.string(), on: external_exports.boolean().optional() },
+    annotations: CHANGES
+  }, ({ key, on }) => run(() => radioFavorite(key, on !== false)));
   server.registerTool("roon_favorite", {
     title: "Heart an album or track",
     description: "Put a heart on an album or a track in Roon, or take it off (`on: false`). The `key` comes from a search, shelf, album or playlist result. Changes the user's library: only on an explicit request. Reads the heart back and says if Roon didn't change it.",
@@ -51499,7 +51665,39 @@ async function runSelfTest() {
 __name(runSelfTest, "runSelfTest");
 
 // src/tools/status.ts
+init_session();
+function registerDebugTool(server) {
+  server.registerTool("roon_debug", {
+    title: "Graph fields (development)",
+    description: "Development only: without `type`, the graph's type names with counts (`match` narrows); with `type`, the first `limit` objects of that type with their fields.",
+    inputSchema: { type: external_exports.string().optional(), match: external_exports.string().optional(), limit: external_exports.number().int().min(1).max(200).optional() },
+    annotations: { readOnlyHint: true }
+  }, ({ type, match, limit: limit3 }) => run(() => withCore(async (c) => {
+    const preview = /* @__PURE__ */ __name((v) => {
+      if (v && typeof v === "object" && "$ref" in v) {
+        const o = c.graph.getObject(v.$ref);
+        return { $ref: String(v.$ref), type: o?.typeName };
+      }
+      if (Array.isArray(v)) return v.slice(0, 3).map(preview);
+      if (v && typeof v === "object") return Object.fromEntries(Object.entries(v).slice(0, 6).map(([k, x]) => [k, preview(x)]));
+      return typeof v === "string" ? v.slice(0, 80) : typeof v === "bigint" ? String(v) : v;
+    }, "preview");
+    if (!type) {
+      const counts = /* @__PURE__ */ new Map();
+      for (const o of c.graph.objects.values()) counts.set(o.typeName, (counts.get(o.typeName) ?? 0) + 1);
+      return { types: [...counts].filter(([n]) => !match || n.toLowerCase().includes(match.toLowerCase())).sort((a, b) => b[1] - a[1]).map(([name, n]) => ({ name, n })) };
+    }
+    const all = c.graph.findByType(type);
+    return { count: all.length, objects: all.slice(0, limit3 ?? 3).map((o) => ({
+      oid: String(o.oid),
+      type: o.typeName,
+      fields: Object.fromEntries(Object.entries(o.fields ?? {}).map(([k, v]) => [k.replace(/^.*::/, ""), preview(v)]))
+    })) };
+  })));
+}
+__name(registerDebugTool, "registerDebugTool");
 function registerStatusTool(server, internal) {
+  if (process.env.DEEP_ROON_DEBUG === "1") registerDebugTool(server);
   server.registerTool("roon_status", {
     title: "Deep Roon MCP status",
     description: "How Deep Roon MCP stands: its version (and whether a newer one is out), the Roon Core it talks to, whether it is enabled in Roon (Settings \u203A Extensions), whether Roon's internal protocol works, and a self-test of a few reads with the tools each one stands for. Use it when a tool fails, or when the user asks whether everything works.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deep-roon-mcp",
-  "version": "0.4.0",
+  "version": "0.4.5",
   "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>",