@ai-matrx/chat 0.7.25 → 0.7.27

package/dist/messenger/people/usePeopleMessengerSource.d.ts

@@ -0,0 +1,35 @@
+/**
+ * THE PEOPLE SOURCE — `@ai-matrx/messaging` conversations as a MessengerSource.
+ *
+ * Everything real is messaging's: the inbox (useConversations), the People /
+ * Agents and archive axes (server requests, never client sieves), presence,
+ * mark-read, and the thread body, which is messaging's own `ConversationView`
+ * (`showHeader={false}`, `appearance="messenger"`) — rich content, references,
+ * actions, typing and the composer are never re-implemented here.
+ *
+ * Needs a `<MessagingProvider>` above it (a host mounts one app-wide).
+ * Only this subpath imports `@ai-matrx/messaging`; the build is per-file, so a
+ * chat host that never mounts the messenger loads none of it.
+ */
+import { type ReactNode } from "react";
+import { type ConversationId, type ConversationSummary } from "@ai-matrx/messaging/react";
+import type { MessengerMenuEntry, MessengerProfile, MessengerSource } from "../contract.js";
+export interface PeopleMessengerOptions {
+    /** The list title. Default "Chats". */
+    readonly title?: string;
+    readonly profile?: MessengerProfile;
+    /** The "+" button (the host's new-conversation dialog). */
+    readonly onNewConversation?: () => void;
+    /** Conversation ids the host keeps pinned, in order. With `onTogglePin`, rows get Pin/Unpin. */
+    readonly pinnedConversationIds?: readonly string[];
+    readonly onTogglePin?: (conversationId: string) => void;
+    /**
+     * The thread body. Default: messaging's `ConversationView` with the messenger
+     * appearance. A host that wraps that SAME view in its own chrome (its
+     * right-click menu, its composer field) passes it here — never a second renderer.
+     */
+    readonly renderConversation?: (conversationId: ConversationId) => ReactNode;
+    /** Host-specific options appended to every conversation menu. */
+    readonly conversationMenuExtras?: (summary: ConversationSummary) => readonly MessengerMenuEntry[];
+}
+export declare function usePeopleMessengerSource(options?: PeopleMessengerOptions): MessengerSource;

package/dist/messenger/people/usePeopleMessengerSource.js

