ha-mcp-dev 7.14.2.dev2089__tar.gz → 7.14.2.dev2093__tar.gz

{ha_mcp_dev-7.14.2.dev2089/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.14.2.dev2093}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.14.2.dev2089
+Version: 7.14.2.dev2093
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT
@@ -395,7 +395,7 @@ The proxy split lets MCP clients apply different permission policies per categor
 
 Leave it off when using Claude Sonnet/Opus or any client with deferred tool loading; the full catalog has no idle cost there and direct calls skip the search step. If you choose to use our toolsearch then you should disable the native Claude Opus/Sonnet toolsearch, which is called deferred tools in the settings.
 
-> 🔄 **Refresh your client's tool list after changing this (or any) setting.** Toggling `ENABLE_TOOL_SEARCH` (or changing pinned/disabled tools, Read Only Mode, etc.) changes the tools the server exposes, but your AI client keeps serving its **cached** tool list until it re-fetches. Restarting the add-on or Home Assistant does **not** refresh the client — reconnect or refresh the MCP server in your client (e.g. re-add/refresh the connector in ChatGPT, or close and reopen Claude Desktop). If you skip this, tools shown as available will return `Unknown tool` when called.
+> 🔄 **Refresh your client's tool list after changing this (or any) setting.** Toggling `ENABLE_TOOL_SEARCH` (or changing pinned/disabled tools, Read Only Mode, etc.) changes the tools the server exposes, but your AI client keeps serving its **cached** tool list until it re-fetches. Restarting the add-on or Home Assistant does **not** refresh the client — reconnect or refresh the MCP server in your client (e.g. re-add/refresh the connector in ChatGPT, or close and reopen Claude Desktop). If you skip this, newly enabled tools won't appear in the client at all, and tools the server no longer exposes still show as available but return `Unknown tool` when called. ChatGPT sometimes keeps serving the stale list even after the connector is removed and re-added under the same name — if tools are still missing after re-adding, delete the connector and create a new one with a **different name**.
 
 For the HA add-on, the same option is documented in [`homeassistant-addon/DOCS.md`](homeassistant-addon/DOCS.md#enable_tool_search) along with the in-add-on settings UI for fine-grained tool enable/disable/pin.
 

{ha_mcp_dev-7.14.2.dev2089 → ha_mcp_dev-7.14.2.dev2093}/README.md

@@ -362,7 +362,7 @@ The proxy split lets MCP clients apply different permission policies per categor
 
 Leave it off when using Claude Sonnet/Opus or any client with deferred tool loading; the full catalog has no idle cost there and direct calls skip the search step. If you choose to use our toolsearch then you should disable the native Claude Opus/Sonnet toolsearch, which is called deferred tools in the settings.
 
-> 🔄 **Refresh your client's tool list after changing this (or any) setting.** Toggling `ENABLE_TOOL_SEARCH` (or changing pinned/disabled tools, Read Only Mode, etc.) changes the tools the server exposes, but your AI client keeps serving its **cached** tool list until it re-fetches. Restarting the add-on or Home Assistant does **not** refresh the client — reconnect or refresh the MCP server in your client (e.g. re-add/refresh the connector in ChatGPT, or close and reopen Claude Desktop). If you skip this, tools shown as available will return `Unknown tool` when called.
+> 🔄 **Refresh your client's tool list after changing this (or any) setting.** Toggling `ENABLE_TOOL_SEARCH` (or changing pinned/disabled tools, Read Only Mode, etc.) changes the tools the server exposes, but your AI client keeps serving its **cached** tool list until it re-fetches. Restarting the add-on or Home Assistant does **not** refresh the client — reconnect or refresh the MCP server in your client (e.g. re-add/refresh the connector in ChatGPT, or close and reopen Claude Desktop). If you skip this, newly enabled tools won't appear in the client at all, and tools the server no longer exposes still show as available but return `Unknown tool` when called. ChatGPT sometimes keeps serving the stale list even after the connector is removed and re-added under the same name — if tools are still missing after re-adding, delete the connector and create a new one with a **different name**.
 
 For the HA add-on, the same option is documented in [`homeassistant-addon/DOCS.md`](homeassistant-addon/DOCS.md#enable_tool_search) along with the in-add-on settings UI for fine-grained tool enable/disable/pin.
 

{ha_mcp_dev-7.14.2.dev2089 → ha_mcp_dev-7.14.2.dev2093}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.14.2.dev2089"
+version = "7.14.2.dev2093"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 # Upper bound widened to <3.15 so the package installs on Home Assistant's

{ha_mcp_dev-7.14.2.dev2089 → ha_mcp_dev-7.14.2.dev2093}/src/ha_mcp/settings_ui/locales/de.json

@@ -21,7 +21,7 @@
     "tabs.policies": "Tool-Sicherheitsrichtlinien",
     "tabs.visibility": "Entitäts-Sichtbarkeit",
     "tabs.accessibility": "Barrierefreiheit",
-    "notice.restart_required": "⚠ Änderungen gespeichert. Starte HA-MCP neu, damit sie wirksam werden. Beim nächsten Start entfernt HA-MCP deaktivierte Tools vollständig aus der MCP-Tool-Liste. Verbinde dann den MCP-Server in deinem KI-Client neu oder aktualisiere ihn (z. B. Tool-Liste auf claude.ai aktualisieren, Connector in ChatGPT erneut hinzufügen oder aktualisieren oder Claude Desktop schließen und neu öffnen), damit die Tool-Liste neu geladen wird. Das Neustarten des Add-ons oder von Home Assistant aktualisiert NICHT die vom Client zwischengespeicherte Tool-Liste.",
+    "notice.restart_required": "⚠ Änderungen gespeichert. Starte HA-MCP neu, damit sie wirksam werden. Beim nächsten Start entfernt HA-MCP deaktivierte Tools vollständig aus der MCP-Tool-Liste. Verbinde dann den MCP-Server in deinem KI-Client neu oder aktualisiere ihn (z. B. Tool-Liste auf claude.ai aktualisieren, Connector in ChatGPT erneut hinzufügen oder aktualisieren oder Claude Desktop schließen und neu öffnen), damit die Tool-Liste neu geladen wird. Das Neustarten des Add-ons oder von Home Assistant aktualisiert NICHT die vom Client zwischengespeicherte Tool-Liste. ChatGPT liefert die zwischengespeicherte Tool-Liste manchmal auch nach dem Entfernen und erneuten Hinzufügen des Connectors weiter aus — fehlen Tools weiterhin, lösche den Connector und lege ihn unter einem anderen Namen neu an.",
     "notice.shared_settings": "Server-weite Funktionen (Tool-Suche, YAML-Konfigurationsbearbeitung, Dateisystem-Tools usw.) erscheinen sowohl im Tab <strong>Server-Einstellungen</strong> als auch auf der Add-on-Konfigurationsseite; es sind dieselben Einstellungen. Beide Ansichten bleiben nach dem Neustart des Add-ons synchron. Änderungen erfordern einen Neustart von HA-MCP.",
     "notice.env_pins": "Tools, die in den Umgebungsvariablen <code>DISABLED_TOOLS</code> oder <code>PINNED_TOOLS</code> aufgeführt sind, sind schreibgeschützt gesperrt; hebe die Umgebungsvariable auf, um sie hier zu bearbeiten. Anheftungs-Toggles wirken nur, wenn die Tool-Suche aktiviert ist (Tab Server-Einstellungen oder Add-on-Konfigurationsseite).",
     "actions.restart_addon": "Add-on neu starten",
@@ -33,7 +33,7 @@
     "tools.read_only.help": "Schaltet alle Schreibtools aus und verhindert, dass Tools Schreib- oder destruktive Aufrufe tätigen. Gemischte Lese-/Schreib-Tools (Backups, Add-ons, Energiepräferenzen, Voice-Pipelines und Code-Modus, wenn aktiviert) bleiben verfügbar, wobei ihre Schreiboperationen blockiert sind.",
     "tools.read_only.unknown": "Server-Einstellungen konnten nicht gelesen werden. Status des Nur-Lese-Modus unbekannt; diese Ansicht spiegelt möglicherweise nicht wider, was der Server erzwingt.",
     "tools.search": "Tools durchsuchen...",
-    "server.auto_save_notice": "Einstellungen auf diesem Tab werden automatisch gespeichert. Änderungen werden erst wirksam, nachdem du das Add-on neu gestartet hast (wendet sie serverseitig an) und die MCP-Server-Verbindung in deinem KI-Client neu verbindest oder aktualisierst (lädt die Tool-Liste neu), z. B. Tool-Liste auf claude.ai aktualisieren, Connector in ChatGPT erneut hinzufügen oder aktualisieren oder Claude Desktop schließen und neu öffnen.",
+    "server.auto_save_notice": "Einstellungen auf diesem Tab werden automatisch gespeichert. Änderungen werden erst wirksam, nachdem du das Add-on neu gestartet hast (wendet sie serverseitig an) und die MCP-Server-Verbindung in deinem KI-Client neu verbindest oder aktualisierst (lädt die Tool-Liste neu), z. B. Tool-Liste auf claude.ai aktualisieren, Connector in ChatGPT erneut hinzufügen oder aktualisieren oder Claude Desktop schließen und neu öffnen. ChatGPT liefert die zwischengespeicherte Tool-Liste manchmal auch nach dem Entfernen und erneuten Hinzufügen des Connectors weiter aus — fehlen Tools weiterhin, lösche den Connector und lege ihn unter einem anderen Namen neu an.",
     "server.sections.search": "Suche & Abgleich",
     "server.sections.operations": "Operationen",
     "server.sections.tool_surface": "Tool-Oberfläche",

{ha_mcp_dev-7.14.2.dev2089 → ha_mcp_dev-7.14.2.dev2093}/src/ha_mcp/settings_ui/locales/en.json

@@ -21,7 +21,7 @@
     "tabs.policies": "Tool Security Policies",
     "tabs.visibility": "Entity Visibility",
     "tabs.accessibility": "Accessibility",
-    "notice.restart_required": "⚠ Changes saved. Restart HA-MCP for them to take effect. On next startup, HA-MCP fully removes disabled tools from the MCP tool list. Then reconnect or refresh the MCP server in your AI client (e.g. refresh tool list on claude.ai, re-add/refresh the connector in ChatGPT, or close and reopen Claude Desktop) so it reloads the tool list. Restarting the App (add-on) or Home Assistant does NOT refresh your client's cached tool list.",
+    "notice.restart_required": "⚠ Changes saved. Restart HA-MCP for them to take effect. On next startup, HA-MCP fully removes disabled tools from the MCP tool list. Then reconnect or refresh the MCP server in your AI client (e.g. refresh tool list on claude.ai, re-add/refresh the connector in ChatGPT, or close and reopen Claude Desktop) so it reloads the tool list. Restarting the App (add-on) or Home Assistant does NOT refresh your client's cached tool list. ChatGPT sometimes keeps serving its cached tool list even after the connector is removed and re-added — if tools are still missing, delete the connector and create a new one under a different name.",
     "notice.shared_settings": "Server-wide features (Tool Search, YAML config editing, filesystem tools, etc.) appear in both the <strong>Server Settings</strong> tab and the App (add-on) Configuration page; they're the same settings either way. Either surface stays in sync with the other after the App (add-on) restarts. Changes require HA-MCP to be restarted.",
     "notice.env_pins": "Tools listed in the <code>DISABLED_TOOLS</code> or <code>PINNED_TOOLS</code> env vars are locked read-only; unset the env var to edit them here. Pin toggles only take effect when Tool Search is enabled (Server Settings tab or App (add-on) Configuration page).",
     "actions.restart_addon": "Restart App (add-on)",
@@ -33,7 +33,7 @@
     "tools.read_only.help": "Turns off all write tools and blocks every tool from making write or destructive calls. Mixed read/write tools (backups, Apps (add-ons), energy preferences, voice pipelines, and code mode when enabled) stay available with their write operations blocked.",
     "tools.read_only.unknown": "Could not read server settings. Read Only Mode status unknown; this view may not reflect what the server enforces.",
     "tools.search": "Search tools...",
-    "server.auto_save_notice": "Settings on this tab save automatically. Changes take effect only after you restart the App (add-on) (applies them server-side) and reconnect or refresh the MCP server in your AI client (reloads the tool list), e.g. refresh tool list on claude.ai, re-add or refresh the connector in ChatGPT, or close and reopen Claude Desktop.",
+    "server.auto_save_notice": "Settings on this tab save automatically. Changes take effect only after you restart the App (add-on) (applies them server-side) and reconnect or refresh the MCP server in your AI client (reloads the tool list), e.g. refresh tool list on claude.ai, re-add or refresh the connector in ChatGPT, or close and reopen Claude Desktop. ChatGPT sometimes keeps serving its cached tool list even after the connector is removed and re-added — if tools are still missing, delete the connector and create a new one under a different name.",
     "server.sections.search": "Search & matching",
     "server.sections.operations": "Operations",
     "server.sections.tool_surface": "Tool surface",

{ha_mcp_dev-7.14.2.dev2089 → ha_mcp_dev-7.14.2.dev2093}/src/ha_mcp/settings_ui/locales/ru.json

@@ -21,7 +21,7 @@
     "tabs.policies": "Политики безопасности",
     "tabs.visibility": "Видимость сущностей",
     "tabs.accessibility": "Оформление и доступность",
-    "notice.restart_required": "⚠ Изменения сохранены. Чтобы они вступили в силу, перезапустите HA-MCP. При следующем запуске HA-MCP полностью удалит отключённые инструменты из списка MCP. Затем переподключите или обновите MCP-сервер в клиенте ИИ, чтобы он заново загрузил список инструментов: обновите список на claude.ai, повторно добавьте или обновите коннектор в ChatGPT либо закройте и снова откройте Claude Desktop. Перезапуск приложения (дополнения) или Home Assistant НЕ обновляет список инструментов, сохранённый в кеше клиента.",
+    "notice.restart_required": "⚠ Изменения сохранены. Чтобы они вступили в силу, перезапустите HA-MCP. При следующем запуске HA-MCP полностью удалит отключённые инструменты из списка MCP. Затем переподключите или обновите MCP-сервер в клиенте ИИ, чтобы он заново загрузил список инструментов: обновите список на claude.ai, повторно добавьте или обновите коннектор в ChatGPT либо закройте и снова откройте Claude Desktop. Перезапуск приложения (дополнения) или Home Assistant НЕ обновляет список инструментов, сохранённый в кеше клиента. ChatGPT иногда продолжает использовать кешированный список инструментов даже после удаления и повторного добавления коннектора — если инструменты по-прежнему отсутствуют, удалите коннектор и создайте новый под другим именем.",
     "notice.shared_settings": "Общие серверные функции — поиск инструментов, редактирование YAML-конфигурации, работа с файлами и другие — отображаются и на вкладке <strong>Настройки сервера</strong>, и на странице конфигурации приложения (дополнения). Это одни и те же параметры. После перезапуска приложения обе страницы синхронизируются. Изменения требуют перезапуска HA-MCP.",
     "notice.env_pins": "Инструменты, перечисленные в переменных окружения <code>DISABLED_TOOLS</code> или <code>PINNED_TOOLS</code>, заблокированы от редактирования. Чтобы изменить их здесь, удалите инструмент из соответствующей переменной. Переключатели закрепления действуют только при включённом поиске инструментов — на вкладке настроек сервера или странице конфигурации приложения.",
     "actions.restart_addon": "Перезапустить приложение",
@@ -33,7 +33,7 @@
     "tools.read_only.help": "Отключает все инструменты записи и запрещает каждому инструменту выполнять изменяющие или разрушительные операции. Смешанные инструменты чтения и записи — резервные копии, приложения, параметры энергии, голосовые конвейеры и режим кода — остаются доступными, но их операции записи блокируются.",
     "tools.read_only.unknown": "Не удалось прочитать настройки сервера. Состояние режима только для чтения неизвестно; показанное значение может не соответствовать фактическим ограничениям сервера.",
     "tools.search": "Поиск инструментов...",
-    "server.auto_save_notice": "Настройки на этой вкладке сохраняются автоматически. Изменения вступят в силу только после перезапуска приложения, который применит их на сервере, и повторного подключения или обновления MCP-сервера в клиенте ИИ, который заново загрузит список инструментов. Например, обновите список на claude.ai, повторно добавьте или обновите коннектор в ChatGPT либо закройте и снова откройте Claude Desktop.",
+    "server.auto_save_notice": "Настройки на этой вкладке сохраняются автоматически. Изменения вступят в силу только после перезапуска приложения, который применит их на сервере, и повторного подключения или обновления MCP-сервера в клиенте ИИ, который заново загрузит список инструментов. Например, обновите список на claude.ai, повторно добавьте или обновите коннектор в ChatGPT либо закройте и снова откройте Claude Desktop. ChatGPT иногда продолжает использовать кешированный список инструментов даже после удаления и повторного добавления коннектора — если инструменты по-прежнему отсутствуют, удалите коннектор и создайте новый под другим именем.",
     "server.sections.search": "Поиск и сопоставление",
     "server.sections.operations": "Операции",
     "server.sections.tool_surface": "Набор инструментов",

{ha_mcp_dev-7.14.2.dev2089 → ha_mcp_dev-7.14.2.dev2093}/src/ha_mcp/settings_ui/locales/zh-Hans.json

@@ -21,7 +21,7 @@
     "tabs.policies": "工具安全策略",
     "tabs.visibility": "实体可见性",
     "tabs.accessibility": "无障碍",
-    "notice.restart_required": "⚠ 更改已保存。请重启 HA-MCP 使其生效。下次启动时，HA-MCP 会从 MCP 工具列表中彻底移除已禁用的工具。随后请在你的 AI 客户端中重新连接或刷新 MCP 服务器（例如在 claude.ai 上刷新工具列表、在 ChatGPT 中重新添加/刷新连接器，或关闭并重新打开 Claude Desktop）以重新加载工具列表。仅重启应用（插件）或 Home Assistant 不会刷新客户端缓存的工具列表。",
+    "notice.restart_required": "⚠ 更改已保存。请重启 HA-MCP 使其生效。下次启动时，HA-MCP 会从 MCP 工具列表中彻底移除已禁用的工具。随后请在你的 AI 客户端中重新连接或刷新 MCP 服务器（例如在 claude.ai 上刷新工具列表、在 ChatGPT 中重新添加/刷新连接器，或关闭并重新打开 Claude Desktop）以重新加载工具列表。仅重启应用（插件）或 Home Assistant 不会刷新客户端缓存的工具列表。ChatGPT 有时在删除并重新添加连接器后仍会继续使用缓存的工具列表——如果工具仍然缺失，请删除该连接器并用一个不同的名称重新创建。",
     "notice.shared_settings": "服务器级功能（工具搜索、YAML 配置编辑、文件系统工具等）会同时出现在<strong>服务器设置</strong>选项卡和应用（插件）配置页中；无论在哪里设置都是同一份配置。在应用（插件）重启后，两个入口会保持同步。更改需要重启 HA-MCP 才能生效。",
     "notice.env_pins": "列在 <code>DISABLED_TOOLS</code> 或 <code>PINNED_TOOLS</code> 环境变量中的工具被锁定为只读；取消该环境变量才能在此编辑。固定开关仅在启用工具搜索时生效（服务器设置选项卡或应用（插件）配置页）。",
     "actions.restart_addon": "重启应用（插件）",
@@ -33,7 +33,7 @@
     "tools.read_only.help": "关闭所有写入工具，并阻止任何工具进行写入或破坏性调用。读写混合工具（备份、应用（插件）、能源偏好、语音流水线，以及启用时的代码模式）仍可用，但其写入操作被阻止。",
     "tools.read_only.unknown": "无法读取服务器设置。只读模式状态未知；此视图可能无法反映服务器实际执行的策略。",
     "tools.search": "搜索工具…",
-    "server.auto_save_notice": "此选项卡上的设置会自动保存。更改仅在重启应用（插件）（在服务端生效）并在你的 AI 客户端中重新连接或刷新 MCP 服务器（重新加载工具列表）后才会生效，例如在 claude.ai 上刷新工具列表、在 ChatGPT 中重新添加或刷新连接器，或关闭并重新打开 Claude Desktop。",
+    "server.auto_save_notice": "此选项卡上的设置会自动保存。更改仅在重启应用（插件）（在服务端生效）并在你的 AI 客户端中重新连接或刷新 MCP 服务器（重新加载工具列表）后才会生效，例如在 claude.ai 上刷新工具列表、在 ChatGPT 中重新添加或刷新连接器，或关闭并重新打开 Claude Desktop。ChatGPT 有时在删除并重新添加连接器后仍会继续使用缓存的工具列表——如果工具仍然缺失，请删除该连接器并用一个不同的名称重新创建。",
     "server.sections.search": "搜索与匹配",
     "server.sections.operations": "操作",
     "server.sections.tool_surface": "工具面",

{ha_mcp_dev-7.14.2.dev2089 → ha_mcp_dev-7.14.2.dev2093}/src/ha_mcp/tools/config_entry_flow.py

@@ -11,6 +11,7 @@ for the 15 helper types listed in FLOW_HELPER_TYPES.
 """
 
 import asyncio
+import copy
 import logging
 from collections.abc import Iterator
 from enum import StrEnum
@@ -78,6 +79,7 @@ _RECONFIGURE_SUCCESS_REASONS = frozenset(
         "reconfigure_successful",
     }
 )
+_MISSING_DEFAULT = object()
 
 
 class _FlowType(StrEnum):
@@ -172,6 +174,47 @@ def _record_ignored_section_keys(
     )
 
 
+def _field_default_value(field: dict[str, Any]) -> Any:
+    """Return a serialized schema field's default/suggested value, if present."""
+    description = field.get("description")
+    if isinstance(description, dict) and description.get("suggested_value") is not None:
+        return copy.deepcopy(description["suggested_value"])
+    if field.get("suggested_value") is not None:
+        return copy.deepcopy(field["suggested_value"])
+    if "default" in field:
+        return copy.deepcopy(field["default"])
+    return _MISSING_DEFAULT
+
+
+def _schema_default_values(data_schema: list[Any]) -> dict[str, Any]:
+    """Build default form data from serialized schema suggestions/defaults."""
+    defaults: dict[str, Any] = {}
+    for field in data_schema:
+        if not isinstance(field, dict):
+            continue
+        name = field.get("name")
+        nested_schema = field.get("schema")
+        if not isinstance(name, str):
+            continue
+        if isinstance(nested_schema, list):
+            nested_defaults = _schema_default_values(nested_schema)
+            if nested_defaults:
+                defaults[name] = nested_defaults
+            continue
+        default = _field_default_value(field)
+        if default is not _MISSING_DEFAULT:
+            defaults[name] = default
+    return defaults
+
+
+def _required_section_defaults(field: dict[str, Any]) -> dict[str, Any]:
+    """Return default data for a required section, otherwise an empty dict."""
+    nested_schema = field.get("schema")
+    if not field.get("required") or not isinstance(nested_schema, list):
+        return {}
+    return _schema_default_values(nested_schema)
+
+
 def _ignored_keys_warnings(
     ignored_config_keys: set[str], remaining_config: dict[str, Any]
 ) -> list[str]:
@@ -194,10 +237,89 @@ def _ignored_keys_warnings(
     return warnings
 
 
+def _consume_section_schema(
+    field: dict[str, Any],
+    explicit_section: dict[str, Any] | None,
+    remaining_config: dict[str, Any],
+    ignored_config_keys: set[str] | None,
+    consumed_config_keys: set[str] | None,
+    path_prefix: str,
+) -> dict[str, Any]:
+    """Consume config values for a nested flow section."""
+    nested_schema = field.get("schema")
+    if not isinstance(nested_schema, list):
+        return {}
+
+    name = field.get("name")
+    section_path = _section_path(path_prefix, name)
+    nested_data = _required_section_defaults(field)
+
+    if explicit_section is not None:
+        explicit_remaining = dict(explicit_section)
+        nested_data.update(
+            _consume_form_schema(
+                nested_schema,
+                explicit_remaining,
+                ignored_config_keys,
+                consumed_config_keys,
+                section_path,
+            )
+        )
+        _record_ignored_section_keys(
+            ignored_config_keys,
+            explicit_remaining,
+            section_path,
+        )
+
+    nested_data.update(
+        _consume_form_schema(
+            nested_schema,
+            remaining_config,
+            ignored_config_keys,
+            consumed_config_keys,
+            section_path,
+        )
+    )
+    return nested_data
+
+
+def _mark_consumed(
+    consumed_config_keys: set[str] | None,
+    path_prefix: str,
+    name: str,
+) -> None:
+    """Record that a caller-supplied form key, not an injected default, was used."""
+    if consumed_config_keys is not None:
+        consumed_config_keys.add(_section_path(path_prefix, name))
+
+
+def _auto_confirm_form_payload(current_step: dict[str, Any]) -> dict[str, Any] | None:
+    """Return payload for HA preview/confirmation-only forms we can safely advance."""
+    if "preview" not in current_step:
+        return None
+    data_schema = current_step.get("data_schema")
+    if not isinstance(data_schema, list) or len(data_schema) != 1:
+        return None
+    field = data_schema[0]
+    if not isinstance(field, dict) or not field.get("required"):
+        return None
+    name = field.get("name")
+    if not isinstance(name, str) or name in _MENU_SELECTION_KEYS:
+        return None
+    default = _field_default_value(field)
+    if default is not False:
+        return None
+    selector = field.get("selector")
+    if isinstance(selector, dict) and selector and "boolean" not in selector:
+        return None
+    return {name: True}
+
+
 def _consume_form_schema(
     data_schema: list[Any],
     remaining_config: dict[str, Any],
     ignored_config_keys: set[str] | None = None,
+    consumed_config_keys: set[str] | None = None,
     path_prefix: str = "",
 ) -> dict[str, Any]:
     """Consume matching config values and shape nested flow sections.
@@ -208,7 +330,6 @@ def _consume_form_schema(
     ``ignored_config_keys`` with their dotted section path.
     """
     form_data: dict[str, Any] = {}
-    missing = object()
 
     for field in data_schema:
         if not isinstance(field, dict):
@@ -217,47 +338,27 @@ def _consume_form_schema(
         name = field.get("name")
         nested_schema = field.get("schema")
         if isinstance(nested_schema, list):
-            section_path = _section_path(path_prefix, name)
-            explicit_section = (
-                remaining_config.pop(name, missing)
-                if isinstance(name, str)
-                else missing
-            )
-            if explicit_section is not missing and not isinstance(
-                explicit_section, dict
-            ):
-                if isinstance(name, str):
-                    form_data[name] = explicit_section
-                continue
-
-            nested_data: dict[str, Any] = {}
-            if isinstance(explicit_section, dict):
-                explicit_remaining = dict(explicit_section)
-                nested_data.update(
-                    _consume_form_schema(
-                        nested_schema,
-                        explicit_remaining,
-                        ignored_config_keys,
-                        section_path,
-                    )
-                )
-                _record_ignored_section_keys(
-                    ignored_config_keys,
-                    explicit_remaining,
-                    section_path,
-                )
-            nested_data.update(
-                _consume_form_schema(
-                    nested_schema,
-                    remaining_config,
-                    ignored_config_keys,
-                    section_path,
-                )
+            section_name = name if isinstance(name, str) else None
+            explicit_section = None
+            if section_name is not None and section_name in remaining_config:
+                explicit_value = remaining_config.pop(section_name)
+                if not isinstance(explicit_value, dict):
+                    form_data[section_name] = explicit_value
+                    _mark_consumed(consumed_config_keys, path_prefix, section_name)
+                    continue
+                explicit_section = explicit_value
+
+            nested_data = _consume_section_schema(
+                field,
+                explicit_section,
+                remaining_config,
+                ignored_config_keys,
+                consumed_config_keys,
+                path_prefix,
             )
-
             if nested_data:
-                if isinstance(name, str):
-                    form_data[name] = nested_data
+                if section_name is not None:
+                    form_data[section_name] = nested_data
                 else:
                     form_data.update(nested_data)
             continue
@@ -268,6 +369,7 @@ def _consume_form_schema(
             and name in remaining_config
         ):
             form_data[name] = remaining_config.pop(name)
+            _mark_consumed(consumed_config_keys, path_prefix, name)
 
     return form_data
 
@@ -296,6 +398,7 @@ def _handle_form_step(
     current_step: dict[str, Any],
     remaining_config: dict[str, Any],
     ignored_config_keys: set[str] | None = None,
+    consumed_config_keys: set[str] | None = None,
 ) -> dict[str, Any]:
     """Validate a form step and return form data to submit.
 
@@ -337,9 +440,10 @@ def _handle_form_step(
             if key in _MENU_SELECTION_KEYS:
                 continue
             form_data[key] = remaining_config.pop(key)
+            _mark_consumed(consumed_config_keys, "", key)
     else:
         form_data = _consume_form_schema(
-            data_schema, remaining_config, ignored_config_keys
+            data_schema, remaining_config, ignored_config_keys, consumed_config_keys
         )
 
     return form_data
@@ -783,13 +887,17 @@ async def _handle_flow_steps(
             # for subsequent steps (HA can present multi-step forms, e.g.
             # statistics: user step then pick-characteristic step).
             saw_form_step = True
-            form_data = _handle_form_step(
-                flow_id,
-                current_step,
-                remaining_config,
-                ignored_config_keys,
-            )
-            if form_data:
+            consumed_form_keys: set[str] = set()
+            form_data = _auto_confirm_form_payload(current_step)
+            if form_data is None:
+                form_data = _handle_form_step(
+                    flow_id,
+                    current_step,
+                    remaining_config,
+                    ignored_config_keys,
+                    consumed_form_keys,
+                )
+            if consumed_form_keys:
                 any_form_key_consumed = True
             logger.debug(
                 f"Flow step {step_num}: form submit "

{ha_mcp_dev-7.14.2.dev2089 → ha_mcp_dev-7.14.2.dev2093/src/ha_mcp_dev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.14.2.dev2089
+Version: 7.14.2.dev2093
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT
@@ -395,7 +395,7 @@ The proxy split lets MCP clients apply different permission policies per categor
 
 Leave it off when using Claude Sonnet/Opus or any client with deferred tool loading; the full catalog has no idle cost there and direct calls skip the search step. If you choose to use our toolsearch then you should disable the native Claude Opus/Sonnet toolsearch, which is called deferred tools in the settings.
 
-> 🔄 **Refresh your client's tool list after changing this (or any) setting.** Toggling `ENABLE_TOOL_SEARCH` (or changing pinned/disabled tools, Read Only Mode, etc.) changes the tools the server exposes, but your AI client keeps serving its **cached** tool list until it re-fetches. Restarting the add-on or Home Assistant does **not** refresh the client — reconnect or refresh the MCP server in your client (e.g. re-add/refresh the connector in ChatGPT, or close and reopen Claude Desktop). If you skip this, tools shown as available will return `Unknown tool` when called.
+> 🔄 **Refresh your client's tool list after changing this (or any) setting.** Toggling `ENABLE_TOOL_SEARCH` (or changing pinned/disabled tools, Read Only Mode, etc.) changes the tools the server exposes, but your AI client keeps serving its **cached** tool list until it re-fetches. Restarting the add-on or Home Assistant does **not** refresh the client — reconnect or refresh the MCP server in your client (e.g. re-add/refresh the connector in ChatGPT, or close and reopen Claude Desktop). If you skip this, newly enabled tools won't appear in the client at all, and tools the server no longer exposes still show as available but return `Unknown tool` when called. ChatGPT sometimes keeps serving the stale list even after the connector is removed and re-added under the same name — if tools are still missing after re-adding, delete the connector and create a new one with a **different name**.
 
 For the HA add-on, the same option is documented in [`homeassistant-addon/DOCS.md`](homeassistant-addon/DOCS.md#enable_tool_search) along with the in-add-on settings UI for fine-grained tool enable/disable/pin.