@happyvertical/smrt-messages 0.55.12 → 0.55.13

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-messages",
-  "packageVersion": "0.55.12",
+  "packageVersion": "0.55.13",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "b4f4c803c935b1eb9c2318b164d63ac1ac0b1e29b9471291aaf297d64af90ef1",
-    "packageJson": "c0478381af6eb0fe9e8257736359f70085d83cfe517baf6fc73898576a063f71",
+    "manifest": "4888deafbc8f5994604a93ec5a29477d93aa8b0a851b9a8823b551372305ced6",
+    "packageJson": "01a7b2b93313ef30045a19b3e283b7d74cb53348efebf565950fdda6b24524c5",
     "agents": "f2bbd8f6d74a68c2ab949153f2051c7a906bd2e4ba547873b3641d0779491c59"
   },
   "exports": [
@@ -3997,50 +3997,58 @@
           "name": "name",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The display name for this connected messaging account."
         },
         {
           "name": "providerType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The service that connects this account to your application."
         },
         {
           "name": "channelType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The kind of messaging this account supports, such as email or chat."
         },
         {
           "name": "isActive",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": true
+          "default": true,
+          "description": "Whether this account is enabled for messaging."
         },
         {
           "name": "lastSyncAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account last checked for new messages."
         },
         {
           "name": "configuration",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The public connection settings for this account; credentials are stored separately."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was added."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was last changed."
         }
       ],
       "relationships": [],
@@ -4786,259 +4794,300 @@
           "type": "foreignKey",
           "required": false,
           "related": "Account",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The connected account used to receive or send this message."
         },
         {
           "name": "personaId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-personas:AgentPersona",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The assistant identity associated with this message, when one was used."
         },
         {
           "name": "endpointId",
           "type": "foreignKey",
           "required": false,
           "related": "MessagingEndpoint",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The saved destination used to deliver this message."
         },
         {
           "name": "correlationId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A tracking reference that connects this message to related activity."
         },
         {
           "name": "threadId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The conversation this message belongs to."
         },
         {
           "name": "subject",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The subject shown in the message list."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The message content in plain text."
         },
         {
           "name": "fromAddress",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The address the message was sent from."
         },
         {
           "name": "fromName",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The sender name shown beside their address."
         },
         {
           "name": "toAddresses",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The people or addresses receiving this message."
         },
         {
           "name": "date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the message was sent or received."
         },
         {
           "name": "isRead",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this message has been marked as read."
         },
         {
           "name": "isFlagged",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this message is flagged for follow-up."
         },
         {
           "name": "hasAttachments",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether files are attached to this message."
         },
         {
           "name": "size",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "The size of the message in bytes."
         },
         {
           "name": "metadata",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Additional details supplied by the messaging connection."
         },
         {
           "name": "sendStatus",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "The latest sending state: draft, sending, sent, or failed. Received mail may also show draft here."
         },
         {
           "name": "sentAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the message was successfully sent."
         },
         {
           "name": "sendError",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The reason the latest send attempt failed."
         },
         {
           "name": "retryCount",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How many times delivery has been retried."
         },
         {
           "name": "maxRetries",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 3
+          "default": 3,
+          "description": "The maximum number of delivery retries allowed."
         },
         {
           "name": "scheduledSendAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message is scheduled to be sent."
         },
         {
           "name": "inReplyToMessageId",
           "type": "foreignKey",
           "required": false,
           "related": "Message",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The earlier message this one replies to."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message was recorded."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message was last changed."
         },
         {
           "name": "messageId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The email reference assigned by the sender for tracking replies."
         },
         {
           "name": "inReplyTo",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The sender-assigned reference of the email being replied to."
         },
         {
           "name": "ccAddresses",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Recipients receiving a visible copy of this email."
         },
         {
           "name": "bccAddresses",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Recipients receiving a copy without appearing in the visible recipient list."
         },
         {
           "name": "replyToAddress",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The address replies should be sent to."
         },
         {
           "name": "replyToName",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The name associated with the reply address."
         },
         {
           "name": "textBody",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The plain-text version of the email."
         },
         {
           "name": "htmlBody",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The formatted version of the email."
         },
         {
           "name": "folderId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The mailbox folder reference supplied by the email connection."
         },
         {
           "name": "folderPath",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The location of this email within the mailbox folders."
         },
         {
           "name": "labels",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Labels applied to this email by the mailbox provider."
         },
         {
           "name": "flags",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Mailbox markers such as read, answered, or flagged."
         },
         {
           "name": "isAnswered",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this email has been replied to."
         },
         {
           "name": "isDraft",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this email is saved as an unfinished draft."
         },
         {
           "name": "rawMessage",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The original email content as received from the mail server."
         },
         {
           "name": "headers",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Delivery and routing details included with the email."
         }
       ],
       "relationships": [
@@ -5743,63 +5792,73 @@
           "name": "name",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The display name for this connected messaging account."
         },
         {
           "name": "providerType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The service that connects this account to your application."
         },
         {
           "name": "channelType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The kind of messaging this account supports, such as email or chat."
         },
         {
           "name": "isActive",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": true
+          "default": true,
+          "description": "Whether this account is enabled for messaging."
         },
         {
           "name": "lastSyncAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account last checked for new messages."
         },
         {
           "name": "configuration",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The public connection settings for this account; credentials are stored separately."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was added."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was last changed."
         },
         {
           "name": "email",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The email address associated with this mailbox."
         },
         {
           "name": "syncIntervalMinutes",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 60
+          "default": 60,
+          "description": "The time in minutes between scheduled mailbox checks."
         }
       ],
       "relationships": [],
