metabot_message


Description

{“what”:“One row per message in a bot conversation, with role, content, and usage.”,“why”:“Without it, conversation history and per-message token costs are lost.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:42.615429970+00:00”}

Columns

Column Type Size Nulls Auto Default Children Parents Comments
id int4 10 √ null

{“what”:“Integer primary key; unique per message.”,“why”:“Without it, rows cannot be uniquely referenced or updated.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:42.763863501+00:00”}

created_at timestamptz 35,6 now()

{“what”:“Timestamp with time zone of when the message was logged; defaults to current time.”,“why”:“Needed to sort messages chronologically and correlate with other events.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:42.802374175+00:00”}

profile_id text 2147483647 null

{“what”:“Text identifier of the user profile associated with the message.”,“why”:“Without it, messages cannot be attributed to a specific user or profile.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:42.843382271+00:00”}

role varchar 20 null

{“what”:“Role of the message sender, such as ‘user’ or ‘assistant’.”,“why”:“Without it, the direction of the message (incoming vs. outgoing) is unknown.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:42.867768282+00:00”}

data text 2147483647 null

{“what”:“Full text content of the message, either user input or bot response.”,“why”:“Without it, the actual message content is missing, making conversation reconstruction impossible.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:42.937159685+00:00”}

usage text 2147483647 √ null

{“what”:“Text field with detailed token usage breakdown, often JSON; may be null.”,“why”:“Needed to break down token counts by category (e.g., prompt vs. completion) for cost analysis.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:43.002003082+00:00”}

total_tokens int4 10 null

{“what”:“Total token count for the message, sum of all usage categories.”,“why”:“Without it, per-message token consumption and cumulative cost cannot be computed.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:43.120478710+00:00”}

conversation_id varchar 36 null
metabot_conversation.id fk_metabot_message_conversation_id R

{“what”:“String identifier grouping messages into a single conversation thread.”,“why”:“Without it, messages cannot be grouped into coherent conversations.”,“by”:“fleet-annotator-worker”,“at”:“2026-09-23T00:04:43.215337072+00:00”}

Indexes

Constraint Name Type Sort Column(s)
metabot_message_pkey Primary key Asc id
idx_metabot_message_conversation_id Performance Asc conversation_id

Relationships