release: r015 compact filtered Docker inventory

src/tools.ts

@@ -74,9 +74,29 @@ export const TOOLS: ToolDef[] = [
   {
     name: "unraid_docker_list",
     description:
-      "List all Docker containers with runtime stats (CPU, memory, network I/O). Returns a compact JSON summary.",
-    inputSchema: empty,
-    handler: () => containerRuntimeSummary(),
+      "List Docker containers and return authoritative server-side counts. For questions about active/currently running containers, ALWAYS use state='running'. Defaults to a compact response without performance statistics to avoid large tool output. Use include_stats=true only when CPU, RAM or I/O values are explicitly needed.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        state: {
+          type: "string",
+          enum: ["all", "running", "stopped", "created", "exited"],
+          description: "Filter by container state. Use 'running' for active/running containers; 'stopped' means every non-running container. Default: all.",
+        },
+        include_stats: bool("Include live CPU, RAM, network and block-I/O statistics. Expensive and verbose; default false."),
+        detail: {
+          type: "string",
+          enum: ["compact", "full"],
+          description: "compact returns name/status/state; full additionally returns ID, image and ports. Default: compact.",
+        },
+      },
+      additionalProperties: false,
+    },
+    handler: (a) => containerRuntimeSummary({
+      state: (a["state"] as "all" | "running" | "stopped" | "created" | "exited" | undefined),
+      includeStats: a["include_stats"] === true,
+      detail: (a["detail"] as "compact" | "full" | undefined),
+    }),
   },
   {
     name: "unraid_docker_inspect",