@@ -6903,161 +6962,186 @@
           "type": "foreignKey",
           "required": false,
           "related": "Account",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The connected account used to receive or send this message."
         },
         {
           "name": "personaId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-personas:AgentPersona",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The assistant identity associated with this message, when one was used."
         },
         {
           "name": "endpointId",
           "type": "foreignKey",
           "required": false,
           "related": "MessagingEndpoint",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The saved destination used to deliver this message."
         },
         {
           "name": "correlationId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A tracking reference that connects this message to related activity."
         },
         {
           "name": "threadId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The conversation this message belongs to."
         },
         {
           "name": "subject",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The subject shown in the message list."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The message content in plain text."
         },
         {
           "name": "fromAddress",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The address the message was sent from."
         },
         {
           "name": "fromName",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The sender name shown beside their address."
         },
         {
           "name": "toAddresses",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The people or addresses receiving this message."
         },
         {
           "name": "date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the message was sent or received."
         },
         {
           "name": "isRead",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this message has been marked as read."
         },
         {
           "name": "isFlagged",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this message is flagged for follow-up."
         },
         {
           "name": "hasAttachments",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether files are attached to this message."
         },
         {
           "name": "size",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "The size of the message in bytes."
         },
         {
           "name": "metadata",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Additional details supplied by the messaging connection."
         },
         {
           "name": "sendStatus",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "The latest sending state: draft, sending, sent, or failed. Received mail may also show draft here."
         },
         {
           "name": "sentAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the message was successfully sent."
         },
         {
           "name": "sendError",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The reason the latest send attempt failed."
         },
         {
           "name": "retryCount",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How many times delivery has been retried."
         },
         {
           "name": "maxRetries",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 3
+          "default": 3,
+          "description": "The maximum number of delivery retries allowed."
         },
         {
           "name": "scheduledSendAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message is scheduled to be sent."
         },
         {
           "name": "inReplyToMessageId",
           "type": "foreignKey",
           "required": false,
           "related": "Message",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The earlier message this one replies to."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message was recorded."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message was last changed."
         }
       ],
       "relationships": [
@@ -7868,50 +7952,58 @@
           "name": "name",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The display name for this connected messaging account."
         },
         {
           "name": "providerType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The service that connects this account to your application."
         },
         {
           "name": "channelType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The kind of messaging this account supports, such as email or chat."
         },
         {
           "name": "isActive",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": true
+          "default": true,
+          "description": "Whether this account is enabled for messaging."
         },
         {
           "name": "lastSyncAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account last checked for new messages."
         },
         {
           "name": "configuration",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The public connection settings for this account; credentials are stored separately."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was added."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was last changed."
         },
         {
           "name": "workspaceId",
@@ -8142,161 +8234,186 @@
           "type": "foreignKey",
           "required": false,
           "related": "Account",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The connected account used to receive or send this message."
         },
         {
           "name": "personaId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-personas:AgentPersona",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The assistant identity associated with this message, when one was used."
         },
         {
           "name": "endpointId",
           "type": "foreignKey",
           "required": false,
           "related": "MessagingEndpoint",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The saved destination used to deliver this message."
         },
         {
           "name": "correlationId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A tracking reference that connects this message to related activity."
         },
         {
           "name": "threadId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The conversation this message belongs to."
         },
         {
           "name": "subject",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The subject shown in the message list."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The message content in plain text."
         },
         {
           "name": "fromAddress",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The address the message was sent from."
         },
         {
           "name": "fromName",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The sender name shown beside their address."
         },
         {
           "name": "toAddresses",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The people or addresses receiving this message."
         },
         {
           "name": "date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the message was sent or received."
         },
         {
           "name": "isRead",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this message has been marked as read."
         },
         {
           "name": "isFlagged",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this message is flagged for follow-up."
         },
         {
           "name": "hasAttachments",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether files are attached to this message."
         },
         {
           "name": "size",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "The size of the message in bytes."
         },
         {
           "name": "metadata",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Additional details supplied by the messaging connection."
         },
         {
           "name": "sendStatus",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "The latest sending state: draft, sending, sent, or failed. Received mail may also show draft here."
         },
         {
           "name": "sentAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the message was successfully sent."
         },
         {
           "name": "sendError",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The reason the latest send attempt failed."
         },
         {
           "name": "retryCount",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How many times delivery has been retried."
         },
         {
           "name": "maxRetries",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 3
+          "default": 3,
+          "description": "The maximum number of delivery retries allowed."
         },
         {
           "name": "scheduledSendAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message is scheduled to be sent."
         },
         {
           "name": "inReplyToMessageId",
           "type": "foreignKey",
           "required": false,
           "related": "Message",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The earlier message this one replies to."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message was recorded."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message was last changed."
         },
         {
           "name": "channelId",
@@ -8897,50 +9014,58 @@
           "name": "name",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The display name for this connected messaging account."
         },
         {
           "name": "providerType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The service that connects this account to your application."
         },
         {
           "name": "channelType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The kind of messaging this account supports, such as email or chat."
         },
         {
           "name": "isActive",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": true
+          "default": true,
+          "description": "Whether this account is enabled for messaging."
         },
         {
           "name": "lastSyncAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account last checked for new messages."
         },
         {
           "name": "configuration",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The public connection settings for this account; credentials are stored separately."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was added."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was last changed."
         }
       ],
       "relationships": [],
@@ -9153,161 +9278,186 @@
           "type": "foreignKey",
           "required": false,
           "related": "Account",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The connected account used to receive or send this message."
         },
         {
           "name": "personaId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-personas:AgentPersona",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The assistant identity associated with this message, when one was used."
         },
         {
           "name": "endpointId",
           "type": "foreignKey",
           "required": false,
           "related": "MessagingEndpoint",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The saved destination used to deliver this message."
         },
         {
           "name": "correlationId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A tracking reference that connects this message to related activity."
         },
         {
           "name": "threadId",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The conversation this message belongs to."
         },
         {
           "name": "subject",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The subject shown in the message list."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The message content in plain text."
         },
         {
           "name": "fromAddress",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The address the message was sent from."
         },
         {
           "name": "fromName",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The sender name shown beside their address."
         },
         {
           "name": "toAddresses",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The people or addresses receiving this message."
         },
         {
           "name": "date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the message was sent or received."
         },
         {
           "name": "isRead",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this message has been marked as read."
         },
         {
           "name": "isFlagged",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether this message is flagged for follow-up."
         },
         {
           "name": "hasAttachments",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether files are attached to this message."
         },
         {
           "name": "size",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "The size of the message in bytes."
         },
         {
           "name": "metadata",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Additional details supplied by the messaging connection."
         },
         {
           "name": "sendStatus",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "The latest sending state: draft, sending, sent, or failed. Received mail may also show draft here."
         },
         {
           "name": "sentAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the message was successfully sent."
         },
         {
           "name": "sendError",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The reason the latest send attempt failed."
         },
         {
           "name": "retryCount",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How many times delivery has been retried."
         },
         {
           "name": "maxRetries",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 3
+          "default": 3,
+          "description": "The maximum number of delivery retries allowed."
         },
         {
           "name": "scheduledSendAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message is scheduled to be sent."
         },
         {
           "name": "inReplyToMessageId",
           "type": "foreignKey",
           "required": false,
           "related": "Message",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The earlier message this one replies to."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message was recorded."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this message was last changed."
         },
         {
           "name": "tweetId",
@@ -9918,50 +10068,58 @@
           "name": "name",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The display name for this connected messaging account."
         },
         {
           "name": "providerType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The service that connects this account to your application."
         },
         {
           "name": "channelType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The kind of messaging this account supports, such as email or chat."
         },
         {
           "name": "isActive",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": true
+          "default": true,
+          "description": "Whether this account is enabled for messaging."
         },
         {
           "name": "lastSyncAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account last checked for new messages."
         },
         {
           "name": "configuration",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The public connection settings for this account; credentials are stored separately."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was added."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was last changed."
         },
         {
           "name": "handle",
@@ -10488,50 +10646,58 @@
           "name": "name",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The display name for this connected messaging account."
         },
         {
           "name": "providerType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The service that connects this account to your application."
         },
         {
           "name": "channelType",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The kind of messaging this account supports, such as email or chat."
         },
         {
           "name": "isActive",
           "type": "boolean",
           "required": true,
           "columnType": "BOOLEAN",
-          "default": true
+          "default": true,
+          "description": "Whether this account is enabled for messaging."
         },
         {
           "name": "lastSyncAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account last checked for new messages."
         },
         {
           "name": "configuration",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The public connection settings for this account; credentials are stored separately."
         },
         {
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was added."
         },
         {
           "name": "updatedAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this account was last changed."
         }
       ],
       "relationships": [],
