Terminal Control

Terminal Control

Sleep and speaker volume are ordinary MCP tools on the Pi, not custom AO protocol. Full decision: ADR 0004.

---

Sleep

• Attention state → sleeping.
• Not OS suspend — processes keep running.
• Vision and VAD events are ignored.
• Wake word remains armed; only WakeWord exits to listening.
• Enter via sleep_enter MCP or POST http://127.0.0.1:8776/control/sleep.

---

Volume

Tool	Effect
volume_get	Current percent + muted
volume_set	Absolute 0–100
volume_adjust	Relative delta
volume_mute	Speaker mute (not mic mute)

Prefer sink name comstar_hdmi when configured. Backed by bridge loopback HTTP GET|POST /control/volume.

---

Guest policy

Guest sessions must not register client.terminal — no sleep/volume control for strangers.

---

Related pages

• Contracts — MCP
• Contracts — Attention State Machine
• ADR 0004