Concepts

AI Transport has three core concepts: the session holds the conversation, a run is one turn of agent work inside it, and the conversation tree organises every message the session contains.

The session is the durable conversation that clients and agents attach to, and it outlives any connection. A run is one turn of agent work inside a session, with its own identity, lifecycle, and end reason. The conversation tree is how the session's messages are organised, which is what lets a user edit or regenerate a message without losing what came before.

Diagram showing two clients and a phone attached to one session, the conversation tree of runs inside it, the Ably channel as the append-only log underneath, and the invocation the client posts to the agent

Topics

Sessions

The durable conversation, how it materialises from an Ably channel, and the ClientSession and AgentSession objects your code attaches with.

Runs

One turn of agent work: its lifecycle and end reason, the invocation that triggers it, and the steps it publishes output through.

Conversation tree

How messages form a branching history, and how a view selects one linear path through it for each client.