@@ -0,0 +1,213 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { Archive, Bot, CheckCheck, Copy, MessageCircle, MessageSquareText, Pin, PinOff, Plus, RefreshCw, Users } from "lucide-react";
+import {
+  ConversationView,
+  asConversationId,
+  useConversations,
+  useMessagingHost,
+  useOnlineUserIds
+} from "@ai-matrx/messaging/react";
+import { MessengerDetails } from "../MessengerDetails.js";
+import { MessengerAvatar } from "../MessengerAvatar.js";
+import { formatMessengerTime } from "./format-time.js";
+const SPACE_ALL = "chats";
+const SPACE_PEOPLE = "people";
+const SPACE_AGENTS = "agents";
+const SPACE_ARCHIVED = "archived";
+function copyText(text) {
+  void globalThis.navigator?.clipboard?.writeText(text).catch(() => void 0);
+}
+function usePeopleMessengerSource(options = {}) {
+  const host = useMessagingHost();
+  const inbox = useConversations();
+  const selfId = host?.identity.userId ?? "";
+  const activeId = inbox.activeConversationId;
+  const online = useOnlineUserIds(activeId);
+  const {
+    title = "Chats",
+    profile,
+    onNewConversation,
+    pinnedConversationIds,
+    onTogglePin,
+    renderConversation,
+    conversationMenuExtras
+  } = options;
+  return useMemo(() => {
+    const pinned = new Set(pinnedConversationIds ?? []);
+    const byId = /* @__PURE__ */ new Map();
+    for (const summary of inbox.conversations) byId.set(summary.conversation.id, summary);
+    const toContact = (s) => {
+      const own = s.lastMessageSenderId !== null && s.lastMessageSenderId === selfId;
+      const content = s.lastMessageContent ?? void 0;
+      return {
+        id: s.conversation.id,
+        name: s.displayName,
+        avatar: s.displayImageUrl ? { kind: "image", src: s.displayImageUrl } : { kind: "monogram" },
+        time: formatMessengerTime(s.lastMessageAt),
+        preview: content !== void 0 && own ? `You: ${content}` : content,
+        unread: s.unreadCount,
+        muted: s.isMuted,
+        pinned: pinned.has(s.conversation.id),
+        searchText: s.participants.map((p) => `${p.displayName} ${p.email ?? ""}`).join(" ")
+      };
+    };
+    const all = inbox.conversations.map(toContact);
+    const pinOrder = [...pinned];
+    const contacts = [
+      ...all.filter((c) => c.pinned).sort((a, b) => pinOrder.indexOf(a.id) - pinOrder.indexOf(b.id)),
+      ...all.filter((c) => !c.pinned)
+    ];
+    const markRead = (id) => void host?.engine.markRead(asConversationId(id));
+    const conversationMenu = (contact, includeOpen) => {
+      const summary = byId.get(contact.id);
+      const entries = [];
+      if (includeOpen) {
+        entries.push({ id: "open", label: "Open", icon: MessageSquareText, onSelect: () => inbox.select(asConversationId(contact.id)) });
+      }
+      entries.push({
+        id: "mark-read",
+        label: "Mark as read",
+        icon: CheckCheck,
+        disabled: (contact.unread ?? 0) === 0,
+        onSelect: () => markRead(contact.id)
+      });
+      if (onTogglePin) {
+        entries.push(
+          contact.pinned ? { id: "unpin", label: "Unpin", icon: PinOff, onSelect: () => onTogglePin(contact.id) } : { id: "pin", label: "Pin", icon: Pin, onSelect: () => onTogglePin(contact.id) }
+        );
+      }
+      entries.push({ id: "copy-name", label: "Copy name", icon: Copy, onSelect: () => copyText(contact.name) });
+      const extras = summary && conversationMenuExtras ? conversationMenuExtras(summary) : [];
+      if (extras.length > 0) entries.push({ id: "extras", separator: true }, ...extras);
+      return entries;
+    };
+    const kindUnread = inbox.kindUnread;
+    const spaces = [
+      { id: SPACE_ALL, label: "Chats", icon: MessageCircle, count: kindUnread ? kindUnread.people + kindUnread.agents : void 0 },
+      { id: SPACE_PEOPLE, label: "People", icon: Users, count: kindUnread?.people },
+      { id: SPACE_AGENTS, label: "Agents", icon: Bot, count: kindUnread?.agents }
+    ];
+    const archived = {
+      id: SPACE_ARCHIVED,
+      label: "Archived",
+      icon: Archive,
+      count: inbox.archivedCount?.count
+    };
+    const activeSpaceId = inbox.archiveFilter === "archived" ? SPACE_ARCHIVED : inbox.kindFilter === "people" ? SPACE_PEOPLE : inbox.kindFilter === "agents" ? SPACE_AGENTS : SPACE_ALL;
+    const selectSpace = (id) => {
+      if (id === SPACE_ARCHIVED) {
+        inbox.setArchiveFilter("archived");
+        return;
+      }
+      if (inbox.archiveFilter !== "active") inbox.setArchiveFilter("active");
+      inbox.setKindFilter(id === SPACE_PEOPLE ? "people" : id === SPACE_AGENTS ? "agents" : "all");
+    };
+    const refresh = () => inbox.retry();
+    const filters = [
+      { id: "unread", label: "Unread", test: (c) => (c.unread ?? 0) > 0 },
+      { id: "groups", label: "Groups", test: (c) => byId.get(c.id)?.conversation.type === "group" }
+    ];
+    if (onTogglePin) filters.push({ id: "pinned", label: "Pinned", test: (c) => c.pinned === true });
+    const headerSubtitle = (summary) => {
+      if (!summary) return void 0;
+      const others = summary.participants.filter((p) => p.userId !== selfId);
+      if (summary.conversation.type === "group") return others.map((p) => p.displayName).join(", ") || void 0;
+      return others.some((p) => online.has(p.userId)) ? "online" : void 0;
+    };
+    return {
+      title,
+      rail: [...spaces, { id: "more", label: "More", spaces: [archived] }],
+      activeSpaceId,
+      onSelectSpace: selectSpace,
+      spaceMenu: (space) => [
+        { id: "open", label: `Show ${space.label}`, icon: space.icon, onSelect: () => selectSpace(space.id) },
+        { id: "refresh", label: "Refresh", icon: RefreshCw, onSelect: refresh }
+      ],
+      profile,
+      contacts,
+      listState: {
+        loading: inbox.isInitialLoading,
+        error: inbox.loadError,
+        retry: inbox.retry,
+        hasMore: inbox.hasMore,
+        loadMore: inbox.loadMore,
+        emptyLabel: activeSpaceId === SPACE_ARCHIVED ? "No archived chats" : "No chats yet"
+      },
+      filters,
+      activeContactId: activeId,
+      onSelectContact: (id) => inbox.select(asConversationId(id)),
+      contactMenu: (contact) => conversationMenu(contact, true),
+      listMenu: () => {
+        const entries = [];
+        if (onNewConversation) entries.push({ id: "new", label: "New chat", icon: Plus, onSelect: onNewConversation });
+        entries.push(
+          activeSpaceId === SPACE_ARCHIVED ? { id: "unarchived", label: "Back to chats", icon: MessageCircle, onSelect: () => selectSpace(SPACE_ALL) } : { id: "archived", label: "Archived chats", icon: Archive, onSelect: () => selectSpace(SPACE_ARCHIVED) },
+          { id: "refresh", label: "Refresh", icon: RefreshCw, onSelect: refresh }
+        );
+        return entries;
+      },
+      onNew: onNewConversation,
+      newLabel: "New chat",
+      header: (contact) => ({
+        title: contact.name,
+        subtitle: headerSubtitle(byId.get(contact.id)),
+        avatar: contact.avatar
+      }),
+      headerMenu: (contact) => conversationMenu(contact, false),
+      renderThread: (contact) => {
+        const id = asConversationId(contact.id);
+        return renderConversation ? renderConversation(id) : /* @__PURE__ */ jsx(ConversationView, { conversationId: id, showHeader: false, appearance: "messenger", className: "min-h-0 flex-1" });
+      },
+      renderDetails: (contact) => {
+        const summary = byId.get(contact.id);
+        const members = summary?.participants ?? [];
+        return /* @__PURE__ */ jsx(
+          MessengerDetails,
+          {
+            name: contact.name,
+            avatar: contact.avatar,
+            subtitle: summary?.conversation.type === "group" ? `${members.length} members` : headerSubtitle(summary),
+            tabs: [
+              {
+                id: "members",
+                label: "Members",
+                content: /* @__PURE__ */ jsx("ul", { className: "flex flex-col", children: members.map((member) => /* @__PURE__ */ jsxs("li", { className: "flex min-w-0 items-center gap-3 rounded-lg px-2 py-2", children: [
+                  /* @__PURE__ */ jsx(
+                    MessengerAvatar,
+                    {
+                      name: member.displayName,
+                      avatar: member.avatarUrl ? { kind: "image", src: member.avatarUrl } : { kind: "monogram" },
+                      size: "header"
+                    }
+                  ),
+                  /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [
+                    /* @__PURE__ */ jsx("span", { className: "truncate text-[14px] text-foreground", children: member.userId === selfId ? `${member.displayName} (You)` : member.displayName }),
+                    member.email ? /* @__PURE__ */ jsx("span", { className: "truncate text-[12px] text-muted-foreground", children: member.email }) : null
+                  ] })
+                ] }, member.userId)) })
+              }
+            ]
+          }
+        );
+      }
+    };
+  }, [
+    host,
+    inbox,
+    selfId,
+    activeId,
+    online,
+    title,
+    profile,
+    onNewConversation,
+    pinnedConversationIds,
+    onTogglePin,
+    renderConversation,
+    conversationMenuExtras
+  ]);
+}
+export {
+  usePeopleMessengerSource
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.25",
+  "version": "0.7.27",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as explicit per-module subpaths @ai-matrx/chat/<domain>/<module> (no wildcards: scripts/public-modules.json) over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -3260,6 +3260,31 @@
       "import": "./dist/mandates/useStartMandateWorkflow.js",
       "default": "./dist/mandates/useStartMandateWorkflow.js"
     },
