ha-mcp-dev 9.0.0.dev3101__tar.gz → 9.0.0.dev3108__tar.gz

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.0.0.dev3101"
+version = "9.0.0.dev3108"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"
@@ -253,6 +253,7 @@ markers = [
     "not_on_haos_embedded: skip on the haos_embedded backend (HAOS_TEST_MODE=embedded) - provably redundant with the lane's own session backend, which enables the entry once and drives the in-process server for the whole suite; #1527",
     "requires_tools_entry: needs the File & YAML Tools config entry - skipped on E2E_NO_TOOLS_ENTRY=1 lanes (#2292)",
     "no_tools_only: runs only on E2E_NO_TOOLS_ENTRY=1 lanes (#2292)",
+    "requires_component_surface: needs an active ha_mcp_tools config entry - skipped on the no-tools lanes without an active server entry (plain container, HAOS inaddon, where it is absent or disabled); #2584",
 ]
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "session"

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.0.0.dev3101"
+version = "9.0.0.dev3108"
 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
@@ -328,6 +328,7 @@ markers = [
     "not_on_haos_embedded: skip on the haos_embedded backend (HAOS_TEST_MODE=embedded) - provably redundant with the lane's own session backend, which enables the entry once and drives the in-process server for the whole suite; #1527",
     "requires_tools_entry: needs the File & YAML Tools config entry - skipped on E2E_NO_TOOLS_ENTRY=1 lanes (#2292)",
     "no_tools_only: runs only on E2E_NO_TOOLS_ENTRY=1 lanes (#2292)",
+    "requires_component_surface: needs an active ha_mcp_tools config entry - skipped on the no-tools lanes without an active server entry (plain container, HAOS inaddon, where it is absent or disabled); #2584",
 ]
 
 # Async support - session-scoped loop lets session-scoped fixtures

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/az.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Parametrlər interfeysinin köməkçi prosesi",
     "server.sections.beta": "Beta funksiyalar (təhlükəli)",
     "server.sections.developer": "Tərtibatçı",
+    "server.sections.remote_access": "Uzaqdan giriş",
     "server.sidecar.disable": "Parametrlər serverini həmişəlik söndür",
     "server.sidecar.disable_title": "Parametrlər interfeysini həmişəlik söndürür: bu serveri dayandırır VƏ ~/.ha-mcp/settings_ui_disabled faylını yaradır ki, gələcəkdə ha-mcp işə salınanda yenidən başlamasın. Yenidən aktivləşdirmək üçün həmin faylı silin.",
     "backups.loading": "Ehtiyat nüsxələrin vəziyyəti yüklənir…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Fərdi yollar hazırda əlçatan deyil.",
     "filesystem.custom.save": "Yolları yadda saxla",
     "filesystem.custom.saved_rejected": "Yadda saxlanıldı. Rədd edilənlər (bloklanmış və ya etibarsız): {paths}",
+    "oauth_callbacks.title": "İcazə verilən OAuth geriyə çağırış (callback) URL-ləri",
+    "oauth_callbacks.help": "Doğrulama rejimi gizli veb-qarmaq (webhook) URL-i olduğu müddətdə, OAuth ilə daxil olan müştəri yalnız bu siyahıdakı geriyə çağırış URL-nə yönləndirilir; digər istənilən geriyə çağırış onun necə əlavə ediləcəyini izah edən səhifə ilə rədd edilir. Hər sətirə bir URL olmaqla, müştərinin göndərdiyi kimi daxil edin. <code>http://</code> qaydabağlantı (loopback) geriyə çağırışı (127.0.0.1, [::1] və ya localhost) həm də istənilən portda uyğun gəlir. Yalnız veb-qarmaq URL-i ilə qoşulan müştərilər üçün giriş tələb olunmur. Dəyişikliklөр yenidən başladılmadan növbəti girişə tətbiq edilir.",
+    "oauth_callbacks.default": "İlkin siyahı: {urls}",
+    "oauth_callbacks.inactive": "Hazırda istifadədə deyil: siyahı yalnız uzaqdan giriş aktiv olduqda və Doğrulama rejimi gizli veb-qarmaq URL-i olduqda tətbiq edilir.",
+    "oauth_callbacks.save": "Geriyə çağırışları saxla",
+    "oauth_callbacks.reset": "İlkin vəziyyəti bərpa et",
+    "oauth_callbacks.invalid": "Saxlanılmadı. Bunlar istifadəyə yararlı geriyə çağırış URL-ləri deyil: {urls}. İstifadəçi adı, parol və ya #fragment olmadan https://, yaxud 127.0.0.1, [::1] və ya localhost üzərində http:// istifadə edin.",
+    "oauth_callbacks.saved": "Saxlandı. Növbəti girişə tətbiq olunur.",
+    "oauth_callbacks.load_failed": "Geriyə çağırış siyahısını yükləmək mümkün olmadı (HTTP {status}). Yenidən cəhd etmək üçün səhifəni yeniləyin.",
+    "oauth_callbacks.load_error": "Geriyə çağırış siyahısını yükləmək mümkün olmadı: sorğu uğursuz oldu. Yenidən cəhd etmək üçün səhifəni yeniləyin.",
     "origins.env_locked": "Mühit dəyişəni vasitəsilə təyin edilib; burada redaktə etmək üçün həmin təyinatı ləğv edin.",
     "origins.addon_synced": "Tətbiqin (əlavənin) Konfiqurasiya vərəqi ilə sinxronlaşdırılıb. Yadda saxladıqdan sonra yenidən başlatmaq tələb olunur.",
     "origins.env_var_unset": "{variable} mühit dəyişəni vasitəsilə təyin edilib; burada redaktə etmək üçün həmin təyinatı ləğv edin.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/cs.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Doprovodné uživatelské rozhraní nastavení",
     "server.sections.beta": "Beta funkce (nebezpečné)",
     "server.sections.developer": "Vývojář",
+    "server.sections.remote_access": "Vzdálený přístup",
     "server.sidecar.disable": "Trvale zakázat server nastavení",
     "server.sidecar.disable_title": "Trvale zakáže uživatelské rozhraní nastavení: zastaví tento server A zapíše ~/.ha-mcp/settings_ui_disabled, aby se nespustil při budoucích spuštěních ha-mcp. Pro opětovné povolení tento soubor smažte.",
     "backups.loading": "Načítání stavu zálohy…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Vlastní cesty jsou aktuálně nedostupné.",
     "filesystem.custom.save": "Uložit cesty",
     "filesystem.custom.saved_rejected": "Uloženo. Zamítnuto (blokováno nebo neplatné): {paths}",
