Struct AgentState 

pub struct AgentState {

    pub id: String,
    pub agent_type: String,
    pub status: AgentStateStatus,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub prompt: String,
    pub messages: Vec<Message>,
    pub tool_calls: Vec<ToolCallRecord>,
    pub results: Vec<Value>,
    pub checkpoint: Option<Checkpoint>,
    pub checkpoints: Vec<Checkpoint>,
    pub current_step: usize,
    pub total_steps: Option<usize>,
    pub error_count: usize,
    pub retry_count: usize,
    pub max_retries: usize,
    pub metadata: HashMap<String, Value>,
}

Agent state for persistence and recovery

Fields

id: String

Unique state identifier (same as agent ID)

agent_type: String

Agent type

status: AgentStateStatus

Current status

created_at: DateTime<Utc>

Creation timestamp

updated_at: DateTime<Utc>

Last update timestamp

prompt: String

Original prompt

messages: Vec<Message>

Conversation messages

tool_calls: Vec<ToolCallRecord>

Tool call records

results: Vec<Value>

Results collected

checkpoint: Option<Checkpoint>

Current checkpoint (if any)

checkpoints: Vec<Checkpoint>

All checkpoints

current_step: usize

Current step number

total_steps: Option<usize>

Total steps (if known)

error_count: usize

Error count

retry_count: usize

Retry count

max_retries: usize

Maximum retries allowed

metadata: HashMap<String, Value>

Custom metadata

Implementations

impl AgentState

pub fn new( id: impl Into<String>, agent_type: impl Into<String>, prompt: impl Into<String>, ) -> Self

Create a new agent state

pub fn with_status(self, status: AgentStateStatus) -> Self

Set status

pub fn with_max_retries(self, max_retries: usize) -> Self

Set max retries

pub fn with_total_steps(self, total: usize) -> Self

Set total steps

pub fn add_message(&mut self, message: Message)

Add a message

pub fn add_tool_call(&mut self, tool_call: ToolCallRecord)

Add a tool call

pub fn add_result(&mut self, result: Value)

Add a result

pub fn increment_step(&mut self)

Increment step

pub fn record_error(&mut self)

Record an error

pub fn record_retry(&mut self)

Record a retry

pub fn reset_errors(&mut self)

Reset error state

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

Set metadata

pub fn create_checkpoint(&mut self, name: Option<&str>) -> Checkpoint

Create a checkpoint from current state

pub fn restore_from_checkpoint(&mut self, checkpoint: &Checkpoint)

Restore from a checkpoint

pub fn can_resume(&self) -> bool

Check if can be resumed

pub fn latest_checkpoint(&self) -> Option<&Checkpoint>

Get the latest checkpoint

pub fn age(&self) -> ChronoDuration

Get age of the state

pub fn is_expired(&self, max_age: Duration) -> bool

Check if state is expired based on max age

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<'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 PartialEq for AgentState

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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.

impl Eq for AgentState