Struct SummaryMemory 

pub struct SummaryMemory { /* private fields */ }

LLM-backed memory: when message count exceeds threshold, summarize the oldest threshold/2 messages into a single system message (via the supplied Client) and drop the originals.

Summarization is lazy — it runs in seed() (called by the agent before each turn). That keeps write() synchronous, which is what the Memory trait requires.

Implementations

impl SummaryMemory

pub fn new(client: Client, threshold: usize) -> Self

Build with the LLM client used to summarize, and the message count at which compression kicks in.

pub fn with_system(self, prompt: impl Into<String>) -> Self

Pin a system message at the head of the seed.

pub fn with_prompt(self, p: impl Into<String>) -> Self

Override the summarization prompt.

pub async fn compact(&mut self) -> Result<()>

Force compression now, regardless of threshold. Useful for tests and explicit “compact” calls.

impl SummaryMemory

pub fn needs_compact(&self) -> bool

True when the buffer has grown past the configured threshold and a compact() call would do work.

Trait Implementations

impl Memory for SummaryMemory

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

All currently buffered messages.

fn write(&mut self, msg: Message)

Append one message.

fn clear(&mut self)

Clear all buffered messages (system pinned ones survive in the Window impl).

fn seed(&self) -> Vec<Message>

Build the seed messages for a fresh graph run. Default: read().to_vec().