List configured agents (Pi or Pico). Returns name, ip, port, online (live /hello probe), type (pi/pico), version, has_default_key, and last_updated_at. Unreachable agents are included (online=false). The LAN is scanned automatically every hour (last_updated_at indicates the last scan time). You can pass rescan=true to forcefully sweep the LAN for new agents right now, but avoid doing this unless the user explicitly asks to find new hardware, as active scanning takes a long time. If has_default_key is true for any agent, explicitly tell the user they are using an insecure default key and ask if they want you to change it.

Read a GPIO pin value on agent by number or name, or 'all' to read all pins.

Write a value to a GPIO pin on agent ('0', '1', 'on', 'off', or 'toggle'). Optional duration in seconds, after which the pin reverts to its previous state. If the pin has a configured 'max' pulse duration, the effective duration is clamped to it - and if no duration is given but 'max' is set, 'max' is used as the duration automatically.

Scan all hardware GPIO pins on agent and return their value, type, pull resistor, and name: BCM 2-27 on a Raspberry Pi, GP0-GP28 (minus the WiFi-reserved GP23/24/25/29) on a Pico. Only supported on Raspberry Pi / Pico hardware.

Configure a GPIO pin on agent by number. type: input/output/vcc/gnd/remove. init: 0/1/last. pullup: up/down/none (input only). max: max pulse duration in seconds (output only). reversed: active-low logic (input/output only). watched: trigger webhook on state change (logged on the agent if no notifications.webhook is configured).

List the GPIO pins that are currently being actively watched (the ones emitting hardware interrupts/webhooks).

Configure a named sensor on agent. A sensor runs a script and its output is the reading. script is " [args...]": a bare filename in the agent's scripts/ folder (no paths - that folder is the only allowed location), with letters/digits-only arguments. On a Raspberry Pi it is a shell script run with sh; on a Pico a .py file the agent execs in-process. Pass remove=true to delete the sensor.

Read sensors on agent. With no name, reads every configured sensor and returns them merged into one JSON object; with a name, reads just that sensor. Every reading is nested under its sensor's own name: a script emitting a JSON object with several fields nests whole, one emitting a single-field object contributes just that field's value, and any other output is wrapped the same way.

Read agent's global application configuration, grouped: notifications (webhook + webhook_key), bridges (matter/homekit callbacks), settings (docs_enabled, logs_enabled, log_days), sensors, and configured pins (gpios). The agent block (platform, os, ip, cpu_temperature, version) is computed live on every read and is not stored.

Update agent's global configuration dynamically. These are the ungrouped (root) field names; the agent routes each into its group (webhook_url -> notifications.webhook, webhook_key -> notifications.webhook_key, docs_enabled/logs_enabled/log_days -> settings), so a read afterwards shows them nested. log_days controls how long log entries are kept (0-30, clamped; 0 clears the log immediately and keeps only the last hour). docs_enabled is Pi-only. Changing api_key changes the agent's authentication key immediately, and also updates the local config.json file to match automatically.

Load a full config onto agent from a dict (the agent saves a backup first). Pass an empty dict {} to reset all settings on the agent keeping only its API key.

Restart agent's server process. Pass reboot=true to reboot the physical device instead - only honored on a real Raspberry Pi; on Mac/dev agents reboot is ignored and the process is restarted as usual.

Upgrade the agent in place: runs install.sh --upgrade (re-downloads the latest release files and reinstalls dependencies), then restarts the process so the new code takes effect.

Read the last 50 lines of agent's server log file.