ha-mcp-dev 7.4.1.dev424__tar.gz → 7.4.1.dev426__tar.gz

{ha_mcp_dev-7.4.1.dev424/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.4.1.dev426}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.4.1.dev424"
+version = "7.4.1.dev426"
 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.dev424 → ha_mcp_dev-7.4.1.dev426}/src/ha_mcp/tools/tools_filesystem.py

@@ -51,10 +51,11 @@ READABLE_PATTERNS = [
     "www/**",
     "themes/**",
     "custom_templates/**",
+    "dashboards/**",
     "custom_components/**/*.py",
 ]
 
-WRITABLE_DIRS = ["www", "themes", "custom_templates"]
+WRITABLE_DIRS = ["www", "themes", "custom_templates", "dashboards"]
 
 
 def is_filesystem_tools_enabled() -> bool:
@@ -115,7 +116,7 @@ class FilesystemTools:
             Field(
                 description=(
                     "Relative directory path from config directory. "
-                    "Allowed paths: www/, themes/, custom_templates/. "
+                    "Allowed paths: www/, themes/, custom_templates/, dashboards/. "
                     "Example: 'www/' or 'themes/my_theme'"
                 ),
             ),
@@ -133,13 +134,14 @@ class FilesystemTools:
     ) -> dict[str, Any]:
         """List files in a directory within the Home Assistant config directory.
 
-        Lists files in allowed directories (www/, themes/, custom_templates/) with
+        Lists files in allowed directories (www/, themes/, custom_templates/, dashboards/) with
         optional glob pattern filtering. Returns file names, sizes, and modification times.
 
         **Allowed Directories:**
         - `www/` - Web assets (CSS, JS, images for dashboards)
         - `themes/` - Theme files
         - `custom_templates/` - Jinja2 template files
+        - `dashboards/` - YAML-mode dashboard files
 
         **Security:** Only directories in the allowed list can be accessed.
         Path traversal attempts (../) are blocked.
@@ -237,7 +239,7 @@ class FilesystemTools:
         - `secrets.yaml` (values masked)
         - `packages/*.yaml`
         - `home-assistant.log` (tail only)
-        - `www/**`, `themes/**`, `custom_templates/**`
+        - `www/**`, `themes/**`, `custom_templates/**`, `dashboards/**`
         - `custom_components/**/*.py` (read-only)
 
         **Security:**
@@ -322,7 +324,7 @@ class FilesystemTools:
             Field(
                 description=(
                     "Relative path from config directory. "
-                    "Must be in www/, themes/, or custom_templates/. "
+                    "Must be in www/, themes/, custom_templates/, or dashboards/. "
                     "Example: 'www/custom.css', 'themes/my_theme.yaml'"
                 ),
             ),
@@ -365,6 +367,7 @@ class FilesystemTools:
         - `www/` - Web assets for dashboards
         - `themes/` - Theme YAML files
         - `custom_templates/` - Jinja2 template files
+        - `dashboards/` - YAML-mode dashboard files
 
         **Security:**
         - Only the directories above allow writes
@@ -453,7 +456,7 @@ class FilesystemTools:
             Field(
                 description=(
                     "Relative path from config directory. "
-                    "Must be in www/, themes/, or custom_templates/. "
+                    "Must be in www/, themes/, custom_templates/, or dashboards/. "
                     "Example: 'www/old-file.css'"
                 ),
             ),
@@ -478,6 +481,7 @@ class FilesystemTools:
         - `www/` - Web assets
         - `themes/` - Theme files
         - `custom_templates/` - Template files
+        - `dashboards/` - YAML-mode dashboard files
 
         **Security:**
         - Only the directories above allow deletions

{ha_mcp_dev-7.4.1.dev424 → ha_mcp_dev-7.4.1.dev426}/src/ha_mcp/tools/tools_yaml_config.py

@@ -28,6 +28,68 @@ from .util_helpers import coerce_bool_param, unwrap_service_response
 
 logger = logging.getLogger(__name__)
 
+_LOVELACE_DASHBOARD_PREFIX = "lovelace.dashboards."
+
+
+async def _check_storage_mode_dashboard_collision(
+    client: Any, yaml_path: str
+) -> None:
+    """Raise a ToolError if a storage-mode dashboard already owns the requested
+    url_path; otherwise return without doing anything.
+
+    Only runs for yaml_path values starting with 'lovelace.dashboards.'.
+    A WebSocket failure or unexpected response shape warns and skips the check
+    (fail-open) so that a transient HA outage doesn't block dashboard creation.
+    """
+    if not yaml_path.startswith(_LOVELACE_DASHBOARD_PREFIX):
+        return
+    url_path = yaml_path[len(_LOVELACE_DASHBOARD_PREFIX):]
+    try:
+        result = await client.send_websocket_message(
+            {"type": "lovelace/dashboards/list"}
+        )
+    except Exception as exc:
+        logger.warning(
+            "lovelace/dashboards/list WS query failed (%s); skipping collision check",
+            exc,
+        )
+        return
+
+    if isinstance(result, dict) and "result" in result:
+        dashboards = result["result"]
+    elif isinstance(result, list):
+        dashboards = result
+    else:
+        logger.warning(
+            "lovelace/dashboards/list returned unexpected shape (%s); "
+            "skipping collision check",
+            type(result).__name__,
+        )
+        return
+
+    for entry in dashboards or []:
+        if (
+            isinstance(entry, dict)
+            and entry.get("url_path") == url_path
+            and entry.get("mode") == "storage"
+        ):
+            raise_tool_error(
+                create_error_response(
+                    ErrorCode.VALIDATION_INVALID_PARAMETER,
+                    (
+                        f"A storage-mode dashboard already owns url_path "
+                        f"'{url_path}'. Delete it via ha_config_delete_dashboard "
+                        "or pick a different url_path before registering a "
+                        "YAML-mode dashboard."
+                    ),
+                    context={"url_path": url_path, "existing_id": entry.get("id")},
+                    suggestions=[
+                        f"ha_config_delete_dashboard(url_path='{url_path}')",
+                        "Pick a different url_path for your YAML-mode dashboard.",
+                    ],
+                )
+            )
+
 
 def register_yaml_config_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
     """Register YAML config editing tools with the MCP server.
