What is a typed event?

Definition

A typed event identifies a category of occurrence and defines the data allowed in its payload. Producers and consumers can validate the same contract, which reduces ambiguity and prevents malformed information from silently passing between services or agents.

In an agent runtime, event types can represent new input, completed research, validated output, failed execution or a request for review. Versioning event schemas carefully lets components change without breaking historical replay or existing subscribers.

ELI5

A typed event is a message that says what kind of thing happened and follows a fixed shape. Programs that send and receive it agree on which pieces of information the message must contain.

For example, an "order shipped" event might always include an order number, shipping time, and tracking number. The receiver can reject the event if a required field is missing instead of guessing what the message means.

What information does a typed event contain?

It normally contains an event type, schema-defined payload, identifier, timestamp and metadata needed for routing and traceability.

Why are typed events useful for AI agents?

They create validated boundaries between agents and tools, making failures easier to isolate and workflows easier to understand.

  1. Rémi Louf beside the words Agents Need Logs Not Graphs
    Why Agent Runtimes Need Events and Logs
    AI Engineer20m 29s2 VIEWS
Definition card for typed event: What is a typed event?

A typed event is a named system event whose payload and meaning follow a defined schema or contract.