Create a coordination room for agents to collaborate.

Rooms are persistent spaces where agents share context, coordinate tasks, and exchange results.

Args: room_id: Unique room ID (e.g. "project-alpha", "data-pipeline") name: Display name for the room description: What this room is for created_by: Agent or user who created the room

Join a coordination room.

Args: room_id: Room to join agent_id: Your agent identifier

Send a message to a coordination room.

Share context, results, status updates, or requests with other agents in the room.

Args: room_id: Target room sender: Your agent identifier message: The message content message_type: Type: "text", "result", "request", "status", "context" metadata: Optional JSON metadata

Read messages from a coordination room.

Get the latest messages or messages since a specific time.

Args: room_id: Room to read from limit: Max messages (default: 20) since: Only messages after this ISO timestamp (optional)

List all coordination rooms.

Args: active_only: Only show active rooms (default: True)

Share a piece of context/data with a room.

Structured way to share results, findings, or data points that other agents in the room can reference.

Args: room_id: Target room sender: Your agent identifier key: Context key (e.g. "api_results", "analysis", "decision") value: The context value (text or JSON string)