Struct Session 

pub struct Session<'a, M: Model> { /* private fields */ }

A persistent multi-turn conversation over one AgentLoop.

Holds the append-only history and, on each turn, re-runs the loop against a stable prefix (system + name-sorted tool schemas). That byte-stable prefix is what lets a provider’s prefix cache hit across turns — the difference between paying full price to re-read the same context every round and paying ~10% for the cached bytes (DeepSeek).

Implementations

impl<'a, M: Model> Session<'a, M>

pub fn with_max_iters(self, n: u32) -> Self

pub fn with_seed(self, seed: Vec<Turn>) -> Self

Preload prior turns (e.g. resumed from disk).

pub fn history(&self) -> &[Turn]

The accumulated conversation so far.

pub fn reset(&mut self)

Start over (branch): drop the accumulated turns.

pub async fn turn( &mut self, message: impl Into<String>, world: &mut World, ) -> Result<Outcome, HarnessError>

Send one user message. Runs the ReAct loop against the accumulated history, then appends this user turn + the assistant reply so the next turn extends the same cached prefix.