ha-mcp-dev 7.14.2.dev2153__tar.gz → 7.14.2.dev2156__tar.gz

{ha_mcp_dev-7.14.2.dev2153/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.14.2.dev2156}/PKG-INFO

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

{ha_mcp_dev-7.14.2.dev2153 → ha_mcp_dev-7.14.2.dev2156}/pyproject.toml

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

{ha_mcp_dev-7.14.2.dev2153 → ha_mcp_dev-7.14.2.dev2156}/src/ha_mcp/settings_ui/locales/de.json

@@ -110,7 +110,7 @@
     "visibility.assist.help": "Verstecke Entitäten, die nicht für den Assist-Sprachassistenten (Konversation) von Home Assistant freigegeben sind – entsprechend der Liste Einstellungen > Sprachassistenten > Freigeben. Fügt zwei WebSocket-Lesevorgänge pro Suche hinzu, während es aktiviert ist.",
     "visibility.assist.only_exposed": "Nur für Assist freigegebene Entitäten anzeigen",
     "features.enable_tool_search.label": "Tool-Suche aktivieren",
-    "features.enable_tool_search.help": "Ersetzt den vollständigen Tool-Katalog durch suchbasierte Entdeckung. Reduziert den Leerlauf-Kontext von ~46K auf ~5K Tokens. ⚠️ Aktiviere dies NICHT, wenn du Claude im Sonnet- oder Opus-Modus verwendest - diese Modelle haben ihre eigene integrierte Tool-Suche / aufgeschobene Tools, die mit unserer kollidiert. Um die Tool-Suche von ha-mcp mit Claude zu verwenden, deaktiviere zuerst Claudes integrierte Tool-Suche; lasse dies andernfalls ausgeschaltet. Verwende dies nur mit LLMs, denen native aufgeschobene Tools fehlen (z. B. Claude Haiku, lokale OpenAI-kompatible Modelle) oder mit kleineren Kontextfenstern. Tools werden über ha_search_tools gefunden und über kategorisierte Proxys (read/write/delete) ausgeführt. Erfordert Neustart, um wirksam zu werden.",
+    "features.enable_tool_search.help": "Ersetzt den vollständigen Tool-Katalog durch suchbasierte Entdeckung. Reduziert den Leerlauf-Kontext von ~46K auf ~5K Tokens. ⚠️ Aktiviere dies NICHT, wenn du Claude im Sonnet- oder Opus-Modus verwendest – diese Modelle haben ihre eigene integrierte Tool-Suche / aufgeschobene Tools, die mit unserer kollidiert. Um die Tool-Suche von ha-mcp mit Claude zu verwenden, deaktiviere zuerst Claudes integrierte Tool-Suche; lasse dies andernfalls ausgeschaltet. Verwende dies nur mit LLMs, denen native aufgeschobene Tools fehlen (z. B. Claude Haiku, lokale OpenAI-kompatible Modelle) oder mit kleineren Kontextfenstern. Tools werden über ha_search_tools gefunden und über kategorisierte Proxys (read/write/delete) ausgeführt. Erfordert Neustart, um wirksam zu werden.",
     "features.tool_search_max_results.label": "Max. Tool-Suchergebnisse",
     "features.tool_search_max_results.help": "Maximale Anzahl von Tools, die von ha_search_tools zurückgegeben werden, wenn die Tool-Suche aktiviert ist. Niedrigere Werte (2-3) sparen Kontext-Tokens, können aber relevante Tools übersehen. Bereich: 2-10. Erfordert Neustart.",
     "features.enable_tool_security_policies.label": "Tool-Sicherheitsrichtlinien aktivieren (erweitert)",
@@ -120,11 +120,11 @@
     "features.enable_mandatory_bps.label": "Best-Practice-Skills bei Schreibvorgängen anhängen",
     "features.enable_mandatory_bps.help": "Hauptschalter für die Funktion zur Bereitstellung von Schreib-Tool-Skill-Inhalten (Issue #1182). Wenn aktiviert (Standard), fügen die sechs Konfigurations-Schreibtools (Automatisierungen, Skripte, Szenen, Helfer, Dashboards, rohes YAML) die kanonischen Home-Assistant-Best-Practice-Referenzdateien unter skill_content bei jedem erfolgreichen Schreibvorgang an, plus automatisches Einbetten aller Referenzabschnitte, die von Best-Practice-Warnungen zitiert werden. Jedes Tool stellt auch einen per-Aufruf-Parameter MandatoryBPS zur Verfügung, den der Agent bei nachfolgenden Aufrufen auf false setzen kann, sobald er den Inhalt hat. Wenn dieser Hauptschalter ausgeschaltet ist, wird KEIN skill_content ausgegeben, unabhängig vom per-Aufruf-Parameter oder BP-Warnungen. Empfohlen EIN als erste Wahl; deaktiviere nur für Modelle mit sehr kleinen Kontextfenstern. Das Ausschalten davon kann die Schreibgenauigkeit beeinträchtigen. Erfordert Neustart, um wirksam zu werden.",
     "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_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 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_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_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)",
     "features.enable_yaml_edit_confirm.help": "Unter-Toggle der YAML-Konfigurationsbearbeitung, standardmäßig EIN (empfohlen). Der erste ha_config_set_yaml-Aufruf gibt ein einheitliches Diff von genau dem zurück, was sich auf der Festplatte ändern würde, plus ein Bestätigungstoken und schreibt nichts; die Bearbeitung landet nur, wenn der Aufruf mit diesem Token wiederholt wird. Existiert, damit unbeabsichtigte Änderungen außerhalb der angeforderten Bearbeitung erfasst werden, bevor sie die Festplatte erreichen (Issue #1720). Schalte nur aus, um einen Roundtrip pro Bearbeitung zu sparen.",
     "features.enable_yaml_packages_automation.label": "automation in packages/*.yaml erlauben",
