deep-roon-mcp 0.3.6 → 0.4.0

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.6";
+    version2 = "0.4.0";
   }
 });
 
@@ -16207,7 +16207,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 +16227,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;
 }
@@ -16353,7 +16354,12 @@ async function bio(key, max, wiki) {
       for (const n of names2) for (const x of list(n)) {
         const o = obj(c, x);
         const name = field2(o, "Name");
-        if (name && !out.some((y) => y.name === name)) out.push({ key: String(field2(o, "PerformerId") ?? "") || void 0, name });
+        if (name && !out.some((y) => y.name === name)) {
+          const r = { key: String(field2(o, "PerformerId") ?? "") || void 0, name };
+          const img2 = imageKey(c, o, "Photo") ?? imageKey(c, o, "Avatar");
+          if (img2) r.image = img2;
+          out.push(r);
+        }
       }
       return out.length ? out.slice(0, 12) : void 0;
     }, "people");
@@ -16481,13 +16487,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})`);
@@ -16522,12 +16528,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})`);
@@ -17746,14 +17752,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 {
@@ -21978,8 +21984,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");
   }
@@ -49290,14 +49296,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 }))
+      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;
+      })
     };
   });
 }
@@ -49450,312 +49474,13 @@ 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_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();
@@ -49889,7 +49614,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);
@@ -49917,8 +49642,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);
@@ -49926,8 +49651,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");
@@ -49952,7 +49677,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"));
@@ -49987,6 +49712,63 @@ function queueRow(c, oid) {
   return r;
 }
 __name(queueRow, "queueRow");
+async function queueItemAt(c, zoneName, n) {
+  const { z: z2, q } = queueOf(c, zoneName);
+  const refs = await queueItems(c, q);
+  const at = Math.max(0, field2(c.graph.getObject(q.oid), "CurrentItemIndex") ?? 0);
+  const oid = refs[at + n - 1];
+  if (oid === void 0) throw new RoonError(`The queue of ${z2.name} has no item ${n} (${Math.max(0, refs.length - at)} from here)`, "invalid");
+  return { z: z2, q, oid, refs, at };
+}
+__name(queueItemAt, "queueItemAt");
+async function queueJump(zoneName, n) {
+  const r = await withCore(async (c) => {
+    const { z: z2, q, oid } = await queueItemAt(c, zoneName, n);
+    c.remoting.callMethodNoReply(q.oid, formatMethodSignature("Queue", "PlayFromHere", [{ type: "TransportItem", name: "item" }]), buildArgs([Arg.ref(oid)]));
+    log(`queue_jump: ${z2.name} \u2192 item ${n}`);
+    return { zone: z2.name, n };
+  });
+  return { ok: true, ...r, ...await started2(r.zone, PRIORITY["now"]) };
+}
+__name(queueJump, "queueJump");
+async function queueRemove(zoneName, ns) {
+  return withCore(async (c) => {
+    const { z: z2, q } = queueOf(c, zoneName);
+    const refs = await queueItems(c, q);
+    const at = Math.max(0, field2(c.graph.getObject(q.oid), "CurrentItemIndex") ?? 0);
+    const oids = [...new Set(ns)].map((n) => refs[at + n - 1]).filter((o) => o !== void 0);
+    if (!oids.length) throw new RoonError("No such items in the queue", "invalid");
+    c.remoting.callMethodNoReply(q.oid, formatMethodSignature("Queue", "RemoveItems", [{ type: "IEnumerable<TransportItem>", name: "items" }]), buildArgs([Arg.collection(oids.map((o) => buildArgs([Arg.ref(o)])))]));
+    log(`queue_remove: ${z2.name} \u2212 ${oids.length} item(s)`);
+    await wait(300);
+    const after = await queueItems(c, q);
+    return { ok: true, zone: z2.name, removed: oids.length, left: Math.max(0, after.length - at) };
+  });
+}
+__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);
@@ -50022,7 +49804,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);
@@ -50048,8 +49830,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);
@@ -50067,8 +49849,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");
@@ -50083,7 +49865,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);
@@ -50096,7 +49878,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);
@@ -50108,8 +49890,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;
@@ -50138,11 +49920,434 @@ 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;
+  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");
+
+// 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 `image`.',
+    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();
+var CHANGES_QUEUE = { readOnlyHint: false, destructiveHint: true, openWorldHint: false };
 var PLAYS = { readOnlyHint: false, destructiveHint: false, openWorldHint: false };
 var REMOVES = { readOnlyHint: false, destructiveHint: true, openWorldHint: false };
 var zone = external_exports.string().describe("A Roon zone name (see roon_zones).");
@@ -50162,18 +50367,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).",
@@ -50187,7 +50398,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",
@@ -50195,6 +50406,24 @@ function registerControlTools(server, internal = true) {
     inputSchema: { zone, limit: external_exports.number().int().min(1).max(200).optional() },
     annotations: { readOnlyHint: true, openWorldHint: false }
   }, ({ zone: zn, limit: limit3 }) => run(() => queue2(zn, limit3 ?? 50)));
+  reg("roon_queue_jump", {
+    title: "Jump in the queue",
+    description: "Play an item of the zone's queue now (`n` as roon_queue numbers them: 1 is what plays, 2 the next \u2026); what came before it is done. Only on an explicit request.",
+    inputSchema: { zone, n: external_exports.number().int().min(1) },
+    annotations: PLAYS
+  }, ({ zone: zn, n }) => run(() => queueJump(zn, n)));
+  reg("roon_queue_remove", {
+    title: "Remove from the queue",
+    description: "Take items out of the zone's queue, by their numbers from roon_queue (`ns`, e.g. [3, 4]). Only on an explicit request.",
+    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.",
@@ -50206,19 +50435,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").',
@@ -50233,13 +50462,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");
 
@@ -50257,7 +50486,7 @@ 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";
@@ -50273,7 +50502,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 ?? [];
@@ -50301,7 +50530,7 @@ async function newForYou(limit3, offset2) {
   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));
+    const all = items(c, decoded2(c, res.payload));
     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) => {
@@ -50329,7 +50558,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() {
@@ -50460,7 +50689,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];
@@ -50490,7 +50719,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 = [];
@@ -50624,7 +50853,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) => {
@@ -50734,7 +50963,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) };
@@ -50752,7 +50981,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");
@@ -50881,7 +51110,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);