ha-mcp-dev 9.0.0.dev3204__tar.gz → 9.0.0.dev3208__tar.gz

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 9.0.0.dev3204
+Version: 9.0.0.dev3208
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Keywords: mcp,home-assistant,ai,automation,smart-home
 Author: Julien

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.0.0.dev3204"
+version = "9.0.0.dev3208"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.0.0.dev3204"
+version = "9.0.0.dev3208"
 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-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/client/websocket_client.py

@@ -282,12 +282,12 @@ class WebSocketConnectionState:
                 future.set_exception(HomeAssistantConnectionError(message))
         self._event_responses.clear()
 
-        # Drop any subscription queues — readers wake on the close signal
-        # we push, then a ``QueueShutDown`` (3.13) tells them the source
-        # is gone. Using ``shutdown`` rather than just clearing the dict
-        # so blocked ``queue.get()`` awaiters unblock instead of hanging.
+        # Drop any subscription queues. ``shutdown`` rather than just clearing
+        # the dict, so blocked ``queue.get()`` awaiters unblock instead of
+        # hanging; not ``immediate``, so a reader still gets the events that
+        # arrived before the close, then ``QueueShutDown`` (3.13).
         for queue in self._subscription_queues.values():
-            queue.shutdown(immediate=True)
+            queue.shutdown()
         self._subscription_queues.clear()
         # Subscriptions die with the socket, and ids restart on the next one.
         self._abandoned_subscriptions.clear()

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/config_meta.py

@@ -50,14 +50,13 @@ class AppOption:
     ``start.py`` exports the option to the setting's env var. An option that
     only some flavors declare is exported only when ``options.json`` has the
     key: an exported value marks the setting as app-managed in the web UI,
