Struct Conversation 

pub struct Conversation { /* private fields */ }

An ordered sequence of conversation messages with serialization helpers.

Implementations

impl Conversation

pub fn new() -> Self

Create a new empty conversation.

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

Create a conversation with a system message.

pub fn push(&mut self, message: ConversationMessage)

Append a message to the conversation.

pub fn messages(&self) -> &[ConversationMessage]

Get the messages in the conversation.

pub fn len(&self) -> usize

Get the number of messages.

pub fn is_empty(&self) -> bool

Check if the conversation is empty.

pub fn estimate_tokens(&self) -> usize

Estimate total token count across all messages.

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

Get the system message if present (first message with System role).

pub fn last_assistant_message(&self) -> Option<&ConversationMessage>

Get the last assistant message.

pub fn to_openai_messages(&self) -> Vec<Value>

Serialize to OpenAI chat completions format.

Produces a JSON array of message objects with role, content, and optionally tool_calls or tool_call_id fields.

pub fn to_anthropic_messages(&self) -> (Option<String>, Vec<Value>)

Serialize to Anthropic Messages API format.

Returns (system_prompt, messages) because Anthropic takes the system message as a separate top-level field.

pub fn truncate_to_budget(&mut self, max_tokens: usize)

Truncate the conversation to fit within a token budget.

Preserves the system message and the most recent messages. Removes older messages from the middle until the budget is met.

pub fn inject_knowledge_context(&mut self, context: impl Into<String>)

Insert a system-level knowledge context message after the initial system message. If a previous knowledge context exists (identified by a marker prefix), replace it.

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

Get metadata about the conversation for logging.

Trait Implementations

impl Clone for Conversation

fn clone(&self) -> Conversation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Conversation

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

Formats the value using the given formatter.

impl Default for Conversation

fn default() -> Conversation

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Conversation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Conversation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.