ha-mcp-dev 6.3.1.dev137__py3-none-any.whl

ha_mcp/utils/usage_logger.py

@@ -0,0 +1,290 @@
+"""
+Usage logging for MCP tool calls to track usage patterns and performance metrics.
+"""
+
+import json
+import logging
+import threading
+import time
+from collections import deque
+from dataclasses import asdict, dataclass
+from datetime import UTC, datetime
+from pathlib import Path
+from queue import Queue
+from typing import Any
+
+
+# Default ring buffer size - keeps last N entries in memory
+DEFAULT_RING_BUFFER_SIZE = 200
+
+# Average log entries per tool call (empirically observed)
+# This includes the tool itself plus any associated operations
+AVG_LOG_ENTRIES_PER_TOOL = 3
+
+# Startup log collection duration in seconds
+STARTUP_LOG_DURATION_SECONDS = 60
+
+
+class StartupLogCollector(logging.Handler):
+    """Collects log messages during the first minute of server startup."""
+
+    def __init__(self, duration_seconds: int = STARTUP_LOG_DURATION_SECONDS):
+        super().__init__()
+        self._start_time = time.time()
+        self._duration = duration_seconds
+        self._logs: list[dict[str, Any]] = []
+        self._lock = threading.Lock()
+        self._active = True
+
+    def emit(self, record: logging.LogRecord) -> None:
+        """Capture log record if within startup window."""
+        if not self._active:
+            return
+
+        elapsed = time.time() - self._start_time
+        if elapsed > self._duration:
+            self._active = False
+            return
+
+        with self._lock:
+            self._logs.append({
+                "timestamp": datetime.now(UTC).isoformat(),
+                "level": record.levelname,
+                "logger": record.name,
+                "message": record.getMessage(),
+                "elapsed_seconds": round(elapsed, 2),
+            })
+
+    def get_logs(self) -> list[dict[str, Any]]:
+        """Get collected startup logs."""
+        with self._lock:
+            return list(self._logs)
+
+    def is_active(self) -> bool:
+        """Check if still collecting startup logs."""
+        return self._active and (time.time() - self._start_time) <= self._duration
+
+
+# Global startup log collector - initialized at module import
+_startup_collector: StartupLogCollector | None = None
+
+
+def _init_startup_collector() -> None:
+    """Initialize startup log collector and attach to root logger."""
+    global _startup_collector
+    if _startup_collector is None:
+        _startup_collector = StartupLogCollector()
+        _startup_collector.setLevel(logging.DEBUG)
+        logging.getLogger().addHandler(_startup_collector)
+
+
+# Initialize on module load
+_init_startup_collector()
+
+
+def get_startup_logs() -> list[dict[str, Any]]:
+    """Get startup logs collected during the first minute."""
+    if _startup_collector is None:
+        return []
+    return _startup_collector.get_logs()
+
+
+@dataclass
+class ToolUsageLog:
+    """Single tool usage log entry."""
+
+    timestamp: str
+    tool_name: str
+    parameters: dict[str, Any]
+    execution_time_ms: float
+    success: bool
+    error_message: str | None = None
+    response_size_bytes: int | None = None
+    user_context: str | None = None
+
+
+class UsageLogger:
+    """Async disk logger for MCP tool usage tracking with in-memory ring buffer."""
+
+    def __init__(
+        self,
+        log_file_path: str | None = None,
+        ring_buffer_size: int = DEFAULT_RING_BUFFER_SIZE,
+    ):
+        self._enabled = True
+        
+        if log_file_path:
+            self.log_file_path = Path(log_file_path)
+        else:
+            # Use user's home directory by default to avoid read-only filesystem errors
+            # when running via uvx/npx which might have read-only CWD
+            self.log_file_path = Path.home() / ".ha-mcp" / "logs" / "mcp_usage.jsonl"
+
+        try:
+            self.log_file_path.parent.mkdir(parents=True, exist_ok=True)
+        except OSError:
+            # Directory creation failed (e.g., read-only filesystem)
+            # Disable logging silently to avoid disrupting the MCP server
+            self._enabled = False
+
+        # In-memory ring buffer for fast access to recent logs
+        # Thread-safe: deque is thread-safe for append/pop operations
+        self._ring_buffer: deque[dict[str, Any]] = deque(maxlen=ring_buffer_size)
+        self._buffer_lock = threading.Lock()
+
+        # Thread-safe queue for disk writes
+        self._log_queue: Queue[ToolUsageLog] = Queue()
+        self._logger_thread: threading.Thread | None = None
+        self._stop_event = threading.Event()
+        if self._enabled:
+            self._start_logger_thread()
+
+    def _start_logger_thread(self) -> None:
+        """Start background thread for disk writes."""
+        self._logger_thread = threading.Thread(
+            target=self._log_writer_worker, daemon=True
+        )
+        self._logger_thread.start()
+
+    def _log_writer_worker(self) -> None:
+        """Background thread worker for writing logs to disk."""
+        while not self._stop_event.is_set():
+            try:
+                # Wait for log entry with timeout to check stop event
+                if not self._log_queue.empty():
+                    log_entry = self._log_queue.get(timeout=1.0)
+                    self._write_log_entry(log_entry)
+                else:
+                    # Sleep briefly to avoid busy waiting
+                    threading.Event().wait(0.1)
+            except Exception as e:
+                # Silent error handling to avoid disrupting MCP server
+                print(f"Usage logger error: {e}")
+
+    def _write_log_entry(self, log_entry: ToolUsageLog) -> None:
+        """Write single log entry to disk."""
+        try:
+            with open(self.log_file_path, "a", encoding="utf-8") as f:
+                json.dump(asdict(log_entry), f, ensure_ascii=False)
+                f.write("\n")
+        except Exception:
+            # Silent error handling
+            pass
+
+    def log_tool_usage(
+        self,
+        tool_name: str,
+        parameters: dict[str, Any],
+        execution_time_ms: float,
+        success: bool,
+        error_message: str | None = None,
+        response_size_bytes: int | None = None,
+        user_context: str | None = None,
+    ) -> None:
+        """Log tool usage (non-blocking)."""
+        if not self._enabled:
+            return
+        try:
+            log_entry = ToolUsageLog(
+                timestamp=datetime.now(UTC).isoformat(),
+                tool_name=tool_name,
+                parameters=parameters,
+                execution_time_ms=execution_time_ms,
+                success=success,
+                error_message=error_message,
+                response_size_bytes=response_size_bytes,
+                user_context=user_context,
+            )
+
+            # Add to ring buffer (thread-safe)
+            entry_dict = asdict(log_entry)
+            with self._buffer_lock:
+                self._ring_buffer.append(entry_dict)
+
+            # Queue for disk write
+            self._log_queue.put(log_entry)
+        except Exception:
+            # Silent error handling to never break MCP server
+            pass
+
+    def get_recent_entries(self, count: int) -> list[dict[str, Any]]:
+        """
+        Get recent log entries from the in-memory ring buffer.
+
+        Args:
+            count: Maximum number of entries to return
+
+        Returns:
+            List of log entries as dictionaries, ordered newest to oldest
+        """
+        with self._buffer_lock:
+            # Get the last N entries, reversed to newest-first order
+            buffer_list = list(self._ring_buffer)
+            return list(reversed(buffer_list[-count:]))
+
+    def shutdown(self) -> None:
+        """Gracefully shutdown logger."""
+        self._stop_event.set()
+        if self._logger_thread and self._logger_thread.is_alive():
+            self._logger_thread.join(timeout=2.0)
+
+
+# Global logger instance
+_usage_logger: UsageLogger | None = None
+
+
+def get_usage_logger() -> UsageLogger:
+    """Get global usage logger instance."""
+    global _usage_logger
+    if _usage_logger is None:
+        _usage_logger = UsageLogger()
+    return _usage_logger
+
+
+def log_tool_call(
+    tool_name: str,
+    parameters: dict[str, Any],
+    execution_time_ms: float,
+    success: bool,
+    error_message: str | None = None,
+    response_size_bytes: int | None = None,
+    user_context: str | None = None,
+) -> None:
+    """Convenience function to log tool usage."""
+    logger = get_usage_logger()
+    logger.log_tool_usage(
+        tool_name=tool_name,
+        parameters=parameters,
+        execution_time_ms=execution_time_ms,
+        success=success,
+        error_message=error_message,
+        response_size_bytes=response_size_bytes,
+        user_context=user_context,
+    )
+
+
+def shutdown_usage_logger() -> None:
+    """Shutdown global usage logger."""
+    global _usage_logger
+    if _usage_logger:
+        _usage_logger.shutdown()
+        _usage_logger = None
+
+
+def get_recent_logs(max_entries: int = 20) -> list[dict[str, Any]]:
+    """
+    Get recent log entries from the in-memory ring buffer.
+
+    This is O(1) access - no file I/O required.
+
+    Args:
+        max_entries: Maximum number of log entries to return (most recent first)
+
+    Returns:
+        List of log entries as dictionaries, ordered newest to oldest
+    """
+    logger = get_usage_logger()
+    if not logger._enabled:
+        return []
+
+    return logger.get_recent_entries(max_entries)

