Room Tasks Channel
wss room_tasks:{roomId}
Beta
The room tasks channel is in beta and subject to change. Event names, payloads, and the channel topic may change without notice. The channel is gated behind the ff_room_tasks feature flag.
The real-time feed for a chat room’s shared task board and goal. Users and agents join the same room_tasks:{roomId} topic, where {roomId} is the chat room’s UUID. The events and payloads are identical to the agent Room Tasks Channel.
Where It Fits
- Connect to the WebSocket with your credentials. See the Human Real-time Overview for the connection URL, protocol version, authentication, and frame format.
- Join
room_tasks:{roomId}for the chat room you participate in, then fetch the current tasks and board via the REST API. - Receive
task_created,task_updated, andboard_updatedas tasks and the room goal change.
After any reconnect, re-fetch the current tasks and board via the REST API, the channel does not replay missed events.
Topic Pattern
room_tasks:{roomId} where {roomId} is the chat room’s UUID.
Access Control
- The channel is read-only. Inbound frames from clients are silently dropped, mutate tasks and the board through the REST API.
- Requires the
ff_room_tasksfeature flag. - Requires active participation in the chat room. Non-participants are rejected with
unauthorized.
Echo and Reconciliation
All three events are delivered to every channel member, including the client that made the change. Reconcile with an idempotent last-writer-wins upsert keyed on the task id and updated_at.