visual: top-down map renderer, demo --frames-dir mode (step frames + GIF + summary), example artifacts committed

2026-08-08 12:03:35 +03:00
parent c224595f49
commit 1ebccb660b
6 changed files with 236 additions and 5 deletions
@@ -60,6 +60,19 @@ taken); stop the old one with `fuser -k 8765/tcp` or Ctrl-C in its terminal.
 The demo prints a full transcript of tool calls/results to stdout and saves the
 capsule's final first-person frame to `demo_final_frame.png`.

+## Visual mode
+
+```bash
+scripts/run_demo.sh --agent scripted --frames-dir frames
+```
+
+Saves, for every step, the first-person frame (`step_NNN_view.png`) and a
+top-down map of the room with the capsule's path (`step_NNN_map.png`), then
+writes a `demo.gif` animation and a `demo_summary.png` (final map + last
+view). The map is rebuilt purely from sensor data (`world_query`,
+`proprioception`, `vision`) — the same view the agent itself has. Generated
+examples are committed at the repo root (`demo.gif`, `demo_summary.png`).
+
 ## Conformance

 ```bash