Struct Turn 

pub struct Turn<'a> { /* private fields */ }

Available on crate feature async-client only.

One turn of the conversation: everything between a prompt and the agent going idle again.

Steps stream out of Turn::next_step. While it is being polled, the turn also answers whatever the harness asks of the client — so a tool handler runs inside next_step, not on a background task. Tool calls are therefore executed one at a time, in arrival order.

Implementations

impl Turn<'_>

pub async fn next_step(&mut self) -> Result<Option<Step>>

The next step, or None once the agent has gone idle.

If the turn failed, the error surfaces after the last step, so whatever the agent said before failing is still delivered.

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

Drains the turn and returns everything the agent said to the user.

pub fn is_finished(&self) -> bool

True once the agent has gone idle.

Trait Implementations

impl<'a> Debug for Turn<'a>

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

Formats the value using the given formatter.