ha-mcp-dev 8.2.0.dev2321__tar.gz → 8.2.0.dev2326__tar.gz

{ha_mcp_dev-8.2.0.dev2321/src/ha_mcp_dev.egg-info → ha_mcp_dev-8.2.0.dev2326}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.2.0.dev2321"
+version = "8.2.0.dev2326"
 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.dev2321 → ha_mcp_dev-8.2.0.dev2326}/src/ha_mcp/client/rest_client.py

@@ -40,6 +40,10 @@ logger = logging.getLogger(__name__)
 # so the request did not execute and retrying is safe even for writes.
 _RETRYABLE_STATUS = frozenset({502, 503, 504})
 _MAX_REQUEST_ATTEMPTS = 3
+# Journald window requested for the Core error log on Supervisor-backed
+# installs. Both such branches of get_error_log() build their request from this
+# constant, so the window they ask for cannot drift apart.
+_ERROR_LOG_LINES = 20000
 
 
 class HomeAssistantError(Exception):
@@ -586,7 +590,11 @@ class HomeAssistantClient:
         """
         if is_running_in_addon():
             logger.debug("Fetching error log via Supervisor direct (core service)")
-            return await self._supervisor_logs_get("core")
+            # An explicit `lines` is required: without it Supervisor applies its
+            # 100-line default, which is far too short a slice to tell what keeps
+            # repeating. `_get_supervisor_log` plumbs the same parameter for the
+            # same reason (#1734).
+            return await self._supervisor_logs_get("core", lines=_ERROR_LOG_LINES)
 
         if await self._is_supervised_install():
             logger.debug(
@@ -594,7 +602,7 @@ class HomeAssistantClient:
             )
             raw_response = await self._raw_request(
                 "GET",
-                "/hassio/core/logs?lines=20000",
+                f"/hassio/core/logs?lines={_ERROR_LOG_LINES}",
                 headers={"Accept": "text/plain"},
             )
             return raw_response.text
@@ -619,11 +627,21 @@ class HomeAssistantClient:
         glitch or HTTP error returns False without setting the cache,
         so the next call re-probes. This is the only path that
         intentionally fails open — caller proceeds on the historical
-        Container branch (which on HAOS will also fail, but with a
-        clearer 404 than a probe-side exception would surface).
-
-        Auth / connection / HTTP errors are caught explicitly; runtime
-        bugs (TypeError, AttributeError) and BaseException derivatives
+        Container branch.
+
+        A 401 is deliberately excluded from that fail-open: it is a
+        definitive answer about the credential rather than a transient
+        glitch, and swallowing it strands exactly the install class this
+        probe exists for. Failing open sends a Supervised caller down
+        the Container branch to ``/api/error_log``, which HA Core never
+        registers under ``SUPERVISOR`` (see ``get_error_log``), so the
+        auth failure resurfaces as a 404 and the caller answers with
+        connection advice instead of "re-create the LLAT". Letting
+        ``HomeAssistantAuthError`` propagate reaches the auth handler
+        directly. Transport / HTTP fail-open is unchanged.
+
+        Connection / HTTP errors are caught explicitly; runtime bugs
+        (TypeError, AttributeError) and BaseException derivatives
         (KeyboardInterrupt, CancelledError) deliberately propagate so
         they're not silenced as "not supervised".
         """
@@ -632,16 +650,17 @@ class HomeAssistantClient:
         try:
             config = await self._request("GET", "/config")
         except (
-            HomeAssistantAuthError,
             HomeAssistantAPIError,
             HomeAssistantConnectionError,
             httpx.HTTPError,
             TimeoutError,
         ) as exc:
-            # Fail-open on transport / HTTP-layer failures only. Note:
-            # a 401 here likely means the LLA is bad and the /error_log
-            # fallback will also 401 — the user gets a clearer auth error
-            # from that path than a swallowed probe error would surface.
+            # Fail-open on transport / HTTP-layer failures only.
+            # HomeAssistantAuthError is deliberately absent: a 401 is a
+            # definitive verdict on the credential, and failing open on
+            # it routes a Supervised caller to /api/error_log — a route
+            # that does not exist there — turning the auth error into a
+            # 404 (see the docstring).
             # Logged at WARNING so it's visible at default log levels
             # without spamming on every call (probe runs at most once
             # per session per outcome).

{ha_mcp_dev-8.2.0.dev2321 → ha_mcp_dev-8.2.0.dev2326}/src/ha_mcp/settings_ui/locales/de.json

