ha-mcp-dev 7.9.0.dev758__tar.gz → 7.9.0.dev760__tar.gz

{ha_mcp_dev-7.9.0.dev758/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.9.0.dev760}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.9.0.dev758
+Version: 7.9.0.dev760
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT
@@ -462,7 +462,14 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - **[@L1AD](https://github.com/L1AD)** — Filed #966 proposing tool security policies; pointed to PolicyLayer's MCP-security work as prior art that inspired the predicate DSL shape.
 - **[@nightcityblade](https://github.com/nightcityblade)** — Updated stale Home Assistant Advanced Mode references after HA 2026.6 made formerly advanced options available by default (#1533).
 - **[@emmelutzer](https://github.com/emmelutzer)** — Financial support via [GitHub Sponsors](https://github.com/sponsors/julienld). Thank you! ☕
-
+- **[@pkkr](https://github.com/pkkr)** — `ha_knx_get_project` tool exposing KNX group addresses from an uploaded ETS project file.
+- **[@cbowns](https://github.com/cbowns)** — Fixed inconsistent hyphen in setup.astro Codex CLI docs.
+- **[@Shaan-alpha](https://github.com/Shaan-alpha)** — Extended `ha_restart` known-good error patterns to cover 502/503 responses from reverse proxies.
+- **[@rebelancap](https://github.com/rebelancap)** — Fixed UTC-to-local timezone conversion in `add_timezone_metadata`.
+- **[@saevras](https://github.com/saevras)** — Fixed blueprint import E2E test to use local URL instead of host-to-container networking.
+- **[@jasonjhofmann](https://github.com/jasonjhofmann)** — Recurring calendar events via `rrule` support in `ha_config_set_calendar_event`.
+- **[@vpciii](https://github.com/vpciii)** — Coerce JSON-encoded strings on dict/list tool params.
+- **[@pburtchaell](https://github.com/pburtchaell)** — Financial support via [GitHub Sponsors](https://github.com/sponsors/julienld). Thank you! ☕
 ---
 
 ## 💬 Community

{ha_mcp_dev-7.9.0.dev758 → ha_mcp_dev-7.9.0.dev760}/README.md

@@ -430,7 +430,14 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - **[@L1AD](https://github.com/L1AD)** — Filed #966 proposing tool security policies; pointed to PolicyLayer's MCP-security work as prior art that inspired the predicate DSL shape.
 - **[@nightcityblade](https://github.com/nightcityblade)** — Updated stale Home Assistant Advanced Mode references after HA 2026.6 made formerly advanced options available by default (#1533).
 - **[@emmelutzer](https://github.com/emmelutzer)** — Financial support via [GitHub Sponsors](https://github.com/sponsors/julienld). Thank you! ☕
-
+- **[@pkkr](https://github.com/pkkr)** — `ha_knx_get_project` tool exposing KNX group addresses from an uploaded ETS project file.
+- **[@cbowns](https://github.com/cbowns)** — Fixed inconsistent hyphen in setup.astro Codex CLI docs.
+- **[@Shaan-alpha](https://github.com/Shaan-alpha)** — Extended `ha_restart` known-good error patterns to cover 502/503 responses from reverse proxies.
+- **[@rebelancap](https://github.com/rebelancap)** — Fixed UTC-to-local timezone conversion in `add_timezone_metadata`.
+- **[@saevras](https://github.com/saevras)** — Fixed blueprint import E2E test to use local URL instead of host-to-container networking.
+- **[@jasonjhofmann](https://github.com/jasonjhofmann)** — Recurring calendar events via `rrule` support in `ha_config_set_calendar_event`.
+- **[@vpciii](https://github.com/vpciii)** — Coerce JSON-encoded strings on dict/list tool params.
+- **[@pburtchaell](https://github.com/pburtchaell)** — Financial support via [GitHub Sponsors](https://github.com/sponsors/julienld). Thank you! ☕
 ---
 
 ## 💬 Community

{ha_mcp_dev-7.9.0.dev758 → ha_mcp_dev-7.9.0.dev760}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.9.0.dev758"
+version = "7.9.0.dev760"
 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.9.0.dev758 → ha_mcp_dev-7.9.0.dev760}/src/ha_mcp/client/rest_client.py

@@ -606,7 +606,7 @@ class HomeAssistantClient:
         self._supervised_detected = is_supervised
         return is_supervised
 
-    async def get_addon_logs(self, slug: str) -> str:
+    async def get_addon_logs(self, slug: str, lines: int | None = None) -> str:
         """Fetch an add-on's container logs.
 
         Branch on ``is_running_in_addon()`` (which keys off ``SUPERVISOR_TOKEN``
@@ -621,6 +621,15 @@ class HomeAssistantClient:
         HA URL), falls back to the HA Core proxy path. That path requires an
         admin LLA but works fine when not invoked from the add-on container.
 
+        ``lines`` sets the journald window Supervisor serves via its
+        ``?lines=`` query param (supervisor/api/host.py). Without it,
+        Supervisor returns only its default window (``DEFAULT_LINES = 100``
+        in supervisor/api/const.py) — which silently capped every larger
+        caller-side limit before this param existed. Both branches carry
+        it: the direct endpoint parses the query natively, and HA Core's
+        hassio proxy forwards ``request.query`` upstream
+        (homeassistant/components/hassio/http.py).
+
         Both branches return ``text/plain`` log content.
 
         Raises:
@@ -633,17 +642,18 @@ class HomeAssistantClient:
             HomeAssistantConnectionError: Network, timeout, or transport error.
         """
         if is_running_in_addon():
-            return await self._get_addon_logs_via_supervisor(slug)
+            return await self._get_addon_logs_via_supervisor(slug, lines=lines)
 
         logger.debug(f"Fetching addon logs for slug={slug} via HA Core proxy")
         response = await self._raw_request(
             "GET",
             f"/hassio/addons/{slug}/logs",
             headers={"Accept": "text/plain"},
+            params={"lines": lines} if lines is not None else None,
         )
         return response.text
 
-    async def _supervisor_logs_get(self, path: str) -> str:
+    async def _supervisor_logs_get(self, path: str, lines: int | None = None) -> str:
         """Fetch ``text/plain`` logs from a Supervisor REST endpoint.
 
         ``path`` is everything between ``http://supervisor/`` and ``/logs``:
@@ -652,6 +662,9 @@ class HomeAssistantClient:
         - ``"<service>"`` (where service ∈ {supervisor, host, core, dns, audio,
           cli, multicast, observer}) for system-service logs
 
+        ``lines`` maps to the endpoint's ``?lines=`` journald-window query
+        param; omitted → Supervisor's 100-line default window.
+
         Bypasses ``HomeAssistantClient.httpx_client`` because the Supervisor
         endpoint uses a different base URL (``http://supervisor``) and a
         different token (``SUPERVISOR_TOKEN``) than HA Core REST. Both
@@ -681,9 +694,10 @@ class HomeAssistantClient:
 
         relative_path = f"/{path}/logs"
         logger.debug(
-            "Fetching %s%s via Supervisor direct",
+            "Fetching %s%s via Supervisor direct (lines=%s)",
             get_supervisor_base_url(),
             relative_path,
+            lines,
         )
 
         try:
@@ -694,6 +708,7 @@ class HomeAssistantClient:
                 response = await client.get(
                     relative_path,
                     headers={"Accept": "text/plain"},
+                    params={"lines": lines} if lines is not None else None,
                 )
         except httpx.TimeoutException as e:
             raise HomeAssistantConnectionError(
@@ -753,7 +768,9 @@ class HomeAssistantClient:
             )
         return response.text
 
-    async def _get_addon_logs_via_supervisor(self, slug: str) -> str:
+    async def _get_addon_logs_via_supervisor(
+        self, slug: str, lines: int | None = None
+    ) -> str:
         """Fetch add-on container logs directly from Supervisor's REST API.
 
         Distinct from ``tools_bug_report._fetch_addon_logs``: that helper is
@@ -766,9 +783,11 @@ class HomeAssistantClient:
         Delegates to ``_supervisor_logs_get`` so error handling stays in
         lockstep with ``_get_system_service_logs``.
         """
-        return await self._supervisor_logs_get(f"addons/{slug}")
+        return await self._supervisor_logs_get(f"addons/{slug}", lines=lines)
 
-    async def _get_system_service_logs(self, service: str) -> str:
+    async def _get_system_service_logs(
+        self, service: str, lines: int | None = None
+    ) -> str:
         """Fetch HA system-service logs.
 
         ``service`` must be one of the eight Supervisor-managed services:
@@ -796,13 +815,14 @@ class HomeAssistantClient:
         logs) call kept working through its own Core-proxy fallback.
         """
         if is_running_in_addon():
-            return await self._supervisor_logs_get(service)
+            return await self._supervisor_logs_get(service, lines=lines)
 
         logger.debug(f"Fetching {service} logs via HA Core proxy")
         response = await self._raw_request(
             "GET",
             f"/hassio/{service}/logs",
             headers={"Accept": "text/plain"},
+            params={"lines": lines} if lines is not None else None,
         )
         return response.text
 

{ha_mcp_dev-7.9.0.dev758 → ha_mcp_dev-7.9.0.dev760}/src/ha_mcp/read_only.py

@@ -131,6 +131,16 @@ def _custom_tool_write(args: dict[str, Any]) -> str | None:
     return "sandbox code execution"
 
 
+def _updates_write(args: dict[str, Any]) -> str | None:
+    # ``action`` defaults to "list" at the schema layer, so a missing action
+    # executes as a read (the middleware sees RAW pre-validation arguments —
+    # an absent key here means the tool itself will run the list branch).
+    action = args.get("action")
+    if action in (None, "list", "get"):
+        return None
+    return f"action={action!r}"
+
+
 def _radio_write(args: dict[str, Any]) -> str | None:
     action = args.get("action")
     # Reads (allowed): per-node diagnostics, the integration/network summary,
@@ -200,6 +210,14 @@ READ_ONLY_EXEMPT_TOOLS: dict[str, ReadOnlyExemption] = {
         "cluster-attribute read ('cluster_read'), and the Thread dataset "
         "listing ('list_datasets')",
     ),
+    # Update listing/details exist only here — ha_get_updates was merged
+    # into this tool (issue #1726), so hiding it would remove the read
+    # surface entirely.
+    "ha_manage_updates": ReadOnlyExemption(
+        _updates_write,
+        "listing pending updates (action='list', the default) and reading "
+        "update details/release notes (action='get')",
+    ),
 }
 
 

{ha_mcp_dev-7.9.0.dev758 → ha_mcp_dev-7.9.0.dev760}/src/ha_mcp/tools/backup.py

@@ -329,11 +329,19 @@ async def _poll_backup_completion(
         )
 
         if event_state == "failed":
+            # Surface the failure event verbatim — HA's failed event
+            # carries the cause (e.g. another backup already in
+            # progress), and dropping it left CI failures reading
+            # "Backup creation failed: Backup creation failed" with
+            # nothing to diagnose.
             raise_tool_error(
                 create_error_response(
                     ErrorCode.SERVICE_CALL_FAILED,
                     "Backup creation failed",
-                    context={"backup_job_id": backup_job_id},
+                    context={
+                        "backup_job_id": backup_job_id,
+                        "last_action_event": last_event,
+                    },
                 )
             )
 
@@ -410,7 +418,11 @@ async def _poll_backup_completion(
                 create_error_response(
                     ErrorCode.SERVICE_CALL_FAILED,
                     "Backup creation failed (observed at post-timeout lookup)",
-                    context={"backup_job_id": backup_job_id, "name": name},
+                    context={
+                        "backup_job_id": backup_job_id,
+                        "name": name,
+                        "last_action_event": last_event,
+                    },
                 )
             )
         if state != "idle":

{ha_mcp_dev-7.9.0.dev758 → ha_mcp_dev-7.9.0.dev760}/src/ha_mcp/tools/best_practice_checker.py

@@ -162,6 +162,28 @@ _TARGET_FIELDS = ("entity_id", "device_id", "area_id", "floor_id", "label_id")
 # ``service:`` (legacy) and ``action:`` (modern, 2024+) for the same field.
 _SERVICE_KEYS = ("service", "action")
 
+# Purpose-specific trigger/condition keys renamed in HA 2026.7 — the old keys
+# no longer load (home-assistant/core#174463).
+_RENAMED_TRIGGER_KEYS = {
+    "battery.low": "battery.became_low",
+    "battery.not_low": "battery.no_longer_low",
+    "lawn_mower.docked": "lawn_mower.returned_to_dock",
+    "schedule.turned_on": "schedule.block_started",
+    "schedule.turned_off": "schedule.block_ended",
+    "timer.time_remaining": "timer.remaining_time_reached",
+    "update.update_became_available": "update.became_available",
+    "vacuum.docked": "vacuum.returned_to_dock",
+}
+_RENAMED_CONDITION_KEYS = {
+    "climate.target_temperature": "climate.is_target_temperature",
+    "climate.target_humidity": "climate.is_target_humidity",
+}
+# Trigger ``options.behavior`` values renamed in HA 2026.7: any→each,
+# last→all (home-assistant/core#173259). The old values still load but raise
+# an HA repair issue and face removal. Condition ``options.behavior`` keeps
+# ``any``/``all`` — conditions are never flagged.
+_DEPRECATED_TRIGGER_BEHAVIOR = {"any": "each", "last": "all"}
+
 
 # ---------------------------------------------------------------------------
 # Public API
@@ -318,6 +340,23 @@ def _check_condition_templates(
             # Shorthand template condition
             _check_template_string(cond, warnings, skill_prefix, "condition")
         elif isinstance(cond, dict):
+            # 2026.7 renamed purpose-specific condition keys — old keys no
+            # longer load.
+            condition_key = cond.get("condition")
+            renamed_condition = (
+                _RENAMED_CONDITION_KEYS.get(condition_key)
+                if isinstance(condition_key, str)
+                else None
+            )
+            if renamed_condition:
+                _emit(
+                    warnings,
+                    f"Condition key `{condition_key}` was renamed to "
+                    f"`{renamed_condition}` in HA 2026.7 and the old key no "
+                    f"longer loads — use `condition: {renamed_condition}`.",
+                    skill_prefix,
+                    "automation-patterns.md#native-conditions",
+                )
             if cond.get("condition") == "template":
                 vt = cond.get("value_template", "")
                 if isinstance(vt, str):
@@ -655,12 +694,44 @@ def _check_triggers(
 
         platform = trigger.get("platform", trigger.get("trigger", ""))
 
+        # 2026.7 renamed purpose-specific trigger keys — old keys no longer load.
+        renamed_trigger = (
+            _RENAMED_TRIGGER_KEYS.get(platform) if isinstance(platform, str) else None
+        )
+        if renamed_trigger:
+            _emit(
+                warnings,
+                f"Trigger key `{platform}` was renamed to `{renamed_trigger}` "
+                "in HA 2026.7 and the old key no longer loads — use "
+                f"`trigger: {renamed_trigger}`.",
+                skill_prefix,
+                "automation-patterns.md#trigger-types",
+            )
+
+        # 2026.7 renamed trigger `options.behavior` values (any→each, last→all).
+        options = trigger.get("options")
+        if isinstance(options, dict):
+            behavior = options.get("behavior")
+            if isinstance(behavior, str) and behavior in _DEPRECATED_TRIGGER_BEHAVIOR:
+                _emit(
+                    warnings,
+                    f"Trigger `options.behavior: {behavior}` was renamed to "
+                    f"`{_DEPRECATED_TRIGGER_BEHAVIOR[behavior]}` in HA 2026.7 — "
+                    "the old value still loads but raises a repair issue and "
+                    "will be removed. Valid trigger values: `each`, `first`, "
+                    "`all` (conditions keep `any`/`all`).",
+                    skill_prefix,
+                    "automation-patterns.md#trigger-types",
+                )
+
         # Device trigger → prefer entity_id-based triggers
         if platform == "device":
             _emit(
                 warnings,
-                "Trigger uses `device` platform with `device_id` — prefer "
-                "`state` or `event` trigger with `entity_id` when possible "
+                "Trigger uses `device` platform with `device_id` — prefer a "
+                "purpose-specific trigger (`<domain>.<name>` with a `target:` "
+                "of entities/areas/floors/labels, HA 2026.7+) or a `state`/"
+                "`event` trigger with `entity_id` when possible "
                 "(device_id breaks on re-add).",
                 skill_prefix,
                 "device-control.md#entity-id-vs-device-id",

{ha_mcp_dev-7.9.0.dev758 → ha_mcp_dev-7.9.0.dev760}/src/ha_mcp/tools/tools_config_automations.py

@@ -440,6 +440,8 @@ class AutomationConfigTools:
             Field(
                 description="Complete automation configuration with required fields: 'alias', 'triggers', 'actions'. "
                 "Optional: 'description', 'conditions', 'mode', 'max', 'initial_state', 'variables'. "
+                "Purpose-specific triggers/conditions (HA 2026.7+ default: 'trigger': '<domain>.<name>' "
+                "with 'target'/'options') are valid config. "
                 "Mutually exclusive with python_transform.",
                 default=None,
             ),

{ha_mcp_dev-7.9.0.dev758 → ha_mcp_dev-7.9.0.dev760}/src/ha_mcp/tools/tools_traces.py

@@ -712,6 +712,8 @@ def _populate_trigger_info(
             )
         if "entity_id" in trigger_vars:
             result["trigger"]["entity_id"] = trigger_vars["entity_id"]
+        if "error" in trigger_step:
+            result["trigger"]["error"] = trigger_step["error"]
 
     if "trigger" not in result and "trigger" in trace:
         result["trigger"] = {"description": trace["trigger"]}
@@ -731,6 +733,11 @@ def _populate_condition_results(
             }
             if "timestamp" in cond:
                 cond_result["timestamp"] = cond["timestamp"]
+            # HA 2026.7+ always records template errors on the failing step
+            # (core #172917) — dropping this field would hide the reason a
+            # condition evaluated to None.
+            if "error" in cond:
+                cond_result["error"] = cond["error"]
             condition_results.append(cond_result)
         result["condition_results"] = condition_results