ha-mcp-dev 8.7.0.dev3047__tar.gz → 8.7.0.dev3053__tar.gz

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.7.0.dev3047"
+version = "8.7.0.dev3053"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.7.0.dev3047"
+version = "8.7.0.dev3053"
 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.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/config_meta.py

@@ -75,6 +75,8 @@ class Setting:
     range: tuple[float, float] | None = None
     off_value: int | None = None
     choices: tuple[str, ...] | None = None
+    # Free text whose line breaks matter; the UI edits it in a textarea.
+    multiline: bool = False
     # An env value that does not parse or is out of range logs a warning and
     # gives the default, instead of failing the settings validation.
     lenient: bool = False

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/config_registry.py

@@ -19,6 +19,7 @@ from ha_mcp.config_settings import Settings
 
 __all__ = [
     "ADDON_SYNCED_ADVANCED_FIELDS",
+    "ADVANCED_MULTILINE",
     "ADVANCED_RESTART_REQUIRED",
     "ADVANCED_SETTINGS_FIELDS",
     "BACKUP_OVERRIDE_FIELDS",
@@ -244,6 +245,11 @@ _ADVANCED_SETTINGS_CHOICES: dict[str, tuple[str, ...]] = {
     if setting.choices is not None
 }
 
+# Advanced string fields edited as multi-line text (renders as <textarea>).
+ADVANCED_MULTILINE: frozenset[str] = frozenset(
+    name for name, _field, setting in _settings_of("advanced") if setting.multiline
+)
+
 # Advanced fields that take effect only after a restart of the MCP server.
 ADVANCED_RESTART_REQUIRED: frozenset[str] = frozenset(
     name

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/config_settings.py

@@ -280,6 +280,20 @@ class Settings(BaseSettings):
         Setting(surface="advanced", section="tools_surface", restart_required=True),
     ] = Field("all", alias="ENABLED_TOOL_MODULES")
 
+    # Free text appended to the MCP server instructions, so every client
+    # connecting to this installation gets the same user-defined guidance
+    # (e.g. where household notes live). Empty adds nothing.
+    custom_instructions: Annotated[
+        str,
+        Setting(
+            surface="advanced",
+            section="tools_surface",
+            app=_ALL_FLAVORS,
+            restart_required=True,
+            multiline=True,
+        ),
+    ] = Field("", alias="HAMCP_CUSTOM_INSTRUCTIONS")
+
     # Dashboard partial update tools (python_transform, find_card)
     # These are token-efficient alternatives to full config replacement.
     # Disable when using clients with programmatic tool use (future).

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/server.py

@@ -19,16 +19,19 @@ from pydantic import Field
 from .config import _PACKAGE_VERSION, get_global_settings
 from .errors import ErrorCode, create_error_response
 from .http_transport import HttpTransportFastMCP as FastMCP
+from .server_instructions import (
+    build_skills_instructions,
+    compose_instructions,
+    skill_tool_hidden,
+)
 from .server_lifespan import server_lifespan
 from .server_tool_text import (
-    ISSUE_FILING_INSTRUCTIONS,
     LITE_DOCSTRING_DESTINATIONS,
     LITE_DOCSTRINGS,
-    READ_ONLY_INSTRUCTIONS,
     SEARCH_KEYWORDS,
     SEARCH_TOOL_DESCRIPTION,
+    SKILL_TOOL_NAME,
     SKILL_USE_BEFORE_KEYWORDS,
-    TOOL_DISCOVERY_INSTRUCTIONS,
 )
 from .tools.helpers import raise_tool_error
 from .tools.tool_hints import read_only_hints
@@ -46,12 +49,6 @@ if TYPE_CHECKING:
 
 logger = logging.getLogger(__name__)
 
-# Name of the consolidated skill tool. Defined as a module
-# constant so settings UI, instructions, tests, and pinning all agree on
-# one canonical string. 18 chars — well under the 40-char cap that
-# Cloudflare's MCP portal enforces (#1121).
-SKILL_TOOL_NAME = "ha_get_skill_guide"
-
 # Names this tool replaced in #1134. Appended to the catalog description
 # so agents trained on the prior catalog (or pasting old instructions)
 # see the redirect inside the tool itself, not just via BM25 keyword
@@ -319,147 +316,18 @@ class HomeAssistantSmartMCPServer:
 
         return get_skills_dir()
 
-    def _skill_tool_hidden(self) -> bool:
-        """True when ha_get_skill_guide will be absent from the catalog.
-
-        The tool is user- or env-disableable only while strict-BPS mode
-        is off (#1886) — apply_tool_visibility strips the disable
-        otherwise. Consulted at instruction-build time so the skills
-        header doesn't direct clients to a tool that is not being
-        served. Fails toward False (mention the tool): a wrong mention
-        costs one unknown-tool error, a wrong omission hides the only
-        non-resource access path.
-        """
-        try:
-            from .settings_ui._persistence import effective_tool_config
-            from .settings_ui._tools_meta import effective_mandatory_tools
-
-            states = effective_tool_config().get("tools", {})
-            return states.get(
-                SKILL_TOOL_NAME
-            ) == "disabled" and SKILL_TOOL_NAME not in effective_mandatory_tools(
-                self.settings
-            )
-        except Exception:
-            logger.debug("skill-tool visibility lookup failed", exc_info=True)
-            return False
-
     def _build_instructions(self) -> str:
         """Compose the server instructions sent in the MCP initialize response."""
-        sections: list[str] = []
-        skills = self._build_skills_instructions()
-        if skills:
-            sections.append(skills)
-
-        # Surface Read Only Mode in the startup instructions so clients
-        # that show server instructions warn the model up front. Startup
-        # state only — live flips are covered by the structured
-        # READ_ONLY_MODE call errors and the ha_get_overview field.
-        if self.settings.read_only_mode:
-            sections.append(READ_ONLY_INSTRUCTIONS)
-        sections.append(ISSUE_FILING_INSTRUCTIONS)
-        return "\n\n".join(sections)
+        return compose_instructions(self._build_skills_instructions(), self.settings)
 
     def _build_skills_instructions(self) -> str | None:
-        """Build server instructions from bundled skill frontmatter.
-
-        Reads the description field from each SKILL.md's YAML frontmatter
-        and includes it as-is in the server instructions. The description
-        is authored for LLM consumption and should not be parsed or
-        restructured by code.
-
-        Returns None when no skills directory or no parseable skills are
-        present, leaving instructions unchanged from the default (None).
-        """
-        skills_dir = self._get_skills_dir()
-        if not skills_dir:
-            return None
-
-        try:
-            entries = sorted(skills_dir.iterdir())
-        except OSError as e:
-            logger.warning("Could not read skills directory %s: %s", skills_dir, e)
-            return None
-
-        skill_blocks: list[str] = []
-        for skill_dir in entries:
-            main_file = skill_dir / "SKILL.md"
-            if not skill_dir.is_dir() or not main_file.exists():
-                continue
-
-            block = self._build_skill_block(skill_dir.name, main_file)
-            if block:
-                skill_blocks.append(block)
-
-        if not skill_blocks:
-            return None
-
-        if self._skill_tool_hidden():
-            # The user disabled the skill tool (possible only outside
-            # strict-BPS mode, #1886) — directing clients to it would
-            # steer them into a tool that is not in the catalog. Their
-            # stated fallback is a local skills install.
-            access_method = (
-                "Read the skill via MCP resources (resources/read with the "
-                "skill:// URI) — if you can read these instructions, you "
-                "should be able to access resources as well. If for any "
-                "reason you cannot access MCP resources, refer to your "
-                "locally installed copy of these skills instead (the "
-                f"{SKILL_TOOL_NAME} fallback tool is disabled on this "
-                "server)."
-            )
-        else:
-            access_method = (
-                "Read the skill via MCP resources (resources/read with the "
-                "skill:// URI) — if you can read these instructions, you "
-                "should be able to access resources as well. If for any "
-                f"reason you cannot access MCP resources, call {SKILL_TOOL_NAME}() "
-                "with no arguments as a fallback: it returns SKILL.md, then "
-                "pass file='<path>' for a reference file. If you can access "
-                "resources normally, do "
-                "not waste time or tokens on that tool."
-            )
-
-        header = (
-            "IMPORTANT: This server provides best-practice skills that MUST "
-            "be consulted before performing matching actions. "
-            "Read the SKILL.md for the matching skill "
-            "\u2014 it contains a Reference Files table that maps tasks to "
-            "specific reference files. You MUST read the referenced files "
-            "that match your current task before proceeding. "
-            "Do NOT load all reference files upfront "
-            "\u2014 only the ones the table directs you to.\n\n"
-            f"How to access: {access_method}\n"
+        """The skills section of the instructions, or None without skills."""
+        return build_skills_instructions(
+            self._get_skills_dir(), self.settings, skill_tool_hidden(self.settings)
         )
 
-        instructions = header + "\n".join(skill_blocks)
-
-        # Append tool search instructions when enabled
-        if self.settings.enable_tool_search:
-            instructions += TOOL_DISCOVERY_INSTRUCTIONS.format(
-                pinned=", ".join(DEFAULT_PINNED_TOOLS)
-            )
-
-        return instructions
-
     _parse_skill_frontmatter = staticmethod(parse_skill_frontmatter)
 
-    def _build_skill_block(self, skill_name: str, main_file: Path) -> str | None:
-        """Build an instruction block for a single skill.
-
-        Reads the description field from YAML frontmatter and includes it
-        verbatim. The description is designed for LLM consumption and
-        contains its own trigger conditions and symptom indicators.
-        """
-        frontmatter = self._parse_skill_frontmatter(main_file)
-        if not frontmatter:
-            return None
-
-        description = frontmatter["description"]
-        uri = f"skill://{skill_name}/SKILL.md"
-
-        return f"\n### Skill: {skill_name} ({uri})\n{description.strip()}"
-
     def _apply_settings_visibility(self) -> None:
         """Apply persisted tool visibility from ``tool_config.json``.
 
@@ -1089,32 +957,6 @@ class HomeAssistantSmartMCPServer:
         else:
             logger.warning(message, *args)
 
-    def _list_bundled_skills(
-        self, skills_dir: Path
-    ) -> list[tuple[str, Path, dict[str, Any]]]:
-        """Return parsed (name, dir, frontmatter) triples for valid bundled skills.
-
-        Skips entries that aren't directories, lack ``SKILL.md``, or whose
-        frontmatter doesn't parse. Sorted by directory name for stable
-        ordering across clients.
-        """
-        try:
-            entries = sorted(skills_dir.iterdir())
-        except OSError as e:
-            logger.warning("Could not read skills directory %s: %s", skills_dir, e)
-            return []
-
-        skills: list[tuple[str, Path, dict[str, Any]]] = []
-        for skill_dir in entries:
-            main_file = skill_dir / "SKILL.md"
-            if not skill_dir.is_dir() or not main_file.exists():
-                continue
-            frontmatter = self._parse_skill_frontmatter(main_file)
-            if not frontmatter:
-                continue
-            skills.append((skill_dir.name, skill_dir, frontmatter))
-        return skills
-
     def _register_skill_guide_tool(self, skills_dir: Path | None) -> int:
         """Register the ``ha_get_skill_guide`` tool unconditionally.
 

ha_mcp_dev-8.7.0.dev3053/src/ha_mcp/server_instructions.py

@@ -0,0 +1,141 @@
+"""The instructions the server sends in the MCP initialize response.
+
+Sections, in order: the bundled best-practice skills with how to read them
+(plus the tool-search note when that mode is on), the Read Only Mode
+warning, the issue-filing rule, and the installation owner's
+``custom_instructions``. The skills header and access fallbacks are
+defined here; the notices come from ``server_tool_text``.
+"""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from .server_tool_text import (
+    ISSUE_FILING_INSTRUCTIONS,
+    READ_ONLY_INSTRUCTIONS,
+    SKILL_TOOL_NAME,
+    TOOL_DISCOVERY_INSTRUCTIONS,
+)
+from .transforms import DEFAULT_PINNED_TOOLS
+from .utils.skill_loader import list_skills
+
+if TYPE_CHECKING:
+    from .config_settings import Settings
+
+logger = logging.getLogger(__name__)
+
+OWNER_HEADING = "## Instructions from this installation's owner"
+
+_SKILLS_HEADER = (
+    "IMPORTANT: This server provides best-practice skills that MUST "
+    "be consulted before performing matching actions. "
+    "Read the SKILL.md for the matching skill "
+    "— it contains a Reference Files table that maps tasks to "
+    "specific reference files. You MUST read the referenced files "
+    "that match your current task before proceeding. "
+    "Do NOT load all reference files upfront "
+    "— only the ones the table directs you to.\n\n"
+    "How to access: {access_method}\n"
+)
+
+_RESOURCE_ACCESS = (
+    "Read the skill via MCP resources (resources/read with the "
+    "skill:// URI) — if you can read these instructions, you "
+    "should be able to access resources as well. "
+)
+
+# The user disabled the skill tool (possible only outside strict-BPS mode,
+# #1886) — directing clients to it would steer them into a tool that is not
+# in the catalog. Their stated fallback is a local skills install.
+_LOCAL_SKILLS_FALLBACK = (
+    "If for any reason you cannot access MCP resources, refer to your "
+    "locally installed copy of these skills instead (the "
+    f"{SKILL_TOOL_NAME} fallback tool is disabled on this server)."
+)
+
+_SKILL_TOOL_FALLBACK = (
+    f"If for any reason you cannot access MCP resources, call {SKILL_TOOL_NAME}() "
+    "with no arguments as a fallback: it returns SKILL.md, then "
+    "pass file='<path>' for a reference file. If you can access "
+    "resources normally, do not waste time or tokens on that tool."
+)
+
+
+def skill_tool_hidden(settings: Settings) -> bool:
+    """True when ha_get_skill_guide will be absent from the catalog.
+
+    The tool is user- or env-disableable only while strict-BPS mode
+    is off (#1886) — apply_tool_visibility strips the disable
+    otherwise. Consulted at instruction-build time so the skills
+    header doesn't direct clients to a tool that is not being
+    served. Fails toward False (mention the tool): a wrong mention
+    costs one unknown-tool error, a wrong omission hides the only
+    non-resource access path.
+    """
+    try:
+        from .settings_ui._persistence import effective_tool_config
+        from .settings_ui._tools_meta import effective_mandatory_tools
+
+        states = effective_tool_config(settings).get("tools", {})
+        return states.get(
+            SKILL_TOOL_NAME
+        ) == "disabled" and SKILL_TOOL_NAME not in effective_mandatory_tools(settings)
+    except Exception:
+        logger.debug("skill-tool visibility lookup failed", exc_info=True)
+        return False
+
+
+def skill_block(skill_name: str, description: str) -> str:
+    """One skill's entry: its resource URI and its LLM-authored description."""
+    uri = f"skill://{skill_name}/SKILL.md"
+    return f"\n### Skill: {skill_name} ({uri})\n{description.strip()}"
+
+
+def build_skills_instructions(
+    skills_dir: Path | None, settings: Settings, tool_hidden: bool
+) -> str | None:
+    """Build the skills section from each bundled SKILL.md's frontmatter.
+
+    The description field is authored for LLM consumption and included
+    as-is, never parsed or restructured by code. Returns None when there is
+    no skills directory or no parseable skill; the instructions then start
+    with the notices.
+    """
+    skills = list_skills(skills_dir) if skills_dir else []
+    if not skills:
+        return None
+
+    fallback = _LOCAL_SKILLS_FALLBACK if tool_hidden else _SKILL_TOOL_FALLBACK
+    header = _SKILLS_HEADER.format(access_method=_RESOURCE_ACCESS + fallback)
+    instructions = header + "\n".join(
+        skill_block(name, frontmatter["description"])
+        for name, _dir, frontmatter in skills
+    )
+
+    if settings.enable_tool_search:
+        instructions += TOOL_DISCOVERY_INSTRUCTIONS.format(
+            pinned=", ".join(DEFAULT_PINNED_TOOLS)
+        )
+
+    return instructions
+
+
+def compose_instructions(skills: str | None, settings: Settings) -> str:
+    """Join the skills section with the startup notices and the owner's text."""
+    sections = [skills] if skills else []
+    # Surface Read Only Mode in the startup instructions so clients
+    # that show server instructions warn the model up front. Startup
+    # state only — live flips are covered by the structured
+    # READ_ONLY_MODE call errors and the ha_get_overview field.
+    if settings.read_only_mode:
+        sections.append(READ_ONLY_INSTRUCTIONS)
+    sections.append(ISSUE_FILING_INSTRUCTIONS)
+    custom = settings.custom_instructions.strip()
+    if custom:
+        # Length only: the text itself is the owner's and may be personal.
+        logger.info("custom_instructions active (%d characters)", len(custom))
+        sections.append(f"{OWNER_HEADING}\n{custom}")
+    return "\n\n".join(sections)

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/server_tool_text.py

@@ -1,12 +1,19 @@
 """Static text the server publishes about its tools.
 
 Holds the search tool description, the BM25 keyword boosts, the lite
-docstring variants with their destinations, and the skill keyword block.
-``HomeAssistantSmartMCPServer`` exposes each one as a class attribute.
+docstring variants with their destinations and the skill keyword block,
+which ``HomeAssistantSmartMCPServer`` exposes as class attributes, plus the
+skill tool's name and the instruction notices ``server_instructions`` uses.
 """
 
 from __future__ import annotations
 
+# Name of the consolidated skill tool. Defined as a module constant so the
+# tool registration, the instructions, the mandatory-tool set, the default
+# pins and the tests agree on one canonical string. 18 chars — well under
+# the 40-char cap that Cloudflare's MCP portal enforces (#1121).
+SKILL_TOOL_NAME = "ha_get_skill_guide"
+
 # Description for the unified search tool
 SEARCH_TOOL_DESCRIPTION = (
     "Search ALL Home Assistant tools by ENGLISH keyword. Each hit is "

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/_handlers_advanced.py

@@ -88,7 +88,7 @@ def _advanced_field_row(
         _ADVANCED_SETTINGS_SENTINELS,
         OAUTH_MODE_TOKEN,
     )
-    from ..config_registry import ADVANCED_RESTART_REQUIRED
+    from ..config_registry import ADVANCED_MULTILINE, ADVANCED_RESTART_REQUIRED
 
     origin = _origin_for_advanced_field(env_name, overrides=overrides)
     value: Any = getattr(settings, fname, None)
@@ -122,6 +122,8 @@ def _advanced_field_row(
     choices = _ADVANCED_SETTINGS_CHOICES.get(fname)
     if choices is not None:
         row["choices"] = list(choices)
+    if fname in ADVANCED_MULTILINE:
+        row["multiline"] = True
     return row
 
 

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/_tools_meta.py

@@ -18,6 +18,7 @@ import logging
 from collections.abc import Iterable
 from typing import TYPE_CHECKING, Any, NamedTuple, NotRequired, TypedDict
 
+from ..server_tool_text import SKILL_TOOL_NAME
 from ..transforms import categorize_capability
 
 if TYPE_CHECKING:
@@ -116,7 +117,7 @@ MANDATORY_TOOLS: set[str] = {
 # _save_feature_flags) so each direction of the conflict gets an
 # actionable error.
 BPS_MANDATORY_TOOLS: set[str] = {
-    "ha_get_skill_guide",
+    SKILL_TOOL_NAME,
 }
 
 

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/az.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "Ekran görüntüsü mühərrikinin əsas URL-i. Supervisor vasitəsilə avtomatik aşkarlama üçün boş saxlayın. Dərhal tətbiq edilir.",
     "advanced.enable_websocket.label": "WebSocket-i aktivləşdir",
     "advanced.enable_websocket.help": "WebSocket statusunun izlənməsi. Deaktiv edilməsi sorğulamaya (polling) qayıdır və bir çox alətin işini zəiflədir.",
+    "advanced.custom_instructions.label": "Xüsusi server təlimatları",
+    "advanced.custom_instructions.help": "Qoşulan hər bir süni intellekt köməkçisinə MCP server təlimatlarının bir hissəsi olaraq göndərilən mətn — məsələn, ev qeydlərinin harada saxlandığı və onların nə vaxt oxunmalı və ya yenilənməli olduğu. Həmçinin bu alətlər dəstindən istifadə edən Home Assistant söhbət agentlərinin (Assist) sorğusunun bir hissəsidir. Onu bütün müştərilərinizə eyni vaxtda çatmalı olan təlimatlar üçün istifadə edin; onu qısa və məxfi məlumatlardan azad saxlayın. Heç nə əlavə etməmək üçün boş buraxın. Yenidən başladılmasını tələb edir; müştərilər yenidən qoşulduqda dəyişikliyi görürlər.",
     "advanced.enabled_tool_modules.label": "Aktiv alət modulları",
     "advanced.enabled_tool_modules.help": "Vergüllə ayrılmış modul adları və ya 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "İdarə panelinin qismən yenilənməsi alətləri",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/cs.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "Základní URL enginu pro snímky obrazovky. Ponechte prázdné pro automatické zjišťování Supervisor. Platí okamžitě.",
     "advanced.enable_websocket.label": "Povolit WebSocket",
     "advanced.enable_websocket.help": "Sledování stavu přes WebSocket. Vypnutí přepne na polling a omezí funkčnost mnoha nástrojů.",
+    "advanced.custom_instructions.label": "Vlastní instrukce serveru",
+    "advanced.custom_instructions.help": "Text odeslaný každému připojujícímu se AI asistentu jako součást instrukcí MCP serveru — například kde jsou uloženy poznámky domácnosti a kdy je číst nebo aktualizovat. Je také součástí promptu konverzačních agentů Home Assistant (Assist), kteří tuto sadu nástrojů používají. Použijte jej pro pokyny, které by měly zasáhnout všechny vaše klienti najednou; udržujte jej stručný a bez tajných údajů. Ponechte prázdné, pokud nechcete nic přidat. Vyžaduje restart; klienti uvidí změnu po opětovném připojení.",
     "advanced.enabled_tool_modules.label": "Povolené moduly nástrojů",
     "advanced.enabled_tool_modules.help": "Názvy modulů oddělené čárkami nebo 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Nástroje pro částečnou aktualizaci panelu",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/de.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "Basis-URL der Screenshot-Engine. Lasse leer für Supervisor-Auto-Discovery. Wirkt sofort.",
     "advanced.enable_websocket.label": "WebSocket aktivieren",
     "advanced.enable_websocket.help": "WebSocket-Zustandsüberwachung. Das Deaktivieren fällt auf Polling zurück und beeinträchtigt viele Tools.",
+    "advanced.custom_instructions.label": "Eigene Server-Anweisungen",
+    "advanced.custom_instructions.help": "Text, den jeder verbundene KI-Assistent als Teil der MCP-Server-Anweisungen erhält – zum Beispiel, wo Notizen zum Haushalt liegen und wann sie gelesen oder aktualisiert werden sollen. Auch Teil des Prompts von Home-Assistant-Sprachassistenten (Assist), die dieses Toolset nutzen. Gedacht für Hinweise, die alle deine Clients auf einmal erreichen sollen; halte ihn kurz und ohne Geheimnisse. Leer lassen, um nichts hinzuzufügen. Erfordert einen Neustart; Clients sehen die Änderung nach dem erneuten Verbinden.",
     "advanced.enabled_tool_modules.label": "Aktivierte Tool-Module",
     "advanced.enabled_tool_modules.help": "Kommagetrennte Modulnamen oder 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Dashboard-Partial-Update-Tools",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/en.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "Base URL of the screenshot engine. Leave blank for Supervisor auto-discovery. Applies immediately.",
     "advanced.enable_websocket.label": "Enable WebSocket",
     "advanced.enable_websocket.help": "WebSocket state monitoring. Disabling falls back to polling and degrades many tools.",
+    "advanced.custom_instructions.label": "Custom server instructions",
+    "advanced.custom_instructions.help": "Text sent to every AI assistant that connects, as part of the MCP server instructions — for example where household notes are kept and when to read or update them. Also part of the prompt of Home Assistant conversation agents (Assist) that use this toolset. Use it for guidance that should reach all your clients at once; keep it short and free of secrets. Leave empty to add nothing. Requires restart; clients see the change when they reconnect.",
     "advanced.enabled_tool_modules.label": "Enabled tool modules",
     "advanced.enabled_tool_modules.help": "Comma-separated module names, or 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Dashboard partial-update tools",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/eo.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "Baza URL de la ekrankopiga motoro. Lasu malplena por aŭtomata malkovro de Supervisor. Aplikiĝas tuj.",
     "advanced.enable_websocket.label": "Ebligi WebSocket",
     "advanced.enable_websocket.help": "Monitorado de WebSocket-stato. Malŝalto falas al balotado kaj malbonigas multajn ilojn.",
+    "advanced.custom_instructions.label": "Propraj servilaj instrukcioj",
+    "advanced.custom_instructions.help": "Teksto sendita al ĉiu AI-asistanto kiu konektiĝas, kiel parto de la instrukcioj de la serviloj MCP — ekzemple kie hejmaj notoj estas konservitaj kaj kiam legi aŭ ĝisdatigi ilin. Ankaŭ parto de la prompto de hejmaŭtomatigaj konversaciaj agentoj (Assist) de Home Assistant, kiuj uzas ĉi tiun ilaron. Uzu ĝin por gvidado, kiu devas atingi ĉiujn viajn klientojn samtempe; tenu ĝin mallonga kaj libera de sekretoj. Lasu malplena por aldoni nenion. Postulas relumon; klientoj vidas la ŝanĝon kiam ili rekonektiĝas.",
     "advanced.enabled_tool_modules.label": "Ebligitaj il-moduloj",
     "advanced.enabled_tool_modules.help": "Komo-dividitaj modulnomoj, aŭ 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Iloj por parta ĝisdatigo de panelo",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/es.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "URL base del motor de capturas. Déjalo vacío para la detección automática del Supervisor. Se aplica de inmediato.",
     "advanced.enable_websocket.label": "Activar WebSocket",
     "advanced.enable_websocket.help": "Monitoreo del estado por WebSocket. Si se desactiva, se recurre al sondeo (polling) y se degradan muchas herramientas.",
+    "advanced.custom_instructions.label": "Instrucciones personalizadas del servidor",
+    "advanced.custom_instructions.help": "Texto enviado a cada asistente de IA que se conecta, como parte de las instrucciones del servidor MCP (por ejemplo, dónde se guardan las notas del hogar y cuándo leerlas o actualizarlas). También forma parte del prompt de los agentes de conversación de Home Assistant (Assist) que utilizan este conjunto de herramientas. Úsalo para directrices que deban llegar a todos tus clientes a la vez; mantenlo breve y sin datos confidenciales. Déjalo vacío para no añadir nada. Requiere reinicio; los clientes verán el cambio cuando se reconecten.",
     "advanced.enabled_tool_modules.label": "Módulos de herramientas activados",
     "advanced.enabled_tool_modules.help": "Nombres de módulos separados por comas, o 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Herramientas de actualización parcial de paneles",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/fr.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "URL de base du moteur de capture d'écran. Laissez vide pour la découverte automatique par le Supervisor. S'applique immédiatement.",
     "advanced.enable_websocket.label": "Activer WebSocket",
     "advanced.enable_websocket.help": "Surveillance de l'état via WebSocket. La désactivation bascule vers l'interrogation (polling) et dégrade de nombreux outils.",
+    "advanced.custom_instructions.label": "Instructions personnalisées du serveur",
+    "advanced.custom_instructions.help": "Texte envoyé à chaque assistant IA qui se connecte, dans le cadre des instructions du serveur MCP — par exemple, l'emplacement des notes du foyer et le moment de les lire ou de les mettre à jour. Fait également partie du prompt des agents de conversation Home Assistant (Assist) qui utilisent cet ensemble d'outils. Utilisez-le pour fournir des directives destinées à tous vos clients en même temps ; restez concis et évitez d'y inclure des secrets. Laissez vide pour ne rien ajouter. Nécessite un redémarrage ; les clients voient le changement lorsqu'ils se reconnectent.",
     "advanced.enabled_tool_modules.label": "Modules d'outils activés",
     "advanced.enabled_tool_modules.help": "Noms de modules séparés par des virgules, ou 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Outils de mise à jour partielle du tableau de bord",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/it.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "URL di base del motore per gli screenshot. Lascia vuoto per il rilevamento automatico tramite Supervisor. Ha effetto immediato.",
     "advanced.enable_websocket.label": "Attiva il WebSocket",
     "advanced.enable_websocket.help": "Monitoraggio dello stato tramite WebSocket. Se disabilitato, il sistema passa al polling e molte funzionalità degli strumenti si riducono.",
+    "advanced.custom_instructions.label": "Istruzioni personalizzate del server",
+    "advanced.custom_instructions.help": "Testo inviato a ogni assistente IA che si connette, come parte delle istruzioni del server MCP — ad esempio dove sono conservate le note della casa e quando leggerle o aggiornarle. Fa anche parte del prompt degli agenti di conversazione di Home Assistant (Assist) che utilizzano questo set di strumenti. Usalo per indicazioni che devono raggiungere tutti i client in una volta sola; tienilo breve e privo di segreti. Lascia vuoto per non aggiungere nulla. Richiede il riavvio; i client vedono la modifica quando si riconnettono.",
     "advanced.enabled_tool_modules.label": "Moduli di strumenti attivi",
     "advanced.enabled_tool_modules.help": "Nomi dei moduli separati da virgola o 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Strumenti di aggiornamento parziale delle dashboard",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/ko.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "스크린샷 엔진의 기본 URL입니다. Supervisor 자동 검색을 쓰려면 비워 두세요. 즉시 적용됩니다.",
     "advanced.enable_websocket.label": "WebSocket 사용",
     "advanced.enable_websocket.help": "WebSocket 상태 모니터링. 비활성화하면 폴링으로 대체되며 많은 도구의 성능이 저하됩니다.",
+    "advanced.custom_instructions.label": "사용자 정의 서버 지침",
+    "advanced.custom_instructions.help": "MCP 서버 지침의 일부로 연결되는 모든 AI 어시스턴트에게 전송되는 텍스트입니다. 예를 들어 가족 메모가 보관되는 위치와 이를 읽거나 업데이트해야 하는 시기 등을 지정할 수 있습니다. 이 도구 세트를 사용하는 Home Assistant 대화 어시스턴트(Assist)의 프롬프트에도 포함됩니다. 모든 클라이언트에 한 번에 전달해야 하는 지침에 사용하고, 짧고 비밀 정보가 포함되지 않도록 유지하세요. 추가하지 않으려면 비워 두세요. 재시작이 필요하며, 클라이언트는 재연결할 때 변경 사항을 확인합니다.",
     "advanced.enabled_tool_modules.label": "사용할 도구 모듈",
     "advanced.enabled_tool_modules.help": "쉼표로 구분된 모듈 이름 또는 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "대시보드 부분 업데이트 도구",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/nl.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "Basis-URL van de screenshot engine. Laat leeg voor Supervisor auto-ontdekking. Wordt onmiddellijk toegepast.",
     "advanced.enable_websocket.label": "WebSocket inschakelen",
     "advanced.enable_websocket.help": "WebSocket-statusmonitoring. Uitschakelen valt terug op pollen en degradeert veel tools.",
+    "advanced.custom_instructions.label": "Aangepaste serverinstructies",
+    "advanced.custom_instructions.help": "Tekst die naar elke verbindende AI-assistent wordt verzonden als onderdeel van de MCP-serverinstructies — bijvoorbeeld waar huishoudelijke notities worden bewaard en wanneer je deze moet lezen of bijwerken. Maakt ook deel uit van de prompt van Home Assistant-gespreksagenten (Assist) die deze toolset gebruiken. Gebruik dit voor richtlijnen die al je clients tegelijk moeten bereiken; houd het kort en vrij van geheimen. Laat leeg om niets toe te voegen. Vereist een herstart; clients zien de wijziging wanneer ze opnieuw verbinden.",
     "advanced.enabled_tool_modules.label": "Ingeschakelde toolmodules",
     "advanced.enabled_tool_modules.help": "Door komma's gescheiden modulenamen, of 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Dashboard tools voor gedeeltelijke updates",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/pl.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "Bazowy adres URL silnika zrzutów ekranu. Pozostaw puste dla automatycznego wykrywania przez Supervisor. Obowiązuje natychmiast.",
     "advanced.enable_websocket.label": "Włącz WebSocket",
     "advanced.enable_websocket.help": "Monitorowanie stanu przez WebSocket. Wyłączenie powoduje powrót do odpytywania (polling) i obniża działanie wielu narzędzi.",
+    "advanced.custom_instructions.label": "Niestandardowe instrukcje serwera",
+    "advanced.custom_instructions.help": "Tekst wysyłany do każdego łączącego się asystenta AI jako część instrukcji serwera MCP – na przykład informacja o tym, gdzie przechowywane są notatki domowe oraz kiedy je czytać lub aktualizować. Jest to również część promptu agentów konwersacyjnych Home Assistant (Assist), którzy korzystają z tego zestawu narzędzi. Użyj tej opcji do wytycznych, które powinny dotrzeć do wszystkich Twoich klientów naraz; dbaj o to, aby tekst był krótki i nie zawierał poufnych danych. Pozostaw puste pole, aby niczego nie dodawać. Wymaga ponownego uruchomienia; klienci zobaczą zmianę po ponownym połączeniu.",
     "advanced.enabled_tool_modules.label": "Włączone moduły narzędzi",
     "advanced.enabled_tool_modules.help": "Nazwy modułów oddzielone przecinkami lub „all”.",
     "advanced.enable_dashboard_partial_tools.label": "Narzędzia do częściowej aktualizacji pulpitu nawigacyjnego",

{ha_mcp_dev-8.7.0.dev3047 → ha_mcp_dev-8.7.0.dev3053}/src/ha_mcp/settings_ui/locales/ru.json

@@ -472,6 +472,8 @@
     "advanced.dashboard_screenshot_engine_url.help": "Базовый URL движка. Оставьте пустым для автопоиска через Supervisor. Действует сразу.",
     "advanced.enable_websocket.label": "Включить WebSocket",
     "advanced.enable_websocket.help": "Мониторинг состояния через WebSocket. Отключение переключает на опрос и ухудшает работу многих инструментов.",
+    "advanced.custom_instructions.label": "Пользовательские инструкции сервера",
+    "advanced.custom_instructions.help": "Текст, отправляемый каждому подключающемуся ИИ-ассистенту в составе инструкций MCP-сервера — например, где хранятся заметки о доме и когда их читать или обновлять. Также входит в промпт голосовых ассистентов Home Assistant (Assist), использующих этот набор инструментов. Используйте для указаний, которые должны поступать сразу ко всем клиентам; пишите кратко и без конфиденциальных данных. Оставьте пустым, чтобы ничего не добавлять. Требуется перезапуск; клиенты увидят изменения при повторном подключении.",
     "advanced.enabled_tool_modules.label": "Включённые модули инструментов",
     "advanced.enabled_tool_modules.help": "Имена модулей через запятую или 'all'.",
     "advanced.enable_dashboard_partial_tools.label": "Инструменты частичного обновления панелей",