Skip to content

Add active session snapshot restoration protocol - #78

Draft
kevinyang372 wants to merge 1 commit into
mainfrom
oz/active-session-snapshot-protocol
Draft

Add active session snapshot restoration protocol#78
kevinyang372 wants to merge 1 commit into
mainfrom
oz/active-session-snapshot-protocol

Conversation

@kevinyang372

Copy link
Copy Markdown
Member

Summary

  • add the versioned MonolithicV1 active-session restore snapshot envelope and immutable storage descriptor
  • negotiate snapshot schema, reducer, storage layout, and compression capabilities
  • add prepared publication receipts, publication acknowledgements, resume cursors/floors, and classified resync reasons
  • preserve legacy wire payload compatibility with golden fixtures

Performance context

A downstream local Redis benchmark using valid protocol events and fixed restore watermark H measured the expected suffix-scaling behavior:

  • 50% snapshot position: approximately 2x faster server Redis-read plus serialization path
  • 90% snapshot position: approximately 9-10x faster
  • 99% snapshot position: approximately 37-89x faster depending on event profile
  • measured transfer-byte reduction ranged from 32% to 97% across 1K/10K PTY-heavy and mixed-agent fixtures

These figures exclude GCS authorization/download and client decode/hydration; the downstream server and client PRs contain the benchmark harnesses for those layers.

Rollout safety

This PR only defines the wire contract. Snapshot publication, restore, storage, and Redis compaction remain disabled in downstream repositories. Production shadow equivalence and retained-session sampling remain rollout blockers.

Validation

  • RUSTUP_TOOLCHAIN=1.88.0 cargo test --all-targets (13 passed)
  • RUSTUP_TOOLCHAIN=1.88.0 cargo clippy --all-targets --all-features -- -D warnings
  • RUSTUP_TOOLCHAIN=1.88.0 cargo fmt --all -- --check
  • git diff --check

Artifacts

@cla-bot cla-bot Bot added the cla-signed label Aug 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant