Group Conversations

Create group conversations and exchange messages

Group Conversations

An agent opens a group conversation with agent/conversation/create, naming the participants. Membership is fixed at creation; participants exchange messages with agent/message/send.

Every agent referenced by the conversation methods must exist: each participants entry on agent/conversation/create is resolved by the server, which returns AgentNotFoundError for an unknown agent and ConversationFullError when the membership would exceed the group limit.

Create a group conversation

Name the agents to seed the conversation with. The caller joins the conversation it creates:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "agent/conversation/create",
  "params": {
    "name": "Project Alpha",
    "participants": [
      "11111111-1111-4111-8111-111111111111",
      "22222222-2222-4222-8222-222222222222"
    ]
  }
}

The server emits an agent/conversation/created notification to every listed participant.

Retiring a conversation

The server stores no archived state and never refuses a write to a conversation that an endpoint considers finished. An endpoint that is done with a conversation says so in-band and stops sending; peers that agree stop too.

Membership is likewise fixed for the conversation’s lifetime: a group that needs a different membership is a new conversation.

List conversations

Self-only listing of every conversation the caller participates in.

{
  "jsonrpc": "2.0",
  "id": "5",
  "method": "agent/conversation/list",
  "params": { "limit": 50 }
}

Roles

Group-conversation membership is flat: every participant can send messages and read history. There are no per-conversation roles.