message

A single message in a conversation. Base type — email extends this via also. Querying by “message” returns emails alongside iMessages, WhatsApp messages, Claude transcripts, etc.

Metadata	Value
Plural	`messages`
Subtitle field	`from`
Identity	`platform`, `id`

Fields

Field	Type
`isOutgoing`	`boolean`
`isStarred`	`boolean`

Relations

Relation	Target
`platform`	`product`
`from`	`actor`
`inConversation`	`conversation`
`repliesTo`	`message`
`toolCalls`	`tool_call[]`

Used as a base by

email

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 Note/Activity — Closest open standard for generic messages. Our from ≈ actor; inConversation ≈ context/conversation; repliesTo ≈ inReplyTo.
Matrix m.room.message — Practical cross-platform message event schema. Our isOutgoing has no Matrix analog (sender identity instead); repliesTo ≈ m.relates_to rel_type m.thread/m.in_reply_to.
XMPP (RFC 6121) message stanza — IETF instant-messaging baseline. from/to/thread correspond to our from/inConversation; no standardized isStarred.

Skills that produce this shape

claude — import_conversation
imessage — op_list_messages, op_search_messages, op_get_message
whatsapp — op_list_messages, op_search_messages, op_get_message