ha-mcp-dev 8.2.0.dev2367__tar.gz → 8.3.0.dev2374__tar.gz

{ha_mcp_dev-8.2.0.dev2367/src/ha_mcp_dev.egg-info → ha_mcp_dev-8.3.0.dev2374}/PKG-INFO

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

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.2.0.dev2367"
+version = "8.3.0.dev2374"
 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-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/__init__.py

@@ -20,7 +20,7 @@ from typing import TYPE_CHECKING, Any
 from starlette.requests import Request
 from starlette.responses import HTMLResponse, JSONResponse, Response
 
-from .._version import is_running_in_addon
+from .._version import is_embedded, is_running_in_addon
 from ..transforms import DEFAULT_PINNED_TOOLS
 from ..utils.data_paths import get_data_dir
 from ._handlers_advanced import build_advanced_handlers
@@ -524,11 +524,11 @@ def _ingress_only(handler: _SettingsRoute) -> _SettingsRoute:
 
 
 # Mount prefix the settings UI is served under in long-lived HTTP transports
-# (Docker / standalone ha-mcp-web / OAuth / the add-on's secret-path mount).
-# Recorded by register_settings_routes so ha_get_overview can point users at
-# the settings page in modes that have no stdio sidecar URL file to surface
-# (issue #1458). Stays None in pure stdio mode, where the sidecar writes
-# ~/.ha-mcp/ui.url instead.
+# (Docker / standalone ha-mcp-web). Recorded by register_settings_routes so
+# ha_get_overview can point users at the settings page in modes that have no
+# managed UI entry point or stdio sidecar URL file to surface (issue #1458).
+# Stays None in managed HA deployments and pure stdio mode, where the sidebar /
+# ingress entry point or ~/.ha-mcp/ui.url already provides discovery.
 _http_settings_prefix: str | None = None
 
 
@@ -539,8 +539,8 @@ def get_http_settings_prefix() -> str | None:
     long-lived HTTP server *and* advertising is enabled. ``ha_get_overview``
     reads it to hint at the settings page when there is no stdio sidecar URL to
     hand the user. It is None when the mount is deliberately not advertised
-    (OAuth/OIDC dedicated-secret mode) — use :func:`is_http_settings_mounted`,
-    not this, to tell HTTP from the stdio sidecar.
+    (managed HA or OAuth/OIDC dedicated-secret mode) — use
+    :func:`is_http_settings_mounted`, not this, to tell HTTP from the sidecar.
     """
     return _http_settings_prefix
 
@@ -594,12 +594,18 @@ def register_settings_routes(
             non-add-on mode, the function logs a warning and registers
             nothing rather than expose the routes publicly.
         advertise_prefix: When True (default), record the secret-path mount in
-            ``_http_settings_prefix`` so ``ha_get_overview`` can hint at the
-            settings URL. OAuth/OIDC modes pass False: there the settings UI
-            sits under a *dedicated* secret path that must never be handed to
-            MCP clients (GHSA-mx64-982r-65vg), so the mount happens but the
-            prefix is not recorded.
+            ``_http_settings_prefix`` for unmanaged HTTP deployments so
+            ``ha_get_overview`` can hint at the settings URL. The managed app
+            (add-on) and embedded deployments never record it because Home Assistant
+            supplies their settings entry points. OAuth/OIDC callers pass False
+            because they use a dedicated settings secret.
     """
+    global _http_settings_mounted, _http_settings_prefix
+
+    # Never let a rejected or non-advertised registration inherit another
+    # server's credential-bearing hint.
+    _http_settings_prefix = None
+
     handlers = build_settings_handlers(server)
     secret_prefix = secret_path.rstrip("/") if secret_path else ""
     if secret_prefix and ("{" in secret_prefix or "}" in secret_prefix):
