deep-roon-mcp 0.4.0 → 0.4.6

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-nine tools. Qobuz, TIDAL or both — whatever is signed in on your Core.
 
 **Reading** — changes nothing in Roon:
 
@@ -32,6 +32,7 @@ Version 0.4: fifty-six tools. Qobuz, TIDAL or both — whatever is signed in on
 | `roon_new` | Qobuz's shelves (new, qobuzissimes, press awards, top, trending, ideal discography) or TIDAL's (new, recommended, top, rising, masters; albums or tracks) — by genre |
 | `roon_genres` | Qobuz's genres and their ids, or TIDAL's genres and moods |
 | `roon_album` | An album's page: tracks, release dates, label, barcode, credits |
+| `roon_track_files` | Where your own files are: per track of an album, an artist or a list of tracks, the file path as the Core sees it (and duplicates) — Roon's export data |
 | `roon_review` | The review Roon shows, in full, with its author |
 | `roon_bio` | The biography Roon shows, in full, with related artists |
 | `roon_artist` | An artist's discography at Qobuz or TIDAL, oldest first |
@@ -88,6 +89,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 +109,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-nine, 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.6";
   }
 });
 
@@ -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");
@@ -16413,6 +16426,71 @@ async function discography(key, wanted) {
     return { service: SERVICE_NAME[service2], artist, albums };
   });
 }
