ha-mcp-dev 7.14.2.dev2162__tar.gz → 7.14.2.dev2165__tar.gz

{ha_mcp_dev-7.14.2.dev2162/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.14.2.dev2165}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.14.2.dev2162
+Version: 7.14.2.dev2165
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT
@@ -370,7 +370,7 @@ If your model can't see the tools or your Home Assistant, it may be getting hand
 
 ### Enable search-based discovery
 
-Set ENABLE_TOOL_SEARCH=true (or toggle the option in the HA add-on). The full catalog is replaced in the tool list with four entry points plus a small set of always-visible "pinned" tools (ha_search_entities, ha_get_overview, ha_restart, etc.). All tools remain callable directly by name once discovered:
+Set ENABLE_TOOL_SEARCH=true (or toggle the option in the HA add-on). The full catalog is replaced in the tool list with four entry points plus a small set of always-visible "pinned" tools (ha_search, ha_get_overview, ha_report_issue, etc.). All tools remain callable directly by name once discovered:
 
 | Tool | Purpose |
 |------|---------|

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/README.md

@@ -337,7 +337,7 @@ If your model can't see the tools or your Home Assistant, it may be getting hand
 
 ### Enable search-based discovery
 
-Set ENABLE_TOOL_SEARCH=true (or toggle the option in the HA add-on). The full catalog is replaced in the tool list with four entry points plus a small set of always-visible "pinned" tools (ha_search_entities, ha_get_overview, ha_restart, etc.). All tools remain callable directly by name once discovered:
+Set ENABLE_TOOL_SEARCH=true (or toggle the option in the HA add-on). The full catalog is replaced in the tool list with four entry points plus a small set of always-visible "pinned" tools (ha_search, ha_get_overview, ha_report_issue, etc.). All tools remain callable directly by name once discovered:
 
 | Tool | Purpose |
 |------|---------|

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.14.2.dev2162"
+version = "7.14.2.dev2165"
 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-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/__init__.py

@@ -2,7 +2,7 @@
 Home Assistant MCP Server
 
 A Model Context Protocol server that provides complete control over Home Assistant
-through REST API and WebSocket integration with 20+ enhanced tools.
+through REST API and WebSocket integration.
 """
 
 from ._version import get_version

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/client/rest_client.py

@@ -412,28 +412,6 @@ class HomeAssistantClient:
         logger.debug(f"Fetching state for entity: {entity_id}")
         return await self._request("GET", f"/states/{entity_id}")
 
-    async def set_entity_state(
-        self, entity_id: str, state: str, attributes: dict[str, Any] | None = None
-    ) -> dict[str, Any]:
-        """
-        Set entity state.
-
-        Args:
-            entity_id: Entity ID
-            state: New state value
-            attributes: Optional attributes dictionary
-
-        Returns:
-            Updated entity state
-        """
-        logger.debug(f"Setting state for entity {entity_id} to {state}")
-
-        payload: dict[str, Any] = {"state": state}
-        if attributes:
-            payload["attributes"] = attributes
-
-        return await self._request("POST", f"/states/{entity_id}", json=payload)
-
     async def call_service(
         self,
         domain: str,
@@ -490,41 +468,6 @@ class HomeAssistantClient:
         logger.debug("Fetching available services")
         return await self._request("GET", "/services")
 
-    async def get_history(
-        self,
-        entity_id: str | None = None,
-        start_time: str | None = None,
-        end_time: str | None = None,
-    ) -> list[list[dict[str, Any]]]:
-        """
-        Get historical data.
-
-        Args:
-            entity_id: Optional entity ID to filter
-            start_time: Optional start time (ISO format)
-            end_time: Optional end time (ISO format)
-
-        Returns:
-            Historical data
-        """
-        logger.debug(f"Fetching history for entity: {entity_id}")
-
-        params = {}
-        if start_time:
-            params["start_time"] = start_time
-        if end_time:
-            params["end_time"] = end_time
-
-        endpoint = "/history/period"
-        if entity_id:
-            endpoint += f"/{entity_id}"
-
-        result = await self._request("GET", endpoint, params=params)
-        if isinstance(result, list):
-            return result
-        else:
-            return []
-
     async def get_logbook(
         self,
         entity_id: str | None = None,
@@ -962,15 +905,6 @@ class HomeAssistantClient:
             logger.error(f"Failed to connect to Home Assistant: {e}")
             return False, str(e)
 
-    async def get_system_health(self) -> dict[str, Any]:
-        """Get system health information."""
-        logger.debug("Fetching system health")
-        try:
-            return await self._request("GET", "/system_health/info")
-        except HomeAssistantAPIError:
-            # System health might not be available in all HA instances
-            return {"status": "unknown", "message": "System health not available"}
-
     # Automation Configuration Management
 
     async def _resolve_automation_id(self, identifier: str) -> str:
@@ -2097,14 +2031,3 @@ class HomeAssistantClient:
                     status_code=405,
                 ) from e
             raise
-
-
-async def create_client() -> HomeAssistantClient:
-    """Create and return a new Home Assistant client."""
-    return HomeAssistantClient()
-
-
-async def test_connection_with_config() -> tuple[bool, str | None]:
-    """Test connection using configuration settings."""
-    async with HomeAssistantClient() as client:
-        return await client.test_connection()

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/client/websocket_listener.py

@@ -7,7 +7,6 @@ WebSocket events and updates operation status in real-time.
 
 import asyncio
 import logging
-from datetime import datetime
 from typing import Any
 
 from ..config import get_global_settings
@@ -29,13 +28,6 @@ class WebSocketListenerService:
         self.cleanup_task: asyncio.Task | None = None
         self.running = False
         self._event_loop: asyncio.AbstractEventLoop | None = None
-        self.stats: dict[str, Any] = {
-            "events_processed": 0,
-            "operations_updated": 0,
-            "connection_errors": 0,
-            "last_event_time": None,
-            "start_time": None,
-        }
 
     async def start(self) -> bool:
         """Start the WebSocket listener service.
@@ -64,7 +56,6 @@ class WebSocketListenerService:
             self.cleanup_task = asyncio.create_task(self._periodic_cleanup())
 
             self.running = True
-            self.stats["start_time"] = datetime.now()
 
             logger.info("WebSocket listener service started successfully")
             return True
@@ -141,11 +132,6 @@ class WebSocketListenerService:
         entity_id: str | None = None
         new_state: dict[str, Any] | None = None
         try:
-            events_processed = self.stats["events_processed"]
-            if isinstance(events_processed, int):
-                self.stats["events_processed"] = events_processed + 1
-            self.stats["last_event_time"] = datetime.now()
-
             # Extract event data — fields are nested under ``event["data"]``.
             event_data = event.get("data") or {}
             entity_id = event_data.get("entity_id")
@@ -164,11 +150,6 @@ class WebSocketListenerService:
             # Update pending operations
             updated_ops = update_pending_operations(entity_id, new_state)
             if updated_ops:
-                operations_updated = self.stats["operations_updated"]
-                if isinstance(operations_updated, int):
-                    self.stats["operations_updated"] = operations_updated + len(
-                        updated_ops
-                    )
                 logger.info(f"Updated {len(updated_ops)} operations for {entity_id}")
 
         except (RuntimeError, ConnectionError, OSError) as e:
@@ -198,14 +179,8 @@ class WebSocketListenerService:
                     ping_success = await self.websocket_client.ping()
                     if not ping_success:
                         logger.warning("WebSocket ping failed")
-                        connection_errors = self.stats["connection_errors"]
-                        if isinstance(connection_errors, int):
-                            self.stats["connection_errors"] = connection_errors + 1
                 else:
                     logger.warning("WebSocket connection lost")
-                    connection_errors = self.stats["connection_errors"]
-                    if isinstance(connection_errors, int):
-                        self.stats["connection_errors"] = connection_errors + 1
 
                     # Try to reconnect
                     try:
@@ -241,67 +216,6 @@ class WebSocketListenerService:
                 logger.error(f"Cleanup task error: {e}")
                 await asyncio.sleep(300)
 