+    "oauth_callbacks.title": "Povolené adresy URL zpětného volání OAuth",
+    "oauth_callbacks.help": "Když je režim ověřování nastaven na tajnou adresu URL webhooku, klient, který se přihlásí pomocí OAuth, je přesměrován zpět pouze na adresu URL zpětného volání z tohoto seznamu; jakékoli jiné zpětné volání je odmítnuto se stránkou vysvětlující, jak jej přidat. Zadejte jednu adresu URL na řádek přesně tak, jak ji klient odesílá. Zpětné volání typu loopback s <code>http://</code> (127.0.0.1, [::1] nebo localhost) odpovídá také na libovolném portu. Klienti, kteří se připojují pouze pomocí adresy URL webhooku, nevyžadují žádný záznam. Změny se projeví při příštím přihlášení bez nutnosti restartu.",
+    "oauth_callbacks.default": "Výchozí seznam: {urls}",
+    "oauth_callbacks.inactive": "Právě se nepoužívá: seznam platí pouze v případě, že je zapnutý vzdálený přístup a režim ověřování je nastaven na tajnou adresu URL webhooku.",
+    "oauth_callbacks.save": "Uložit zpětná volání",
+    "oauth_callbacks.reset": "Obnovit výchozí",
+    "oauth_callbacks.invalid": "Neuloženo. Tyto adresy URL zpětného volání jsou nepoužitelné: {urls}. Použijte https:// nebo http:// na 127.0.0.1, [::1] či localhost, bez uživatelského jména, hesla nebo #fragmentu.",
+    "oauth_callbacks.saved": "Uloženo. Platí pro příští přihlášení.",
+    "oauth_callbacks.load_failed": "Seznam zpětných volání se nepodařilo načíst (HTTP {status}). Znovu načtěte stránku a zkuste to znovu.",
+    "oauth_callbacks.load_error": "Seznam zpětných volání se nepodařilo načíst: požadavek selhal. Znovu načtěte stránku a zkuste to znovu.",
     "origins.env_locked": "Nastaveno přes proměnnou prostředí; zrušte ji pro úpravy zde.",
     "origins.addon_synced": "Synchronizováno s kartou Konfigurace aplikace (doplňku). Po uložení je vyžadován restart.",
     "origins.env_var_unset": "Nastaveno přes proměnnou prostředí {variable}; zrušte ji pro úpravy zde.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/de.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Einstellungs-UI-Sidecar",
     "server.sections.beta": "Beta-Funktionen (gefährlich)",
     "server.sections.developer": "Entwickler",
+    "server.sections.remote_access": "Fernzugriff",
     "server.sidecar.disable": "Einstellungs-Server dauerhaft deaktivieren",
     "server.sidecar.disable_title": "Deaktiviert die Einstellungs-UI dauerhaft: stoppt diesen Server UND schreibt ~/.ha-mcp/settings_ui_disabled, sodass der Server bei zukünftigen ha-mcp-Starts nicht neu startet. Lösche diese Datei, um sie wieder zu aktivieren.",
     "backups.loading": "Lade Backup-Status…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Benutzerdefinierte Pfade sind derzeit nicht verfügbar.",
     "filesystem.custom.save": "Pfade speichern",
     "filesystem.custom.saved_rejected": "Gespeichert. Abgelehnt (blockiert oder ungültig): {paths}",
+    "oauth_callbacks.title": "Erlaubte OAuth-Callback-URLs",
+    "oauth_callbacks.help": "Solange der Authentifizierungsmodus die geheime Webhook-URL ist, wird ein Client, der sich mit OAuth anmeldet, nur an eine Callback-URL auf dieser Liste zurückgeleitet; jeder andere Callback wird mit einer Seite abgelehnt, die erklärt, wie man ihn hinzufügt. Gib eine URL pro Zeile ein, exakt so, wie der Client sie sendet. Ein <code>http://</code>-Loopback-Callback (127.0.0.1, [::1] oder localhost) stimmt auch mit jedem Port überein. Clients, die sich nur mit der Webhook-URL verbinden, benötigen keinen Eintrag. Änderungen gelten für die nächste Anmeldung, ohne Neustart.",
+    "oauth_callbacks.default": "Standardliste: {urls}",
+    "oauth_callbacks.inactive": "Zurzeit nicht in Verwendung: Die Liste gilt nur, während der Fernzugriff aktiv ist und der Authentifizierungsmodus die geheime Webhook-URL ist.",
+    "oauth_callbacks.save": "Callbacks speichern",
+    "oauth_callbacks.reset": "Standard wiederherstellen",
+    "oauth_callbacks.invalid": "Nicht gespeichert. Dies sind keine verwendbaren Callback-URLs: {urls}. Verwende https:// oder http:// auf 127.0.0.1, [::1] oder localhost, ohne Benutzernamen, Passwort oder #fragment.",
+    "oauth_callbacks.saved": "Gespeichert. Gilt für die nächste Anmeldung.",
+    "oauth_callbacks.load_failed": "Die Callback-Liste konnte nicht geladen werden (HTTP {status}). Lade die Seite neu, um es erneut zu versuchen.",
+    "oauth_callbacks.load_error": "Die Callback-Liste konnte nicht geladen werden: Die Anfrage ist fehlgeschlagen. Lade die Seite neu, um es erneut zu versuchen.",
     "origins.env_locked": "Über Umgebungsvariable gesetzt; hebe sie auf, um hier zu bearbeiten.",
     "origins.addon_synced": "Mit dem Tab App-Konfiguration (Add-on) synchronisiert. Nach dem Speichern ist ein Neustart erforderlich.",
     "origins.env_var_unset": "Über Umgebungsvariable {variable} gesetzt; hebe sie auf, um hier zu bearbeiten.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/eo.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Flankveturilo de Agorda UI",
     "server.sections.beta": "Beta-funkcioj (danĝeraj)",
     "server.sections.developer": "Programisto",
+    "server.sections.remote_access": "Forstira aliro",
     "server.sidecar.disable": "Konstante malŝalti agordan servilon",
     "server.sidecar.disable_title": "Konstante malŝaltas la agordan UI: haltigas ĉi tiun servilon KAJ skribas ~/.ha-mcp/settings_ui_disabled por ke ĝi ne reaperu ĉe estontaj lanĉoj de ha-mcp. Forigu tiun dosieron por re-ebligi.",
     "backups.loading": "Ŝarĝante sekurkopian staton…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Propraj vojoj nuntempe ne disponeblas.",
     "filesystem.custom.save": "Konservi vojojn",
     "filesystem.custom.saved_rejected": "Konservita. Malakceptita (blokita aŭ nevalida): {paths}",
