@ai-matrx/messaging 0.14.0 → 0.15.1

package/dist/react.cjs

@@ -75,6 +75,7 @@ __export(react_exports, {
   asOrganizationId: () => asOrganizationId,
   asUserId: () => asUserId,
   composeFence: () => composeFence,
+  conversationContextVariables: () => conversationContextVariables,
   conversationTopic: () => conversationTopic,
   createActionRegistry: () => createActionRegistry,
   createMemoryOutboxStorage: () => createMemoryOutboxStorage,
@@ -379,6 +380,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;
@@ -468,7 +483,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) {
@@ -983,6 +999,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() {
@@ -996,7 +1013,8 @@ function createMessagingStore() {
       totalUnreadConversations: conversations.filter((item) => item.unreadCount > 0).length,
       archiveFilter,
       archivedCount,
-      conversationReadFailures
+      conversationReadFailures,
+      conversationsLoadError
     };
     return cached;
   }
@@ -1041,6 +1059,12 @@ function createMessagingStore() {
       conversations = normalizeConversations(items);
       hasMoreConversations = hasMore;
       hasLoadedConversations = true;
+      conversationsLoadError = null;
+      emit();
+    },
+    setConversationsLoadError(message) {
+      if (message === conversationsLoadError) return;
+      conversationsLoadError = message;
       emit();
     },
     setArchiveFilter(next) {
@@ -1273,10 +1297,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);
@@ -1361,6 +1395,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);
@@ -2504,7 +2545,11 @@ function useConversations() {
     hasMore: snapshot?.hasMoreConversations ?? false,
     // "Not loaded yet" is a FACT from the store, never a guess. Showing
     // "No conversations yet" before the first read is a screen telling a lie.
-    isInitialLoading: snapshot === null || !snapshot.hasLoadedConversations,
+    isInitialLoading: snapshot === null || !snapshot.hasLoadedConversations && snapshot.conversationsLoadError === null,
+    loadError: snapshot?.conversationsLoadError ?? null,
+    retry: () => {
+      void host?.engine.refreshInbox();
+    },
     totalUnreadConversations: snapshot?.totalUnreadConversations ?? 0,
     loadMore: () => {
       void host?.engine.loadMoreConversations();
@@ -2709,6 +2754,14 @@ function useMessagingAi(conversationId) {
         conversationId,
         messages: conversation.messages,
         participants: conversation.participants,
+        context: {
+          conversationType: conversation.summary?.conversation.type,
+          conversationName: conversation.summary?.displayName,
+          conversationCreatedAt: conversation.summary?.conversation.createdAt,
+          unreadCount: conversation.summary?.unreadCount,
+          isMuted: conversation.summary?.isMuted,
+          readerUserId: host?.identity.userId || void 0
+        },
         signal: controller.signal,
         // Live progress. Aborted runs stop painting immediately — a cancelled
         // answer must not keep growing on screen.
@@ -3086,6 +3139,7 @@ function EmptyState(props) {
 }
 
 // src/react/components.tsx
+var import_design_system = require("@ai-matrx/design-system");
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var AI_LABELS = {
   catchUp: "Catch me up",
@@ -3103,7 +3157,9 @@ function ConversationList(props) {
     activeConversationId,
     archiveFilter,
     setArchiveFilter,
-    archivedCount
+    archivedCount,
+    loadError,
+    retry
   } = useConversations();
   const RowChrome = useMessagingHost()?.wrapConversationRow ?? null;
   const [query, setQuery] = (0, import_react5.useState)("");
@@ -3168,7 +3224,20 @@ function ConversationList(props) {
       }
     ) }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "mx-msg__scroll", children: [
-      isInitialLoading ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ConversationSkeleton, {}) : visible.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      isInitialLoading ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ConversationSkeleton, {}) : loadError !== null && visible.length === 0 ? (
+        // A failed read resolves to the failure — never a skeleton forever,
+        // never "No conversations yet" (RC-B12 round 11). ErrorBox is the
+        // design-system error slot: the host fills it with its menu.
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          ReadFailureBox,
+          {
+            title: "Couldn't load your conversations",
+            message: loadError,
+            operation: "List your conversations",
+            onRetry: retry
+          }
+        )
+      ) : visible.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         EmptyState,
         {
           title: query.length > 0 ? "No matches" : showingArchive ? "No archived conversations" : "No conversations yet",
@@ -3345,10 +3414,11 @@ function ConversationView(props) {
         body: "It doesn't exist, or you aren't a member of it."
       }
     ) : conversation.error !== null && messages.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-      EmptyState,
+      ReadFailureBox,
       {
         title: "Couldn't load this conversation",
-        body: "Check your connection, then open it again."
+        message: conversation.error.message || "Check your connection, then open it again.",
+        operation: "Open this conversation"
       }
     ) : messages.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(EmptyState, { title: "No messages yet", body: "Say something to get started." }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "mx-msg__messages", children: [
       conversation.hasMoreOlder ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
@@ -3679,4 +3749,27 @@ function MessagingInbox(props) {
     }
   );
 }
+function ReadFailureBox({
+  title,
+  message,
+  operation,
+  onRetry
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "mx-msg__empty", role: "alert", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      import_design_system.ErrorBox,
+      {
+        as: "div",
+        title,
+        message,
+        operation,
+        origin: "messaging",
+        style: { color: "var(--mx-msg-danger)", fontWeight: 600 },
+        children: title
+      }
+    ),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { children: message }),
+    onRetry ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("button", { type: "button", className: "mx-msg__button mx-msg__button--ghost", onClick: onRetry, children: "Try again" }) : null
+  ] });
+}
 //# sourceMappingURL=react.cjs.map