-    def get_status(self) -> dict[str, Any]:
-        """Get service status and statistics.
-
-        Returns:
-            Dictionary with service status and statistics
-        """
-        uptime: float | None = None
-        start_time = self.stats["start_time"]
-        if isinstance(start_time, datetime):
-            uptime = (datetime.now() - start_time).total_seconds()
-
-        return {
-            "running": self.running,
-            "websocket_connected": (
-                self.websocket_client.is_connected if self.websocket_client else False
-            ),
-            "uptime_seconds": uptime,
-            "statistics": {
-                **self.stats,
-                "last_event_time": (
-                    self.stats["last_event_time"].isoformat()
-                    if isinstance(self.stats["last_event_time"], datetime)
-                    else None
-                ),
-                "start_time": (
-                    self.stats["start_time"].isoformat()
-                    if isinstance(self.stats["start_time"], datetime)
-                    else None
-                ),
-            },
-            "operation_summary": self.operation_manager.get_operations_summary(),
-        }
-
-    async def force_reconnect(self) -> bool:
-        """Force a WebSocket reconnection.
-
-        Returns:
-            True if reconnection successful
-        """
-        try:
-            if self.websocket_client:
-                self.websocket_client.remove_event_handler(
-                    "state_changed", self._handle_state_change
-                )
-
-            self.websocket_client = await get_websocket_client()
-            await self.websocket_client.subscribe_events("state_changed")
-            self.websocket_client.add_event_handler(
-                "state_changed", self._handle_state_change
-            )
-
-            logger.info("Forced WebSocket reconnection successful")
-            return True
-
-        except Exception as e:
-            logger.error(f"Forced reconnection failed: {e}")
-            connection_errors = self.stats["connection_errors"]
-            if isinstance(connection_errors, int):
-                self.stats["connection_errors"] = connection_errors + 1
-            return False
-
 
 # Global listener service instance
 _listener_service: WebSocketListenerService | None = None
@@ -353,40 +267,3 @@ async def stop_websocket_listener() -> None:
     if _listener_service:
         await _listener_service.stop()
         _listener_service = None
-
-
-async def get_listener_status() -> dict[str, Any]:
-    """Get WebSocket listener service status."""
-    service = await get_listener_service()
-    return service.get_status()
-
-
-class WebSocketContextManager:
-    """Context manager for WebSocket listener lifecycle."""
-
-    def __init__(self) -> None:
-        self.service: WebSocketListenerService | None = None
-
-    async def __aenter__(self) -> WebSocketListenerService:
-        """Start WebSocket listener."""
-        service = await get_listener_service()
-        success = await service.start()
-        if not success:
-            raise Exception("Failed to start WebSocket listener")
-        self.service = service
-        return service
-
-    async def __aexit__(
-        self,
-        exc_type: type[BaseException] | None,
-        exc_val: BaseException | None,
-        exc_tb: object,
-    ) -> None:
-        """Stop WebSocket listener."""
-        if self.service:
-            await self.service.stop()
-
-
-def websocket_listener_context() -> WebSocketContextManager:
-    """Create a WebSocket listener context manager."""
-    return WebSocketContextManager()

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/config.py

@@ -63,10 +63,9 @@ class Settings(BaseSettings):
 
     # Tool configuration
     fuzzy_threshold: int = Field(60, alias="FUZZY_THRESHOLD")
-    entity_search_limit: int = Field(20, alias="ENTITY_SEARCH_LIMIT")
 
     # Smart-search config-fetch time budgets (seconds). Bound how long
-    # ha_search / ha_deep_search spends fetching automation/script/scene
+    # ha_search spends fetching automation/script/scene
     # definitions during the per-id fallback before reporting a partial
     # result. Surfaced in the Advanced settings panel (issue #1538) so
     # add-on users — who cannot set raw env vars — can tune them. Consumed
@@ -466,11 +465,6 @@ class Settings(BaseSettings):
             return int(val)
         return val
 