+    "oauth_callbacks.title": "Permesitaj OAuth-retrekomencaj URL-oj",
+    "oauth_callbacks.help": "Dum la Aŭtentiga reĝimo estas la sekreta retmesaĝa ligilo, kliento kiu ensalutas per OAuth estas sendita reen nur al retrekomenca URL en ĉi tiu listo; ĉiu alia retrekomenco estas rifuzita per paĝo klariganta kiel aldoni ĝin. Enigu unu URL-on po linio, ekzakte kiel la kliento sendas ĝin. <code>http://</code>-retslaŭba retrekomenco (127.0.0.1, [::1] aŭ localhost) ankaŭ kongruas je ĉiu pordo. Kliento kiu konektas per la retmesaĝa ligilo sola bezonas neniun eniron. Ŝanĝoj validas por la venonta ensaluto, sen restartigo.",
+    "oauth_callbacks.default": "Defaŭlta listo: {urls}",
+    "oauth_callbacks.inactive": "Ne uzata nun: la listo validas nur dum forstira aliro estas ŝaltita kaj Aŭtentiga reĝimo estas la sekreta retmesaĝa ligilo.",
+    "oauth_callbacks.save": "Konservi retrekomencojn",
+    "oauth_callbacks.reset": "Restarigi defaŭltan",
+    "oauth_callbacks.invalid": "Ne konservite. Ĉi tiuj ne estas uzeblaj retrekomencaj URL-oj: {urls}. Uzu https://, aŭ http:// je 127.0.0.1, [::1] aŭ localhost, sen uzantnomo, pasvorto aŭ #fragment.",
+    "oauth_callbacks.saved": "Konservite. Validas por la venonta ensaluto.",
+    "oauth_callbacks.load_failed": "Ne eblis ŝargi la retrekomencan liston (HTTP {status}). Reŝargu la paĝon por provi denove.",
+    "oauth_callbacks.load_error": "Ne eblis ŝargi la retrekomencan liston: la peto malsukcesis. Reŝargu la paĝon por provi denove.",
     "origins.env_locked": "Agordita per medio-variablo; malagordu ĝin por redakti ĉi tie.",
     "origins.addon_synced": "Sinkronigita al la agorda langeto de la apo (aldonaĵo). Restartigo postulata post konservo.",
     "origins.env_var_unset": "Agordita per medio-variablo {variable}; malagordu ĝin por redakti ĉi tie.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/es.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Sidecar de la interfaz de ajustes",
     "server.sections.beta": "Funciones beta (peligrosas)",
     "server.sections.developer": "Desarrollo",
+    "server.sections.remote_access": "Acceso remoto",
     "server.sidecar.disable": "Desactivar permanentemente el servidor de ajustes",
     "server.sidecar.disable_title": "Desactiva permanentemente la interfaz de ajustes: detiene este servidor Y escribe ~/.ha-mcp/settings_ui_disabled para que no vuelva a arrancar en futuros inicios de ha-mcp. Elimina ese archivo para reactivarla.",
     "backups.loading": "Cargando el estado de las copias de seguridad…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Las rutas personalizadas no están disponibles actualmente.",
     "filesystem.custom.save": "Guardar rutas",
     "filesystem.custom.saved_rejected": "Guardado. Rechazados (bloqueados o no válidos): {paths}",
+    "oauth_callbacks.title": "URLs de devolución de llamada de OAuth permitidas",
+    "oauth_callbacks.help": "Mientras el modo de autenticación sea la URL de webhook secreta, un cliente que inicie sesión con OAuth solo será redirigido a una URL de devolución de llamada de esta lista; cualquier otra devolución de llamada se rechazará con una página que explica cómo añadirla. Introduce una URL por línea, exactamente como la envía el cliente. Una devolución de llamada de bucle invertido <code>http://</code> (127.0.0.1, [::1] o localhost) también coincide en cualquier puerto. Los clientes que se conectan solo con la URL de webhook no necesitan ninguna entrada. Los cambios se aplican en el próximo inicio de sesión, sin necesidad de reiniciar.",
+    "oauth_callbacks.default": "Lista predeterminada: {urls}",
+    "oauth_callbacks.inactive": "No se está usando en este momento: la lista solo se aplica mientras el acceso remoto está activado y el modo de autenticación es la URL de webhook secreta.",
+    "oauth_callbacks.save": "Guardar devoluciones de llamada",
+    "oauth_callbacks.reset": "Restaurar predeterminado",
+    "oauth_callbacks.invalid": "No guardado. Estas no son URLs de devolución de llamada utilizables: {urls}. Usa https://, o http:// en 127.0.0.1, [::1] o localhost, sin nombre de usuario, contraseña ni #fragment.",
+    "oauth_callbacks.saved": "Guardado. Se aplica al próximo inicio de sesión.",
+    "oauth_callbacks.load_failed": "No se pudo cargar la lista de devoluciones de llamada (HTTP {status}). Recarga la página para intentarlo de nuevo.",
+    "oauth_callbacks.load_error": "No se pudo cargar la lista de devoluciones de llamada: la solicitud falló. Recarga la página para intentarlo de nuevo.",
     "origins.env_locked": "Definido mediante una variable de entorno; quítala para poder editarlo aquí.",
     "origins.addon_synced": "Sincronizado con la pestaña de configuración de la app (add-on). Se requiere reiniciar después de guardar.",
     "origins.env_var_unset": "Definido mediante la variable de entorno {variable}; quítala para poder editarlo aquí.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/fr.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Sidecar de l'interface des paramètres",
     "server.sections.beta": "Fonctionnalités bêta (dangereuses)",
     "server.sections.developer": "Développeur",
+    "server.sections.remote_access": "Accès distant",
     "server.sidecar.disable": "Désactiver définitivement le serveur de paramètres",
     "server.sidecar.disable_title": "Désactive définitivement l'interface des paramètres : arrête ce serveur ET écrit ~/.ha-mcp/settings_ui_disabled pour qu'il ne redémarre pas lors des futurs lancements de ha-mcp. Supprimez ce fichier pour réactiver.",
     "backups.loading": "Chargement de l'état des sauvegardes…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Les chemins personnalisés sont actuellement indisponibles.",
     "filesystem.custom.save": "Enregistrer les chemins",
     "filesystem.custom.saved_rejected": "Enregistré. Rejeté (bloqué ou invalide) : {paths}",
