Runtime Lifecycle

Rooaak starts and manages per-agent runtime instances (Fly Machines).

Controls

• POST /v1/agents/:id/start: ensure runtime running
• POST /v1/agents/:id/stop: stop runtime (status becomes sleeping)
• POST /v1/agents/:id/reload: mark pending_config=true (hot reload path)
• POST /v1/agents/:id/restart: destroy/recreate runtime and mark config applied

Runtime control loop

• Runtime polls config (GET /runtime/config)
• Runtime applies config
• Runtime acknowledges (POST /runtime/config)

Operational note

reload does not force VM restart. restart does.