-    @property
-    def env_file_name(self) -> str:
-        """Get the current environment file name."""
-        return os.getenv("HAMCP_ENV_FILE", ".env")
-
     @field_validator("homeassistant_url")
     @classmethod
     def validate_homeassistant_url(cls, v: str) -> str:
@@ -580,28 +574,6 @@ def get_settings() -> Settings:
     return Settings()  # type: ignore[call-arg]
 
 
-def validate_settings() -> tuple[bool, str | None]:
-    """
-    Validate settings and return (is_valid, error_message).
-
-    Returns:
-        tuple: (True, None) if valid, (False, error_message) if invalid
-    """
-    try:
-        settings = get_settings()
-
-        # Additional validation
-        if not settings.homeassistant_url:
-            return False, "Home Assistant URL is required"
-
-        if not settings.homeassistant_token:
-            return False, "Home Assistant token is required"
-
-        return True, None
-    except Exception as e:
-        return False, str(e)
-
-
 # Runtime-editable feature flags surfaced in the /settings web UI
 # (issue #863). Each entry is (field_name, env_var_name, python_type).
 # The web UI's /api/settings/features GET/POST endpoints iterate this
@@ -811,7 +783,6 @@ ADVANCED_SETTINGS_FIELDS: tuple[AdvancedField, ...] = (
     AdvancedField("verify_ssl", "HA_VERIFY_SSL", bool, "operations", True),
     # Search & matching.
     AdvancedField("fuzzy_threshold", "FUZZY_THRESHOLD", int, "search", True),
-    AdvancedField("entity_search_limit", "ENTITY_SEARCH_LIMIT", int, "search", True),
     # Smart-search config-fetch time budgets (#1538). Restart-required
     # (consumed as import-time constants in smart_search/_config.py).
     AdvancedField(
@@ -941,12 +912,11 @@ ADVANCED_SETTINGS_FIELDS: tuple[AdvancedField, ...] = (
 # Bounds present on the Settings field today (mirrored):
 #   fuzzy_threshold (validator 0-100), code_mode_* (Field ge/le).
 # Bounds added purely as UI/POST guardrails (no Field constraint):
-#   timeout, max_retries, entity_search_limit.
+#   timeout, max_retries.
 _ADVANCED_SETTINGS_BOUNDS: dict[str, tuple[float, float]] = {
     "timeout": (1, 600),
     "max_retries": (0, 20),
     "fuzzy_threshold": (0, 100),
-    "entity_search_limit": (1, 1000),
     "automation_config_time_budget": (1.0, 600.0),
     "script_config_time_budget": (1.0, 600.0),
     "scene_config_time_budget": (1.0, 600.0),

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/policy/value_sources.py

@@ -50,10 +50,6 @@ _CACHE_TTL_SECONDS = 30.0
 _cache: dict[str, tuple[float, list[str]]] = {}
 
 
-def value_source_for(tool_name: str, arg_path: str) -> str | None:
-    return VALUE_SOURCE_REGISTRY.get((tool_name, arg_path))
-
-
 def all_value_sources_for(tool_name: str) -> dict[str, str]:
     """Return {arg_path: value_source} for one tool — used by the UI to
     decide which paths render as dropdowns vs free-text."""

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/server.py

@@ -11,7 +11,7 @@ from __future__ import annotations
 
 import logging
 from pathlib import Path
-from typing import TYPE_CHECKING, Annotated, Any, ClassVar, cast
+from typing import TYPE_CHECKING, Annotated, Any, ClassVar
 
 import yaml  # type: ignore[import-untyped]
 from fastmcp import FastMCP
@@ -20,9 +20,7 @@ from pydantic import Field
 
 from .config import _PACKAGE_VERSION, get_global_settings
 from .errors import ErrorCode, create_error_response
-from .tools.enhanced import EnhancedToolsMixin
 from .tools.helpers import raise_tool_error
-from .tools.util_helpers import strip_internal_fields
 from .transforms import DEFAULT_PINNED_TOOLS
 
 if TYPE_CHECKING:
@@ -77,7 +75,7 @@ SERVER_ICONS = [
 ]
 
 
-class HomeAssistantSmartMCPServer(EnhancedToolsMixin):
+class HomeAssistantSmartMCPServer:
     """Home Assistant MCP Server with smart tools and fuzzy search.
 
     Uses lazy initialization to improve startup time:
@@ -196,9 +194,6 @@ class HomeAssistantSmartMCPServer(EnhancedToolsMixin):
         # Register tools
         self.tools_registry.register_all_tools()
 
-        # Register enhanced tools for first/second interaction success
-        self.register_enhanced_tools()
-
         # Register bundled skills as MCP resources
         self._register_skills()
 
@@ -1789,51 +1784,6 @@ class HomeAssistantSmartMCPServer(EnhancedToolsMixin):
         )
         return response
 
-    # Helper methods required by EnhancedToolsMixin
-
-    async def smart_entity_search(
-        self, query: str, domain_filter: str | None = None, limit: int = 10
-    ) -> dict[str, Any]:
-        """Bridge method to existing smart search implementation."""
-        return cast(
-            dict[str, Any],
-            await self.smart_tools.smart_entity_search(
-                query=query, limit=limit, include_attributes=False
-            ),
-        )
-
-    async def get_entity_state(self, entity_id: str) -> dict[str, Any]:
-        """Bridge method to existing entity state implementation."""
-        return await self.client.get_entity_state(entity_id)
-
-    async def call_service(
-        self,
-        domain: str,
-        service: str,
-        entity_id: str | None = None,
-        data: dict | None = None,
-    ) -> list[dict[str, Any]] | dict[str, Any]:
-        """Bridge method to existing service call implementation."""
-        service_data = data or {}
-        if entity_id:
-            service_data["entity_id"] = entity_id
-        return await self.client.call_service(domain, service, service_data)
-
-    async def get_entities_by_area(self, area_name: str) -> dict[str, Any]:
-        """Bridge method to existing area functionality.
-
-        ``smart_tools.get_entities_by_area`` enriches per-entity dicts
-        with leading-underscore internals (``_hidden_by`` etc.) so
-        downstream search branches can apply the score penalty without
-        a second registry lookup. Strip them here so this public bridge
-        doesn't leak internals to MCP clients.
-        """
-        result = await self.smart_tools.get_entities_by_area(
-            area_query=area_name, group_by_domain=True
-        )
-        strip_internal_fields(result)
-        return cast(dict[str, Any], result)
-
     async def start(self) -> None:
         """Start the Smart MCP server with async compatibility."""
         logger.info(
@@ -1853,8 +1803,8 @@ class HomeAssistantSmartMCPServer(EnhancedToolsMixin):
         except Exception as e:
             logger.error(f"❌ Error testing connection: {e}")
 
-        # Log available tools count
-        logger.info("🔧 Smart server with enhanced tools loaded")
+        # Log successful server initialization
+        logger.info("🔧 Home Assistant MCP tools loaded")
 
         # Run the MCP server with async compatibility
         await self.mcp.run_async()

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/settings_ui/locales/de.json

@@ -371,8 +371,6 @@
     "advanced.verify_ssl.help": "Deaktiviere TLS-Überprüfung nur in vertrauenswürdigen Netzwerken. Neustart erforderlich.",
     "advanced.fuzzy_threshold.label": "Fuzzy-Such-Schwellenwert",
     "advanced.fuzzy_threshold.help": "Niedrigere Werte erlauben lockerere Entitätsabgleichung. Bereich 0-100.",
-    "advanced.entity_search_limit.label": "Entitätssuchergebnis-Limit",
-    "advanced.entity_search_limit.help": "Maximale Entitäten, die von ha_search_entities zurückgegeben werden. Bereich 1-1000.",
     "advanced.automation_config_time_budget.label": "Automatisierungskonfigurations-Zeitbudget (s)",
     "advanced.automation_config_time_budget.help": "Maximale Zeit, die die Tiefensuche für das Abrufen von Automatisierungskonfigurationen aufwendet. Bereich 1-600. Neustart erforderlich.",
     "advanced.script_config_time_budget.label": "Skriptkonfigurations-Zeitbudget (s)",

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/settings_ui/locales/en.json

@@ -371,8 +371,6 @@
     "advanced.verify_ssl.help": "Disable TLS verification only on trusted networks. Restart required.",
     "advanced.fuzzy_threshold.label": "Fuzzy-search threshold",
     "advanced.fuzzy_threshold.help": "Lower values allow looser entity matching. Range 0–100.",
-    "advanced.entity_search_limit.label": "Entity search result limit",
-    "advanced.entity_search_limit.help": "Maximum entities returned by ha_search_entities. Range 1–1000.",
     "advanced.automation_config_time_budget.label": "Automation config time budget (s)",
     "advanced.automation_config_time_budget.help": "Maximum time deep search spends fetching automation configs. Range 1–600. Restart required.",
     "advanced.script_config_time_budget.label": "Script config time budget (s)",

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/settings_ui/locales/fr.json

@@ -371,8 +371,6 @@
     "advanced.verify_ssl.help": "Désactive la vérification TLS uniquement sur les réseaux de confiance. Redémarrage requis.",
     "advanced.fuzzy_threshold.label": "Seuil de recherche floue",
     "advanced.fuzzy_threshold.help": "Des valeurs plus basses permettent une correspondance d'entités plus lâche. Plage 0–100.",
-    "advanced.entity_search_limit.label": "Limite des résultats de recherche d'entités",
-    "advanced.entity_search_limit.help": "Nombre maximum d'entités renvoyées par ha_search_entities. Plage 1–1000.",
     "advanced.automation_config_time_budget.label": "Budget de temps de configuration d'automatisation (s)",
     "advanced.automation_config_time_budget.help": "Temps maximum que la recherche approfondie consacre à la récupération des configurations d'automatisation. Plage 1–600. Redémarrage requis.",
     "advanced.script_config_time_budget.label": "Budget de temps de configuration de script (s)",

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/settings_ui/locales/ru.json

@@ -371,8 +371,6 @@
     "advanced.verify_ssl.help": "Отключайте проверку TLS только в доверенной сети. Нужен перезапуск.",
     "advanced.fuzzy_threshold.label": "Порог нечёткого поиска",
     "advanced.fuzzy_threshold.help": "Меньшее значение даёт более свободное сопоставление сущностей. Диапазон 0–100.",
-    "advanced.entity_search_limit.label": "Лимит результатов поиска сущностей",
-    "advanced.entity_search_limit.help": "Максимум сущностей, возвращаемых ha_search_entities. Диапазон 1–1000.",
     "advanced.automation_config_time_budget.label": "Бюджет времени конфигураций автоматизаций (с)",
     "advanced.automation_config_time_budget.help": "Максимальное время глубокого поиска для загрузки автоматизаций. 1–600. Нужен перезапуск.",
     "advanced.script_config_time_budget.label": "Бюджет времени конфигураций скриптов (с)",

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/settings_ui/locales/zh-Hans.json

@@ -371,8 +371,6 @@
     "advanced.verify_ssl.help": "仅在受信任网络上禁用 TLS 验证。需重启。",
     "advanced.fuzzy_threshold.label": "模糊搜索阈值",
     "advanced.fuzzy_threshold.help": "较低的值允许更宽松的实体匹配。范围 0–100。",
-    "advanced.entity_search_limit.label": "实体搜索结果上限",
-    "advanced.entity_search_limit.help": "ha_search_entities 返回的最大实体数。范围 1–1000。",
     "advanced.automation_config_time_budget.label": "自动化配置时间预算（秒）",
     "advanced.automation_config_time_budget.help": "深度搜索获取自动化配置所花费的最大时间。范围 1–600。需重启。",
     "advanced.script_config_time_budget.label": "脚本配置时间预算（秒）",

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/settings_ui/settings.js

@@ -3475,10 +3475,9 @@ const ADVANCED_FIELD_META = {
   max_retries:         { label: "HA request max retries",      help: "Retry budget per failed REST call. Range 0–20. Restart required." },
   verify_ssl:          { label: "Verify SSL certificates",     help: "Skip TLS verification only on trusted networks (self-signed certs, hostname mismatch). Restart required." },
   fuzzy_threshold:     { label: "Fuzzy-search threshold",      help: "Lower = looser entity match. Range 0–100." },
-  entity_search_limit: { label: "Entity search result limit",  help: "Max entities returned by ha_search_entities. Range 1–1000." },
-  automation_config_time_budget: { label: "Automation config time budget (s)", help: "Max seconds ha_search/ha_deep_search spends fetching automation configs before returning a partial result. Raise on instances with many automations. Range 1–600. Restart required." },
-  script_config_time_budget:     { label: "Script config time budget (s)",     help: "Max seconds ha_search/ha_deep_search spends fetching script configs before returning a partial result. Range 1–600. Restart required." },
-  scene_config_time_budget:      { label: "Scene config time budget (s)",      help: "Max seconds ha_search/ha_deep_search spends fetching scene configs before returning a partial result. Range 1–600. Restart required." },
+  automation_config_time_budget: { label: "Automation config time budget (s)", help: "Max seconds deep search spends fetching automation configs before returning a partial result. Raise on instances with many automations. Range 1–600. Restart required." },
+  script_config_time_budget:     { label: "Script config time budget (s)",     help: "Max seconds deep search spends fetching script configs before returning a partial result. Range 1–600. Restart required." },
+  scene_config_time_budget:      { label: "Scene config time budget (s)",      help: "Max seconds deep search spends fetching scene configs before returning a partial result. Range 1–600. Restart required." },
   individual_config_timeout:     { label: "Per-request config fetch timeout (s)", help: "Timeout for each individual automation/script/scene config fetch during deep search. On HA servers that serve config reads serially, raise this and/or lower the batch size so queued requests don't time out. Values above the HA request timeout (HA_TIMEOUT, default 30) have no extra effect — the HTTP client gives up first. Range 1–600. Restart required." },
   individual_fetch_batch_size:   { label: "Config fetch batch size",          help: "How many per-id config fetches deep search issues concurrently. Lower toward 1 on HA servers that serve config reads serially (symptom: 'timed out' partial-result warnings). Range 1–100. Restart required." },
   backup_hint:         { label: "Backup-hint level",           help: "Tunes how strongly the LLM is prompted to take a full-HA snapshot before risky writes." },
@@ -3512,7 +3511,7 @@ const ADVANCED_RESTART_REQUIRED = new Set([
   "log_level", "debug",
   "mcp_server_name", "mcp_server_version", "environment",
   // fuzzy_threshold is read once by SmartSearchTools at the
-  // lazy-init singleton (tools/smart_search.py) — changes
+  // lazy-init singleton (tools/smart_search/) — changes
   // need restart to rebuild the searcher.
   "fuzzy_threshold",
   // The three smart-search time budgets are read once at import by

{ha_mcp_dev-7.14.2.dev2162 → ha_mcp_dev-7.14.2.dev2165}/src/ha_mcp/tools/smart_search/_deep.py

@@ -138,7 +138,7 @@ class DeepSearchMixin(SceneSearchMixin):
                 (it never fetches the registry on its own — see
                 ``_deep_search_helpers``). The orchestrator only hands one down
                 when both the entity and config-body branches run, so direct
-                ``deep_search``/``ha_deep_search`` callers get ``None`` here.
+                ``deep_search`` callers get ``None`` here.
 
         Returns:
             Dictionary with search results grouped by type
@@ -881,7 +881,7 @@ class DeepSearchMixin(SceneSearchMixin):
         here — this path adds no request) to map each input_* helper's storage
         ``unique_id`` to its CURRENT entity_id + name so a UI rename doesn't
         hide the helper from a search for its new name (#1794). ``None`` on the
-        direct ``deep_search``/``ha_deep_search`` path yields an empty map and
+        direct ``deep_search`` path yields an empty map and
         storage-name-only matching.
         """
         helper_types = [