ha-mcp-dev 7.4.1.dev433__tar.gz → 7.4.1.dev434__tar.gz

{ha_mcp_dev-7.4.1.dev433/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.4.1.dev434}/PKG-INFO

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

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

@@ -248,6 +248,8 @@ class AutomationConfigTools:
 
         Returns the complete configuration including triggers, conditions, actions, and mode settings.
 
+        The returned `config_hash` is stable across consecutive reads of an unchanged config — `compute_config_hash` documents the underlying contract.
+
         EXAMPLES:
         - Get automation: ha_config_get_automation("automation.morning_routine")
         - Get by unique_id: ha_config_get_automation("my_unique_automation_id")

{ha_mcp_dev-7.4.1.dev433 → ha_mcp_dev-7.4.1.dev434}/src/ha_mcp/tools/tools_config_dashboards.py

@@ -483,6 +483,8 @@ def register_config_dashboard_tools(mcp: Any, client: Any, **kwargs: Any) -> Non
           Returns the full Lovelace dashboard config, defaulting to the
           main dashboard if url_path is omitted.
 
+        Return a stable `config_hash` (Get and Search modes only; not present in list_only mode) across consecutive reads of an unchanged config — `compute_config_hash` documents the underlying contract.
+
         EXAMPLES:
         - List all dashboards: ha_config_get_dashboard(list_only=True)
         - Get default dashboard: ha_config_get_dashboard(url_path="default")

{ha_mcp_dev-7.4.1.dev433 → ha_mcp_dev-7.4.1.dev434}/src/ha_mcp/tools/tools_config_scripts.py

@@ -95,6 +95,8 @@ class ConfigScriptTools:
 
         Returns the complete configuration for a script, including sequence, mode, fields, and other settings.
 
+        The returned `config_hash` is stable across consecutive reads of an unchanged config — `compute_config_hash` documents the underlying contract.
+
         EXAMPLES:
         - Get script: ha_config_get_script("morning_routine")
         - Get script: ha_config_get_script("backup_script")

{ha_mcp_dev-7.4.1.dev433 → ha_mcp_dev-7.4.1.dev434}/src/ha_mcp/utils/config_hash.py

@@ -13,6 +13,15 @@ def compute_config_hash(config: dict[str, Any]) -> str:
 
     Uses SHA256 truncated to 16 hex characters (64 bits). Deterministic
     via sorted keys and minimal separators.
+
+    Stability across reads is the caller's contract, not this function's.
+    Automations canonicalize via ``_normalize_config_for_roundtrip`` before
+    hashing; scripts and dashboards hash raw HA responses, so their
+    stability depends on HA returning structurally identical responses on
+    consecutive reads (``sort_keys=True`` canonicalizes dict-key order but
+    not list-element order). The ``test_config_hash_stable_across_reads``
+    E2E tests pin this for each tool family. See issue #980 for the
+    contract analysis.
     """
     config_str = json.dumps(config, sort_keys=True, separators=(",", ":"))
     return hashlib.sha256(config_str.encode()).hexdigest()[:16]

{ha_mcp_dev-7.4.1.dev433 → ha_mcp_dev-7.4.1.dev434/src/ha_mcp_dev.egg-info}/PKG-INFO

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