ha-mcp-dev 9.2.0.dev3491__tar.gz → 9.3.0.dev3492__tar.gz

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 9.2.0.dev3491
+Version: 9.3.0.dev3492
 Summary: Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants.
 Keywords: mcp,home-assistant,ai,automation,smart-home
 Author: Julien
@@ -10,12 +10,10 @@ License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Home Automation
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: anyio>=4.10 ; python_full_version >= '3.14'
-Requires-Dist: anyio>=4.9 ; python_full_version < '3.14'
+Requires-Dist: anyio>=4.10
 Requires-Dist: authlib>=1.6.11
 Requires-Dist: certifi>=2026.10.19
 Requires-Dist: cyclopts>=4.0.0
@@ -53,7 +51,7 @@ Requires-Dist: cryptography>=48.0.0,<51
 Requires-Dist: pydantic-monty==0.0.18
 Requires-Dist: tzdata>=2024.1
 Requires-Dist: packaging>=24.0
-Requires-Python: >=3.13, <3.15
+Requires-Python: >=3.14, <3.15
 Project-URL: Homepage, https://github.com/homeassistant-ai/ha-mcp
 Project-URL: Bug Tracker, https://github.com/homeassistant-ai/ha-mcp/issues
 Project-URL: Repository, https://github.com/homeassistant-ai/ha-mcp
@@ -142,14 +140,14 @@ Prefer to run ha-mcp as a Home Assistant **app (add-on)**? On **Home Assistant O
 
 [Full app documentation →](homeassistant-addon/DOCS.md)
 
-> ⚠️ **Configure exactly one install method per client.** The custom component, the app, Docker/PyPI, and local stdio are independent ways to run the same server — pick one and point your AI client at that single URL. Keeping two entries for the same server in one client (for example a local `uvx ha-mcp@latest` entry with `HOMEASSISTANT_URL` / `HOMEASSISTANT_TOKEN` alongside an app or component URL) is a known cause of connection hangs.
+> ⚠️ **Configure exactly one install method per client.** The custom component, the app, Docker/PyPI, and local stdio are independent ways to run the same server — pick one and point your AI client at that single URL. Keeping two entries for the same server in one client (for example a local `uvx --python 3.14 ha-mcp@latest` entry with `HOMEASSISTANT_URL` / `HOMEASSISTANT_TOKEN` alongside an app or component URL) is a known cause of connection hangs.
 
 ### Other install methods
 
 These run the server outside Home Assistant — useful for **Container** / **Core** installs (which can't run apps) or a separate host. The [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) generates the exact client-specific config for each.
 
 - **Docker (HTTP server):** run `ghcr.io/homeassistant-ai/ha-mcp` in HTTP mode, pointed at your Home Assistant URL and a long-lived token (an administrator's is recommended; non-admin tokens work with limitations), and connect your client to its secret URL. See the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) for the full command and per-client config.
-- **PyPI / uvx (HTTP server):** run the published `ha-mcp` package with `uvx ha-mcp@latest` (or pip) as a streamable-HTTP server the same way. Details in the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/).
+- **PyPI / uvx (HTTP server):** run the published `ha-mcp` package with `uvx --python 3.14 ha-mcp@latest` (or pip) as a streamable-HTTP server the same way. Details in the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/).
 - **Local stdio (not recommended):** runs ha-mcp on your own machine over stdio. The one-command installers in the **Demo server** section below use this path; the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) covers connecting it to your own Home Assistant.
 - **OIDC authentication:** gate remote access behind an external identity provider (Authentik, Keycloak, Auth0, etc.) instead of a secret URL — all authenticated users share the server's Home Assistant credentials. See [OIDC Mode](docs/oidc.md).
 

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/README.md

@@ -81,14 +81,14 @@ Prefer to run ha-mcp as a Home Assistant **app (add-on)**? On **Home Assistant O
 
 [Full app documentation →](homeassistant-addon/DOCS.md)
 
