Struct ConversationState 

pub struct ConversationState {
    pub messages: Vec<Message>,
    pub system_prompt: String,
    pub turn_count: usize,
    pub task_id: String,
    pub created_at: DateTime<Utc>,
}

Wraps llm-cascade Conversation with agent-specific metadata.

Tracks turn count, task ID, and timestamps for persistence and observability. Implements ConversationStateAccess so the memory subsystem can operate on it.

Fields

messages: Vec<Message>

The ordered list of conversation messages (user, assistant, tool results).

system_prompt: String

System prompt prepended to every LLM call.

turn_count: usize

Number of user turns processed so far.

task_id: String

Unique identifier for the current task.

created_at: DateTime<Utc>

Timestamp when this state was created.

Implementations

impl ConversationState

pub fn new(system_prompt: String, task_id: String) -> Self

Create a new empty conversation state.

pub fn add_user_message(&mut self, content: String)

Append a user message and increment the turn counter.

pub fn add_assistant_text(&mut self, content: String)

Append an assistant text response.

pub fn add_tool_result(&mut self, tool_call_id: &str, result: &str)

Append a tool result message associated with a tool call ID.

pub fn to_conversation(&self) -> Conversation

Build an llm_cascade::Conversation from current state.

Prepends the system prompt as the first message and attaches no tools (tools are added via with_tools by the caller when needed).

pub fn last_assistant_text(&self) -> Option<String>

Get the last assistant text message (excluding tool-call stubs).

pub fn to_json(&self) -> Result<String>

Serialize state to a pretty-printed JSON string.

pub fn to_json_file(&self, dir: &str) -> Result<PathBuf>

Save state to a JSON file in the given directory.

Trait Implementations

impl ConversationStateAccess for ConversationState

fn messages(&self) -> &[Message]

Returns the current conversation messages as a slice.

fn messages_mut(&mut self) -> &mut Vec<Message>

Returns a mutable reference to the messages vector for in-place compaction.

fn system_prompt(&self) -> &str

Returns the system prompt string (first system message content).

impl Debug for ConversationState

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

Formats the value using the given formatter.

impl Serialize for ConversationState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.