TUI: 既存セッションからの Pod 復帰

背景

session-store は JSONL ログから Worker 状態を復元でき、Pod 側にも Pod::restore(session_id, ...) が存在する。一方で、現在の実行経路は新規 Pod 起動 (Pod::from_manifest) と生存中 Pod への attach / Paused 状態の Resume に限られており、停止済み Pod を既存 SessionId から起動するユーザー向け導線がない。

TUI には既に新規 Pod 起動用の spawn UI があるため、同じような選択 UI で既存 session を一覧し、選択した session を復元した Pod を起動して attach できるようにする。

要件

起動導線

TUI の既存挙動は維持する:
- tui（引数なし）: 新規 Pod spawn。現在と同じ name 入力ダイアログから始める
- tui <pod-name>: 生存中 Pod への attach
既存 session 復帰用に tui -r / tui --resume を追加する
- --resume はユーザー向けの「過去 session から復帰」入口であり、protocol の Method::Resume（Paused turn の続行）とは別概念として扱う
- --resume 指定時のみ、現在の name 入力ダイアログの前段に session 選択プロンプトを表示する
session id を直接指定するショートカットとして tui --session <UUID> を追加する
- --session は session picker をスキップし、指定 session を復元対象にした name 入力ダイアログから始める
- --resume と --session は併用不可
直接起動用に、Pod CLI に session id を指定して復元起動するフラグを追加する（pod --session <UUID>）
TUI の --resume / --session 復帰フローは最終的にこの Pod CLI 復元起動経路を使う

セッション一覧

manifest::paths::sessions_dir() または既存の --store 相当設定で解決される session store を読み、既存 session を新しい順に一覧表示する
一覧には少なくとも以下を表示する:
- SessionId
- 最終更新時刻、または store が提供できる同等の並び順情報
- 履歴の簡易プレビュー（最後の user / assistant メッセージ等、取得できる範囲でよい）
session log が壊れている、復元不能、または現在のバージョンで読めない場合は、その行を復帰不可として表示するか、エラー表示してスキップする
session が 1 件もない場合は、新規 Pod 起動へ戻れる導線を出す

復元 Pod の構築

選択した SessionId を使って Pod::restore 経由で Pod を構築する
manifest / scope / tool 登録 / prompt loader は、通常の新規 Pod 起動と同じ現在の cascade 解決結果を使う
Worker の会話履歴・system prompt・request config・turn count・usage history 等は session log 由来の状態を使う
復元起動時、runtime の history.json / status.json / Event::History で TUI が初期履歴を正しく再構築できる
復元された session が interrupted / paused 相当の状態を持つ場合、起動直後に Resume 可能な状態として扱う。通常終了済みなら Idle として新しい入力を受け付ける

二重起動の扱い

既に生きている Pod が同じ session を持っている場合は、新規復元起動せず既存 Pod への attach を促す
少なくとも、同じ session id に対する複数 Pod の同時書き込みが発生しないようにする
runtime dir / status.json から検出できる範囲でよいが、検出不能な場合のエラーメッセージは明示する

UI / 操作

tui -r / tui --resume では、name 入力の前に session picker を表示する
session picker は上下キーで session を選択し、Enter で決定、Esc / Ctrl-C でキャンセルできる
session が多い場合でも使えるよう、最低限のスクロールを備える
session 決定後は既存の name 入力ダイアログを再利用する
- 入力する name は、復元された session を載せる新しい Pod 実行インスタンス名（runtime dir / socket 名）
- default name は現行と同じ cwd 由来でよい
- 表示上は Resume Pod / session: <short-id> のように、新規 spawn ではなく復帰であることを明示する
tui --session <UUID> では session picker を省略し、指定 session を対象にした name 入力ダイアログから始める
将来的な検索フィルタ追加を妨げない state 構造にするが、本チケットでは必須にしない
復帰に失敗した場合、inline / alt-screen 内にエラーを表示し、一覧へ戻るか終了できる

完了条件

pod --session <UUID> で既存 session から Pod を起動できる
tui -r / tui --resume で既存 session 一覧を表示し、選択した session を復元対象にできる
tui --session <UUID> で session picker を経由せず、指定 session の復帰 name 入力へ進める
復帰フローでは session 選択後または --session 指定後に name 入力ダイアログが表示され、その name の Pod として起動・attach できる
復元直後の TUI に過去履歴が表示される
復元後に新しい入力を送ると、既存履歴に続く turn として動作し、session log に追記される
interrupted / paused 状態の session では、復元直後に Resume 導線が動作する
同一 session の生存中 Pod がある場合は二重起動せず attach または明示的なエラーになる

範囲外

session log の全文検索 UI
compact 前後の session chain を 1 つの論理スレッドとして束ねる UI
過去 session の編集・削除・名前付け
spawn された子 Pod / scope delegation ツリー全体の復元
別マシンから転送された session store の import UI

5.8 KiB Raw Blame History Unescape Escape