@@ -128,7 +128,7 @@
     "features.enable_strict_mandatory_bps.label": "Strikter Best-Practices-Modus",
     "features.enable_strict_mandatory_bps.help": "Strikter Modus: verhindert, dass der Client das Tool verwendet, bis er nachweisen kann, dass er die Best Practices gelesen hat. Während er eingeschaltet ist, werden die sechs Best-Practice-Schreibtools (Automatisierungen, Skripte, Szenen, Helfer, Dashboards, rohes YAML) blockiert und geben einen Fehler zurück, der den Client anweist, das Best-Practices-Skill über ha_get_skill_guide zu lesen und den dort erhaltenen Bestätigungsschlüssel zurückzugeben. Während er eingeschaltet ist, ist das ha_get_skill_guide-Tool gesperrt aktiviert – es ist der einzige Herausgeber des Bestätigungsschlüssels. Kind der Option Best-Practice-Skills bei Schreibvorgängen anhängen oben und inert, während dieser Elternteil ausgeschaltet ist. Erfordert Neustart, um wirksam zu werden.",
     "features.enable_beta_features.label": "Beta-Funktionen aktivieren (Master)",
-    "features.enable_beta_features.help": "⚠ GEFAHR – diese Tools können deine Home-Assistant-Installation DAUERHAFT BESCHÄDIGEN. Sie schreiben in deine YAML-Konfiguration, dein Dateisystem, installieren benutzerdefinierte Komponenten, führen beliebigen sandboxed Python aus und bearbeiten Tool-Docstrings, die die KI sieht. Es gibt keine Garantie und keine Support-Garantie – du aktivierst sie auf EIGENES RISIKO. Erstelle ein Home-Assistant-Backup, bevor du dies einschaltest, und aktiviere es niemals in der Produktion ohne eines. Master-Gate für die 5 experimentellen Unter-Flags unten; Unter-Flags werden zur Laufzeit ignoriert, während dieser Master ausgeschaltet ist, selbst wenn sie explizit auf true gesetzt sind. Derselbe Schalter wird auch in der Web-Einstellungs-UI unter Beta-Funktionen (gefährlich) angezeigt – beide Ansichten spiegeln sich nach dem Neustart wider.",
+    "features.enable_beta_features.help": "⚠ GEFAHR — diese Tools können deine Home Assistant-Installation DAUERHAFT BESCHÄDIGEN. Sie schreiben in deine YAML-Konfiguration, dein Dateisystem, installieren benutzerdefinierte Komponenten, führen beliebigen sandboxed Python-Code aus und bearbeiten Tool-Docstrings, die die KI sieht. Es gibt keine Garantie und keine Support-Zusage — du aktivierst sie auf EIGENES RISIKO. Erstelle ein Home Assistant-Backup, bevor du dies aktivierst, und aktiviere es niemals in der Produktion ohne eines. Hauptschalter für die experimentellen Unter-Flags unten; Unter-Flags werden zur Laufzeit ignoriert, solange dieser Hauptschalter ausgeschaltet ist, selbst wenn sie explizit auf true gesetzt sind. Derselbe Schalter wird auch in der Web-Einstellungen-UI unter \"Beta-Funktionen (gefährlich)\" angezeigt — beide Oberflächen spiegeln sich beim Neustart wider.",
     "features.enable_yaml_config_editing.label": "YAML-Konfigurations-Bearbeitung aktivieren (Beta)",
     "features.enable_yaml_config_editing.help": "Beta-Funktion. Ermöglicht KI-Assistenten, Schlüssel der obersten Ebene in configuration.yaml und packages/*.yaml hinzuzufügen, zu ersetzen oder zu entfernen. Nur auf die Whitelist gesetzte Schlüssel sind erlaubt (z. B. template, sensor, command_line, mqtt, knx); Kernschlüssel wie homeassistant, http und recorder sind blockiert. Jede Bearbeitung validiert YAML-Syntax, führt eine Konfigurationsprüfung durch und erstellt ein automatisches Backup. Änderungen an den meisten Schlüsseln erfordern einen vollständigen HA-Neustart, um wirksam zu werden. Siehe docs/beta.md für bekannte Einschränkungen. Dedizierte Tools (Automatisierungen, Skripte, Szenen, Helfer, Template-Sensoren) sollten bevorzugt werden, wenn verfügbar. ERFORDERT, dass der Master-Schalter Beta-Funktionen aktivieren oben (und in der Web-UI) eingeschaltet ist – andernfalls wird dieses Unter-Flag zur Laufzeit ignoriert, unabhängig von seinem Wert hier.",
     "features.enable_yaml_edit_confirm.label": "Bestätigung für YAML-Bearbeitungen erfordern (Diff-Vorschau)",