+    "oauth_callbacks.title": "URLs de rappel OAuth autorisées",
+    "oauth_callbacks.help": "Lorsque le mode d'authentification est l'URL de webhook secrète, un client qui se connecte via OAuth est redirigé uniquement vers une URL de rappel figurant sur cette liste ; tout autre rappel est refusé avec une page expliquant comment l'ajouter. Entrez une URL par ligne, exactement telle que le client l'envoie. Un rappel de bouclage <code>http://</code> (127.0.0.1, [::1] ou localhost) correspond également à n'importe quel port. Les clients qui se connectent uniquement avec l'URL de webhook n'ont pas besoin d'entrée. Les modifications s'appliquent à la prochaine connexion, sans redémarrage.",
+    "oauth_callbacks.default": "Liste par défaut : {urls}",
+    "oauth_callbacks.inactive": "Inactif pour le moment : la liste ne s'applique que lorsque l'accès distant est activé et que le mode d'authentification est l'URL de webhook secrète.",
+    "oauth_callbacks.save": "Enregistrer les rappels",
+    "oauth_callbacks.reset": "Restaurer la valeur par défaut",
+    "oauth_callbacks.invalid": "Non enregistré. Ces URLs de rappel ne sont pas utilisables : {urls}. Utilisez https:// ou http:// sur 127.0.0.1, [::1] ou localhost, sans nom d'utilisateur, mot de passe ni #fragment.",
+    "oauth_callbacks.saved": "Enregistré. S'applique à la prochaine connexion.",
+    "oauth_callbacks.load_failed": "Impossible de charger la liste des rappels (HTTP {status}). Rechargez la page pour réessayer.",
+    "oauth_callbacks.load_error": "Impossible de charger la liste des rappels : la requête a échoué. Rechargez la page pour réessayer.",
     "origins.env_locked": "Défini via une variable d'environnement ; désactivez-la pour modifier ici.",
     "origins.addon_synced": "Synchronisé avec l'onglet Configuration de l'application (add-on). Redémarrage requis après l'enregistrement.",
     "origins.env_var_unset": "Défini via la variable d'environnement {variable} ; désactivez-la pour modifier ici.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/it.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Sidecar dell'interfaccia delle impostazioni",
     "server.sections.beta": "Funzioni beta (pericolose)",
     "server.sections.developer": "Sviluppo",
+    "server.sections.remote_access": "Accesso remoto",
     "server.sidecar.disable": "Disattiva permanentemente il server delle impostazioni",
     "server.sidecar.disable_title": "Disattiva permanentemente l'interfaccia delle impostazioni: ferma questo server E scrive ~/.ha-mcp/settings_ui_disabled in modo che non riparta ai prossimi avvii di ha-mcp. Elimina quel file per riattivarla.",
     "backups.loading": "Caricamento dello stato dei backup…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "I percorsi personalizzati non sono attualmente disponibili.",
     "filesystem.custom.save": "Salva percorsi",
     "filesystem.custom.saved_rejected": "Salvato. Rifiutati (bloccati o non validi): {paths}",
+    "oauth_callbacks.title": "URL di callback OAuth consentiti",
+    "oauth_callbacks.help": "Mentre la modalità di autenticazione è l'URL webhook segreto, un client che effettua l'accesso con OAuth viene reindirizzato solo a un URL di callback presente in questo elenco; qualsiasi altro callback viene rifiutato con una pagina che spiega come aggiungerlo. Inserisci un URL per riga, esattamente come lo invia il client. Un callback di loopback <code>http://</code> (127.0.0.1, [::1] o localhost) corrisponde anche a qualsiasi porta. I client che si connettono solo con l'URL webhook non richiedono alcuna voce. Le modifiche si applicano al successivo accesso, senza riavviare.",
+    "oauth_callbacks.default": "Elenco predefinito: {urls}",
+    "oauth_callbacks.inactive": "Non in uso al momento: l'elenco si applica solo quando l'accesso remoto è attivo e la modalità di autenticazione è l'URL webhook segreto.",
+    "oauth_callbacks.save": "Salva callback",
+    "oauth_callbacks.reset": "Ripristina predefiniti",
+    "oauth_callbacks.invalid": "Non salvato. Questi non sono URL di callback utilizzabili: {urls}. Usa https://, oppure http:// su 127.0.0.1, [::1] o localhost, senza nome utente, password o #fragment.",
+    "oauth_callbacks.saved": "Salvato. Si applica al successivo accesso.",
+    "oauth_callbacks.load_failed": "Impossibile caricare l'elenco dei callback (HTTP {status}). Ricarica la pagina per riprovare.",
+    "oauth_callbacks.load_error": "Impossibile caricare l'elenco dei callback: la richiesta non è riuscita. Ricarica la pagina per riprovare.",
     "origins.env_locked": "Impostato tramite variabile d'ambiente; toglila per modificarlo qui.",
     "origins.addon_synced": "Sincronizzato con la scheda Configuration dell'applicazione (add-on). Riavvio richiesto dopo il salvataggio.",
     "origins.env_var_unset": "Impostato tramite la variabile d'ambiente {variable}; toglila per modificarlo qui.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/ko.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "설정 UI 사이드카",
     "server.sections.beta": "베타 기능(위험)",
     "server.sections.developer": "개발자",
+    "server.sections.remote_access": "원격 접근",
     "server.sidecar.disable": "설정 서버 영구 비활성화",
     "server.sidecar.disable_title": "설정 UI를 영구히 비활성화합니다. 이 서버를 중지하고 ~/.ha-mcp/settings_ui_disabled 파일을 기록해 이후 ha-mcp 실행 시 다시 뜨지 않게 합니다. 다시 켜려면 그 파일을 삭제하세요.",
     "backups.loading": "백업 상태를 불러오는 중…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "현재 사용자 지정 경로를 사용할 수 없습니다.",
     "filesystem.custom.save": "경로 저장",
     "filesystem.custom.saved_rejected": "저장했습니다. 거부된 항목(차단되었거나 잘못됨): {paths}",
+    "oauth_callbacks.title": "허용된 OAuth 콜백 URL",
+    "oauth_callbacks.help": "인증 모드가 비밀 웹훅 URL인 동안에는, OAuth로 로그인한 클라이언트는 이 목록에 있는 콜백 URL로만 리디렉션되며, 다른 콜백은 추가 방법을 설명하는 페이지와 함께 거부됩니다. 클라이언트가 보내는 그대로 줄당 하나의 URL을 입력하세요. <code>http://</code> 루프백 콜백(127.0.0.1, [::1] 또는 localhost)은 모든 포트에서도 일치합니다. 웹훅 URL만으로 연결하는 클라이언트는 항목이 필요하지 않습니다. 변경 사항은 재시작 없이 다음 로그인부터 적용됩니다.",
+    "oauth_callbacks.default": "기본 목록: {urls}",
+    "oauth_callbacks.inactive": "현재 사용되지 않음: 이 목록은 원격 접근이 켜져 있고 인증 모드가 비밀 웹훅 URL일 때만 적용됩니다.",
+    "oauth_callbacks.save": "콜백 저장",
+    "oauth_callbacks.reset": "기본값 복원",
+    "oauth_callbacks.invalid": "저장되지 않았습니다. 다음은 사용할 수 없는 콜백 URL입니다: {urls}. 사용자 이름, 비밀번호 또는 #fragment 없이 https:// 또는 127.0.0.1, [::1] 또는 localhost의 http://를 사용하세요.",
+    "oauth_callbacks.saved": "저장되었습니다. 다음 로그인부터 적용됩니다.",
+    "oauth_callbacks.load_failed": "콜백 목록을 불러올 수 없습니다 (HTTP {status}). 페이지를 다시 불러와서 다시 시도하세요.",
+    "oauth_callbacks.load_error": "콜백 목록을 불러올 수 없습니다: 요청이 실패했습니다. 페이지를 다시 불러와서 다시 시도하세요.",
     "origins.env_locked": "환경 변수로 설정되어 있습니다. 여기서 편집하려면 해제하세요.",
     "origins.addon_synced": "앱(애드온) 구성 탭과 동기화됩니다. 저장 후 다시 시작해야 합니다.",
     "origins.env_var_unset": "환경 변수 {variable}로 설정되어 있습니다. 여기서 편집하려면 해제하세요.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/nl.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Instellingen UI sidecar",
     "server.sections.beta": "Bètafuncties (gevaarlijk)",
     "server.sections.developer": "Ontwikkelaar",
+    "server.sections.remote_access": "Externe toegang",
     "server.sidecar.disable": "Instellingenserver permanent uitschakelen",
     "server.sidecar.disable_title": "Schakelt de instellingen-UI permanent uit: stopt deze server EN schrijft ~/.ha-mcp/settings_ui_disabled zodat deze niet opnieuw wordt gestart bij toekomstige ha-mcp lanceringen. Verwijder dat bestand om opnieuw in te schakelen.",
     "backups.loading": "Back-upstatus laden…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Aangepaste paden zijn momenteel niet beschikbaar.",
     "filesystem.custom.save": "Paden opslaan",
     "filesystem.custom.saved_rejected": "Opgeslagen. Geweigerd (geblokkeerd of ongeldig): {paths}",
+    "oauth_callbacks.title": "Toegestane OAuth-terugbel-URL's",
+    "oauth_callbacks.help": "Terwijl de authenticatiemodus de geheime webhook-URL is, wordt een cliënt die inlogt met OAuth alleen teruggestuurd naar een terugbel-URL op deze lijst; elke andere terugbelactie wordt geweigerd met een pagina die uitlegt hoe je deze kunt toevoegen. Voer één URL per regel in, precies zoals de cliënt deze verzendt. Een <code>http://</code> loopback-terugbel-URL (127.0.0.1, [::1] of localhost) komt ook overeen op elke poort. Cliënten die alleen verbinding maken met de webhook-URL hebben geen vermelding nodig. Wijzigingen zijn van toepassing op de volgende aanmelding, zonder herstart.",
+    "oauth_callbacks.default": "Standaardlijst: {urls}",
+    "oauth_callbacks.inactive": "Momenteel niet in gebruik: de lijst is alleen van toepassing wanneer externe toegang is ingeschakeld en de authenticatiemodus de geheime webhook-URL is.",
+    "oauth_callbacks.save": "Terugbel-URL's opslaan",
+    "oauth_callbacks.reset": "Standaardherstel",
+    "oauth_callbacks.invalid": "Niet opgeslagen. Dit zijn geen bruikbare terugbel-URL's: {urls}. Gebruik https://, of http:// op 127.0.0.1, [::1] of localhost, zonder gebruikersnaam, wachtwoord of #fragment.",
+    "oauth_callbacks.saved": "Opgeslagen. Is van toepassing op de volgende aanmelding.",
+    "oauth_callbacks.load_failed": "Kon de terugbelijst niet laden (HTTP {status}). Herlaad de pagina om het opnieuw te proberen.",
+    "oauth_callbacks.load_error": "Kon de terugbelijst niet laden: het verzoek is mislukt. Herlaad de pagina om het opnieuw te proberen.",
     "origins.env_locked": "Ingesteld via omgevingsvariabele; maak deze ongedaan om hier te bewerken.",
     "origins.addon_synced": "Gesynchroniseerd met het tabblad Configuratie van de app (add-on). Herstart vereist na opslaan.",
     "origins.env_var_unset": "Ingesteld via omgevingsvariabele {variable}; maak deze ongedaan om hier te bewerken.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/pl.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Panel boczny interfejsu ustawień",
     "server.sections.beta": "Funkcje beta (niebezpieczne)",
     "server.sections.developer": "Deweloper",
+    "server.sections.remote_access": "Dostęp zdalny",
     "server.sidecar.disable": "Trwale wyłącz serwer ustawień",
     "server.sidecar.disable_title": "Trwale wyłącza interfejs użytkownika ustawień: zatrzymuje ten serwer ORAZ zapisuje ~/.ha-mcp/settings_ui_disabled, aby nie uruchamiał się ponownie przy przyszłych uruchomieniach ha-mcp. Usuń ten plik, aby ponownie włączyć.",
     "backups.loading": "Ładowanie stanu kopii zapasowej…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Niestandardowe ścieżki są obecnie niedostępne.",
     "filesystem.custom.save": "Zapisz ścieżki",
     "filesystem.custom.saved_rejected": "Zapisano. Odrzucono (zablokowane lub nieprawidłowe): {paths}",