-    and Supervisor rejects a save of a key the flavor does not declare.
+    and Supervisor drops a key the flavor does not declare (with only a log
+    warning), so a save of it would silently not persist.
     """
 
     flavors: tuple[Literal["stable", "dev"], ...] = ("stable", "dev")
     # The dev flavor's default when it differs from the field default.
     dev_default: bool | None = None
-    # Supervisor requires the option; every other option is optional ("?").
-    required: bool = False
 
 
 @dataclass(frozen=True)

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/config_overrides.py

@@ -484,10 +484,10 @@ def _apply_advanced_overrides(settings: "Settings") -> None:
     registry) are NEVER applied — chicken-and-egg safeguard for
     connection settings.
 
-    Addon-mode behavior: two advanced fields are in addon ``config.yaml``
-    schemas — ``backup_hint`` and ``verify_ssl`` (both stable and dev).
-    For those, ``start.py`` exports the env var on every boot and the
-    env-var-wins check below correctly skips them. All other advanced
+    Addon-mode behavior: the advanced fields that are also app options
+    (``ADDON_SYNCED_ADVANCED_FIELDS``) are in the addon ``config.yaml``
+    schemas. For those, ``start.py`` exports the env var on every boot and the
+    env-var-wins check in ``_apply_one_advanced_override`` skips them. All other advanced
     fields (code_mode_* sub-numerics, mcp_server_*, log_level, debug,
     enabled_tool_modules, fuzzy_threshold, etc.) are NOT in any addon
     schema; the override file is the authoritative source and applies

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/config_settings.py

@@ -244,17 +244,6 @@ class Settings(BaseSettings):
         ),
     ] = Field(0, alias="HA_TOOL_CONCURRENCY")
 
-    # Backup tool configuration. The app requires this option.
-    backup_hint: Annotated[
-        str,
-        Setting(
-            surface="advanced",
-            section="operations",
-            app=AppOption(required=True),
-            choices=("strong", "normal", "weak", "auto"),
-        ),
-    ] = Field("normal", alias="BACKUP_HINT")
-
     # WebSocket configuration (essential for async operations)
     enable_websocket: Annotated[
         bool,
@@ -530,7 +519,7 @@ class Settings(BaseSettings):
     # generic Server Settings feature list, while /api/settings/features
     # still serves and persists it for the Policies-tab toggle. It is an app
     # option because that toggle routes its save through Supervisor in
-    # add-on mode, which rejects any option the schema does not declare.
+    # add-on mode, which drops any option the schema does not declare.
     enable_security_policy_tool: Annotated[
         bool, Setting(surface="feature", app=_ALL_FLAVORS)
     ] = Field(False, alias="ENABLE_SECURITY_POLICY_TOOL")
@@ -754,7 +743,7 @@ class Settings(BaseSettings):
     # snapshots before deleting old ones, but it cannot forge a backup's
     # HA-stamped creation date. 0 disables the age floor (still gated by
     # enable_snapshot_delete + the newest-snapshot / automatic-backup
-    # guards enforced in tools/backup.py).
+    # guards enforced in tools/backup_snapshot.py).
     snapshot_delete_min_age_days: Annotated[
         int, Setting(surface="backup", app=_ALL_FLAVORS, range=(0, 365))
     ] = Field(7, alias="SNAPSHOT_DELETE_MIN_AGE_DAYS")
@@ -886,12 +875,6 @@ class Settings(BaseSettings):
         """Accept a log level in any case."""
         return _one_of(cls, "log_level", v.upper())
 
-    @field_validator("backup_hint")
-    @classmethod
-    def validate_backup_hint(cls, v: str) -> str:
-        """Accept a backup hint in any case."""
-        return _one_of(cls, "backup_hint", v.lower())
-
     model_config = SettingsConfigDict(
         # Absolute, and the same file load_dotenv already resolved above. A
         # relative ".env" here would be a second, independent read that

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/server.py

@@ -396,50 +396,6 @@ class HomeAssistantSmartMCPServer:
     # unnecessarily trim context for other clients.
     _SEARCH_DESCRIPTION_OVERRIDES: ClassVar[dict[str, str]] = {}
 
-    @staticmethod
-    def _lite_docstring_tokens() -> dict[str, str]:
-        """Operator-tuned values interpolated into the lite descriptions.
-
-        ``_LITE_DOCSTRINGS`` is a static ``ClassVar``, but not every full
-        description it replaces is static: ``ha_manage_backup``'s is an
-        f-string built in ``register_backup_tools()`` that interpolates
-        ``_get_backup_hint_text()`` from ``BACKUP_HINT``
-        (strong/normal/weak). Hard-coding one wording into the lite text
-        would make that setting a silent no-op whenever lite mode is on —
-        the add-on UI would confirm a Backup-hint change that changed
-        nothing. So the lite values carry ``{token}`` placeholders and are
-        resolved here, reading the same env var at the same point in
-        startup the full description does.
-        """
-        # Local import: same lazy-seam pattern as backup_manager's
-        # _normalize_config_for_roundtrip import. It does NOT keep the tools
-        # package off the module-load path — server.py already imports
-        # .tools.helpers at module scope — what it avoids is pulling in
-        # tools.backup, which is the actual reason to keep it local.
-        from .tools.backup import _get_backup_hint_text
-
-        return {"backup_hint_text": _get_backup_hint_text()}
-
-    @classmethod
-    def _resolve_lite_docstrings(cls) -> dict[str, str]:
-        """Return ``_LITE_DOCSTRINGS`` with its placeholders filled in.
-
-        Uses ``str.replace`` rather than ``str.format`` so the descriptions
-        stay free to contain literal braces (Jinja examples, JSON) without
-        a stray ``{`` turning into a ``KeyError`` at startup. An unknown
-        placeholder is left verbatim rather than raising —
-        ``test_every_placeholder_in_the_map_is_resolvable`` is what catches a
-        typo'd token, at test time instead of in a user's tool catalog.
-        """
-        tokens = cls._lite_docstring_tokens()
-        resolved: dict[str, str] = {}
-        for name, lite in cls._LITE_DOCSTRINGS.items():
-            filled = lite
-            for token, value in tokens.items():
-                filled = filled.replace("{" + token + "}", value)
-            resolved[name] = filled
-        return resolved
-
     def _apply_lite_docstrings(self) -> None:
         """Swap heavy tool descriptions for shorter variants if enabled.
 
@@ -450,10 +406,6 @@ class HomeAssistantSmartMCPServer:
         ``ha_get_skill_guide``. Tools not in the
         mapping pass through unchanged.
 
-        Descriptions are resolved through ``_resolve_lite_docstrings`` so
-        operator-tuned text (``BACKUP_HINT``) survives the swap instead of
-        being pinned to whatever wording the static map happened to carry.
-
         Emits a startup WARNING when enabled so non-addon users (Docker,
         uvx, pip) see the trade-off in their logs — the addon UI surfaces
         the same warning via the toggle description. A second WARNING is
@@ -488,7 +440,7 @@ class HomeAssistantSmartMCPServer:
 
         try:
             self.mcp.add_transform(
-                LiteDocstringsTransform(replacements=self._resolve_lite_docstrings())
+                LiteDocstringsTransform(replacements=self._LITE_DOCSTRINGS)
             )
         except Exception:
             logger.exception("Failed to apply LiteDocstringsTransform")

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/server_tool_text.py

@@ -388,17 +388,14 @@ LITE_DOCSTRINGS: dict[str, str] = {
         "entity_id over device_id, impact analysis before renaming — see "
         "ha_get_skill_guide."
     ),
-    # ha_manage_backup: the full description is 4571 dedented chars at
-    # BACKUP_HINT=normal (4672 strong / 4598 weak) and the lite value is
-    # a little over a quarter of that. No exact pair is quoted here on
-    # purpose — three successive edits left a stale figure in this
-    # comment, so the ratio is pinned by
-    # test_backup_lite_description_stays_substantially_smaller instead,
-    # which measures both sides at test time.
+    # ha_manage_backup: the lite value is a fraction of the full
+    # description. test_backup_lite_description_stays_substantially_smaller
+    # bounds it (under 45% of the full text, over 900 chars) and measures
+    # both sides at test time, so no figure is quoted here.
     #
     # It was the largest full description in the GATEWAY catalog this was
-    # measured against, not in the repo: ha_get_system_health (5811) is
-    # larger and unmapped.
+    # measured against, not in the repo: ha_get_system_health is larger
+    # and unmapped.
     # The reduction is smaller than pure compression would give because
     # the safety content below is kept inline. The routing matrix STAYS —
     # the `action` parameter's own Field description says "Valid (scope,
@@ -418,19 +415,25 @@ LITE_DOCSTRINGS: dict[str, str] = {
     # destructiveHint is set on this tool, so the lite text keeps every
     # irreversibility marker inline rather than deferring it: the
     # restart, the confirm, the human-only enable_snapshot_delete, and
-    # each individual delete guard. It also keeps the two diagnostics
-    # that have no fallback anywhere else — the enable_auto_backup
-    # empty-list ambiguity, and the {backup_hint_text} timing sentence
-    # (resolved per-instance; see _lite_docstring_tokens).
+    # each individual delete guard. It also keeps the diagnostics that
+    # have no fallback anywhere else: a slow `create` is not a hang
+    # (retrying starts a second backup), and the enable_auto_backup
+    # empty-list ambiguity.
     "ha_manage_backup": (
         "Manage Home Assistant backups: full HA snapshots "
         "(`scope='snapshot'`) and per-entity auto-backups of agent edits "
         "(`scope='edits'`). Pick the scope first — the wrong one routes "
         "through the wrong code path.\n\n"
-        "`scope='snapshot'` actions: `create` (slow on a large "
+        "`scope='snapshot'` actions: `create` (a full backup with Home "
+        "Assistant's automatic-backup settings, counted by their "
+        "retention, or on the default location without automatic-backup "
+        "locations, holding the apps those settings select; any "
+        "`include_*` makes a custom backup of just those "
+        "parts instead; slow on a large "
         "instance — progress heartbeats are sent while waiting, so a "
         "long wait is not a hang; retrying starts a SECOND backup), "
-        "`list`, `restore` (**restarts HA**), `delete` (needs "
+        "`list`, `restore` (**restarts HA**; `safety_backup=True`, off "
+        "by default, first backs up what the restore replaces), `delete` (needs "
         "`confirm=True`; disabled until a human sets "
         "`enable_snapshot_delete` — an agent cannot enable it. Even then "
         "a delete is refused for scheduled/automatic backups, for "
@@ -439,7 +442,7 @@ LITE_DOCSTRINGS: dict[str, str] = {
         "remaining).\n\n"
         "`scope='edits'` actions: `create` (needs `domain` + "
         "`entity_id`), `list`, `view`, `diff`, `restore` (takes a fresh "
-        "safety snapshot first; no HA restart), `delete`. Automatic "
+        "per-entity backup first; no HA restart), `delete`. Automatic "
         "capture on write is gated by `enable_auto_backup`, so an empty "
         '`list` means "nothing saved" OR "the toggle is off" — check it '
         "before concluding there is nothing to restore. Either way "
@@ -447,8 +450,8 @@ LITE_DOCSTRINGS: dict[str, str] = {
         "the request is explicit.\n\n"
         "Use `edits` to undo a recent agent edit to an "
         "automation/script/scene/dashboard/helper; use `snapshot` for "
-        "system-wide recovery and before irreversible operations. "
-        "{backup_hint_text}\n\n"
+        "system-wide recovery. A snapshot backup is the user's call: ask "
+        "before making one, and make it only when they say so.\n\n"
         "For which recovery path fits which failure, what an archive "
         "actually contains, and the encryption key a restore needs, see "
         "ha_get_skill_guide (`references/backups.md`)."

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/_handlers_advanced.py

@@ -3,9 +3,8 @@
 Factory returning the ``get_advanced_settings`` / ``save_advanced_settings``
 handlers over the ``ADVANCED_SETTINGS_FIELDS`` registry. Most advanced
 fields write to the shared ``feature_flags.json`` override file;
-``ADDON_SYNCED_ADVANCED_FIELDS`` (``backup_hint``, ``ha_tool_concurrency``,
-``verify_ssl``) route
-through the Supervisor add-on options in add-on mode instead.
+``ADDON_SYNCED_ADVANCED_FIELDS`` (the advanced fields that are also app
+options) route through the Supervisor add-on options in add-on mode instead.
 
 Handlers are module-level (own C901 budget); ``build_advanced_handlers``
 binds ``server`` into request-only wrappers.
@@ -136,8 +135,8 @@ async def _get_advanced_settings(
     Mirrors ``_get_feature_flags`` / ``_get_backup_config`` but for the
     ``ADVANCED_SETTINGS_FIELDS`` registry. Most advanced fields write to
     ``feature_flags.json`` via the shared override file in either deployment
-    mode. ``ADDON_SYNCED_ADVANCED_FIELDS`` (``backup_hint``,
-    ``ha_tool_concurrency``, ``verify_ssl``) are an exception: in addon mode
+    mode. ``ADDON_SYNCED_ADVANCED_FIELDS`` (the advanced fields that are
+    also app options) are an exception: in addon mode
     they have ``origin="addon"`` (editable) and saves route through Supervisor
     so the add-on Configuration tab and the web UI share state.
     """
@@ -332,7 +331,7 @@ def _validate_one_advanced_field(
                 status_code=409,
             ),
         )
-    # Addon-synced fields (backup_hint, ha_tool_concurrency, verify_ssl) are editable in
+    # Addon-synced fields (``ADDON_SYNCED_ADVANCED_FIELDS``) are editable in
     # addon mode even though their env vars are set — start.py rewrites them
     # from /data/options.json on every boot, so route the write through
     # Supervisor instead of the override file.
@@ -404,8 +403,8 @@ async def _save_advanced_addon(
                     f"into separate POSTs ({sorted(file_only)})."
                 ),
                 suggestions=[
-                    "Submit addon-synced fields (e.g. backup_hint, "
-                    "verify_ssl) and override-file fields in separate "
+                    "Submit addon-synced fields (e.g. verify_ssl, "
+                    "ha_tool_concurrency) and override-file fields in separate "
                     "save requests.",
                 ],
             ),
@@ -530,8 +529,8 @@ async def _save_advanced_settings(
 ) -> JSONResponse:
     """Persist UI-edited advanced settings.
 
-    Addon-synced fields (``backup_hint``, ``ha_tool_concurrency``,
-    ``verify_ssl``) in add-on mode route through Supervisor; everything else
+    Addon-synced fields (``ADDON_SYNCED_ADVANCED_FIELDS``) in add-on mode
+    route through Supervisor; everything else
     atomically merges into the shared ``feature_flags.json`` override file.
     Either sink responds with ``restart_required=True`` (most advanced fields
     gate one-time startup paths).

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/_handlers_backups.py

@@ -476,7 +476,7 @@ async def _save_backup_config_addon(
     """Add-on-mode branch of ``_save_backup_config``: merge ``clean`` into the
     Supervisor add-on options (full-replacement) and return.
 
-    ``start.py`` re-derives env vars from ``config.yaml`` on the next add-on
+    ``start.py`` re-derives env vars from ``/data/options.json`` on the next add-on
     boot, but the actual restart is fired by the user's global Restart Add-on
     button — not here — so ``restart_required=True`` and no auto-restart.
     """
@@ -489,12 +489,6 @@ async def _save_backup_config_addon(
             code=ErrorCode.INTERNAL_ERROR,
             status=500,
         )
-    # Merge ``clean`` into the *full* current options before posting.
-    # Supervisor validates against the addon schema and rejects any body
-    # missing a required key (notably ``backup_hint`` on the production /
-    # dev manifests). A previous version shipped just the auto-backup
-    # fields, producing ``addon_configuration_invalid_error: Missing option
-    # 'backup_hint' in root`` from supervisor and a confusing 400 in the UI.
     ok, sup_err = await _supervisor._supervisor_merge_and_post_options(
         server.settings.verify_ssl, clean
     )

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/_supervisor.py

@@ -4,9 +4,9 @@ Groups the two Supervisor concerns the settings handlers depend on:
 
 - **Options merge/post** (``_supervisor_fetch_current_options`` /
   ``_supervisor_merge_and_post_options``) — Supervisor's
-  ``/addons/self/options`` POST is a *full* replacement validated against
-  the addon schema, so a partial edit must be merged into the current
-  options before posting.
+  ``/addons/self/options`` POST replaces the stored options in full (keys
+  left out fall back to their defaults), so a partial edit must be merged
+  into the current options before posting.
 - **Self-restart** (``_schedule_supervisor_self_restart``) — a
   fire-and-forget ``/addons/self/restart`` POST scheduled after the
   response has flushed, so the browser isn't served a 5xx by the ingress
@@ -74,9 +74,9 @@ async def _supervisor_fetch_current_options(
 ) -> tuple[dict[str, Any], _SupervisorOptionsError | None]:
     """GET ``/addons/self/info`` and return the current options dict.
 
-    Supervisor's ``/addons/self/options`` POST is a *full* replacement
-    validated against the addon schema — every required key must be
-    present in the body. We can't ship a partial PATCH of just the
+    Supervisor's ``/addons/self/options`` POST replaces the stored options
+    in full: any key left out falls back to its ``config.yaml`` default.
+    We can't ship a partial PATCH of just the
     fields the user changed, so callers must merge their changes into
     the full current options before posting. Mirrors the pattern in
     ``homeassistant-addon/start.py::maybe_persist_secret_path`` which
@@ -146,8 +146,7 @@ async def _supervisor_merge_and_post_options(
     Necessary because supervisor's POST is full-replacement (see
     :func:`_supervisor_fetch_current_options`). Without this merge, a
     POST that only includes a handful of fields the user edited
-    drops every other key (including required ones like ``backup_hint``)
-    and supervisor rejects with a 400 ``addon_configuration_invalid_error``.
+    drops every other key, resetting those options to their defaults.
 
     Returns ``(success, error)`` where ``error`` is a
     :class:`_SupervisorOptionsError`. Transport failures (token missing,

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/az.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Obyekt sayı və vaxt aralığı üzrə ehtiyatlı limitləri aşan qeydiyyatçı sorğularını rədd edir. Standart olaraq deaktivdir.",
     "advanced.ha_tool_concurrency.label": "Home Assistant alətlərinin paralel icrası",
     "advanced.ha_tool_concurrency.help": "Bütün sessiyalar üzrə xarici Home Assistant alət çağırışlarında əlavə məhdudiyyət. Daxili REST, WebSocket və hər alət üzrə paylanma eynizmətliliyi (concurrency) dəyişməz qalır. 0 məhdudiyyətsiz davranışı qoruyur. Tutum üçün gözləyən çağırış 60 saniyədən sonra uğursuz olur.",
-    "advanced.backup_hint.label": "Ehtiyat nüsxə ipucu səviyyəsi",
-    "advanced.backup_hint.help": "Riskli dəyişikliklərdən əvvəl süni intellekt köməkçilərinə tam Home Assistant ehtiyat nüsxəsini təklif etməyin nə qədər güclü şəkildə bildirildiyi. O, yalnız bu ipucunu dəyişdirir; avtomatik redaktə ehtiyat nüsxələrinin öz parametrləri var.",
-    "advanced.backup_hint.choices.strong": "Güclü",
-    "advanced.backup_hint.choices.normal": "Normal",
-    "advanced.backup_hint.choices.weak": "Zəif",
-    "advanced.backup_hint.choices.auto": "Avtomatik",
     "advanced.dashboard_screenshot_engine_url.label": "İdarə panelinin ekran görüntüsü mühərrikinin URL-i",
     "advanced.dashboard_screenshot_engine_url.help": "Ekran görüntüsü mühərrikinin əsas URL-i. Supervisor vasitəsilə avtomatik aşkarlama üçün boş saxlayın. Dərhal tətbiq edilir.",
     "advanced.enable_websocket.label": "WebSocket-i aktivləşdir",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/cs.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Zamítat dotazy do záznamu (recorder), které překračují konzervativní limity entit a časového rozsahu. Ve výchozím nastavení vypnuto.",
     "advanced.ha_tool_concurrency.label": "Souběžnost nástrojů Home Assistant",
     "advanced.ha_tool_concurrency.help": "Volitelný limit pro vnější volání nástrojů Home Assistant napříč všemi relacemi. Vnitřní souběh pro REST, WebSocket a rozbočení pro jednotlivé nástroje zůstává nezměněn. 0 zachovává neomezené chování. Volání čekající na kapacitu selže po 60 sekundách.",
-    "advanced.backup_hint.label": "Úroveň nápovědy zálohování",
-    "advanced.backup_hint.help": "Jak důrazně jsou asistenti AI vyzýváni k doporučení úplné zálohy Home Assistant před rizikovými změnami. Mění pouze tuto nápovědu; automatické zálohy úprav mají své vlastní nastavení.",
-    "advanced.backup_hint.choices.strong": "Silná",
-    "advanced.backup_hint.choices.normal": "Normální",
-    "advanced.backup_hint.choices.weak": "Slabá",
-    "advanced.backup_hint.choices.auto": "Automatická",
     "advanced.dashboard_screenshot_engine_url.label": "URL adresa enginu pro snímky obrazovky panelu",
     "advanced.dashboard_screenshot_engine_url.help": "Základní URL enginu pro snímky obrazovky. Ponechte prázdné pro automatické zjišťování Supervisor. Platí okamžitě.",
     "advanced.enable_websocket.label": "Povolit WebSocket",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/de.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Recorder-Abfragen ablehnen, die konservative Entitäts- und Zeitbereichsbudgets überschreiten. Standardmäßig deaktiviert.",
     "advanced.ha_tool_concurrency.label": "Home-Assistant-Tool-Gleichzeitigkeit",
     "advanced.ha_tool_concurrency.help": "Optionale Begrenzung für äußere Home Assistant-Tool-Aufrufe über alle Sitzungen hinweg. Interne REST-, WebSocket- und tool-spezifische Fan-Out-Gleichzeitigkeit bleibt unverändert. 0 belässt das Verhalten unbegrenzt. Ein Aufruf, der auf Kapazität wartet, schlägt nach 60 Sekunden fehl.",
-    "advanced.backup_hint.label": "Backup-Hinweisstufe",
-    "advanced.backup_hint.help": "Wie nachdrücklich KI-Assistenten angewiesen werden, vor riskanten Änderungen ein vollständiges Home Assistant-Backup vorzuschlagen. Ändert nur diesen Hinweis; automatische Bearbeitungs-Backups haben ihre eigene Einstellung.",
-    "advanced.backup_hint.choices.strong": "Stark",
-    "advanced.backup_hint.choices.normal": "Normal",
-    "advanced.backup_hint.choices.weak": "Schwach",
-    "advanced.backup_hint.choices.auto": "Automatisch",
     "advanced.dashboard_screenshot_engine_url.label": "Dashboard-Screenshot-Engine-URL",
     "advanced.dashboard_screenshot_engine_url.help": "Basis-URL der Screenshot-Engine. Lasse leer für Supervisor-Auto-Discovery. Wirkt sofort.",
     "advanced.enable_websocket.label": "WebSocket aktivieren",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/en.json

@@ -160,7 +160,7 @@
     "features.enable_code_mode.label": "Enable custom tool sandbox (beta)",
     "features.enable_code_mode.help": "Beta feature. Enables the ha_manage_custom_tool tool, which lets AI assistants create, run, save, and delete custom Python code in a secure sandbox when no built-in tool can handle the request. Code runs in an isolated interpreter with no filesystem or arbitrary network access. Sandbox code can hit the HA REST API (api_get/api_post), send WebSocket commands (ws_send), call existing MCP tools (call_tool), or remove a saved tool (delete_saved_tool). Saved tools persist to /data/saved_tools.json by default so they survive app (add-on) restarts, and are visible to any client that can connect. See docs/beta.md for known limitations. Requires restart to take effect. REQUIRES the master \"Enable beta features\" toggle above (and in the web UI) to be on — otherwise this sub-flag is ignored at runtime regardless of its value here.",
     "features.enable_lite_docstrings.label": "Enable lite tool docstrings (beta)",
-    "features.enable_lite_docstrings.help": "Beta feature. Replaces the docstrings on 15 heavy ha-mcp tools (ha_config_get_automation, ha_config_set_automation, ha_config_get_script, ha_config_set_script, ha_config_get_scene, ha_config_set_scene, ha_config_list_helpers, ha_config_set_helper, ha_config_get_dashboard, ha_config_set_dashboard, ha_call_service, ha_config_set_yaml, ha_search, ha_manage_backup, ha_report_issue) with shorter variants that defer schema and example detail to the ha_get_skill_guide tool (or its skill:// resource). One exception: ha_report_issue defers to the instructions field of its own response instead. Tuning the Backup-hint setting still applies in lite mode. WARNING: this reduces idle token usage, but may degrade LLM performance — the trimmed descriptions rely on the LLM actually calling the skill tool or reading the skill resource for detail, which is not guaranteed (some models will skip the extra tool call and end up with less guidance than they had before). Best paired with a client that supports MCP resources or with enable_tool_search. Requires restart to take effect. REQUIRES the master \"Enable beta features\" toggle above (and in the web UI) to be on — otherwise this sub-flag is ignored at runtime regardless of its value here.",
+    "features.enable_lite_docstrings.help": "Beta feature. Replaces the docstrings on 15 heavy ha-mcp tools (ha_config_get_automation, ha_config_set_automation, ha_config_get_script, ha_config_set_script, ha_config_get_scene, ha_config_set_scene, ha_config_list_helpers, ha_config_set_helper, ha_config_get_dashboard, ha_config_set_dashboard, ha_call_service, ha_config_set_yaml, ha_search, ha_manage_backup, ha_report_issue) with shorter variants that defer schema and example detail to the ha_get_skill_guide tool (or its skill:// resource). One exception: ha_report_issue defers to the instructions field of its own response instead. WARNING: this reduces idle token usage, but may degrade LLM performance — the trimmed descriptions rely on the LLM actually calling the skill tool or reading the skill resource for detail, which is not guaranteed (some models will skip the extra tool call and end up with less guidance than they had before). Best paired with a client that supports MCP resources or with enable_tool_search. Requires restart to take effect. REQUIRES the master \"Enable beta features\" toggle above (and in the web UI) to be on — otherwise this sub-flag is ignored at runtime regardless of its value here.",
     "features.enable_dashboard_screenshot.label": "Enable dashboard screenshot mode (beta)",
     "features.enable_dashboard_screenshot.help": "Beta feature — disabled by default. Adds the ha_get_dashboard_screenshot tool plus include_screenshot / return_screenshot options on the dashboard get/set tools, so AI assistants can inspect one or more responsive Lovelace images (e.g. to verify a dashboard they just created). Supports stable named views, mobile/tablet/desktop batches, and PNG/JPEG/WebP/BMP output. Rendering runs in a separate, opt-in engine — balloob's \"Puppet\" App (add-on), headless Chromium — which you install once (add balloob's repository to the App store, then install \"Puppet\") and give a long-lived access token; on Docker/Container deployments you run that engine as a sidecar and set HAMCP_DASHBOARD_SCREENSHOT_ENGINE_URL. Nothing heavy is installed unless you both enable this and install the engine. Requires restart to take effect. REQUIRES the master \"Enable beta features\" toggle above (and in the web UI) to be on — otherwise this sub-flag is ignored at runtime regardless of its value here.",
     "actions.restart_server": "Restart HA-MCP Server",
@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Reject recorder queries that exceed conservative entity and time-range budgets. Disabled by default.",
     "advanced.ha_tool_concurrency.label": "Home Assistant tool concurrency",
     "advanced.ha_tool_concurrency.help": "Optional limit on outer Home Assistant tool calls across all sessions. Internal REST, WebSocket, and per-tool fan-out concurrency is unchanged. 0 keeps unlimited behavior. A call waiting for capacity fails after 60 seconds.",
-    "advanced.backup_hint.label": "Backup hint level",
-    "advanced.backup_hint.help": "How strongly AI assistants are told to suggest a full Home Assistant backup before risky changes. It changes only this hint; automatic edit backups have their own setting.",
-    "advanced.backup_hint.choices.strong": "Strong",
-    "advanced.backup_hint.choices.normal": "Normal",
-    "advanced.backup_hint.choices.weak": "Weak",
-    "advanced.backup_hint.choices.auto": "Automatic",
     "advanced.dashboard_screenshot_engine_url.label": "Dashboard screenshot engine URL",
     "advanced.dashboard_screenshot_engine_url.help": "Base URL of the screenshot engine. Leave blank for Supervisor auto-discovery. Applies immediately.",
     "advanced.enable_websocket.label": "Enable WebSocket",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/eo.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Malakcepti registrilajn kuriojn, kiuj superas konservativajn entajn kaj tempintervalajn buĝetojn. Malŝaltite defaŭlte.",
     "advanced.ha_tool_concurrency.label": "Konkureco de hejmaŭtomatigaj iloj de Home Assistant",
     "advanced.ha_tool_concurrency.help": "Laŭvola limo pri eksteraj Home Assistant ilvokoj tra ĉiuj seancoj. Interna REST, WebSocket, kaj samtempeco de disbranĉigo po ilo estas senŝanĝaj. 0 konservas senliman konduton. Voko atendanta kapaciton malsukcesas post 60 sekundoj.",
-    "advanced.backup_hint.label": "Nivelo de konsilo pri momentfotoj",
-    "advanced.backup_hint.help": "Kiom forte oni diras al AI-asistantoj sugesti plenan momentfoton de Home Assistant antaŭ riskaj ŝanĝoj. Ĝi ŝanĝas nur ĉi tiun konsilon; aŭtomataj redaktaj momentfotoj havas sian propran agordon.",
-    "advanced.backup_hint.choices.strong": "Forta",
-    "advanced.backup_hint.choices.normal": "Normala",
-    "advanced.backup_hint.choices.weak": "Malforta",
-    "advanced.backup_hint.choices.auto": "Aŭtomata",
     "advanced.dashboard_screenshot_engine_url.label": "URL de panelo-ekrankopiga motoro",
     "advanced.dashboard_screenshot_engine_url.help": "Baza URL de la ekrankopiga motoro. Lasu malplena por aŭtomata malkovro de Supervisor. Aplikiĝas tuj.",
     "advanced.enable_websocket.label": "Ebligi WebSocket",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/es.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Rechazar consultas del registrador que superen los límites conservadores de entidades y rangos de tiempo. Desactivado por defecto.",
     "advanced.ha_tool_concurrency.label": "Concurrencia de herramientas de Home Assistant",
     "advanced.ha_tool_concurrency.help": "Límite opcional en las llamadas a herramientas externas de Home Assistant en todas las sesiones. La concurrencia interna de REST, WebSocket y de distribución por herramienta no se modifica. 0 mantiene el comportamiento ilimitado. Una llamada que espera capacidad falla después de 60 segundos.",
-    "advanced.backup_hint.label": "Nivel de sugerencia de copia de seguridad",
-    "advanced.backup_hint.help": "Con qué intensidad se indica a los asistentes de IA que sugieran una copia de seguridad completa de Home Assistant antes de realizar cambios arriesgados. Solo cambia esta sugerencia; las copias de seguridad de edición automática tienen su propia configuración.",
-    "advanced.backup_hint.choices.strong": "Fuerte",
-    "advanced.backup_hint.choices.normal": "Normal",
-    "advanced.backup_hint.choices.weak": "Suave",
-    "advanced.backup_hint.choices.auto": "Automático",
     "advanced.dashboard_screenshot_engine_url.label": "URL del motor de capturas de pantalla de paneles",
     "advanced.dashboard_screenshot_engine_url.help": "URL base del motor de capturas. Déjalo vacío para la detección automática del Supervisor. Se aplica de inmediato.",
     "advanced.enable_websocket.label": "Activar WebSocket",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/fr.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Rejette les requêtes d'historique qui dépassent les budgets prudents d'entités et de plages horaires. Désactivé par défaut.",
     "advanced.ha_tool_concurrency.label": "Concurrence des outils Home Assistant",
     "advanced.ha_tool_concurrency.help": "Limite facultative sur les appels d'outils Home Assistant externes pour toutes les sessions. La concurrence interne pour REST, WebSocket et la répartition par outil reste inchangée. 0 conserve un comportement illimité. Un appel en attente de capacité échoue après 60 secondes.",
-    "advanced.backup_hint.label": "Niveau d'indication de sauvegarde",
-    "advanced.backup_hint.help": "Avec quelle insistance il est demandé aux assistants IA de suggérer une sauvegarde complète de Home Assistant avant des modifications risquées. Cela ne modifie que cette indication ; les sauvegardes automatiques de modification ont leur propre paramètre.",
-    "advanced.backup_hint.choices.strong": "Fort",
-    "advanced.backup_hint.choices.normal": "Normal",
-    "advanced.backup_hint.choices.weak": "Faible",
-    "advanced.backup_hint.choices.auto": "Automatique",
     "advanced.dashboard_screenshot_engine_url.label": "URL du moteur de capture d'écran du tableau de bord",
     "advanced.dashboard_screenshot_engine_url.help": "URL de base du moteur de capture d'écran. Laissez vide pour la découverte automatique par le Supervisor. S'applique immédiatement.",
     "advanced.enable_websocket.label": "Activer WebSocket",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/it.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Rifiuta le query del recorder che superano i limiti conservativi di entità e intervallo di tempo. Disabilitato per impostazione predefinita.",
     "advanced.ha_tool_concurrency.label": "Concorrenza degli strumenti di Home Assistant",
     "advanced.ha_tool_concurrency.help": "Limite opzionale sulle chiamate esterne agli strumenti di Home Assistant in tutte le sessioni. La concorrenza interna di REST, WebSocket e di distribuzione per singolo strumento rimane invariata. 0 mantiene il comportamento illimitato. Una chiamata in attesa di capacità fallisce dopo 60 secondi.",
-    "advanced.backup_hint.label": "Livello di suggerimento per il backup",
-    "advanced.backup_hint.help": "Con quale insistenza gli assistenti IA vengono invitati a suggerire un backup completo di Home Assistant prima di modifiche rischiose. Modifica solo questo suggerimento; i backup di modifica automatici hanno una propria impostazione.",
-    "advanced.backup_hint.choices.strong": "Forte",
-    "advanced.backup_hint.choices.normal": "Normale",
-    "advanced.backup_hint.choices.weak": "Debole",
-    "advanced.backup_hint.choices.auto": "Automatico",
     "advanced.dashboard_screenshot_engine_url.label": "URL del motore per gli screenshot delle dashboard",
     "advanced.dashboard_screenshot_engine_url.help": "URL di base del motore per gli screenshot. Lascia vuoto per il rilevamento automatico tramite Supervisor. Ha effetto immediato.",
     "advanced.enable_websocket.label": "Attiva il WebSocket",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/ko.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "보수적인 엔티티 및 시간 범위 예산을 초과하는 recorder 쿼리를 거부합니다. 기본적으로 비활성화되어 있습니다.",
     "advanced.ha_tool_concurrency.label": "Home Assistant 도구 동시성",
     "advanced.ha_tool_concurrency.help": "모든 세션에 걸친 외부 Home Assistant 도구 호출의 선택적 제한. 내부 REST, WebSocket 및 도구별 팬아웃 동시성은 변경되지 않습니다. 0은 무제한 동작을 유지합니다. 용량을 대기 중인 호출은 60초 후에 실패합니다.",
-    "advanced.backup_hint.label": "백업 힌트 수준",
-    "advanced.backup_hint.help": "위험한 변경 전에 전체 Home Assistant 백업을 제안하도록 AI 어시스턴트에 지시하는 강도입니다. 이 힌트만 변경하며 자동 편집 백업에는 자체 설정이 있습니다.",
-    "advanced.backup_hint.choices.strong": "강하게",
-    "advanced.backup_hint.choices.normal": "보통",
-    "advanced.backup_hint.choices.weak": "약하게",
-    "advanced.backup_hint.choices.auto": "자동",
     "advanced.dashboard_screenshot_engine_url.label": "대시보드 스크린샷 엔진 URL",
     "advanced.dashboard_screenshot_engine_url.help": "스크린샷 엔진의 기본 URL입니다. Supervisor 자동 검색을 쓰려면 비워 두세요. 즉시 적용됩니다.",
     "advanced.enable_websocket.label": "WebSocket 사용",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/nl.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Wijs recorderquery's af die de conservatieve budgetten voor entiteiten en tijdsbereik overschrijden. Standaard uitgeschakeld.",
     "advanced.ha_tool_concurrency.label": "Home Assistant-toolgelijktijdigheid",
     "advanced.ha_tool_concurrency.help": "Optionele limiet voor uiterste Home Assistant-toolaanroepen over alle sessies heen. Interne REST-, WebSocket- en per-tool fan-out-gelijktijdigheid blijft ongewijzigd. 0 behoudt onbeperkt gedrag. Een aanroep die wacht op capaciteit mislukt na 60 seconden.",
-    "advanced.backup_hint.label": "Niveau van back-uptip",
-    "advanced.backup_hint.help": "Hoe sterk AI-assistenten worden aangespoord om een volledige Home Assistant-back-up voor te stellen vóór risicovolle wijzigingen. Dit wijzigt alleen deze tip; automatische bewerkingsback-ups hebben hun eigen instelling.",
-    "advanced.backup_hint.choices.strong": "Sterk",
-    "advanced.backup_hint.choices.normal": "Normaal",
-    "advanced.backup_hint.choices.weak": "Zwak",
-    "advanced.backup_hint.choices.auto": "Automatisch",
     "advanced.dashboard_screenshot_engine_url.label": "Dashboard screenshot engine URL",
     "advanced.dashboard_screenshot_engine_url.help": "Basis-URL van de screenshot engine. Laat leeg voor Supervisor auto-ontdekking. Wordt onmiddellijk toegepast.",
     "advanced.enable_websocket.label": "WebSocket inschakelen",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/pl.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Odrzucaj zapytania rejestratora przekraczające zachowawcze limity encji i zakresu czasu. Domyślnie wyłączone.",
     "advanced.ha_tool_concurrency.label": "Współbieżność narzędzi Home Assistant",
     "advanced.ha_tool_concurrency.help": "Opcjonalny limit zewnętrznych wywołań narzędzi Home Assistant we wszystkich sesjach. Współbieżność wewnętrznych żądań REST, WebSocket oraz rozgałęzień na narzędzie pozostaje bez zmian. Wartość 0 oznacza brak limitu. Wywołanie oczekujące na wolne zasoby zakończy się niepowodzeniem po 60 sekundach.",
-    "advanced.backup_hint.label": "Poziom podpowiedzi kopii zapasowej",
-    "advanced.backup_hint.help": "Jak stanowczo asystenci AI są instruowani, aby sugerować pełną kopię zapasową Home Assistant przed ryzykownymi zmianami. Zmienia to tylko tę podpowiedź; automatyczne kopie zapasowe edycji mają własne ustawienie.",
-    "advanced.backup_hint.choices.strong": "Silny",
-    "advanced.backup_hint.choices.normal": "Normalny",
-    "advanced.backup_hint.choices.weak": "Słaby",
-    "advanced.backup_hint.choices.auto": "Automatyczny",
     "advanced.dashboard_screenshot_engine_url.label": "Adres URL silnika zrzutów ekranu pulpitu nawigacyjnego",
     "advanced.dashboard_screenshot_engine_url.help": "Bazowy adres URL silnika zrzutów ekranu. Pozostaw puste dla automatycznego wykrywania przez Supervisor. Obowiązuje natychmiast.",
     "advanced.enable_websocket.label": "Włącz WebSocket",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/ru.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Отклонять запросы к истории, превышающие консервативные лимиты по объектам и временным диапазонам. Отключено по умолчанию.",
     "advanced.ha_tool_concurrency.label": "Параллелизм инструментов Home Assistant",
     "advanced.ha_tool_concurrency.help": "Необязательное ограничение на внешние вызовы инструментов Home Assistant во всех сеансах. Внутренние REST, WebSocket и параллельность запросов по инструментам остаются без изменений. 0 сохраняет поведение без ограничений. Запрос, ожидающий свободного ресурса, завершается ошибкой через 60 секунд.",
-    "advanced.backup_hint.label": "Уровень подсказок резервного копирования",
-    "advanced.backup_hint.help": "Насколько настойчиво ИИ-ассистентам рекомендуется предлагать создание полной резервной копии Home Assistant перед рискованными изменениями. Изменяет только эту подсказку; автоматические резервные копии редактирования имеют собственный параметр.",
-    "advanced.backup_hint.choices.strong": "Настойчивое",
-    "advanced.backup_hint.choices.normal": "Обычное",
-    "advanced.backup_hint.choices.weak": "Мягкое",
-    "advanced.backup_hint.choices.auto": "Автоматическое",
     "advanced.dashboard_screenshot_engine_url.label": "URL движка снимков панели",
     "advanced.dashboard_screenshot_engine_url.help": "Базовый URL движка. Оставьте пустым для автопоиска через Supervisor. Действует сразу.",
     "advanced.enable_websocket.label": "Включить WebSocket",

{ha_mcp_dev-9.0.0.dev3204 → ha_mcp_dev-9.0.0.dev3208}/src/ha_mcp/settings_ui/locales/sv.json

@@ -474,12 +474,6 @@
     "advanced.enable_history_query_guardrails.help": "Avvisa recorder-frågor som överskrider konservativa budgetar för entiteter och tidsintervall. Inaktiverat som standard.",
     "advanced.ha_tool_concurrency.label": "Samtidighet för Home Assistant-verktyg",
     "advanced.ha_tool_concurrency.help": "Valfri gräns för yttre Home Assistant-verktygsanrop över alla sessioner. Intern REST-, WebSocket- och per-verktyg-samtidighet förblir oförändrad. 0 behåller obegränsat beteende. Ett anrop som väntar på kapacitet misslyckas efter 60 sekunder.",
-    "advanced.backup_hint.label": "Nivå för säkerhetskopieringstips",
-    "advanced.backup_hint.help": "Hur starkt AI-assistenter uppmanas att föreslå en fullständig Home Assistant-säkerhetskopia före riskabla ändringar. Det ändrar bara detta tips; automatiska redigeringssäkerhetskopior har sin egen inställning.",
-    "advanced.backup_hint.choices.strong": "Stark",
-    "advanced.backup_hint.choices.normal": "Normal",
-    "advanced.backup_hint.choices.weak": "Svag",
-    "advanced.backup_hint.choices.auto": "Automatisk",
     "advanced.dashboard_screenshot_engine_url.label": "URL för skärmbildsmotor för instrumentpanel",
     "advanced.dashboard_screenshot_engine_url.help": "Bas-URL för skärmbildsmotorn. Lämna tomt för automatisk upptäckt av Supervisor. Tillämpas omedelbart.",
     "advanced.enable_websocket.label": "Aktivera WebSocket",