# StreamEvent

> The message for each small bit of a reply. It lets text show as it is typed.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** partial message, includePartialMessages, Claude Agent SDK StreamEvent

## Think of it like

It is like hearing each word as it is said.

## Definition

StreamEvent is the message type for small raw parts of a reply as the model writes them. You only get them when you turn on partial messages. The option is includePartialMessages in TypeScript. Use them to show text as it is typed. Without them, you see each block only when it is done.

## Example

Mia wants her chat to type out answers live. She turns on partial messages and draws each StreamEvent's text as it comes.

## Why it matters

Users trust a reply more when they can see it being written.

## Common mistake

Waiting for StreamEvents with the option off. They never come unless you turn it on.

## Three principles

- **Raw pieces.** As they are written.
- **Off by default.** Turn it on.
- **For live text.** Typing effect.

## Related terms

- [AssistantMessage](https://learn.benibix.com/term/ai/sdk-assistant-message)
- [Streaming Input Mode](https://learn.benibix.com/term/ai/streaming-input-mode)

---

Source: https://learn.benibix.com/term/ai/sdk-stream-event
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
