deep-roon-mcp 0.3.8 → 0.4.5

package/dist/deep-roon-mcp.js

@@ -3635,12 +3635,12 @@ var require_utils = __commonJS({
       let output2 = "";
       for (let i = 0; i < input2.length; i++) {
         if (input2[i] === "%" && i + 2 < input2.length) {
-          const hex3 = input2.slice(i + 1, i + 3);
-          if (isHexPair(hex3)) {
-            const normalizedHex = hex3.toUpperCase();
-            const decoded3 = String.fromCharCode(parseInt(normalizedHex, 16));
-            if (decodeUnreserved && isUnreserved(decoded3)) {
-              output2 += decoded3;
+          const hex4 = input2.slice(i + 1, i + 3);
+          if (isHexPair(hex4)) {
+            const normalizedHex = hex4.toUpperCase();
+            const decoded4 = String.fromCharCode(parseInt(normalizedHex, 16));
+            if (decodeUnreserved && isUnreserved(decoded4)) {
+              output2 += decoded4;
             } else {
               output2 += "%" + normalizedHex;
             }
@@ -3658,12 +3658,12 @@ var require_utils = __commonJS({
       for (let i = 0; i < input2.length; i++) {
         const ch = input2[i];
         if (ch === "%" && i + 2 < input2.length) {
-          const hex3 = input2.slice(i + 1, i + 3);
-          if (isHexPair(hex3)) {
-            const normalizedHex = hex3.toUpperCase();
-            const decoded3 = String.fromCharCode(parseInt(normalizedHex, 16));
-            if (decoded3 !== "." && isUnreserved(decoded3)) {
-              output2 += decoded3;
+          const hex4 = input2.slice(i + 1, i + 3);
+          if (isHexPair(hex4)) {
+            const normalizedHex = hex4.toUpperCase();
+            const decoded4 = String.fromCharCode(parseInt(normalizedHex, 16));
+            if (decoded4 !== "." && isUnreserved(decoded4)) {
+              output2 += decoded4;
             } else {
               output2 += "%" + normalizedHex;
             }
@@ -3701,9 +3701,9 @@ var require_utils = __commonJS({
       for (let i = 0; i < input2.length; i++) {
         const ch = input2[i];
         if (ch === "%" && i + 2 < input2.length) {
-          const hex3 = input2.slice(i + 1, i + 3);
-          if (isHexPair(hex3)) {
-            output2 += "%" + hex3.toUpperCase();
+          const hex4 = input2.slice(i + 1, i + 3);
+          if (isHexPair(hex4)) {
+            output2 += "%" + hex4.toUpperCase();
             i += 2;
             continue;
           }
@@ -3740,9 +3740,9 @@ var require_utils = __commonJS({
       for (let i = 0; i < input2.length; i++) {
         const ch = input2[i];
         if (ch === "%" && i + 2 < input2.length) {
-          const hex3 = input2.slice(i + 1, i + 3);
-          if (isHexPair(hex3)) {
-            output2 += "%" + hex3.toUpperCase();
+          const hex4 = input2.slice(i + 1, i + 3);
+          if (isHexPair(hex4)) {
+            output2 += "%" + hex4.toUpperCase();
             i += 2;
             continue;
           }
@@ -3792,12 +3792,12 @@ var require_utils = __commonJS({
       for (let i = 0; i < input2.length; i++) {
         const ch = input2[i];
         if (ch === "%" && i + 2 < input2.length) {
-          const hex3 = input2.slice(i + 1, i + 3);
-          if (isHexPair(hex3)) {
-            const normalizedHex = hex3.toUpperCase();
-            const decoded3 = String.fromCharCode(parseInt(normalizedHex, 16));
-            if (isUnreserved(decoded3)) {
-              output2 += decoded3;
+          const hex4 = input2.slice(i + 1, i + 3);
+          if (isHexPair(hex4)) {
+            const normalizedHex = hex4.toUpperCase();
+            const decoded4 = String.fromCharCode(parseInt(normalizedHex, 16));
+            if (isUnreserved(decoded4)) {
+              output2 += decoded4;
             } else {
               output2 += "%" + normalizedHex;
             }
@@ -3833,9 +3833,9 @@ var require_utils = __commonJS({
       let output2 = "";
       for (let i = 0; i < input2.length; i++) {
         if (input2[i] === "%" && i + 2 < input2.length) {
-          const hex3 = input2.slice(i + 1, i + 3);
-          if (isHexPair(hex3)) {
-            output2 += "%" + hex3.toUpperCase();
+          const hex4 = input2.slice(i + 1, i + 3);
+          if (isHexPair(hex4)) {
+            output2 += "%" + hex4.toUpperCase();
             i += 2;
             continue;
           }
@@ -9225,24 +9225,24 @@ function editField(info, fieldSuffix, list = false) {
   const metadataValue = list ? decodeStringList(rawMeta) : rawMeta;
   return { value, metadataValue, edited: member(wrapper, "::HasEditLayer") === true };
 }
-function parseAlbumEditInfo(decoded3) {
+function parseAlbumEditInfo(decoded4) {
   return {
-    title: editField(decoded3, "Title"),
-    version: editField(decoded3, "Version"),
-    performedBy: editField(decoded3, "PerformedBy"),
-    genres: editField(decoded3, "Genres", true),
-    labels: editField(decoded3, "Labels", true),
-    rating: editField(decoded3, "Rating"),
-    type: editField(decoded3, "Type"),
-    isCompilation: editField(decoded3, "IsCompilation"),
-    isLive: editField(decoded3, "IsLive"),
-    isPick: editField(decoded3, "IsPick"),
-    containsExplicitContent: editField(decoded3, "ContainsExplicitContent"),
-    isUserHidden: editField(decoded3, "IsUserHidden"),
-    country: editField(decoded3, "Country"),
-    catalogNumber: editField(decoded3, "CatalogNumber"),
-    productCode: editField(decoded3, "ProductCode"),
-    raw: decoded3
+    title: editField(decoded4, "Title"),
+    version: editField(decoded4, "Version"),
+    performedBy: editField(decoded4, "PerformedBy"),
+    genres: editField(decoded4, "Genres", true),
+    labels: editField(decoded4, "Labels", true),
+    rating: editField(decoded4, "Rating"),
+    type: editField(decoded4, "Type"),
+    isCompilation: editField(decoded4, "IsCompilation"),
+    isLive: editField(decoded4, "IsLive"),
+    isPick: editField(decoded4, "IsPick"),
+    containsExplicitContent: editField(decoded4, "ContainsExplicitContent"),
+    isUserHidden: editField(decoded4, "IsUserHidden"),
+    country: editField(decoded4, "Country"),
+    catalogNumber: editField(decoded4, "CatalogNumber"),
+    productCode: editField(decoded4, "ProductCode"),
+    raw: decoded4
   };
 }
 var ROOT_SERVICE_GUID, RoonClient, ALBUM_EDIT, EDIT_OPTIONAL_VAL_INT, EDIT_REQUIRED_REF_STR, EDIT_LIST_STR, LIBRARY_EDIT;
@@ -9532,14 +9532,14 @@ var init_client = __esm({
        *   VirtualAlbumLiteQuery oid -> RetainPage(0) -> items push.
        */
       async searchAlbums(term, pageSize = 40) {
-        const criteria = this.structArg("Sooloos.Broker.Api.AlbumQueryCriteria", [
+        const criteria2 = this.structArg("Sooloos.Broker.Api.AlbumQueryCriteria", [
           { name: "UiLanguage", propType: 20 /* String */, value: new BinaryWriter().string("en").toBuffer() },
           { name: "TextFilter", propType: 20 /* String */, value: new BinaryWriter().string(term).toBuffer() }
         ]);
         const params = this.structArg("Sooloos.Broker.Api.VirtualQueryParameters", [
           { name: "PageSize", propType: 0 /* Int */, value: new BinaryWriter().integer(pageSize).toBuffer() }
         ]);
-        const args = Buffer.concat([buildArgs([Arg.sooid(this.profile())]), criteria, params]);
+        const args = Buffer.concat([buildArgs([Arg.sooid(this.profile())]), criteria2, params]);
         const res = await this.call(
           "Library",
           "VirtualAlbumQuery",
@@ -9716,8 +9716,8 @@ var init_client = __esm({
           this.serviceOid("Library")
         );
         if (!res.success) throw new Error(`GetAlbumEditInfo failed: ${res.status}`);
-        const decoded3 = this.graph.decodeReturnValue(Uint8Array.from(res.payload));
-        return parseAlbumEditInfo(decoded3);
+        const decoded4 = this.graph.decodeReturnValue(Uint8Array.from(res.payload));
+        return parseAlbumEditInfo(decoded4);
       }
       // --- metadata editing: write side (Phase E) ---
       /**
@@ -9913,7 +9913,7 @@ async function exportPlayHistory(client2, options) {
   if (client2.graph.findByType("HistoryPlay").length > 0) {
     throw new Error("history export requires a fresh client graph with no HistoryPlay objects");
   }
-  const criteria = inlineStruct(
+  const criteria2 = inlineStruct(
     client2.remoting.defineType("Sooloos.Broker.Api.HistoryQueryCriteria", [])
   );
   const params = client2.structArg("Sooloos.Broker.Api.VirtualQueryParameters", [
@@ -9923,7 +9923,7 @@ async function exportPlayHistory(client2, options) {
       value: new BinaryWriter().integer(pageSize).toBuffer()
     }
   ]);
-  const args = Buffer.concat([buildArgs([Arg.sooid(client2.profile())]), criteria, params]);
+  const args = Buffer.concat([buildArgs([Arg.sooid(client2.profile())]), criteria2, params]);
   const result = await client2.call(
     "Library",
     "VirtualHistoryQuery",
@@ -13953,9 +13953,9 @@ function coreInfo(host, port = 9330, ms = 5e3) {
   });
 }
 function brokerId(coreId) {
-  const hex3 = coreId.replace(/-/g, "");
-  if (!/^[0-9a-f]{32}$/i.test(hex3)) throw new Error(`not a Roon core_id: ${coreId}`);
-  const b = Buffer.from(hex3, "hex");
+  const hex4 = coreId.replace(/-/g, "");
+  if (!/^[0-9a-f]{32}$/i.test(hex4)) throw new Error(`not a Roon core_id: ${coreId}`);
+  const b = Buffer.from(hex4, "hex");
   return Buffer.concat([Buffer.from(b.subarray(0, 4)).reverse(), Buffer.from(b.subarray(4, 6)).reverse(), Buffer.from(b.subarray(6, 8)).reverse(), b.subarray(8)]);
 }
 var import_dgram, import_crypto, ROON_SERVICE_ID, SOOD_PORT;
@@ -15525,7 +15525,7 @@ var require_lib2 = __commonJS({
 var version2;
 var init_package = __esm({
   "package.json"() {
-    version2 = "0.3.8";
+    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");
@@ -16207,7 +16220,7 @@ async function findAlbum(c, key) {
   }
   throw new RoonError(`Roon knows no album with key ${key}`, "not_found");
 }
-async function findTracks(c, keys) {
+async function findTracks(c, keys, lenient = false) {
   const look = /* @__PURE__ */ __name(() => {
     const all = [...c.graph.objects.values()].filter((o) => /\.Track(Lite)?$/.test(o.typeName) && field2(o, "Title") !== void 0);
     return keys.map((k) => all.find((o) => String(field2(o, "TrackId") ?? "") === k));
@@ -16227,6 +16240,7 @@ async function findTracks(c, keys) {
     tracks2 = look();
   }
   const gone = keys.filter((_, i) => !tracks2[i]);
+  if (gone.length && lenient) return tracks2;
   if (gone.length) throw new RoonError(`Roon doesn't know ${gone.length} of the ${keys.length} tracks (keys ${gone.join(", ")})`, "not_found");
   return tracks2;
 }
@@ -16477,6 +16491,7 @@ __export(focus_exports, {
   artists: () => artists,
   focus: () => focus,
   library: () => library2,
+  toplevelGenres: () => toplevelGenres,
   tracks: () => tracks,
   work: () => work,
   works: () => works
@@ -16486,13 +16501,13 @@ async function virtualQuery(c, kind, members2, limit3, offset2, row) {
   const missing = members2.find((f) => !schema.some((m) => m.shortName === f.name));
   if (missing) throw new RoonError(`The filter ${missing.name} doesn't exist for ${kind.toLowerCase()}s in this Roon version`, "invalid");
   const size = Math.min(Math.max(1, limit3), 100), page = Math.floor(Math.max(0, offset2) / size);
-  const criteria = c.structArg(`Sooloos.Broker.Api.${kind}QueryCriteria`, [english(), ...members2]);
+  const criteria2 = c.structArg(`Sooloos.Broker.Api.${kind}QueryCriteria`, [english(), ...members2]);
   const params = c.structArg("Sooloos.Broker.Api.VirtualQueryParameters", [{ name: "PageSize", propType: 0, value: new BinaryWriter().integer(size).toBuffer() }]);
   const res = await c.call(
     "Library",
     `Virtual${kind}Query`,
     [{ type: "Sooid", name: "profileid" }, { type: `${kind}QueryCriteria`, name: "criteria" }, { type: "VirtualQueryParameters", name: "queryparams" }, { type: `ResultCallback<Virtual${kind}LiteQuery>`, name: "cb_result" }],
-    Buffer.concat([buildArgs([Arg.sooid(c.profile())]), criteria, params]),
+    Buffer.concat([buildArgs([Arg.sooid(c.profile())]), criteria2, params]),
     c.serviceOid("Library")
   );
   if (!res.success) throw new RoonError(`Roon refused the ${kind.toLowerCase()} query (${res.status})`);
@@ -16527,12 +16542,12 @@ async function virtualQuery(c, kind, members2, limit3, offset2, row) {
   }
 }
 async function albumInfo(c, members2) {
-  const criteria = c.structArg("Sooloos.Broker.Api.AlbumQueryCriteria", [english(), ...members2]);
+  const criteria2 = c.structArg("Sooloos.Broker.Api.AlbumQueryCriteria", [english(), ...members2]);
   const res = await c.call(
     "Library",
     "GetAlbumQueryInfo",
     [{ type: "Sooid", name: "profileid" }, { type: "AlbumQueryCriteria", name: "criteria" }, { type: "ResultCallback<AlbumQueryInfo>", name: "cb_result" }],
-    Buffer.concat([buildArgs([Arg.sooid(c.profile())]), criteria]),
+    Buffer.concat([buildArgs([Arg.sooid(c.profile())]), criteria2]),
     c.serviceOid("Library")
   );
   if (!res.success) throw new RoonError(`Roon refused the Focus panel (${res.status})`);
@@ -16575,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"));
@@ -16606,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 };
   });
@@ -16651,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 };
+      })
     };
   });
 }
@@ -16672,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 };
   });
@@ -16710,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) {
@@ -16776,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";
@@ -16826,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");
@@ -17751,14 +17808,14 @@ function isValidJWT(jwt2, alg) {
     if (!header)
       return false;
     const base643 = header.replace(/-/g, "+").replace(/_/g, "/").padEnd(header.length + (4 - header.length % 4) % 4, "=");
-    const decoded3 = JSON.parse(atob(base643));
-    if (typeof decoded3 !== "object" || decoded3 === null)
+    const decoded4 = JSON.parse(atob(base643));
+    if (typeof decoded4 !== "object" || decoded4 === null)
       return false;
-    if ("typ" in decoded3 && decoded3?.typ !== "JWT")
+    if ("typ" in decoded4 && decoded4?.typ !== "JWT")
       return false;
-    if (!decoded3.alg)
+    if (!decoded4.alg)
       return false;
-    if (alg && decoded3.alg !== alg)
+    if (alg && decoded4.alg !== alg)
       return false;
     return true;
   } catch {
@@ -21983,8 +22040,8 @@ function uint8ArrayToBase64url(bytes) {
   return uint8ArrayToBase64(bytes).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
 }
 __name(uint8ArrayToBase64url, "uint8ArrayToBase64url");
-function hexToUint8Array(hex3) {
-  const cleanHex = hex3.replace(/^0x/, "");
+function hexToUint8Array(hex4) {
+  const cleanHex = hex4.replace(/^0x/, "");
   if (cleanHex.length % 2 !== 0) {
     throw new Error("Invalid hex string length");
   }
@@ -49295,22 +49352,32 @@ init_library();
 init_intern();
 init_session();
 init_graph();
+init_library();
 async function history(limit3) {
   return withCore(async (first) => {
     const c = first.graph.findByType("HistoryPlay").length > 0 ? await fresh() : first;
     const out = await exportPlayHistory(c, { limit: Math.min(Math.max(0, limit3), 500) });
+    const keys = [...new Set(out.events.map((e) => e.roonTrackId).filter((k) => !!k))].slice(0, 100);
+    const byKey = /* @__PURE__ */ new Map();
+    if (keys.length) {
+      const tracks2 = await findTracks(c, keys, true).catch(() => []);
+      for (const t of tracks2) if (t) byKey.set(String(field2(t, "TrackId")), t);
+    }
     closeSoon("after the history");
     return {
       total: out.total ?? null,
-      plays: out.events.map((e) => ({
-        at: localTime(e.playedAt),
-        title: e.title,
-        artist: clean(e.artist),
-        album: e.album ?? void 0,
-        played_pct: e.completionPct ?? void 0,
-        track_key: e.roonTrackId ?? void 0
-      }))
-      // for roon_play_tracks (13 Oct 2026, Rosso's history)
+      plays: out.events.map((e) => {
+        const r = { at: localTime(e.playedAt), title: e.title, artist: clean(e.artist), album: e.album ?? void 0, played_pct: e.completionPct ?? void 0, track_key: e.roonTrackId ?? void 0 };
+        const t = e.roonTrackId ? byKey.get(e.roonTrackId) : void 0;
+        if (t) {
+          const al = obj(c, field2(t, "Album"));
+          const ak = field2(al, "AlbumId");
+          if (ak !== void 0 && ak !== null) r.album_key = String(ak);
+          const img = imageKey(c, al);
+          if (img) r.image = img;
+        }
+        return r;
+      })
     };
   });
 }
@@ -49463,312 +49530,14 @@ async function nowPlaying() {
 }
 __name(nowPlaying, "nowPlaying");
 
-// src/core/officialtools.ts
-init_errors();
-init_official();
-var call = /* @__PURE__ */ __name((fn) => new Promise((res, rej) => fn((err) => err ? rej(new RoonError(`Roon refused: ${err}`)) : res())), "call");
-var duration4 = /* @__PURE__ */ __name((s) => {
-  const t = Math.round(s), h = Math.floor(t / 3600), m = Math.floor(t % 3600 / 60), r = t % 60;
-  return h ? `${h}:${String(m).padStart(2, "0")}:${String(r).padStart(2, "0")}` : `${m}:${String(r).padStart(2, "0")}`;
-}, "duration");
-var wait2 = /* @__PURE__ */ __name((ms) => new Promise((r) => setTimeout(r, ms)), "wait");
-async function zoneOf(name) {
-  const t = await paired();
-  await officialReady();
-  const z2 = officialZone(name);
-  if (!z2) throw new RoonError(`No Roon zone called "${name}"; Roon has: ${officialZones().map((x) => x.display_name).join(", ")}`, "not_found");
-  return { t, z: z2 };
-}
-__name(zoneOf, "zoneOf");
-async function zones3() {
-  await officialReady();
-  const all = officialZones();
-  return {
-    zones: [...new Set(all.flatMap((z2) => z2.outputs.map((o) => o.display_name)))].sort(),
-    groups: all.filter((z2) => z2.outputs.length > 1).map((z2) => z2.outputs.map((o) => o.display_name))
-  };
-}
-__name(zones3, "zones");
-async function nowPlaying2() {
-  await officialReady();
-  return { zones: officialZones().map((z2) => {
-    const r = { zone: z2.display_name, state: z2.state };
-    const v = z2.outputs.find((o) => o.volume)?.volume;
-    if (v) {
-      r.volume = v.value;
-      r.volume_max = v.max;
-      if (v.is_muted) r.muted = true;
-    }
-    if (z2.settings?.shuffle) r.shuffle = true;
-    if (z2.settings?.loop && z2.settings.loop !== "disabled") r.repeat = z2.settings.loop === "loop_one" ? "one" : "all";
-    if (z2.settings?.auto_radio) r.roon_radio = true;
-    const np = z2.now_playing;
-    if (np && z2.state !== "stopped") {
-      if (np.three_line?.line1) {
-        r.title = np.three_line.line1;
-        if (np.three_line.line2) r.artist = np.three_line.line2;
-        if (np.three_line.line3) r.album = np.three_line.line3;
-      }
-      if (typeof np.seek_position === "number") r.position = duration4(np.seek_position);
-      if (typeof np.length === "number") r.length = duration4(np.length);
-    }
-    return r;
-  }) };
-}
-__name(nowPlaying2, "nowPlaying");
-async function control(name, action) {
-  const { t, z: z2 } = await zoneOf(name);
-  await call((cb) => t.control(z2.zone_id, action, cb));
-  const expect = { pause: ["paused"], stop: ["stopped", "paused"], play: ["playing", "loading"] };
-  let state = officialZone(z2.display_name)?.state;
-  if (expect[action]) {
-    const end = Date.now() + 3e3;
-    while (Date.now() < end && !expect[action].includes(state ?? "")) {
-      await wait2(150);
-      state = officialZone(z2.display_name)?.state;
-    }
-  }
-  return { ok: !expect[action] || expect[action].includes(state ?? ""), zone: z2.display_name, action, state };
-}
-__name(control, "control");
-async function seek(name, seconds) {
-  const { t, z: z2 } = await zoneOf(name);
-  await call((cb) => t.seek(z2.zone_id, "absolute", Math.max(0, Math.round(seconds)), cb));
-  return { ok: true, zone: z2.display_name, position: duration4(seconds) };
-}
-__name(seek, "seek");
-async function settings(name, s) {
-  if (s.roon_radio === "now") throw new RoonError('"Start Roon Radio now" needs the internal protocol (switched off)', "invalid");
-  const { t, z: z2 } = await zoneOf(name);
-  const change = {};
-  if (s.shuffle !== void 0) change.shuffle = s.shuffle;
-  if (s.repeat !== void 0) change.loop = { off: "disabled", all: "loop", one: "loop_one" }[s.repeat];
-  if (s.roon_radio !== void 0) change.auto_radio = s.roon_radio;
-  if (!Object.keys(change).length) throw new RoonError("Nothing to set: give shuffle, repeat or roon_radio", "invalid");
-  await call((cb) => t.change_settings(z2.zone_id, change, cb));
-  return { ok: true, zone: z2.display_name, ...s };
-}
-__name(settings, "settings");
-async function transfer(from, to) {
-  const a = await zoneOf(from), b = await zoneOf(to);
-  if (a.z.zone_id === b.z.zone_id) throw new RoonError("From and to are the same zone", "invalid");
-  await call((cb) => a.t.transfer_zone(a.z.zone_id, b.z.zone_id, cb));
-  return { ok: true, from: a.z.display_name, to: b.z.display_name };
-}
-__name(transfer, "transfer");
-async function group(main2, join) {
-  const m = await zoneOf(main2);
-  const outs = [...m.z.outputs.map((o) => o.output_id)];
-  for (const n of join) {
-    const j = await zoneOf(n);
-    for (const o of j.z.outputs) if (!outs.includes(o.output_id)) outs.push(o.output_id);
-  }
-  if (outs.length === m.z.outputs.length) throw new RoonError("Nothing to group: name at least one other zone", "invalid");
-  await call((cb) => m.t.group_outputs(outs, cb));
-  return { ok: true, group: outs.map((id) => officialZones().flatMap((z2) => z2.outputs).find((o) => o.output_id === id)?.display_name ?? id) };
-}
-__name(group, "group");
-async function ungroup(name, only) {
-  const { t, z: z2 } = await zoneOf(name);
-  if (z2.outputs.length < 2) throw new RoonError(`${z2.display_name} isn't in a group`, "invalid");
-  const off = only ? z2.outputs.filter((o) => o.display_name.toLowerCase().includes(only.toLowerCase())) : z2.outputs;
-  if (!off.length) throw new RoonError(`"${only}" isn't in this group`, "not_found");
-  await call((cb) => t.ungroup_outputs(off.map((o) => o.output_id), cb));
-  return { ok: true, released: off.map((o) => o.display_name) };
-}
-__name(ungroup, "ungroup");
-async function standby(name, on) {
-  const { t, z: z2 } = await zoneOf(name);
-  for (const o of z2.outputs) await call((cb) => on ? t.standby(o.output_id, {}, cb) : t.convenience_switch(o.output_id, {}, cb));
-  return { ok: true, zone: z2.display_name, standby: on };
-}
-__name(standby, "standby");
-async function cover(target2, name) {
-  await officialReady();
-  const z2 = name ? officialZone(name) : officialZones().find((x) => x.state === "playing" && x.now_playing?.image_key) ?? officialZones().find((x) => x.state === "paused" && x.now_playing?.image_key);
-  if (!z2) throw new RoonError(name ? `No Roon zone called "${name}"` : "Nothing plays in Roon right now", "not_found");
-  const key = z2.now_playing?.image_key;
-  if (!key) throw new RoonError(`Roon has no cover for what plays on ${z2.display_name}`, "not_found");
-  const r = await fetch(`http://${target2.host}:${target2.port}/api/image/${key}?scale=fit&width=600&height=600`).catch(() => null);
-  if (!r?.ok) throw new RoonError("Roon doesn't hand over the cover right now", "unavailable");
-  const l = z2.now_playing?.three_line;
-  return {
-    info: { zone: z2.display_name, title: l?.line1, artist: l?.line2, album: l?.line3 },
-    image: { data: Buffer.from(await r.arrayBuffer()).toString("base64"), mimeType: r.headers.get("content-type") ?? "image/jpeg" }
-  };
-}
-__name(cover, "cover");
-
-// src/tools/run.ts
+// src/roon/radio.ts
+init_intern();
+init_serializer();
+init_writer();
+init_signature();
 init_session();
 init_log();
-
-// src/core/status.ts
-init_package();
-init_log();
-var checks = null;
-var checking = null;
-function selfTest(run2) {
-  checking ??= run2().then((c) => {
-    checks = c;
-    const bad = c.filter((x) => !x.ok);
-    log(bad.length ? `self-test: ${bad.map((x) => `${x.name} failed (${x.detail})`).join("; ")}` : `self-test: ${c.length} reads ok`);
-  }).catch((e) => {
-    log(`self-test couldn't run: ${e.message}`);
-  });
-  return checking;
-}
-__name(selfTest, "selfTest");
-var selfTestResults = /* @__PURE__ */ __name(() => checks, "selfTestResults");
-var newer = null;
-var told = false;
-var parse3 = /* @__PURE__ */ __name((v) => v.replace(/^v/, "").split(".").map((n) => parseInt(n, 10) || 0), "parse");
-var isNewer = /* @__PURE__ */ __name((a, b) => {
-  const x = parse3(a), y = parse3(b);
-  for (let i = 0; i < 3; i++) {
-    if ((x[i] ?? 0) !== (y[i] ?? 0)) return (x[i] ?? 0) > (y[i] ?? 0);
-  }
-  return false;
-}, "isNewer");
-async function checkForUpdate() {
-  if (process.env.DEEP_ROON_NO_UPDATE_CHECK === "1") return;
-  try {
-    const r = await fetch("https://api.github.com/repos/renebouwmeester/deep-roon-mcp/releases/latest", {
-      headers: { "User-Agent": `deep-roon-mcp/${version2}`, Accept: "application/vnd.github+json" },
-      signal: AbortSignal.timeout(5e3)
-    });
-    if (!r.ok) return;
-    const j = await r.json();
-    if (j.tag_name && isNewer(j.tag_name, version2)) {
-      newer = { version: j.tag_name.replace(/^v/, ""), url: j.html_url ?? "" };
-      log(`a newer version is out: ${newer.version}`);
-    }
-  } catch {
-  }
-}
-__name(checkForUpdate, "checkForUpdate");
-var updateInfo = /* @__PURE__ */ __name(() => newer, "updateInfo");
-function updateNotice() {
-  if (!newer || told) return null;
-  told = true;
-  return `Deep Roon MCP ${newer.version} is available (this is ${version2}): ${newer.url}`;
-}
-__name(updateNotice, "updateNotice");
-
-// src/tools/run.ts
-var compact = /* @__PURE__ */ __name((_k, v) => v === void 0 ? void 0 : typeof v === "bigint" ? v.toString() : v, "compact");
-async function run(work2) {
-  try {
-    const result = await work2();
-    const notice = updateNotice();
-    return { content: [{ type: "text", text: JSON.stringify(result, compact) }, ...notice ? [{ type: "text", text: notice }] : []] };
-  } catch (e) {
-    const err = e;
-    let text2;
-    if (err instanceof RoonError) text2 = err.message;
-    else if (/MissingMethod|method not found|unknown method/i.test(err.message)) {
-      text2 = `Roon changed this part of its internal protocol in this version (${err.message}). Check for an update of Deep Roon MCP.`;
-    } else text2 = `Roon didn't answer as expected: ${err.message}`;
-    log(`tool error: ${err.message}`);
-    return { isError: true, content: [{ type: "text", text: text2 }] };
-  }
-}
-__name(run, "run");
-async function runImage(work2) {
-  let image = null;
-  const r = await run(async () => {
-    const x = await work2();
-    image = x.image;
-    return x.info;
-  });
-  if (r.isError || !image) return r;
-  const { data, mimeType } = image;
-  return { content: [...r.content, { type: "image", data, mimeType }] };
-}
-__name(runImage, "runImage");
-
-// src/tools/read.ts
-var READ = { readOnlyHint: true, openWorldHint: false };
-var service = external_exports.enum(["qobuz", "tidal"]).optional().describe("qobuz or tidal \u2014 default: Qobuz when it is signed in in Roon, else TIDAL.");
-var limit = /* @__PURE__ */ __name((max, dflt) => external_exports.number().int().min(1).max(max).optional().describe(`How many (default ${dflt}, at most ${max}).`), "limit");
-function registerReadTools(server, internal = true) {
-  const R = /* @__PURE__ */ __name((name) => internal || name === "roon_zones" || name === "roon_now_playing", "R");
-  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). 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)));
-  reg("roon_new", {
-    title: "Streaming shelves in Roon",
-    description: 'The editorial shelves of Qobuz or TIDAL as Roon shows them (the same for everyone). Qobuz (`service: "qobuz"`): `new`, `qobuzissimes`, `press_awards`, `top`, `trending`, `ideal_discography` \u2014 albums; `genre` narrows a shelf to one or more Qobuz genre ids from `roon_genres`. TIDAL (`service: "tidal"`): `new`, `recommended`, `top`, `rising`, `masters` \u2014 albums, or tracks with `what: "tracks"` (not masters); `genre` (one TIDAL genre from `roon_genres`, e.g. "Jazz") gives TIDAL\'s page for that genre instead of a shelf. Use `genre` for "new jazz", "what\'s new in classical"; TIDAL\'s playlists are in roon_tidal_playlists. Albums carry their format and a `key` for `roon_album`; tracks a `key` for roon_play_tracks. `offset` pages through the shelf; `total` says how many there are.',
-    inputSchema: {
-      service,
-      section: external_exports.string().optional().describe("The shelf (default new) \u2014 see the list for each service."),
-      genre: external_exports.string().optional().describe("Qobuz: genre id(s) from roon_genres, comma-separated. TIDAL: one genre from roon_genres."),
-      what: external_exports.enum(["albums", "tracks"]).optional().describe("TIDAL only: albums (default) or tracks."),
-      limit: limit(100, 30),
-      offset: external_exports.number().int().min(0).optional()
-    },
-    annotations: READ
-  }, ({ service: sv, section: section2, genre, what, limit: n, offset: offset2 }) => run(() => section(section2 ?? "new", n ?? 30, offset2 ?? 0, (genre ?? "").split(",").map((x) => x.trim()).filter(Boolean), sv, what ?? "albums")));
-  reg("roon_genres", {
-    title: "Streaming genres",
-    description: "The genres of Qobuz or TIDAL, for the `genre` filter of `roon_new` (and, for TIDAL, of `roon_tidal_playlists`). Qobuz: the main genres with their ids (names in the account's language); with `parent` (a genre id) its sub-genres, e.g. the kinds of jazz. TIDAL: its genres and its moods (Relax, Focus \u2026), each with an `id` to pass on.",
-    inputSchema: { service, parent: external_exports.string().optional().describe("Qobuz: a genre id, to list its sub-genres.") },
-    annotations: READ
-  }, ({ service: sv, parent }) => run(() => genres(parent, sv)));
-  reg("roon_album", {
-    title: "Album page",
-    description: "One album in Roon, by its `key` (from roon_search, roon_new, roon_artist): the album with year, format, label and whether it is in the library, its genres, release date (and the date of this edition), barcode and \u2014 when Roon has them \u2014 catalogue number and country, its main artist(s) with a `key` for `roon_artist` / `roon_bio`, and every track with its own `key`. A streaming album that is also in the library comes back as the library copy (its key may differ; both work). `credits: true` adds who played, produced, engineered and wrote, grouped by role \u2014 Roon's own data.",
-    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_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.",
-    inputSchema: { key: external_exports.string().describe("An album key."), wikipedia: external_exports.boolean().optional(), max_chars: external_exports.number().int().min(200).optional() },
-    annotations: READ
-  }, ({ key, wikipedia, max_chars }) => run(() => review(key, max_chars ?? 1e9, wikipedia === true)));
-  reg("roon_bio", {
-    title: "Artist biography",
-    description: 'The biography Roon shows on an artist\'s page, in full, with its author \u2014 by artist `key` \u2014 plus where they are from, active since, genres, and the related artists Roon lists: `similar`, `influenced_by`, `influenced`, `worked_with`, `member_of`, `members`, each with a `key` for `roon_artist` / `roon_bio`. When the user asks for the bio ("who is \u2026", "tell me about this artist"), show the text complete and exactly as returned, with the author\'s name \u2014 no paraphrase or shortening unless they ask for a summary. For a narrower question ("who influenced them") answer from the lists. `wikipedia: true` adds the Wikipedia text; `max_chars` only when a shorter excerpt is asked for.',
-    inputSchema: { key: external_exports.string().describe("An artist key."), wikipedia: external_exports.boolean().optional(), max_chars: external_exports.number().int().min(200).optional() },
-    annotations: READ
-  }, ({ key, wikipedia, max_chars }) => run(() => bio(key, max_chars ?? 1e9, wikipedia === true)));
-  reg("roon_artist", {
-    title: "Discography",
-    description: 'An artist\'s discography in Roon: the main albums Qobuz (or, with `service: "tidal"`, TIDAL) has, oldest first, each with year, format and a `key` for `roon_album`. The artist `key` comes from roon_search (`kind: "artist"`) or from the `artists` of roon_album. Use this for "the album before/after \u2026", "their debut", "what else did they make" \u2014 don\'t answer discography questions from memory. The year is the original release where Roon knows it; reissues and compilations are in the list too.',
-    inputSchema: { key: external_exports.string().describe("An artist key."), service },
-    annotations: READ
-  }, ({ key, service: sv }) => run(() => discography(key, sv)));
-  reg("roon_zones", {
-    title: "Roon zones",
-    description: "The zones Roon can play on (Roon's own names), and which are grouped right now (`groups`).",
-    inputSchema: {},
-    annotations: READ
-  }, () => run(() => internal ? zones2() : zones3()));
-  reg("roon_now_playing", {
-    title: "Now playing in Roon",
-    description: "What plays in Roon, per zone: state (playing, loading, paused, stopped), the track with album, artist and format, the position, how many tracks are left in the queue, shuffle, repeat, Roon Radio and a sleep timer. Read this before saying anything about what Roon plays \u2014 it changes all the time.",
-    inputSchema: {},
-    annotations: READ
-  }, () => run(() => internal ? nowPlaying() : nowPlaying2()));
-  reg("roon_history", {
-    title: "Play history",
-    description: `What was played in Roon, newest first \u2014 Roon's own play history, with how much of each track was heard. For "most played" questions use roon_top instead of counting this.`,
-    inputSchema: { limit: limit(300, 30) },
-    annotations: READ
-  }, ({ limit: n }) => run(() => history(n ?? 30)));
-  reg("roon_top", {
-    title: "Most played",
-    description: 'The most played albums, artists or tracks in Roon, counted over the WHOLE play history (a play counts when at least half the track was heard). Use this for "most listened" questions \u2014 don\'t tally roon_history yourself. `since` (YYYY-MM-DD) limits the period.',
-    inputSchema: { what: external_exports.enum(["albums", "artists", "tracks"]).optional(), limit: limit(100, 20), since: external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("Only plays from this date on (YYYY-MM-DD).") },
-    annotations: READ
-  }, ({ what, limit: n, since }) => run(() => top(what ?? "albums", n ?? 20, since)));
-}
-__name(registerReadTools, "registerReadTools");
+init_graph();
 
 // src/roon/control.ts
 init_intern();
@@ -49902,7 +49671,7 @@ 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) {
+async function control(zoneName, action) {
   if (action === "release") {
     return withCore(async (c) => {
       const z2 = findZone(c, zoneName);
@@ -49930,8 +49699,8 @@ async function control2(zoneName, action) {
   }
   return { ok: !expect[action] || expect[action].includes(state ?? ""), zone: r.zone, action, state };
 }
-__name(control2, "control");
-async function seek2(zoneName, seconds) {
+__name(control, "control");
+async function seek(zoneName, seconds) {
   return withCore(async (c) => {
     const z2 = findZone(c, zoneName);
     const res = await c.call("Zone", "Seek", [{ type: "int", name: "seconds" }, { type: "ResultCallback", name: "cb_done" }], buildArgs([Arg.int(Math.max(0, Math.round(seconds)))]), z2.oid);
@@ -49939,8 +49708,8 @@ async function seek2(zoneName, seconds) {
     return { ok: true, zone: z2.name, position: duration3(seconds) };
   });
 }
-__name(seek2, "seek");
-async function settings2(zoneName, s) {
+__name(seek, "seek");
+async function settings(zoneName, s) {
   return withCore(async (c) => {
     const z2 = findZone(c, zoneName);
     const send = /* @__PURE__ */ __name((method, params, args) => c.remoting.callMethodNoReply(z2.oid, formatMethodSignature("Zone", method, params), args), "send");
@@ -49965,7 +49734,7 @@ async function settings2(zoneName, s) {
     return { ok: true, zone: z2.name, ...done };
   });
 }
-__name(settings2, "settings");
+__name(settings, "settings");
 function queueOf(c, zoneName) {
   const z2 = findZone(c, zoneName);
   const q = obj(c, field2(c.graph.getObject(z2.oid), "Queue"));
@@ -50034,6 +49803,29 @@ async function queueRemove(zoneName, ns) {
   });
 }
 __name(queueRemove, "queueRemove");
+var INSERTION = { before: 3, after: 2 };
+async function queueMove(zoneName, n, to, where) {
+  return withCore(async (c) => {
+    const { z: z2, q, oid, refs, at } = await queueItemAt(c, zoneName, n);
+    const rel = refs[at + to - 1];
+    if (rel === void 0 || to === n) throw new RoonError(`The queue of ${z2.name} has no item ${to} to move next to`, "invalid");
+    const point = INSERTION[where];
+    const res = await c.call(
+      "Queue",
+      "MoveItems",
+      [{ type: "IEnumerable<TransportItem>", name: "items" }, { type: "InsertionPoint", name: "insertionpoint" }, { type: "TransportItem", name: "relative_to_item" }, { type: "ResultCallback", name: "cb_done" }],
+      Buffer.concat([buildArgs([Arg.collection([buildArgs([Arg.ref(oid)])]), Arg.enum_(point), Arg.ref(rel)])]),
+      q.oid
+    );
+    if (!res.success) throw new RoonError(`Roon refused to move the item (${res.status})`);
+    log(`queue_move: ${z2.name} item ${n} \u2192 ${where} ${to} (point ${point})`);
+    await wait(300);
+    const after = await queueItems(c, q);
+    const now = after.indexOf(oid) - at + 1;
+    return { ok: true, zone: z2.name, moved: n, now_at: now > 0 ? now : void 0 };
+  });
+}
+__name(queueMove, "queueMove");
 async function queue2(zoneName, limit3) {
   return withCore(async (c) => {
     const { z: z2, q } = queueOf(c, zoneName);
@@ -50069,7 +49861,7 @@ var outputsOf = /* @__PURE__ */ __name((c, zone3) => c.graph.findByType("Endpoin
   const z2 = field2(e, "Zone");
   return isRef2(z2) && String(z2.$ref) === String(zone3) && typeof field2(e, "Name") === "string";
 }), "outputsOf");
-async function group2(main2, join) {
+async function group(main2, join) {
   return withCore(async (c) => {
     const h = findZone(c, main2);
     const own2 = outputsOf(c, h.oid);
@@ -50095,8 +49887,8 @@ async function group2(main2, join) {
     return { ok: true, group: [...own2, ...added].map((e) => field2(e, "Name")) };
   });
 }
-__name(group2, "group");
-async function ungroup2(zoneName, only) {
+__name(group, "group");
+async function ungroup(zoneName, only) {
   return withCore(async (c) => {
     const z2 = findZone(c, zoneName);
     const all = outputsOf(c, z2.oid);
@@ -50114,8 +49906,8 @@ async function ungroup2(zoneName, only) {
     return { ok: true, released: off.map((e) => field2(e, "Name")) };
   });
 }
-__name(ungroup2, "ungroup");
-async function transfer2(from, to) {
+__name(ungroup, "ungroup");
+async function transfer(from, to) {
   return withCore(async (c) => {
     const a = findZone(c, from), b = findZone(c, to);
     if (a.oid === b.oid) throw new RoonError("From and to are the same zone", "invalid");
@@ -50130,7 +49922,7 @@ async function transfer2(from, to) {
     return { ok: true, from: a.name, to: b.name };
   });
 }
-__name(transfer2, "transfer");
+__name(transfer, "transfer");
 async function sleep(zoneName, minutes) {
   return withCore(async (c) => {
     const z2 = findZone(c, zoneName);
@@ -50143,7 +49935,7 @@ async function sleep(zoneName, minutes) {
   });
 }
 __name(sleep, "sleep");
-async function standby2(zoneName, on) {
+async function standby(zoneName, on) {
   return withCore(async (c) => {
     const z2 = findZone(c, zoneName);
     const outs = outputsOf(c, z2.oid).filter((e) => field2(e, "SupportsStandby") === true);
@@ -50155,8 +49947,8 @@ async function standby2(zoneName, on) {
     return { ok: true, zone: z2.name, standby: on };
   });
 }
-__name(standby2, "standby");
-async function cover2(zoneName) {
+__name(standby, "standby");
+async function cover(zoneName) {
   const t = await findTarget();
   const info = await withCore(async (c) => {
     const pick2 = zoneName ? findZone(c, zoneName) : null;
@@ -50185,8 +49977,456 @@ async function cover2(zoneName) {
     image: { data: Buffer.from(await r.arrayBuffer()).toString("base64"), mimeType: r.headers.get("content-type") ?? "image/jpeg" }
   };
 }
+__name(cover, "cover");
+
+// src/roon/radio.ts
+var hex3 = /* @__PURE__ */ __name((v) => Buffer.isBuffer(v) ? v.toString("hex") : "", "hex");
+var decoded = /* @__PURE__ */ __name((c, payload) => payload.length ? c.graph.decodeReturnValue(Uint8Array.from(payload)) : null, "decoded");
+var radioOid = /* @__PURE__ */ __name((c) => c.serviceOid("Radio"), "radioOid");
+function stationRow(c, o) {
+  const r = { key: hex3(field2(o, "ChannelId")), name: field2(o, "Name") ?? "" };
+  const loc = field2(o, "Location");
+  if (loc) r.location = loc;
+  const d = field2(o, "Description");
+  if (d) r.description = String(d).slice(0, 200);
+  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");
+var categoryRow = /* @__PURE__ */ __name((c, o) => ({ key: hex3(field2(o, "CategoryId")), name: field2(o, "Name") ?? "" }), "categoryRow");
+function criteria(c, category, genre) {
+  const members2 = [];
+  if (category) {
+    const cat = c.structArg("Sooloos.Broker.Api.RadioCategory", [{ name: "System.Sooid Sooloos.Broker.Api.RadioCategory::CategoryId", propType: 4, value: new BinaryWriter().sooid(Buffer.from(category, "hex")).toBuffer() }]);
+    members2.push({ name: "Sooloos.Broker.Api.RadioCategory Sooloos.Broker.Api.RadioBrowseCriteria::Category", propType: 23, value: cat });
+  }
+  if (genre) members2.push({ name: "string Sooloos.Broker.Api.RadioBrowseCriteria::Genre", propType: 20, value: new BinaryWriter().string(genre).toBuffer() });
+  return c.structArg("Sooloos.Broker.Api.RadioBrowseCriteria", members2);
+}
+__name(criteria, "criteria");
+async function myStations(c) {
+  const crit = c.structArg("Sooloos.Broker.Api.ChannelQueryCriteria", [{ name: "bool Sooloos.Broker.Api.ChannelQueryCriteria::RequireInLibrary", propType: 2, value: new BinaryWriter().boolean(true).toBuffer() }]);
+  const res = await c.call("Radio", "ChannelQuery", [{ type: "Sooid", name: "profileid" }, { type: "ChannelQueryCriteria", name: "criteria" }, { type: "ResultCallback<Query<Channel>>", name: "cb_result" }], Buffer.concat([buildArgs([Arg.sooid(c.profile())]), crit]), radioOid(c));
+  if (!res.success) throw new RoonError(`Roon refused the radio stations (${res.status})`);
+  const v = decoded(c, res.payload);
+  const end = Date.now() + 3e3;
+  let list = [];
+  while (Date.now() < end) {
+    list = (isRef2(v) ? c.graph.getObject(v.$ref)?.fields?.$items : null) ?? [];
+    if (!list.length || list.every((x) => field2(obj(c, x), "Name") !== void 0)) break;
+    await wait(60);
+  }
+  return list.map((x) => obj(c, x)).filter(Boolean);
+}
+__name(myStations, "myStations");
+async function radio(category, genre, limit3 = 40) {
+  return withCore(async (c) => {
+    const out = {};
+    if (!category && !genre) out.my_stations = (await myStations(c)).map((o) => stationRow(c, o));
+    const crit = criteria(c, category, genre);
+    if (!genre) {
+      const res = await c.call("Radio", "BrowseCategories", [{ type: "Sooid", name: "profileid" }, { type: "RadioBrowseCriteria", name: "criterid" }, { type: "ResultCallback<DataList<RadioCategory>>", name: "cb_result" }], Buffer.concat([buildArgs([Arg.sooid(c.profile())]), crit]), radioOid(c));
+      if (!res.success) throw new RoonError(`Roon refused the radio categories (${res.status})`);
+      const cats = items(c, decoded(c, res.payload));
+      await untilLoaded(c, cats.map((x) => ({ $ref: x.oid })), 2500);
+      out.categories = cats.map((x) => categoryRow(c, x));
+    }
+    if (category || genre) {
+      const n = Math.min(Math.max(1, limit3), 100);
+      const res = await c.call(
+        "Radio",
+        "BrowseChannels",
+        [{ type: "Sooid", name: "profileid" }, { type: "RadioBrowseCriteria", name: "criteria" }, { type: "int?", name: "count" }, { type: "ResultCallback<DataList<Channel>>", name: "cb_result" }],
+        Buffer.concat([buildArgs([Arg.sooid(c.profile())]), crit, Buffer.from([1]), new BinaryWriter().integer(n).toBuffer()]),
+        radioOid(c)
+      );
+      if (!res.success) throw new RoonError(`Roon refused the radio stations (${res.status})`);
+      const chs = items(c, decoded(c, res.payload));
+      await untilLoaded(c, chs.map((x) => ({ $ref: x.oid })), 3500);
+      out.stations = chs.map((x) => stationRow(c, x));
+    }
+    return out;
+  });
+}
+__name(radio, "radio");
+async function findStation(c, key) {
+  if (/^[0-9a-f]{20,}$/i.test(key)) {
+    const res = await c.call("Radio", "GetChannel", [{ type: "Sooid", name: "channelid" }, { type: "ResultCallback<Channel>", name: "cb_result" }], buildArgs([Arg.sooid(Buffer.from(key, "hex"))]), radioOid(c));
+    const v = res.success ? decoded(c, res.payload) : null;
+    if (isRef2(v)) {
+      await untilLoaded(c, [v], 2500);
+      const o2 = c.graph.getObject(v.$ref);
+      if (o2 && field2(o2, "Name") !== void 0) return o2;
+    }
+    throw new RoonError("Roon knows no station with that key", "not_found");
+  }
+  const mine = await myStations(c);
+  const want = key.toLowerCase();
+  const o = mine.find((x) => String(field2(x, "Name") ?? "").toLowerCase() === want) ?? mine.find((x) => String(field2(x, "Name") ?? "").toLowerCase().includes(want));
+  if (!o) throw new RoonError(`No station called "${key}" among your own; give a key from roon_radio`, "not_found");
+  return o;
+}
+__name(findStation, "findStation");
+async function playRadio(key, zoneName) {
+  const r = await withCore(async (c) => {
+    const st = await findStation(c, key);
+    const z2 = findZone(c, zoneName);
+    const res = await c.call(
+      "Transport",
+      "PlayChannel",
+      [{ type: "Zone", name: "zone" }, { type: "Sooid", name: "profileid" }, { type: "Channel", name: "channel" }, { type: "ResultCallback<PlayFeedback>", name: "cb_result" }],
+      buildArgs([Arg.ref(z2.oid), Arg.sooid(c.profile()), Arg.ref(st.oid)]),
+      c.serviceOid("Transport")
+    );
+    log(`play_radio: ${field2(st, "Name")} on ${z2.name} \u2192 ${res.success ? "ok" : res.status}`);
+    if (!res.success) throw new RoonError(`Roon refused to play the station (${res.status})`);
+    return { zone: z2.name, station: field2(st, "Name") };
+  });
+  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();
+init_official();
+var call = /* @__PURE__ */ __name((fn) => new Promise((res, rej) => fn((err) => err ? rej(new RoonError(`Roon refused: ${err}`)) : res())), "call");
+var duration4 = /* @__PURE__ */ __name((s) => {
+  const t = Math.round(s), h = Math.floor(t / 3600), m = Math.floor(t % 3600 / 60), r = t % 60;
+  return h ? `${h}:${String(m).padStart(2, "0")}:${String(r).padStart(2, "0")}` : `${m}:${String(r).padStart(2, "0")}`;
+}, "duration");
+var wait2 = /* @__PURE__ */ __name((ms) => new Promise((r) => setTimeout(r, ms)), "wait");
+async function zoneOf(name) {
+  const t = await paired();
+  await officialReady();
+  const z2 = officialZone(name);
+  if (!z2) throw new RoonError(`No Roon zone called "${name}"; Roon has: ${officialZones().map((x) => x.display_name).join(", ")}`, "not_found");
+  return { t, z: z2 };
+}
+__name(zoneOf, "zoneOf");
+async function zones3() {
+  await officialReady();
+  const all = officialZones();
+  return {
+    zones: [...new Set(all.flatMap((z2) => z2.outputs.map((o) => o.display_name)))].sort(),
+    groups: all.filter((z2) => z2.outputs.length > 1).map((z2) => z2.outputs.map((o) => o.display_name))
+  };
+}
+__name(zones3, "zones");
+async function nowPlaying2() {
+  await officialReady();
+  return { zones: officialZones().map((z2) => {
+    const r = { zone: z2.display_name, state: z2.state };
+    const v = z2.outputs.find((o) => o.volume)?.volume;
+    if (v) {
+      r.volume = v.value;
+      r.volume_max = v.max;
+      if (v.is_muted) r.muted = true;
+    }
+    if (z2.settings?.shuffle) r.shuffle = true;
+    if (z2.settings?.loop && z2.settings.loop !== "disabled") r.repeat = z2.settings.loop === "loop_one" ? "one" : "all";
+    if (z2.settings?.auto_radio) r.roon_radio = true;
+    const np = z2.now_playing;
+    if (np && z2.state !== "stopped") {
+      if (np.three_line?.line1) {
+        r.title = np.three_line.line1;
+        if (np.three_line.line2) r.artist = np.three_line.line2;
+        if (np.three_line.line3) r.album = np.three_line.line3;
+      }
+      if (typeof np.seek_position === "number") r.position = duration4(np.seek_position);
+      if (typeof np.length === "number") r.length = duration4(np.length);
+    }
+    return r;
+  }) };
+}
+__name(nowPlaying2, "nowPlaying");
+async function control2(name, action) {
+  const { t, z: z2 } = await zoneOf(name);
+  await call((cb) => t.control(z2.zone_id, action, cb));
+  const expect = { pause: ["paused"], stop: ["stopped", "paused"], play: ["playing", "loading"] };
+  let state = officialZone(z2.display_name)?.state;
+  if (expect[action]) {
+    const end = Date.now() + 3e3;
+    while (Date.now() < end && !expect[action].includes(state ?? "")) {
+      await wait2(150);
+      state = officialZone(z2.display_name)?.state;
+    }
+  }
+  return { ok: !expect[action] || expect[action].includes(state ?? ""), zone: z2.display_name, action, state };
+}
+__name(control2, "control");
+async function seek2(name, seconds) {
+  const { t, z: z2 } = await zoneOf(name);
+  await call((cb) => t.seek(z2.zone_id, "absolute", Math.max(0, Math.round(seconds)), cb));
+  return { ok: true, zone: z2.display_name, position: duration4(seconds) };
+}
+__name(seek2, "seek");
+async function settings2(name, s) {
+  if (s.roon_radio === "now") throw new RoonError('"Start Roon Radio now" needs the internal protocol (switched off)', "invalid");
+  const { t, z: z2 } = await zoneOf(name);
+  const change = {};
+  if (s.shuffle !== void 0) change.shuffle = s.shuffle;
+  if (s.repeat !== void 0) change.loop = { off: "disabled", all: "loop", one: "loop_one" }[s.repeat];
+  if (s.roon_radio !== void 0) change.auto_radio = s.roon_radio;
+  if (!Object.keys(change).length) throw new RoonError("Nothing to set: give shuffle, repeat or roon_radio", "invalid");
+  await call((cb) => t.change_settings(z2.zone_id, change, cb));
+  return { ok: true, zone: z2.display_name, ...s };
+}
+__name(settings2, "settings");
+async function transfer2(from, to) {
+  const a = await zoneOf(from), b = await zoneOf(to);
+  if (a.z.zone_id === b.z.zone_id) throw new RoonError("From and to are the same zone", "invalid");
+  await call((cb) => a.t.transfer_zone(a.z.zone_id, b.z.zone_id, cb));
+  return { ok: true, from: a.z.display_name, to: b.z.display_name };
+}
+__name(transfer2, "transfer");
+async function group2(main2, join) {
+  const m = await zoneOf(main2);
+  const outs = [...m.z.outputs.map((o) => o.output_id)];
+  for (const n of join) {
+    const j = await zoneOf(n);
+    for (const o of j.z.outputs) if (!outs.includes(o.output_id)) outs.push(o.output_id);
+  }
+  if (outs.length === m.z.outputs.length) throw new RoonError("Nothing to group: name at least one other zone", "invalid");
+  await call((cb) => m.t.group_outputs(outs, cb));
+  return { ok: true, group: outs.map((id) => officialZones().flatMap((z2) => z2.outputs).find((o) => o.output_id === id)?.display_name ?? id) };
+}
+__name(group2, "group");
+async function ungroup2(name, only) {
+  const { t, z: z2 } = await zoneOf(name);
+  if (z2.outputs.length < 2) throw new RoonError(`${z2.display_name} isn't in a group`, "invalid");
+  const off = only ? z2.outputs.filter((o) => o.display_name.toLowerCase().includes(only.toLowerCase())) : z2.outputs;
+  if (!off.length) throw new RoonError(`"${only}" isn't in this group`, "not_found");
+  await call((cb) => t.ungroup_outputs(off.map((o) => o.output_id), cb));
+  return { ok: true, released: off.map((o) => o.display_name) };
+}
+__name(ungroup2, "ungroup");
+async function standby2(name, on) {
+  const { t, z: z2 } = await zoneOf(name);
+  for (const o of z2.outputs) await call((cb) => on ? t.standby(o.output_id, {}, cb) : t.convenience_switch(o.output_id, {}, cb));
+  return { ok: true, zone: z2.display_name, standby: on };
+}
+__name(standby2, "standby");
+async function cover2(target2, name) {
+  await officialReady();
+  const z2 = name ? officialZone(name) : officialZones().find((x) => x.state === "playing" && x.now_playing?.image_key) ?? officialZones().find((x) => x.state === "paused" && x.now_playing?.image_key);
+  if (!z2) throw new RoonError(name ? `No Roon zone called "${name}"` : "Nothing plays in Roon right now", "not_found");
+  const key = z2.now_playing?.image_key;
+  if (!key) throw new RoonError(`Roon has no cover for what plays on ${z2.display_name}`, "not_found");
+  const r = await fetch(`http://${target2.host}:${target2.port}/api/image/${key}?scale=fit&width=600&height=600`).catch(() => null);
+  if (!r?.ok) throw new RoonError("Roon doesn't hand over the cover right now", "unavailable");
+  const l = z2.now_playing?.three_line;
+  return {
+    info: { zone: z2.display_name, title: l?.line1, artist: l?.line2, album: l?.line3 },
+    image: { data: Buffer.from(await r.arrayBuffer()).toString("base64"), mimeType: r.headers.get("content-type") ?? "image/jpeg" }
+  };
+}
 __name(cover2, "cover");
 
+// src/tools/run.ts
+init_session();
+init_log();
+
+// src/core/status.ts
+init_package();
+init_log();
+var checks = null;
+var checking = null;
+function selfTest(run2) {
+  checking ??= run2().then((c) => {
+    checks = c;
+    const bad = c.filter((x) => !x.ok);
+    log(bad.length ? `self-test: ${bad.map((x) => `${x.name} failed (${x.detail})`).join("; ")}` : `self-test: ${c.length} reads ok`);
+  }).catch((e) => {
+    log(`self-test couldn't run: ${e.message}`);
+  });
+  return checking;
+}
+__name(selfTest, "selfTest");
+var selfTestResults = /* @__PURE__ */ __name(() => checks, "selfTestResults");
+var newer = null;
+var told = false;
+var parse3 = /* @__PURE__ */ __name((v) => v.replace(/^v/, "").split(".").map((n) => parseInt(n, 10) || 0), "parse");
+var isNewer = /* @__PURE__ */ __name((a, b) => {
+  const x = parse3(a), y = parse3(b);
+  for (let i = 0; i < 3; i++) {
+    if ((x[i] ?? 0) !== (y[i] ?? 0)) return (x[i] ?? 0) > (y[i] ?? 0);
+  }
+  return false;
+}, "isNewer");
+async function checkForUpdate() {
+  if (process.env.DEEP_ROON_NO_UPDATE_CHECK === "1") return;
+  try {
+    const r = await fetch("https://api.github.com/repos/renebouwmeester/deep-roon-mcp/releases/latest", {
+      headers: { "User-Agent": `deep-roon-mcp/${version2}`, Accept: "application/vnd.github+json" },
+      signal: AbortSignal.timeout(5e3)
+    });
+    if (!r.ok) return;
+    const j = await r.json();
+    if (j.tag_name && isNewer(j.tag_name, version2)) {
+      newer = { version: j.tag_name.replace(/^v/, ""), url: j.html_url ?? "" };
+      log(`a newer version is out: ${newer.version}`);
+    }
+  } catch {
+  }
+}
+__name(checkForUpdate, "checkForUpdate");
+var updateInfo = /* @__PURE__ */ __name(() => newer, "updateInfo");
+function updateNotice() {
+  if (!newer || told) return null;
+  told = true;
+  return `Deep Roon MCP ${newer.version} is available (this is ${version2}): ${newer.url}`;
+}
+__name(updateNotice, "updateNotice");
+
+// src/tools/run.ts
+var compact = /* @__PURE__ */ __name((_k, v) => v === void 0 ? void 0 : typeof v === "bigint" ? v.toString() : v, "compact");
+async function run(work2) {
+  try {
+    const result = await work2();
+    const notice = updateNotice();
+    return { content: [{ type: "text", text: JSON.stringify(result, compact) }, ...notice ? [{ type: "text", text: notice }] : []] };
+  } catch (e) {
+    const err = e;
+    let text2;
+    if (err instanceof RoonError) text2 = err.message;
+    else if (/MissingMethod|method not found|unknown method/i.test(err.message)) {
+      text2 = `Roon changed this part of its internal protocol in this version (${err.message}). Check for an update of Deep Roon MCP.`;
+    } else text2 = `Roon didn't answer as expected: ${err.message}`;
+    log(`tool error: ${err.message}`);
+    return { isError: true, content: [{ type: "text", text: text2 }] };
+  }
+}
+__name(run, "run");
+async function runImage(work2) {
+  let image = null;
+  const r = await run(async () => {
+    const x = await work2();
+    image = x.image;
+    return x.info;
+  });
+  if (r.isError || !image) return r;
+  const { data, mimeType } = image;
+  return { content: [...r.content, { type: "image", data, mimeType }] };
+}
+__name(runImage, "runImage");
+
+// src/tools/read.ts
+var READ = { readOnlyHint: true, openWorldHint: false };
+var service = external_exports.enum(["qobuz", "tidal"]).optional().describe("qobuz or tidal \u2014 default: Qobuz when it is signed in in Roon, else TIDAL.");
+var limit = /* @__PURE__ */ __name((max, dflt) => external_exports.number().int().min(1).max(max).optional().describe(`How many (default ${dflt}, at most ${max}).`), "limit");
+function registerReadTools(server, internal = true) {
+  const R = /* @__PURE__ */ __name((name) => internal || name === "roon_zones" || name === "roon_now_playing", "R");
+  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). 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)));
+  reg("roon_new", {
+    title: "Streaming shelves in Roon",
+    description: 'The editorial shelves of Qobuz or TIDAL as Roon shows them (the same for everyone). Qobuz (`service: "qobuz"`): `new`, `qobuzissimes`, `press_awards`, `top`, `trending`, `ideal_discography` \u2014 albums; `genre` narrows a shelf to one or more Qobuz genre ids from `roon_genres`. TIDAL (`service: "tidal"`): `new`, `recommended`, `top`, `rising`, `masters` \u2014 albums, or tracks with `what: "tracks"` (not masters); `genre` (one TIDAL genre from `roon_genres`, e.g. "Jazz") gives TIDAL\'s page for that genre instead of a shelf. Use `genre` for "new jazz", "what\'s new in classical"; TIDAL\'s playlists are in roon_tidal_playlists. Albums carry their format and a `key` for `roon_album`; tracks a `key` for roon_play_tracks. `offset` pages through the shelf; `total` says how many there are.',
+    inputSchema: {
+      service,
+      section: external_exports.string().optional().describe("The shelf (default new) \u2014 see the list for each service."),
+      genre: external_exports.string().optional().describe("Qobuz: genre id(s) from roon_genres, comma-separated. TIDAL: one genre from roon_genres."),
+      what: external_exports.enum(["albums", "tracks"]).optional().describe("TIDAL only: albums (default) or tracks."),
+      limit: limit(100, 30),
+      offset: external_exports.number().int().min(0).optional()
+    },
+    annotations: READ
+  }, ({ service: sv, section: section2, genre, what, limit: n, offset: offset2 }) => run(() => section(section2 ?? "new", n ?? 30, offset2 ?? 0, (genre ?? "").split(",").map((x) => x.trim()).filter(Boolean), sv, what ?? "albums")));
+  reg("roon_genres", {
+    title: "Streaming genres",
+    description: "The genres of Qobuz or TIDAL, for the `genre` filter of `roon_new` (and, for TIDAL, of `roon_tidal_playlists`). Qobuz: the main genres with their ids (names in the account's language); with `parent` (a genre id) its sub-genres, e.g. the kinds of jazz. TIDAL: its genres and its moods (Relax, Focus \u2026), each with an `id` to pass on.",
+    inputSchema: { service, parent: external_exports.string().optional().describe("Qobuz: a genre id, to list its sub-genres.") },
+    annotations: READ
+  }, ({ service: sv, parent }) => run(() => genres(parent, sv)));
+  reg("roon_album", {
+    title: "Album page",
+    description: "One album in Roon, by its `key` (from roon_search, roon_new, roon_artist): the album with year, format, label and whether it is in the library, its genres, release date (and the date of this edition), barcode and \u2014 when Roon has them \u2014 catalogue number and country, its main artist(s) with a `key` for `roon_artist` / `roon_bio`, and every track with its own `key`. A streaming album that is also in the library comes back as the library copy (its key may differ; both work). `credits: true` adds who played, produced, engineered and wrote, grouped by role \u2014 Roon's own data.",
+    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_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.",
+    inputSchema: { key: external_exports.string().describe("An album key."), wikipedia: external_exports.boolean().optional(), max_chars: external_exports.number().int().min(200).optional() },
+    annotations: READ
+  }, ({ key, wikipedia, max_chars }) => run(() => review(key, max_chars ?? 1e9, wikipedia === true)));
+  reg("roon_bio", {
+    title: "Artist biography",
+    description: 'The biography Roon shows on an artist\'s page, in full, with its author \u2014 by artist `key` \u2014 plus where they are from, active since, genres, and the related artists Roon lists: `similar`, `influenced_by`, `influenced`, `worked_with`, `member_of`, `members`, each with a `key` for `roon_artist` / `roon_bio`. When the user asks for the bio ("who is \u2026", "tell me about this artist"), show the text complete and exactly as returned, with the author\'s name \u2014 no paraphrase or shortening unless they ask for a summary. For a narrower question ("who influenced them") answer from the lists. `wikipedia: true` adds the Wikipedia text; `max_chars` only when a shorter excerpt is asked for.',
+    inputSchema: { key: external_exports.string().describe("An artist key."), wikipedia: external_exports.boolean().optional(), max_chars: external_exports.number().int().min(200).optional() },
+    annotations: READ
+  }, ({ key, wikipedia, max_chars }) => run(() => bio(key, max_chars ?? 1e9, wikipedia === true)));
+  reg("roon_artist", {
+    title: "Discography",
+    description: 'An artist\'s discography in Roon: the main albums Qobuz (or, with `service: "tidal"`, TIDAL) has, oldest first, each with year, format and a `key` for `roon_album`. The artist `key` comes from roon_search (`kind: "artist"`) or from the `artists` of roon_album. Use this for "the album before/after \u2026", "their debut", "what else did they make" \u2014 don\'t answer discography questions from memory. The year is the original release where Roon knows it; reissues and compilations are in the list too.',
+    inputSchema: { key: external_exports.string().describe("An artist key."), service },
+    annotations: READ
+  }, ({ key, service: sv }) => run(() => discography(key, sv)));
+  reg("roon_zones", {
+    title: "Roon zones",
+    description: "The zones Roon can play on (Roon's own names), and which are grouped right now (`groups`).",
+    inputSchema: {},
+    annotations: READ
+  }, () => run(() => internal ? zones2() : zones3()));
+  reg("roon_now_playing", {
+    title: "Now playing in Roon",
+    description: "What plays in Roon, per zone: state (playing, loading, paused, stopped), the track with album, artist and format, the position, how many tracks are left in the queue, shuffle, repeat, Roon Radio and a sleep timer. Read this before saying anything about what Roon plays \u2014 it changes all the time.",
+    inputSchema: {},
+    annotations: READ
+  }, () => 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 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)));
+  reg("roon_history", {
+    title: "Play history",
+    description: `What was played in Roon, newest first \u2014 Roon's own play history, with how much of each track was heard. For "most played" questions use roon_top instead of counting this.`,
+    inputSchema: { limit: limit(300, 30) },
+    annotations: READ
+  }, ({ limit: n }) => run(() => history(n ?? 30)));
+  reg("roon_top", {
+    title: "Most played",
+    description: 'The most played albums, artists or tracks in Roon, counted over the WHOLE play history (a play counts when at least half the track was heard). Use this for "most listened" questions \u2014 don\'t tally roon_history yourself. `since` (YYYY-MM-DD) limits the period.',
+    inputSchema: { what: external_exports.enum(["albums", "artists", "tracks"]).optional(), limit: limit(100, 20), since: external_exports.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("Only plays from this date on (YYYY-MM-DD).") },
+    annotations: READ
+  }, ({ what, limit: n, since }) => run(() => top(what ?? "albums", n ?? 20, since)));
+}
+__name(registerReadTools, "registerReadTools");
+
 // src/tools/control.ts
 init_official();
 init_session();
@@ -50210,18 +50450,24 @@ function registerControlTools(server, internal = true) {
     inputSchema: { keys: external_exports.array(external_exports.string()).min(1).max(60).describe("Track keys, in playing order."), zone, mode },
     annotations: PLAYS
   }, ({ keys, zone: zn, mode: m }) => run(() => playTracks(keys, zn, m ?? "now")));
+  reg("roon_play_radio", {
+    title: "Play a radio station",
+    description: "Play a Live Radio station on a Roon zone: `key` from roon_radio, or the name of one of the user's own stations. Says whether the zone started. Only on an explicit request, never as a probe.",
+    inputSchema: { key: external_exports.string().describe("A station key, or the name of an own station."), zone },
+    annotations: PLAYS
+  }, ({ key, zone: zn }) => run(() => playRadio(key, zn)));
   reg("roon_control", {
     title: "Transport",
     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) : action === "release" ? Promise.reject(new Error("release needs Roon's internal protocol (switched off)")) : control(zn, action)));
+  }, ({ zone: zn, action }) => run(() => internal ? control(zn, action) : action === "release" ? Promise.reject(new Error("release needs Roon's internal protocol (switched off)")) : control2(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.",
     inputSchema: { zone, seconds: external_exports.number().int().min(0) },
     annotations: PLAYS
-  }, ({ zone: zn, seconds }) => run(() => internal ? seek2(zn, seconds) : seek(zn, seconds)));
+  }, ({ zone: zn, seconds }) => run(() => internal ? seek(zn, seconds) : seek2(zn, seconds)));
   reg("roon_volume", {
     title: "Volume",
     description: "Set the volume of a Roon zone to an absolute level, in that zone's own scale (roon_now_playing shows `volume` and `volume_max`), and/or mute or unmute it. Only on an explicit request; small steps unless a level is named. Needs Deep Roon MCP enabled in Roon (Settings \u203A Extensions).",
@@ -50235,7 +50481,7 @@ function registerControlTools(server, internal = true) {
     annotations: PLAYS
   }, ({ zone: zn, shuffle, repeat, roon_radio }) => {
     const s = { shuffle, repeat, roon_radio: roon_radio === void 0 ? void 0 : roon_radio === "now" ? "now" : roon_radio === "on" };
-    return run(() => internal ? settings2(zn, s) : settings(zn, s));
+    return run(() => internal ? settings(zn, s) : settings2(zn, s));
   });
   reg("roon_queue", {
     title: "Queue",
@@ -50255,6 +50501,12 @@ function registerControlTools(server, internal = true) {
     inputSchema: { zone, ns: external_exports.array(external_exports.number().int().min(2)).min(1).max(100).describe("Positions from roon_queue (2 and up: 1 is what plays).") },
     annotations: CHANGES_QUEUE
   }, ({ zone: zn, ns }) => run(() => queueRemove(zn, ns)));
+  reg("roon_queue_move", {
+    title: "Move in the queue",
+    description: "Move an item of the zone's queue next to another: `n` goes `before` or `after` item `to` (numbers from roon_queue; 1 is what plays). Only on an explicit request.",
+    inputSchema: { zone, n: external_exports.number().int().min(2), to: external_exports.number().int().min(2), where: external_exports.enum(["before", "after"]).optional().describe("before (default) or after item `to`.") },
+    annotations: CHANGES_QUEUE
+  }, ({ zone: zn, n, to, where }) => run(() => queueMove(zn, n, to, where ?? "before")));
   reg("roon_queue_clear", {
     title: "Clear the queue",
     description: "Clear the queue of a Roon zone. By default the track that plays keeps playing and everything after it is removed; `everything: true` also removes the playing track (the zone falls silent). Only on an explicit request.",
@@ -50266,19 +50518,19 @@ function registerControlTools(server, internal = true) {
     description: `Move what plays \u2014 with its queue and position \u2014 from one Roon zone to another (Roon's own "Transfer zone"). The tool for "move the music to \u2026": never restart the album with roon_play for that. Read roon_now_playing first if the source zone isn't named.`,
     inputSchema: { from: external_exports.string().describe("The zone that plays now."), to: external_exports.string().describe("The zone it should move to.") },
     annotations: PLAYS
-  }, ({ from, to }) => run(() => internal ? transfer2(from, to) : transfer(from, to)));
+  }, ({ from, to }) => run(() => internal ? transfer(from, to) : transfer2(from, to)));
   reg("roon_group", {
     title: "Group zones",
     description: 'Group Roon zones so they play the same music in sync (Roon\'s own "Group zones"). `zone` keeps its music and queue; `with` are the zones that join. Roon groups only outputs of the same kind. Only on an explicit request.',
     inputSchema: { zone: external_exports.string().describe("The zone whose music continues."), with: external_exports.array(external_exports.string()).min(1).describe("The zones that join.") },
     annotations: PLAYS
-  }, (a) => run(() => internal ? group2(a.zone, a.with) : group(a.zone, a.with)));
+  }, (a) => run(() => internal ? group(a.zone, a.with) : group2(a.zone, a.with)));
   reg("roon_ungroup", {
     title: "Ungroup zones",
     description: "Undo a Roon zone group: `zone` is any member. Without `only` the whole group is dissolved; with `only` (a member's name) just that one leaves. Only on an explicit request.",
     inputSchema: { zone: external_exports.string().describe("A member of the group."), only: external_exports.string().optional() },
     annotations: PLAYS
-  }, ({ zone: zn, only }) => run(() => internal ? ungroup2(zn, only) : ungroup(zn, only)));
+  }, ({ zone: zn, only }) => run(() => internal ? ungroup(zn, only) : ungroup2(zn, only)));
   reg("roon_sleep", {
     title: "Sleep timer",
     description: 'The sleep timer of a Roon zone: stop the music after `minutes` (1\u2013600), or `off: true` to cancel it. roon_now_playing shows a running timer. Only on an explicit request ("stop in half an hour").',
@@ -50293,13 +50545,13 @@ function registerControlTools(server, internal = true) {
     description: 'Put a Roon zone\'s device in standby (`action: "standby"`) or wake it (`action: "wake"`), where the device supports it. Only on an explicit request.',
     inputSchema: { zone, action: external_exports.enum(["standby", "wake"]) },
     annotations: PLAYS
-  }, ({ zone: zn, action }) => run(() => internal ? standby2(zn, action === "standby") : standby(zn, action === "standby")));
+  }, ({ zone: zn, action }) => run(() => internal ? standby(zn, action === "standby") : standby2(zn, action === "standby")));
   reg("roon_cover", {
     title: "Cover",
     description: "The album cover of what plays in a Roon zone, as an image (about 600 px), with the title in text. Without `zone` it takes the zone that plays. Read-only.",
     inputSchema: { zone: external_exports.string().optional().describe("A Roon zone name (default: the zone that plays).") },
     annotations: { readOnlyHint: true, openWorldHint: false }
-  }, ({ zone: zn }) => runImage(async () => internal ? cover2(zn) : cover(await findTarget(), zn)));
+  }, ({ zone: zn }) => runImage(async () => internal ? cover(zn) : cover2(await findTarget(), zn)));
 }
 __name(registerControlTools, "registerControlTools");
 
@@ -50313,11 +50565,12 @@ 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())}`;
 }, "localNow");
-var decoded = /* @__PURE__ */ __name((c, payload) => payload.length ? c.graph.decodeReturnValue(Uint8Array.from(payload)) : null, "decoded");
+var decoded2 = /* @__PURE__ */ __name((c, payload) => payload.length ? c.graph.decodeReturnValue(Uint8Array.from(payload)) : null, "decoded");
 async function dailyPicks(perBox) {
   return withCore(async (c) => {
     const DP = "Sooloos.Broker.Api.DailyPicksParameters";
@@ -50333,7 +50586,7 @@ async function dailyPicks(perBox) {
       c.serviceOid("Library")
     );
     if (!res.success) throw new RoonError(`Roon refused the Daily Picks (${res.status})`);
-    const boxes = items(c, decoded(c, res.payload));
+    const boxes = items(c, decoded2(c, res.payload));
     const things = /* @__PURE__ */ __name((b) => {
       for (const k of ["DisplayAlbums", "Albums", "Tracks", "Performers"]) {
         const l = obj(c, field2(b, k))?.fields?.$items ?? [];
@@ -50357,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, decoded(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);
@@ -50389,7 +50653,7 @@ async function readMixes(c) {
     c.serviceOid("Library")
   );
   if (!res.success) throw new RoonError(`Roon refused the Daily Mixes (${res.status})`);
-  return items(c, decoded(c, res.payload));
+  return items(c, decoded2(c, res.payload));
 }
 __name(readMixes, "readMixes");
 async function mixes() {
@@ -50398,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) => {
@@ -50491,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");
@@ -50520,7 +50821,7 @@ var profileObject = /* @__PURE__ */ __name((c) => {
   if (!p) throw new RoonError("Roon gave no profile");
   return p;
 }, "profileObject");
-var decoded2 = /* @__PURE__ */ __name((c, payload) => payload.length ? c.graph.decodeReturnValue(Uint8Array.from(payload)) : null, "decoded");
+var decoded3 = /* @__PURE__ */ __name((c, payload) => payload.length ? c.graph.decodeReturnValue(Uint8Array.from(payload)) : null, "decoded");
 var PLAYLIST_KIND = { 1: "itunes", 5: "roon", 6: "roon (read-only)", 10: "TIDAL", 11: "file", 12: "qobuz", 13: "roon editorial", 15: "smart" };
 function allPlaylists(c) {
   const service2 = c.graph.findByType("Playlists")[0];
@@ -50536,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) {
@@ -50550,7 +50862,7 @@ async function playlist(key, limit3) {
     const p = await findPlaylist2(c, key);
     const res = await c.call("Playlist", "GetItems", [{ type: "ResultCallback<Query<PlaylistItem>>", name: "cb_result" }], Buffer.alloc(0), p.oid);
     if (!res.success) throw new RoonError(`Roon refused the playlist (${res.status})`);
-    const v = decoded2(c, res.payload);
+    const v = decoded3(c, res.payload);
     const n = Math.min(Math.max(1, limit3), 300);
     const end = Date.now() + 3e3;
     let list = [];
@@ -50562,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;
     }) };
   });
 }
@@ -50684,7 +51003,7 @@ async function listenLater(includePlayed) {
       c.serviceOid("Library")
     );
     if (!res.success) throw new RoonError(`Roon refused Listen Later (${res.status})`);
-    const list = items(c, decoded2(c, res.payload));
+    const list = items(c, decoded3(c, res.payload));
     const thing = /* @__PURE__ */ __name((it) => field2(it, "Album") ?? field2(it, "Track") ?? field2(it, "Performer"), "thing");
     await untilLoaded(c, list.map(thing).filter(isRef2), 2500);
     const rows = list.map((it) => {
@@ -50794,7 +51113,7 @@ async function similarAlbum(key, limit3) {
       buildArgs([Arg.ref(al.oid), Arg.sooid(c.profile())]),
       c.serviceOid("Library")
     ), 8e3);
-    const recommended = res?.success ? items(c, decoded2(c, res.payload)) : [];
+    const recommended = res?.success ? items(c, decoded3(c, res.payload)) : [];
     const similar = ["SimilarAlbums", "SoundsSimilar", "SeeAlso", "WasInfluencedBy", "WasInspiredBy"].flatMap((k) => items(c, field2(A, k)));
     await untilLoaded(c, [...recommended, ...similar].map((o) => ({ $ref: o.oid })), 2500);
     return { album: albumRow(c, al), similar: unique(similar), recommended: unique(recommended) };
@@ -50812,7 +51131,7 @@ async function similarArtist(key, limit3) {
       buildArgs([Arg.ref(lv.$ref), Arg.sooid(c.profile())]),
       c.serviceOid("Library")
     ), 8e3);
-    const w = res?.success ? obj(c, decoded2(c, res.payload)) : null;
+    const w = res?.success ? obj(c, decoded3(c, res.payload)) : null;
     const list = /* @__PURE__ */ __name((k) => items(c, field2(w, k)), "list");
     await untilLoaded(c, ["RecommendedAlbums", "LatestAlbums", "AppearsOnAlbums"].flatMap(list).map((o) => ({ $ref: o.oid })), 2500);
     const rows = /* @__PURE__ */ __name((k) => list(k).filter((o) => field2(o, "Title") !== void 0).slice(0, limit3).map((o) => albumRow(c, o)), "rows");
@@ -50941,7 +51260,7 @@ async function dspOf(c, endpoint) {
   const cc = obj(c, field2(obj(c, field2(endpoint, "Device")), "CommonConfig"));
   if (!cc || field2(cc, "SupportsDspConfig") !== true) return null;
   const res = await short(c.call("AudioDeviceCommonConfig", "GetDspConfig", [{ type: "ResultCallback<DspConfig>", name: "conf" }], Buffer.alloc(0), cc.oid), 6e3);
-  const v = res?.success ? decoded2(c, res.payload) : null;
+  const v = res?.success ? decoded3(c, res.payload) : null;
   if (!isRef2(v)) return null;
   const end = Date.now() + 2500;
   while (Date.now() < end && field2(c.graph.getObject(v.$ref), "BeforeItems") === void 0 && field2(c.graph.getObject(v.$ref), "Items") === void 0) await wait(50);
@@ -51079,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
@@ -51167,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.',
@@ -51227,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.",
@@ -51330,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.",