@arbidocs/react 0.5.111 → 0.5.112

package/dist/directmessages/grouping.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/directmessages/grouping.ts"],
+  "sourcesContent": ["/**\n * Thread grouping: the two annotations a readable message list needs.\n *\n * A run is a burst from one sender close together in time; only its last\n * message carries the meta row (sender, time, receipt), so ten rapid messages\n * read as one block instead of ten stamped rows. A day boundary gets a\n * separator so a thread spanning weeks stays navigable.\n *\n * Generic over the message shape because the two consumers hold different ones \u2014\n * the block's `DmMessage` and the ARBI app's decrypted notification rows \u2014 and\n * duplicating this logic is exactly how they drifted apart before.\n */\n\n/** Two messages belong to the same run when same sender and within this gap. */\nexport const RUN_WINDOW_MS = 2 * 60 * 1000\n\nexport interface ThreadItem<T> {\n  message: T\n  /** Last of a same-sender run: render the meta row here. */\n  isLastOfRun: boolean\n  /** First message on its calendar day: render a date separator above it. */\n  isFirstOfDay: boolean\n}\n\nexport interface ThreadAccessors<T> {\n  senderId: (message: T) => string\n  createdAt: (message: T) => string\n}\n\n/**\n * Local calendar day for a timestamp.\n *\n * Deliberately local rather than UTC: a message sent at 23:30 in the reader's\n * zone belongs under that day's separator, not tomorrow's. Falls back to the\n * raw string for an unparseable timestamp so such a message still buckets\n * consistently with itself rather than joining an arbitrary day.\n */\nexport function dayKey(iso: string): string {\n  const d = new Date(iso)\n  if (Number.isNaN(d.getTime())) return iso\n  return `${d.getFullYear()}-${d.getMonth() + 1}-${d.getDate()}`\n}\n\n/** Annotate messages (ascending time order) with run and day boundaries. */\nexport function annotateThread<T>(\n  messages: T[],\n  accessors: ThreadAccessors<T>,\n  runWindowMs: number = RUN_WINDOW_MS\n): ThreadItem<T>[] {\n  const { senderId, createdAt } = accessors\n  return messages.map((message, i) => {\n    const next = messages[i + 1]\n    const prev = messages[i - 1]\n    const day = dayKey(createdAt(message))\n\n    const continuesIntoNext =\n      !!next &&\n      senderId(next) === senderId(message) &&\n      dayKey(createdAt(next)) === day &&\n      Date.parse(createdAt(next)) - Date.parse(createdAt(message)) < runWindowMs\n\n    return {\n      message,\n      isLastOfRun: !continuesIntoNext,\n      isFirstOfDay: !prev || dayKey(createdAt(prev)) !== day,\n    }\n  })\n}\n"],
+  "mappings": "AAcO,MAAM,gBAAgB,IAAI,KAAK;AAuB/B,SAAS,OAAO,KAAqB;AAC1C,QAAM,IAAI,IAAI,KAAK,GAAG;AACtB,MAAI,OAAO,MAAM,EAAE,QAAQ,CAAC,EAAG,QAAO;AACtC,SAAO,GAAG,EAAE,YAAY,CAAC,IAAI,EAAE,SAAS,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;AAC9D;AAGO,SAAS,eACd,UACA,WACA,cAAsB,eACL;AACjB,QAAM,EAAE,UAAU,UAAU,IAAI;AAChC,SAAO,SAAS,IAAI,CAAC,SAAS,MAAM;AAClC,UAAM,OAAO,SAAS,IAAI,CAAC;AAC3B,UAAM,OAAO,SAAS,IAAI,CAAC;AAC3B,UAAM,MAAM,OAAO,UAAU,OAAO,CAAC;AAErC,UAAM,oBACJ,CAAC,CAAC,QACF,SAAS,IAAI,MAAM,SAAS,OAAO,KACnC,OAAO,UAAU,IAAI,CAAC,MAAM,OAC5B,KAAK,MAAM,UAAU,IAAI,CAAC,IAAI,KAAK,MAAM,UAAU,OAAO,CAAC,IAAI;AAEjE,WAAO;AAAA,MACL;AAAA,MACA,aAAa,CAAC;AAAA,MACd,cAAc,CAAC,QAAQ,OAAO,UAAU,IAAI,CAAC,MAAM;AAAA,IACrD;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/directmessages/index.js

