ha-mcp-dev 8.5.0.dev2737__tar.gz → 8.5.0.dev2742__tar.gz

{ha_mcp_dev-8.5.0.dev2737/src/ha_mcp_dev.egg-info → ha_mcp_dev-8.5.0.dev2742}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 8.5.0.dev2737
+Version: 8.5.0.dev2742
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.5.0.dev2737"
+version = "8.5.0.dev2742"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 # Upper bound widened to <3.15 so the package installs on Home Assistant's

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/az.json

@@ -700,7 +700,7 @@
     },
     "ha_eval_template": {
       "title": "Şablonu emal et",
-      "description": "Home Assistant-ın şablon mühərrikindən istifadə edərək Jinja2 şablonlarını emal edin."
+      "description": "Home Assistant-də Jinja2 şablonunun render edilməsini və ya avtomatlaşdırma şərtinin yoxlanılmasını icra edin."
     },
     "ha_get_app": {
       "title": "Tətbiqləri (əlavələri) al",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/cs.json

@@ -669,7 +669,7 @@
     },
     "ha_eval_template": {
       "title": "Vyhodnotit šablonu",
-      "description": "Vyhodnotit šablony Jinja2 pomocí šablonovacího enginu Home Assistant."
+      "description": "Provede vykreslení šablony Jinja2 nebo kontrolu podmínki automatizace v Home Assistant."
     },
     "ha_get_app": {
       "title": "Získat aplikace (doplňky)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/de.json

@@ -700,7 +700,7 @@
     },
     "ha_eval_template": {
       "title": "Template auswerten",
-      "description": "Wertet ein Jinja2-Template mit der Home-Assistant-Engine aus."
+      "description": "Führe ein Jinja2-Template-Rendering oder eine Automatisierungs-Bedingungsprüfung in Home Assistant aus."
     },
     "ha_get_app": {
       "title": "Apps (Add-ons) abrufen",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/eo.json

@@ -669,7 +669,7 @@
     },
     "ha_eval_template": {
       "title": "Taksi Ŝablonon",
-      "description": "Taksi Jinja2-ŝablonojn uzante la ŝablonan motoron de Home Assistant."
+      "description": "Plenumi Jinja2-ŝablonan rendorigon, aŭ aŭtomatigan kondiĉan kontrolon, en Home Assistant."
     },
     "ha_get_app": {
       "title": "Akiri programojn (aldonaĵojn)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/es.json

@@ -700,7 +700,7 @@
     },
     "ha_eval_template": {
       "title": "Evaluar plantilla",
-      "description": "Evalúa plantillas Jinja2 con el motor de plantillas de Home Assistant."
+      "description": "Ejecuta una renderización de plantilla Jinja2, o una comprobación de condición de automatización, en Home Assistant."
     },
     "ha_get_app": {
       "title": "Obtener Apps (add-ons)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/fr.json

@@ -700,7 +700,7 @@
     },
     "ha_eval_template": {
       "title": "Évaluer le modèle",
-      "description": "Évalue un modèle Jinja2 avec le moteur Home Assistant."
+      "description": "Exécute le rendu d'un modèle Jinja2 ou une vérification de condition d'automatisation dans Home Assistant."
     },
     "ha_get_app": {
       "title": "Obtenir des applications (add-ons)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/it.json

@@ -700,7 +700,7 @@
     },
     "ha_eval_template": {
       "title": "Valuta un template",
-      "description": "Valuta i template Jinja2 usando il motore dei template di Home Assistant."
+      "description": "Esegue il rendering di un template Jinja2 o un controllo delle condizioni di un'automazione in Home Assistant."
     },
     "ha_get_app": {
       "title": "Ottieni app (componenti aggiuntivi)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/ko.json

@@ -700,7 +700,7 @@
     },
     "ha_eval_template": {
       "title": "템플릿 평가",
-      "description": "Home Assistant 템플릿 엔진으로 Jinja2 템플릿을 평가합니다."
+      "description": "Home Assistant에서 Jinja2 템플릿 렌더링 또는 자동화 조건 검사를 실행합니다."
     },
     "ha_get_app": {
       "title": "앱(애드온) 조회",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/nl.json

@@ -669,7 +669,7 @@
     },
     "ha_eval_template": {
       "title": "Evalueer Sjabloon",
-      "description": "Evalueer Jinja2-sjablonen met behulp van de sjabloonengine van Home Assistant."
+      "description": "Voer een Jinja2-sjabloonweergave of een automatiseringsvoorwaardecontrole uit in Home Assistant."
     },
     "ha_get_app": {
       "title": "Apps ophalen (add-ons)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/pl.json

@@ -669,7 +669,7 @@
     },
     "ha_eval_template": {
       "title": "Oceń szablon",
-      "description": "Oceń szablony Jinja2 za pomocą silnika szablonów Home Assistant."
+      "description": "Wykonaj renderowanie szablonu Jinja2 lub sprawdź warunek automatyzacji w Home Assistant."
     },
     "ha_get_app": {
       "title": "Pobierz aplikacje (dodatki)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/ru.json

@@ -700,7 +700,7 @@
     },
     "ha_eval_template": {
       "title": "Вычислить шаблон",
-      "description": "Вычислить Jinja2-шаблон с помощью движка Home Assistant."
+      "description": "Выполнить рендеринг шаблона Jinja2 или проверку условия автоматизации в Home Assistant."
     },
     "ha_get_app": {
       "title": "Получить приложения (аддоны)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/sv.json

@@ -669,7 +669,7 @@
     },
     "ha_eval_template": {
       "title": "Utvärdera Mall",
-      "description": "Utvärdera Jinja2-mallar med Home Assistants mallmotor."
+      "description": "Kör en Jinja2-mallrendering eller en automationsvillkorskontroll i Home Assistant."
     },
     "ha_get_app": {
       "title": "Hämta appar (tillägg)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/zh-Hans.json

@@ -700,7 +700,7 @@
     },
     "ha_eval_template": {
       "title": "评估模板",
-      "description": "使用 Home Assistant 的模板引擎评估 Jinja2 模板。"
+      "description": "在 Home Assistant 中执行 Jinja2 模板渲染或自动化条件检查。"
     },
     "ha_get_app": {
       "title": "获取应用（add-on）",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/settings_ui/locales/zh-Hant.json

@@ -669,7 +669,7 @@
     },
     "ha_eval_template": {
       "title": "評估範本",
-      "description": "使用 Home Assistant 的範本引擎評估 Jinja2 範本。"
+      "description": "在 Home Assistant 中執行 Jinja2 範本渲染或自動化條件檢查。"
     },
     "ha_get_app": {
       "title": "取得應用程式 (add-ons)",

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/tools/backup.py

@@ -1718,17 +1718,15 @@ survives an agent's own mistakes.
             bool,
             Field(
                 default=False,
-                description="(snapshot.restore) Include database in the restore. Default false (config-only).",
+                description="(snapshot.restore) Include the database in the restore; otherwise "
+                "config only.",
             ),
         ] = False,
         confirm: Annotated[
             bool,
             Field(
                 default=False,
-                description=(
-                    "(snapshot.delete) Must be True to confirm deletion — a "
-                    "safety measure against accidental calls."
-                ),
+                description=("(snapshot.delete) Must be True to confirm deletion."),
             ),
         ] = False,
         # edits scope params

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/tools/tools_addons.py

