homeassistant-ai
diff --git a/‎src/ha_mcp/read_only.py‎
Lines changed: 18 additions & 0 deletions b/‎src/ha_mcp/read_only.py‎
Lines changed: 18 additions & 0 deletions
diff --git a/‎src/ha_mcp/tools/best_practice_checker.py‎
Lines changed: 73 additions & 2 deletions b/‎src/ha_mcp/tools/best_practice_checker.py‎
Lines changed: 73 additions & 2 deletions
diff --git a/‎src/ha_mcp/tools/tools_config_automations.py‎
Lines changed: 2 additions & 0 deletions b/‎src/ha_mcp/tools/tools_config_automations.py‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎src/ha_mcp/tools/tools_traces.py‎
Lines changed: 7 additions & 0 deletions b/‎src/ha_mcp/tools/tools_traces.py‎
Lines changed: 7 additions & 0 deletions
@@ -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 @@ def _radio_write(args: dict[str, Any]) -> str | None:
         "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')",
+    ),
 }
 
 
 
@@ -162,6 +162,28 @@ def __init__(self, items: list[str] | None = None) -> None:
 # ``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",
 
@@ -440,6 +440,8 @@ async def ha_config_set_automation(
             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,
             ),
 
@@ -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