Struct Conversation 

pub struct Conversation { /* private fields */ }

The messages of one conversation.

Implementations

impl Conversation

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

The messages, oldest first.

pub fn view(&self, budget: usize) -> Vec<Value>

The messages as they go out in a request that is at most budget bytes: the conversation as it is when it fits, and a trimmed view of it when it does not. What is kept is kept whole, and nothing is asked of the model to make the view smaller.

Three parts are never shortened: the first message, which usually holds the task; the newest message, which holds the tool results the model is waiting for an answer to; and the shape of a call and its result, so that every call still has its answer. What is shortened first is the tool results of the turns in between, oldest first, since they are the biggest part of an old turn and the least needed of it; the text of those turns follows in the same order, only if the results alone are not enough. Wherever something is left out, an English note stands in its place saying what was left out, and the conversation kept here is not touched.

pub fn is_empty(&self) -> bool

Whether nothing has been said yet.

pub fn say(&mut self, text: &str)

Adds what the person wrote. Right after another user message (a reply that was stopped before it said anything) the text joins that message, since the API wants the roles to take turns.

pub fn reply(&mut self, content: Vec<Value>)

Adds the model’s reply. Nothing is added for a reply with no content.

pub fn results(&mut self, results: Vec<Value>)

Adds the results of tool calls, each a tool_result block.

pub fn open_calls(&self) -> Vec<Call>

The tool calls of the last message that have no result yet, in the order they were made.

pub fn to_json(&self) -> Value

The conversation as it is saved.

pub fn holds(value: &Value) -> bool

Whether value is a conversation as this program keeps one. A file that is not one holds somebody’s thread in a shape this program cannot show, which is not the same as a file that holds nothing.

pub fn from_json(value: &Value) -> Self

A saved conversation. Anything that is not a message is left out, and calls that were waiting when the program closed are answered as not done, so the conversation can go on.

Trait Implementations

impl Clone for Conversation

fn clone(&self) -> Self

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() -> Self

Returns the “default value” for a type.

impl PartialEq for Conversation

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Conversation