@@ -15209,6 +15375,28 @@
         "icon": "folder",
         "description": "Read email and keep up with updates addressed to you."
       },
+      "options": {
+        "@happyvertical/smrt-messages:Email": {
+          "fields": {
+            "created_at": {
+              "help": "When this email was first recorded."
+            },
+            "updated_at": {
+              "help": "When this email record was last changed."
+            }
+          }
+        },
+        "@happyvertical/smrt-messages:EmailAccount": {
+          "fields": {
+            "created_at": {
+              "help": "When this mailbox connection was first recorded."
+            },
+            "updated_at": {
+              "help": "When this mailbox connection was last changed."
+            }
+          }
+        }
+      },
       "help": {
         "markdown": "## Your mailbox\nRead messages, open a conversation, or compose an email using a connected account.\nChoose the sender account, add recipients, and check the subject and message before sending.\n\n## Failed sends\nUse Failed sends to review email whose last send attempt failed. Returning to the mailbox shows all email again.\nCheck the failure and sender connection before retrying through your application. This view does not resend email automatically.\n\n## Preview\nThe playground uses fictional messages. Sending and saving are mocked and never contact a mail server.\n\n## Connect an account\nYour application administrator connects an authorized email provider on the server. Real sending and mailbox synchronization require that connection; a preview does not verify delivery.\n",
         "fieldRefs": []