Struct AgentState 

pub struct AgentState {
    pub files: HashMap<PathBuf, FileState>,
    pub errors: Vec<ErrorInfo>,
    pub occupied_files: HashMap<PathBuf, u32>,
    pub investigated: HashMap<PathBuf, u32>,
    pub metrics: HashMap<String, f64>,
    pub last_progress_tick: u64,
    pub total_changes: usize,
}

State of the agent’s world

Fields

files: HashMap<PathBuf, FileState>

Files that have been loaded/modified

errors: Vec<ErrorInfo>

Current errors (compile, lint, etc.)

occupied_files: HashMap<PathBuf, u32>

Files currently being investigated by other agents

investigated: HashMap<PathBuf, u32>

Completed investigation targets

metrics: HashMap<String, f64>

Custom metrics

last_progress_tick: u64

Last progress tick (for stall detection)

total_changes: usize

Total changes made

Implementations

impl AgentState

pub fn new() -> Self

Create a new empty state

pub fn update_file(&mut self, path: PathBuf, state: FileState)

Add or update a file’s state

pub fn get_file(&self, path: &PathBuf) -> Option<&FileState>

Get a file’s state

pub fn add_error(&mut self, error: ErrorInfo)

Add an error

pub fn clear_errors(&mut self)

Clear all errors

pub fn has_errors(&self) -> bool

Check if there are any errors

pub fn error_count(&self) -> usize

Get the number of errors

pub fn most_errored_file(&self) -> Option<&PathBuf>

Get the file with the most errors

pub fn occupy_file(&mut self, path: PathBuf, agent_id: u32)

Mark a file as occupied by an agent

pub fn release_file(&mut self, path: &PathBuf)

Release a file

pub fn is_occupied(&self, path: &PathBuf, exclude_agent: u32) -> bool

Check if a file is occupied (by another agent)

pub fn mark_investigated(&mut self, path: PathBuf, agent_id: u32)

Mark a file as investigated

pub fn is_investigated(&self, path: &PathBuf) -> bool

Check if a file has been investigated

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

Get uninvestigated files

pub fn available_files(&self, agent_id: u32) -> Vec<&PathBuf>

Get available files for an agent (not occupied, not investigated)

pub fn set_metric(&mut self, key: impl Into<String>, value: f64)

Set a metric

pub fn get_metric(&self, key: &str) -> Option<f64>

Get a metric

pub fn record_progress(&mut self, tick: u64, changes: usize)

Record progress at current tick

pub fn is_stalled(&self, current_tick: u64, threshold: u64) -> bool

Check if progress is stalled

pub fn summary(&self) -> String

Generate a summary for logging

Trait Implementations

impl Clone for AgentState

fn clone(&self) -> AgentState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentState

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

Formats the value using the given formatter.

impl Default for AgentState

fn default() -> AgentState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.