ha-mcp-dev 7.4.1.dev457__tar.gz → 7.4.1.dev458__tar.gz

{ha_mcp_dev-7.4.1.dev457/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.4.1.dev458}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.4.1.dev457
+Version: 7.4.1.dev458
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT

{ha_mcp_dev-7.4.1.dev457 → ha_mcp_dev-7.4.1.dev458}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.4.1.dev457"
+version = "7.4.1.dev458"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 requires-python = ">=3.13,<3.14"

{ha_mcp_dev-7.4.1.dev457 → ha_mcp_dev-7.4.1.dev458}/src/ha_mcp/tools/tools_traces.py

@@ -7,7 +7,7 @@ to help debug automation and script issues.
 
 import json
 import logging
-from typing import Annotated, Any
+from typing import Annotated, Any, Literal
 
 from fastmcp import Context
 from fastmcp.exceptions import ToolError
@@ -63,7 +63,7 @@ class TraceTools:
         limit: Annotated[
             int,
             Field(
-                description="Maximum number of traces to return when listing (default: 10, max: 50)",
+                description="Maximum number of traces to return when listing (default: 10, max: 50).",
                 default=10,
                 ge=1,
                 le=50,
@@ -94,6 +94,21 @@ class TraceTools:
                 default=None,
             ),
         ] = None,
+        offset: Annotated[
+            int,
+            Field(
+                description="Number of traces to skip from the start of the requested order. Use with `limit` to page through stored traces when `total_available > limit`.",
+                default=0,
+                ge=0,
+            ),
+        ] = 0,
+        order: Annotated[
+            Literal["newest", "oldest"],
+            Field(
+                description="Order traces are returned in. 'newest' (default) returns most-recent first; 'oldest' returns chronological-first.",
+                default="newest",
+            ),
+        ] = "newest",
         ctx: Context | None = None,
     ) -> dict[str, Any]:
         """
@@ -111,6 +126,8 @@ class TraceTools:
         1. List recent traces (omit run_id):
            ha_get_automation_traces("automation.motion_light")
            Returns a summary of recent execution runs with timestamps, triggers, and status.
+           Use `offset` to page deeper when `has_more` is true, or `order="oldest"` to
+           start from the earliest stored trace instead of the most recent.
 
         2. Get detailed trace (provide run_id):
            ha_get_automation_traces("automation.motion_light", run_id="1705312800.123456")
@@ -268,7 +285,12 @@ class TraceTools:
                             ctx, progress=3, total=3, message="diagnostics complete"
                         )
                         return _format_trace_list(
-                            automation_id, traces_data, limit, diagnostics
+                            automation_id,
+                            traces_data,
+                            limit,
+                            diagnostics,
+                            offset=offset,
+                            order=order,
                         )
 
                     await safe_progress(
@@ -277,7 +299,13 @@ class TraceTools:
                         total=3,
                         message=f"listed {len(traces_data)} traces",
                     )
-                    return _format_trace_list(automation_id, traces_data, limit)
+                    return _format_trace_list(
+                        automation_id,
+                        traces_data,
+                        limit,
+                        offset=offset,
+                        order=order,
+                    )
 
             finally:
                 await ws_client.disconnect()
@@ -463,18 +491,32 @@ def _format_trace_list(
     traces: list[dict[str, Any]],
     limit: int,
     diagnostics: dict[str, Any] | None = None,
+    *,
+    offset: int = 0,
+    order: Literal["newest", "oldest"] = "newest",
 ) -> dict[str, Any]:
     """Format trace list for AI consumption.
 
     Args:
         automation_id: The automation or script entity_id
-        traces: List of trace data from Home Assistant
+        traces: List of trace data from Home Assistant (oldest-first)
         limit: Maximum number of traces to include
         diagnostics: Optional diagnostic information when traces are empty
+        offset: Number of traces to skip from the start of the requested order
+        order: 'newest' (default) returns most-recent first; 'oldest' chronological
     """
-    formatted_traces = []
+    # HA's trace/list returns traces oldest-first. Pick a window from the end
+    # for newest-first, or from the start for oldest-first, with offset for
+    # pagination through stored traces beyond `limit`.
+    if order == "newest":
+        end = len(traces) - offset
+        start = max(end - limit, 0)
+        window = list(reversed(traces[start:end])) if end > 0 else []
+    else:
+        window = traces[offset:offset + limit]
 
-    for trace in traces[:limit]:
+    formatted_traces = []
+    for trace in window:
         # Extract key information from trace
         trace_info: dict[str, Any] = {
             "run_id": trace.get("run_id"),
@@ -503,6 +545,9 @@ def _format_trace_list(
         "automation_id": automation_id,
         "trace_count": len(formatted_traces),
         "total_available": len(traces),
+        "offset": offset,
+        "order": order,
+        "has_more": offset + len(formatted_traces) < len(traces),
         "traces": formatted_traces,
         "hint": "Use run_id with this tool to get detailed trace information",
     }

{ha_mcp_dev-7.4.1.dev457 → ha_mcp_dev-7.4.1.dev458/src/ha_mcp_dev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.4.1.dev457
+Version: 7.4.1.dev458
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT