fix: make media inventory discovery deterministic

src/tools.ts

@@ -536,13 +536,13 @@ export const TOOLS: ToolDef[] = [
   {
     name: "unraid_files_inventory",
     description:
-      "Inventory file and directory names below one exact Unraid share in one bounded read-only call. Use this instead of repeated ls/find calls for media-library audits, missing-episode checks and locating a named collection. It never reads file contents. If name_contains matches a directory, that directory and its descendants are returned; unrelated trees are omitted.",
+      "Inventory file and directory names below one exact Unraid share in a bounded read-only call. Use this instead of repeated ls/find calls for media-library audits and missing-episode checks. It never reads file contents. To locate a collection, first search directories with name_contains; then call this tool once more with the returned directory as relative_path and an empty name_contains to inventory that collection.",
     inputSchema: {
       type: "object",
       properties: {
         share: str("Exact Unraid share name, for example Audiobooks"),
         relative_path: str("Optional path below the share; never use /mnt/user or an absolute path"),
-        name_contains: str("Optional case-insensitive name fragment, for example 'drei'. Matching directories include their descendants"),
+        name_contains: str("Optional case-insensitive path fragment, for example 'drei'. It filters returned entries; use a second call on a matched directory to list its descendants"),
         max_depth: int("Maximum directory depth below relative_path (1-20, default 10)"),
         max_entries: int("Maximum returned entries (1-5000, default 2000)"),
         include_files: { type: "boolean", description: "Include files (default true)" },