Struct WorkingSet 

pub struct WorkingSet { /* private fields */ }

Manages the set of files currently in the agent’s context

Implementations

impl WorkingSet

pub fn new() -> Self

Create a new working set with default configuration.

pub fn with_config(config: WorkingSetConfig) -> Self

Create a new working set with the given configuration.

pub fn next_turn(&mut self)

Advance to the next turn, triggering stale eviction if enabled.

pub fn current_turn(&self) -> u32

Returns the current turn number.

pub fn add(&mut self, path: PathBuf, tokens: usize) -> Option<String>

Add a file to the working set, evicting LRU entries if needed.

pub fn add_labeled( &mut self, path: PathBuf, tokens: usize, label: &str, ) -> Option<String>

Add a file with a label, evicting LRU entries if needed.

pub fn add_pinned(&mut self, path: PathBuf, tokens: usize, label: Option<&str>)

Add a pinned file that is immune to eviction.

pub fn touch(&mut self, path: &Path) -> bool

Touch a file to update its access count and turn.

pub fn remove(&mut self, path: &Path) -> bool

Remove a file from the working set.

pub fn pin(&mut self, path: &Path) -> bool

Pin a file to prevent eviction.

pub fn unpin(&mut self, path: &Path) -> bool

Unpin a file, allowing it to be evicted.

pub fn clear(&mut self, keep_pinned: bool)

Clear the working set, optionally keeping pinned entries.

pub fn entries(&self) -> impl Iterator<Item = &WorkingSetEntry>

Iterate over all entries in the working set.

pub fn get(&self, path: &Path) -> Option<&WorkingSetEntry>

Get an entry by path.

pub fn contains(&self, path: &Path) -> bool

Check if a path is in the working set.

pub fn len(&self) -> usize

Returns the number of entries in the working set.

pub fn is_empty(&self) -> bool

Returns true if the working set is empty.

pub fn total_tokens(&self) -> usize

Returns the total estimated token count across all entries.

pub fn last_eviction(&self) -> Option<&str>

Returns the last eviction message, if any.

pub fn file_paths(&self) -> Vec<&PathBuf>

Returns all file paths in the working set.

pub fn record_write(&mut self, path: &Path, hash: [u8; 32])

Record the SHA-256 of content a tool has just written to path.

If the entry is already present, its intended_hash is overwritten (the most recent write wins) and last_access_turn is refreshed. If the entry does not exist yet, a new one is inserted with zero estimated tokens — the caller is expected to update token estimates separately via add/add_labeled when loading file content.

pub fn get_intended_hash(&self, path: &Path) -> Option<[u8; 32]>

Return the intended-write SHA-256 previously recorded for path, if any. None if the path is not tracked or was never written.

Trait Implementations

impl Clone for WorkingSet

fn clone(&self) -> WorkingSet

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WorkingSet

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for WorkingSet

fn default() -> WorkingSet

Returns the “default value” for a type.