ha-mcp-dev 8.5.0.dev2694__tar.gz → 8.5.0.dev2699__tar.gz

{ha_mcp_dev-8.5.0.dev2694/src/ha_mcp_dev.egg-info → ha_mcp_dev-8.5.0.dev2699}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.5.0.dev2694"
+version = "8.5.0.dev2699"
 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.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/backup_manager.py

@@ -56,7 +56,7 @@ from collections import Counter
 from collections.abc import AsyncIterator, Awaitable, Callable
 from contextlib import AsyncExitStack, asynccontextmanager, suppress
 from dataclasses import dataclass, field
-from datetime import UTC, datetime
+from datetime import UTC, datetime, timedelta
 from functools import cached_property
 from pathlib import Path
 from typing import Any, Literal, NotRequired, TypedDict
@@ -65,7 +65,11 @@ import yaml  # type: ignore[import-untyped]
 
 from ha_mcp._vendor.fastmcp.exceptions import ToolError
 
-from .client.rest_client import HomeAssistantConnectionError, HomeAssistantError
+from .client.rest_client import (
+    HomeAssistantCommandError,
+    HomeAssistantConnectionError,
+    HomeAssistantError,
+)
 from .utils.data_paths import get_data_dir
 from .utils.registry_update_lock import registry_update_lock
 
@@ -2464,9 +2468,76 @@ async def _restore_group(client: Any, entity_id: str, config: Any) -> Any:
 # Calendar events — calendar.get_events to fetch, calendar.create/update services.
 
 
+# Bounds of the second sweep below: wide enough for a past event or one booked
+# well ahead, without asking a busy calendar to expand a decade of recurrences.
+_CALENDAR_WIDE_LOOKBACK_DAYS = 366
+_CALENDAR_WIDE_LOOKAHEAD_DAYS = 732
+
+
+async def _find_calendar_event(
+    client: Any,
+    cal: str,
+    uid: str,
+    recurrence_id: str | None,
+    start: datetime,
+    end: datetime,
+) -> Any:
+    """Return the event with ``uid`` on ``cal`` between ``start`` and ``end``.
+
+    Reads the REST calendar view rather than the ``calendar.get_events``
+    service: the service response is built by HA's
+    ``_list_events_dict_factory``, which keeps only ``LIST_EVENT_FIELDS``
+    (start/end/summary/description/location/status) and therefore carries no
+    ``uid`` to match on. ``/api/calendars/{entity_id}`` serialises the whole
+    CalendarEvent, so uid, recurrence_id and rrule survive — the same endpoint
+    ``ha_config_get_calendar_events`` reads.
+
+    A recurring series is expanded into occurrences that all share the ``uid``,
+    so ``recurrence_id`` selects which one; without it the first match wins.
+    """
+    try:
+        events = await client._request(
+            "GET",
+            f"/calendars/{cal}",
+            params={"start": start.isoformat(), "end": end.isoformat()},
+        )
+    except HomeAssistantError as err:
+        # Only treat 404 (calendar entity not present) as "skip silently".
+        # Auth/transport/server errors deserve a WARNING so an operator
+        # can spot a misconfigured calendar integration; matches the
+        # ``status_code == 404`` narrowing the automation/script/scene
+        # fetchers use.
+        if getattr(err, "status_code", None) == 404:
+            return None
+        raise
+    for event in _require_list(events, f"/calendars/{cal}"):
+        if not isinstance(event, dict) or event.get("uid") != uid:
+            continue
+        if recurrence_id is not None and event.get("recurrence_id") != recurrence_id:
+            continue
+        return event
+    return None
+
+
+def _recurrence_id_window(
+    recurrence_id: str | None,
+) -> tuple[datetime, datetime] | None:
+    """A day-wide window around an iCalendar recurrence id, if it parses."""
+    if not recurrence_id:
+        return None
+    for fmt in ("%Y%m%dT%H%M%S", "%Y%m%dT%H%M%SZ", "%Y%m%d"):
+        try:
+            at = datetime.strptime(recurrence_id, fmt).replace(tzinfo=UTC)
+        except ValueError:
+            continue
+        return at - timedelta(days=1), at + timedelta(days=1)
+    return None
+
+
 async def _fetch_calendar_event(client: Any, entity_id: str) -> Any:
-    # entity_id is "<calendar.entity>::<event_uid>"
-    cal, _, uid = entity_id.partition("::")
+    # entity_id is "<calendar.entity>::<event_uid>[::<recurrence_id>]"
+    cal, _, rest = entity_id.partition("::")
+    uid, _, recurrence_id = rest.partition("::")
     if not cal or not uid:
         return None
     # Configurable lookahead window. Default 7 days catches typical edits;
@@ -2482,48 +2553,186 @@ async def _fetch_calendar_event(client: Any, entity_id: str) -> Any:
     except (AttributeError, ImportError, ValueError, TypeError):
         days = 7
     days = max(1, min(365, days))
-    start = datetime.now(UTC).isoformat()
-    payload = {
-        "type": "execute_script",
-        "sequence": [
-            {
-                "service": "calendar.get_events",
-                "target": {"entity_id": cal},
-                "data": {"duration": {"days": days}, "start_date_time": start},
-                "response_variable": "events",
-            },
-            {"stop": "", "response_variable": "events"},
-        ],
-    }
-    try:
-        result = await _ws_send(client, payload)
-    except HomeAssistantError as err:
-        # Only treat 404 (calendar entity not present) as "skip silently".
-        # Auth/transport/server errors deserve a WARNING so an operator
-        # can spot a misconfigured calendar integration; matches the
-        # ``status_code == 404`` narrowing the automation/script/scene
-        # fetchers use.
-        if getattr(err, "status_code", None) == 404:
-            return None
-        raise
-    result = _require_dict(result, "execute_script")
-    events = result.get("response", {}).get("events", {}).get(cal, {}).get("events", [])
-    for ev in events:
-        if ev.get("uid") == uid:
-            return {"calendar_entity_id": cal, **ev}
+    now = datetime.now(UTC)
+    wanted = recurrence_id or None
+    # A recurrence_id names the occurrence's own date, so an occurrence far
+    # outside the windows below is still found in one request.
+    around = _recurrence_id_window(wanted)
+    found = (
+        await _find_calendar_event(client, cal, uid, wanted, *around)
+        if around
+        else None
+    )
+    if found is None:
+        found = await _find_calendar_event(
+            client, cal, uid, wanted, now, now + timedelta(days=days)
+        )
+    if found is None:
+        # The configured window is the cheap common case, not the contract: a
+        # write targets an event by uid, and an event being edited or deleted
+        # can sit in the past or well beyond the lookahead. Missing it would
+        # silently skip the snapshot and leave the prior values unrecoverable,
+        # so sweep once more over a wide window before concluding it is gone.
+        found = await _find_calendar_event(
+            client,
+            cal,
+            uid,
+            wanted,
+            now - timedelta(days=_CALENDAR_WIDE_LOOKBACK_DAYS),
+            now + timedelta(days=_CALENDAR_WIDE_LOOKAHEAD_DAYS),
+        )
+    if found is None:
+        return None
+    if wanted is None and found.get("rrule"):
+        # The write targets a whole series, but the calendar view only exposes
+        # expanded OCCURRENCES — never the master event's own start. Restoring
+        # one occurrence's values would revert a single date and leave the rest
+        # of the series edited, or re-create a series starting at the wrong
+        # date, both reported as a successful restore. No snapshot is the
+        # honest answer; a single-occurrence write (which carries a
+        # recurrence_id) is captured normally.
+        logger.warning(
+            "Auto-backup: no snapshot for series-wide write on %s (event %s); "
+            "Home Assistant exposes only expanded occurrences, so the series "
+            "could not be restored faithfully",
+            cal,
+            uid,
+        )
+        return None
+    return {"calendar_entity_id": cal, **found}
+
+
+def _calendar_bound(value: Any) -> tuple[str, bool] | None:
+    """Return ``(iso_value, is_date_only)`` for a snapshotted event boundary.
+
+    The REST view wraps each boundary as ``{"dateTime": ...}`` (timed) or
+    ``{"date": ...}`` (all-day); snapshots taken before that switch hold a
+    flat ISO string, which a 10-character length identifies as date-only.
+    """
+    if isinstance(value, dict):
+        if value.get("dateTime"):
+            return str(value["dateTime"]), False
+        if value.get("date"):
+            return str(value["date"]), True
+        return None
+    if isinstance(value, str) and value:
+        return value, len(value) == 10
     return None
 
 
+# HA reports a missing event as a plain ``failed`` command error whose message
+# comes from the integration (Local Calendar surfaces ical's "No existing item
+# with uid/recurrence_id: ..."), so absence has to be read off the message.
+_CALENDAR_EVENT_ABSENT_MARKERS = ("no existing item", "not found", "does not exist")
+
+
+def _calendar_update_cannot_apply(err: HomeAssistantCommandError) -> bool:
+    """Whether ``err`` proves the in-place update never touched the event."""
+    if getattr(err, "code", None) == "not_supported":
+        # The calendar advertises no UPDATE_EVENT, so it cannot ever accept
+        # the update and re-creating is the only restore available.
+        return True
+    message = str(err).lower()
+    return any(marker in message for marker in _CALENDAR_EVENT_ABSENT_MARKERS)
+
+
+async def _recreate_calendar_event(
+    client: Any,
+    cal: str,
+    event: dict[str, Any],
+    start: tuple[str, bool],
+    end: tuple[str, bool],
+) -> Any:
+    """Create an event that no longer exists under its snapshotted uid.
+
+    Always a single event: a series-wide write is never snapshotted (the
+    calendar view cannot describe the series), and a snapshot of one
+    occurrence must not be re-created as a series of its own.
+    """
+    data: dict[str, Any] = {"entity_id": cal, "summary": event["summary"]}
+    if start[1]:
+        data.update({"start_date": start[0], "end_date": end[0]})
+    else:
+        data.update({"start_date_time": start[0], "end_date_time": end[0]})
+    for key in ("description", "location"):
+        if event.get(key):
+            data[key] = event[key]
+    return await _rest_post(client, "services/calendar/create_event", data)
+
+
 async def _restore_calendar_event(client: Any, entity_id: str, config: Any) -> Any:
-    cal = config.get("calendar_entity_id")
-    if not cal:
-        cal = entity_id.split("::", 1)[0]
-    data = {k: v for k, v in config.items() if k != "calendar_entity_id"}
-    return await _rest_post(
-        client,
-        "services/calendar/create_event",
-        {"entity_id": cal, **data},
-    )
+    cal, _, rest = entity_id.partition("::")
+    key_uid, _, key_recurrence_id = rest.partition("::")
+    cal = config.get("calendar_entity_id") or cal
+    uid = config.get("uid") or key_uid
+    recurrence_id = config.get("recurrence_id") or key_recurrence_id or None
+    start = _calendar_bound(config.get("start"))
+    end = _calendar_bound(config.get("end"))
+    if start is None or end is None:
+        raise HomeAssistantError(
+            f"Calendar snapshot for {entity_id!r} has no usable start/end"
+        )
+
+    # Home Assistant merges the update into the stored event (ical dumps it
+    # with ``exclude_unset``), so a field left out keeps whatever the write
+    # put there. Send the text fields unconditionally — empty clears a
+    # description or location the write added.
+    event: dict[str, Any] = {
+        "summary": config.get("summary") or "",
+        "dtstart": start[0],
+        "dtend": end[0],
+        "description": config.get("description") or "",
+        "location": config.get("location") or "",
+    }
+    # ``rrule`` is deliberately never replayed. Every expanded occurrence
+    # carries the series' rule, and sending it back onto one occurrence —
+    # which ical has already forked into a plain event — would make that
+    # occurrence a second series under the same uid, duplicating every later
+    # date.
+
+    if not uid:
+        return await _recreate_calendar_event(client, cal, event, start, end)
+
+    # An edited event still exists under its uid, so put the captured values
+    # back in place instead of creating a second copy. Only a snapshot of a
+    # DELETED event (or a calendar without UPDATE_EVENT) falls through to
+    # re-creation.
+    message: dict[str, Any] = {
+        "type": "calendar/event/update",
+        "entity_id": cal,
+        "uid": uid,
+        "event": event,
+    }
+    if recurrence_id:
+        message["recurrence_id"] = recurrence_id
+    try:
+        return await _ws_send(client, message)
+    except HomeAssistantCommandError as err:
+        if not _calendar_update_cannot_apply(err):
+            # A transport drop, a timeout or an unclassified command failure
+            # leaves it unknown whether HA applied the update; re-creating
+            # then leaves a duplicate behind. Only a failure that PROVES the
+            # update never landed falls through. Connection errors and
+            # timeouts are separate types, so they never reach here at all.
+            raise
+        if recurrence_id:
+            # The occurrence is gone — deleted from the series, or the series
+            # moved and this recurrence_id no longer names one of its dates.
+            # ``create_event`` could only add a detached event next to the
+            # series, which is not the occurrence being restored, so say so
+            # instead of inventing one.
+            raise HomeAssistantError(
+                f"Occurrence {recurrence_id} of event {uid} no longer exists on "
+                f"{cal}, and an occurrence cannot be re-created into its series"
+            ) from err
+        logger.info(
+            "Restoring calendar event %s on %s in place is not possible (%s); "
+            "re-creating it instead",
+            uid,
+            cal,
+            err,
+        )
+    return await _recreate_calendar_event(client, cal, event, start, end)
 
 
 # Zones — zone/{list,update} (no ``config/`` prefix per HA's actual WS API;

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/cs.json

