Module device 

device … operator commands (online, via the trust-task dispatcher).

Thin wrappers over the VtaClient::device_* methods. A personal AI agent (open-claw / nano-claw / hermes) is a Service consumer (consumerKind.serviceKind = "ai-agent"); these commands enroll, list, and retire its DeviceBinding. See docs/02-vta/personal-ai-agents.md.

Functions

cmd_device_disable

device disable — disable a device by id (kept on record, can no longer authenticate). The operator kill switch.

cmd_device_heartbeat

device heartbeat — refresh lastSeenAt; returns server time + any queued operations for the device.

cmd_device_list

device list — list the caller’s registered devices. service_kind filters to a single Service consumer kind (e.g. ai-agent) when supplied.

cmd_device_register

device register — claim a DeviceBinding for the authenticated DID. The DID must already be in the ACL (provision the ai-agent template first).

cmd_device_set_wake

device set-wake — record the device’s push WakeHandle (gateway DID/URL + opaque handle) and return the trigger allowlist.

cmd_device_wipe

device wipe — remotely wipe a lost/compromised device. Marks it wiped + disabled and records the reason. scope is cache, cache-and-keys, or full.