Struct Yielded 

pub struct Yielded<'a, 'h, Ctx: LoopDepth + Send + Sync + 'static> {
    pub tool_calls: Vec<ToolCall>,
    pub results: Vec<ToolResult>,
    pub assistant_content: Vec<ContentBlock>,
    pub iteration: u32,
    pub total_usage: Usage,
    pub events: Vec<LoopEvent>,
    /* private fields */
}

Handle returned when tools were executed. Borrows the ToolLoopHandle mutably, so the caller cannot call next_turn() again until this is consumed via resume(), continue_loop(), inject_and_continue(), or stop().

The text content the LLM produced alongside tool calls is available directly via assistant_content and assistant_text() — no need to scan messages().

Fields

tool_calls: Vec<ToolCall>

The tool calls the LLM requested.

results: Vec<ToolResult>

Results from executing those tool calls.

assistant_content: Vec<ContentBlock>

Text content from the LLM’s response alongside the tool calls.

This is the other_content from partition_content() — Text, Reasoning, Image, etc. — everything that isn’t a ToolCall or ToolResult. Previously only accessible by scanning messages().

iteration: u32

Current iteration number (1-indexed).

total_usage: Usage

Accumulated usage across all iterations so far.

events: Vec<LoopEvent>

Lifecycle events from this turn (IterationStart, ToolExecutionStart/End, etc.).

Pre-drained from the internal buffer — no need to call ToolLoopHandle::drain_events() separately.

Implementations

impl<'a, 'h, Ctx: LoopDepth + Send + Sync + 'static> Yielded<'a, 'h, Ctx>

pub fn resume(self, command: LoopCommand)

Continue with the given command.

pub fn continue_loop(self)

Convenience: continue to the next LLM iteration with no injected messages.

pub fn inject_and_continue(self, messages: Vec<ChatMessage>)

Convenience: inject messages and continue.

pub fn stop(self, reason: Option<String>)

Convenience: stop the loop.

pub fn assistant_text(&self) -> Option<String>

Extract text from assistant_content blocks.

Returns the LLM’s “thinking aloud” text emitted alongside tool calls, or None if there were no text blocks.

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

Access the full message history (read-only).

pub fn messages_mut(&mut self) -> &mut Vec<ChatMessage>

Access the full message history (mutable, for context compaction).