conversation

A message thread — an iMessage chat, WhatsApp group, email thread, Claude transcript, etc. Contains messages and links to participants.

Metadata	Value
Plural	conversations
Subtitle field	text
Identity	platform, id

Fields

Field	Type
isGroup	boolean
isArchived	boolean
unreadCount	integer
messageCount	integer
accountEmail	string
cwd	string
gitBranch	string

Relations

Relation	Target
platform	product
participant	actor[]
message	message[]
in	folder

Prior art

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

• ActivityStreams 2.0 context/inReplyTo — Conversations are AS2 contexts — the thread that groups replies. Our participant[] ≈ to/cc/audience.
• Matrix Room (m.room) — Practical thread model. Our isGroup ≈ room.join_rules; unreadCount ≈ unread_notifications.highlight_count.
• Gmail API — Thread resource — Our messageCount ≈ messages.length; unreadCount derived from UNREAD labels on Thread messages.

Skills that produce this shape

• granola — op_list_conversations, op_get_conversation
• claude — list_conversations, search_conversations, list_conversations_cli, get_conversation, read_conversation_cli
• mimestream — list_conversations, get_conversation
• imessage — op_list_conversations, op_get_conversation
• gmail — list_conversations, get_conversation
• whatsapp — op_list_conversations, op_get_conversation