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

# rooms • AI Agent SDK

> Conversation-room turn coordination for multi-agent chats (Issue #4917).

# rooms

<Badge color="blue">AI Agent</Badge>

Conversation-room turn coordination for multi-agent chats (Issue #4917).

PraisonAI's gateway binds a single `Agent` per conversation. A *room* is the
live, message-driven counterpart of :class:`~praisonaiagents.agents.agents.AgentTeam`:
a declared roster of agents that take turns in one shared chat transcript.

Coordinating turn order over a shared, restart-safe transcript is
infrastructure, not a prompt. The only part of that infrastructure that must be
**pure and deterministic** — so a gateway restart reconstructs the exact same
schedule from durable state — is the *turn planner*. That contract belongs in
core (mirroring `gateway.plan_pressure_evictions` and the `workflows`
process planners); the heavy transcript store, durable outbox and platform
delivery live in the `praisonai-bot` wrapper.

This module is intentionally lightweight: **no heavy imports, no I/O**. It
contains a protocol, a minimal event/roster model and a reference planner:

* :class:`RoomEvent` — one immutable message in the shared transcript.
* :class:`RoomTurnPlannerProtocol` — `plan_next(roster, transcript) -&gt; str|None`.
* :func:`extract_mentions` — parse `@name` addressing between participants.
* :class:`RoundRobinRoomPlanner` — the default bounded, deterministic planner:
  round 0 lets every rostered agent speak once; later rounds admit **only**
  agents an earlier agent `@`-mentioned, with hard caps on rounds/messages so
  a room can never loop unbounded.

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import rooms
```