// radarr's tools — ported from the shared hal sdk (novox/hq ADR 0039), 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 []; } });