TypesCore types

Conversation

A conversation, such as a chat with a person or an assistant. Its messages are the rows of its messages table.

Identifiercore.conversation

Fields

FieldKindDescription
titlestringThe conversation's name.

Settings

SettingValue
pluralConversations
title_fieldtitle
iconlucide:messages-square
merge_policylast_writer_wins for every field

Tables

messages

The messages of the conversation, kept in the order they were sent.

order: sent_at

ColumnKindDescription
authorstring, requiredWho wrote the message, such as a name, a handle or assistant.
textstring, searchableWhat the message says. A message may have no text and only an attachment.
sent_atdatetime, requiredWhen the message was sent.
attachmentitemA picture or other file the message carries. Types: core.file.

A message is a row, never an item, so it has no version, tags or edges of its own. Rows are written with writeTableRows or marfa rows, as Tables explains. A message people read on its own, such as an email, is a core.message item instead.

Example

{
  "type": "core.conversation",
  "properties": {
    "title": "Planning the Lisbon trip"
  }
}

One row of its messages table:

{
  "author": "Ana",
  "text": "Which week works for Lisbon?",
  "sent_at": "2026-04-01T09:12:00Z"
}

On this page