@@ -0,0 +1,81 @@
+import { ConversationList } from "./ConversationList.js";
+import { DmComposer } from "./DmComposer.js";
+import { DmAvatar } from "./DmAvatar.js";
+import {
+  applyAgentDmStatus,
+  applyChatEvent,
+  applyChatMessage,
+  applyChatRead,
+  applyChatUpdated,
+  appendToThread,
+  cachedChat,
+  cachedChats,
+  getOpenChat,
+  myChatId,
+  removeChat,
+  setOpenChat,
+  upsertChat
+} from "./chat-cache.js";
+import {
+  useAddChatMembers,
+  useAgentDmStatus,
+  useChatPost,
+  useChats,
+  useChatSummaries,
+  useChatThread,
+  useChatUnreadTotal,
+  useCreateGroupChat,
+  useDeleteChatMessage,
+  useMarkChatRead,
+  useRemoveChatMember,
+  useRenameChat,
+  useUnreadByPeer
+} from "./useChats.js";
+import { useChatArrivals } from "./arrivals.js";
+import { userDisplayName, userInitials, formatRelativeTime } from "./utils.js";
+import { DateSeparator } from "./DateSeparator.js";
+import {
+  annotateThread,
+  dayKey,
+  RUN_WINDOW_MS
+} from "./grouping.js";
+export {
+  ConversationList,
+  DateSeparator,
+  DmAvatar,
+  DmComposer,
+  RUN_WINDOW_MS,
+  annotateThread,
+  appendToThread,
+  applyAgentDmStatus,
+  applyChatEvent,
+  applyChatMessage,
+  applyChatRead,
+  applyChatUpdated,
+  cachedChat,
+  cachedChats,
+  dayKey,
+  formatRelativeTime,
+  getOpenChat,
+  myChatId,
+  removeChat,
+  setOpenChat,
+  upsertChat,
+  useAddChatMembers,
+  useAgentDmStatus,
+  useChatArrivals,
+  useChatPost,
+  useChatSummaries,
+  useChatThread,
+  useChatUnreadTotal,
+  useChats,
+  useCreateGroupChat,
+  useDeleteChatMessage,
+  useMarkChatRead,
+  useRemoveChatMember,
+  useRenameChat,
+  useUnreadByPeer,
+  userDisplayName,
+  userInitials
+};
+//# sourceMappingURL=index.js.map

package/dist/directmessages/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/directmessages/index.ts"],
+  "sourcesContent": ["/**\n * Direct messages: the one chat cache (direct, group and meeting chats), its hooks, and the\n * presentational parts (conversation rail, composer, avatar). The connected messenger, as a side\n * panel or a messages page, is `ConnectedMessenger` in `@arbidocs/blocks/connect`.\n */\n\nexport { ConversationList, type ConversationListProps } from './ConversationList'\nexport { DmComposer, type DmComposerProps } from './DmComposer'\nexport { DmAvatar, type DmAvatarProps } from './DmAvatar'\n// The one chat cache (direct, group and meeting chats) and its hooks.\nexport {\n  applyAgentDmStatus,\n  applyChatEvent,\n  applyChatMessage,\n  applyChatRead,\n  applyChatUpdated,\n  appendToThread,\n  cachedChat,\n  cachedChats,\n  getOpenChat,\n  myChatId,\n  removeChat,\n  setOpenChat,\n  upsertChat,\n  type AgentDmStatus,\n  type ChatAttachmentFile,\n  type ChatEvent,\n  type ChatMemberKey,\n  type ChatMessageResponse,\n  type ChatResponse,\n  type ChatThreadData,\n  type ChatThreadMessage,\n  type DecryptedChatMessage,\n} from './chat-cache'\nexport {\n  useAddChatMembers,\n  useAgentDmStatus,\n  useChatPost,\n  useChats,\n  useChatSummaries,\n  useChatThread,\n  useChatUnreadTotal,\n  useCreateGroupChat,\n  useDeleteChatMessage,\n  useMarkChatRead,\n  useRemoveChatMember,\n  useRenameChat,\n  useUnreadByPeer,\n  type ChatPost,\n  type ChatSummary,\n} from './useChats'\n// Someone else's message arriving in a chat that is not open (a host's toast).\nexport { useChatArrivals, type ChatArrival } from './arrivals'\nexport type { DmConversation, DmMessage, DmUser, DmClassNames } from './types'\nexport { userDisplayName, userInitials, formatRelativeTime } from './utils'\nexport { DateSeparator, type DateSeparatorProps } from './DateSeparator'\nexport {\n  annotateThread,\n  dayKey,\n  RUN_WINDOW_MS,\n  type ThreadItem,\n  type ThreadAccessors,\n} from './grouping'\n"],
+  "mappings": "AAMA,SAAS,wBAAoD;AAC7D,SAAS,kBAAwC;AACjD,SAAS,gBAAoC;AAE7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAUK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,uBAAyC;AAElD,SAAS,iBAAiB,cAAc,0BAA0B;AAClE,SAAS,qBAA8C;AACvD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;",
+  "names": []
+}