+async function trackFiles(a) {
+  return withCore(async (c) => {
+    const cb = { type: "ResultCallback<IList<TrackExportInfo>>", name: "cb_result" };
+    let res;
+    if (a.tracks?.length) {
+      if (a.tracks.some((k) => !/^\d+$/.test(k))) throw new RoonError("A track key is a number", "invalid");
+      res = await short(c.call(
+        "Library",
+        "GetTrackExportInfo",
+        [{ type: "IEnumerable<long>", name: "ids" }, cb],
+        buildArgs([Arg.collection(a.tracks.map((k) => buildArgs([Arg.long(BigInt(k))])))]),
+        library(c)
+      ), 2e4);
+    } else if (a.album) {
+      const al = await findAlbum(c, a.album);
+      res = await short(c.call(
+        "Library",
+        "GetTrackExportInfoForAlbums",
+        [{ type: "IEnumerable<AlbumBase>", name: "albums" }, cb],
+        buildArgs([Arg.collection([buildArgs([Arg.ref(al.oid)])])]),
+        library(c)
+      ), 2e4);
+    } else if (a.artist) {
+      const p = await performer(c, a.artist);
+      res = await short(c.call(
+        "Library",
+        "GetTrackExportInfoForPerformers",
+        [{ type: "IEnumerable<PerformerBase>", name: "performers" }, cb],
+        buildArgs([Arg.collection([buildArgs([Arg.ref(p.$ref)])])]),
+        library(c)
+      ), 3e4);
+    } else throw new RoonError("Give an album key, an artist key or track keys", "invalid");
+    if (!res?.success) throw new RoonError(`Roon refused the file list (${res?.status ?? "no answer"})`);
+    if (res.payload.length < 2) return { tracks: [] };
+    const r = new BinaryReader(Uint8Array.from(res.payload));
+    r.integer();
+    const n = r.flexInt();
+    const graph = c.graph;
+    const infos = [];
+    for (let i = 0; i < n && r.remaining > 0; i++) infos.push(graph.readValue(r, 23));
+    await untilLoaded(c, infos.map((x) => field2(x, "Track")).filter(isRef2), 3e3);
+    const paden = /* @__PURE__ */ __name((x) => items(c, field2(x, "DuplicateTracks")).map((d) => field2(d, "FilePath")).filter((p) => typeof p === "string" && !!p), "paden");
+    const tracks2 = infos.map((x) => {
+      const t = obj(c, field2(x, "Track"));
+      const row = { key: String(field2(t, "TrackId") ?? "") };
+      const title = field2(t, "Title");
+      if (title) row.title = title;
+      const al = field2(obj(c, field2(t, "Album")), "Title");
+      if (al) row.album = al;
+      const n2 = field2(t, "TrackNumber");
+      if (n2 != null) row.n = n2;
+      const path2 = field2(x, "FilePath");
+      if (typeof path2 === "string" && path2) row.path = path2;
+      const format = field2(t, "Format");
+      if (format) row.format = format;
+      const dup = paden(x);
+      if (dup.length) row.duplicates = dup;
+      return row;
+    });
+    const gevraagd = a.tracks?.length ?? 0, ontbreekt = gevraagd ? gevraagd - tracks2.length : 0;
+    const zonder = tracks2.filter((t) => !t.path).length + Math.max(0, ontbreekt);
+    const of = gevraagd || tracks2.length;
+    return { tracks: tracks2, ...zonder ? { note: `${zonder} of ${of} ${of === 1 ? "track" : "tracks"} ${zonder === 1 ? "has" : "have"} no file (streaming tracks, or not on this Core's storage)` } : {} };
+  });
+}
 var SERVICE_NAME, SERVICE_TYPE, NONE2, SECTIONS, library, CREDIT_KIND, cut, choose;
 var init_library = __esm({
   "src/roon/library.ts"() {
@@ -16469,6 +16547,7 @@ var init_library = __esm({
     __name(performer, "performer");
     __name(bio, "bio");
     __name(discography, "discography");
+    __name(trackFiles, "trackFiles");
   }
 });
 
@@ -16478,6 +16557,7 @@ __export(focus_exports, {
   artists: () => artists,
   focus: () => focus,
   library: () => library2,
+  toplevelGenres: () => toplevelGenres,
   tracks: () => tracks,
   work: () => work,
   works: () => works
@@ -16576,6 +16656,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 +16709,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 +16764,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 +16791,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 +16829,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 +16897,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 +16947,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 +49600,7 @@ __name(nowPlaying, "nowPlaying");
 init_intern();
 init_serializer();
 init_writer();
+init_signature();
 init_session();
 init_log();
 init_graph();
@@ -49935,6 +50058,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 +50155,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();
@@ -50293,6 +50442,16 @@ function registerReadTools(server, internal = true) {
     inputSchema: { key: external_exports.string().describe("An album key."), credits: external_exports.boolean().optional() },
     annotations: READ
   }, ({ key, credits }) => run(() => album(key, credits === true)));
+  reg("roon_track_files", {
+    title: "File paths",
+    description: "Where the user's own music files are: for an album (`album` key), an artist (`artist` key, all their tracks in the library) or a list of `tracks` keys, each track with its `key`, title, album, track number, format and `path` \u2014 the file as the Roon Core sees it (on the Core's storage), plus `duplicates` when Roon has the same track twice. The data behind Roon's own Export. Use it to link Roon's tracks to files, e.g. to join with data the user keeps per file. Streaming tracks (Qobuz, TIDAL) have no path.",
+    inputSchema: {
+      album: external_exports.string().optional().describe("An album key."),
+      artist: external_exports.string().optional().describe("An artist key."),
+      tracks: external_exports.array(external_exports.string()).max(500).optional().describe("Track keys.")
+    },
+    annotations: READ
+  }, ({ album: album2, artist, tracks: tracks2 }) => run(() => trackFiles({ album: album2, artist, tracks: tracks2 })));
   reg("roon_review", {
     title: "Album review",
     description: "The review Roon shows on an album's page, in full, with its author \u2014 by album `key`. When the user asks for the review (\"what does Roon say about this album\", \"show me the review\"), they want to read the review itself: show the text complete and exactly as returned, as a quote with the author's name \u2014 no paraphrase or shortening unless they ask for a summary, and don't go to the web for it. `wikipedia: true` adds the album's Wikipedia text; it also comes by itself when Roon has no review of its own. `max_chars` only when a shorter excerpt is asked for.",
@@ -50325,7 +50484,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 +50641,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 +50686,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 +50738,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 +50864,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 +50913,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 +50950,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 +51474,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 +51566,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 +51632,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 +51741,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.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>",