ha-mcp-dev 7.4.1.dev466__tar.gz → 7.4.1.dev468__tar.gz

{ha_mcp_dev-7.4.1.dev466/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.4.1.dev468}/PKG-INFO

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

{ha_mcp_dev-7.4.1.dev466 → ha_mcp_dev-7.4.1.dev468}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.4.1.dev466"
+version = "7.4.1.dev468"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 requires-python = ">=3.13,<3.14"

{ha_mcp_dev-7.4.1.dev466 → ha_mcp_dev-7.4.1.dev468}/src/ha_mcp/server.py

@@ -525,6 +525,14 @@ class HomeAssistantSmartMCPServer(EnhancedToolsMixin):
             "binary_sensor command_line rest mqtt platform yaml-only "
             "config file modify add remove replace"
         ),
+        "ha_manage_addon": (
+            "manage addon add-on configure settings options port network boot "
+            "watchdog auto_update supervisor ingress proxy websocket api rest "
+            "esphome nodered node-red frigate mosquitto mqtt zigbee2mqtt zigbee "
+            "z-wave zwave appdaemon hacs studio code server file editor terminal "
+            "ssh samba grafana influxdb deconz motioneye compile validate upload "
+            "deploy firmware ota flash yaml device logs flows events stats"
+        ),
     }
 
     # Description overrides that REPLACE the original description for BM25.

{ha_mcp_dev-7.4.1.dev466 → ha_mcp_dev-7.4.1.dev468}/src/ha_mcp/tools/tools_addons.py

