homeassistant.list_filtered_entities: rename input parameter label_id -> labels; update schema and docs; add docs preview README

Author: ekobres

custom_components/spook/ectoplasms/homeassistant/services/list_filtered_entities.py

@@ -165,7 +165,7 @@ def _parse_service_call(
         domains = call.data.get("domains", [])
         integrations = call.data.get("integrations", [])
         status = call.data.get("status", [])
-        label_id = call.data.get("label_id", [])
+        labels = call.data.get("labels", [])
         values = call.data.get("values", [])
         limit = call.data.get("limit")
 
@@ -182,7 +182,7 @@ def _parse_service_call(
             "domains": domains,
             "integrations": integrations,
             "status": status,
-            "labels": label_id,
+            "labels": labels,
         }
 
         return filters, values, limit

custom_components/spook/services.yaml

@@ -1324,7 +1324,7 @@ homeassistant_list_filtered_entities:
               label: Not provided
             - value: unmanageable
               label: Unmanageable
-    label_id:
+    labels:
       name: Labels
       description: Filter by specific labels (OR logic within this filter).
       required: false

documentation/README.md

@@ -0,0 +1,30 @@
+# Documentation preview quickstart
+
+Run the local MyST preview for this folder.
+
+- Using the VS Code task (recommended):
+
+  - Terminal > Run Task… > "Preview documentation"
+  - It runs: `cd documentation && myst start`
+
+- Using CLI (no global install needed):
+
+  - macOS with Homebrew Node 20:
+    ```bash
+    export PATH="/opt/homebrew/opt/node@20/bin:$PATH"
+    cd documentation
+    uvx --from mystmd myst start
+    ```
+  - Then open: http://localhost:3000
+  - Stop with Ctrl+C
+
+- Alternative with npx (if you prefer npm):
+  ```bash
+  cd documentation
+  npx mystmd myst start
+  ```
+
+Notes
+
+- Requires Node.js 20 or newer in your PATH.
+- Run the command from the `documentation/` directory (don’t pass extra flags like `--config` or `--serve`).

documentation/entities.md

@@ -326,7 +326,7 @@ The action supports comprehensive filtering by search terms, areas, devices, dom
   - {term}`string <string>` | {term}`list of strings <list>`
   - No
   - `["enabled", "available"]`
-* - `label_id`
+* - `labels`
   - {term}`string <string>` | {term}`list of strings <list>`
   - No
   - `["security", "automation_controlled"]`
@@ -422,7 +422,7 @@ List entities with specific labels:
 :linenos:
 action: homeassistant.list_filtered_entities
 data:
-  label_id:
+  labels:
     - security
     - automation_controlled
   values: