> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Stream items

> Consume text, reasoning, tool, and provider item events from Ruby agent runs.

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

```ruby theme={null}
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.

<Note>
  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.
</Note>

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