bdambrosio head-move
Publishes a single chatter/head/cmd to the ChatterBot Pi and waits for the
head to report it has arrived before returning the settled pose. Either aim
(pan/tilt) or a gesture, never both — the Pi gives a gesture precedence and
ignores pan/tilt when a gesture is present.
This is gaze control for a stationary head, not locomotion. There is no forward/back/drive — the bot does not move through the world.
If you want to see what the head is now pointing at, follow this with
camera-capture; the camera rides the head, so capture after the move settles.
Examples
{"thought": "user asked me to look up at them", "tool": "head-move", "tilt": 130}
{"thought": "look toward the doorway on the left", "tool": "head-move", "pan": 150, "tilt": 95}
{"thought": "agree warmly", "tool": "head-move", "gesture": "nod"}