@@ -627,7 +633,6 @@ def register_settings_routes(
     # Past this point at least one HTTP mount happens (add-on root and/or the
     # secret path). Record that so consumers can distinguish HTTP from the stdio
     # sidecar even when the prefix itself is not advertised (advertise_prefix=False).
-    global _http_settings_mounted
     _http_settings_mounted = True
 
     # Every route this function mounts except the add-on-only root mount is defined
@@ -705,10 +710,10 @@ def register_settings_routes(
         # need the same secret to reach the UI as they do for the MCP
         # endpoint.
         _mount(secret_prefix)
-        if advertise_prefix:
+        if advertise_prefix and not is_addon and not is_embedded():
             # Record the mount so ha_get_overview can point users at the
-            # settings page in HTTP transports that have no stdio sidecar URL
-            # file (#1458). Suppressed in OAuth/OIDC modes, where the dedicated
-            # secret path must not leak to MCP clients (GHSA-mx64-982r-65vg).
-            global _http_settings_prefix
+            # settings page in unmanaged HTTP transports that have no stdio
+            # sidecar URL file (#1458). The managed app (add-on) and embedded deployments
+            # already have Home Assistant settings entry points; OAuth/OIDC
+            # callers suppress their dedicated settings secret explicitly.
             _http_settings_prefix = secret_prefix

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/cs.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Bez režimu vynucení (níže) jde o redukci šumu, nikoli o řízení přístupu: skrytá entita je stále vrácena přímým čtením jejího entity_id a stále se objevuje v obsahu automatizací, řídicích panelů a šablon. Nespoléhejte se na samotný filtr jako na bezpečnostní hranici.",
     "visibility.enabled": "Povolit filtr viditelnosti entit",
     "visibility.enforce.title": "Režim vynucení",
-    "visibility.enforce.help": "Rozšiřuje filtr z pročišťování vyhledávání a přehledu na každé čtení nástrojem. Přímé čtení skryté entity vrátí „nenalezeno“ a čtení obsahu (řídicí panel, šablona, automatizace, trasování, protokol nebo soubor), které by odhalilo skrytou entitu, je odmítnuto. Jde o nejlepší snahu o utajení proti náhodnému odhalení, nikoli o zesílenou bezpečnostní hranici.",
-    "visibility.enforce.only_enforced": "Učinit skryté entity nečitelnými napříč všemi nástroji (nejen vyhledáváním)",
+    "visibility.enforce.help": "Rozšiřuje filtr z úklidu vyhledávání a přehledu na každé čtení nástroje kromě ha_report_issue ve výchozím nastavení. Přímé čtení skryté entity vrátí „nenalezeno“ a čtení obsahu, které by ji zobrazil, je odmítnuto. Výjimka pro nástroj hlášení se ovládá níže. Jedná se o snahu o skrytí před náhodným vystavením na základě nejlepších možností, nikoli o zabezpečenou bezpečnostní hranici.",
+    "visibility.enforce.only_enforced": "Udělat skryté entity nečitelnými napříč čteními nástrojů (kromě hlášení problémů ve výchozím nastavení)",
+    "visibility.enforce.report_issue_help": "Dokud je toto vypnuto, ha_report_issue a veškerý jeho diagnostický výstup – včetně protokolů – zůstávají mimo režim vynucení při každém volání, a to i když jsou data o viditelnosti v pořádku nebo nedostupná. Zapněte toto nastavení pro prohledání a odmítnutí tohoto nástroje stejně jako u jiných čtení.",
+    "visibility.enforce.restrict_report_issue": "Použít režim vynucení na ha_report_issue",
     "visibility.categories.title": "Skrýt podle kategorie",
     "visibility.categories.help": "Home Assistant označuje automaticky generované entity jako diagnostické nebo konfigurační.",
     "visibility.categories.legend": "Kategorie entit ke skrytí",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/de.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Ohne den Erzwingungsmodus (unten) ist dies Rauschreduzierung, keine Zugriffskontrolle: Eine versteckte Entität wird weiterhin durch ein direktes Lesen ihrer entity_id zurückgegeben und erscheint weiterhin in Automatisierungs-, Dashboard- und Template-Inhalten. Verlasse dich nicht allein auf den Filter als Sicherheitsgrenze.",
     "visibility.enabled": "Entitäts-Sichtbarkeitsfilter aktivieren",
     "visibility.enforce.title": "Erzwingungsmodus",
-    "visibility.enforce.help": "Erweitert den Filter vom Aufräumen von Suche und Übersicht auf jeden Werkzeug-Lesezugriff. Ein direkter Lesezugriff auf eine versteckte Entität liefert „nicht gefunden“, und ein Inhalts-Lesezugriff (Dashboard, Template, Automatisierung, Trace, Log oder Datei), der eine versteckte Entität offenlegen würde, wird verweigert. Bestmögliche Verschleierung gegen versehentliche Offenlegung, keine gehärtete Sicherheitsgrenze.",
-    "visibility.enforce.only_enforced": "Versteckte Entitäten für alle Werkzeuge unlesbar machen (nicht nur für die Suche)",
+    "visibility.enforce.help": "Erweitert den Filter von der Übersicht und dem Aufräumen der Suche standardmäßig auf jeden Tool-Lesevorgang außer ha_report_issue. Ein direkter Lesevorgang einer ausgeblendeten Entität gibt „nicht gefunden“ zurück, und ein Inhaltslesevorgang, der eine solche anzeigen würde, wird verweigert. Die Ausnahme für das Berichts-Tool wird unten gesteuert. Best-Effort-Verbergen gegen zufällige Exposition, keine gehärtete Sicherheitsgrenze.",
+    "visibility.enforce.only_enforced": "Versteckte Entitäten bei Tool-Lesevorgängen unlesbar machen (standardmäßig außer Fehlerberichten)",
+    "visibility.enforce.report_issue_help": "Solange dies deaktiviert ist, bleiben ha_report_issue und all seine Diagnoseausgaben – einschließlich Protokolle – bei jedem Aufruf außerhalb des Erzwingungsmodus, selbst wenn die Sichtbarkeitsdaten intakt oder nicht verfügbar sind. Aktiviere dies, um dieses Tool wie andere Lesevorgänge zu scannen und zu verweigern.",
+    "visibility.enforce.restrict_report_issue": "Erzwingungsmodus auf ha_report_issue anwenden",
     "visibility.categories.title": "Nach Kategorie verstecken",
     "visibility.categories.help": "Home Assistant markiert automatisch generierte Entitäten als Diagnose oder Konfiguration.",
     "visibility.categories.legend": "Zu versteckende Entitätskategorien",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/eo.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Sen deviga reĝimo (malsupre), ĉi tio estas bruo-redukto, ne alirkontrolo: kaŝita ento estas ankoraŭ redonita per rekta legado de ĝia entity_id kaj ankoraŭ aperas en aŭtomatigo, panelo kaj ŝablona enhavo. Ne fidu nur je la filtrilo kiel sekureca limo.",
     "visibility.enabled": "Ebligi filtrilon de enta videbleco",
     "visibility.enforce.title": "Deviga reĝimo",
-    "visibility.enforce.help": "Etendas la filtrilon de malordiga serĉo kaj superrigardo al ĉiu ilo-legado. Rekta legado de kaŝita ento redonas „ne trovita”, kaj enhavo-legado (panelo, ŝablono, aŭtomatigo, spuro, protokolo aŭ dosiero) kiu malkaŝus kaŝitan enton estas rifuzita. Plejbona-klopodata kaŝado kontraŭ hazarda ekspono, ne fortigita sekureca limo.",
-    "visibility.enforce.only_enforced": "Faru kaŝitajn entojn nelegeblaj tra ĉiuj iloj (ne nur serĉo)",
+    "visibility.enforce.help": "Etendas la filtrilon de ordigado de serĉado kaj superrigardo al ĉiu illegado krom ha_report_issue defaŭlte. Rekta legado de kaŝita ento redonas “ne trovita”, kaj enhava legado kiu elmontrus tian enton estas rifuzita. La escepto de la raport-ilo estas regata sube. Plejforta kaŝado kontraŭ hazarda elmontro, ne fortika sekureca limo.",
+    "visibility.enforce.only_enforced": "Maliberi legadon de kaŝitaj entoj tra ĉiuj illegadoj (krom problemnotoj defaŭlte)",
+    "visibility.enforce.report_issue_help": "Dum ĉi tio estas malŝaltita, ha_report_issue kaj ĉiuj ĝiaj diagnozaj eliraĵoj—inkluzive de protokoloj—restas ekster la deviga reĝimo je ĉiu voko, eĉ kiam videblecaj datumoj estas sanaj aŭ nehaveblaj. Ŝaltu ĝin por skani kaj rifuzi tiun ilon kiel aliajn legadojn.",
+    "visibility.enforce.restrict_report_issue": "Apliki devigan reĝimon al ha_report_issue",
     "visibility.categories.title": "Kaŝi laŭ kategorio",
     "visibility.categories.help": "Home Assistant etikedas aŭtomate generitajn entojn kiel diagnozajn aŭ agordajn.",
     "visibility.categories.legend": "Entaj kategorioj por kaŝi",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/es.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Sin el modo de aplicación estricta (abajo), esto reduce ruido, no controla el acceso: una entidad oculta se sigue devolviendo en una lectura directa de su entity_id y sigue apareciendo en el contenido de automatizaciones, paneles y plantillas. No confíes en el filtro por sí solo como frontera de seguridad.",
     "visibility.enabled": "Activar el filtro de visibilidad de entidades",
     "visibility.enforce.title": "Modo de aplicación estricta",
-    "visibility.enforce.help": "Extiende el filtro de limpiar la búsqueda y el resumen a todas las lecturas de herramientas. Una lectura directa de una entidad oculta devuelve «no encontrada», y una lectura de contenido (panel, plantilla, automatización, traza, registro o archivo) que fuese a mostrar una entidad oculta se rechaza. Es ocultación en la medida de lo posible frente a exposiciones accidentales, no una frontera de seguridad reforzada.",
-    "visibility.enforce.only_enforced": "Hacer que las entidades ocultas no se puedan leer desde ninguna herramienta (no solo en la búsqueda)",
+    "visibility.enforce.help": "Amplía el filtro de búsqueda y resumen para ocultar elementos en todas las lecturas de herramientas, excepto ha_report_issue de forma predeterminada. Una lectura directa de una entidad oculta devuelve \"no encontrado\", y se rechaza una lectura de contenido que muestre alguna. La excepción de la herramienta de informes se controla a continuación. Ocultación de mejor esfuerzo contra la exposición incidental, no es un límite de seguridad reforzado.",
+    "visibility.enforce.only_enforced": "Hacer que las entidades ocultas no se puedan leer en las lecturas de herramientas (excepto en los informes de problemas de forma predeterminada)",
+    "visibility.enforce.report_issue_help": "Mientras esto esté desactivado, ha_report_issue y toda su salida de diagnóstico (incluidos los registros) quedan fuera del modo de aplicación en cada llamada, incluso cuando los datos de visibilidad son correctos o no están disponibles. Actívalo para escanear y rechazar esa herramienta como las demás lecturas.",
+    "visibility.enforce.restrict_report_issue": "Aplicar el modo de aplicación a ha_report_issue",
     "visibility.categories.title": "Ocultar por categoría",
     "visibility.categories.help": "Home Assistant etiqueta las entidades generadas automáticamente como de diagnóstico o de configuración.",
     "visibility.categories.legend": "Categorías de entidad que ocultar",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/fr.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Sans le mode d'application (ci-dessous), il s'agit d'une réduction du bruit, pas d'un contrôle d'accès : une entité masquée est toujours renvoyée par une lecture directe de son entity_id et apparaît toujours dans le contenu des automatisations, tableaux de bord et modèles. Ne vous fiez pas uniquement au filtre comme barrière de sécurité.",
     "visibility.enabled": "Activer le filtre de visibilité des entités",
     "visibility.enforce.title": "Mode d'application",
-    "visibility.enforce.help": "Étend le filtre du désencombrement de la recherche et de l'aperçu à chaque lecture d'outil. Une lecture directe d'une entité masquée renvoie « introuvable », et une lecture de contenu (tableau de bord, modèle, automatisation, trace, journal ou fichier) qui révélerait une entité masquée est refusée. Dissimulation au mieux contre l'exposition incidente, pas une barrière de sécurité renforcée.",
-    "visibility.enforce.only_enforced": "Rendre les entités masquées illisibles dans tous les outils (pas seulement la recherche)",
+    "visibility.enforce.help": "Étend par défaut le filtre de l'encombrement de la recherche et de la vue d'ensemble à toutes les lectures d'outils, à l'exception de ha_report_issue. La lecture directe d'une entité masquée renvoie \"introuvable\", et toute lecture de contenu qui en ferait apparaître une est refusée. L'exception pour l'outil de rapport est contrôlée ci-dessous. Il s'agit d'une dissimulation au mieux contre l'exposition accidentelle, et non d'une limite de sécurité renforcée.",
+    "visibility.enforce.only_enforced": "Rendre les entités masquées illisibles lors des lectures d'outils (sauf les rapports de problèmes par défaut)",
+    "visibility.enforce.report_issue_help": "Lorsque cette option est désactivée, ha_report_issue et l'ensemble de ses sorties de diagnostic (y compris les journaux) restent en dehors du mode d'application à chaque appel, même lorsque les données de visibilité sont saines ou indisponibles. Activez-le pour analyser et refuser cet outil comme les autres lectures.",
+    "visibility.enforce.restrict_report_issue": "Appliquer le mode d'application à ha_report_issue",
     "visibility.categories.title": "Masquer par catégorie",
     "visibility.categories.help": "Home Assistant étiquette les entités générées automatiquement comme diagnostic ou configuration.",
     "visibility.categories.legend": "Catégories d'entités à masquer",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/it.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Senza la modalità di applicazione rigorosa (qui sotto) questo riduce il rumore, non controlla l'accesso: un'entità nascosta viene comunque restituita da una lettura diretta del suo entity_id e compare ancora nei contenuti di automazioni, dashboard e template. Non considerare il filtro da solo come un confine di sicurezza.",
     "visibility.enabled": "Attiva il filtro di visibilità delle entità",
     "visibility.enforce.title": "Modalità di applicazione rigorosa",
-    "visibility.enforce.help": "Estende il filtro dalla sola pulizia di ricerca e panoramica a ogni lettura degli strumenti. Una lettura diretta di un'entità nascosta restituisce «non trovata», e una lettura di contenuti (dashboard, template, automazione, traccia, registro o file) che farebbe emergere un'entità nascosta viene rifiutata. È occultamento secondo il criterio del massimo impegno contro esposizioni accidentali, non un confine di sicurezza robusto.",
-    "visibility.enforce.only_enforced": "Rendi le entità nascoste illeggibili in tutti gli strumenti (non solo nella ricerca)",
+    "visibility.enforce.help": "Estende il filtro dalla ricerca di pulizia e dalla panoramica a ogni lettura di strumenti, tranne ha_report_issue per impostazione predefinita. Una lettura diretta di un'entità nascosta restituisce \"non trovato\", e una lettura di contenuti che ne mostrerebbe una viene rifiutata. L'eccezione dello strumento di segnalazione è controllata di seguito. Copertura basata sul massimo sforzo contro l'esposizione accidentale, non un confine di sicurezza blindato.",
+    "visibility.enforce.only_enforced": "Rendi le entità nascoste illeggibili in tutte le letture degli strumenti (tranne i rapporti di problemi per impostazione predefinita)",
+    "visibility.enforce.report_issue_help": "Mentre questo è disattivato, ha_report_issue e tutta la sua emissione diagnostica, inclusi i log, rimangono al di fuori della modalità di applicazione a ogni chiamata, anche quando i dati di visibilità sono integri o non disponibili. Attivalo per scansionare e rifiutare tale strumento come le altre letture.",
+    "visibility.enforce.restrict_report_issue": "Applica la modalità di applicazione a ha_report_issue",
     "visibility.categories.title": "Nascondi per categoria",
     "visibility.categories.help": "Home Assistant contrassegna le entità generate automaticamente come di diagnostica o di configurazione.",
     "visibility.categories.legend": "Categorie di entità da nascondere",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/nl.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Zonder afdwingmodus (hieronder) is dit ruisonderdrukking, geen toegangscontrole: een verborgen entiteit wordt nog steeds geretourneerd door een directe uitlezing van zijn entity_id en verschijnt nog steeds in automatisering, dashboard en sjablooninhoud. Vertrouw niet alleen op het filter als een beveiligingsgrens.",
     "visibility.enabled": "Schakel filter voor entiteitszichtbaarheid in",
     "visibility.enforce.title": "Afdwingmodus",
-    "visibility.enforce.help": "Breidt het filter uit van het opruimen van zoekopdrachten en overzichten naar elke tool-leesactie. Een directe uitlezing van een verborgen entiteit retourneert “niet gevonden”, en een inhoudelijke uitlezing (dashboard, sjabloon, automatisering, trace, log of bestand) die een verborgen entiteit zou tonen, wordt geweigerd. Beste poging tot verhulling tegen incidentele blootstelling, geen geharde beveiligingsgrens.",
-    "visibility.enforce.only_enforced": "Maak verborgen entiteiten onleesbaar in alle tools (niet alleen zoeken)",
+    "visibility.enforce.help": "Breidt het filter van opschoning van zoekopdrachten en overzichten standaard uit naar elke tool-gelezen data behalve ha_report_issue. Een directe lezing van een verborgen entiteit retourneert \"niet gevonden\", en een inhoudsgelezen data die er een zou tonen, wordt geweigerd. De uitzondering voor het rapportageregelingsmiddel wordt hieronder beheerd. Dit is een inspanningsverplichting ter verberging tegen incidentele blootstelling, geen harde beveiligingsgrens.",
+    "visibility.enforce.only_enforced": "Maak verborgen entiteiten onleesbaar bij alle tool-lezingen (standaard uitgezonderd foutmeldingen)",
+    "visibility.enforce.report_issue_help": "Terwijl dit is uitgeschakeld, blijven ha_report_issue en al zijn diagnostische uitvoer — inclusief logboeken — bij elke aanroep buiten de afdwingmodus, zelfs wanneer zichtbaarheidsgegevens gezond of niet beschikbaar zijn. Schakel dit in om dat hulpprogramma te scannen en te weigeren net als andere lezingen.",
+    "visibility.enforce.restrict_report_issue": "Pas afdwingmodus toe op ha_report_issue",
     "visibility.categories.title": "Verbergen per categorie",
     "visibility.categories.help": "Home Assistant tagt automatisch gegenereerde entiteiten als diagnostisch of configuratie.",
     "visibility.categories.legend": "Entiteitscategorieën om te verbergen",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/pl.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Bez trybu wymuszenia (poniżej), jest to redukcja szumu, a nie kontrola dostępu: ukryta encja jest nadal zwracana przez bezpośredni odczyt jej entity_id i nadal pojawia się w automatyzacjach, panelach i zawartości szablonów. Nie polegaj wyłącznie na filtrze jako granicy bezpieczeństwa.",
     "visibility.enabled": "Włącz filtr widoczności encji",
     "visibility.enforce.title": "Tryb wymuszenia",
-    "visibility.enforce.help": "Rozszerza filtr z wyszukiwania i przeglądu (mających na celu zmniejszenie bałaganu) na każdy odczyt narzędzia. Bezpośredni odczyt ukrytej encji zwraca komunikat „nie znaleziono”, a odczyt zawartości (panel, szablon, automatyzacja, śledzenie, log lub plik), który ujawniłby ukrytą encję, jest odrzucany. Ukrycie z najlepszymi intencjami przed przypadkowym ujawnieniem, a nie wzmocniona granica bezpieczeństwa.",
-    "visibility.enforce.only_enforced": "Spraw, aby ukryte encje były nieczytelne we wszystkich narzędziach (nie tylko w wyszukiwaniu)",
+    "visibility.enforce.help": "Rozszerza domyślnie filtr z ukrywania w wyszukiwaniu i przeglądzie na każdy odczyt narzędzia, z wyjątkiem ha_report_issue. Bezpośredni odczyt ukrytej encji zwraca „nie znaleziono”, a odczyt zawartości, który by ją ujawnił, jest odrzucany. Wyjątek dotyczący narzędzia raportowania jest kontrolowany poniżej. Ukrywanie w najlepszej wierze przed przypadkowym ujawnieniem, a nie twarda granica bezpieczeństwa.",
+    "visibility.enforce.only_enforced": "Uczyń ukryte encje nieczytelnymi we wszystkich odczytach narzędzi (domyślnie z wyjątkiem raportów błędów)",
+    "visibility.enforce.report_issue_help": "Gdy ta opcja jest wyłączona, ha_report_issue oraz wszystkie jego dane diagnostyczne — w tym logi — pozostają poza trybem egzekwowania przy każdym wywołaniu, nawet gdy dane widoczności są poprawne lub niedostępne. Włącz tę opcję, aby skanować i odrzucać to narzędzie podobnie jak inne odczyty.",
+    "visibility.enforce.restrict_report_issue": "Zastosuj tryb egzekwowania do ha_report_issue",
     "visibility.categories.title": "Ukryj według kategorii",
     "visibility.categories.help": "Home Assistant oznacza automatycznie generowane encje jako diagnostyczne lub konfiguracyjne.",
     "visibility.categories.legend": "Kategorie encji do ukrycia",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/ru.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Без режима принудительного скрытия (ниже) это уменьшение информационного шума, а не ограничение доступа: скрытая сущность всё ещё возвращается при прямом запросе по entity_id и остаётся видимой в автоматизациях, панелях и шаблонах. Не полагайтесь на один лишь фильтр как на средство безопасности.",
     "visibility.enabled": "Включить фильтр видимости сущностей",
     "visibility.enforce.title": "Режим принудительного скрытия",
-    "visibility.enforce.help": "Расширяет фильтр: скрытие применяется не только к поиску и обзору, но и к чтению через любые инструменты. Прямое чтение скрытой сущности возвращает «не найдено», а чтение содержимого (дашборд, шаблон, автоматизация, трассировка, журнал или файл), которое раскрыло бы скрытую сущность, отклоняется. Это защита от случайного раскрытия, а не строгая граница безопасности.",
-    "visibility.enforce.only_enforced": "Сделать скрытые сущности нечитаемыми для всех инструментов (не только для поиска)",
+    "visibility.enforce.help": "Расширяет фильтр из поиска, загромождающего интерфейс, и обзора на чтение каждого инструмента, кроме ha_report_issue, по умолчанию. Прямое чтение скрытой сущности возвращает «не найдено», а чтение содержимого, которое должно её показать, отклоняется. Исключение для инструмента отчетов управляется ниже. Это скрытие на основе лучших усилий от случайного раскрытия, а не защищенный рубеж безопасности.",
+    "visibility.enforce.only_enforced": "Сделать скрытые сущности недоступными для чтения во всех инструментах (кроме отчетов о проблемах по умолчанию)",
+    "visibility.enforce.report_issue_help": "Пока эта функция отключена, ha_report_issue и весь ее диагностический вывод, включая логи, не участвуют в режиме принудительного применения при каждом вызове, даже когда данные о видимости в норме или недоступны. Включите ее, чтобы сканировать и отклонять этот инструмент так же, как и другие запросы на чтение.",
+    "visibility.enforce.restrict_report_issue": "Применить режим принудительного применения к ha_report_issue",
     "visibility.categories.title": "Скрывать по категории",
     "visibility.categories.help": "Home Assistant помечает автоматически созданные сущности как диагностические или конфигурационные.",
     "visibility.categories.legend": "Категории скрываемых сущностей",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/sv.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "Utan tvingande läge (nedan) är detta brusreducering, inte åtkomstkontroll: en dold entitet returneras fortfarande vid en direkt läsning av dess entity_id och visas fortfarande i innehåll för automatisering, instrumentpaneler och mallar. Förlita dig inte enbart på filtret som en säkerhetsgräns.",
     "visibility.enabled": "Aktivera entitets synlighetsfilter",
     "visibility.enforce.title": "Tvingande läge",
-    "visibility.enforce.help": "Utökar filtret från att rensa sökning och översikt till varje verktygsläsning. En direkt läsning av en dold entitet returnerar ”hittades inte”, och en innehållsläsning (instrumentpanel, mall, automatisering, spårning, logg eller fil) som skulle visa en dold entitet nekas. Bästa möjliga döljande mot oavsiktlig exponering, inte en förstärkt säkerhetsgräns.",
-    "visibility.enforce.only_enforced": "Gör dolda entiteter oläsbara över alla verktyg (inte bara sökning)",
+    "visibility.enforce.help": "Utökar filtret från att rensa sökningar och översikter till att som standard gälla alla verktygsläsningar förutom ha_report_issue. En direkt läsning av en dold entitet returnerar \"ej hittad\", och en innehållsläsning som skulle visa en sådan nekas. Undantaget för rapportverktyget styrs nedan. Bästa möjliga döljande mot oavsiktlig exponering, inte en härdad säkerhetsgräns.",
+    "visibility.enforce.only_enforced": "Gör dolda entiteter oläsbara vid alla verktygsläsandet (förutom felrapporter som standard)",
+    "visibility.enforce.report_issue_help": "Medan detta är avstängt förblir ha_report_issue och all dess diagnostiska utdata – inklusive loggar – utanför tvingande läge vid varje anrop, även när synlighetsdata är felfri eller otillgänglig. Slå på det för att skanna och neka det verktyget liksom andra läsningar.",
+    "visibility.enforce.restrict_report_issue": "Tillämpa tvingande läge på ha_report_issue",
     "visibility.categories.title": "Dölj efter kategori",
     "visibility.categories.help": "Home Assistant taggar automatiskt genererade entiteter som diagnostik eller konfiguration.",
     "visibility.categories.legend": "Entitetskategorier att dölja",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/settings_ui/locales/zh-Hans.json

@@ -96,8 +96,10 @@
     "visibility.boundary": "在未启用下方的强制模式时，这只是降噪，而非访问控制：被隐藏的实体仍会在直接读取其 entity_id 时返回，并仍会出现在自动化、仪表盘和模板内容中。请勿仅依赖此过滤器作为安全边界。",
     "visibility.enabled": "启用实体可见性过滤器",
     "visibility.enforce.title": "强制模式",
-    "visibility.enforce.help": "将过滤器从仅整理搜索和概览结果扩展到所有工具读取。直接读取隐藏实体会返回“未找到”，而会暴露隐藏实体的内容读取（仪表板、模板、自动化、跟踪、日志或文件）将被拒绝。这是针对意外暴露的尽力隐藏，并非强化的安全边界。",
-    "visibility.enforce.only_enforced": "使隐藏实体对所有工具不可读（不仅限于搜索）",
+    "visibility.enforce.help": "默认将过滤范围从精简搜索和概览扩展到除 ha_report_issue 之外的所有工具读取。直接读取隐藏实体会返回“未找到”，而会暴露隐藏实体的正文读取则会被拒绝。报告工具的例外情况在下方控制。这是针对偶然暴露的尽力隐蔽，而非强固的安全边界。",
+    "visibility.enforce.only_enforced": "使隐藏实体在所有工具读取中均不可读（默认故障排除报告除外）",
+    "visibility.enforce.report_issue_help": "当此选项关闭时，ha_report_issue 及其所有诊断输出（包括日志）在每次调用时都不受强制模式约束，即使可见性数据正常或不可用。开启此选项以像其他读取一样扫描并拒绝该工具。",
+    "visibility.enforce.restrict_report_issue": "将强制模式应用于 ha_report_issue",
     "visibility.categories.title": "按类别隐藏",
     "visibility.categories.help": "Home Assistant 会将自动生成的实体标记为诊断或配置。",
     "visibility.categories.legend": "要隐藏的实体类别",

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374}/src/ha_mcp/tools/tools_search.py

@@ -3396,7 +3396,7 @@ class SearchTools:
                     "tool_discovery, settings_url, settings_url_hint, "
                     "read_only_mode, read_only_mode_hint, ha_mcp_update. Note: "
                     "``settings_url`` (stdio mode), ``settings_url_hint`` "
-                    "(HTTP/Docker/OAuth mode), the ``read_only_mode`` / "
+                    "(standalone HTTP/Docker mode), the ``read_only_mode`` / "
                     "``read_only_mode_hint`` pair (only while Read Only Mode "
                     "is on), and ``ha_mcp_update`` (when an update check applies) "
                     "are emitted regardless of ``fields=`` projection so the "
@@ -3430,10 +3430,11 @@ class SearchTools:
         minimize the response) but only when the sidecar URL file
         actually exists.
 
