HydraIssues

hydraheadipad: embedded HTTP control server for remote automation
open unclassified Project: hydraheadipad Reporter: hydra 18 May 2026 21:39

Description

Add a lightweight HTTP server to hydraheadipad that starts on launch and registers the iPad LAN IP with HydraCluster. Enables automated smoke tests and remote ops without physical access.

Endpoints:
GET /screenshot — PNG of current screen
GET /status — JSON: head state, enrolled, streaming, version
POST /enroll — trigger enrollment flow programmatically
POST /stream/start — start a named experience
POST /stream/stop — stop current stream
POST /reset — reset enrollment (clear UserDefaults)

On startup: POST to HydraCluster /api/v1/heads/{id}/control-endpoint with the LAN IP + port, so the control server is discoverable via WireGuard routing from neoremote. iPad is on mobile-kit WiFi which routes through WireGuard mesh.