@@ -441,7 +441,7 @@
     "addon.enable_security_policy_tool.name": "KI-Agenten erlauben, Tool-Sicherheitsrichtlinien zu bearbeiten",
     "addon.enable_security_policy_tool.description": "Registriert das Tool ha_manage_security_policy, das verbundenen KI-Agenten erlaubt, die Tool-Sicherheitsrichtlinien zu lesen und neu zu schreiben — einschließlich des Entfernens von Genehmigungsschranken. Standardmäßig deaktiviert. Unabhängig von der Option „Tool-Sicherheitsrichtlinien“ oben: Dies steuert, wer die Regeln bearbeiten kann, nicht ob sie erzwungen werden. Das Tool kann ausstehende Genehmigungen nicht sehen oder entscheiden. Um einen Menschen in der Schleife zu halten, schütze das Tool, bevor du es aktivierst: Aktiviere „security gated“ für „Manage Security Policy“ auf dem Tab „Tools“ der Web-UI. Erfordert einen Neustart, um wirksam zu werden.",
     "addon.enable_auto_backup.name": "Auto-Backup von Bearbeitungen aktivieren",
-    "addon.enable_auto_backup.description": "Erfasst einen Pro-Entität-Snapshot vor jedem umschlossenen Schreib/destruktiven MCP-Tool-Aufruf (Automatisierung, Skript, Szene, Helfer, Dashboard, Label, Kategorie, Gruppe, Zone, Bereich, Kalender, Todo, Entität, Integration und verwandte Remove/Delete-Tools). Snapshots werden als YAML-Dateien unter /data/ha_mcp_backups/ gespeichert (Override via HAMCP_BACKUP_DIR) und über den Backups-Tab im Web-Settings-UI oder via ha_manage_backup(scope='edits', ...) aufgelistet, wiederhergestellt oder gelöscht. Best-Effort – Fehler loggen ein WARNING, blockieren aber nie den zugrunde liegenden Schreibvorgang. Standardmäßig an; Häkchen entfernen, um auszusteigen. Erfordert Neustart, um wirksam zu werden.",
+    "addon.enable_auto_backup.description": "Erstellt einen Snapshot pro Entität vor jedem umschlossenen Schreib-/destruktiven MCP-Tool-Aufruf (Automatisierung, Skript, Szene, Helfer, Dashboard, Dashboard-Ressource, Label, Kategorie, Gruppe, Zone, Bereich, Kalender, Todo, Entität, Gerät, Integration und zugehörige Entfernungs-/Lösch-Tools). Die Auto-Backup-Drosselung begrenzt, wie oft dies geschieht: 0 (Standard) erstellt bei jedem solchen Aufruf einen Snapshot, N>0 maximal einen Snapshot pro N Minuten pro Entität. Snapshots werden als YAML-Dateien unter /data/ha_mcp_backups/ (Überschreibung über HAMCP_BACKUP_DIR) gespeichert und können über den Tab „Backups“ in der Web-Einstellungen-UI oder über ha_manage_backup(scope='edits', ...) aufgelistet, wiederhergestellt oder gelöscht werden. Für diese Domänen ist die Erfassung ein Best-Effort-Versuch — ein Fehler protokolliert eine WARNING und der Schreibvorgang wird fortgesetzt. Die Datei- und Raw-YAML-Tools sind die Ausnahme: ha_write_file, ha_delete_file und ha_config_set_yaml behandeln den Snapshot als Vorbedingung, sodass ein Schreibvorgang über sie verweigert wird, solange dies deaktiviert ist, und eine fehlgeschlagene Erfassung ihn blockiert. Standardmäßig aktiviert; Deaktivieren meldet sich von den Best-Effort-Erfassungen ab und nimmt die Datei- und Raw-YAML-Tools mit ihnen außer Betrieb. Erfordert einen Neustart, um wirksam zu werden.",
     "addon.auto_backup_throttle_minutes.name": "Auto-Backup-Drosselung (Minuten)",
     "addon.auto_backup_throttle_minutes.description": "Pro-Entität-Drosselungsfenster. 0 (Standard) erfasst einen Snapshot bei jedem umschlossenen Schreibvorgang. N>0 erfasst höchstens einen Snapshot pro N Minuten pro Entität. Bereich 0–1440.",
     "addon.auto_backup_retain_per_entity.name": "Auto-Backup-Aufbewahrung (pro Entität)",