deep-roon-mcp 0.4.5 → 0.4.6

package/README.md

@@ -22,7 +22,7 @@ server of its own and sends nothing anywhere else. What you ask goes to your MCP
 
 ## Status
 
-Version 0.4: fifty-seven tools. Qobuz, TIDAL or both — whatever is signed in on your Core.
+Version 0.4: fifty-nine tools. Qobuz, TIDAL or both — whatever is signed in on your Core.
 
 **Reading** — changes nothing in Roon:
 
@@ -32,6 +32,7 @@ Version 0.4: fifty-seven tools. Qobuz, TIDAL or both — whatever is signed in o
 | `roon_new` | Qobuz's shelves (new, qobuzissimes, press awards, top, trending, ideal discography) or TIDAL's (new, recommended, top, rising, masters; albums or tracks) — by genre |
 | `roon_genres` | Qobuz's genres and their ids, or TIDAL's genres and moods |
 | `roon_album` | An album's page: tracks, release dates, label, barcode, credits |
+| `roon_track_files` | Where your own files are: per track of an album, an artist or a list of tracks, the file path as the Core sees it (and duplicates) — Roon's export data |
 | `roon_review` | The review Roon shows, in full, with its author |
 | `roon_bio` | The biography Roon shows, in full, with related artists |
 | `roon_artist` | An artist's discography at Qobuz or TIDAL, oldest first |
@@ -108,7 +109,7 @@ The settings (Claude Desktop › Settings › Extensions › Deep Roon MCP):
 | Setting | What it does |
 |---|---|
 | Roon Core address | Empty: found on your network. Fill in the Core's address for another subnet or a private VPN (Tailscale) |
-| Essentials only | Seventeen tools instead of fifty-seven, for small models |
+| Essentials only | Seventeen tools instead of fifty-nine, for small models |
 | Use Roon's internal protocol | Off: only the official API — zones, playback, volume, grouping; no search, reviews, Focus or history |
 
 ### Other clients

package/dist/deep-roon-mcp.js

@@ -15525,7 +15525,7 @@ var require_lib2 = __commonJS({
 var version2;
 var init_package = __esm({
   "package.json"() {
-    version2 = "0.4.5";
+    version2 = "0.4.6";
   }
 });
 
@@ -16426,6 +16426,71 @@ async function discography(key, wanted) {
     return { service: SERVICE_NAME[service2], artist, albums };
   });
 }
