Struct StepIterator 

pub struct StepIterator<'a, P: Provider, C: ContextStrategy> { /* private fields */ }

Step-by-step iterator over the agentic loop.

Allows driving the loop one turn at a time with full control between turns: inspect messages, inject new messages, modify tools.

Created via AgentLoop::run_step.

Implementations

impl<'a, P: Provider, C: ContextStrategy> StepIterator<'a, P, C>

pub async fn next(&mut self) -> Option<TurnResult>

Advance the loop by one turn.

Returns None if the loop has already completed (final response was returned or an error occurred).

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

Returns a reference to the current messages.

pub fn inject_message(&mut self, message: Message)

Inject a message into the conversation between turns.

pub fn tools_mut(&mut self) -> &mut ToolRegistry

Returns a mutable reference to the tool registry.