camera

# Camera ## Quick Start Accesses the device's built-in camera at `http://127.0.0.1:5001` to take snapshots or check the environment. Only use when the user explicitly asks you to look at something. ## Already-captured frame (reuse, don't re-snapshot) If the incoming turn contains a line like: ``` [vision-image] <absolute-path-to-a.jpg> (a photo was JUST captured ...) ``` a photo was **already taken** for this exact request by the realtime voice layer (it captured the frame, then handed the turn to you — e.g. it timed out mid-answer), and the OS layer delivers it **with this very message** — either as an `[image description]` line (when the main model is text-only, a vision model has already analyzed the photo for you) or as an attached image. **Answer the visual question from that description/attachment. Do NOT call `/camera/snapshot`** — re-snapshotting wastes time and may capture a different moment than what the user asked about. Do NOT read the path with a file tool — it is there for traceability only, and on text-only models a file-read image is silently dropped. Only fall back to the snapshot endpoint below when there is no `[vision-image]` line. ## Capture Protocol One call. It takes the photo, sizes it, and gives you back what is in it: ```bash curl -sX POST http://127.0.0.1:5000/api/vision/look \ -H 'Content-Type: application/json' \ -d '{"question":"<what the user asked>"}' ``` Returns `{"data":{"description":"...","path":"..."}}` — **answer from `descr...