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

# Event Patterns

> The ways a producer composes events into a stream — draft

<Warning>
  **Draft — not yet ratified.** This document is published for review. It
  describes the intended 1.0 behaviour, its wording is not final, and nothing
  here is covered by a compatibility promise until a version is frozen. Do not
  cite it as a stable reference.
</Warning>

This page defines the event patterns of the core protocol: the ways a producer
composes events into a stream. Every
[transport](/spec/draft/basic/transports) carries all of these patterns;
transports differ only in how events are framed and delivered.

The direction of the protocol is fixed. Events flow from producer to consumer;
the consumer speaks exactly once per exchange, by sending the
[run input](/spec/draft/basic/run-input) that opens it. A producer MUST NOT
require any mid-run message from the consumer — a run that needs outside input
ends, and the answer arrives on the next run: through an interrupt and its
resume entries, or through a
[frontend tool call](/spec/draft/events/tool-calls#frontend-tools) left
unanswered and answered in the next input's messages.

## Streaming

Long values arrive a piece at a time: a `*_START` opens an item, content
events extend it, a `*_END` closes it — or a chunked shorthand compresses the
three. Text messages, tool calls and reasoning messages all stream this way.

```mermaid theme={null}
sequenceDiagram
    participant Producer
    participant Consumer
    Producer->>Consumer: *_START (id)
    Producer->>Consumer: content (id, delta) ×N
    Producer->>Consumer: *_END (id)
```

See [Streaming Messages](/spec/draft/basic/patterns/streaming).

## Snapshot and delta

Values that evolve — agent state, activities, the conversation itself — are
carried as a snapshot that replaces and deltas that amend, with deltas
expressed as RFC 6902 JSON Patch.

```mermaid theme={null}
sequenceDiagram
    participant Producer
    participant Consumer
    Producer->>Consumer: *_SNAPSHOT (the whole value)
    Producer->>Consumer: *_DELTA (a patch) ×N
    Producer->>Consumer: *_SNAPSHOT (resynchronise)
```

See [Snapshots and Deltas](/spec/draft/basic/patterns/snapshots).

## Interrupt and resume

A run that needs something from outside — an approval, a missing value — ends
with an interrupt outcome, and the run that continues from it carries the
answers in its input.

```mermaid theme={null}
sequenceDiagram
    participant Application
    participant Agent
    Application->>Agent: RunAgentInput
    Agent->>Application: … events …
    Agent->>Application: RUN_FINISHED (outcome: interrupt)
    Note over Application: gathers the answer
    Application->>Agent: RunAgentInput (resume: answers)
    Agent->>Application: RUN_STARTED …
```

See [Interrupts and Resume](/spec/draft/basic/patterns/interrupt-resume).

## Adding patterns

All protocol features are built from these patterns. A protocol revision that
adds a pattern defines it on this page. Transports carry new patterns without
changes, because patterns are expressed entirely in terms of events and the
run input.