@ai-matrx/messaging 0.14.0 → 0.15.1

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # 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
+
+- **A failed inbox read is never a skeleton forever, and never "empty"** (RC-B12
+  round 11). When the first conversation-list read failed,
+  `hasLoadedConversations` stayed false and the list showed its skeleton for as
+  long as it was open. The store now carries `conversationsLoadError`; the list
+  resolves to "Couldn't load your conversations" with a **Try again**
+  (`useConversations().retry`, `engine.refreshInbox()`), and "No conversations
+  yet" only follows a read that succeeded.
+- **Read failures render through the design-system error slot.** "Couldn't load
+  this conversation" and the inbox failure are drawn with `ErrorBox` from
+  `@ai-matrx/design-system` (new dependency), so the host fills them with its
+  error actions — in AI Matrx, the Alchemy Menu. They were `EmptyState`s before,
+  in the same grey as "No messages yet".
+
+### Added
+
+- `MessagingSnapshot.conversationsLoadError`, `MessagingStore.setConversationsLoadError`,
+  `MessagingEngine.refreshInbox()`, `useConversations().loadError` / `.retry`.
+
+## 0.14.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/messaging/v0.14.0..npm/messaging/v0.14.1 -- apps/shared/messaging`).
+No source changes intended and no consumer action required.
+
 ## 0.14.0
 
 ### Changed
@@ -811,3 +857,4 @@ consumer):
   sign-in reports `session-unavailable` instead of recovering.
 - This package supersedes host code that talks to `communication.dm_*` directly. Anything still
   reading those tables outside the package should be moved onto it or deleted.
+

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) {
@@ -1045,6 +1061,7 @@ function createMessagingStore() {
   let threads = /* @__PURE__ */ new Map();
   let activeConversationId = null;
   let conversationReadFailures = /* @__PURE__ */ new Map();
+  let conversationsLoadError = null;
   const listeners = /* @__PURE__ */ new Set();
   let cached = null;
   function snapshot() {
@@ -1058,7 +1075,8 @@ function createMessagingStore() {
       totalUnreadConversations: conversations.filter((item) => item.unreadCount > 0).length,
       archiveFilter,
       archivedCount,
-      conversationReadFailures
+      conversationReadFailures,
+      conversationsLoadError
     };
     return cached;
   }
@@ -1103,6 +1121,12 @@ function createMessagingStore() {
       conversations = normalizeConversations(items);
       hasMoreConversations = hasMore;
       hasLoadedConversations = true;
+      conversationsLoadError = null;
+      emit();
+    },
+    setConversationsLoadError(message) {
+      if (message === conversationsLoadError) return;
+      conversationsLoadError = message;
       emit();
     },
     setArchiveFilter(next) {
@@ -1335,10 +1359,20 @@ function createMessagingEngine(options) {
   }
   async function reloadInbox() {
     if (disposed) return;
-    const page = await repository.listConversations({
-      limit: conversationPageSize,
-      archived: store.snapshot().archiveFilter
-    });
+    let page;
+    try {
+      page = await repository.listConversations({
+        limit: conversationPageSize,
+        archived: store.snapshot().archiveFilter
+      });
+    } catch (error) {
+      if (!disposed) {
+        store.setConversationsLoadError(
+          error instanceof Error ? error.message : typeof error === "string" ? error : "The conversation list could not be read."
+        );
+      }
+      throw error;
+    }
     if (disposed) return;
     conversationCursor = page.nextCursor;
     store.setConversations(page.items, page.hasMore);
@@ -1423,6 +1457,13 @@ function createMessagingEngine(options) {
         }
       });
     },
+    async refreshInbox() {
+      try {
+        await reloadInbox();
+      } catch (error) {
+        reportError(error, "inboxRefresh");
+      }
+    },
     async setArchiveFilter(next) {
       if (next === store.snapshot().archiveFilter) return;
       store.setArchiveFilter(next);