+async function trackFiles(a) {
+  return withCore(async (c) => {
+    const cb = { type: "ResultCallback<IList<TrackExportInfo>>", name: "cb_result" };
+    let res;
+    if (a.tracks?.length) {
+      if (a.tracks.some((k) => !/^\d+$/.test(k))) throw new RoonError("A track key is a number", "invalid");
+      res = await short(c.call(
+        "Library",
+        "GetTrackExportInfo",
+        [{ type: "IEnumerable<long>", name: "ids" }, cb],
+        buildArgs([Arg.collection(a.tracks.map((k) => buildArgs([Arg.long(BigInt(k))])))]),
+        library(c)
+      ), 2e4);
+    } else if (a.album) {
+      const al = await findAlbum(c, a.album);
+      res = await short(c.call(
+        "Library",
+        "GetTrackExportInfoForAlbums",
+        [{ type: "IEnumerable<AlbumBase>", name: "albums" }, cb],
+        buildArgs([Arg.collection([buildArgs([Arg.ref(al.oid)])])]),
+        library(c)
+      ), 2e4);
+    } else if (a.artist) {
+      const p = await performer(c, a.artist);
+      res = await short(c.call(
+        "Library",
+        "GetTrackExportInfoForPerformers",
+        [{ type: "IEnumerable<PerformerBase>", name: "performers" }, cb],
+        buildArgs([Arg.collection([buildArgs([Arg.ref(p.$ref)])])]),
+        library(c)
+      ), 3e4);
+    } else throw new RoonError("Give an album key, an artist key or track keys", "invalid");
+    if (!res?.success) throw new RoonError(`Roon refused the file list (${res?.status ?? "no answer"})`);
+    if (res.payload.length < 2) return { tracks: [] };
+    const r = new BinaryReader(Uint8Array.from(res.payload));
+    r.integer();
+    const n = r.flexInt();
+    const graph = c.graph;
+    const infos = [];
+    for (let i = 0; i < n && r.remaining > 0; i++) infos.push(graph.readValue(r, 23));
+    await untilLoaded(c, infos.map((x) => field2(x, "Track")).filter(isRef2), 3e3);
+    const paden = /* @__PURE__ */ __name((x) => items(c, field2(x, "DuplicateTracks")).map((d) => field2(d, "FilePath")).filter((p) => typeof p === "string" && !!p), "paden");
+    const tracks2 = infos.map((x) => {
+      const t = obj(c, field2(x, "Track"));
+      const row = { key: String(field2(t, "TrackId") ?? "") };
+      const title = field2(t, "Title");
+      if (title) row.title = title;
+      const al = field2(obj(c, field2(t, "Album")), "Title");
+      if (al) row.album = al;
+      const n2 = field2(t, "TrackNumber");
+      if (n2 != null) row.n = n2;
+      const path2 = field2(x, "FilePath");
+      if (typeof path2 === "string" && path2) row.path = path2;
+      const format = field2(t, "Format");
+      if (format) row.format = format;
+      const dup = paden(x);
+      if (dup.length) row.duplicates = dup;
+      return row;
+    });
+    const gevraagd = a.tracks?.length ?? 0, ontbreekt = gevraagd ? gevraagd - tracks2.length : 0;
+    const zonder = tracks2.filter((t) => !t.path).length + Math.max(0, ontbreekt);
+    const of = gevraagd || tracks2.length;
+    return { tracks: tracks2, ...zonder ? { note: `${zonder} of ${of} ${of === 1 ? "track" : "tracks"} ${zonder === 1 ? "has" : "have"} no file (streaming tracks, or not on this Core's storage)` } : {} };
+  });
+}
 var SERVICE_NAME, SERVICE_TYPE, NONE2, SECTIONS, library, CREDIT_KIND, cut, choose;
 var init_library = __esm({
   "src/roon/library.ts"() {
@@ -16482,6 +16547,7 @@ var init_library = __esm({
     __name(performer, "performer");
     __name(bio, "bio");
     __name(discography, "discography");
+    __name(trackFiles, "trackFiles");
   }
 });
 
@@ -50376,6 +50442,16 @@ function registerReadTools(server, internal = true) {
     inputSchema: { key: external_exports.string().describe("An album key."), credits: external_exports.boolean().optional() },
     annotations: READ
   }, ({ key, credits }) => run(() => album(key, credits === true)));
+  reg("roon_track_files", {
+    title: "File paths",
+    description: "Where the user's own music files are: for an album (`album` key), an artist (`artist` key, all their tracks in the library) or a list of `tracks` keys, each track with its `key`, title, album, track number, format and `path` \u2014 the file as the Roon Core sees it (on the Core's storage), plus `duplicates` when Roon has the same track twice. The data behind Roon's own Export. Use it to link Roon's tracks to files, e.g. to join with data the user keeps per file. Streaming tracks (Qobuz, TIDAL) have no path.",
+    inputSchema: {
+      album: external_exports.string().optional().describe("An album key."),
+      artist: external_exports.string().optional().describe("An artist key."),
+      tracks: external_exports.array(external_exports.string()).max(500).optional().describe("Track keys.")
+    },
+    annotations: READ
+  }, ({ album: album2, artist, tracks: tracks2 }) => run(() => trackFiles({ album: album2, artist, tracks: tracks2 })));
   reg("roon_review", {
     title: "Album review",
     description: "The review Roon shows on an album's page, in full, with its author \u2014 by album `key`. When the user asks for the review (\"what does Roon say about this album\", \"show me the review\"), they want to read the review itself: show the text complete and exactly as returned, as a quote with the author's name \u2014 no paraphrase or shortening unless they ask for a summary, and don't go to the web for it. `wikipedia: true` adds the album's Wikipedia text; it also comes by itself when Roon has no review of its own. `max_chars` only when a shorter excerpt is asked for.",

package/package.json

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