-> ⚠️ **Configure exactly one install method per client.** The custom component, the app, Docker/PyPI, and local stdio are independent ways to run the same server — pick one and point your AI client at that single URL. Keeping two entries for the same server in one client (for example a local `uvx ha-mcp@latest` entry with `HOMEASSISTANT_URL` / `HOMEASSISTANT_TOKEN` alongside an app or component URL) is a known cause of connection hangs.
+> ⚠️ **Configure exactly one install method per client.** The custom component, the app, Docker/PyPI, and local stdio are independent ways to run the same server — pick one and point your AI client at that single URL. Keeping two entries for the same server in one client (for example a local `uvx --python 3.14 ha-mcp@latest` entry with `HOMEASSISTANT_URL` / `HOMEASSISTANT_TOKEN` alongside an app or component URL) is a known cause of connection hangs.
 
 ### Other install methods
 
 These run the server outside Home Assistant — useful for **Container** / **Core** installs (which can't run apps) or a separate host. The [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) generates the exact client-specific config for each.
 
 - **Docker (HTTP server):** run `ghcr.io/homeassistant-ai/ha-mcp` in HTTP mode, pointed at your Home Assistant URL and a long-lived token (an administrator's is recommended; non-admin tokens work with limitations), and connect your client to its secret URL. See the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) for the full command and per-client config.
-- **PyPI / uvx (HTTP server):** run the published `ha-mcp` package with `uvx ha-mcp@latest` (or pip) as a streamable-HTTP server the same way. Details in the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/).
+- **PyPI / uvx (HTTP server):** run the published `ha-mcp` package with `uvx --python 3.14 ha-mcp@latest` (or pip) as a streamable-HTTP server the same way. Details in the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/).
 - **Local stdio (not recommended):** runs ha-mcp on your own machine over stdio. The one-command installers in the **Demo server** section below use this path; the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) covers connecting it to your own Home Assistant.
 - **OIDC authentication:** gate remote access behind an external identity provider (Authentik, Keycloak, Auth0, etc.) instead of a secret URL — all authenticated users share the server's Home Assistant credentials. See [OIDC Mode](docs/oidc.md).
 

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.2.0.dev3491"
+version = "9.3.0.dev3492"
 description = "Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants."
 readme = "README.md"
