ha-mcp-dev 8.2.0.dev2307__tar.gz → 8.2.0.dev2311__tar.gz

{ha_mcp_dev-8.2.0.dev2307/src/ha_mcp_dev.egg-info → ha_mcp_dev-8.2.0.dev2311}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.2.0.dev2307"
+version = "8.2.0.dev2311"
 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.dev2307 → ha_mcp_dev-8.2.0.dev2311}/src/ha_mcp/settings_ui/locales/de.json

@@ -492,7 +492,7 @@
   "tools": {
     "ha_bulk_control": {
       "title": "Massensteuerung",
-      "description": "Steuert mehrere Geräte in einer einzigen Massenoperation."
+      "description": "Steuere mehrere Geräte mit Unterstützung für Massenoperationen und WebSocket-Verfolgung."
     },
     "ha_call_event": {
       "title": "Ereignis aufrufen",
@@ -568,7 +568,7 @@
     },
     "ha_config_remove_group": {
       "title": "Gruppe entfernen",
-      "description": "Entfernt eine Home-Assistant-Entitätsgruppe."
+      "description": "Entferne eine dienstbasierte Home Assistant Entitätsgruppe über den Dienst group.remove."
     },
     "ha_config_remove_label": {
       "title": "Label entfernen",
@@ -604,7 +604,7 @@
     },
     "ha_config_set_group": {
       "title": "Gruppe erstellen/aktualisieren",
-      "description": "Erstellt oder aktualisiert eine Home-Assistant-Entitätsgruppe."
+      "description": "Erstelle oder aktualisiere eine dienstbasierte Home Assistant Entitätsgruppe über den Dienst group.set."
     },
     "ha_config_set_helper": {
       "title": "Helfer erstellen/aktualisieren",
@@ -624,7 +624,7 @@
     },
     "ha_config_set_yaml": {
       "title": "Rohes YAML bearbeiten",
-      "description": "Bearbeitet die Home-Assistant-YAML-Konfiguration; nur als letztes Mittel verwenden."
+      "description": "Füge Schlüssel der obersten Ebene in configuration.yaml oder Paketdateien hinzu, ersetze oder entferne sie."
     },
     "ha_delete_file": {
       "title": "Datei löschen",
@@ -663,8 +663,8 @@
       "description": "Ruft gerenderte Bilder einer Lovelace-Ansicht ab."
     },
     "ha_get_device": {
-      "title": "Gerät abrufen",
-      "description": "Ruft Geräteinformationen ab, einschließlich Zigbee, Z-Wave und Matter."
+      "title": "Gerät abrufen (inkl. Zigbee/ZHA/Z2M, Z-Wave und Matter)",
+      "description": "Rufe Geräteinformationen mit Paginierung ab, einschließlich Zigbee (ZHA/Z2M) und Z-Wave JS Geräten."
     },
     "ha_get_entity": {
       "title": "Entität abrufen",
@@ -692,7 +692,7 @@
     },
     "ha_get_operation_status": {
       "title": "Operationsstatus",
-      "description": "Prüft den Status einer oder mehrerer Geräteoperationen."
+      "description": "Rufe den Status einer oder mehrerer Geräteoperationen mit Echtzeit-WebSocket-Verifizierung ab."
     },
     "ha_get_overview": {
       "title": "System-Übersicht",

{ha_mcp_dev-8.2.0.dev2307 → ha_mcp_dev-8.2.0.dev2311}/src/ha_mcp/settings_ui/locales/es.json

@@ -624,7 +624,7 @@
     },
     "ha_config_set_yaml": {
       "title": "Edición directa de configuración YAML",
-      "description": "Actualiza la configuración YAML en bruto de configuration.yaml, packages/*.yaml o themes/*.yaml (ÚLTIMO RECURSO)."
+      "description": "Añadir, reemplazar o eliminar claves de nivel superior en configuration.yaml o archivos de paquete."
     },
     "ha_delete_file": {
       "title": "Eliminar archivo",

{ha_mcp_dev-8.2.0.dev2307 → ha_mcp_dev-8.2.0.dev2311}/src/ha_mcp/settings_ui/locales/fr.json

@@ -492,7 +492,7 @@
   "tools": {
     "ha_bulk_control": {
       "title": "Contrôle groupé",
-      "description": "Contrôle plusieurs appareils en une seule opération groupée."
+      "description": "Contrôler plusieurs appareils avec prise en charge des opérations en masse et suivi WebSocket."
     },
     "ha_call_event": {
       "title": "Déclencher un événement",
@@ -568,7 +568,7 @@
     },
     "ha_config_remove_group": {
       "title": "Supprimer le groupe",
-      "description": "Supprime un groupe d'entités Home Assistant."
+      "description": "Supprimer un groupe d'entités Home Assistant basé sur un service via le service group.remove."
     },
     "ha_config_remove_label": {
       "title": "Supprimer l'étiquette",
@@ -604,7 +604,7 @@
     },
     "ha_config_set_group": {
       "title": "Créer/mettre à jour le groupe",
-      "description": "Crée ou met à jour un groupe d'entités Home Assistant."
+      "description": "Créer ou mettre à jour un groupe d'entités Home Assistant basé sur un service via le service group.set."
     },
     "ha_config_set_helper": {
       "title": "Créer/mettre à jour l'assistant",
@@ -624,7 +624,7 @@
     },
     "ha_config_set_yaml": {
       "title": "Modifier le YAML brut",
-      "description": "Modifie la configuration YAML de Home Assistant ; à utiliser uniquement en dernier recours."
+      "description": "Ajouter, remplacer ou supprimer des clés de niveau supérieur dans configuration.yaml ou les fichiers de package."
     },
     "ha_delete_file": {
       "title": "Supprimer le fichier",
@@ -663,8 +663,8 @@
       "description": "Récupère les images rendues d'une vue Lovelace."
     },
     "ha_get_device": {
-      "title": "Obtenir l'appareil",
-      "description": "Récupère les informations sur l'appareil, y compris Zigbee, Z-Wave et Matter."
+      "title": "Obtenir un appareil (incl. Zigbee/ZHA/Z2M, Z-Wave et Matter)",
+      "description": "Obtenir les informations de l'appareil avec pagination, y compris les appareils Zigbee (ZHA/Z2M) et Z-Wave JS."
     },
     "ha_get_entity": {
       "title": "Obtenir l'entité",
@@ -692,7 +692,7 @@
     },
     "ha_get_operation_status": {
       "title": "Statut de l'opération",
-      "description": "Vérifie le statut d'une ou plusieurs opérations sur les appareils."
+      "description": "Obtenir le statut d'une ou plusieurs opérations d'appareil avec vérification WebSocket en temps réel."
     },
     "ha_get_overview": {
       "title": "Aperçu du système",

{ha_mcp_dev-8.2.0.dev2307 → ha_mcp_dev-8.2.0.dev2311}/src/ha_mcp/settings_ui/locales/it.json

@@ -114,7 +114,7 @@
     "visibility.assist.help": "Nasconde le entità non esposte all'assistente vocale Assist («conversation») di Home Assistant, rispecchiando l'elenco in Impostazioni > Assistenti vocali > Esponi. Aggiunge due letture via websocket per ogni ricerca mentre è attivo.",
     "visibility.assist.only_exposed": "Mostra solo le entità esposte ad Assist",
     "features.enable_tool_search.label": "Attiva la ricerca degli strumenti",
-    "features.enable_tool_search.help": "Sostituisce il catalogo completo degli strumenti con una scoperta basata sulla ricerca. Riduce il contesto a riposo da circa 46K a 5K token. ⚠️ NON attivarla se usi Claude in modalità Sonnet o Opus: quei modelli hanno una propria ricerca di strumenti / strumenti differiti integrata, che va in conflitto con la nostra. Per usare la ricerca di ha-mcp con Claude, disattiva prima quella integrata di Claude; altrimenti lascia questa opzione disattivata. Usala solo con LLM privi di strumenti differiti nativi (per esempio Claude Haiku, modelli locali compatibili con OpenAI) o con finestre di contesto più piccole. Gli strumenti si trovano tramite ha_search_tools e vengono eseguiti tramite proxy suddivisi per categoria (lettura/scrittura/eliminazione). Richiede il riavvio per avere effetto.",
+    "features.enable_tool_search.help": "Sostituisci il catalogo completo degli strumenti con la scoperta basata sulla ricerca. Riduce il contesto inattivo di circa il 90%, a circa 5K token. ⚠️ NON abilitare questa opzione nei client con la propria ricerca strumenti integrata / strumenti differiti (claude.ai, Claude Desktop, Claude Code) — i due livelli di ricerca entrano in conflitto, e la ricerca strumenti integrata del client è la scelta migliore in quel caso; lasciala disattivata. Se gli strumenti sono differiti dipende dalla combinazione client e modello: usa questa opzione quando la tua configurazione carica il catalogo completo in anticipo — modelli senza strumenti differiti nativi (es. Gemini, modelli locali compatibili con OpenAI, Claude Haiku), client che incorporano tutti gli schemi degli strumenti indipendentemente dal modello (es. GitHub Copilot CLI), o finestre di contesto più piccole. Alcuni modelli Codex e ChatGPT includono anche strumenti differiti — controlla direttamente il tuo client/modello per confermarne le funzionalità in modo da non lasciare questa opzione abilitata inutilmente. Gli strumenti vengono trovati tramite ha_search_tools ed eseguiti tramite proxy categorizzati (read/write/delete). Richiede un riavvio per avere effetto.",
     "features.tool_search_max_results.label": "Numero massimo di risultati della ricerca degli strumenti",
     "features.tool_search_max_results.help": "Numero massimo di strumenti restituiti da ha_search_tools quando la ricerca degli strumenti è attiva. Valori bassi (2-3) risparmiano token di contesto ma possono escludere strumenti pertinenti. Intervallo: 2-10. Richiede il riavvio.",
     "features.enable_tool_security_policies.label": "Attiva i criteri di sicurezza degli strumenti (avanzato)",
@@ -456,7 +456,7 @@
     "addon.pinned_tools.description": "Gli strumenti elencati qui restano fissati in modo bloccato: compaiono in cima alla scheda Strumenti e non possono essere sganciati dall'interfaccia web delle impostazioni senza prima togliere questa opzione. Utile in combinazione con la ricerca degli strumenti. Nomi degli strumenti separati da virgole.",
     "addon.verify_ssl.name": "Verifica il certificato TLS",
     "addon.verify_ssl.description": "Verifica il certificato TLS del server Home Assistant. Il componente aggiuntivo si collega tramite il proxy del Supervisor, quindi di norma questo non ha alcun effetto e conviene lasciarlo attivo. Disattivalo solo se hai riconfigurato il componente aggiuntivo per parlare con HA tramite un nome host HTTPS pubblico con certificato autofirmato o con nome host non corrispondente. Disattivarlo indebolisce la sicurezza del trasporto: lascialo attivo a meno che tu non sappia di averne bisogno. Richiede il riavvio per avere effetto.",
-    "addon_stable.enable_tool_search.description": "Sostituisce il catalogo completo degli strumenti con una scoperta basata sulla ricerca. Riduce il contesto a riposo da circa 46K a 5K token. ⚠️ NON attivarla se usi Claude in modalità Sonnet o Opus: quei modelli hanno una propria ricerca di strumenti / strumenti differiti integrata, che va in conflitto con la nostra. Per usare la ricerca di ha-mcp con Claude, disattiva prima quella integrata di Claude; altrimenti lascia questa opzione disattivata. Usala solo con LLM privi di strumenti differiti nativi (per esempio Claude Haiku, modelli locali compatibili con OpenAI) o con finestre di contesto più piccole. Gli strumenti si trovano tramite ha_search_tools e vengono eseguiti tramite proxy suddivisi per categoria (lettura/scrittura/eliminazione). Richiede il riavvio del componente aggiuntivo per avere effetto; poi riconnetti o aggiorna il server MCP nel tuo client di IA in modo che ricarichi l'elenco degli strumenti. Riavviare solo il componente aggiuntivo NON aggiorna l'elenco degli strumenti memorizzato nella cache del client; vale per qualsiasi impostazione modificata qui."
+    "addon_stable.enable_tool_search.description": "Sostituisci il catalogo completo degli strumenti con la scoperta basata sulla ricerca. Riduce il contesto inattivo di circa il 90%, a circa 5K token. ⚠️ NON abilitare questa opzione nei client con la propria ricerca strumenti integrata / strumenti differiti (claude.ai, Claude Desktop, Claude Code) — i due livelli di ricerca entrano in conflitto, e la ricerca strumenti integrata del client è la scelta migliore in quel caso; lasciala disattivata. Se gli strumenti sono differiti dipende dalla combinazione client e modello: usa questa opzione quando la tua configurazione carica il catalogo completo in anticipo — modelli senza strumenti differiti nativi (es. Gemini, modelli locali compatibili con OpenAI, Claude Haiku), client che incorporano tutti gli schemi degli strumenti indipendentemente dal modello (es. GitHub Copilot CLI), o finestre di contesto più piccole. Alcuni modelli Codex e ChatGPT includono anche strumenti differiti — controlla direttamente il tuo client/modello per confermarne le funzionalità in modo da non lasciare questa opzione abilitata inutilmente. Gli strumenti vengono trovati tramite ha_search_tools ed eseguiti tramite proxy categorizzati (read/write/delete). Richiede un riavvio dell'add-on per avere effetto — poi riconnettiti o aggiorna il server MCP nel tuo client di IA in modo che ricarichi l'elenco degli strumenti. Il solo riavvio dell'add-on NON aggiorna l'elenco degli strumenti memorizzato nella cache di un client; questo si applica dopo aver modificato qualsiasi impostazione qui."
   },
   "tool_groups": {
     "Add-ons": "Componenti aggiuntivi",
@@ -624,7 +624,7 @@
     },
     "ha_config_set_yaml": {
       "title": "Modifica diretta della configurazione YAML",
-      "description": "Aggiorna la configurazione YAML grezza in configuration.yaml, packages/*.yaml o themes/*.yaml (ULTIMA RISORSA)."
+      "description": "Aggiungi, sostituisci o rimuovi chiavi di primo livello in configuration.yaml o nei file di pacchetto."
     },
     "ha_delete_file": {
       "title": "Elimina un file",

{ha_mcp_dev-8.2.0.dev2307 → ha_mcp_dev-8.2.0.dev2311}/src/ha_mcp/settings_ui/locales/ru.json

@@ -212,7 +212,7 @@
     "tools.badges.writes": "запись",
     "tools.badges.deletes": "удаление",
     "tools.notes.gated_disabled": "Отключено. Включите {setting} — переключатель инструмента редактирования политик находится на вкладке «Политики безопасности инструментов» — затем перезапустите Приложение (дополнение).",
-    "tools.notes.beta_disabled": "Бета-функция. Задайте {setting} в конфигурации dev-дополнения или в соответствующей переменной среды.",
+    "tools.notes.beta_disabled": "Бета-функция. Задайте {setting} в конфигурации dev-дополнения или в соответствующей переменной среды (см. docs/beta.md).",
     "tools.notes.env_pinned": "Зафиксировано через {variable}. Снимите переменную среды, чтобы редактировать здесь.",
     "tools.notes.bps_locked": "Заблокировано, пока включён строгий режим рекомендаций. Сначала отключите его.",
     "tools.notes.read_only_off": "Выключено: активен режим только для чтения.",
@@ -492,7 +492,7 @@
   "tools": {
     "ha_bulk_control": {
       "title": "Массовое управление",
-      "description": "Управлять несколькими устройствами в одной массовой операции."
+      "description": "Управление несколькими устройствами с поддержкой массовых операций и отслеживанием через WebSocket."
     },
     "ha_call_event": {
       "title": "Вызвать событие",
@@ -568,7 +568,7 @@
     },
     "ha_config_remove_group": {
       "title": "Удалить группу",
-      "description": "Удалить группу сущностей Home Assistant."
+      "description": "Удалить группу сущностей Home Assistant на основе сервиса через сервис group.remove."
     },
     "ha_config_remove_label": {
       "title": "Удалить метку",
@@ -604,7 +604,7 @@
     },
     "ha_config_set_group": {
       "title": "Создать или изменить группу",
-      "description": "Создать или обновить группу сущностей Home Assistant."
+      "description": "Создать или обновить группу сущностей Home Assistant на основе сервиса через сервис group.set."
     },
     "ha_config_set_helper": {
       "title": "Создать или изменить помощник",
@@ -624,7 +624,7 @@
     },
     "ha_config_set_yaml": {
       "title": "Изменить исходный YAML",
-      "description": "Изменить YAML-конфигурацию Home Assistant; использовать только как крайнее средство."
+      "description": "Добавить, заменить или удалить ключи верхнего уровня в configuration.yaml или файлах пакетов."
     },
     "ha_delete_file": {
       "title": "Удалить файл",
@@ -663,8 +663,8 @@
       "description": "Получить отрисованные изображения представления Lovelace."
     },
     "ha_get_device": {
-      "title": "Получить устройство",
-      "description": "Получить сведения об устройствах, включая Zigbee, Z-Wave и Matter."
+      "title": "Получить устройство (вкл. Zigbee/ZHA/Z2M, Z-Wave и Matter)",
+      "description": "Получить информацию об устройстве с пагинацией, включая устройства Zigbee (ZHA/Z2M) и Z-Wave JS."
     },
     "ha_get_entity": {
       "title": "Получить сущность",
@@ -692,7 +692,7 @@
     },
     "ha_get_operation_status": {
       "title": "Статус операции",
-      "description": "Проверить статус одной или нескольких операций устройств."
+      "description": "Получить статус одной или нескольких операций устройства с проверкой в реальном времени через WebSocket."
     },
     "ha_get_overview": {
       "title": "Обзор системы",

{ha_mcp_dev-8.2.0.dev2307 → ha_mcp_dev-8.2.0.dev2311}/src/ha_mcp/settings_ui/locales/zh-Hans.json

@@ -144,7 +144,7 @@
     "features.enable_code_mode.label": "启用自定义工具沙箱（测试版）",
     "features.enable_code_mode.help": "测试版功能。启用 ha_manage_custom_tool 工具，当没有内置工具可处理请求时，让 AI 助手在安全沙箱中创建、运行、保存和删除自定义 Python 代码。代码在隔离的解释器中运行，无文件系统或任意网络访问。沙箱代码可调用 HA REST API（api_get/api_post）、发送 WebSocket 命令（ws_send）、调用现有 MCP 工具（call_tool），或删除已保存工具（delete_saved_tool）。已保存工具默认持久化到 /data/saved_tools.json，以便在插件重启后保留，且对任何能连接的客户端可见。已知限制见 docs/beta.md。需要重启才能生效。需要上方（及 Web UI 中）的主开关“启用测试版功能”开启——否则无论此处值如何，此子开关在运行时都会被忽略。",
     "features.enable_lite_docstrings.label": "启用精简工具文档字符串（测试版）",
-    "features.enable_lite_docstrings.help": "测试版功能。将少数重型 ha-mcp 工具（自动化、脚本、场景、辅助元素、仪表盘、ha_call_service、ha_config_set_yaml）上的文档字符串替换为更短的变体，将 schema 和示例细节推迟到 ha_get_skill_guide 工具（或其 skill:// 资源）。警告：这会降低空闲 token 用量，但可能降低 LLM 表现——精简后的描述依赖 LLM 实际调用技能工具或读取技能资源来获取细节，这并不保证（某些模型会跳过额外的工具调用，最终得到的指引反而比之前更少）。最好与支持 MCP 资源的客户端或启用工具搜索搭配使用。需要重启才能生效。需要上方（及 Web UI 中）的主开关“启用测试版功能”开启——否则无论此处值如何，此子开关在运行时都会被忽略。",
+    "features.enable_lite_docstrings.help": "测试版功能。将少数重型 ha-mcp 工具（自动化、脚本、场景、辅助元素、仪表盘、ha_call_service、ha_config_set_yaml）上的文档字符串替换为更短的变体，将 schema 和示例细节推迟到 ha_get_skill_guide 工具（或其 skill:// 资源）。警告：这会降低空闲 token 用量，但可能降低 LLM 表现——精简后的描述依赖 LLM 实际调用技能工具或读取技能资源来获取细节，这并不保证（某些模型会跳过额外的工具调用，最终得到的指引反而比之前更少）。最好与支持 MCP 资源的客户端或 enable_tool_search 搭配使用。需要重启才能生效。需要上方（及 Web UI 中）的主开关“启用测试版功能”开启——否则无论此处值如何，此子开关在运行时都会被忽略。",
     "features.enable_dashboard_screenshot.label": "启用仪表盘截图模式（测试版）",
     "features.enable_dashboard_screenshot.help": "测试版功能——默认关闭。新增 ha_get_dashboard_screenshot 工具，以及仪表盘 get/set 工具上的 include_screenshot / return_screenshot 选项，让 AI 助手可检查一个或多个响应式 Lovelace 图像（例如验证其刚创建的仪表盘）。支持稳定的命名视图、移动/平板/桌面批次，以及 PNG/JPEG/WebP/BMP 输出。渲染在独立的、可选引擎中运行——balloob 的“Puppet”插件（无头 Chromium）——您安装一次（添加 balloob 的插件仓库，然后安装“Puppet”）并为其提供长期访问令牌；在 Docker/容器部署中，您将该引擎作为 sidecar 运行并设置 HAMCP_DASHBOARD_SCREENSHOT_ENGINE_URL。除非您同时启用此功能并安装引擎，否则不会安装任何重型组件。需要重启才能生效。需要上方（及 Web UI 中）的主开关“启用测试版功能”开启——否则无论此处值如何，此子开关在运行时都会被忽略。",
     "actions.restart_server": "重启 HA-MCP 服务器",
@@ -624,7 +624,7 @@
     },
     "ha_config_set_yaml": {
       "title": "原始 YAML 配置编辑",
-      "description": "更新 configuration.yaml、packages/*.yaml 或 themes/*.yaml 中的原始 YAML 配置（最后手段）。"
+      "description": "添加、替换或移除 configuration.yaml 或包文件中的顶级键。"
     },
     "ha_delete_file": {
       "title": "删除文件",

{ha_mcp_dev-8.2.0.dev2307 → ha_mcp_dev-8.2.0.dev2311/src/ha_mcp_dev.egg-info}/PKG-INFO

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