sonarr, radarr: full nox modules — clients, tools and events (ADR 0044/0046)

The Servarr apps (TV, movies), each self-contained from hal's shared arr client. Tools: status, library, search, queue, calendar. Events by polling the download queue: a new item emits module.<app>.<thing>.grabbed, an item that leaves as completed emits module.<app>.download.completed — the exact key plex consumes to rescan. A grab that left as failed/warning is not reported as a completion. Both typecheck; manifests parse.
2026-09-04 02:33:32 +02:00
parent 259c3721b5
commit fb42fb956b
12 changed files with 588 additions and 0 deletions
@@ -0,0 +1,78 @@
+// radarr's tools — ported from the shared hal sdk (novox/hq ADR 0044), importing radarr's own
+// client. They return structured data (not pre-formatted text as hal did); the mesh serves them
+// through the sdk's tool harness.
+
+import { registerModuleTools, type ToolDefinition } from "@novox/mesh-sdk/tools";
+import { RadarrClient } from "../client.js";
+
+export function getRadarrTools(radarr: RadarrClient): ToolDefinition[] {
+  return [
+    {
+      name: "radarr_status",
+      description: "Radarr status overview: version, movie count, monitored count, queue size.",
+      input: {},
+      run: async () => {
+        const [status, content, queue] = await Promise.all([
+          radarr.getStatus(),
+          radarr.getContent(),
+          radarr.getQueue(),
+        ]);
+        return {
+          app: status.appName,
+          version: status.version,
+          movies: content.length,
+          monitored: content.filter((c) => c.monitored).length,
+          queue: queue.totalRecords,
+        };
+      },
+    },
+    {
+      name: "radarr_library",
+      description: "List movies from the Radarr library.",
+      input: { limit: { type: "number", description: "max items to return (default 50)" } },
+      run: async (args) => {
+        const items = await radarr.getContent(args.limit ? Number(args.limit) : 50);
+        return { count: items.length, movies: items };
+      },
+    },
+    {
+      name: "radarr_search",
+      description: "Search the Radarr library for movies by title (filters existing content, not indexers).",
+      input: { query: { type: "string", description: "the search term" } },
+      run: async (args) => {
+        const query = String(args.query);
+        return { query, results: await radarr.searchContent(query) };
+      },
+    },
+    {
+      name: "radarr_queue",
+      description: "Show the Radarr download queue — what is downloading and how far along.",
+      input: {},
+      run: async () => {
+        const queue = await radarr.getQueue();
+        return { count: queue.totalRecords, items: queue.items };
+      },
+    },
+    {
+      name: "radarr_calendar",
+      description: "Upcoming movie releases from the Radarr calendar.",
+      input: { days: { type: "number", description: "how many days to look ahead (default 7)" } },
+      run: async (args) => {
+        const days = args.days ? Number(args.days) : 7;
+        const items = await radarr.getCalendar(days);
+        items.sort((a, b) => a.date.localeCompare(b.date));
+        return { days, count: items.length, items };
+      },
+    },
+  ];
+}
+
+// The tools exist only when Radarr is configured; without a URL and key, radarr contributes none
+// rather than failing the whole runtime.
+registerModuleTools("radarr", (env) => {
+  try {
+    return getRadarrTools(RadarrClient.fromEnv(env));
+  } catch {
+    return [];
+  }
+});