@@ -3759,8 +3759,7 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         source: Annotated[
             Literal["installed", "available"] | None,
             Field(
-                description="App (add-on) source: 'installed' (default) for currently installed apps, "
-                "'available' for apps in the store that can be installed. "
+                description="App (add-on) source. "
                 "With source='available', 'version' is the version you would "
                 "get by installing (Supervisor's version_latest) and "
                 "'version_installed' is the running one, null when the app is "
@@ -3772,7 +3771,7 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         slug: Annotated[
             str | None,
             Field(
-                description="App (add-on) slug for detailed info (e.g., '<prefix>_nodered'). "
+                description="App (add-on) slug (e.g., '<prefix>_nodered'). "
                 "Slug prefixes vary by app repository — omit to list all apps "
                 "and discover the actual installed slug.",
                 default=None,
@@ -3806,8 +3805,7 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         ``ha_manage_app``. Use ``slug`` for details, ``source="installed"`` for an
         inventory, or ``source="available"`` for store discovery.
 
-        Requires Home Assistant OS or Supervised. ``include_stats`` applies only
-        to installed-app listings.
+        Requires Home Assistant OS or Supervised.
         """
         return await tools.get_addon(
             source=source,
@@ -3832,13 +3830,11 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         slug: Annotated[
             str,
             Field(
-                description="App (add-on) slug (e.g., '<prefix>_nodered', '<prefix>_frigate'). "
-                "Slug prefixes vary by app repository — call ha_get_app() "
-                "to discover the actual installed slug. Required for every mode "
-                "except the store-repository actions "
-                "(action='add_repository'/'remove_repository'), which use "
-                "'repository' instead and take no slug, and the store-wide "
-                "action (action='check_updates'), which takes neither.",
+                description="App (add-on) slug (e.g., '<prefix>_nodered', '<prefix>_frigate'). Slug"
+                " prefixes vary by app repository — call ha_get_app() to discover the "
+                "actual installed slug. Required except for action='add_repository' / "
+                "'remove_repository' (which take 'repository' instead) and "
+                "action='check_updates' (which takes neither).",
                 default="",
             ),
         ] = "",
@@ -3847,14 +3843,14 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
             Field(
                 description="Proxy mode: API path relative to the app (add-on) root "
                 "(e.g., '/flows', '/api/events', '/api/stats'). "
-                "Required for proxy mode; mutually exclusive with config parameters.",
+                "Required for proxy mode.",
                 default=None,
             ),
         ] = None,
         method: Annotated[
             str,
             Field(
-                description="Proxy mode only. HTTP method: GET, POST, PUT, DELETE, PATCH. Defaults to GET.",
+                description="Proxy mode only. HTTP method: GET, POST, PUT, DELETE, PATCH.",
                 default="GET",
             ),
         ] = "GET",
@@ -3868,25 +3864,25 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         debug: Annotated[
             bool,
             Field(
-                description="Proxy mode only. Include diagnostic info (request URL, headers sent, response headers). Default: false.",
+                description="Proxy mode only. Include diagnostic info (request URL, headers sent, "
+                "response headers).",
                 default=False,
             ),
         ] = False,
         port: Annotated[
             int | None,
             Field(
-                description="Proxy mode only. Connect to this port instead of the Ingress port. "
-                "Use ha_get_app(slug='...') to find available ports. Some apps, including "
-                "Node-RED, reject direct access unless their leave_front_door_open option is "
-                "enabled and the app is restarted; related errors include an actionable, "
-                "security-qualified ha_manage_app options command.",
+                description="Proxy mode only. Connect to this port instead of the Ingress port. Use"
+                " ha_get_app(slug='...') to find available ports. Some apps, including "
+                "Node-RED, reject direct access unless their leave_front_door_open "
+                "option is enabled and the app is restarted.",
                 default=None,
             ),
         ] = None,
         offset: Annotated[
             int,
             Field(
-                description="Proxy mode only. HTTP: skip this many items in a JSON array response. Default: 0.",
+                description="Proxy mode only. HTTP: skip this many items in a JSON array response.",
                 default=0,
             ),
         ] = 0,
@@ -3900,10 +3896,9 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         websocket: Annotated[
             bool,
             Field(
-                description="Proxy mode only. Use WebSocket instead of HTTP for an app "
-                "(add-on) WebSocket API. Sends 'body' as the initial message and collects "
-                "responses; command names and body schemas are app/version-specific. "
-                "Default: false.",
+                description="Proxy mode only. Use WebSocket instead of HTTP for an app (add-on) "
+                "WebSocket API. Sends 'body' as the initial message and collects "
+                "responses; command names and body schemas are app/version-specific.",
                 default=False,
             ),
         ] = False,
@@ -3911,9 +3906,9 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
             bool,
             Field(
                 description="Proxy mode only. WebSocket: True waits for the server to close a "
-                "run-to-completion stream. False returns after the first response batch; use "
-                "for one-shot command/response or bounded capture on a channel that stays "
-                "open. Default: true.",
+                "run-to-completion stream. False returns after the first response "
+                "batch; use for one-shot command/response or bounded capture on a "
+                "channel that stays open.",
                 default=True,
             ),
         ] = True,
@@ -3921,37 +3916,37 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
             int | None,
             Field(
                 description="Proxy mode only. WebSocket: cap on messages collected from the wire, "
-                "bounded by an internal safety ceiling. None = collect up to the ceiling. "
-                "Lower to save tokens on noisy streams (e.g., message_limit=50 for a quick health check).",
+                "bounded by an internal safety ceiling. None = collect up to the "
+                "ceiling.",
                 default=None,
             ),
         ] = None,
         message_offset: Annotated[
             int,
             Field(
-                description="Proxy mode only. WebSocket: drop this many messages from the start of the "
-                "collected list before returning. Useful for paginating past known-noisy headers. Default: 0.",
+                description="Proxy mode only. WebSocket: drop this many messages from the start of "
+                "the collected list before returning.",
                 default=0,
             ),
         ] = 0,
         summarize: Annotated[
             bool,
             Field(
-                description="Proxy mode only. WebSocket: when True (default), collapse runs of "
-                "non-signal messages (typically YAML config dumps) into short elision markers. "
-                "Set to False to return the raw stream.",
+                description="Proxy mode only. WebSocket: when True, collapse runs of non-signal "
+                "messages (typically YAML config dumps) into short elision markers. Set"
+                " to False to return the raw stream.",
                 default=True,
             ),
         ] = True,
         python_transform: Annotated[
             str | None,
             Field(
-                description="Proxy mode only. Sandboxed Python expression that post-processes the response. "
-                "Variable `response` is exposed — a list[dict | str] for WebSocket (parsed JSON or raw text), "
-                "or dict/list/str for HTTP (parsed body). Supports in-place mutation "
-                "(response.append(...)) or reassignment (response = [...]). "
-                "Example: response = [m for m in response if 'ERROR' in str(m)]. "
-                "Post-processing only — does not provide optimistic-locking write semantics.",
+                description="Proxy mode only. Sandboxed Python expression that post-processes the "
+                "response. Variable `response` is exposed — a list[dict | str] for "
+                "WebSocket (parsed JSON or raw text), or dict/list/str for HTTP (parsed"
+                " body). Supports in-place mutation (response.append(...)) or "
+                "reassignment (response = [...]). Example: response = [m for m in "
+                "response if 'ERROR' in str(m)].",
                 default=None,
             ),
         ] = None,
@@ -4032,26 +4027,18 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
                 description="Lifecycle mode: run a Supervisor app (add-on) action. One of "
                 "'install', 'uninstall', 'start', 'stop', 'restart', 'rebuild', "
                 "'update'. 'install'/'update' require the app's repository to be "
-                "registered (it appears in ha_get_app(source='available')). "
-                "Store-repository mode: 'add_repository' / 'remove_repository' "
-                "register or unregister a custom app store repository — these "
-                "use the 'repository' param instead of 'slug'. "
-                "Store-wide mode: 'check_updates' reloads the store so "
-                "Supervisor re-scans its repositories, mirroring the Apps UI "
-                "'Check for updates' item — it takes neither 'slug' nor "
-                "'repository', refreshes available metadata only, and installs "
-                "nothing. Use it to pick up an edited local app's config.yaml "
-                "on demand instead of waiting for Supervisor's own reload "
-                "(every 3h). Follow with action='update' to install a new "
-                "version, or action='rebuild' for a local app whose source "
-                "changed but whose version did not. Returns 'changed' and "
-                "'updates_available', each null (not empty) if the store "
-                "could not be read to measure it — check 'warnings'. "
-                "When ha-mcp runs as an app, it can update other apps but cannot "
-                "update its own running slug; update ha-mcp from the Home Assistant "
-                "Apps UI. "
-                "Mutually exclusive with path / config parameters / array_patch. "
-                "HA OS / Supervised only.",
+                "registered (it appears in ha_get_app(source='available')); 'rebuild' "
+                "is for a local app whose source changed but whose version did not. "
+                "Store-repository mode: 'add_repository' / 'remove_repository' register"
+                " or unregister a custom app store repository — these use the "
+                "'repository' param instead of 'slug'. Store-wide mode: 'check_updates'"
+                " reloads the store so Supervisor re-scans its repositories (e.g. after"
+                " editing a local app's config.yaml) — it takes neither 'slug' nor "
+                "'repository', refreshes available metadata only, and installs nothing;"
+                " follow with action='update' for a newer version, or action='rebuild' "
+                "for a local app whose source changed without a version change. Returns"
+                " 'changed' and 'updates_available', null when the store could not be "
+                "read (see 'warnings').",
                 default=None,
             ),
         ] = None,
@@ -4071,24 +4058,24 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         """Manage Home Assistant apps (add-ons) or proxy an app API.
 
         For app inventory, status, and Supervisor metadata, call ``ha_get_app``
-        first; use proxy mode here for documented app-specific read APIs.
-        Do not infer private app API schemas; consult version-matched app docs,
-        and use ``ha_get_skill_guide`` for complex Home Assistant workflows.
+        first; use proxy mode here for documented app-specific read APIs, and
+        do not infer private app API schemas.
 
         Use exactly one mode: lifecycle/store action, configuration fields,
         ``path`` proxy, or ``path`` with ``array_patch``.
 
-        Requires Home Assistant OS or Supervised. ``options`` merges top-level
-        keys and one nested mapping level; supply complete values for deeper nested
-        mappings because they are replaced. A non-empty ``network`` replaces the
-        full port override map. Prefer
-        Ingress: direct-port access requires a shared container network and may
-        require weakening the target app authentication. If a Supervisor
-        lifecycle, configuration, or repository write has an unknown outcome,
-        verify durable state with ``ha_get_app`` before retrying. That cannot
-        prove whether ``restart`` or ``rebuild`` ran; inspect Supervisor jobs
-        and logs and do not automatically replay them. For a proxy or array-patch
-        write, query the target app's own read API before retrying.
+        Requires Home Assistant OS or Supervised. When ha-mcp itself runs as an
+        app it cannot update its own running slug; update ha-mcp from the Home
+        Assistant Apps UI. ``options`` merges top-level keys and one nested
+        mapping level; supply complete values for deeper nested mappings
+        because they are replaced. Prefer Ingress: direct-port access requires
+        a shared container network and may require weakening the target app
+        authentication. If a Supervisor lifecycle, configuration, or repository
+        write has an unknown outcome, verify durable state with ``ha_get_app``
+        before retrying. That cannot prove whether ``restart`` or ``rebuild``
+        ran; inspect Supervisor jobs and logs and do not automatically replay
+        them. For a proxy or array-patch write, query the target app's own read
+        API before retrying.
         """
         return await tools.manage_addon(
             slug=slug,

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/tools/tools_areas.py

@@ -285,12 +285,10 @@ class AreaTools:
             Field(
                 default=None,
                 description=(
-                    "Return only the specified top-level response keys to reduce "
-                    'response size (e.g. ["floors"]). '
-                    "None = full response (default). "
-                    "Available keys: success, floor_count, area_count, "
-                    "unassigned_count, orphaned_count, floors, unassigned_areas, "
-                    "orphaned_areas, message."
+                    "Return only the specified top-level response keys to reduce response "
+                    'size (e.g. ["floors"]). None = full response. Available keys: success,'
+                    " floor_count, area_count, unassigned_count, orphaned_count, floors, "
+                    "unassigned_areas, orphaned_areas, message."
                 ),
             ),
         ] = None,
@@ -300,11 +298,11 @@ class AreaTools:
             Field(
                 default=None,
                 description=(
-                    "Project each area record (in floors[].areas, unassigned_areas, "
-                    'and orphaned_areas) to only the specified keys. E.g. ["area_id", '
-                    '"name"] returns slim area records. None = full records (default). '
-                    "Unknown keys yield empty records. Available keys: area_id, name, "
-                    "icon, floor_id, aliases, picture, labels."
+                    "Project each area record (in floors[].areas, unassigned_areas, and "
+                    'orphaned_areas) to only the specified keys. E.g. ["area_id", "name"] '
+                    "returns slim area records. None = full records. Unknown keys yield "
+                    "empty records. Available keys: area_id, name, icon, floor_id, aliases,"
+                    " picture, labels."
                 ),
             ),
         ] = None,
@@ -312,7 +310,7 @@ class AreaTools:
         """
         List floors sorted by level ascending, each with their assigned areas nested, plus areas without a floor.
 
-        Use for location-based reasoning where floor-to-area relationships matter, such as "which rooms are on the ground floor" or operations scoped to a level. Optionally project the response with fields= (top-level keys) or area_fields= (per-area-record keys, applied uniformly across nested, unassigned, and orphaned buckets).
+        Use for location-based reasoning where floor-to-area relationships matter, such as "which rooms are on the ground floor" or operations scoped to a level.
 
         Floors with level=None sort alongside level 0 (ground floor). Areas without a floor assignment appear in unassigned_areas; areas whose floor_id points to a non-existent floor appear in orphaned_areas. When the ha_mcp_tools component's registries capability is available, both registries come from a single in-process snapshot, so this classification is always consistent. Without it (legacy path), the two registries are fetched via independent WebSocket calls and a registry change between reads may transiently misclassify an area.
         """
@@ -755,21 +753,21 @@ class AreaTools:
         id: Annotated[  # noqa: A002
             str | None,
             Field(
-                description="Existing area_id or floor_id to update (omit to create a new entry; use ha_list_floors_areas to find IDs)",
+                description="Existing area_id or floor_id to update (use ha_list_floors_areas to find IDs)",
                 default=None,
             ),
         ] = None,
         floor_id: Annotated[
             str | None,
             Field(
-                description="Floor assignment when kind='area' (use empty string to clear). Only valid when kind='area'.",
+                description="Floor assignment when kind='area' (use empty string to clear).",
                 default=None,
             ),
         ] = None,
         level: Annotated[
             int | None,
             Field(
-                description="Numeric level when kind='floor' (0=ground, 1=first, -1=basement). Only valid when kind='floor'.",
+                description="Numeric level when kind='floor' (0=ground, 1=first, -1=basement).",
                 default=None,
             ),
         ] = None,
@@ -791,7 +789,7 @@ class AreaTools:
         picture: Annotated[
             str | None,
             Field(
-                description="Picture URL when kind='area' (empty string to remove). Only valid when kind='area'.",
+                description="Picture URL when kind='area' (empty string to remove).",
                 default=None,
             ),
         ] = None,
@@ -802,7 +800,7 @@ class AreaTools:
                 description=(
                     "Label IDs when kind='area' (replaces the area's label set; "
                     "empty list to clear). Omit to leave labels unchanged. "
-                    "Only valid when kind='area' — floors have no labels."
+                    "Floors have no labels."
                 ),
                 default=None,
             ),

{ha_mcp_dev-8.5.0.dev2737 → ha_mcp_dev-8.5.0.dev2742}/src/ha_mcp/tools/tools_assist_pipeline.py

@@ -565,9 +565,7 @@ class AssistPipelineTools:
             Field(
                 description=(
                     "Natural-language command to run through Assist. Required when "
-                    "action='process'. A matched intent executes, and with the "
-                    "built-in agent a sentence matching a conversation trigger "
-                    "runs that automation."
+                    "action='process'."
                 ),
                 default=None,
             ),
@@ -695,8 +693,8 @@ class AssistPipelineTools:
             bool,
             Field(
                 description=(
-                    "For create/update only, also set the resulting pipeline as "
-                    "preferred with an extra websocket call. Ignored for other actions."
+                    "For create/update only, also set the resulting pipeline as preferred. "
+                    "Ignored for other actions."
                 ),
                 default=False,
             ),
@@ -719,53 +717,19 @@ class AssistPipelineTools:
         this to test what Assist itself understands. When the built-in agent
         answers, a matching conversation trigger runs its automation: that
         agent checks its sentence triggers before it matches intents, so this
-        is not limited to intents. pipeline_id borrows a pipeline's
-        conversation agent and language, but the sentence still goes to the
-        agent directly. So with an agent other than the built-in one, neither
+        is not limited to intents. Even with pipeline_id, the sentence goes
+        to the agent directly. So with an agent other than the built-in one, neither
         sentence triggers nor prefer_local_intents apply — a full pipeline run
         is what adds those for other agents.
 
         EXAMPLES:
-        - List pipelines: ha_manage_pipeline(action="list")
-        - Get one pipeline: ha_manage_pipeline(action="get", pipeline_id="preferred")
-        - Create by cloning preferred: ha_manage_pipeline(
-              action="create",
-              name="Local Assist",
-              conversation_engine="conversation.local_llm",
-          )
-        - Create by cloning a specific pipeline: ha_manage_pipeline(
-              action="create",
-              base_pipeline_id="preferred",
-              name="Local Assist",
-              conversation_engine="conversation.local_llm",
-          )
-        - Update conversation agent and clear TTS voice: ha_manage_pipeline(
-              action="update",
-              pipeline_id="preferred",
-              conversation_engine="conversation.local_llm",
-              tts_voice="",
-          )
-        - Set preferred: ha_manage_pipeline(
-              action="set_preferred",
-              pipeline_id="preferred",
-          )
-        - Run a sentence: ha_manage_pipeline(
-              action="process",
-              sentence="turn on the kitchen light",
-          )
-        - Run it through one pipeline's agent: ha_manage_pipeline(
-              action="process",
-              sentence="turn on the kitchen light",
-              pipeline_id="preferred",
-          )
-        - Continue a conversation: ha_manage_pipeline(
-              action="process",
-              sentence="and the hallway?",
-              conversation_id="<id from the previous response>",
-          )
-
-        Empty string clears nullable STT/TTS/wake-word fields. Non-nullable
-        fields such as name, language, conversation_language, and
+        - Get the preferred pipeline: ha_manage_pipeline(action="get", pipeline_id="preferred")
+        - Create by cloning a pipeline: ha_manage_pipeline(action="create", base_pipeline_id="preferred", name="Local Assist", conversation_engine="conversation.local_llm")
+        - Update the agent and clear the TTS voice: ha_manage_pipeline(action="update", pipeline_id="preferred", conversation_engine="conversation.local_llm", tts_voice="")
+        - Run a sentence through one pipeline's agent: ha_manage_pipeline(action="process", sentence="turn on the kitchen light", pipeline_id="preferred")
+        - Continue a conversation: ha_manage_pipeline(action="process", sentence="and the hallway?", conversation_id="<id from the previous response>")
+
+        Non-nullable fields such as name, language, conversation_language, and
         conversation_engine must be omitted or non-empty.
         """
         try: