ha-mcp-dev 8.6.0.dev2865__tar.gz → 8.6.0.dev2868__tar.gz

{ha_mcp_dev-8.6.0.dev2865 → ha_mcp_dev-8.6.0.dev2868}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 8.6.0.dev2865
+Version: 8.6.0.dev2868
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Keywords: mcp,home-assistant,ai,automation,smart-home
 Author: Julien
@@ -407,7 +407,7 @@ Set ENABLE_TOOL_SEARCH=true (or toggle the option in the HA app). The full catal
 
 | Tool | Purpose |
 |------|---------|
-| `ha_search_tools` | BM25 keyword search across all tools. Returns name, description, parameters, and annotations (`readOnlyHint` / `destructiveHint`) so the agent can pick the right one. |
+| `ha_search_tools` | BM25 English-keyword search across all tools, pinned ones included. Hidden tools return name, description, parameters, and annotations (`readOnlyHint` / `destructiveHint`) so the agent can pick the right one; a pinned tool returns a name-only stub (`pinned: true`) pointing back at the tool list, and does not use up a result slot. |
 | `ha_call_read_tool` | Execute a `readOnlyHint` tool by name. Safe — clients can auto-approve. |
 | `ha_call_write_tool` | Execute a write tool that creates or updates data. |
 | `ha_call_delete_tool` | Execute a tool that removes / deletes data. |
@@ -419,7 +419,7 @@ A `ha_manage_*` tool combines several operations, so it is reachable from more t
 | Setting | Default | Description |
 |---------|---------|-------------|
 | `ENABLE_TOOL_SEARCH` | `false` | Replace full tool catalog with search-based discovery (tools deferred behind on-demand search). |
-| `TOOL_SEARCH_MAX_RESULTS` | `5` | Max results returned by `ha_search_tools` (range 2–10). |
+| `TOOL_SEARCH_MAX_RESULTS` | `5` | Max hidden tools returned per `ha_search_tools` call (range 2–10); a pinned tool that ranks inside that top count is added as a name-only stub on top of it. |
 | `PINNED_TOOLS` | empty | Comma-separated tool names to keep always visible. The web settings UI is the primary way to manage this. |
 
 ### When to enable
@@ -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.dev2865 → ha_mcp_dev-8.6.0.dev2868}/README.md

@@ -347,7 +347,7 @@ Set ENABLE_TOOL_SEARCH=true (or toggle the option in the HA app). The full catal
 
 | Tool | Purpose |
 |------|---------|
-| `ha_search_tools` | BM25 keyword search across all tools. Returns name, description, parameters, and annotations (`readOnlyHint` / `destructiveHint`) so the agent can pick the right one. |
+| `ha_search_tools` | BM25 English-keyword search across all tools, pinned ones included. Hidden tools return name, description, parameters, and annotations (`readOnlyHint` / `destructiveHint`) so the agent can pick the right one; a pinned tool returns a name-only stub (`pinned: true`) pointing back at the tool list, and does not use up a result slot. |
 | `ha_call_read_tool` | Execute a `readOnlyHint` tool by name. Safe — clients can auto-approve. |
 | `ha_call_write_tool` | Execute a write tool that creates or updates data. |
 | `ha_call_delete_tool` | Execute a tool that removes / deletes data. |
@@ -359,7 +359,7 @@ A `ha_manage_*` tool combines several operations, so it is reachable from more t
 | Setting | Default | Description |
 |---------|---------|-------------|
 | `ENABLE_TOOL_SEARCH` | `false` | Replace full tool catalog with search-based discovery (tools deferred behind on-demand search). |
-| `TOOL_SEARCH_MAX_RESULTS` | `5` | Max results returned by `ha_search_tools` (range 2–10). |
+| `TOOL_SEARCH_MAX_RESULTS` | `5` | Max hidden tools returned per `ha_search_tools` call (range 2–10); a pinned tool that ranks inside that top count is added as a name-only stub on top of it. |
 | `PINNED_TOOLS` | empty | Comma-separated tool names to keep always visible. The web settings UI is the primary way to manage this. |
 
 ### When to enable
@@ -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.dev2865 → ha_mcp_dev-8.6.0.dev2868}/pyproject.toml

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

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

@@ -23,11 +23,14 @@ 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,
+    TOOL_DISCOVERY_INSTRUCTIONS,
 )
 from .tools.helpers import raise_tool_error
 from .transforms import DEFAULT_PINNED_TOOLS
@@ -128,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(
@@ -380,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.
 
@@ -456,32 +454,8 @@ class HomeAssistantSmartMCPServer:
 
         # Append tool search instructions when enabled
         if self.settings.enable_tool_search:
-            instructions += (
-                "\n\n## Tool Discovery\n"
-                "This server uses search-based tool discovery. Most tools "
-                "are NOT listed directly \u2014 use ha_search_tools to find them.\n\n"
-                "WORKFLOW:\n"
-                '1. Call ha_search_tools(query="...") to find relevant tools\n'
-                "2. Results include name, description, parameters, and "
-                "annotations (readOnlyHint/destructiveHint)\n"
-                "3. Execute the discovered tool \u2014 two options:\n"
-                "   a) DIRECT CALL (preferred): Call the tool directly by "
-                "name. All discovered tools are callable without a proxy.\n"
-                "   b) VIA PROXY: For permission-gated execution, use the "
-                "matching proxy:\n"
-                "      - ha_call_read_tool \u2014 safe, read-only operations\n"
-                "      - ha_call_write_tool \u2014 creates or modifies data\n"
-                "      - ha_call_delete_tool \u2014 removes data permanently\n\n"
-                "Once you know a tool\u2019s name, you do NOT need to search "
-                "again \u2014 call it directly.\n\n"
-                f"A few default tools are listed directly "
-                f"({', '.join(DEFAULT_PINNED_TOOLS)}) — these are the "
-                f"starting pins, and users can unpin the non-mandatory "
-                f"ones via the Tools tab in the settings UI, so the "
-                f"actual visible set may be a subset of this list. "
-                f"Everything else must be discovered via search.\n\n"
-                "DO NOT assume a capability is unavailable because you "
-                "don't see a direct tool for it. ALWAYS search first."
+            instructions += TOOL_DISCOVERY_INSTRUCTIONS.format(
+                pinned=", ".join(DEFAULT_PINNED_TOOLS)
             )
 
         return instructions

{ha_mcp_dev-8.6.0.dev2865 → ha_mcp_dev-8.6.0.dev2868}/src/ha_mcp/server_tool_text.py

@@ -9,12 +9,15 @@ from __future__ import annotations
 
 # Description for the unified search tool
 SEARCH_TOOL_DESCRIPTION = (
-    "Search ALL Home Assistant tools by keyword. Returns matching tools "
-    "with descriptions, parameters, and annotations (read/write/delete). "
-    "Categories: entities, states, automations, scripts, dashboards, "
-    "helpers, HACS, calendar, zones, labels, groups, areas, floors, "
-    "history, statistics, devices, integrations, services, backups, "
-    "todo, camera, blueprints, system, and more.\n\n"
+    "Search ALL Home Assistant tools by ENGLISH keyword. Returns matching "
+    "tools with descriptions, parameters, and annotations "
+    "(read/write/delete). Categories: entities, states, automations, "
+    "scripts, dashboards, helpers, HACS, calendar, zones, labels, groups, "
+    "areas, floors, history, statistics, devices, integrations, services, "
+    "backups, todo, camera, blueprints, system, and more.\n\n"
+    "Tools already in your tool list are callable directly \u2014 no search "
+    "needed. If one matches a search, it comes back as a name-only stub "
+    "(pinned: true); use the schema you already have.\n\n"
     "WORKFLOW:\n"
     "1. ha_search_tools(query='...') \u2014 find tools (this tool)\n"
     "2. Execute: call the tool DIRECTLY by name (preferred), or use "
@@ -32,6 +35,42 @@ SEARCH_TOOL_DESCRIPTION = (
     "Most tools are discoverable only through this search."
 )
 
+# Appended to the server instructions when tool search is on; ``{pinned}``
+# is the comma-joined DEFAULT_PINNED_TOOLS.
+TOOL_DISCOVERY_INSTRUCTIONS = (
+    "\n\n## Tool Discovery\n"
+    "Tools already in your tool list are callable directly — "
+    "do not search for them. Once you know any tool’s name, "
+    "call it directly; never search for the same tool twice.\n\n"
+    "Most other tools are NOT listed directly — use "
+    "ha_search_tools to find them.\n\n"
+    "WORKFLOW:\n"
+    '1. Call ha_search_tools(query="...") with ENGLISH keywords '
+    "naming the operation (e.g. 'get entity state'). Translate "
+    "other languages first; entity, area and device names keep "
+    "their original spelling.\n"
+    "2. Results include name, description, parameters, and "
+    "annotations (readOnlyHint/destructiveHint). A tool already "
+    "in your list comes back as a name-only stub (pinned: true) "
+    "— use the schema you already have.\n"
+    "3. Execute the discovered tool — two options:\n"
+    "   a) DIRECT CALL (preferred): Call the tool directly by "
+    "name. All discovered tools are callable without a proxy.\n"
+    "   b) VIA PROXY: For permission-gated execution, use the "
+    "matching proxy:\n"
+    "      - ha_call_read_tool — safe, read-only operations\n"
+    "      - ha_call_write_tool — creates or modifies data\n"
+    "      - ha_call_delete_tool — removes data permanently\n\n"
+    "A few default tools are listed directly "
+    "({pinned}) — these are the "
+    "starting pins, and users can unpin the non-mandatory "
+    "ones via the Tools tab in the settings UI, so the "
+    "actual visible set may be a subset of this list. "
+    "Everything else must be discovered via search.\n\n"
+    "DO NOT assume a capability is unavailable because you "
+    "don't see a direct tool for it. ALWAYS search first."
+)
+
 # Extra keywords appended to tool descriptions for BM25 ranking.
 # Applied unconditionally via SearchKeywordsTransform so they also
 # improve retrieval for Claude's native deferred-tool search on
@@ -72,8 +111,12 @@ SEARCH_KEYWORDS: dict[str, str] = {
         "counter timer input_datetime input_select"
     ),
     "ha_get_entity": ("get entity state attributes details single specific entity_id"),
+    # #2576: BM25 has no stemming, so "lights" never matched "light". No
+    # control verbs (on/off/turn) here: they would pull "turn off lights"
+    # onto this read tool.
     "ha_get_state": (
-        "get current state value single entity check status bulk multiple states"
+        "get current state value single entity check status bulk multiple states "
+        "which lights"
     ),
     "ha_config_set_automation": (
         "create update modify edit automation triggers conditions actions "
@@ -391,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
@@ -404,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 "
@@ -482,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."
+)

{ha_mcp_dev-8.6.0.dev2865 → ha_mcp_dev-8.6.0.dev2868}/src/ha_mcp/settings_ui/locales/en.json

@@ -132,7 +132,7 @@
     "features.enable_tool_search.label": "Enable tool search",
     "features.enable_tool_search.help": "Replace the full tool catalog with search-based discovery. Reduces idle context by roughly 90%, to about 5K tokens. ⚠️ Do NOT enable this in clients with their own built-in tool search / deferred tools (claude.ai, Claude Desktop, Claude Code) — the two search layers conflict, and the client's built-in tool search is the better choice there; leave this off. Whether tools are deferred depends on your client and model combination: use this when your setup loads the full catalog up front — models without native deferred tools (e.g. Gemini, OpenAI-compatible local models, Claude Haiku), clients that inline all tool schemas regardless of model (e.g. GitHub Copilot CLI), or smaller context windows. Some Codex models and ChatGPT include deferred tools too — check your client/model directly to confirm its features so you don't leave this enabled unnecessarily. Tools are found via ha_search_tools and executed via categorized proxies (read/write/delete). Requires restart to take effect.",
     "features.tool_search_max_results.label": "Tool search max results",
-    "features.tool_search_max_results.help": "Maximum number of tools returned by ha_search_tools when tool search is enabled. Lower values (2-3) save context tokens but may miss relevant tools. Range: 2-10. Requires restart.",
+    "features.tool_search_max_results.help": "Maximum number of hidden tools returned per ha_search_tools call when tool search is enabled; a pinned tool that ranks inside that top count is added as a short name-only entry on top of it. Lower values (2-3) save context tokens but may miss relevant tools. Range: 2-10. Requires restart.",
     "features.enable_tool_security_policies.label": "Enable Tool Security Policies (advanced)",
     "features.enable_tool_security_policies.help": "Gate high-stakes tool calls (lock/alarm control, automation writes, etc.) behind user approval. When a guarded tool is called, the agent tells the user to open the Tool Security Policies tab in the web UI and click Approve before the call proceeds. Per-tool rules with optional argument conditions are configured in the Tool Security Policies tab. Off by default. Requires restart to take effect.",
     "features.read_only_mode.label": "Read Only Mode",

{ha_mcp_dev-8.6.0.dev2865 → ha_mcp_dev-8.6.0.dev2868}/src/ha_mcp/settings_ui/settings_js/05_feature_flags.js

@@ -13,7 +13,7 @@ const FEATURE_META = {
   },
   tool_search_max_results: {
     label: "Tool search max results",
-    help: "Maximum number of tools returned by ha_search_tools when tool search is enabled. Lower values (2-3) save context tokens but may miss relevant tools. Range: 2-10. Requires restart.",
+    help: "Maximum number of hidden tools returned per ha_search_tools call when tool search is enabled; a pinned tool that ranks inside that top count is added as a short name-only entry on top of it. Lower values (2-3) save context tokens but may miss relevant tools. Range: 2-10. Requires restart.",
   },
   enable_tool_security_policies: {
     label: "Enable Tool Security Policies (advanced)",

{ha_mcp_dev-8.6.0.dev2865 → ha_mcp_dev-8.6.0.dev2868}/src/ha_mcp/tools/backup.py

@@ -1667,11 +1667,11 @@ survives an agent's own mistakes.
 - List snapshots (to discover a backup_id or confirm one landed): `ha_manage_backup(scope="snapshot", action="list")`
 - Restore full snapshot: `ha_manage_backup(scope="snapshot", action="restore", backup_id="dd7550ed")`
 - Delete an old snapshot (requires `enable_snapshot_delete=true`): `ha_manage_backup(scope="snapshot", action="delete", backup_id="dd7550ed", confirm=True)`
-- On-demand entity snapshot before a manual UI edit: `ha_manage_backup(scope="edits", action="create", domain="helper_input_boolean", entity_id="kitchen_lights_active")`
-- List recent auto-backups for one automation: `ha_manage_backup(scope="edits", action="list", domain="automation", entity_id="kitchen_lights")`
-- View an auto-backup: `ha_manage_backup(scope="edits", action="view", backup_name="automation.kitchen_lights.20260521_153000.yaml")`
-- Diff an auto-backup vs current state: `ha_manage_backup(scope="edits", action="diff", backup_name="automation.kitchen_lights.20260521_153000.yaml")`
-- Restore an auto-backup: `ha_manage_backup(scope="edits", action="restore", backup_name="automation.kitchen_lights.20260521_153000.yaml")`
+- On-demand entity snapshot before a manual UI edit: `ha_manage_backup(scope="edits", action="create", domain="helper_input_boolean", entity_id="welcome_home_active")`
+- List recent auto-backups for one automation: `ha_manage_backup(scope="edits", action="list", domain="automation", entity_id="welcome_home")`
+- View an auto-backup: `ha_manage_backup(scope="edits", action="view", backup_name="automation.welcome_home.20260521_153000.yaml")`
+- Diff an auto-backup vs current state: `ha_manage_backup(scope="edits", action="diff", backup_name="automation.welcome_home.20260521_153000.yaml")`
+- Restore an auto-backup: `ha_manage_backup(scope="edits", action="restore", backup_name="automation.welcome_home.20260521_153000.yaml")`
 - Delete one auto-backup: `ha_manage_backup(scope="edits", action="delete", backup_name="...")`
 - Bulk-delete old auto-backups: `ha_manage_backup(scope="edits", action="delete", older_than_days=30)`
 """