@@ -134,13 +134,13 @@
     "features.enable_yaml_packages_scene.label": "scene in packages/*.yaml erlauben",
     "features.enable_yaml_packages_scene.help": "Unter-Toggle der YAML-Konfigurationsbearbeitung. Wenn eingeschaltet, akzeptiert ha_config_set_yaml yaml_path='scene' innerhalb von packages/*.yaml. Wenn ausgeschaltet, wird der Aufruf sowohl client- als auch serverseitig abgelehnt. Das Storage-Modus-Tool (ha_config_set_scene) ist nicht betroffen. Standard AUS; wirkt nur, wenn YAML-Konfigurations-Bearbeitung aktivieren oben ebenfalls eingeschaltet ist.",
     "features.enable_filesystem_tools.label": "Dateisystem-Tools aktivieren (Beta)",
-    "features.enable_filesystem_tools.help": "Setzt HAMCP_ENABLE_FILESYSTEM_TOOLS=true. Aktiviert direkten Dateilese-/-schreibzugriff auf dein Home-Assistant-Dateisystem. WARNUNG: Dies gibt dem MCP-Server sensiblen direkten Dateizugriff auf dein System. Aktiviere nur, wenn du dem KI-Assistenten bei Dateioperationen vertraust. Erfordert Neustart, um wirksam zu werden. 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_filesystem_tools.help": "Setzt HAMCP_ENABLE_FILESYSTEM_TOOLS=true. Aktiviert direkten Dateilese-/-schreibzugriff auf dein Home-Assistant-Dateisystem. WARNUNG: Dies gibt dem MCP-Server sensiblen direkten Dateizugriff auf dein System. Aktiviere nur, wenn du dem KI-Assistenten bei Dateioperationen vertraust. Erfordert Neustart, um wirksam zu werden. 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_code_mode.label": "Benutzerdefinierte Tool-Sandbox aktivieren (Beta)",
-    "features.enable_code_mode.help": "Beta-Funktion. Aktiviert das ha_manage_custom_tool-Tool, das KI-Assistenten ermöglicht, benutzerdefinierten Python-Code in einer sicheren Sandbox zu erstellen, auszuführen, zu speichern und zu löschen, wenn kein integriertes Tool die Anfrage bearbeiten kann. Code wird in einem isolierten Interpreter ohne Dateisystem- oder beliebigen Netzwerkzugriff ausgeführt. Sandbox-Code kann die HA REST API treffen (api_get/api_post), WebSocket-Befehle senden (ws_send), vorhandene MCP-Tools aufrufen (call_tool) oder ein gespeichertes Tool entfernen (delete_saved_tool). Gespeicherte Tools werden standardmäßig in /data/saved_tools.json gespeichert, sodass sie Add-on-Neustarts überstehen und für jeden Client sichtbar sind, der sich verbinden kann. Siehe docs/beta.md für bekannte Einschränkungen. Erfordert Neustart, um wirksam zu werden. 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_code_mode.help": "Beta-Funktion. Aktiviert das ha_manage_custom_tool-Tool, das KI-Assistenten ermöglicht, benutzerdefinierten Python-Code in einer sicheren Sandbox zu erstellen, auszuführen, zu speichern und zu löschen, wenn kein integriertes Tool die Anfrage bearbeiten kann. Code wird in einem isolierten Interpreter ohne Dateisystem- oder beliebigen Netzwerkzugriff ausgeführt. Sandbox-Code kann die HA REST API treffen (api_get/api_post), WebSocket-Befehle senden (ws_send), vorhandene MCP-Tools aufrufen (call_tool) oder ein gespeichertes Tool entfernen (delete_saved_tool). Gespeicherte Tools werden standardmäßig in /data/saved_tools.json gespeichert, sodass sie Add-on-Neustarts überstehen und für jeden Client sichtbar sind, der sich verbinden kann. Siehe docs/beta.md für bekannte Einschränkungen. Erfordert Neustart, um wirksam zu werden. 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_lite_docstrings.label": "Lite-Tool-Docstrings aktivieren (Beta)",
-    "features.enable_lite_docstrings.help": "Beta-Funktion. Ersetzt die Docstrings auf einer Handvoll schwerer ha-mcp-Tools (Automatisierungen, Skripte, Szenen, Helfer, Dashboards, ha_call_service, ha_config_set_yaml) durch kürzere Varianten, die Schema- und Beispieldetails auf das ha_get_skill_guide-Tool (oder seine skill://-Ressource) verschieben. WARNUNG: Dies reduziert die Leerlauf-Token-Nutzung, kann aber die LLM-Leistung beeinträchtigen - die gekürzten Beschreibungen verlassen sich darauf, dass das LLM tatsächlich das Skill-Tool aufruft oder die Skill-Ressource für Details liest, was nicht garantiert ist (einige Modelle überspringen den zusätzlichen Tool-Aufruf und haben am Ende weniger Anleitung als zuvor). Am besten mit einem Client gepaart, der MCP-Ressourcen unterstützt, oder mit enable_tool_search. Erfordert Neustart, um wirksam zu werden. 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_lite_docstrings.help": "Beta-Funktion. Ersetzt die Docstrings auf einer Handvoll schwerer ha-mcp-Tools (Automatisierungen, Skripte, Szenen, Helfer, Dashboards, ha_call_service, ha_config_set_yaml) durch kürzere Varianten, die Schema- und Beispieldetails auf das ha_get_skill_guide-Tool (oder seine skill://-Ressource) verschieben. WARNUNG: Dies reduziert die Leerlauf-Token-Nutzung, kann aber die LLM-Leistung beeinträchtigen – die gekürzten Beschreibungen verlassen sich darauf, dass das LLM tatsächlich das Skill-Tool aufruft oder die Skill-Ressource für Details liest, was nicht garantiert ist (einige Modelle überspringen den zusätzlichen Tool-Aufruf und haben am Ende weniger Anleitung als zuvor). Am besten mit einem Client gepaart, der MCP-Ressourcen unterstützt, oder mit enable_tool_search. Erfordert Neustart, um wirksam zu werden. 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_dashboard_screenshot.label": "Dashboard-Screenshot-Modus aktivieren (Beta)",
-    "features.enable_dashboard_screenshot.help": "Beta-Funktion - standardmäßig deaktiviert. Fügt das ha_get_dashboard_screenshot-Tool plus include_screenshot / return_screenshot-Optionen auf den Dashboard-Get-/Set-Tools hinzu, sodass KI-Assistenten ein oder mehrere responsive Lovelace-Bilder inspizieren können (z. B. um ein Dashboard zu verifizieren, das sie gerade erstellt haben). Unterstützt stabile benannte Ansichten, Mobile-/Tablet-/Desktop-Batches und PNG-/JPEG-/WebP-/BMP-Ausgabe. Das Rendering läuft in einer separaten Opt-in-Engine - balloobs Puppet-Add-on (headless Chromium) - die du einmal installierst (füge balloobs Add-on-Repository hinzu, dann installiere Puppet) und gibst ihm ein langlebiges Zugriffstoken; bei Docker-/Container-Deployments führst du diese Engine als Sidecar aus und setzt HAMCP_DASHBOARD_SCREENSHOT_ENGINE_URL. Nichts Schweres wird installiert, es sei denn, du aktivierst dies sowohl als auch installierst die Engine. Erfordert Neustart, um wirksam zu werden. 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_dashboard_screenshot.help": "Beta-Funktion – standardmäßig deaktiviert. Fügt das ha_get_dashboard_screenshot-Tool plus include_screenshot / return_screenshot-Optionen auf den Dashboard-Get-/Set-Tools hinzu, sodass KI-Assistenten ein oder mehrere responsive Lovelace-Bilder inspizieren können (z. B. um ein Dashboard zu verifizieren, das sie gerade erstellt haben). Unterstützt stabile benannte Ansichten, Mobile-/Tablet-/Desktop-Batches und PNG-/JPEG-/WebP-/BMP-Ausgabe. Das Rendering läuft in einer separaten Opt-in-Engine – balloobs Puppet-Add-on (headless Chromium) – die du einmal installierst (füge balloobs Add-on-Repository hinzu, dann installiere Puppet) und gibst ihm ein langlebiges Zugriffstoken; bei Docker-/Container-Deployments führst du diese Engine als Sidecar aus und setzt HAMCP_DASHBOARD_SCREENSHOT_ENGINE_URL. Nichts Schweres wird installiert, es sei denn, du aktivierst dies sowohl als auch installierst die Engine. Erfordert Neustart, um wirksam zu werden. 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.",
     "actions.restart_server": "HA-MCP-Server neu starten",
     "actions.restart_confirm": "HA-MCP jetzt neu starten? Die Seite wird automatisch neu geladen, sobald der Server wieder online ist.",
     "actions.view": "Ansehen",

{ha_mcp_dev-7.14.2.dev2153 → ha_mcp_dev-7.14.2.dev2156/src/ha_mcp_dev.egg-info}/PKG-INFO

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