@@ -507,7 +507,7 @@ async def get_addon_info(client: HomeAssistantClient, slug: str) -> dict[str, An
 
     Args:
         client: Home Assistant REST client
-        slug: Add-on slug (e.g., "a0d7b954_nodered")
+        slug: Add-on slug (e.g., "<prefix>_nodered")
 
     Returns:
         Dictionary with add-on details including ingress info, state, options, etc.
@@ -740,7 +740,7 @@ async def _call_addon_ws(
 
     Args:
         client: Home Assistant REST client
-        slug: Add-on slug (e.g., "5c53de3b_esphome")
+        slug: Add-on slug (e.g., "<prefix>_esphome")
         path: WebSocket endpoint path (e.g., "/compile", "/validate")
         body: Message to send after connecting (JSON-encoded if dict, raw if string)
         timeout: Max seconds to wait for messages (default 60)
@@ -1081,7 +1081,7 @@ async def _call_addon_api(
 
     Args:
         client: Home Assistant REST client
-        slug: Add-on slug (e.g., "a0d7b954_nodered")
+        slug: Add-on slug (e.g., "<prefix>_nodered")
         path: API path relative to add-on root (e.g., "/flows")
         method: HTTP method (GET, POST, PUT, DELETE, PATCH)
         body: Request body for POST/PUT/PATCH
@@ -1349,8 +1349,9 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         slug: Annotated[
             str | None,
             Field(
-                description="Add-on slug for detailed info (e.g., 'a0d7b954_nodered'). "
-                "Omit to list all add-ons.",
+                description="Add-on slug for detailed info (e.g., '<prefix>_nodered'). "
+                "Slug prefixes vary by add-on repository — omit to list all add-ons "
+                "and discover the actual installed slug.",
                 default=None,
             ),
         ] = None,
@@ -1402,7 +1403,7 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
 
         **Example Usage:**
         - List installed add-ons: ha_get_addon()
-        - Get Node-RED details: ha_get_addon(slug="a0d7b954_nodered")
+        - Get Node-RED details: ha_get_addon(slug="<prefix>_nodered")
         - List with resource usage: ha_get_addon(include_stats=True)
         - List available add-ons: ha_get_addon(source="available")
         - Search for MQTT: ha_get_addon(source="available", query="mqtt")
@@ -1448,8 +1449,9 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
         slug: Annotated[
             str,
             Field(
-                description="Add-on slug (e.g., 'a0d7b954_nodered', 'ccab4aaf_frigate'). "
-                "Use ha_get_addon() to find installed add-on slugs.",
+                description="Add-on slug (e.g., '<prefix>_nodered', '<prefix>_frigate'). "
+                "Slug prefixes vary by add-on repository — call ha_get_addon() "
+                "to discover the actual installed slug.",
             ),
         ],
         path: Annotated[

{ha_mcp_dev-7.4.1.dev466 → ha_mcp_dev-7.4.1.dev468}/src/ha_mcp/tools/tools_config_dashboards.py

@@ -265,22 +265,37 @@ def _should_lazy_resolve(error_msg: str) -> bool:
     return _LAZY_RESOLVE_TRIGGER in error_msg
 
 
-async def _resolve_dashboard(client: Any, identifier: str) -> dict[str, str] | None:
+async def _resolve_dashboard(
+    client: Any, identifier: str
+) -> tuple[dict[str, str] | None, list[dict[str, Any]] | None]:
     """Resolve a dashboard identifier (url_path or internal id) to both forms.
 
-    Calls ``lovelace/dashboards/list`` and returns
-    ``{"url_path": ..., "id": ...}`` when the identifier matches either field
-    on a registry entry that has both fields populated; otherwise returns
-    ``None``. Always pays the round-trip when called.
+    Calls ``lovelace/dashboards/list`` and returns a 2-tuple
+    ``(match, dashboards)``:
 
-    Two call sites:
+    - ``match`` is ``{"url_path": ..., "id": ...}`` when the identifier
+      matches either field on a registry entry that has both fields
+      populated; otherwise ``None``.
+    - ``dashboards`` is the raw list as returned by HA when the
+      response shape is recognised (dict-with-``result`` or bare list);
+      ``None`` when the shape was unexpected and a warning was logged.
+
+    Returning ``dashboards`` alongside ``match`` lets callers reuse the
+    list for follow-on checks (existence, id lookup) instead of paying
+    a second ``lovelace/dashboards/list`` round-trip.
+
+    Three call sites:
     - **Lazy fallback** (``_lazy_resolve_and_retry``): only invoked after
       ``lovelace/config`` rejected the identifier with
       ``_LAZY_RESOLVE_TRIGGER`` — the round-trip is gated by the caller.
+      Discards ``dashboards``.
     - **Eager pre-resolve** (``ha_config_set_dashboard``): invoked before
       hyphen validation so callers may pass either form; gated on a
       cheap heuristic ("no hyphen, not 'lovelace'") rather than an error
-      from HA.
+      from HA. Reuses ``dashboards`` for the existence-check below.
+    - **Delete** (``ha_config_delete_dashboard``): resolves either form
+      to the registry id before issuing the delete. Discards
+      ``dashboards``.
     """
     result = await client.send_websocket_message({"type": "lovelace/dashboards/list"})
     if isinstance(result, dict) and "result" in result:
@@ -297,7 +312,7 @@ async def _resolve_dashboard(client: Any, identifier: str) -> dict[str, str] | N
             "treating as no-match",
             type(result).__name__,
         )
-        return None
+        return None, None
 
     for d in dashboards:
         if d.get("id") == identifier or d.get("url_path") == identifier:
@@ -309,8 +324,8 @@ async def _resolve_dashboard(client: Any, identifier: str) -> dict[str, str] | N
                 # would be silently used by callers (e.g.
                 # ``delete_dashboard`` would forward ``resolved_id=""``).
                 continue
-            return {"url_path": url_path, "id": entry_id}
-    return None
+            return {"url_path": url_path, "id": entry_id}, dashboards
+    return None, dashboards
 
 
 @overload
@@ -376,7 +391,7 @@ async def _lazy_resolve_and_retry(
         return url_path, response
 
     try:
-        resolved = await _resolve_dashboard(client, url_path)
+        resolved, _ = await _resolve_dashboard(client, url_path)
     except Exception as resolver_exc:
         # Resolver itself raised (timeout, network blip, etc.). Don't let
         # this exception escape and replace the original HA error with
@@ -941,12 +956,18 @@ def register_config_dashboard_tools(mcp: Any, client: Any, **kwargs: Any) -> Non
             # ``resolved_from`` on the success response so callers can
             # detect this redirect.
             pre_resolved_from: str | None = None
+            # When the pre-resolver fires and finds a match, ``_resolve_dashboard``
+            # has already fetched ``lovelace/dashboards/list``. Capture that list
+            # so the existence-check site below can reuse it instead of paying
+            # a second round-trip.
+            pre_fetched_dashboards: list[dict[str, Any]] | None = None
             if "-" not in url_path and url_path != "lovelace":
-                resolved = await _resolve_dashboard(client, url_path)
+                resolved, dashboards = await _resolve_dashboard(client, url_path)
                 if resolved is not None and resolved["url_path"]:
                     original_url_path = url_path
                     url_path = resolved["url_path"]
                     pre_resolved_from = original_url_path
+                    pre_fetched_dashboards = dashboards
                     logger.info(
                         "ha_config_set_dashboard pre-resolver mapped %r -> %r",
                         original_url_path,
@@ -1129,16 +1150,32 @@ def register_config_dashboard_tools(mcp: Any, client: Any, **kwargs: Any) -> Non
                     transform_result["resolved_from"] = pre_resolved_from
                 return transform_result
 
-            # Check if dashboard exists
-            result = await client.send_websocket_message(
-                {"type": "lovelace/dashboards/list"}
-            )
-            if isinstance(result, dict) and "result" in result:
-                existing_dashboards = result["result"]
-            elif isinstance(result, list):
-                existing_dashboards = result
+            # Check if dashboard exists. When the pre-resolver fired
+            # and matched (internal-id branch), reuse its already-fetched
+            # ``lovelace/dashboards/list`` response to skip a redundant
+            # round-trip — the matched dashboard is guaranteed present in
+            # that list.
+            if pre_fetched_dashboards is not None:
+                existing_dashboards = pre_fetched_dashboards
             else:
-                existing_dashboards = []
+                result = await client.send_websocket_message(
+                    {"type": "lovelace/dashboards/list"}
+                )
+                if isinstance(result, dict) and "result" in result:
+                    existing_dashboards = result["result"]
+                elif isinstance(result, list):
+                    existing_dashboards = result
+                else:
+                    # Mirror the warning emitted by ``_resolve_dashboard`` on
+                    # the same response-shape failure, so a future HA shape
+                    # change shows up at every fetch site rather than going
+                    # silent on this one.
+                    logger.warning(
+                        "lovelace/dashboards/list returned an unexpected shape "
+                        "(type=%s); treating as no-match",
+                        type(result).__name__,
+                    )
+                    existing_dashboards = []
             dashboard_exists = any(
                 d.get("url_path") == url_path for d in existing_dashboards
             )
@@ -1407,7 +1444,7 @@ def register_config_dashboard_tools(mcp: Any, client: Any, **kwargs: Any) -> Non
         Note: The default dashboard cannot be deleted via this method.
         """
         try:
-            resolved = await _resolve_dashboard(client, url_path)
+            resolved, _ = await _resolve_dashboard(client, url_path)
             if resolved is None:
                 raise_tool_error(
                     create_resource_not_found_error(

{ha_mcp_dev-7.4.1.dev466 → ha_mcp_dev-7.4.1.dev468/src/ha_mcp_dev.egg-info}/PKG-INFO

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