@@ -542,8 +542,8 @@
       "description": "Získat informace o štítku – vypsat všechny štítky nebo získat konkrétní podle ID."
     },
     "ha_config_get_scene": {
-      "title": "Získat konfiguraci scény",
-      "description": "Načíst konfiguraci scény Home Assistant."
+      "title": "Získat nebo najít scény",
+      "description": "Získejte kompletní konfiguraci scény nebo vyhledejte a seznamte scény bez scene_id."
     },
     "ha_config_get_script": {
       "title": "Získat konfiguraci skriptu",
@@ -599,7 +599,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Vytvořit nebo aktualizovat událost kalendáře",
-      "description": "Vytvořit novou událost v kalendáři."
+      "description": "Vytvořte novou událost v kalendáři nebo aktualizujte stávající."
     },
     "ha_config_set_category": {
       "title": "Vytvořit nebo aktualizovat kategorii",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/de.json

@@ -573,8 +573,8 @@
       "description": "Zeigt Labels oder Details zu einem bestimmten Label."
     },
     "ha_config_get_scene": {
-      "title": "Szene abrufen",
-      "description": "Ruft die Konfiguration einer Home-Assistant-Szene ab."
+      "title": "Szenen abrufen oder finden",
+      "description": "Vollständige Konfiguration einer Szene abrufen oder Szenen ohne scene_id auflisten und durchsuchen."
     },
     "ha_config_get_script": {
       "title": "Skript abrufen",
@@ -630,7 +630,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Kalenderereignis erstellen/aktualisieren",
-      "description": "Erstellt ein neues oder aktualisiert ein bestehendes Kalenderereignis."
+      "description": "Ein neues Ereignis in einem Kalender erstellen oder ein bestehendes aktualisieren."
     },
     "ha_config_set_category": {
       "title": "Kategorie erstellen/aktualisieren",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/eo.json

@@ -542,8 +542,8 @@
       "description": "Akiru etikedan informon - listigu ĉiujn etikedojn aŭ akiru specifan per ID."
     },
     "ha_config_get_scene": {
-      "title": "Akiri Scenan Agordon",
-      "description": "Reakiru agordon de sceno de Home Assistant."
+      "title": "Ricevi aŭ trovi scenojn",
+      "description": "Ricevi la kompletan agordon de sceno, aŭ listigi kaj serĉi scenojn sen scene_id."
     },
     "ha_config_get_script": {
       "title": "Akiri Skriptan Agordon",
@@ -599,7 +599,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Krei aŭ Ĝisdatigi Kalendaran Eventon",
-      "description": "Kreu novan eventon en kalendaro."
+      "description": "Krei novan eventon en kalendaro, aŭ ĝisdatigi ekzistantan."
     },
     "ha_config_set_category": {
       "title": "Krei aŭ Ĝisdatigi Kategorion",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/es.json

@@ -573,8 +573,8 @@
       "description": "Lista todas las etiquetas u obtiene una concreta por su ID."
     },
     "ha_config_get_scene": {
-      "title": "Obtener configuración de escena",
-      "description": "Consulta la configuración de una escena de Home Assistant."
+      "title": "Obtener o buscar escenas",
+      "description": "Obtiene la configuración completa de una escena, o lista y busca escenas sin scene_id."
     },
     "ha_config_get_script": {
       "title": "Obtener configuración de script",
@@ -630,7 +630,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Crear o actualizar evento de calendario",
-      "description": "Crea un evento nuevo en un calendario."
+      "description": "Crea un nuevo evento en un calendario o actualiza uno existente."
     },
     "ha_config_set_category": {
       "title": "Crear o actualizar categoría",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/fr.json

@@ -573,8 +573,8 @@
       "description": "Affiche les étiquettes ou les détails d'une étiquette spécifique."
     },
     "ha_config_get_scene": {
-      "title": "Obtenir la scène",
-      "description": "Récupère la configuration d'une scène Home Assistant."
+      "title": "Obtenir ou rechercher des scènes",
+      "description": "Obtenir la configuration complète d'une scène, ou lister et rechercher des scènes sans scene_id."
     },
     "ha_config_get_script": {
       "title": "Obtenir le script",
@@ -630,7 +630,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Créer/mettre à jour un événement du calendrier",
-      "description": "Crée un nouvel événement ou met à jour un événement de calendrier existant."
+      "description": "Créer un nouvel événement dans un calendrier ou mettre à jour un événement existant."
     },
     "ha_config_set_category": {
       "title": "Créer/mettre à jour la catégorie",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/it.json

@@ -573,8 +573,8 @@
       "description": "Ottiene informazioni sulle etichette: le elenca tutte o ne restituisce una specifica per ID."
     },
     "ha_config_get_scene": {
-      "title": "Ottieni la configurazione di una scena",
-      "description": "Recupera la configurazione di una scena di Home Assistant."
+      "title": "Ottieni o trova scene",
+      "description": "Ottieni la configurazione completa di una scena, oppure elenca e cerca scene senza scene_id."
     },
     "ha_config_get_script": {
       "title": "Ottieni la configurazione di uno script",
@@ -630,7 +630,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Crea o aggiorna un evento del calendario",
-      "description": "Crea un nuovo evento in un calendario."
+      "description": "Crea un nuovo evento in un calendario o aggiorna uno esistente."
     },
     "ha_config_set_category": {
       "title": "Crea o aggiorna una categoria",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/ko.json

@@ -573,8 +573,8 @@
       "description": "라벨 정보를 가져옵니다. 전체 라벨을 나열하거나 ID로 하나를 확인합니다."
     },
     "ha_config_get_scene": {
-      "title": "장면 설정 조회",
-      "description": "Home Assistant 장면 설정을 가져옵니다."
+      "title": "장면 가져오기 또는 찾기",
+      "description": "장면의 전체 구성을 가져오거나, scene_id 없이 장면을 나열하고 검색합니다."
     },
     "ha_config_get_script": {
       "title": "스크립트 설정 조회",
@@ -630,7 +630,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "캘린더 일정 생성·수정",
-      "description": "캘린더에 새 일정을 만듭니다."
+      "description": "캘린더에 새 일정을 만들거나 기존 일정을 업데이트합니다."
     },
     "ha_config_set_category": {
       "title": "카테고리 생성·수정",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/nl.json

@@ -542,8 +542,8 @@
       "description": "Haal labelinformatie op - lijst alle labels of haal een specifieke op via ID."
     },
     "ha_config_get_scene": {
-      "title": "Haal Scène Config op",
-      "description": "Haal de Home Assistant-scèneconfiguratie op."
+      "title": "Scènes ophalen of zoeken",
+      "description": "Haal de volledige configuratie van een scène op, of lijst en zoek scènes zonder scene_id."
     },
     "ha_config_get_script": {
       "title": "Haal Script Config op",
@@ -599,7 +599,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Maak of Werk Kalendergebeurtenis bij",
-      "description": "Maak een nieuwe gebeurtenis in een kalender."
+      "description": "Maak een nieuwe gebeurtenis aan in een kalender of werk een bestaande bij."
     },
     "ha_config_set_category": {
       "title": "Maak of Werk Categorie bij",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/pl.json

@@ -542,8 +542,8 @@
       "description": "Pobierz informacje o etykiecie - wyświetl wszystkie etykiety lub pobierz konkretną po ID."
     },
     "ha_config_get_scene": {
-      "title": "Pobierz konfigurację sceny",
-      "description": "Pobierz konfigurację sceny Home Assistant."
+      "title": "Pobierz lub znajdź sceny",
+      "description": "Pobierz pełną konfigurację sceny lub wyświetl listę i wyszukaj sceny bez użycia scene_id."
     },
     "ha_config_get_script": {
       "title": "Pobierz konfigurację skryptu",
@@ -599,7 +599,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Utwórz lub zaktualizuj wydarzenie w kalendarzu",
-      "description": "Utwórz nowe wydarzenie w kalendarzu."
+      "description": "Utwórz nowe wydarzenie w kalendarzu lub zaktualizuj istniejące."
     },
     "ha_config_set_category": {
       "title": "Utwórz lub zaktualizuj kategorię",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/ru.json

@@ -573,8 +573,8 @@
       "description": "Показать метки или сведения о конкретной метке."
     },
     "ha_config_get_scene": {
-      "title": "Получить сцену",
-      "description": "Получить конфигурацию сцены Home Assistant."
+      "title": "Получить или найти сцены",
+      "description": "Получить полную конфигурацию сцены либо получить список и выполнить поиск сцен без использования scene_id."
     },
     "ha_config_get_script": {
       "title": "Получить скрипт",
@@ -630,7 +630,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Создать или изменить событие",
-      "description": "Создать новое или обновить событие календаря."
+      "description": "Создать новое событие в календаре или обновить существующее."
     },
     "ha_config_set_category": {
       "title": "Создать или изменить категорию",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/sv.json

@@ -542,8 +542,8 @@
       "description": "Hämta etikettinformation - lista alla etiketter eller hämta en specifik med ID."
     },
     "ha_config_get_scene": {
-      "title": "Hämta Scenkonfiguration",
-      "description": "Hämta Home Assistant-scenkonfiguration."
+      "title": "Hämta eller hitta scener",
+      "description": "Hämta en scens kompletta konfiguration, eller lista och sök efter scener utan scene_id."
     },
     "ha_config_get_script": {
       "title": "Hämta Skriptkonfiguration",
@@ -599,7 +599,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "Skapa eller Uppdatera Kalenderhändelse",
-      "description": "Skapa en ny händelse i en kalender."
+      "description": "Skapa en ny händelse i en kalender eller uppdatera en befintlig."
     },
     "ha_config_set_category": {
       "title": "Skapa eller Uppdatera Kategori",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/zh-Hans.json

@@ -573,8 +573,8 @@
       "description": "获取标签信息——列出所有标签或按 ID 查看特定标签。"
     },
     "ha_config_get_scene": {
-      "title": "获取场景配置",
-      "description": "获取 Home Assistant 场景配置。"
+      "title": "获取或查找场景",
+      "description": "获取场景的完整配置，或者在不提供 scene_id 的情况下列出并搜索场景。"
     },
     "ha_config_get_script": {
       "title": "获取脚本配置",
@@ -630,7 +630,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "创建或更新日历事件",
-      "description": "在日历中创建新事件。"
+      "description": "在日历中创建新事件，或更新现有事件。"
     },
     "ha_config_set_category": {
       "title": "创建或更新类别",

{ha_mcp_dev-8.5.0.dev2694 → ha_mcp_dev-8.5.0.dev2699}/src/ha_mcp/settings_ui/locales/zh-Hant.json

@@ -542,8 +542,8 @@
       "description": "取得標籤資訊 - 列出所有標籤，或透過 ID 取得特定標籤。"
     },
     "ha_config_get_scene": {
-      "title": "取得場景設定",
-      "description": "擷取 Home Assistant 場景設定。"
+      "title": "取得或尋找場景",
+      "description": "取得場景的完整設定，或在沒有 scene_id 的情況下列出並搜尋場景。"
     },
     "ha_config_get_script": {
       "title": "取得腳本設定",
@@ -599,7 +599,7 @@
     },
     "ha_config_set_calendar_event": {
       "title": "建立或更新行事曆事件",
-      "description": "在行事曆中建立新事件。"
+      "description": "在行事曆中建立新事件，或更新現有事件。"
     },
     "ha_config_set_category": {
       "title": "建立或更新分類",