Struct ManagedConversation 

pub struct ManagedConversation { /* private fields */ }

A managed conversation that tracks messages and their metadata.

Implementations

impl ManagedConversation

pub fn new() -> Self

Create a new managed conversation.

pub fn with_system(system: impl Into<String>) -> Self

Create a conversation with a system message.

pub fn set_system(&mut self, content: impl Into<String>)

Set or replace the system message.

pub fn system_message(&self) -> Option<&Message>

Get the system message.

pub fn add_user_message(&mut self, content: impl Into<String>)

Add a user message.

pub fn add_assistant_message(&mut self, content: impl Into<String>)

Add an assistant message.

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

Add any message.

pub fn add_messages(&mut self, messages: impl IntoIterator<Item = Message>)

Add multiple messages.

pub fn messages(&self) -> Vec<Message>

Get all messages as a vector (including system message).

pub fn tracked_messages(&self) -> &[TrackedMessage]

Get tracked messages (excluding system).

pub fn last_n_messages(&self, n: usize) -> Vec<Message>

Get the last N messages (excluding system).

pub fn last_message(&self) -> Option<&Message>

Get the last message.

pub fn len(&self) -> usize

Get message count (excluding system).

pub fn is_empty(&self) -> bool

Check if empty (excluding system).

pub fn estimated_tokens(&self) -> usize

Estimate total token count.

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

Clear all messages (optionally keeping system message).

pub fn remove_before(&mut self, id: usize)

Remove messages older than a given ID.

pub fn remove_first(&mut self, n: usize)

Remove the first N messages.

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

Set metadata.

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

Get metadata.

pub fn metadata(&self) -> &HashMap<String, String>

Get all metadata.

pub fn find_messages(&self, text: &str) -> Vec<&TrackedMessage>

Find messages containing text.

pub fn messages_by_role(&self, role: &str) -> Vec<&TrackedMessage>

Get messages by role.

pub fn to_text(&self) -> String

Get conversation as formatted text.

Trait Implementations

impl Clone for ManagedConversation

fn clone(&self) -> ManagedConversation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ManagedConversation

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

Formats the value using the given formatter.

impl Default for ManagedConversation

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ManagedConversation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ManagedConversation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.