yoi/crates/session-store
Hare c2b55a498b update: 残存 Session 識別子の Segment 化(review follow-up)
レビュー指摘の通り、次の session-grouping-introduce で新 SessionId が
入る前に名称衝突を避けるため取り残しを掃除。

- PodError::Session{Empty,ScopeMissing} → Segment{Empty,ScopeMissing}
- ScopeLockError::SessionConflict → SegmentConflict
- Pod.session_state / SegmentState.set_session_id 系
- source_session_id / prev_session_id / ensure_session_head / short_session
- pod_cli の "Session ID:" 表示
- fs_store の sessions ローカル変数
2026-05-20 05:17:49 +09:00
..
src update: 残存 Session 識別子の Segment 化(review follow-up) 2026-05-20 05:17:49 +09:00
tests update: SessionId / SessionStart / SessionOrigin 等を Segment 系名称へ 2026-05-20 05:06:04 +09:00
Cargo.toml update: entry hash chain と session_head mutex を撤廃 2026-05-20 04:31:37 +09:00
README.md session-storeとして分離 2026-04-12 06:31:34 +09:00

llm-worker-persistence

Worker のセッション永続化を提供するクレート。追記専用の JSONL ログとして状態遷移を記録し、ログの再生によってセッションを完全に復元する。大きなツール出力は Blob ストアに分離保存する。

公開型

セッション

  • Session<C, St> — Worker をラップした永続化セッション(run(), resume(), fork(), fork_at()
  • SessionId — UUID v7 によるセッション識別子
  • SessionConfig — 永続化設定(イベントトレース記録の有無)

ストア

  • Store トレイト — 永続化バックエンド抽象(append, read_all, list_sessions
  • FsStore — ファイルシステム上の JSONL ストア実装
  • BlobStore トレイト — Blob ストレージ抽象(store, load
  • FsBlobStore — ファイルシステム上の Blob ストア実装
  • BlobOutputProcessor — ToolOutputProcessor 実装(小さい出力はインライン、大きい出力は Blob 保存)

ログ

  • LogEntry — セッションログのエントリ型(SessionStart, UserInput, AssistantItems, TurnEnd など)
  • RestoredState — ログ再生で復元された状態
  • collect_state() — ログエントリ列から状態を復元する関数

ツール

  • InspectTool — Blob 内容を取得する組み込みツール(行範囲・配列スライス・キー指定セレクタ対応)