-        In HTTP / Docker / OAuth modes there is no sidecar URL file and the
-        server can't know its externally reachable host, so the response
-        instead carries a ``settings_url_hint`` string telling the user where
-        the page is mounted and to read the full URL from the startup logs.
+        In standalone HTTP / Docker modes, when an HTTP settings prefix is
+        advertised, there is no sidecar URL file and the server can't know its
+        externally reachable host. The response instead carries a
+        ``settings_url_hint`` string telling the user where the page is mounted
+        and how to find or construct the full URL.
         Hand whichever of the two fields is present to the user.
 
         The response also carries an ``ha_mcp_update`` object
@@ -3512,7 +3513,7 @@ class SearchTools:
         if sidecar_url:
             projected["settings_url"] = sidecar_url
         else:
-            # No stdio sidecar URL file. In HTTP / Docker / OAuth modes hint at
+            # No stdio sidecar URL file. In standalone HTTP / Docker modes hint at
             # the page (and startup-log URL) instead of guessing a wrong absolute URL
             # when bound to 0.0.0.0 (issue #1458).
             from ..settings_ui import get_http_settings_prefix
@@ -3524,8 +3525,10 @@ class SearchTools:
                     "The settings page (enable/disable/pin tools, feature "
                     "flags, advanced settings, backups, tool-approval) is "
                     f"served at '{settings_path}' on this MCP server. Find the "
-                    "full URL in the ha-mcp startup logs, or append it to the "
-                    "base URL your client connects to."
+                    "full URL in the ha-mcp startup logs. For a direct connection, "
+                    "use the MCP endpoint's scheme, host, and port with this "
+                    "settings path (replace the endpoint path rather than "
+                    "appending to it)."
                 )
 
         # Surface Read Only Mode after projection so the flag survives any

{ha_mcp_dev-8.2.0.dev2367 → ha_mcp_dev-8.3.0.dev2374/src/ha_mcp_dev.egg-info}/PKG-INFO

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