AGENTS.md, zigbee2mqtt/state.json

2026-09-24 12:22:50 +00:00
parent 59cd50d34a
commit 0768b73099
2 changed files with 34 additions and 29 deletions
@@ -170,7 +170,7 @@ Real-time interaction with the running instance:

 - `get_states`, `search_entities`, `get_entity_details`, `get_home_context` — current state and compact area/domain/entity context. Prefer `get_home_context` over broad state dumps.
 - `call_service` — control devices (with confirmation), and read from services that answer with data (`recorder.get_statistics`, `weather.get_forecasts`, `calendar.get_events`, `todo.get_items`); the response comes back automatically
- `get_history`, `get_logbook`, `get_calendar_events` — historical and calendar data; supplied timestamps must include `Z` or a UTC offset
+- `get_history`, `get_logbook`, `get_calendar_events` — historical and calendar data; supplied timestamps must include `Z` or a UTC offset. For every recorded value, use `get_history` with `response_format: "values"`, then pass its exact `meta.continuation` object until `has_more` is false; `numeric_summary` covers the complete response.
 - `get_devices`, `get_areas` — device and area registry
 - `write_config_safe`, `validate_config`, `check_config_syntax` — safe config writing with validation, content protection and backup
 - `get_integration_docs`, `get_breaking_changes` — current syntax, before writing any integration configuration
@@ -271,6 +271,11 @@ Use "hab [command] --help" for more information about a command.

 ### 4. zigporter CLI (Zigbee toolkit)

+In the V2 beta, use the `zigporter_run` MCP tool for these commands. Its sidecar
+supplies credentials; the agent shell intentionally does not inherit them.
+Do not run setup or create credential files. If the current profile does not
+expose the tool, report that limitation and use available read-only MCP tools.
+
 Zigbee device management, and the only tool here that **cascades a rename**
 across automations, scripts, scenes and every Lovelace dashboard atomically.
 `hab` renames one thing and leaves the references dangling. Also handles device
@@ -283,7 +288,7 @@ Dry-run is the default for renames — always preview before `--apply`. The
 <!-- ZIGPORTER_LIVE_HELP_START -->
 ```
                                                                                
- Usage: zigporter [OPTIONS] COMMAND [ARGS]...                                   
+ Usage: managed-cli.py [OPTIONS] COMMAND [ARGS]...                              
                                                                                
 Migrate Zigbee devices between ZHA and Zigbee2MQTT. Supports both ZHA → Z2M    
 (default) and Z2M → ZHA (--direction z2m-to-zha).                              
@@ -4,7 +4,7 @@
        "state": "ON",
        "led_brightness": 100,
        "countdown_to_turn_off": 0,
-        "voltage": 120.8,
+        "voltage": 121.6,
        "countdown_to_turn_on": 0,
        "ac_frequency": 60,
        "power_factor": 0.14,
@@ -22,15 +22,15 @@
    },
    "0xffffb40e0607af27": {
        "state": "ON",
-        "voltage": 119.3,
+        "voltage": 121,
        "ac_frequency": 60,
        "led_brightness": 100,
        "countdown_to_turn_off": 0,
        "countdown_to_turn_on": 0,
-        "power": 1.9,
-        "current": 0.09,
-        "energy": 46.18,
-        "power_factor": 0.17,
+        "power": 137.9,
+        "current": 3.39,
+        "energy": 46.33,
+        "power_factor": 0.28,
        "update": {
            "state": "idle",
            "installed_version": 268513381,
@@ -45,9 +45,9 @@
        "state": "ON",
        "led_brightness": 100,
        "countdown_to_turn_off": 0,
-        "voltage": 120.6,
+        "voltage": 121.4,
        "countdown_to_turn_on": 0,
-        "energy": 90.28,
+        "energy": 90.31,
        "power_factor": 0.2,
        "ac_frequency": 60,
        "update": {
@@ -58,13 +58,13 @@
            "latest_release_notes": null
        },
        "linkquality": 120,
-        "power": 0.2,
-        "current": 0.01,
+        "power": 89.6,
+        "current": 0.83,
        "power_on_behavior": "on"
    },
    "0xb40e060fffe031e3": {
        "battery": 100,
-        "contact": true,
+        "contact": false,
        "tamper": false,
        "battery_low": false,
        "linkquality": 120,
@@ -74,13 +74,13 @@
        "led_brightness": 100,
        "countdown_to_turn_off": 0,
        "countdown_to_turn_on": 0,
-        "voltage": 120,
+        "voltage": 120.2,
        "state": "ON",
        "ac_frequency": 60,
-        "energy": 184.39,
+        "energy": 184.45,
        "power": 3.7,
        "current": 0.05,
-        "power_factor": 0.41,
+        "power_factor": 0.36,
        "update": {
            "state": "idle",
            "installed_version": 268513381,
@@ -95,13 +95,13 @@
        "led_brightness": 100,
        "countdown_to_turn_off": 0,
        "countdown_to_turn_on": 0,
-        "voltage": 120.8,
-        "energy": 91.43,
+        "voltage": 121,
+        "energy": 91.46,
        "state": "ON",
-        "power": 25.7,
-        "current": 0.3,
+        "power": 31.6,
+        "current": 0.35,
        "ac_frequency": 60,
-        "power_factor": 0.72,
+        "power_factor": 0.74,
        "update": {
            "state": "idle",
            "installed_version": 268513381,
@@ -114,12 +114,12 @@
    },
    "0xffffb40e060895b3": {
        "state": "ON",
-        "voltage": 120.8,
+        "voltage": 121.6,
        "ac_frequency": 60,
        "energy": 12.12,
        "current": 0.01,
        "power": 0.2,
-        "power_factor": 0.22,
+        "power_factor": 0.11,
        "linkquality": 87,
        "update": {
            "state": "idle",
@@ -136,14 +136,14 @@
    "0xffffb40e0608864e": {
        "led_brightness": 100,
        "countdown_to_turn_off": 0,
-        "voltage": 121.3,
-        "energy": 28.74,
+        "voltage": 122.2,
+        "energy": 28.84,
        "countdown_to_turn_on": 0,
        "state": "ON",
-        "current": 0.02,
+        "current": 0.16,
        "ac_frequency": 60,
        "power": 0.4,
-        "power_factor": 0.14,
+        "power_factor": 0.4,
        "update": {
            "state": "idle",
            "installed_version": 268513381,
@@ -171,7 +171,7 @@
    },
    "0xa4c1380d0679ffff": {
        "battery": 100,
-        "temperature": 24.3,
+        "temperature": 24,
        "temperature_units": "celsius",
        "temperature_calibration": 0,
        "update": {
@@ -224,7 +224,7 @@
    },
    "0xb40e060fffe717c5": {
        "battery": 100,
-        "occupancy": false,
+        "occupancy": true,
        "tamper": false,
        "battery_low": false,
        "linkquality": 116,