+    "oauth_callbacks.title": "Dozwolone adresy URL zwrotne OAuth",
+    "oauth_callbacks.help": "Gdy trybem uwierzytelniania jest tajny adres URL webhooka, klient logujący się przez OAuth jest odsyłany tylko na adres URL zwrotny z tej listy; każde inne wywołanie zwrotne jest odrzucane ze stroną wyjaśniającą, jak je dodać. Wpisz jeden adres URL w linii, dokładnie tak, jak przesyła go klient. Adres zwrotny pętli zwrotnej <code>http://</code> (127.0.0.1, [::1] lub localhost) pasuje również do każdego portu. Klienci łączący się wyłącznie za pomocą adresu URL webhooka nie potrzebują wpisu. Zmiany obowiązują przy następnym logowaniu, bez restartu.",
+    "oauth_callbacks.default": "Lista domyślna: {urls}",
+    "oauth_callbacks.inactive": "Obecnie nieużywane: lista obowiązuje tylko wtedy, gdy włączony jest dostęp zdalny, a trybem uwierzytelniania jest tajny adres URL webhooka.",
+    "oauth_callbacks.save": "Zapisz adresy zwrotne",
+    "oauth_callbacks.reset": "Przywróć domyślne",
+    "oauth_callbacks.invalid": "Nie zapisano. Te adresy URL zwrotne nie nadają się do użytku: {urls}. Użyj protokołu https:// lub http:// dla 127.0.0.1, [::1] lub localhost, bez nazwy użytkownika, hasła lub fragmentu #.",
+    "oauth_callbacks.saved": "Zapisano. Dotyczy następnego logowania.",
+    "oauth_callbacks.load_failed": "Nie można wczytać listy adresów zwrotnych (HTTP {status}). Odśwież stronę, aby spróbować ponownie.",
+    "oauth_callbacks.load_error": "Nie można wczytać listy adresów zwrotnych: żądanie nie powiodło się. Odśwież stronę, aby spróbować ponownie.",
     "origins.env_locked": "Ustawiono za pomocą zmiennej środowiskowej; usuń ją, aby edytować tutaj.",
     "origins.addon_synced": "Zsynchronizowano z kartą konfiguracji aplikacji (dodatku). Po zapisaniu wymagane jest ponowne uruchomienie.",
     "origins.env_var_unset": "Ustawiono za pomocą zmiennej środowiskowej {variable}; usuń ją, aby edytować tutaj.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/ru.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Вспомогательный сервер интерфейса",
     "server.sections.beta": "Бета-функции (опасно)",
     "server.sections.developer": "Для разработчиков",
+    "server.sections.remote_access": "Удаленный доступ",
     "server.sidecar.disable": "Навсегда отключить сервер настроек",
     "server.sidecar.disable_title": "Останавливает сервер интерфейса настроек и создаёт файл ~/.ha-mcp/settings_ui_disabled, запрещающий его автоматический запуск в дальнейшем. Чтобы снова включить интерфейс, удалите этот файл.",
     "backups.loading": "Загрузка состояния резервных копий…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Пользовательские пути в настоящее время недоступны.",
     "filesystem.custom.save": "Сохранить пути",
     "filesystem.custom.saved_rejected": "Сохранено. Отклонены заблокированные или неверные пути: {paths}",
+    "oauth_callbacks.title": "Разрешенные URL обратного вызова OAuth",
+    "oauth_callbacks.help": "Пока в качестве режима аутентификации используется секретный URL вебхука, клиент, выполняющий вход через OAuth, перенаправляется только на URL обратного вызова из этого списка; любые другие обратные вызовы отклоняются с выводом страницы с инструкциями по их добавлению. Вводите по одному URL на строку, в точности так, как их передает клиент. Обратный вызов через loopback-адрес <code>http://</code> (127.0.0.1, [::1] или localhost) также совпадает с любым портом. Клиентам, подключающимся только с помощью URL вебхука, запись не требуется. Изменения вступают в силу со следующим входом без перезапуска.",
+    "oauth_callbacks.default": "Список по умолчанию: {urls}",
+    "oauth_callbacks.inactive": "Сейчас не используется: список применяется только при включенном удаленном доступе и режиме аутентификации «секретный URL вебхука».",
+    "oauth_callbacks.save": "Сохранить обратные вызовы",
+    "oauth_callbacks.reset": "Восстановить по умолчанию",
+    "oauth_callbacks.invalid": "Не сохранено. Это недопустимые URL обратного вызова: {urls}. Используйте https:// или http:// для 127.0.0.1, [::1] или localhost, без имени пользователя, пароля или фрагмента #.",
+    "oauth_callbacks.saved": "Сохранено. Применяется ко входу в систему.",
+    "oauth_callbacks.load_failed": "Не удалось загрузить список обратных вызовов (HTTP {status}). Обновите страницу, чтобы повторить попытку.",
+    "oauth_callbacks.load_error": "Не удалось загрузить список обратных вызовов: сбой запроса. Обновите страницу, чтобы повторить попытку.",
     "origins.env_locked": "Задано переменной среды; снимите её, чтобы изменять здесь.",
     "origins.addon_synced": "Синхронизировано с вкладкой конфигурации приложения (аддона). После сохранения требуется перезапуск.",
     "origins.env_var_unset": "Задано переменной среды {variable}; снимите её, чтобы изменять здесь.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/sv.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "Inställnings-UI sidovagn",
     "server.sections.beta": "Betafunktioner (farliga)",
     "server.sections.developer": "Utvecklare",
+    "server.sections.remote_access": "Fjärråtkomst",
     "server.sidecar.disable": "Inaktivera inställningsservern permanent",
     "server.sidecar.disable_title": "Inaktiverar inställnings-UI permanent: stoppar denna server OCH skriver ~/.ha-mcp/settings_ui_disabled så att den inte återuppstår vid framtida ha-mcp-starter. Ta bort den filen för att återaktivera.",
     "backups.loading": "Laddar säkerhetskopieringsstatus…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "Anpassade sökvägar är för närvarande inte tillgängliga.",
     "filesystem.custom.save": "Spara sökvägar",
     "filesystem.custom.saved_rejected": "Sparat. Avvisades (blockerade eller ogiltiga): {paths}",