package/dist/directmessages/useChats.js

@@ -0,0 +1,266 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { chats as chatOps } from "@arbidocs/sdk/browser";
+import { useArbi } from "../useArbi.js";
+import { arbiQueryKeys } from "../hooks.js";
+import {
+  appendToThread,
+  deleteChatMessage,
+  dropFromThread,
+  myChatId,
+  removeChat,
+  upsertChat
+} from "./chat-cache.js";
+function useChats(options = {}) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys.chatList(),
+    queryFn: () => arbi.chats.list(),
+    enabled: (options.enabled ?? true) && arbi.isLoggedIn
+  });
+}
+function useAgentDmStatus(agentExtId) {
+  const { data } = useQuery({
+    queryKey: arbiQueryKeys.agentDmStatus(agentExtId ?? ""),
+    // Written by the events only: nothing to fetch.
+    queryFn: () => null,
+    enabled: false,
+    staleTime: Infinity
+  });
+  return agentExtId ? data ?? void 0 : void 0;
+}
+function useChatUnreadTotal() {
+  const { data = [] } = useChats();
+  return useMemo(() => data.reduce((sum, c) => sum + (c.unread_count ?? 0), 0), [data]);
+}
+function useUnreadByPeer() {
+  const arbi = useArbi();
+  const { data = [] } = useChats();
+  const me = myChatId(arbi);
+  return useMemo(() => {
+    const out = /* @__PURE__ */ new Map();
+    for (const c of data) {
+      if (c.kind !== "direct" || !c.unread_count) continue;
+      const peer = c.members.find((m) => m.user.external_id !== me)?.user.external_id ?? me;
+      if (peer) out.set(peer, (out.get(peer) ?? 0) + c.unread_count);
+    }
+    return out;
+  }, [data, me]);
+}
+function useChatSummaries(chats) {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  const [summaries, setSummaries] = useState({});
+  const runId = useRef(0);
+  const key = chats.map(
+    (c) => `${c.external_id}:${c.key_version}:${c.title ?? ""}:${c.last_message?.external_id ?? ""}:${c.last_message?.deleted ? "x" : ""}`
+  ).join("|");
+  useEffect(() => {
+    if (!chats.length || !arbi.isLoggedIn) return;
+    const id = ++runId.current;
+    void (async () => {
+      const next = {};
+      for (const chat of chats) {
+        const title = await arbi.chats.title(chat).catch(() => null);
+        const last = chat.last_message?.deleted ? null : chat.last_message;
+        let preview = null;
+        const open = queryClient.getQueryData(arbiQueryKeys.chatThread(chat.external_id))?.messages.find((m) => m.external_id === last?.external_id);
+        if (open) preview = chatOps.chatMessagePreview(open);
+        else if (last) {
+          preview = await arbi.chats.decrypt(chat, last).then(chatOps.chatMessagePreview).catch(() => chatOps.ENCRYPTED_PREVIEW);
+        }
+        next[chat.external_id] = { title, preview };
+      }
+      if (id === runId.current) setSummaries(next);
+    })();
+  }, [key, arbi]);
+  return summaries;
+}
+function useChatThread(chat) {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  const chatExtId = chat?.external_id ?? "";
+  const chatRef = useRef(chat);
+  chatRef.current = chat;
+  const query = useQuery({
+    queryKey: arbiQueryKeys.chatThread(chatExtId),
+    queryFn: () => arbi.chats.page(chatRef.current),
+    enabled: !!chat && arbi.isLoggedIn,
+    staleTime: Infinity
+  });
+  const [loadingOlder, setLoadingOlder] = useState(false);
+  const loadOlder = useCallback(async () => {
+    const key = arbiQueryKeys.chatThread(chatExtId);
+    const current = queryClient.getQueryData(key);
+    const oldest = current?.messages.find((m) => !m.optimistic);
+    if (!chatRef.current || !current?.hasMore || !oldest) return;
+    setLoadingOlder(true);
+    try {
+      const page = await arbi.chats.page(chatRef.current, { before: oldest.external_id });
+      queryClient.setQueryData(
+        key,
+        (old) => old ? {
+          hasMore: page.hasMore,
+          messages: [
+            ...page.messages.filter(
+              (m) => !old.messages.some((o) => o.external_id === m.external_id)
+            ),
+            ...old.messages
+          ]
+        } : old
+      );
+    } finally {
+      setLoadingOlder(false);
+    }
+  }, [arbi, queryClient, chatExtId]);
+  return {
+    messages: query.data?.messages ?? [],
+    hasMore: query.data?.hasMore ?? false,
+    isLoading: query.isLoading && !!chat,
+    loadOlder,
+    loadingOlder
+  };
+}
+function useChatPost() {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useCallback(
+    async (target, post) => {
+      const me = myChatId(arbi);
+      if (!me) throw new Error("No active session");
+      let chat = target.chat;
+      if (!chat) {
+        if (!target.peerExtId) throw new Error("Could not resolve the conversation");
+        chat = await arbi.chats.openDirect(target.peerExtId);
+        upsertChat(queryClient, chat);
+        queryClient.setQueryData(
+          arbiQueryKeys.chatThread(chat.external_id),
+          (old) => old ?? { messages: [], hasMore: false }
+        );
+      }
+      const files = post.files ?? [];
+      const optimisticId = `optimistic-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const optimistic = {
+        external_id: optimisticId,
+        chat_ext_id: chat.external_id,
+        sender_ext_id: me,
+        kind: "text",
+        content: post.text,
+        key_version: chat.key_version,
+        deleted: false,
+        context_only: !!post.contextOnly,
+        workspace_ext_id: post.workspaceExtId ?? null,
+        created_at: now,
+        updated_at: now,
+        optimistic: true
+      };
+      appendToThread(queryClient, chat.external_id, optimistic);
+      try {
+        let attachments = [];
+        if (files.length) {
+          chatOps.checkChatAttachmentLimits(files);
+          attachments = await arbi.chats.uploadAttachments(
+            await Promise.all(
+              files.map(async (file) => ({
+                name: file.name,
+                type: file.type,
+                bytes: new Uint8Array(await file.arrayBuffer())
+              }))
+            )
+          );
+        }
+        const message = await arbi.chats.send(chat, post.text, {
+          attachments,
+          ...post.workspaceExtId ? { workspaceExtId: post.workspaceExtId } : {},
+          contextOnly: !!post.contextOnly
+        });
+        appendToThread(queryClient, chat.external_id, message, optimisticId);
+        upsertChat(queryClient, {
+          ...chat,
+          last_message: message,
+          last_message_at: message.created_at
+        });
+        return { chat, message };
+      } catch (err) {
+        dropFromThread(queryClient, chat.external_id, optimisticId);
+        void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.chatList() });
+        throw err;
+      }
+    },
+    [arbi, queryClient]
+  );
+}
+function useDeleteChatMessage() {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useCallback(
+    (chatExtId, messageExtId) => deleteChatMessage(arbi, queryClient, chatExtId, messageExtId),
+    [arbi, queryClient]
+  );
+}
+function useMarkChatRead() {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useCallback(
+    (chat, messageExtId) => {
+      upsertChat(queryClient, { ...chat, unread_count: 0 });
+      return arbi.chats.markRead(chat.external_id, messageExtId).then(
+        () => void 0,
+        () => void 0
+      );
+    },
+    [arbi, queryClient]
+  );
+}
+function useCreateGroupChat() {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (params) => arbi.chats.createGroup(params),
+    onSuccess: (chat) => upsertChat(queryClient, chat)
+  });
+}
+function useRenameChat() {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (vars) => arbi.chats.rename(vars.chat, vars.title),
+    onSuccess: (chat) => upsertChat(queryClient, chat)
+  });
+}
+function useAddChatMembers() {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (vars) => arbi.chats.addMembers(vars.chat, vars.members, { callKey: vars.callKey }),
+    onSuccess: (chat) => upsertChat(queryClient, chat)
+  });
+}
+function useRemoveChatMember() {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (vars) => arbi.chats.removeMember(vars.chat, vars.userExtId),
+    onSuccess: (_data, vars) => {
+      if (vars.userExtId === myChatId(arbi)) removeChat(queryClient, vars.chat.external_id);
+      else return queryClient.invalidateQueries({ queryKey: arbiQueryKeys.chatList() });
+    }
+  });
+}
+export {
+  useAddChatMembers,
+  useAgentDmStatus,
+  useChatPost,
+  useChatSummaries,
+  useChatThread,
+  useChatUnreadTotal,
+  useChats,
+  useCreateGroupChat,
+  useDeleteChatMessage,
+  useMarkChatRead,
+  useRemoveChatMember,
+  useRenameChat,
+  useUnreadByPeer
+};
+//# sourceMappingURL=useChats.js.map

package/dist/directmessages/useChats.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/directmessages/useChats.ts"],
+  "sourcesContent": ["/**\n * Chat hooks on the one chat cache (`chat-cache.ts`): my chats, unread totals, decrypted list\n * previews, one open thread, and the writes (send, delete, read, groups). Everything runs on the\n * SDK's end-to-end encrypted `arbi.chats`; nothing here touches keys or ciphertext.\n */\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport { chats as chatOps } from '@arbidocs/sdk/browser'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys } from '../hooks'\nimport {\n  appendToThread,\n  deleteChatMessage,\n  dropFromThread,\n  myChatId,\n  removeChat,\n  upsertChat,\n  type AgentDmStatus,\n  type ChatMemberKey,\n  type ChatResponse,\n  type ChatThreadData,\n  type ChatThreadMessage,\n} from './chat-cache'\n\n/** My chats (raw), most recently active first. */\nexport function useChats(options: { enabled?: boolean } = {}) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.chatList(),\n    queryFn: () => arbi.chats.list(),\n    enabled: (options.enabled ?? true) && arbi.isLoggedIn,\n  })\n}\n\n/** My own agent's latest progress on a message I sent it, live from the chat events. */\nexport function useAgentDmStatus(agentExtId: string | null | undefined): AgentDmStatus | undefined {\n  const { data } = useQuery<AgentDmStatus | null>({\n    queryKey: arbiQueryKeys.agentDmStatus(agentExtId ?? ''),\n    // Written by the events only: nothing to fetch.\n    queryFn: () => null,\n    enabled: false,\n    staleTime: Infinity,\n  })\n  return agentExtId ? (data ?? undefined) : undefined\n}\n\n/** Unread messages across all my chats (the badge on the messages entry points). */\nexport function useChatUnreadTotal(): number {\n  const { data = [] } = useChats()\n  return useMemo(() => data.reduce((sum, c) => sum + (c.unread_count ?? 0), 0), [data])\n}\n\n/** Unread count per direct-chat peer (`usr-`/`agt-` id), for per-person badges and filters. */\nexport function useUnreadByPeer(): Map<string, number> {\n  const arbi = useArbi()\n  const { data = [] } = useChats()\n  const me = myChatId(arbi)\n  return useMemo(() => {\n    const out = new Map<string, number>()\n    for (const c of data) {\n      if (c.kind !== 'direct' || !c.unread_count) continue\n      const peer = c.members.find((m) => m.user.external_id !== me)?.user.external_id ?? me\n      if (peer) out.set(peer, (out.get(peer) ?? 0) + c.unread_count)\n    }\n    return out\n  }, [data, me])\n}\n\nexport interface ChatSummary {\n  /** Decrypted group title (null for direct chats or one that does not open). */\n  title: string | null\n  /** Decrypted last message, one line. */\n  preview: string | null\n}\n\n/**\n * Decrypted titles and last-message previews for a list of chats. Only the newest message of\n * each chat is decrypted \u2014 a thread decrypts in full when it is opened, and its copy is used.\n */\nexport function useChatSummaries(chats: ChatResponse[]): Record<string, ChatSummary> {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  const [summaries, setSummaries] = useState<Record<string, ChatSummary>>({})\n  const runId = useRef(0)\n  const key = chats\n    .map(\n      (c) =>\n        `${c.external_id}:${c.key_version}:${c.title ?? ''}:${c.last_message?.external_id ?? ''}:${c.last_message?.deleted ? 'x' : ''}`\n    )\n    .join('|')\n\n  useEffect(() => {\n    if (!chats.length || !arbi.isLoggedIn) return\n    const id = ++runId.current\n    void (async () => {\n      const next: Record<string, ChatSummary> = {}\n      for (const chat of chats) {\n        const title = await arbi.chats.title(chat).catch(() => null)\n        // A tombstone is never a preview (nor decrypted): the refetched chat brings the one before.\n        const last = chat.last_message?.deleted ? null : chat.last_message\n        let preview: string | null = null\n        // The open thread's copy: my own post reaches the list already decrypted (as the send\n        // returns it), and plaintext does not decrypt.\n        const open = queryClient\n          .getQueryData<ChatThreadData>(arbiQueryKeys.chatThread(chat.external_id))\n          ?.messages.find((m) => m.external_id === last?.external_id)\n        if (open) preview = chatOps.chatMessagePreview(open)\n        else if (last) {\n          preview = await arbi.chats\n            .decrypt(chat, last)\n            .then(chatOps.chatMessagePreview)\n            .catch(() => chatOps.ENCRYPTED_PREVIEW)\n        }\n        next[chat.external_id] = { title, preview }\n      }\n      if (id === runId.current) setSummaries(next)\n    })()\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [key, arbi])\n\n  return summaries\n}\n\n/**\n * One open thread: the newest page decrypted (oldest first), kept live by the chat events, with\n * `loadOlder` paging backwards.\n */\nexport function useChatThread(chat: ChatResponse | null) {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  const chatExtId = chat?.external_id ?? ''\n  const chatRef = useRef(chat)\n  chatRef.current = chat\n  const query = useQuery<ChatThreadData>({\n    queryKey: arbiQueryKeys.chatThread(chatExtId),\n    queryFn: () => arbi.chats.page(chatRef.current!),\n    enabled: !!chat && arbi.isLoggedIn,\n    staleTime: Infinity,\n  })\n  const [loadingOlder, setLoadingOlder] = useState(false)\n\n  const loadOlder = useCallback(async () => {\n    const key = arbiQueryKeys.chatThread(chatExtId)\n    const current = queryClient.getQueryData<ChatThreadData>(key)\n    const oldest = current?.messages.find((m) => !m.optimistic)\n    if (!chatRef.current || !current?.hasMore || !oldest) return\n    setLoadingOlder(true)\n    try {\n      const page = await arbi.chats.page(chatRef.current, { before: oldest.external_id })\n      queryClient.setQueryData<ChatThreadData>(key, (old) =>\n        old\n          ? {\n              hasMore: page.hasMore,\n              messages: [\n                ...page.messages.filter(\n                  (m) => !old.messages.some((o) => o.external_id === m.external_id)\n                ),\n                ...old.messages,\n              ],\n            }\n          : old\n      )\n    } finally {\n      setLoadingOlder(false)\n    }\n  }, [arbi, queryClient, chatExtId])\n\n  return {\n    messages: query.data?.messages ?? [],\n    hasMore: query.data?.hasMore ?? false,\n    isLoading: query.isLoading && !!chat,\n    loadOlder,\n    loadingOlder,\n  }\n}\n\n/** What to post: text, files and (PA chat only) the agent's workspace or a context note. */\nexport interface ChatPost {\n  text: string\n  files?: File[]\n  /** PA chat only: the workspace my agent acts in. */\n  workspaceExtId?: string\n  /** PA chat only: a note the agent records without replying. */\n  contextOnly?: boolean\n}\n\n/**\n * Post to a chat, rendering an optimistic copy at once and swapping in the server's row. With no\n * chat yet, `peerExtId`'s direct chat is opened (created) first. Files are encrypted with their\n * own keys and travel in a manifest under the chat key. A failure drops the optimistic row,\n * refreshes the list (a stale epoch re-keys on the next try) and rethrows.\n */\nexport function useChatPost() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useCallback(\n    async (\n      target: { chat: ChatResponse | null; peerExtId?: string | null },\n      post: ChatPost\n    ): Promise<{ chat: ChatResponse; message: chatOps.DecryptedChatMessage }> => {\n      const me = myChatId(arbi)\n      if (!me) throw new Error('No active session')\n      let chat = target.chat\n      if (!chat) {\n        if (!target.peerExtId) throw new Error('Could not resolve the conversation')\n        chat = await arbi.chats.openDirect(target.peerExtId)\n        upsertChat(queryClient, chat)\n        queryClient.setQueryData<ChatThreadData>(\n          arbiQueryKeys.chatThread(chat.external_id),\n          (old) => old ?? { messages: [], hasMore: false }\n        )\n      }\n      const files = post.files ?? []\n      const optimisticId = `optimistic-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`\n      const now = new Date().toISOString()\n      const optimistic: ChatThreadMessage = {\n        external_id: optimisticId,\n        chat_ext_id: chat.external_id,\n        sender_ext_id: me,\n        kind: 'text',\n        content: post.text,\n        key_version: chat.key_version,\n        deleted: false,\n        context_only: !!post.contextOnly,\n        workspace_ext_id: post.workspaceExtId ?? null,\n        created_at: now,\n        updated_at: now,\n        optimistic: true,\n      }\n      appendToThread(queryClient, chat.external_id, optimistic)\n      try {\n        let attachments: chatOps.ChatAttachmentFile[] = []\n        if (files.length) {\n          // Refuse before reading any file into memory.\n          chatOps.checkChatAttachmentLimits(files)\n          attachments = await arbi.chats.uploadAttachments(\n            await Promise.all(\n              files.map(async (file) => ({\n                name: file.name,\n                type: file.type,\n                bytes: new Uint8Array(await file.arrayBuffer()),\n              }))\n            )\n          )\n        }\n        const message = await arbi.chats.send(chat, post.text, {\n          attachments,\n          ...(post.workspaceExtId ? { workspaceExtId: post.workspaceExtId } : {}),\n          contextOnly: !!post.contextOnly,\n        })\n        appendToThread(queryClient, chat.external_id, message, optimisticId)\n        upsertChat(queryClient, {\n          ...chat,\n          last_message: message,\n          last_message_at: message.created_at,\n        })\n        return { chat, message }\n      } catch (err) {\n        dropFromThread(queryClient, chat.external_id, optimisticId)\n        void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.chatList() })\n        throw err\n      }\n    },\n    [arbi, queryClient]\n  )\n}\n\n/** Delete one of my messages: a tombstone in place at once, rolled back if the delete fails. */\nexport function useDeleteChatMessage() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useCallback(\n    (chatExtId: string, messageExtId: string) =>\n      deleteChatMessage(arbi, queryClient, chatExtId, messageExtId),\n    [arbi, queryClient]\n  )\n}\n\n/**\n * Move my read watermark in a chat to a message (or to now). The list shows it read at once; a\n * failure is ignored (the next open tries again).\n */\nexport function useMarkChatRead() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useCallback(\n    (chat: ChatResponse, messageExtId?: string) => {\n      upsertChat(queryClient, { ...chat, unread_count: 0 })\n      return arbi.chats.markRead(chat.external_id, messageExtId).then(\n        () => undefined,\n        () => undefined\n      )\n    },\n    [arbi, queryClient]\n  )\n}\n\n/** Create a group (members need encryption keys; agents are refused) and add it to the list. */\nexport function useCreateGroupChat() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useMutation({\n    mutationFn: (params: { title?: string | null; members: ChatMemberKey[] }) =>\n      arbi.chats.createGroup(params),\n    onSuccess: (chat) => upsertChat(queryClient, chat),\n  })\n}\n\n/** Rename a group (the title is encrypted under the current epoch). */\nexport function useRenameChat() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useMutation({\n    mutationFn: (vars: { chat: ChatResponse; title: string | null }) =>\n      arbi.chats.rename(vars.chat, vars.title),\n    onSuccess: (chat) => upsertChat(queryClient, chat),\n  })\n}\n\n/** Add people to a group, or to a meeting chat with its call key (`callKey`). */\nexport function useAddChatMembers() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useMutation({\n    mutationFn: (vars: {\n      chat: ChatResponse\n      members: ChatMemberKey[]\n      callKey?: Uint8Array | null\n    }) => arbi.chats.addMembers(vars.chat, vars.members, { callKey: vars.callKey }),\n    onSuccess: (chat) => upsertChat(queryClient, chat),\n  })\n}\n\n/**\n * Remove someone from a group (owner) or leave it (my own id). Leaving drops the chat at once;\n * a removal refreshes the list (the chat now has a new epoch).\n */\nexport function useRemoveChatMember() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useMutation({\n    mutationFn: (vars: { chat: ChatResponse; userExtId: string }) =>\n      arbi.chats.removeMember(vars.chat, vars.userExtId),\n    onSuccess: (_data, vars) => {\n      if (vars.userExtId === myChatId(arbi)) removeChat(queryClient, vars.chat.external_id)\n      else return queryClient.invalidateQueries({ queryKey: arbiQueryKeys.chatList() })\n    },\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/directmessages/utils.js

@@ -0,0 +1,23 @@
+function userInitials(user) {
+  const parts = [user.given_name, user.family_name].filter(Boolean);
+  if (parts.length) {
+    return parts.map((p) => p[0]?.toUpperCase() ?? "").join("").slice(0, 2);
+  }
+  const local = user.email?.split("@")[0] ?? "";
+  return local.slice(0, 2).toUpperCase() || "?";
+}
+function userDisplayName(user) {
+  const name = [user.given_name, user.family_name].filter(Boolean).join(" ").trim();
+  return name || user.email?.split("@")[0] || "Unknown";
+}
+function isAgentUser(user) {
+  return user.external_id.startsWith("agt-");
+}
+import { formatRelativeTime } from "../lib/format-relative-time.js";
+export {
+  formatRelativeTime,
+  isAgentUser,
+  userDisplayName,
+  userInitials
+};
+//# sourceMappingURL=utils.js.map

package/dist/directmessages/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/directmessages/utils.ts"],
+  "sourcesContent": ["/** Small presentation helpers for the DM kit. */\n\nimport type { DmUser } from './types'\n\n/** Initials from a user's name (falls back to the email local-part). */\nexport function userInitials(user: Pick<DmUser, 'given_name' | 'family_name' | 'email'>): string {\n  const parts = [user.given_name, user.family_name].filter(Boolean) as string[]\n  if (parts.length) {\n    return parts\n      .map((p) => p[0]?.toUpperCase() ?? '')\n      .join('')\n      .slice(0, 2)\n  }\n  const local = user.email?.split('@')[0] ?? ''\n  return local.slice(0, 2).toUpperCase() || '?'\n}\n\n/** Full display name (falls back to the email local-part). */\nexport function userDisplayName(\n  user: Pick<DmUser, 'given_name' | 'family_name' | 'email'>\n): string {\n  const name = [user.given_name, user.family_name].filter(Boolean).join(' ').trim()\n  return name || user.email?.split('@')[0] || 'Unknown'\n}\n\n/**\n * Whether a peer is an agent rather than a person.\n *\n * Derived from the `agt-` external-id prefix, which is the platform's own\n * convention and already assumed elsewhere in the kit (entity colours are keyed\n * off the same ids). Deriving it once here is what lets every DM surface mark\n * agents without each consumer having to resolve and pass a flag.\n */\nexport function isAgentUser(user: Pick<DmUser, 'external_id'>): boolean {\n  return user.external_id.startsWith('agt-')\n}\n\nexport { formatRelativeTime } from '../lib/format-relative-time'\n"],
+  "mappings": "AAKO,SAAS,aAAa,MAAoE;AAC/F,QAAM,QAAQ,CAAC,KAAK,YAAY,KAAK,WAAW,EAAE,OAAO,OAAO;AAChE,MAAI,MAAM,QAAQ;AAChB,WAAO,MACJ,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,YAAY,KAAK,EAAE,EACpC,KAAK,EAAE,EACP,MAAM,GAAG,CAAC;AAAA,EACf;AACA,QAAM,QAAQ,KAAK,OAAO,MAAM,GAAG,EAAE,CAAC,KAAK;AAC3C,SAAO,MAAM,MAAM,GAAG,CAAC,EAAE,YAAY,KAAK;AAC5C;AAGO,SAAS,gBACd,MACQ;AACR,QAAM,OAAO,CAAC,KAAK,YAAY,KAAK,WAAW,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK;AAChF,SAAO,QAAQ,KAAK,OAAO,MAAM,GAAG,EAAE,CAAC,KAAK;AAC9C;AAUO,SAAS,YAAY,MAA4C;AACtE,SAAO,KAAK,YAAY,WAAW,MAAM;AAC3C;AAEA,SAAS,0BAA0B;",
+  "names": []
+}

package/dist/document-tools/can-annotate.js

@@ -0,0 +1,7 @@
+function canAnnotate(s) {
+  return s.activeTab === "pdf" && s.hasPdf && !s.isImage && !s.isVideo && !s.isAudio && !s.isDownloadOnly && !s.isDraft && !s.isStreaming && !s.isSnapshot && !s.isComparing;
+}
+export {
+  canAnnotate
+};
+//# sourceMappingURL=can-annotate.js.map

package/dist/document-tools/can-annotate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/document-tools/can-annotate.ts"],
+  "sourcesContent": ["/**\n * Whether the document on screen can be annotated: only a PDF the viewer is actually showing.\n * Text and Word files are shown as a PDF too, so they qualify; images, audio, video, files that\n * cannot be previewed, drafts and streaming output do not, and neither does a read-only snapshot\n * or a comparison.\n */\n\nexport interface AnnotatableState {\n  activeTab: string\n  /** The PDF bytes have been fetched. */\n  hasPdf: boolean\n  isImage: boolean\n  isVideo: boolean\n  isAudio: boolean\n  isDownloadOnly: boolean\n  isDraft: boolean\n  isStreaming: boolean\n  isSnapshot: boolean\n  isComparing: boolean\n}\n\nexport function canAnnotate(s: AnnotatableState): boolean {\n  return (\n    s.activeTab === 'pdf' &&\n    s.hasPdf &&\n    !s.isImage &&\n    !s.isVideo &&\n    !s.isAudio &&\n    !s.isDownloadOnly &&\n    !s.isDraft &&\n    !s.isStreaming &&\n    !s.isSnapshot &&\n    !s.isComparing\n  )\n}\n"],
+  "mappings": "AAqBO,SAAS,YAAY,GAA8B;AACxD,SACE,EAAE,cAAc,SAChB,EAAE,UACF,CAAC,EAAE,WACH,CAAC,EAAE,WACH,CAAC,EAAE,WACH,CAAC,EAAE,kBACH,CAAC,EAAE,WACH,CAAC,EAAE,eACH,CAAC,EAAE,cACH,CAAC,EAAE;AAEP;",
+  "names": []
+}