Stream items

The stream result exposes replayable consumers for text and provider items.

stream = agent.stream(input: prompt, client: client)

stream.item_stream.each do |item|
  render_item(item)
end

result = stream.result

Use full_stream when the interface also needs reasoning deltas, tool progress, approval checkpoints, or lifecycle events.

Ruby item values are generic hashes rather than a closed typed item union. Validate the fields your UI consumes and keep an unknown-item fallback for future provider events.

Ruby consumes the provider stream synchronously and makes the collected sequence replayable. It does not create a background push service by itself.

Last modified on July 26, 2026

Streaming Dynamic turns

Start Here

Build

Observe

Reference