+    "oauth_callbacks.title": "Tillåtna OAuth-återanrops-URL:er",
+    "oauth_callbacks.help": "Medan autentiseringsläget är den hemliga webhook-URL:en skickas en klient som loggar in med OAuth endast tillbaka till en återanrops-URL i den här listan; alla andra återanrop nekas med en sida som förklarar hur man lägger till den. Ange en URL per rad, exakt som klienten skickar den. Ett <code>http://</code>-loopback-återanrop (127.0.0.1, [::1] eller localhost) matchar också på valfri port. Klienter som ansluter enbart med webhook-URL:en behöver ingen post. Ändringar tillämpas vid nästa inloggning, utan omstart.",
+    "oauth_callbacks.default": "Standardlista: {urls}",
+    "oauth_callbacks.inactive": "Inte i bruk just nu: listan gäller endast när fjärråtkomst är på och autentiseringsläget är den hemliga webhook-URL:en.",
+    "oauth_callbacks.save": "Spara återanrop",
+    "oauth_callbacks.reset": "Återställ standard",
+    "oauth_callbacks.invalid": "Inte sparat. Dessa är inte användbara återanrops-URL:er: {urls}. Använd https:// eller http:// på 127.0.0.1, [::1] eller localhost, utan användarnamn, lösenord eller #fragment.",
+    "oauth_callbacks.saved": "Sparat. Gäller vid nästa inloggning.",
+    "oauth_callbacks.load_failed": "Kunde inte läsa in återanropslistan (HTTP {status}). Ladda om sidan för att försöka igen.",
+    "oauth_callbacks.load_error": "Kunde inte läsa in återanropslistan: begäran misslyckades. Ladda om sidan för att försöka igen.",
     "origins.env_locked": "Anges via miljövariabel; avmarkera den för att redigera här.",
     "origins.addon_synced": "Synkroniserat till fliken Configuration för appen (tillägget). Omstart krävs efter sparande.",
     "origins.env_var_unset": "Anges via miljövariabel {variable}; avmarkera den för att redigera här.",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/zh-Hans.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "设置界面旁路服务",
     "server.sections.beta": "测试版功能（危险）",
     "server.sections.developer": "开发者",
+    "server.sections.remote_access": "远程访问",
     "server.sidecar.disable": "永久禁用设置服务器",
     "server.sidecar.disable_title": "永久禁用设置界面：停止此服务器，并写入 ~/.ha-mcp/settings_ui_disabled，使其在 ha-mcp 将来的启动时不再自动启动。删除该文件即可重新启用。",
     "backups.loading": "正在加载备份状态…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "自定义路径当前不可用。",
     "filesystem.custom.save": "保存路径",
     "filesystem.custom.saved_rejected": "已保存。被拒绝（被阻止或无效）：{paths}",
+    "oauth_callbacks.title": "允许的 OAuth 回调 URL",
+    "oauth_callbacks.help": "当身份验证模式为机密 webhook URL 时，使用 OAuth 登录的客户端仅会被重定向回此列表中的回调 URL；任何其他回调都将被拒绝，并显示一个解释如何添加它的页面。每行输入一个 URL，必须与客户端发送的完全一致。<code>http://</code> 回环回调（127.0.0.1、[::1] 或 localhost）也匹配任意端口。仅通过 webhook URL 连接的客户端不需要在此条目中添加。更改将在下次登录时生效，无需重启。",
+    "oauth_callbacks.default": "默认列表：{urls}",
+    "oauth_callbacks.inactive": "当前未在使用：此列表仅在启用远程访问且身份验证模式为机密 webhook URL 时生效。",
+    "oauth_callbacks.save": "保存回调",
+    "oauth_callbacks.reset": "恢复默认",
+    "oauth_callbacks.invalid": "未保存。这些是无效的回调 URL：{urls}。请使用 https://，或在 127.0.0.1、[::1] 或 localhost 上使用 http://，且不能包含用户名、密码或 #fragment。",
+    "oauth_callbacks.saved": "已保存。将在下次登录时生效。",
+    "oauth_callbacks.load_failed": "无法加载回调列表（HTTP {status}）。请重新加载页面以重试。",
+    "oauth_callbacks.load_error": "无法加载回调列表：请求失败。请重新加载页面以重试。",
     "origins.env_locked": "通过环境变量设置；取消它才能在此编辑。",
     "origins.addon_synced": "已同步至应用（附加组件）配置标签页。保存后需要重启。",
     "origins.env_var_unset": "通过环境变量 {variable} 设置；取消它才能在此编辑。",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/settings_ui/locales/zh-Hant.json

@@ -47,6 +47,7 @@
     "server.sections.sidecar": "設定 UI sidecar",
     "server.sections.beta": "測試版功能（具風險）",
     "server.sections.developer": "開發人員",
+    "server.sections.remote_access": "遠端存取",
     "server.sidecar.disable": "永久停用設定伺服器",
     "server.sidecar.disable_title": "永久停用設定 UI：停止此伺服器並寫入 ~/.ha-mcp/settings_ui_disabled，以便在未來的 ha-mcp 啟動時不會重新衍生。刪除該檔案以重新啟用。",
     "backups.loading": "正在載入備份狀態…",
@@ -329,6 +330,16 @@
     "filesystem.custom.unavailable": "自訂路徑目前無法使用。",
     "filesystem.custom.save": "儲存路徑",
     "filesystem.custom.saved_rejected": "已儲存。已拒絕（遭封鎖或無效）：{paths}",
+    "oauth_callbacks.title": "允許的 OAuth 回呼 URL",
+    "oauth_callbacks.help": "當驗證模式為秘密 webhook URL 時，透過 OAuth 登入的用戶端只會被導回此清單上的回呼 URL；任何其他回呼都會被拒絕，並顯示說明如何新增的頁面。每行輸入一個 URL，必須與用戶端傳送的完全一致。<code>http://</code> 迴圈回呼（127.0.0.1、[::1] 或 localhost）也適用於任何連接埠。僅使用 webhook URL 連線的用戶端不需要條目。變更會在下次登入時生效，無需重新啟動。",
+    "oauth_callbacks.default": "預設清單：{urls}",
+    "oauth_callbacks.inactive": "目前未使用：此清單僅在遠端存取開啟且驗證模式為秘密 webhook URL 時生效。",
+    "oauth_callbacks.save": "儲存回呼",
+    "oauth_callbacks.reset": "恢復預設值",
+    "oauth_callbacks.invalid": "未儲存。這些是無法使用的回呼 URL：{urls}。請使用 https://，或在 127.0.0.1、[::1] 或 localhost 上使用 http://，且不得包含使用者名稱、密碼或 #fragment。",
+    "oauth_callbacks.saved": "已儲存。將於下次登入時生效。",
+    "oauth_callbacks.load_failed": "無法載入回呼清單（HTTP {status}）。請重新載入頁面以重試。",
+    "oauth_callbacks.load_error": "無法載入回呼清單：要求失敗。請重新載入頁面以重試。",
     "origins.env_locked": "透過環境變數設定；取消設定即可在此處編輯。",
     "origins.addon_synced": "已同步至應用程式 (add-on) 的「設定」分頁。儲存後需要重新啟動。",
     "origins.env_var_unset": "透過環境變數 {variable} 設定；取消設定即可在此處編輯。",

