Runbook viewer

<viewer> is the directory this SKILL.md was loaded from. view.py shows runs of engine 1.x and 2.x, and only reads the run directory.

During a run

For the orchestrator of a runbook. After every flow.py command that launches or ends a step (start, reply, answer, interrupted, relaunch), run python3 <viewer>/view.py <run> --status --tail 10 and show its output to the human as it is, in a code block, with no commentary. Once the run has ended, run it once more without --tail. Nothing while waiting for a step. Do not start the page unless the human asks for it.

When the human asks

• For the page: start python3 <viewer>/view.py <run> as a background process that outlives the turn, give the human the URL it prints as its first line, and open it in the harness's own browser pane if there is one. Without a run named, pass the runs directory, .agent-runbooks/runs under the directory the session started in: the viewer takes the run modified last. The server runs until the human says to stop it, the session ends, or no page has been open for 30 minutes; if the human asks for the page after that, start it again.
• For the status only: run python3 <viewer>/view.py <run> --status, with the runs directory in place of <run> when no run is named, and show its output in a code block.