sandbox_status

1 つのボックスのすべて：状態、goal、直近 30 件のステップ、使っている会話がまだ作業中か、配線、サービス、実行中のコマンド、クレジット。読むだけです。

上の表にあるものを、1 つのボックスについてすべて返します。読むだけなので、凍結中のボックスは復帰せず、ボックスがあなたのものになることもありません（stopsAt も延びません。ボックスの状態を参照）。次の 3 つは、作業を引き継ぐ側のためのフィールドです。

• goal：sandbox_start に渡した、このボックスの目的です。指定せずに起動したボックス（REST から、または goal が必須になる前に起動したもの）にはありません。
• steps[]：ボックスで最近行われた 30 件を古い順に並べたものです。コマンド、ディレクトリ、それに付けた説明で、出力もスクリーンショットや録画も含みません。各ステップのスクリーンショットと録画は別の一覧にあります：REST の GET /v1/boxes/{id}/media で、画面が残っているステップだけを、直近 7 日間から新しい 200 件まで返します（REST を参照）。各ステップには次があります。
  • at：日時（RFC3339）。
  • kind：exec、build、sync、wire、shot、device、start、stop、takeover、review、return、say のいずれか。
  • summary：行ったこと（コマンド、サービス名、メッセージ）。最大 200 文字で、それより長いと切られて … で終わります。
  • target（ないこともある）：アップロード（sync）またはビルド（build）したディレクトリ。
  • note（ないこともある）：呼び出しに付けた note。
  • actor（ないこともある）：人が行ったものは human。エージェントと ParallelSandbox が行ったものにはありません。
  • detail（ないこともある）：background: true で起動したコマンドは background、出力を復元したビルドは reused、sandbox_shot の録画は record。wire ではモード（box か external）、link to <box>、version <label> のいずれか。
  • ms（ないこともある）：かかった時間。
  • ok：ParallelSandbox がそれを実行できたかどうか（ボックスが応答したか）。実行されて失敗したコマンドも ok で、その exitCode が付きます。
  • exitCode、signal、timedOut（フォアグラウンドのコマンドだけ）：コマンドがどう終わったか。その sandbox_exec が返したとおりです。バックグラウンドのコマンドにはここではありません（始まったばかりだったため）。その終わりは sandbox_procs にあります。
  • error（ないこともある）：ParallelSandbox 側で何が失敗したかを 1 行で。コマンドの出力が入ることはありません。ボックスが応答しなかった、人がボックスを引き継いでいた、またはコマンドが終わる前に呼び出しが閉じられた（sandbox_procs で結果を取得するための execId 付き）のいずれかです。
• アダプター自身の下準備（sandbox_sync がファイルの比較に使う、/work/.psbx-sync/ 以下のコマンドとアップロード）は含みません。ステップは 7 日間残ります。
• agent（動いているボックスだけ）：最後にこのボックスを使った会話がまだ作業中か、{ "state": "left", "idleSec": 5400 }。state は working、away（会話は開いているが、このボックスを 10 分使っていない）、left（会話が終了した）、idle（ボックスが 1 時間使われていない）のいずれかです。判定の規則はどの会話がボックスを使っているかにあります。その会話が呼び出し元の会話なら thisConversation: true が付きます。untracked: true は、最後に使った呼び出しが会話 ID を持っていなかった（API キーのスクリプト、REST、stdio アダプターを通らないリモート接続）ことを示します。このときの state はアイドル時間からの推測にすぎず、別の会話が作業中という意味ではありません。自分のクライアント（Claude Code、Codex…）を再起動すると新しい会話の ID になるので、再起動前に使っていたボックスは、もう一度使うまで thisConversation なしの left と表示されます。そのボックスはあなたがそのまま続けて使えます。
• disk（動いているボックスだけ）：ボックスの容量を何が使っているか。複数のエージェントでボックスを共有していて空きが足りないときに見ます。filesystems は /work、Docker の保存領域、/、/tmp、/dev/shm の sizeGb、usedGb、freeGb（前のパスと同じディスクのものは sameAs だけを示します。合算しないでください）。work は /work 直下の各項目のサイズ（MB、大きい順。たいてい 1 項目が 1 つのプロジェクトか 1 つのエージェントのディレクトリ）。caches はパッケージのキャッシュと共有のブラウザー（/root/.cache、/root/.npm、/root/go、Gradle、pnpm、Playwright のブラウザーなど）。temp は /dev/shm と /tmp の 1 MB を超える項目。docker は docker system df の各行（イメージ、コンテナ、ボリューム、ビルドキャッシュと、それぞれ回収できる量）。sandbox_status が待つのは約 5 秒までです。まだ計測できていないパスは notMeasured に並び、measuring: true が付きます。計測は裏で続くので、数秒後にもう一度呼べば残りがわかります。結果は 30 秒保持されます（measuredAt）。何も自動では消しません。自分のものだけを消し、共有のボックスでほかのディレクトリを消す前には確認してください。このフィールドの公開前に起動したボックスには disk がありません。
• fields：["goal", "agent", "steps"] で、そのトップレベルのフィールドと id、status だけを返します。知らないフィールド名は unknownFields に入って返ります。人があなたに残したメッセージ（fromHuman）はそのまま付きます。別の会話が残したボックスをいくつか見て回るときに使います。
• freeze（アイドルで凍結するボックスが ready または引き継ぎ中のとき）：at は状況が変わらなければアイドルの規則で凍結する時刻、blockedBy[] は通常の 10 分を過ぎても今それを起こしたままにしているものです。background（background: true で起動したコマンド）、url（最後の呼び出し以降に URL 経由で来たリクエスト）、recording はそれぞれの until までしか数えません。takeover、foreground（実行中の sandbox_exec）、link（別のボックスが接続中）、phone（接続中のスマートフォンが先に凍結し、そのあとボックス）は終わるまで続き、そのときは at がありません。ボックスの状態を参照してください。
• boxdVersion：ボックス内の boxd のバージョン。その場で問い合わせます（boxd の再起動直後でも正確）。imageId：ボックスが起動したイメージ（microVM のボックスはイメージ ID、box-…）。記録を始める前に起動したボックスには imageId がありません。
• services[].lastProxyError：過去 30 分にそのサービスの URL 経由のリクエストが通らなかったとき、ボックスでの最後の状況です。at、status（ポートで何も応答しなければ 503。再起動中かもしれないのでボックスが 3 秒待ってから返します。ほかの失敗は 502、またはサービス自身が返した 5xx）、error（dial tcp 127.0.0.1:5173: connect: connection refused、タイムアウト）、count。503 box is frozen（ほかの状態も）や 502 box unreachable はボックスの手前が返したもので、理由は応答そのものに書かれています。同じ記録は、どのサービスにも合わなかった URL も含めて health.sceneErrors にもあります。
• running.containers[]：Docker コンテナごとの name、image、status、ports。psbx-testdb で起動したデータベースには接続設定のファイル envFile も付きます（. /work/.sbx/testdb/<名前>.env で DATABASE_URL などが export されます）。

すべてのツールとトピックはツールリファレンスに並んでいます。