ha-mcp-dev 8.6.0.dev2866__tar.gz → 8.6.0.dev2871__tar.gz

{ha_mcp_dev-8.6.0.dev2866 → ha_mcp_dev-8.6.0.dev2871}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 8.6.0.dev2866
+Version: 8.6.0.dev2871
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Keywords: mcp,home-assistant,ai,automation,smart-home
 Author: Julien
@@ -566,7 +566,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ## 💬 Community
 
 - **[GitHub Discussions](https://github.com/homeassistant-ai/ha-mcp/discussions)** — Ask questions, share ideas
-- **[Issue Tracker](https://github.com/homeassistant-ai/ha-mcp/issues)** — Report bugs, request features, or suggest tool behavior improvements
+- **[Issue Tracker](https://github.com/homeassistant-ai/ha-mcp/issues)** — Report bugs, request features, or suggest tool behavior improvements. Bug reports need the report the `ha_report_issue` tool generates, or a reason why there is none; without either they are closed after 24 hours.
 
 ---
 

{ha_mcp_dev-8.6.0.dev2866 → ha_mcp_dev-8.6.0.dev2871}/README.md

@@ -506,7 +506,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ## 💬 Community
 
 - **[GitHub Discussions](https://github.com/homeassistant-ai/ha-mcp/discussions)** — Ask questions, share ideas
-- **[Issue Tracker](https://github.com/homeassistant-ai/ha-mcp/issues)** — Report bugs, request features, or suggest tool behavior improvements
+- **[Issue Tracker](https://github.com/homeassistant-ai/ha-mcp/issues)** — Report bugs, request features, or suggest tool behavior improvements. Bug reports need the report the `ha_report_issue` tool generates, or a reason why there is none; without either they are closed after 24 hours.
 
 ---
 

{ha_mcp_dev-8.6.0.dev2866 → ha_mcp_dev-8.6.0.dev2871}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.6.0.dev2866"
+version = "8.6.0.dev2871"
 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.6.0.dev2866 → ha_mcp_dev-8.6.0.dev2871}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "8.6.0.dev2866"
+version = "8.6.0.dev2871"
 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.6.0.dev2866 → ha_mcp_dev-8.6.0.dev2871}/src/ha_mcp/read_only.py

@@ -89,7 +89,7 @@ def read_only_remedy_hint() -> str:
     if get_global_settings().read_only_mode:
         return (
             "To allow changes, the user must turn off Read Only Mode in the "
-            "ha-mcp settings UI (Tools tab) or the add-on configuration."
+            "ha-mcp settings UI (Tools tab) or the app (add-on) configuration."
         )
     return "This connection is read-only. If changes are needed, ask the user."
 
@@ -135,7 +135,7 @@ def _addon_write(args: dict[str, Any]) -> str | None:
         return f"action={action!r}"
     for param in _ADDON_CONFIG_WRITE_PARAMS:
         if args.get(param) is not None:
-            return f"add-on configuration change ({param}=...)"
+            return f"app (add-on) configuration change ({param}=...)"
     if args.get("array_patch") is not None:
         return "array_patch modification"
     if args.get("websocket"):

{ha_mcp_dev-8.6.0.dev2866 → ha_mcp_dev-8.6.0.dev2871}/src/ha_mcp/server.py

@@ -23,8 +23,10 @@ from .errors import ErrorCode, create_error_response
 from .http_transport import HttpTransportFastMCP as FastMCP
 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_USE_BEFORE_KEYWORDS,
@@ -129,28 +131,7 @@ class HomeAssistantSmartMCPServer:
             server_name = self.settings.mcp_server_name
             server_version = self.settings.mcp_server_version
 
-        # Build server instructions from bundled skills (if enabled)
-        instructions = self._build_skills_instructions()
-
-        # 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:
-            read_only_note = (
-                "## Read Only Mode\n"
-                "This server is running in Read Only Mode: write-capable "
-                "tools are disabled and every write or destructive "
-                "operation is blocked with a READ_ONLY_MODE error. You can "
-                "search, read, and analyze freely. To allow changes, the "
-                "user must turn off Read Only Mode in the ha-mcp settings "
-                "UI (Tools tab) or the add-on configuration."
-            )
-            instructions = (
-                f"{instructions}\n\n{read_only_note}"
-                if instructions
-                else read_only_note
-            )
+        instructions = self._build_instructions()
 
         # Create FastMCP server with Home Assistant icons for client UI display
         self.mcp = FastMCP(
@@ -381,6 +362,22 @@ class HomeAssistantSmartMCPServer:
             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)
+
     def _build_skills_instructions(self) -> str | None:
         """Build server instructions from bundled skill frontmatter.
 

{ha_mcp_dev-8.6.0.dev2866 → ha_mcp_dev-8.6.0.dev2871}/src/ha_mcp/server_tool_text.py

@@ -434,7 +434,7 @@ LITE_DOCSTRINGS: dict[str, str] = {
         "actually contains, and the encryption key a restore needs, see "
         "ha_get_skill_guide (`references/backups.md`)."
     ),
-    # ha_report_issue: the lite value is about two thirds of the full
+    # ha_report_issue: the lite value is about four fifths of the full
     # docstring. As for ha_manage_backup, no exact pair is quoted.
     #
     # Unlike every other entry here, the deferral target is the tool's
@@ -447,10 +447,14 @@ LITE_DOCSTRINGS: dict[str, str] = {
     # outright so a compliant agent doesn't spend a call finding out.
     "ha_report_issue": (
         "Get diagnostic information plus a finished GitHub issue. Covers "
-        "two kinds of report: a runtime bug (ha-mcp errored or behaved "
-        "unexpectedly) and agent-behaviour feedback (the AI used the wrong "
-        "tool or worked inefficiently). Pass the report text in the call; "
-        "the server builds the issue title, body and a pre-filled link.\n\n"
+        "three kinds of report: a runtime bug (ha-mcp errored or behaved "
+        "unexpectedly), agent-behaviour feedback (the AI used the wrong "
+        "tool or worked inefficiently) and a feature request (ha-mcp "
+        "cannot do something yet). Pass the report text in the call; "
+        "the server builds the issue title, body and a pre-filled link. "
+        "Every GitHub issue about ha-mcp, feature requests included, should "
+        "carry this report as its body; a bug report filed without it is "
+        "closed after 24 hours.\n\n"
         "The response carries the full workflow in its `instructions` "
         "field (duplicate check, the mandatory anonymisation step, and "
         "how to file the issue), plus "
@@ -525,3 +529,24 @@ SKILL_USE_BEFORE_KEYWORDS: str = (
     "ha_config_set_script, ha_config_set_helper, ha_config_set_dashboard, "
     "or ha_set_entity."
 )
+
+
+READ_ONLY_INSTRUCTIONS = (
+    "## Read Only Mode\n"
+    "This server is running in Read Only Mode: write-capable "
+    "tools are disabled and every write or destructive "
+    "operation is blocked with a READ_ONLY_MODE error. You can "
+    "search, read, and analyze freely. To allow changes, the "
+    "user must turn off Read Only Mode in the ha-mcp settings "
+    "UI (Tools tab) or the app (add-on) configuration."
+)
+
+# ha_report_issue is a mandatory tool, so this always points at a tool the
+# client has. The issue tracker's report gate closes bug reports without it.
+ISSUE_FILING_INSTRUCTIONS = (
+    "## Filing ha-mcp issues\n"
+    "Before filing any GitHub issue about ha-mcp, feature requests "
+    "included, run ha_report_issue and put the issue_body it returns "
+    "in the issue unchanged. A bug report filed without it is closed "
+    "automatically after 24 hours."
+)