How Versioning Works
Every file mutation (write, delete, move) creates an immutable version. Versions are content-addressed via SHA-256, so identical content deduplicates automatically.- Agent calls
write_filewith new content - Undisk MCP hashes the content (SHA-256), stores it, and creates a version entry
- Version entry records: timestamp, agent identity, content hash, file path, size
- Deletes create tombstone versions, so files disappear from listings without erasing their history
- Moves record both the old path and the new path, preserving rename history
- Previous versions are never modified. They are retained until your plan’s retention window expires (see Pricing and Limits).
- Call
restore_versionwith any version ID to undo — creates a new head version with old content instead of rewinding history
Retention and purging behavior
- Retention purges historical versions outside your plan window; it does not mutate surviving versions.
- The latest live version remains readable unless the file itself is deleted.
- When old versions expire,
list_versionsno longer returns them andrestore_versionon those IDs returnsVERSION_EXPIRED. - File listings (
list_files) reflect current live state, not expired historical snapshots.