@ai-matrx/messaging 0.15.0 → 0.15.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog — `@ai-matrx/messaging`
 
+## 0.15.1
+### Unreleased
+
+### Added
+
+- `AiCallArgs.context` (`ConversationAiContext`) and
+  `conversationContextVariables()`: the four conversation intelligences now send
+  the `messaging.conversation` offered values by name — `conversation_type`,
+  `conversation_name`, `conversation_created_at`, `unread_count`, `is_muted`,
+  `reader_user_id`, and always `total_loaded_message_count` — beside the
+  existing variables, which are unchanged. `useMessagingAi` fills the context
+  from the inbox row and the host identity. Absent facts are omitted.
+
+### Consumer action
+
+- None — optional field. A host calling `createMessagingAi` directly may pass
+  `context` to supply the same facts.
+
 ## 0.15.0
 
 ### Fixed

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(src_exports, {
   asOrganizationId: () => asOrganizationId,
   asUserId: () => asUserId,
   composeFence: () => composeFence,
+  conversationContextVariables: () => conversationContextVariables,
   conversationTopic: () => conversationTopic,
   createActionRegistry: () => createActionRegistry,
   createMemoryOutboxStorage: () => createMemoryOutboxStorage,
@@ -395,6 +396,20 @@ ${JSON.stringify(references, null, 2)}
 }
 
 // src/core/ai.ts
+function conversationContextVariables(context, loadedMessageCount) {
+  const values = {
+    total_loaded_message_count: loadedMessageCount
+  };
+  if (context === void 0) return values;
+  if (context.conversationType) values.conversation_type = context.conversationType;
+  if (context.conversationName) values.conversation_name = context.conversationName;
+  if (context.conversationCreatedAt)
+    values.conversation_created_at = context.conversationCreatedAt;
+  if (typeof context.unreadCount === "number") values.unread_count = context.unreadCount;
+  if (typeof context.isMuted === "boolean") values.is_muted = context.isMuted;
+  if (context.readerUserId) values.reader_user_id = context.readerUserId;
+  return values;
+}
 function unreadCutoff(messages, unreadCount) {
   if (unreadCount <= 0) return null;
   const index = messages.length - unreadCount - 1;
@@ -484,7 +499,8 @@ function createMessagingAi(options) {
       transcript_message_count: transcript.length,
       // Honest about the cut, so an agent can say "showing the last 200".
       transcript_truncated: args.messages.length > transcript.length,
-      ...args.since != null ? { unread_since: args.since } : {}
+      ...args.since != null ? { unread_since: args.since } : {},
+      ...conversationContextVariables(args.context, args.messages.length)
     };
   }
   function configured(capability) {