运行 Agent 任务

沙箱里跑的是镜像声明的 Agent（claude-code@1 即 Claude Code 本身）。 你通过三个动作与它协作：投递、观察、中止。

投递 prompt

rayrun prompts send --sandbox <id> --text '把 README 的错别字修了'
echo '长 prompt' | rayrun prompts send --sandbox <id> --stdin

Agent 忙时 send 不排队 —— 直接返回 409，等当前任务结束后重发即可。

观察每一步

沙箱的所有动作都进事件流，可以实时订阅：

rayrun events watch --sandbox <id>                 # 实时
rayrun events watch --sandbox <id> --from-seq 42   # 先补历史再挂实时
rayrun events watch --sandbox <id> --kind 'agent.' # 只看 Agent 相关

断线重连由 CLI 自动完成（以 from_seq 续传），长时间挂着也不会丢事件。

中止

rayrun prompts cancel --sandbox <id>

没有任务在跑时是幂等无操作（不报错）。中止只结束当前任务，沙箱与工作区不受影响。

REST 等价物：投递 / 中止 / 事件流。