ha-mcp-dev 7.9.0.dev749__tar.gz → 7.9.0.dev751__tar.gz

{ha_mcp_dev-7.9.0.dev749/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.9.0.dev751}/PKG-INFO

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

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

@@ -86,6 +86,23 @@ SIMPLE_HELPER_TYPES: frozenset[str] = frozenset(
     }
 )
 
+# Stateful HA input helpers skip last-state restore when `initial` is stored in config
+# (including false/0). See input_boolean/input_number async_added_to_hass in HA core.
+_INITIAL_DISABLES_RESTORE_DESCRIPTION = (
+    "When set — even to false/0 — disables last-state restore and forces this "
+    "value on every HA restart. Omit unless you want the helper to reset to this "
+    "value on every restart instead of restoring its last state."
+)
+_INITIAL_PARAM_DESCRIPTION = (
+    "Initial value for applicable helper types. For "
+    "input_boolean, input_select, input_number, input_text, and input_datetime: "
+    "setting `initial` — even to false/0 — disables last-state restore and forces "
+    "that value on every HA restart; omit unless you want the helper to reset to "
+    "that value on every restart instead of restoring its last state. For counter, "
+    "`initial` is just the starting value — restore-on-restart is controlled "
+    "separately by `restore` (default True)."
+)
+
 
 # Bug 4b/7c/10/14 (issue #1150): per-helper-type allowlists of typed
 # parameters. Inapplicable params are rejected at the top of the tool
@@ -233,7 +250,9 @@ SIMPLE_HELPER_SCHEMAS: dict[str, list[_HelperFieldSpec]] = {
             "required": False,
             "selector": {"boolean": {}},
             "description": (
-                "Initial state. Accepts 'true'/'false'/'on'/'off'/'yes'/'no'/'1'/'0'."
+                "Initial state. "
+                f"{_INITIAL_DISABLES_RESTORE_DESCRIPTION} "
+                "Accepts 'true'/'false'/'on'/'off'/'yes'/'no'/'1'/'0'."
             ),
         },
     ],
@@ -257,7 +276,10 @@ SIMPLE_HELPER_SCHEMAS: dict[str, list[_HelperFieldSpec]] = {
             "name": "initial",
             "required": False,
             "selector": {"text": {}},
-            "description": "Initial value — must be one of `options`.",
+            "description": (
+                "Initial value — must be one of `options`. "
+                f"{_INITIAL_DISABLES_RESTORE_DESCRIPTION}"
+            ),
         },
     ],
     "input_number": [
@@ -302,7 +324,12 @@ SIMPLE_HELPER_SCHEMAS: dict[str, list[_HelperFieldSpec]] = {
             "selector": {"select": {"options": ["box", "slider"]}},
             "description": "Default 'slider'.",
         },
-        {"name": "initial", "required": False, "selector": {"number": {}}},
+        {
+            "name": "initial",
+            "required": False,
+            "selector": {"number": {}},
+            "description": _INITIAL_DISABLES_RESTORE_DESCRIPTION,
+        },
         {"name": "icon", "required": False, "selector": {"text": {}}},
     ],
     "input_text": [
@@ -330,7 +357,12 @@ SIMPLE_HELPER_SCHEMAS: dict[str, list[_HelperFieldSpec]] = {
             "selector": {"select": {"options": ["text", "password"]}},
             "description": "Default 'text'.",
         },
-        {"name": "initial", "required": False, "selector": {"text": {}}},
+        {
+            "name": "initial",
+            "required": False,
+            "selector": {"text": {}},
+            "description": _INITIAL_DISABLES_RESTORE_DESCRIPTION,
+        },
         {"name": "icon", "required": False, "selector": {"text": {}}},
     ],
     "input_datetime": [
@@ -362,7 +394,10 @@ SIMPLE_HELPER_SCHEMAS: dict[str, list[_HelperFieldSpec]] = {
             "name": "initial",
             "required": False,
             "selector": {"text": {}},
-            "description": "Initial value (datetime string).",
+            "description": (
+                "Initial value (datetime string). "
+                f"{_INITIAL_DISABLES_RESTORE_DESCRIPTION}"
+            ),
         },
         {"name": "icon", "required": False, "selector": {"text": {}}},
     ],
@@ -373,7 +408,15 @@ SIMPLE_HELPER_SCHEMAS: dict[str, list[_HelperFieldSpec]] = {
             "selector": {"text": {}},
             "description": "Display name.",
         },
-        {"name": "initial", "required": False, "selector": {"number": {}}},
+        {
+            "name": "initial",
+            "required": False,
+            "selector": {"number": {}},
+            "description": (
+                "Initial value. Counter restores its last value on restart by "
+                "default; control via `restore`."
+            ),
+        },
         {
             "name": "min_value",
             "required": False,
@@ -3583,7 +3626,7 @@ class HelperConfigTools:
         initial: Annotated[
             str | int | None,
             Field(
-                description="Initial value for the helper (input_select, input_text, input_boolean, input_datetime, counter)",
+                description=_INITIAL_PARAM_DESCRIPTION,
                 default=None,
             ),
         ] = None,

{ha_mcp_dev-7.9.0.dev749 → ha_mcp_dev-7.9.0.dev751/src/ha_mcp_dev.egg-info}/PKG-INFO

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