Struct ConversationBuffer 

pub struct ConversationBuffer { /* private fields */ }

In-memory circular buffer of recent conversation turns.

Implementations

impl ConversationBuffer

pub fn new(max_turns: usize) -> Self

Create a new buffer with the given maximum size.

pub fn push_user(&mut self, message: &str)

Record a user message (before processing).

pub fn push_agent(&mut self, response: &str, space_id: &SpaceId)

Record an agent response and Space (call after processing completes).

pub fn recent(&self, n: usize) -> Vec<&ConversationTurn>

Get the most recent N turns.

pub fn turns(&self) -> VecDeque<ConversationTurn>

Get all turns.

pub fn len(&self) -> usize

Get the total number of turns.

pub fn is_empty(&self) -> bool

Check if the buffer is empty.

pub fn should_check_topic(&self, min_turns: usize) -> bool

Check if topic shift detection should run.

Returns true if N or more turns have passed since the last check, or if the conversation pattern has visibly changed.

pub fn mark_topic_checked(&mut self)

Record that a topic check was performed.

pub fn record_turn(&mut self, min_turns: usize) -> bool

Increment the turn counter and check if topic check should run.

pub fn should_check_topic_from_messages( turns: &[ConversationTurn], _min_turns: usize, ) -> bool

Static version of should_check_topic that works on a slice of ConversationTurns.

Returns false if we don’t have enough history (safe default — skips expensive LLM-based detection). Returns true if 3+ turns have passed since last check or pattern changed.

pub fn pattern_changed(&self) -> bool

Detect if the conversation pattern has changed.

Looks at average word count and average message length to detect topic or style shifts without LLM.

pub fn space_changed(&self) -> bool

Check if the Space has changed since the last turn.

pub fn last_space_id(&self) -> Option<SpaceId>

Get the last recorded Space ID.

pub fn clear(&mut self)

Clear all turns.

Trait Implementations

impl Clone for ConversationBuffer

fn clone(&self) -> ConversationBuffer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConversationBuffer

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

Formats the value using the given formatter.

impl Default for ConversationBuffer

fn default() -> Self

Returns the “default value” for a type.