@@ -59,8 +121,11 @@ def register_yaml_config_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
                 description=(
                     "Top-level YAML key to modify. Only a narrow allowlist of "
                     "YAML-only integration keys is accepted (e.g., 'command_line', "
-                    "'rest', 'shell_command', 'notify'). Not for template sensors "
-                    "(use ha_config_set_helper), automations, scripts, "
+                    "'rest', 'shell_command', 'notify'). For YAML-mode dashboards, "
+                    "use the dotted form 'lovelace.dashboards.<url_path>' where "
+                    "<url_path> is lowercase, hyphenated, and not a reserved HA "
+                    "route. No other dotted paths are supported. Not for template "
+                    "sensors (use ha_config_set_helper), automations, scripts, "
                     "scenes, or input_* helpers — those have dedicated tools."
                 ),
             ),
@@ -121,7 +186,9 @@ def register_yaml_config_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
           trend, filter, switch_as_x, etc.) -> ha_config_set_helper
 
         Intended for YAML-only integrations with no config-flow or API
-        equivalent (command_line, rest, shell_command, notify platforms).
+        equivalent (command_line, rest, shell_command, notify platforms),
+        and for registering YAML-mode dashboards via
+        ``lovelace.dashboards.<url_path>`` (no other ``lovelace.*`` keys).
         Check ``post_action`` in the response: most keys need a full HA
         restart; template, mqtt, and group support reload. Preserves YAML
         comments and HA tags (``!include``, ``!secret``) on round-trip;
@@ -160,6 +227,12 @@ def register_yaml_config_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
             # Coerce boolean parameter
             backup_bool = coerce_bool_param(backup, "backup", default=True)
 
+            # Storage-mode dashboard collision check (only for lovelace.dashboards.*).
+            # Skip on `remove` so users can clean up YAML entries that conflict
+            # with a storage-mode dashboard (e.g., during a migration).
+            if action in ("add", "replace"):
+                await _check_storage_mode_dashboard_collision(client, yaml_path)
+
             # Check if custom component is available
             await _assert_mcp_tools_available(client)
 

{ha_mcp_dev-7.4.1.dev424 → ha_mcp_dev-7.4.1.dev426/src/ha_mcp_dev.egg-info}/PKG-INFO

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