{ha_mcp_dev-9.0.0.dev3101 → ha_mcp_dev-9.0.0.dev3108}/src/ha_mcp/tools/component_api.py

@@ -19,6 +19,10 @@ or somewhere in between. This module negotiates that with a single cached
   surface entirely; caps are cached as ``None`` and every consumer falls back
   to its legacy path.
 
+``read_info`` reads ``info`` fresh for callers that show a field which can
+change while the client lives (the bug report's component version and webhook
+auth mode); routing and gating keep using the snapshot.
+
 This mirrors the caller-token cache in ``tools_filesystem.py``: weak-keyed by
 client so multi-client / OAuth setups each negotiate independently and the
 entry self-evicts when a client is garbage-collected.
@@ -45,6 +49,8 @@ logger = logging.getLogger(__name__)
 # The WS command every 1.1.0+ component registers; probing it does double duty
 # (existence check + capability enumeration — see module docstring).
 INFO_COMMAND = "ha_mcp_tools/info"
+# The ``result`` of an ``info`` call, as ``read_info`` returns it.
+InfoResult = dict[str, Any]
 
 # HA's structured error code for a command no handler is registered for. Routing
 # keys off this (via the ``code`` attribute threaded onto
@@ -406,3 +412,61 @@ def invalidate_caps(client: Any) -> None:
     _CAPS_CACHE.pop(client, None)
     _NEGATIVE_CACHE_TS.pop(client, None)
     _TRANSIENT_NEGATIVE_TS.pop(client, None)
+
+
+async def read_info(client: Any) -> InfoResult | None:
+    """The ``result`` of a fresh ``ha_mcp_tools/info`` call (#2584).
+
+    For callers that show a field which can change while the client lives:
+    the bug report's component version and webhook auth mode. Routing and
+    gating keep the ``get_component_caps`` snapshot, which lasts as long as the
+    client (for a server running outside HA, an HA restart does not end it),
+    while a component update changes the version and an options change the
+    mode. Only a component whose ``info`` the snapshot accepted is asked. The
+    call goes to ``send_command`` on the pooled WebSocket directly, as the
+    probe does, bypassing ``send_websocket_message``'s ERROR log (a report
+    quotes its log sections); an ``unknown_command`` drops the snapshot so the
+    next caller re-probes. None in that case and on any failure.
+    """
+    if await get_component_caps(client) is None:
+        return None
+    try:
+        ws = await get_websocket_client(
+            url=client.base_url,
+            token=client.token,
+            verify_ssl=getattr(client, "verify_ssl", None),
+        )
+        response = await ws.send_command(INFO_COMMAND)
+    except Exception as e:  # noqa: BLE001
+        if is_unknown_command(e):
+            invalidate_caps(client)
+        logger.info("Fresh %s read failed: %s (%s)", INFO_COMMAND, e, type(e).__name__)
+        return None
+    result = response.get("result") if isinstance(response, dict) else None
+    return result if isinstance(result, dict) else None
+
+
+async def read_component_version(client: Any, info: InfoResult | None) -> str | None:
+    """The component version for a report: from ``info``, else the snapshot's.
+
+    ``info`` is a ``read_info`` result. When that read failed, the snapshot
+    still shows the component is installed. After an ``unknown_command``,
+    ``read_info`` has dropped the snapshot, so the re-probe normally finds no
+    ``info`` either and the result is None. ``""`` when the component reports no
+    version; None only when there is no usable ``info``.
+    """
+    if info is not None:
+        return str(info.get("component_version") or "")
+    caps = await get_component_caps(client)
+    return caps.component_version if caps is not None else None
+
+
+def webhook_auth(info: InfoResult | None) -> str | None:
+    """The server entry's webhook auth mode from a ``read_info`` result.
+
+    Python None, not the ``"none"`` mode: without ``info``, or when its
+    ``webhook_auth`` is missing (an older component) or not a string. The
+    component sends None without a running in-process server.
+    """
+    auth = info.get("webhook_auth") if info else None
+    return auth if isinstance(auth, str) else None

ha_mcp_dev-9.0.0.dev3108/src/ha_mcp/tools/server_version.py

@@ -0,0 +1,77 @@
+"""The running ha-mcp version against the one installed on disk.
+
+``__version__`` is frozen when the process first imports ha_mcp, so after an
+in-place update the running process keeps reporting the old version while the
+disk already carries the new one. Reporting both turns a "which server am I
+talking to" hunt into a single tool call.
+"""
+
+from __future__ import annotations
+
+import importlib
+import logging
+from typing import Any
+
+from ha_mcp import __version__
+
+from .._version import get_version, is_dev_version, is_embedded
+
+logger = logging.getLogger(__name__)
+
+
+def detect_installed_version() -> str | None:
+    """Return the installed ha-mcp version as ``get_version`` resolves it now.
+
+    That is the package metadata on disk, or ``HA_MCP_BUILD_VERSION`` when set.
+    None when it cannot be read.
+    """
+    try:
+        importlib.invalidate_caches()
+    except KeyError as e:
+        # Python 3.14 with an editable homeassistant install (the official
+        # container image, where the in-process server runs) raises here
+        # (#1891); a read without the refresh still beats none.
+        logger.warning("importlib.invalidate_caches() failed: %s", e)
+    try:
+        version = get_version()
+    except Exception as e:  # noqa: BLE001
+        logger.info("Installed-version probe failed: %s", e)
+        return None
+    return None if version == "unknown" else version
+
+
+def version_mismatch(installed: str | None) -> bool:
+    """True when ``installed`` is not the version this process imported.
+
+    A failed probe (None) is no mismatch.
+    """
+    return bool(installed and installed != __version__)
+
+
+def running_version_report() -> tuple[dict[str, Any], list[str]]:
+    """``info``'s version fields, and a warning when they disagree or the
+    installed version cannot be read.
+
+    ``server_version`` is the running one. In-process the hint names a Home
+    Assistant restart, as the component's own staleness warning does.
+    """
+    installed = detect_installed_version()
+    mismatch = version_mismatch(installed)
+    fields = {
+        "server_version": __version__,
+        "installed_version": installed,
+        "version_mismatch": mismatch,
+        "is_dev_build": is_dev_version(__version__),
+    }
+    if installed is None:
+        return fields, [
+            "Could not read the installed server version; the running and "
+            "installed versions were not compared."
+        ]
+    if not mismatch:
+        return fields, []
+    restart = "Home Assistant" if is_embedded() else "the server"
+    return fields, [
+        f"Running {__version__}, but {installed} is installed; restart "
+        f"{restart} to finish applying the update."
+    ]