Module workspace_snapshot 

Cheap workspace environment-delta observability.

Long-horizon agents operate in a changing environment: files are written, processes mutate state, git trees move. The harness needs a fast way to detect that the environment drifted between turns so it can re-ground assumptions instead of trusting a stale picture.

WorkspaceSnapshot captures a lightweight fingerprint of every tracked file (size + mtime + a short content hash of the head), and diff computes added/changed/removed paths. Snapshots are cheap enough to take at each turn boundary and to persist as a derived view.

Structs

FileStat

A compact fingerprint of a single file.

SnapshotDelta

The difference between two workspace snapshots.

WorkspaceSnapshot

A point-in-time fingerprint of a workspace’s tracked files.

Functions

diff

Compute the delta from old to new.

snapshot_path

Resolve the on-disk path for a session’s environment snapshot.