ha-mcp-dev 9.2.0.dev3430__tar.gz → 9.2.0.dev3435__tar.gz

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 9.2.0.dev3430
+Version: 9.2.0.dev3435
 Summary: Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants.
 Keywords: mcp,home-assistant,ai,automation,smart-home
 Author: Julien

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.2.0.dev3430"
+version = "9.2.0.dev3435"
 description = "Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants."
 readme = "README.md"
 requires-python = ">=3.13,<3.15"
@@ -85,23 +85,8 @@ ha-mcp-web = "ha_mcp.__main__:main_web"
 ha-mcp-oauth = "ha_mcp.__main__:main_oauth"
 ha-mcp-oidc = "ha_mcp.__main__:main_oidc"
 
-[tool.uv.build-backend]
-module-name = "ha_mcp"
-source-exclude = [
-    "src/ha_mcp/resources/skills-vendor/.*",
-    "src/ha_mcp/resources/skills-vendor/*.md",
-    "src/ha_mcp/resources/skills-vendor/evals",
-    "src/ha_mcp/resources/skills-vendor/scripts",
-    "src/ha_mcp/settings_ui/AGENTS.md",
-    "src/ha_mcp/settings_ui/CLAUDE.md",
-]
-
-[tool.uv.sources.hamcp-test-env]
-path = "tests/test-env"
-editable = true
-
 [tool.mypy]
-python_version = "3.13"
+python_version = "3.14"
 mypy_path = "src"
 cache_dir = "/tmp/.mypy_cache"
 exclude = ["^src/ha_mcp/resources/skills-vendor/"]
@@ -118,6 +103,13 @@ module = ["ha_mcp._vendor.*"]
 follow_imports = "skip"
 ignore_errors = true
 
+[[tool.mypy.overrides]]
+module = [
+    "voluptuous",
+    "voluptuous.*",
+]
+follow_imports = "skip"
+
 [[tool.mypy.overrides]]
 module = [
     "annotatedyaml.*",
@@ -201,14 +193,18 @@ ignore = [
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 empty_parameter_set_mark = "fail_at_collect"
+strict_markers = true
+strict_config = true
 addopts = [
-    "--strict-markers",
-    "--strict-config",
     "--verbose",
     "--tb=short",
     "--maxfail=3",
     "-ra",
     "--durations=10",
+    "-p",
+    "no:pytest_homeassistant",
+    "-p",
+    "no:respx",
 ]
 markers = [
     "slow: marks tests as slow (use -m 'not slow' to skip)",
@@ -258,8 +254,8 @@ markers = [
     "requires_component_surface: needs an active ha_mcp_tools config entry - skipped on the no-tools lanes without an active server entry (plain container, HAOS inaddon, where it is absent or disabled); #2584",
 ]
 asyncio_mode = "auto"
-asyncio_default_fixture_loop_scope = "session"
-asyncio_default_test_loop_scope = "session"
+asyncio_default_fixture_loop_scope = "function"
+asyncio_default_test_loop_scope = "function"
 timeout = 300
 timeout_method = "signal"
 timeout_func_only = true
@@ -272,8 +268,27 @@ filterwarnings = [
     "ignore::DeprecationWarning",
     "ignore::PendingDeprecationWarning",
     "ignore::ResourceWarning",
+    "ignore::aiohttp.web_exceptions.NotAppKeyWarning",
+]
+
+[tool.uv]
+environments = ["python_full_version >= '3.14.2'"]
+
+[tool.uv.build-backend]
+module-name = "ha_mcp"
+source-exclude = [
+    "src/ha_mcp/resources/skills-vendor/.*",
+    "src/ha_mcp/resources/skills-vendor/*.md",
+    "src/ha_mcp/resources/skills-vendor/evals",
+    "src/ha_mcp/resources/skills-vendor/scripts",
+    "src/ha_mcp/settings_ui/AGENTS.md",
+    "src/ha_mcp/settings_ui/CLAUDE.md",
 ]
 
+[tool.uv.sources.hamcp-test-env]
+path = "tests/test-env"
+editable = true
+
 [tool.semantic_release]
 version_toml = ["pyproject.toml:project.version"]
 version_variables = [
@@ -306,7 +321,8 @@ upload_to_vcs_release = false
 
 [dependency-groups]
 dev = [
-    "aiohttp>=3.13.5",
+    "homeassistant==2026.11.0",
+    "pytest-homeassistant==2026.11.0",
     "websockets>=15.0.1",
     "docker>=7.1.0",
     "mcp>=1.26.0,<2",
@@ -317,9 +333,7 @@ dev = [
     "pytest-timeout>=2.3.0",
     "quickjs-ng==0.17.0.2",
     "pytest-rerunfailures>=15.0",
-    "voluptuous>=0.15.2",
     "voluptuous-openapi>=0.4.1",
-    "probatio>=0.11.4",
     "pytest-xdist>=3.8.0",
     "requests>=2.25.0",
     "lefthook>=1.10.0",

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/pyproject.toml.orig

@@ -4,12 +4,14 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.2.0.dev3430"
+version = "9.2.0.dev3435"
 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). src/ stays 3.13-compatible.
+# 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"
 license = "MIT"
 license-files = ["LICENSE"]
@@ -125,7 +127,7 @@ source-exclude = [
 ]
 
 [tool.mypy]
-python_version = "3.13"
+python_version = "3.14"
 mypy_path = "src"
 # /tmp keeps the cache on Linux tmpfs — avoids the slow Windows FS in WSL2.
 # Windows-native contributors can remove this line or override with MYPY_CACHE_DIR.
@@ -154,6 +156,13 @@ module = ["ha_mcp._vendor.*"]
 follow_imports = "skip"
 ignore_errors = true
 
+[[tool.mypy.overrides]]
+# Core 2026.11 installs probatio as ``voluptuous`` at import; the component and
+# the webhook proxy run on Core versions before and after that switch, so
+# voluptuous schemas stay untyped rather than typed as either library.
+module = ["voluptuous", "voluptuous.*"]
+follow_imports = "skip"
+
 [[tool.mypy.overrides]]
 module = [
     "annotatedyaml.*",
@@ -268,15 +277,30 @@ testpaths = ["tests"]
 # as neither a failure nor a real skip. Make it a collection error instead.
 empty_parameter_set_mark = "fail_at_collect"
 
+# Unregistered markers and unknown config keys are errors. Set here, not as
+# --strict-* in addopts: pytest 9.0 (the version Core's test package pins)
+# silently ignores those flags in addopts.
+strict_markers = true
+strict_config = true
+
 # Command line options
 addopts = [
-    "--strict-markers",
-    "--strict-config",
     "--verbose",
     "--tb=short",
     "--maxfail=3",
     "-ra",
     "--durations=10",
+    # Core's test plugin (pytest-homeassistant, dev group) blocks sockets,
+    # fails tests that leave threads or tasks behind, and needs a fresh event
+    # loop per test. The unit and app (add-on) trees load it from their
+    # conftest; E2E sessions, which share one loop and reach real containers,
+    # must not get it from the installed entry point.
+    "-p",
+    "no:pytest_homeassistant",
+    # respx's entry point imports httpx before Home Assistant can alias it to
+    # httpx2, which Core refuses at import. Core's plugin imports respx itself.
+    "-p",
+    "no:respx",
 ]
 
 # Test markers
@@ -333,13 +357,13 @@ markers = [
     "requires_component_surface: needs an active ha_mcp_tools config entry - skipped on the no-tools lanes without an active server entry (plain container, HAOS inaddon, where it is absent or disabled); #2584",
 ]
 
-# Async support - session-scoped loop lets session-scoped fixtures
-# (mcp_server, mcp_client, ha_client) share one event loop with tests.
-# Without this, each test gets a new loop and session-scoped httpx
-# clients fail with "Event loop is closed".
+# A fresh event loop per test, as Core's test plugin requires. The E2E tree
+# runs its tests and fixtures on one session loop instead (session-scoped
+# mcp_server, mcp_client and ha_client share it); see
+# tests/src/e2e/_conftest_collection.py.
 asyncio_mode = "auto"
-asyncio_default_fixture_loop_scope = "session"
-asyncio_default_test_loop_scope = "session"
+asyncio_default_fixture_loop_scope = "function"
+asyncio_default_test_loop_scope = "function"
 
 # Per-test timeout (pytest-timeout). A stuck server-side await otherwise
 # stalls the run silently until the JOB timeout - observed as a 22-minute
@@ -375,17 +399,23 @@ filterwarnings = [
     "ignore::PendingDeprecationWarning",
     # Allow all ResourceWarnings, including those emitted during test cleanup
     "ignore::ResourceWarning",
+    # Core's http component keeps a plain string key on its aiohttp app.
+    "ignore::aiohttp.web_exceptions.NotAppKeyWarning",
 ]
 
 [dependency-groups]
 dev = [
-    # Real aiohttp so tests can pin the ClientTimeout defaults the custom
-    # component's relay and the webhook-proxy addon rely on (both are stubbed
-    # in unit tests; nothing else would catch stub drift). NOT a runtime
-    # dependency — src/ never imports aiohttp; HA core provides it in-process.
-    # Floor = the aiohttp HA core 2026.6 pins (2026.7 pins 3.14.1, 2026.8.dev
-    # pins 3.14.3), so the version tested here is one a supported HA runs.
-    "aiohttp>=3.13.5",
+    # Real Home Assistant Core and Core's own test package: unit tests run
+    # against Core's modules and its `hass` fixture instead of hand-written
+    # fakes, and uv.lock resolves Core's exact pins for the packages ha-mcp
+    # shares with the embedded install (packages Core pins only in
+    # package_constraints.txt are moved by check_ha_constraint_alignment.py
+    # --sync-lock). Both stay on the Core version of the
+    # e2e image (tests/test_constants.py); Renovate bumps all three together.
+    # renovate: datasource=docker depName=ghcr.io/home-assistant/home-assistant
+    "homeassistant==2026.11.0",
+    # renovate: datasource=docker depName=ghcr.io/home-assistant/home-assistant
+    "pytest-homeassistant==2026.11.0",
     # Test infrastructure imports the SHARED websockets directly (the HAOS
     # runtime harness, the image bake, wait_helpers) to talk to Home
     # Assistant's own WebSocket API — that is test tooling driving HA, not
@@ -404,20 +434,12 @@ dev = [
     # Exercise the component's real sandbox thread affinity in focused unit tests.
     "quickjs-ng==0.17.0.2",
     "pytest-rerunfailures>=15.0",
-    # Real voluptuous for the config-flow tests (the component's
-    # config_flow imports it; HA provides it at runtime, tests need it here).
-    "voluptuous>=0.15.2",
     # Real voluptuous-openapi for the embedded e2e LLM-API test: it converts
     # the REAL tool-schema catalog exactly like llm_api.py does at runtime.
     # HA core shipped it through 2026.8; from 2026.9 the component manifest
-    # is what installs it. Unit tests stub it.
+    # is what installs it. aiohttp, voluptuous and probatio (what core 2026.9
+    # converts with) come with homeassistant above.
     "voluptuous-openapi>=0.4.1",
-    # What core 2026.9 switched to, and converts with when the manifest
-    # requirement above is missing. Needed to assert the round trip an
-    # LLM-API tool schema actually makes there (#2361): voluptuous-openapi
-    # alone cannot show the defect, since it spells an exclusive bound in the
-    # numeric form Anthropic accepts.
-    "probatio>=0.11.4",
     "pytest-xdist>=3.8.0",
     "requests>=2.25.0",
     "lefthook>=1.10.0",
@@ -433,6 +455,11 @@ dev = [
     "hamcp-test-env",
 ]
 
+[tool.uv]
+# The dev group's homeassistant requires Python >=3.14.2; the published
+# package keeps >=3.13, so only the lock is narrowed.
+environments = ["python_full_version >= '3.14.2'"]
+
 [tool.uv.sources]
 hamcp-test-env = { path = "tests/test-env", editable = true }
 

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/src/ha_mcp/__main__.py

@@ -502,7 +502,7 @@ def _log_startup_version() -> None:
             "A newer ha-mcp release is available: %s (you have %s). %s",
             info.latest,
             info.current,
-            update_command_hint(info.current),
+            update_command_hint(info.current, info),
         )
 
 

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/src/ha_mcp/config_registry.py

@@ -4,7 +4,7 @@ Every table is derived from the ``Setting`` metadata on the ``Settings``
 fields; add or change a setting there, not here.
 """
 
-from typing import NamedTuple
+from typing import NamedTuple, cast
 
 from pydantic.fields import FieldInfo
 
@@ -173,7 +173,7 @@ def _env(field: FieldInfo) -> str:
 
 def _ftype(field: FieldInfo) -> RegistryFieldType:
     assert field.annotation in (bool, int, float, str)
-    return field.annotation
+    return cast(RegistryFieldType, field.annotation)
 
 
 FEATURE_FLAG_FIELDS: tuple[FeatureFlagField, ...] = tuple(

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/src/ha_mcp/tools/bug_report_sources.py

@@ -5,6 +5,7 @@ import asyncio
 import contextlib
 import ipaddress
 import logging
+import platform
 from collections.abc import Callable
 from typing import Any
 from urllib.parse import urlparse
@@ -282,3 +283,14 @@ async def fetch_ha_install(client: Any) -> dict[str, Any] | None:
         if ws_client is not None:
             with contextlib.suppress(Exception):
                 await ws_client.disconnect()
+
+
+def detect_platform() -> dict[str, str]:
+    """Detect platform information."""
+    return {
+        "os": platform.system(),  # Windows, Darwin, Linux
+        "os_release": platform.release(),
+        "os_version": platform.version(),
+        "architecture": platform.machine(),
+        "python_version": platform.python_version(),
+    }

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/src/ha_mcp/tools/tools_bug_report.py

@@ -11,7 +11,6 @@ import importlib.metadata
 import importlib.util
 import logging
 import os
-import platform
 import sys
 import time
 from pathlib import Path
@@ -35,6 +34,7 @@ from ..mcp_client_context import (
     protocol_version,
 )
 from ..renamed_tools import CLIENT_TOOL_LIST_REFRESH_STEPS
+from ..update_check import python_upgrade_hint
 from ..utils.mcp_client_host import detect_client_host
 from ..utils.usage_logger import (
     AVG_LOG_ENTRIES_PER_TOOL,
@@ -47,6 +47,7 @@ from .bug_report_sources import (
     _fetch_addon_logs,
     _fetch_core_error_log,
     collect_known_identifiers,
+    detect_platform,
     fetch_ha_install,
 )
 from .bug_report_templates import (
@@ -203,17 +204,6 @@ def _instance_identity() -> dict[str, Any]:
     }
 
 
-def _detect_platform() -> dict[str, str]:
-    """Detect platform information."""
-    return {
-        "os": platform.system(),  # Windows, Darwin, Linux
-        "os_release": platform.release(),
-        "os_version": platform.version(),
-        "architecture": platform.machine(),
-        "python_version": platform.python_version(),
-    }
-
-
 def _format_websockets_dependency_value(diagnostic_info: dict[str, Any]) -> str:
     """Render the websockets probe for the human-pasteable report.
 
@@ -766,7 +756,7 @@ class BugReportTools:
                     "startup_log_count, formatted_report, issue_title, "
                     "issue_body, issue_url, anonymization_guide, "
                     "duplicate_check_urls, missing_tool_hint, "
-                    "known_client_issues_hint, instructions."
+                    "known_client_issues_hint, python_upgrade_hint, instructions."
                 ),
             ),
         ] = None,
@@ -819,7 +809,7 @@ class BugReportTools:
 
         # Detect installation method, platform, and runtime config.
         install_method = _detect_installation_method()
-        platform_info = _detect_platform()
+        platform_info = detect_platform()
         config_toggles = _get_config_toggles()
         tool_policy = await asyncio.to_thread(_tool_policy_summary)
         mcp_transport = _detect_mcp_transport()
@@ -989,6 +979,7 @@ class BugReportTools:
                 "duplicate_check_urls": duplicate_check_urls,
                 "missing_tool_hint": MISSING_TOOL_HINT,
                 "known_client_issues_hint": KNOWN_CLIENT_ISSUES_HINT,
+                "python_upgrade_hint": python_upgrade_hint(),
                 "instructions": (
                     "WORKFLOW FOR FILING A REPORT:\n\n"
                     "0. **PRE-CHECK — missing tool or unknown parameter?** If the "
@@ -1004,6 +995,8 @@ class BugReportTools:
                     "bug with an upstream ticket. See the `known_client_issues_hint` "
                     "field for the workaround to give the user, and only continue "
                     "if the problem persists after it.\n\n"
+                    "0c. **Python upgrade?** If `python_upgrade_hint` is set, pass "
+                    "it on to the user, whatever the report is about.\n\n"
                     "1. **Check for duplicates FIRST**:\n"
                     "   - Use the duplicate_check_urls to search for similar issues\n"
                     '   - If gh CLI is available: use `gh issue list --search "keyword"`\n'

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/src/ha_mcp/tools/tools_search.py

@@ -562,6 +562,8 @@ class SearchTools(ComponentSearchMixin, OverviewMixin, StateMixin):
         The response also carries ``ha_mcp_update`` ``{current, latest,
         update_available}`` (PyPI for pip/Docker, the Supervisor store for the
         app) — proactively tell the user when ``update_available`` is true.
+        If it carries ``python_required``, the release needs that Python: give
+        the user ``upgrade_command``.
         Omitted for the ``unknown`` version, when ``HA_MCP_DISABLE_UPDATE_CHECK``
         is set, or when the update check itself failed.
 

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/src/ha_mcp/tools/tools_system.py

@@ -575,8 +575,8 @@ class SystemTools:
         loaded integrations. Optional sections are selected with `include`.
 
         The result may include ``ha_mcp_update`` ``{current, latest,
-        update_available}``. When update_available is true, tell the user a
-        newer ha-mcp release is available.
+        update_available}``. When update_available is true, tell the user a newer
+        ha-mcp release is available (with ``python_required``, give ``upgrade_command``).
 
         EXAMPLES:
         - ha_get_system_health(include="repairs,zha_network,zwave_network,config_check")

{ha_mcp_dev-9.2.0.dev3430 → ha_mcp_dev-9.2.0.dev3435}/src/ha_mcp/tools/tools_updates.py

@@ -1035,7 +1035,7 @@ class UpdateTools:
         failure, but later batch targets were not started. Confirm per entity
         with action='get'; finished updates drop out of 'list', which also
         returns ha_mcp_update — this MCP server's own update status {current,
-        latest, update_available}, so a newer ha-mcp release can be flagged.
+        latest, update_available; python_required + upgrade_command if it needs another Python}.
 
         EXAMPLES:
         - Pre-update analysis: ha_manage_updates(action="get", entity_ids=["update.home_assistant_core_update"], include_release_notes=True)