+    "./messenger/MessengerAvatar": {
+      "types": "./dist/messenger/MessengerAvatar.d.ts",
+      "import": "./dist/messenger/MessengerAvatar.js",
+      "default": "./dist/messenger/MessengerAvatar.js"
+    },
+    "./messenger/MessengerDetails": {
+      "types": "./dist/messenger/MessengerDetails.d.ts",
+      "import": "./dist/messenger/MessengerDetails.js",
+      "default": "./dist/messenger/MessengerDetails.js"
+    },
+    "./messenger/MessengerShell": {
+      "types": "./dist/messenger/MessengerShell.d.ts",
+      "import": "./dist/messenger/MessengerShell.js",
+      "default": "./dist/messenger/MessengerShell.js"
+    },
+    "./messenger/contract": {
+      "types": "./dist/messenger/contract.d.ts",
+      "import": "./dist/messenger/contract.js",
+      "default": "./dist/messenger/contract.js"
+    },
+    "./messenger/people/usePeopleMessengerSource": {
+      "types": "./dist/messenger/people/usePeopleMessengerSource.d.ts",
+      "import": "./dist/messenger/people/usePeopleMessengerSource.js",
+      "default": "./dist/messenger/people/usePeopleMessengerSource.js"
+    },
     "./next/navigation": {
       "types": "./dist/next/navigation.d.ts",
       "import": "./dist/next/navigation.js",
@@ -4681,25 +4706,26 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
-    "@ai-matrx/agents": "latest",
     "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/canvas": "latest",
-    "@ai-matrx/design-system": "latest",
-    "@ai-matrx/diff": "latest",
+    "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
+    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
-    "@ai-matrx/media": "latest",
-    "@ai-matrx/realtime": "latest",
+    "@ai-matrx/diff": "latest",
+    "@ai-matrx/messaging": "latest",
     "@ai-matrx/print": "latest",
+    "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/rich-editor": "latest",
     "@ai-matrx/rich-content": "latest",
-    "@ai-matrx/icons": "latest",
-    "@ai-matrx/content-ir-react": "latest"
+    "@ai-matrx/rich-editor": "latest",
+    "@ai-matrx/media": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -4818,5 +4844,5 @@
     "check:side-effects": "node ../scripts/check-side-effects-listed.mjs . && node ../scripts/check-side-effects-listed.mjs --self-test",
     "check:public-surface": "node ./scripts/sync-public-surface.mjs --check && node ./scripts/sync-public-surface.mjs --self-test"
   },
-  "gitHead": "e79576768f5d315f1b8413c353e3f7dc3ee1438c"
+  "gitHead": "da1cefa8706b65633e000a46c417e22d410d499f"
 }