-requires-python = ">=3.13,<3.15"
+requires-python = ">=3.14,<3.15"
 license = "MIT"
 license-files = ["LICENSE"]
 keywords = [
@@ -21,14 +21,12 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
     "Topic :: Home Automation",
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
-    "anyio>=4.10; python_version >= '3.14'",
-    "anyio>=4.9; python_version < '3.14'",
+    "anyio>=4.10",
     "authlib>=1.6.11",
     "certifi>=2026.10.19",
     "cyclopts>=4.0.0",
@@ -365,6 +363,11 @@ extend-exclude = [
     "custom_components/**/*.json",
 ]
 
+[tool.ruff.per-file-target-version]
+"src/ha_mcp/__init__.py" = "py313"
+"homeassistant-addon-webhook-proxy/**" = "py313"
+"homeassistant-addon-webhook-proxy-dev/**" = "py313"
+
 [tool.ruff.lint]
 select = [
     "E",

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/pyproject.toml.orig

@@ -4,15 +4,13 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.2.0.dev3491"
+version = "9.3.0.dev3492"
 description = "Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants."
 readme = "README.md"
 # Upper bound widened to <3.15 so the package installs on Home Assistant's
 # interpreter when run in-process by the ha_mcp_tools component (HA
-# core-2026.7 ships Python 3.14). ruff infers its target from this floor, so
-# it writes no 3.14-only syntax while 3.13 can still install; CI, mypy, the
-# images and the dev environment run 3.14.
-requires-python = ">=3.13,<3.15"
+# core-2026.7 ships Python 3.14).
+requires-python = ">=3.14,<3.15"
 license = "MIT"
 license-files = ["LICENSE"]
 authors = [
@@ -23,7 +21,6 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
     "Topic :: Home Automation",
     "Topic :: Software Development :: Libraries :: Python Modules",
@@ -32,8 +29,7 @@ classifiers = [
 dependencies = [
     # fastmcp/mcp/mcp-types are vendored (scripts/vendor_fastmcp.py) so HA
     # Core's own mcp 1.x pin can't conflict. Below: their runtime requirements.
-    "anyio>=4.10; python_version >= '3.14'",
-    "anyio>=4.9; python_version < '3.14'",
+    "anyio>=4.10",
     "authlib>=1.6.11",
     "certifi>=2026.10.19",
     "cyclopts>=4.0.0",
@@ -438,6 +434,15 @@ extend-exclude = [
     "custom_components/**/*.json",
 ]
 
+
+# 3.13 syntax where an older Python must still parse the code: the package's
+# Python-version guard (to print its error instead of a SyntaxError), and the
+# Webhook Proxy, whose component runs on the user's Home Assistant.
+[tool.ruff.per-file-target-version]
+"src/ha_mcp/__init__.py" = "py313"
+"homeassistant-addon-webhook-proxy/**" = "py313"
+"homeassistant-addon-webhook-proxy-dev/**" = "py313"
+
 [tool.ruff.lint]
 select = [
     "E",     # pycodestyle errors
@@ -696,7 +701,7 @@ dev = [
 
 [tool.uv]
 # The dev group's homeassistant requires Python >=3.14.2; the published
-# package keeps >=3.13, so only the lock is narrowed.
+# package keeps >=3.14, so only the lock is narrowed.
 environments = ["python_full_version >= '3.14.2'"]
 
 [tool.uv.sources]

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/__init__.py

@@ -5,6 +5,23 @@ A Model Context Protocol server that provides complete control over Home Assista
 through REST API and WebSocket integration.
 """
 
+import sys
+
+if sys.version_info < (3, 14):
+    # uvx and pip can be forced past requires-python. This runs before any
+    # submodule is imported, so an older Python stops here instead of at a
+    # SyntaxError in one; pyproject.toml keeps ruff on 3.13 syntax for this
+    # file. stderr directly: logging is not set up yet.
+    sys.stderr.write(
+        f"ERROR: ha-mcp requires Python 3.14+, but you are running Python "
+        f"{sys.version_info.major}.{sys.version_info.minor}.\n"
+        "If using uvx, add '--python 3.14' to your config args:\n"
+        '  "args": ["--python", "3.14", "--refresh", "ha-mcp@latest"]\n'
+        "Or install Python 3.14: brew install python@3.14 (macOS) / "
+        "sudo apt install python3.14 (Linux)\n"
+    )
+    sys.exit(1)
+
 # Must be imported before anything that reaches fastmcp (``.auth`` below does),
 # because fastmcp configures rich logging at import time and dies on a rich
 # older than 13.9.4. Importing this module applies the shim. See #2186.

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/__main__.py

@@ -1,20 +1,5 @@
 """Home Assistant MCP Server."""
 
-import sys
-
-if sys.version_info < (3, 13):  # noqa: UP036 — uvx can bypass requires-python and run on 3.12
-    # Write directly to stderr (not print) so this import-time version gate
-    # fires before any 3.13-only syntax in the rest of the module is parsed.
-    sys.stderr.write(
-        f"ERROR: ha-mcp requires Python 3.13+, but you are running Python "
-        f"{sys.version_info.major}.{sys.version_info.minor}.\n"
-        "If using uvx, add '--python 3.13' to your config args:\n"
-        '  "args": ["--python", "3.13", "--refresh", "ha-mcp@latest"]\n'
-        "Or install Python 3.13: brew install python@3.13 (macOS) / "
-        "sudo apt install python3.13 (Linux)\n"
-    )
-    sys.exit(1)
-
 import truststore
 
 truststore.inject_into_ssl()
@@ -65,7 +50,7 @@ class OAuthProxyClient:
         self._oauth_clients: dict[str, HomeAssistantClient] = {}
         self._lock = threading.Lock()
 
-    def current_client(self) -> "HomeAssistantClient":
+    def current_client(self) -> HomeAssistantClient:
         """The requesting user's client; per-user caches key on it, not the proxy."""
         from ha_mcp._vendor.fastmcp.server.dependencies import get_access_token
         from ha_mcp.client.rest_client import (
@@ -215,7 +200,7 @@ def _check_stdin_available() -> bool:
     try:
         fd = sys.stdin.fileno()
         mode = os.fstat(fd).st_mode
-    except (ValueError, OSError):
+    except ValueError, OSError:
         # fileno() or fstat() can raise if stdin is not a real file
         return False
 
@@ -271,7 +256,7 @@ For setup instructions, see:
     sys.exit(1)
 
 
-def _validate_standard_credentials(settings: "Settings") -> None:
+def _validate_standard_credentials(settings: Settings) -> None:
     """Exit with error if HA credentials are OAuth sentinels in standard (non-OAuth) mode."""
     from ha_mcp.config import OAUTH_MODE_TOKEN, OAUTH_MODE_URL
 
@@ -327,7 +312,7 @@ def _http_run_kwargs(host: str, port: int, path: str) -> dict[str, Any]:
     }
 
 
-def _create_server() -> "HomeAssistantSmartMCPServer":
+def _create_server() -> HomeAssistantSmartMCPServer:
     """Create server instance (deferred to avoid import during smoke test)."""
     from pydantic import ValidationError
 
@@ -350,10 +335,10 @@ def _create_server() -> "HomeAssistantSmartMCPServer":
 
 
 # Lazy server creation - only create when needed
-_server: "HomeAssistantSmartMCPServer | None" = None
+_server: HomeAssistantSmartMCPServer | None = None
 
 
-def _get_mcp() -> "FastMCP":
+def _get_mcp() -> FastMCP:
     """Get the MCP instance, creating server if needed."""
     global _server
     if _server is None:
@@ -361,7 +346,7 @@ def _get_mcp() -> "FastMCP":
     return _server.mcp
 
 
-def _get_server() -> "HomeAssistantSmartMCPServer":
+def _get_server() -> HomeAssistantSmartMCPServer:
     """Get the server instance, creating if needed."""
     global _server
     if _server is None:
@@ -559,7 +544,7 @@ async def _cleanup_resources() -> None:
     logger.info("Server resources cleaned up")
 
 
-def _log_cleanup_result(task: "asyncio.Future[None]") -> None:
+def _log_cleanup_result(task: asyncio.Future[None]) -> None:
     """Consume the cleanup task's outcome so a failure is never silent.
 
     ``asyncio.wait`` does not retrieve results, and the timeout path
@@ -1138,7 +1123,7 @@ def _oidc_allowed_client_redirect_uris() -> list[str] | None:
 
 
 def register_browser_landing(
-    mcp_instance: "FastMCP | _DeferredMCP",
+    mcp_instance: FastMCP | _DeferredMCP,
     path: str,
 ) -> None:
     """Register the friendly browser landing page and tidy the uvicorn access log.
@@ -1277,8 +1262,8 @@ def _resolve_settings_secret_path() -> str | None:
 
 
 def _register_settings_ui_secret_path(
-    mcp: "FastMCP",
-    server: "HomeAssistantSmartMCPServer",
+    mcp: FastMCP,
+    server: HomeAssistantSmartMCPServer,
     host: str,
     port: int,
     mcp_path: str,

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/_rich_compat.py

@@ -67,7 +67,7 @@ def ensure_rich_handler_compat() -> bool:
 
     try:
         parameters = inspect.signature(original_init).parameters
-    except (TypeError, ValueError):  # pragma: no cover - exotic rich build
+    except TypeError, ValueError:  # pragma: no cover - exotic rich build
         logger.debug("RichHandler.__init__ is not introspectable; skipping shim")
         return False
 

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/auth/consent_form.py

@@ -14,7 +14,7 @@ def _extract_domain(redirect_uri: str) -> str:
     try:
         parsed = urlparse(redirect_uri)
         return parsed.netloc or redirect_uri
-    except (AttributeError, TypeError, ValueError):
+    except AttributeError, TypeError, ValueError:
         return redirect_uri
 
 

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/backup_calendar.py

@@ -76,7 +76,7 @@ async def _locate_calendar_event(
         days = int(
             getattr(get_global_settings(), "auto_backup_calendar_lookahead_days", 7)
         )
-    except (AttributeError, ImportError, ValueError, TypeError):
+    except AttributeError, ImportError, ValueError, TypeError:
         days = 7
     days = max(1, min(365, days))
     now = datetime.now(UTC)

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/backup_manager.py

@@ -1979,7 +1979,7 @@ def get_backup_manager(client: Any, settings: Any) -> BackupManager:
         register_default_handlers(mgr, client)
         try:
             client._auto_backup_manager = mgr
-        except (AttributeError, TypeError):
+        except AttributeError, TypeError:
             # Read-only client (e.g. a slotted mock) — manager still works,
             # just isn't cached.
             pass

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/client/rest_client.py

@@ -268,7 +268,7 @@ def _pick_render_error(first: str, queue: asyncio.Queue[dict[str, Any]]) -> str:
     while True:
         try:
             event = queue.get_nowait().get("event") or {}
-        except (asyncio.QueueEmpty, asyncio.QueueShutDown):
+        except asyncio.QueueEmpty, asyncio.QueueShutDown:
             break
         error = event.get("error")
         if event.get("level") == "ERROR" and isinstance(error, str):
@@ -406,7 +406,7 @@ class HomeAssistantClient:
 
         logger.info(f"Initialized Home Assistant client for {self.base_url}")
 
-    async def __aenter__(self) -> "HomeAssistantClient":
+    async def __aenter__(self) -> HomeAssistantClient:
         """Async context manager entry."""
         return self
 

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/client/websocket_client.py

@@ -1242,7 +1242,7 @@ class HomeAssistantWebSocketClient:
 MAX_POOL_SIZE = 50
 
 
-def _log_stale_disconnect(future: "concurrent.futures.Future[None]") -> None:
+def _log_stale_disconnect(future: concurrent.futures.Future[None]) -> None:
     """Report how a disconnect scheduled on a stale event loop ended.
 
     Nothing awaits that future, so without this the outcome would be invisible
@@ -1274,7 +1274,7 @@ class WebSocketManager:
     _lock_loop: asyncio.AbstractEventLoop | None = None
     _client_factory: Callable[..., HomeAssistantWebSocketClient] | None = None
 
-    def __new__(cls) -> "WebSocketManager":
+    def __new__(cls) -> WebSocketManager:
         if cls._instance is None:
             cls._instance = super().__new__(cls)
             cls._instance._clients = {}
@@ -1492,7 +1492,7 @@ class WebSocketManager:
                     # doing network I/O and leave a fresh connection retained
                     # in the pool.
                     raise
-                except (OSError, RuntimeError):
+                except OSError, RuntimeError:
                     logger.warning(
                         "Error disconnecting stale WebSocket client",
                         exc_info=True,
@@ -1547,7 +1547,7 @@ class WebSocketManager:
                 # cancelled caller (mirror of the stale-replacement clause
                 # in get_client).
                 raise
-            except (OSError, RuntimeError):
+            except OSError, RuntimeError:
                 logger.warning(
                     "Error disconnecting evicted WebSocket client",
                     exc_info=True,
@@ -1577,7 +1577,7 @@ class WebSocketManager:
             for client in clients:
                 try:
                     await client.disconnect()
-                except (OSError, RuntimeError, asyncio.CancelledError):
+                except OSError, RuntimeError, asyncio.CancelledError:
                     logger.warning(
                         "Error disconnecting WebSocket client", exc_info=True
                     )

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/config.py

@@ -75,7 +75,7 @@ __all__ = [
 ]
 
 
-def parse_extra_yaml_write_keys(settings: "Settings") -> list[str]:
+def parse_extra_yaml_write_keys(settings: Settings) -> list[str]:
     """Parse ``extra_yaml_write_keys`` into a clean key list (#1887).
 
     Whitespace and empty entries are dropped and the result is deduplicated
@@ -212,7 +212,7 @@ def _reset_embedded_connection() -> None:
     _EMBEDDED_CONNECTION.clear()
 
 
-def _apply_embedded_connection(settings: "Settings") -> None:
+def _apply_embedded_connection(settings: Settings) -> None:
     """Apply the in-process embedded HA connection (url/token/verify_ssl) if registered.
 
     No-op outside embedded mode. Plain ``setattr`` (``validate_assignment`` is off

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/config_backup.py

@@ -88,7 +88,7 @@ def _read_backup_override_file() -> dict[str, object]:
         from .utils.data_paths import get_data_dir
 
         path: Path = get_data_dir() / _BACKUP_OVERRIDE_FILENAME
-    except (RuntimeError, OSError):
+    except RuntimeError, OSError:
         # Couldn't resolve the data dir at all — user has no override
         # file by definition. Silent.
         return {}
@@ -190,7 +190,7 @@ def _coerce_backup_override_value(
 
 
 def _apply_one_backup_override(
-    settings: "Settings",
+    settings: Settings,
     field_name: str,
     env_name: str,
     ftype: RegistryFieldType,
@@ -217,7 +217,7 @@ def _apply_one_backup_override(
         )
 
 
-def _apply_backup_overrides(settings: "Settings") -> None:
+def _apply_backup_overrides(settings: Settings) -> None:
     """Patch ``settings`` with values from the override file, in place.
 
     Honors the "env var wins" contract: a field whose env var is set in

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/config_overrides.py

@@ -136,7 +136,7 @@ def _read_feature_flag_override_file() -> dict[str, object]:
         from .utils.data_paths import get_data_dir
 
         path: Path = get_data_dir() / _FEATURE_FLAG_OVERRIDE_FILENAME
-    except (RuntimeError, OSError):
+    except RuntimeError, OSError:
         # Couldn't resolve the data dir at all — user has no override
         # file by definition. Silent.
         return {}
@@ -215,7 +215,7 @@ def _coerce_feature_flag_value(
 
 
 def _apply_one_feature_flag_override(
-    settings: "Settings",
+    settings: Settings,
     field_name: str,
     env_name: str,
     ftype: RegistryFieldType,
@@ -256,7 +256,7 @@ def _apply_one_feature_flag_override(
         )
 
 
-def _apply_beta_master_gate(settings: "Settings") -> None:
+def _apply_beta_master_gate(settings: Settings) -> None:
     """Force BETA_FEATURE_FIELDS to False when ``enable_beta_features`` is off.
 
     This is the "master toggle" semantics: even a power user who sets
@@ -300,7 +300,7 @@ def _apply_beta_master_gate(settings: "Settings") -> None:
                 )
 
 
-def _apply_feature_flag_overrides(settings: "Settings") -> None:
+def _apply_feature_flag_overrides(settings: Settings) -> None:
     """Patch ``settings`` with override-file values + apply the master beta gate.
 
     Two behaviors interleave:
@@ -429,7 +429,7 @@ def _advanced_override_passes_constraints(fname: str, coerced: Any) -> bool:
 
 
 def _apply_one_advanced_override(
-    settings: "Settings",
+    settings: Settings,
     fname: str,
     env_name: str,
     ftype: RegistryFieldType,
@@ -461,7 +461,7 @@ def _apply_one_advanced_override(
         return
     try:
         setattr(settings, fname, coerced)
-    except (ValueError, TypeError):
+    except ValueError, TypeError:
         # Narrowed from bare ``Exception`` to match the parallel
         # _apply_feature_flag_overrides handler. Pydantic validation
         # surfaces failures as ValueError; an
@@ -474,7 +474,7 @@ def _apply_one_advanced_override(
         )
 
 
-def _apply_advanced_overrides(settings: "Settings") -> None:
+def _apply_advanced_overrides(settings: Settings) -> None:
     """Patch ``settings`` with advanced-section override values from
     ``feature_flags.json``.
 

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/config_settings.py

@@ -72,7 +72,7 @@ def _parse_lenient(
         return None, "not a number"
     try:
         val = float(v)  # type: ignore[arg-type]
-    except (ValueError, TypeError):
+    except ValueError, TypeError:
         return None, "not a number"
     if val == setting.off_value:
         return int(val), None

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/dashboard_screenshot/capture.py

@@ -757,7 +757,7 @@ async def _request_or_collect_failure(
             raise
         try:
             failure = json.loads(str(exc))
-        except (json.JSONDecodeError, TypeError):
+        except json.JSONDecodeError, TypeError:
             failure = None
         if not isinstance(failure, dict):
             failure = create_error_response(
@@ -825,7 +825,7 @@ def _reraise_with_guard_warnings(error: ToolError, warnings: list[str]) -> NoRet
         raise error
     try:
         payload = json.loads(str(error))
-    except (json.JSONDecodeError, TypeError):
+    except json.JSONDecodeError, TypeError:
         payload = None
     if not isinstance(payload, dict):
         raise error

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/dashboard_screenshot/paths.py

@@ -714,7 +714,7 @@ async def _validate_legacy_dashboard_root(
         except ToolError as exc:
             try:
                 error_payload = json.loads(str(exc))
-            except (json.JSONDecodeError, TypeError):
+            except json.JSONDecodeError, TypeError:
                 # A non-JSON ToolError (e.g. a WS-layer error whose str() is not
                 # the raise_tool_error JSON form) must surface as its original
                 # ToolError, not as the leaked parse exception.

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/log_filters.py

@@ -43,7 +43,7 @@ class StatelessSessionLogFilter(logging.Filter):
             return True
         try:
             message = record.getMessage()
-        except (ValueError, TypeError):
+        except ValueError, TypeError:
             # A malformed %-format record on this logger is not our target, and
             # a filter must not raise: filters run in Logger.handle() with no
             # exception handling, so a raise would crash the logging call.

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/policy/decision_pin.py

@@ -160,7 +160,7 @@ def _load_record(data_dir: Path) -> tuple[str, dict[str, Any] | None]:
         raw = json.loads(path.read_text(encoding="utf-8"))
     except FileNotFoundError:
         return PIN_ABSENT, None
-    except (OSError, ValueError):
+    except OSError, ValueError:
         # ValueError rather than JSONDecodeError alone: reading the bytes can
         # fail before the parser ever sees them. A file holding invalid UTF-8
         # raises UnicodeDecodeError here, and that is the same answer to the
@@ -193,7 +193,7 @@ def _decode_record(record: dict[str, Any]) -> tuple[bytes, bytes, int] | None:
         expected = base64.b64decode(record["hash"], validate=True)
         iterations = int(record["iterations"])
         algorithm = record["algorithm"]
-    except (KeyError, TypeError, ValueError, OverflowError, binascii.Error):
+    except KeyError, TypeError, ValueError, OverflowError, binascii.Error:
         # OverflowError is not a ValueError: a JSON work factor written in
         # exponent form, ``1e309``, parses to an infinite float, and int()
         # refuses to convert it. Without this the record escapes as an

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/policy/handlers.py

@@ -173,7 +173,7 @@ async def _get_pending(queue: ApprovalQueue) -> JSONResponse:
 async def _post_approve(queue: ApprovalQueue, request: Request) -> JSONResponse:
     try:
         body = await request.json()
-    except (ValueError, TypeError):
+    except ValueError, TypeError:
         return JSONResponse({"error": "invalid JSON body"}, status_code=400)
     if not isinstance(body, dict):
         return JSONResponse({"error": "body must be a JSON object"}, status_code=400)
@@ -201,7 +201,7 @@ async def _post_approve(queue: ApprovalQueue, request: Request) -> JSONResponse:
 async def _post_deny(queue: ApprovalQueue, request: Request) -> JSONResponse:
     try:
         body = await request.json()
-    except (ValueError, TypeError):
+    except ValueError, TypeError:
         return JSONResponse({"error": "invalid JSON body"}, status_code=400)
     if not isinstance(body, dict):
         return JSONResponse({"error": "body must be a JSON object"}, status_code=400)
@@ -227,7 +227,7 @@ async def _get_decision_pin(data_dir: Path) -> JSONResponse:
 async def _post_decision_pin(data_dir: Path, request: Request) -> JSONResponse:
     try:
         body = await request.json()
-    except (ValueError, TypeError):
+    except ValueError, TypeError:
         return JSONResponse({"error": "invalid JSON body"}, status_code=400)
     if not isinstance(body, dict):
         return JSONResponse({"error": "body must be a JSON object"}, status_code=400)

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/policy/model.py

@@ -141,7 +141,7 @@ class Policy(BaseModel):
     schema_version: int = Field(default=POLICY_SCHEMA_VERSION, ge=1)
 
     @model_validator(mode="after")
-    def _wait_must_be_less_than_ttl(self) -> "Policy":
+    def _wait_must_be_less_than_ttl(self) -> Policy:
         # If the middleware's wait window can outlast the entry's TTL
         # the queue's sweeper evicts the entry mid-wait and the
         # reissue-pending path fires on every call — burning one

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/policy/persistence.py

@@ -118,7 +118,7 @@ def _migrate_policy_any_semantics_locked(data_dir: Path) -> bool:
         raw = json.loads(path.read_text(encoding="utf-8"))
     except FileNotFoundError:
         return False
-    except (OSError, json.JSONDecodeError):
+    except OSError, json.JSONDecodeError:
         logger.warning("policy migration: cannot read %s; leaving as-is", path)
         return False
     if not isinstance(raw, dict) or raw.get("schema_version") is not None:

{ha_mcp_dev-9.2.0.dev3491 → ha_mcp_dev-9.3.0.dev3492}/src/ha_mcp/settings_ui/_handlers_advanced.py

@@ -558,7 +558,7 @@ async def _save_advanced_settings(
 
     try:
         body = await request.json()
-    except (ValueError, TypeError):
+    except ValueError, TypeError:
         return JSONResponse(
             create_error_response(
                 ErrorCode.VALIDATION_INVALID_JSON, "Invalid JSON body"