ha_mcp_dev-6.3.1.dev137.dist-info/METADATA

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: ha-mcp-dev
+Version: 6.3.1.dev137
+Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
+Author-email: Julien <github@qc-h.net>
+License: MIT
+Project-URL: Homepage, https://github.com/homeassistant-ai/ha-mcp
+Project-URL: Bug Tracker, https://github.com/homeassistant-ai/ha-mcp/issues
+Project-URL: Repository, https://github.com/homeassistant-ai/ha-mcp
+Keywords: mcp,home-assistant,ai,automation,smart-home
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Home Automation
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.14,>=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=2.11.0
+Requires-Dist: httpx[socks]<1.0,>=0.27.0
+Requires-Dist: jq>=1.8.0; sys_platform != "win32"
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: truststore>=0.10.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: cryptography>=45.0.7
+Dynamic: license-file
+
+<div align="center">
+  <img src="docs/img/ha-mcp-logo.png" alt="Home Assistant MCP Server Logo" width="300"/>
+
+  # The Unofficial and Awesome Home Assistant MCP Server
+
+  <!-- mcp-name: io.github.homeassistant-ai/ha-mcp -->
+
+  <p align="center">
+    <img src="https://img.shields.io/badge/tools-95+-blue" alt="95+ Tools">
+    <a href="https://github.com/homeassistant-ai/ha-mcp/releases"><img src="https://img.shields.io/github/v/release/homeassistant-ai/ha-mcp" alt="Release"></a>
+    <a href="https://github.com/homeassistant-ai/ha-mcp/actions/workflows/e2e-tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/homeassistant-ai/ha-mcp/e2e-tests.yml?branch=master&label=E2E%20Tests" alt="E2E Tests"></a>
+    <a href="LICENSE.md"><img src="https://img.shields.io/github/license/homeassistant-ai/ha-mcp.svg" alt="License"></a>
+    <br>
+    <a href="https://github.com/homeassistant-ai/ha-mcp/commits/master"><img src="https://img.shields.io/github/commit-activity/m/homeassistant-ai/ha-mcp.svg" alt="Activity"></a>
+    <a href="https://github.com/jlowin/fastmcp"><img src="https://img.shields.io/badge/Built%20with-FastMCP-purple" alt="Built with FastMCP"></a>
+    <img src="https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fhomeassistant-ai%2Fha-mcp%2Fmaster%2Fpyproject.toml" alt="Python Version">
+    <a href="https://github.com/sponsors/julienld"><img src="https://img.shields.io/badge/GitHub_Sponsors-☕-blueviolet" alt="GitHub Sponsors"></a>
+  </p>
+
+  <p align="center">
+    <em>A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant.<br>
+    Using natural language, control smart home devices, query states, execute services and manage your automations.</em>
+  </p>
+</div>
+
+---
+
+![Demo with Claude Desktop](docs/img/demo.webp)
+
+---
+
+## 🚀 Get Started
+
+### Full guide to get you started with Claude Desktop (~10 min)
+
+*No paid subscription required.* Click on your operating system:
+
+<p>
+<a href="https://homeassistant-ai.github.io/ha-mcp/guide-macos/"><img src="https://img.shields.io/badge/Setup_Guide_for_macOS-000000?style=for-the-badge&logo=apple&logoColor=white" alt="Setup Guide for macOS" height="120"></a>&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://homeassistant-ai.github.io/ha-mcp/guide-windows/"><img src="https://img.shields.io/badge/Setup_Guide_for_Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Setup Guide for Windows" height="120"></a>
+</p>
+
+### Quick install (~5 min)
+
+<details>
+<summary><b>🍎 macOS</b></summary>
+
+1. Go to [claude.ai](https://claude.ai) and sign in (or create a free account)
+2. Open **Terminal** and run:
+   ```sh
+   curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh
+   ```
+3. [Download Claude Desktop](https://claude.ai/download) (or restart: Claude menu → Quit)
+4. Ask Claude: **"Can you see my Home Assistant?"**
+
+You're now connected to the demo environment! [Connect your own Home Assistant →](https://homeassistant-ai.github.io/ha-mcp/guide-macos/#step-6-connect-your-home-assistant)
+
+</details>
+
+<details>
+<summary><b>🪟 Windows</b></summary>
+
+1. Go to [claude.ai](https://claude.ai) and sign in (or create a free account)
+2. Open **Windows PowerShell** (from Start menu) and run:
+   ```powershell
+   irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex
+   ```
+3. [Download Claude Desktop](https://claude.ai/download) (or restart: File → Exit)
+4. Ask Claude: **"Can you see my Home Assistant?"**
+
+You're now connected to the demo environment! [Connect your own Home Assistant →](https://homeassistant-ai.github.io/ha-mcp/guide-windows/#step-6-connect-your-home-assistant)
+
+</details>
+
+### 🧙 Setup Wizard for 15+ clients
+
+**Claude Code, Gemini CLI, ChatGPT, Open WebUI, VSCode, Cursor, and more.**
+
+<p>
+<a href="https://homeassistant-ai.github.io/ha-mcp/setup/"><img src="https://img.shields.io/badge/Open_Setup_Wizard-4A90D9?style=for-the-badge" alt="Open Setup Wizard" height="40"></a>
+</p>
+
+Having issues? Check the **[FAQ & Troubleshooting](https://homeassistant-ai.github.io/ha-mcp/faq/)**
+
+---
+
+## 💬 What Can You Do With It?
+
+Just talk to Claude naturally. Here are some real examples:
+
+| You Say | What Happens |
+|---------|--------------|
+| *"Create an automation that turns on the porch light at sunset"* | Creates the automation with proper triggers and actions |
+| *"Add a weather card to my dashboard"* | Updates your Lovelace dashboard with the new card |
+| *"The motion sensor automation isn't working, debug it"* | Analyzes execution traces, identifies the issue, suggests fixes |
+| *"Make my morning routine automation also turn on the coffee maker"* | Reads the existing automation, adds the new action, updates it |
+| *"Create a script that sets movie mode: dim lights, close blinds, turn on TV"* | Creates a reusable script with the sequence of actions |
+
+Spend less time configuring, more time enjoying your smart home.
+
+---
+
+## ✨ Features
+
+| Category | Capabilities |
+|----------|--------------|
+| **🔍 Search** | Fuzzy entity search, deep config search, system overview |
+| **🏠 Control** | Any service, bulk device control, real-time states |
+| **🔧 Manage** | Automations, scripts, helpers, dashboards, areas, zones, groups, calendars, blueprints |
+| **📊 Monitor** | History, statistics, camera snapshots, automation traces, ZHA devices |
+| **💾 System** | Backup/restore, updates, add-ons, device registry |
+| **🔐 Auth** | OAuth 2.1 with DCR for secure multi-user access (Claude.ai), token-based for local clients |
+
+<details>
+<summary><b>🛠️ Complete Tool List (97 tools)</b></summary>
+
+| Category | Tools |
+|----------|-------|
+| **Search & Discovery** | `ha_search_entities`, `ha_deep_search`, `ha_get_overview`, `ha_get_state` |
+| **Service & Device Control** | `ha_call_service`, `ha_bulk_control`, `ha_get_operation_status`, `ha_get_bulk_status`, `ha_list_services` |
+| **Automations** | `ha_config_get_automation`, `ha_config_set_automation`, `ha_config_remove_automation` |
+| **Scripts** | `ha_config_get_script`, `ha_config_set_script`, `ha_config_remove_script` |
+| **Helper Entities** | `ha_config_list_helpers`, `ha_config_set_helper`, `ha_config_remove_helper` |
+| **Dashboards** | `ha_config_get_dashboard`, `ha_config_set_dashboard`, `ha_config_update_dashboard_metadata`, `ha_config_delete_dashboard`, `ha_get_dashboard_guide`, `ha_get_card_types`, `ha_get_card_documentation` |
+| **Areas & Floors** | `ha_config_list_areas`, `ha_config_set_area`, `ha_config_remove_area`, `ha_config_list_floors`, `ha_config_set_floor`, `ha_config_remove_floor` |
+| **Labels** | `ha_config_get_label`, `ha_config_set_label`, `ha_config_remove_label`, `ha_manage_entity_labels` |
+| **Zones** | `ha_get_zone`, `ha_create_zone`, `ha_update_zone`, `ha_delete_zone` |
+| **Groups** | `ha_config_list_groups`, `ha_config_set_group`, `ha_config_remove_group` |
+| **Todo Lists** | `ha_get_todo`, `ha_add_todo_item`, `ha_update_todo_item`, `ha_remove_todo_item` |
+| **Calendar** | `ha_config_get_calendar_events`, `ha_config_set_calendar_event`, `ha_config_remove_calendar_event` |
+| **Blueprints** | `ha_list_blueprints`, `ha_get_blueprint`, `ha_import_blueprint` |
+| **Device Registry** | `ha_get_device`, `ha_update_device`, `ha_remove_device`, `ha_rename_entity` |
+| **ZHA & Integrations** | `ha_get_zha_devices`, `ha_get_entity_integration_source` |
+| **Add-ons** | `ha_get_addon` |
+| **Camera** | `ha_get_camera_image` |
+| **History & Statistics** | `ha_get_history`, `ha_get_statistics` |
+| **Automation Traces** | `ha_get_automation_traces` |
+| **System & Updates** | `ha_check_config`, `ha_restart`, `ha_reload_core`, `ha_get_system_info`, `ha_get_system_health`, `ha_get_updates` |
+| **Backup & Restore** | `ha_backup_create`, `ha_backup_restore` |
+| **Utility** | `ha_get_logbook`, `ha_eval_template`, `ha_get_domain_docs`, `ha_get_integration` |
+
+</details>
+
+---
+
+## 🤝 Contributing
+
+For development setup, testing instructions, and contribution guidelines, see **[CONTRIBUTING.md](CONTRIBUTING.md)**.
+
+For comprehensive testing documentation, see **[tests/README.md](tests/README.md)**.
+
+---
+
+## 🔒 Privacy
+
+Ha-mcp runs **locally** on your machine. Your smart home data stays on your network.
+
+- **Configurable telemetry** — optional anonymous usage stats
+- **No personal data collection** — we never collect entity names, configs, or device data
+- **User-controlled bug reports** — only sent with your explicit approval
+
+For full details, see our [Privacy Policy](PRIVACY.md).
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- **[Home Assistant](https://home-assistant.io/)**: Amazing smart home platform (!)
+- **[FastMCP](https://github.com/jlowin/fastmcp)**: Excellent MCP server framework
+- **[Model Context Protocol](https://modelcontextprotocol.io/)**: Standardized AI-application communication
+- **[Claude Code](https://github.com/anthropics/claude-code)**: AI-powered coding assistant
+
+## 👥 Contributors
+
+- **[@julienld](https://github.com/julienld)** — Project maintainer & core contributor.
+- **[@kingbear2](https://github.com/kingbear2)** — Windows UV setup guide.
+- **[@sergeykad](https://github.com/sergeykad)** — Dashboard card-level CRUD operations, better changelogs and removed the dependency to textdistance/numpy.
+- **[@konradwalsh](https://github.com/konradwalsh)** — Financial support via [GitHub Sponsors](https://github.com/sponsors/julienld). Thank you! ☕
+- **[@cj-elevate](https://github.com/cj-elevate)** — Integration & entity management tools (enable/disable/delete).
+- **[@kingpanther13](https://github.com/kingpanther13)** — Native solutions guidance to reduce template overuse.
+- **[@Raygooo](https://github.com/Raygooo)** — SOCKS proxy support.
+
+---
+
+## 💬 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
+
+---
+
+## ⭐ Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=homeassistant-ai/ha-mcp&type=Date)](https://star-history.com/#homeassistant-ai/ha-mcp&Date)

ha_mcp_dev-6.3.1.dev137.dist-info/RECORD

@@ -0,0 +1,71 @@
+ha_mcp/__init__.py,sha256=WnpUJgSF99nlyZeI5nppDjYZ7RqtjAERLpGHiFWOcHQ,1308
+ha_mcp/__main__.py,sha256=sUP5bRI2g1QjKojmz0UhTB5kpAROBMgYhUsg9MspI7k,24583
+ha_mcp/_pypi_marker,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ha_mcp/config.py,sha256=djlKf9ozL-xC1TuzzkWN4ECbXytkRxZhR3s2CYMuEjI,6427
+ha_mcp/errors.py,sha256=6st0Kud3iACAHaKn-eEb8O5o8Ee9ZcSxpeeDJBRM844,13568
+ha_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ha_mcp/server.py,sha256=FkioX-XOAkOyE1AfsBuVnA51kkYH9-N12HLuHXBMxso,7163
+ha_mcp/smoke_test.py,sha256=2aABoHVaxNRIFaLKHZdtLr_d1yCYtB6ZUVAU2AWUlIM,3804
+ha_mcp/auth/__init__.py,sha256=4LY5fPgwJvbWFPc9AndpCkvg8PqssN2WCmlQWqLbJgI,304
+ha_mcp/auth/consent_form.py,sha256=SBuhr7A87T2Npkk1BMlmnoSrzgETDDLgJ8i0godUiYs,14708
+ha_mcp/auth/provider.py,sha256=5s55oo7iQjnpPuhgTt-meapLwPIC4r1v_5wrUQ15y8o,30949
+ha_mcp/client/__init__.py,sha256=tPxyY6vQu5up4kwJgqc-ChpjPEBK5QouUedMQSNJdUQ,277
+ha_mcp/client/rest_client.py,sha256=DC_BPnxLbl5UJ-eUo7bXh4oK1b-IqfpA695z6SS8m9E,34505
+ha_mcp/client/websocket_client.py,sha256=Qygz6D79ZS7bJzk6u-DP1Gh7Z_ozfhOzDu-jz-Pglss,24112
+ha_mcp/client/websocket_listener.py,sha256=5LpBqMlbTqaW3oX61t6OAfwbKy4DurKNeZPPzKIMPiU,12587
+ha_mcp/resources/card_types.json,sha256=dRcKOqMpW6zIh2Q2MLNi8woK9gV_aY1YB5Ot9EzUu_M,977
+ha_mcp/resources/dashboard_guide.md,sha256=uJPV5_dmmoS8YFJX98RA_gflUPFyvVkjU-rDJcqQOkw,14967
+ha_mcp/tools/__init__.py,sha256=7aPElrhC2sUXIgCExm3hIlgSYYdi6KyvmfhtOzPFQHM,334
+ha_mcp/tools/backup.py,sha256=BB1BGWPVneebM7Rf7uq0V9hEeKqmlibBrZSavdNy_Xk,17626
+ha_mcp/tools/device_control.py,sha256=QQkx3CENpfNQIf1UA681Bq4GClMx2pJDZR6ZWbX_mGc,27484
+ha_mcp/tools/enhanced.py,sha256=WJgpSgAJOEhuzPOERiJtasPpGE28wgoJ3vvurgP_Wrw,6681
+ha_mcp/tools/helpers.py,sha256=0Z5jGxNVpm6TnwKO7ZO5zOmG-ankhAXprt_xgcfLE1g,5837
+ha_mcp/tools/registry.py,sha256=mTrju-6gbmhlX-nOYOMpwqiN7zdOCQetnBihHBVq50E,7721
+ha_mcp/tools/smart_search.py,sha256=iMtHjCcL9GfDgD0S4KN3I33b1MXHQXh00W05TmTQU2A,34454
+ha_mcp/tools/tools_addons.py,sha256=xEvYfE_tGovvaczIA5O8uugrnsNr6gDFSSW1jNmNfXg,12369
+ha_mcp/tools/tools_areas.py,sha256=aVdAAwqTPk34ZCP6rhxIo_cw01Cj4Dwa2F06gmvIk9A,17792
+ha_mcp/tools/tools_blueprints.py,sha256=ZH4JHheknfhLzSR104Uk4Ulx7wVHFx8IAxJPQdTlIt0,10911
+ha_mcp/tools/tools_bug_report.py,sha256=2sBSPemnSk6hwSvEZnrLkTLIrlGVn7uTIRT-YZhK8f0,18784
+ha_mcp/tools/tools_calendar.py,sha256=Okt6FdBe7oQP6uXggfR8yET-YjczY9-fn9xuIEnPXq8,14767
+ha_mcp/tools/tools_camera.py,sha256=tDrFcoX9tDfLdwCWTD5l7mErYVNBoAy7j_LsMctpspI,5769
+ha_mcp/tools/tools_config_automations.py,sha256=DCr28CK1bcJDu28ButGZAaapzsmA7oGL5N-bzUXeTQU,20786
+ha_mcp/tools/tools_config_dashboards.py,sha256=qRReRlje64l6GGeO6mYCJ7LD8qRdemLavJuzLWyfMMA,60607
+ha_mcp/tools/tools_config_entry_flow.py,sha256=G21DCsD1eDRN9uq3bnDicc8opcpd5gRSxITpKklsR60,7839
+ha_mcp/tools/tools_config_helpers.py,sha256=Qd6iEQx1EmihbO3abMuyfw0Jo-jCNmLuhqNVFmWdTlQ,37694
+ha_mcp/tools/tools_config_info.py,sha256=79TBsFijVQQuiAG6FXeJyMEGkKQxehtOCdKpxUzEtJU,10762
+ha_mcp/tools/tools_config_scripts.py,sha256=vp5laEBb0m73DSlH4vwT7sOFlEqYs_xX_Uy7hC3bQe0,10017
+ha_mcp/tools/tools_entities.py,sha256=uFLx7xgtBnD72MDyKUp24l_5HCvu-ZQ84lWkUglid90,2623
+ha_mcp/tools/tools_filesystem.py,sha256=DXVwIi6x_SnfrR0ZvdlwWIWw-uOttd_wAm5idiMdi-8,20102
+ha_mcp/tools/tools_groups.py,sha256=KpDpUpIlqn7-ZfvdhQKWPrQ3-q7bSq5_MABZjVejjqU,11786
+ha_mcp/tools/tools_hacs.py,sha256=gWTO-SRi7CPx1MCj68Kw94EJO9r1EVduEdwMdnoXfDw,34988
+ha_mcp/tools/tools_history.py,sha256=CgUCi2_T3F536mpx03OgnHD0pCtXtpDe5CnU_VGNLvA,28704
+ha_mcp/tools/tools_integrations.py,sha256=6PH_gQAkvPkGvW4tdd0TU_6qaZVBfnKWjPEVFUeo7uY,11645
+ha_mcp/tools/tools_labels.py,sha256=nJm2bX5i9OGYMLIpSjeBaEWIhOolbgc1Y5L66OIYL08,27150
+ha_mcp/tools/tools_mcp_component.py,sha256=id6PptzVb06AAb6-ydxGDQPHH5gFGn9RzchZvUOeug0,12871
+ha_mcp/tools/tools_registry.py,sha256=xIhIYeKr-sOC2bP8uglgL-576BoDnweBHmzhwk-KPzQ,46054
+ha_mcp/tools/tools_resources.py,sha256=4s6aflsV7eP5vkz_LHC960OhzUizfQPyocTPBNyc_-k,22945
+ha_mcp/tools/tools_search.py,sha256=4p3I5f6DPeix_KWgwQxC3I-nEokEze3JcntohzoCkos,26319
+ha_mcp/tools/tools_service.py,sha256=eylo6w0mxjv3JcufCZPZre5U_D4izmc8q20ML66nwU0,9062
+ha_mcp/tools/tools_services.py,sha256=KgWt75Rnnk2XQHOgZecf0vOFR0vNO1LFKWh6Mj39aTw,10895
+ha_mcp/tools/tools_system.py,sha256=uHu8CVsALjgpVG21h3vEnntmB3sNP0yGD6d01e9xFdM,14210
+ha_mcp/tools/tools_todo.py,sha256=l71w_ln_Xjy7PbQ5k4Qcf15OJvNFEeihWxyQxfHkmLg,19851
+ha_mcp/tools/tools_traces.py,sha256=F_ppsGNqOEmnav3xgPtQSer8NykzUnArEs2R3qO6K2A,18548
+ha_mcp/tools/tools_updates.py,sha256=Va8OD1h53TODbrtqKkLMAeLm8ZQaNwwAfPSwHsiPgCo,18357
+ha_mcp/tools/tools_utility.py,sha256=OIuxFx-SdTsenRyChlTDNTtOS8iJLkj59IrGq2UyefQ,20886
+ha_mcp/tools/tools_voice_assistant.py,sha256=ylcoFQzYFGSeRN3ULKUwk938Q7ykXtOPILhcZGwzKzQ,13158
+ha_mcp/tools/tools_zones.py,sha256=M1hzXSrC59-kb3aFTNR9x8LbjOv6xVpdOyhdXs5ckt8,14083
+ha_mcp/tools/util_helpers.py,sha256=yuey0tLVo5MZm_-kkDzp1rxYz27PMx6P7lttdlSpTw0,6164
+ha_mcp/utils/__init__.py,sha256=mSXOwk11PxZeFLE7kygZsL53JSfZ53pFZ7MhjbJNaGQ,736
+ha_mcp/utils/domain_handlers.py,sha256=k99mzMDnhCkptIdub8pbZq7RN3hrAjzySBWfd6uSC9I,12334
+ha_mcp/utils/fuzzy_search.py,sha256=QD3Kd-MulX4japp9tj888eMoifTZvILV_iSogWAd8Pc,11377
+ha_mcp/utils/operation_manager.py,sha256=cFW_PFuvU221IqQ2wZDc7o9gf2mffAX_EtePh7PTbhA,14332
+ha_mcp/utils/usage_logger.py,sha256=dHkHzBCCrLMM1n0aZEWjVgOYjMtQvS3FGMRMbIcgUvw,9303
+ha_mcp_dev-6.3.1.dev137.dist-info/licenses/LICENSE,sha256=7rJXXKBJWgJF8595wk-YTxwVTEi1kQaIqyy9dh5o_oY,1062
+tests/__init__.py,sha256=YRpec-ZFYCJ48oD_7ZcNY7dB8avoTWOrZICjaM-BYJ0,39
+tests/test_constants.py,sha256=F14Pf5QMzG77RhsecaNWWaEL-B_8ykHJLIvVMcJxT8M,609
+tests/test_env_manager.py,sha256=patnM4If8gLUGuFRQEYMAuNhsAvjLKZZYuR2oJ2c2kU,12011
+ha_mcp_dev-6.3.1.dev137.dist-info/METADATA,sha256=M2ztuZQ9Gkl2R3a2d6VnOVnTwO_p5O3nA0HndzBksLg,11677
+ha_mcp_dev-6.3.1.dev137.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+ha_mcp_dev-6.3.1.dev137.dist-info/entry_points.txt,sha256=MN0GhQEca3hlfJIBAclzzbvwU7K-czkhlc55Gn58vdg,254
+ha_mcp_dev-6.3.1.dev137.dist-info/top_level.txt,sha256=cqJLEmgh4gQBKg_vBqj0ahS4DCg4J0qBXYgZCDQ2IWs,13
+ha_mcp_dev-6.3.1.dev137.dist-info/RECORD,,

ha_mcp_dev-6.3.1.dev137.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ha_mcp_dev-6.3.1.dev137.dist-info/entry_points.txt

@@ -0,0 +1,7 @@
+[console_scripts]
+ha-mcp = ha_mcp.__main__:main
+ha-mcp-oauth = ha_mcp.__main__:main_oauth
+ha-mcp-smoke-test = ha_mcp.smoke_test:main
+ha-mcp-sse = ha_mcp.__main__:main_sse
+ha-mcp-web = ha_mcp.__main__:main_web
+hamcp-test-env = tests.test_env_manager:main

ha_mcp_dev-6.3.1.dev137.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Julien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ha_mcp_dev-6.3.1.dev137.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+ha_mcp
+tests

tests/__init__.py

@@ -0,0 +1 @@
+"""Home Assistant MCP Server Tests."""

tests/test_constants.py

@@ -0,0 +1,15 @@
+"""
+Test constants shared across test modules.
+
+This module centralizes test configuration values to ensure consistency
+across all test environments.
+"""
+
+# Long-lived access token for test Home Assistant instance
+# This token is embedded in tests/initial_test_state/.storage/auth
+# Expires: 2035 (10+ years from token creation)
+TEST_TOKEN = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiIxOTE5ZTZlMTVkYjI0Mzk2YTQ4YjFiZTI1MDM1YmU2YSIsImlhdCI6MTc1NzI4OTc5NiwiZXhwIjoyMDcyNjQ5Nzk2fQ.Yp9SSAjm2gvl9Xcu96FFxS8SapHxWAVzaI0E3cD9xac"
+
+# Test user credentials (for UI access)
+TEST_USER = "mcp"
+TEST_PASSWORD = "mcp"