ha-mcp-dev 8.5.0.dev2740__tar.gz → 8.5.0.dev2745__tar.gz

{ha_mcp_dev-8.5.0.dev2740/src/ha_mcp_dev.egg-info → ha_mcp_dev-8.5.0.dev2745}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 8.5.0.dev2740
+Version: 8.5.0.dev2745
 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.dev2740 → ha_mcp_dev-8.5.0.dev2745}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.5.0.dev2740"
+version = "8.5.0.dev2745"
 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.dev2740 → ha_mcp_dev-8.5.0.dev2745}/src/ha_mcp/server.py

@@ -662,11 +662,23 @@ class HomeAssistantSmartMCPServer:
         "ha_config_set_automation": (
             "create update modify edit automation triggers conditions actions "
             "new automation write save take control blueprint detach "
-            "unlink standalone convert"
+            "unlink standalone convert enable disable turn on off run trigger now"
         ),
         "ha_config_set_script": (
             "create update modify edit script sequence actions new script write "
-            "save take control blueprint detach unlink standalone convert"
+            "save take control blueprint detach unlink standalone convert "
+            "run start stop execute"
+        ),
+        "ha_config_set_scene": (
+            "create update modify edit scene entities snapshot activate apply turn on"
+        ),
+        "ha_manage_updates": (
+            "update updates install skip firmware core os repair repairs issue "
+            "ignore dismiss unignore"
+        ),
+        "ha_set_integration": (
+            "integration config entry enable disable add options reconfigure "
+            "log level debug logging"
         ),
         "ha_config_set_yaml": (
             "edit yaml configuration.yaml packages template sensor "
@@ -743,7 +755,9 @@ class HomeAssistantSmartMCPServer:
             "to convert a blueprint-backed automation into an editable "
             "standalone one (the UI's Take control action). Omit "
             "`identifier` to create a new automation. Reusing an identifier targets "
-            "the same automation; changing its alias requires config_hash from a prior read.\n\n"
+            "the same automation; changing its alias requires config_hash from a prior read. "
+            "`enabled` turns it on or off and `run_actions` runs it now, with a "
+            "write or alone with `identifier`.\n\n"
             "For schema details, examples, and native-vs-template "
             "guidance, see ha_get_skill_guide or your locally "
             "installed skills."
@@ -763,7 +777,8 @@ class HomeAssistantSmartMCPServer:
             "`config_hash` from ha_config_get_script), or "
             "`take_control_of_blueprint` to convert a blueprint-backed "
             "script into an editable standalone one. `script_id` names "
-            "the script in every mode.\n\n"
+            "the script in every mode. `run` ('start' / 'stop'), used alone "
+            "with `script_id`, starts or stops the script.\n\n"
             "For schema details and examples, see "
             "ha_get_skill_guide or your locally installed skills."
         ),
@@ -782,7 +797,8 @@ class HomeAssistantSmartMCPServer:
             "Create or update a Home Assistant scene.\n\n"
             "Supports two modes: full `config` replacement, or surgical "
             "`python_transform` on an existing scene (requires "
-            "`config_hash`). `scene_id` names the scene in both modes.\n\n"
+            "`config_hash`). `scene_id` names the scene in both modes. "
+            "`activate` activates the scene, with a write or alone.\n\n"
             "For schema details and examples, see "
             "ha_get_skill_guide or your locally installed skills."
         ),
@@ -846,8 +862,10 @@ class HomeAssistantSmartMCPServer:
             "ha_get_skill_guide or your locally installed skills."
         ),
         "ha_call_service": (
-            "Execute a Home Assistant service to control entities or "
-            "trigger automations. Calls `<domain>.<service>` "
+            "Call any Home Assistant service or one-shot WebSocket command: "
+            "the catch-all escape hatch. Prefer a dedicated tool when one "
+            "covers the job (automations, scripts, scenes, apps, updates and "
+            "repairs, integration log levels). Calls `<domain>.<service>` "
             "(e.g., light.turn_on, climate.set_temperature). Use "
             "ha_search to find entity IDs and ha_get_state "
             "to read current values before changing them.\n\n"

{ha_mcp_dev-8.5.0.dev2740 → ha_mcp_dev-8.5.0.dev2745}/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.dev2740 → ha_mcp_dev-8.5.0.dev2745}/src/ha_mcp/tools/entity_registration.py

@@ -82,9 +82,11 @@ async def resolve_entity_id_after_write(
     An empty registry read can precede asynchronous registration even inside
     the component. Retry against one deadline, checking component availability
     on every attempt. A positive budget includes in-flight lookups and sleeps;
-    zero requests one lookup without a time limit, for test fixtures. Known
-    API failures retain the best-effort fallback. Errors escaping the component
-    adapter propagate unless listed below; cancellation always propagates.
+    zero requests one lookup without a time limit, for test fixtures and for
+    callers that need an existing entity without waiting (a standalone script
+    run). Known API failures retain the best-effort fallback. Errors escaping
+    the component adapter propagate unless listed below; cancellation always
+    propagates.
     ``fallback_entity_id`` overrides the constructed ID on failure; registry
     matching always uses the storage key.
 

{ha_mcp_dev-8.5.0.dev2740 → ha_mcp_dev-8.5.0.dev2745}/src/ha_mcp/tools/tools_addons.py

@@ -1302,7 +1302,7 @@ def _validate_addon_access(
                 ErrorCode.SERVICE_CALL_FAILED,
                 f"App (add-on) '{addon_name}' is not running (state: {addon.get('state')})",
                 suggestions=[
-                    f"Start the app (add-on) first with: ha_call_service('hassio', 'addon_start', {{'addon': '{slug}'}})",
+                    f"Start the app (add-on) first with: ha_manage_app(slug='{slug}', action='start')",
                 ],
                 context={"slug": slug, "state": addon.get("state")},
             )
@@ -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.dev2740 → ha_mcp_dev-8.5.0.dev2745}/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.dev2740 → ha_mcp_dev-8.5.0.dev2745}/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: