yoi/crates/session-store
Hare 5edc4d3b03 feat: Session(Segment 群の grouping)を導入
- SessionId 型を新設、各 SegmentStart に session_id を持たせる
- compaction / 内部 fork は同 SessionId を継承、fork() は新 Session を発行
- Store API を (SessionId, SegmentId) ベースに、FsStore layout は
  <root>/<session_id>/<segment_id>.jsonl に
- Store::list_sessions / list_segments(session_id) / lookup_session_of を追加
- restore_by_segment shim を session-store に提供(pod-cli --session で使用)
- SegmentState に SegmentLocation (session_id, segment_id) を保持し ArcSwap で更新
- RestoredState に session_id: Option<SessionId> を追加
- Picker は Session 単位に列挙、leaf segment を解決して resume
2026-05-20 06:17:56 +09:00
..
src feat: Session(Segment 群の grouping)を導入 2026-05-20 06:17:56 +09:00
tests feat: Session(Segment 群の grouping)を導入 2026-05-20 06:17:56 +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 内容を取得する組み込みツール(行範囲・配列スライス・キー指定セレクタ対応)