@liveblocks/core 3.6.2 → 3.7.0

package/dist/index.cjs

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.6.2";
+var PKG_VERSION = "3.7.0";
 var PKG_FORMAT = "cjs";
 
 // src/dupe-detection.ts
@@ -851,6 +851,38 @@ function convertToSubscriptionDeleteInfo(data) {
     deletedAt
   };
 }
+function convertToGroupData(data) {
+  const createdAt = new Date(data.createdAt);
+  const updatedAt = new Date(data.updatedAt);
+  const members = data.members.map((member) => ({
+    ...member,
+    addedAt: new Date(member.addedAt)
+  }));
+  return {
+    ...data,
+    createdAt,
+    updatedAt,
+    members
+  };
+}
+
+// src/lib/assert.ts
+function assertNever(_value, errmsg) {
+  throw new Error(errmsg);
+}
+function assert(condition, errmsg) {
+  if (process.env.NODE_ENV !== "production") {
+    if (!condition) {
+      const err = new Error(errmsg);
+      err.name = "Assertion failure";
+      throw err;
+    }
+  }
+}
+function nn(value, errmsg = "Expected value to be non-nullable") {
+  assert(value !== null && value !== void 0, errmsg);
+  return value;
+}
 
 // src/lib/fancy-console.ts
 var fancy_console_exports = {};
@@ -1095,9 +1127,15 @@ function createBatchStore(batch2) {
   function getCacheKey(args) {
     return stableStringify(args);
   }
-  function update(cacheKey, state) {
+  function update(entryOrEntries) {
     signal.mutate((cache) => {
-      cache.set(cacheKey, state);
+      if (Array.isArray(entryOrEntries)) {
+        for (const entry of entryOrEntries) {
+          cache.set(entry.key, entry.state);
+        }
+      } else {
+        cache.set(entryOrEntries.key, entryOrEntries.state);
+      }
     });
   }
   function invalidate(inputs) {
@@ -1118,21 +1156,34 @@ function createBatchStore(batch2) {
       return;
     }
     try {
-      update(cacheKey, { isLoading: true });
+      update({ key: cacheKey, state: { isLoading: true } });
       const result = await batch2.get(input);
-      update(cacheKey, { isLoading: false, data: result });
+      update({ key: cacheKey, state: { isLoading: false, data: result } });
     } catch (error3) {
-      update(cacheKey, {
-        isLoading: false,
-        error: error3
+      update({
+        key: cacheKey,
+        state: { isLoading: false, error: error3 }
       });
     }
   }
+  function setData(entries2) {
+    update(
+      entries2.map((entry) => ({
+        key: getCacheKey(entry[0]),
+        state: { isLoading: false, data: entry[1] }
+      }))
+    );
+  }
   function getItemState(input) {
     const cacheKey = getCacheKey(input);
     const cache = signal.get();
     return cache.get(cacheKey);
   }
+  function getData(input) {
+    const cacheKey = getCacheKey(input);
+    const cache = signal.get();
+    return _optionalChain([cache, 'access', _12 => _12.get, 'call', _13 => _13(cacheKey), 'optionalAccess', _14 => _14.data]);
+  }
   function _cacheKeys() {
     const cache = signal.get();
     return [...cache.keys()];
@@ -1140,7 +1191,9 @@ function createBatchStore(batch2) {
   return {
     subscribe: signal.subscribe,
     enqueue,
+    setData,
     getItemState,
+    getData,
     invalidate,
     batch: batch2,
     _cacheKeys
@@ -1658,11 +1711,11 @@ function createApiClient({
       `Upload of attachment ${options.attachment.id} was aborted.`,
       "AbortError"
     ) : void 0;
-    if (_optionalChain([abortSignal, 'optionalAccess', _12 => _12.aborted])) {
+    if (_optionalChain([abortSignal, 'optionalAccess', _15 => _15.aborted])) {
       throw abortError;
     }
     const handleRetryError = (err) => {
-      if (_optionalChain([abortSignal, 'optionalAccess', _13 => _13.aborted])) {
+      if (_optionalChain([abortSignal, 'optionalAccess', _16 => _16.aborted])) {
         throw abortError;
       }
       if (err instanceof HttpError && err.status === 413) {
@@ -1734,7 +1787,7 @@ function createApiClient({
       try {
         uploadId = createMultiPartUpload.uploadId;
         const parts = splitFileIntoParts(attachment.file);
-        if (_optionalChain([abortSignal, 'optionalAccess', _14 => _14.aborted])) {
+        if (_optionalChain([abortSignal, 'optionalAccess', _17 => _17.aborted])) {
           throw abortError;
         }
         const batches = chunk(parts, 5);
@@ -1761,7 +1814,7 @@ function createApiClient({
           }
           uploadedParts.push(...await Promise.all(uploadedPartsPromises));
         }
-        if (_optionalChain([abortSignal, 'optionalAccess', _15 => _15.aborted])) {
+        if (_optionalChain([abortSignal, 'optionalAccess', _18 => _18.aborted])) {
           throw abortError;
         }
         const sortedUploadedParts = uploadedParts.sort(
@@ -1777,7 +1830,7 @@ function createApiClient({
           { signal: abortSignal }
         );
       } catch (error3) {
-        if (uploadId && _optionalChain([error3, 'optionalAccess', _16 => _16.name]) && (error3.name === "AbortError" || error3.name === "TimeoutError")) {
+        if (uploadId && _optionalChain([error3, 'optionalAccess', _19 => _19.name]) && (error3.name === "AbortError" || error3.name === "TimeoutError")) {
           try {
             await httpClient.rawDelete(
               url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}`,
@@ -1962,6 +2015,9 @@ function createApiClient({
     return batch2.get(options.inboxNotificationId);
   }
   async function createTextMention(options) {
+    if (options.mention.kind !== "user" && options.mention.kind !== "group") {
+      return assertNever(options.mention, "Unexpected mention kind");
+    }
     await httpClient.rawPost(
       url`/v2/c/rooms/${options.roomId}/text-mentions`,
       await authManager.getAuthValue({
@@ -1969,7 +2025,9 @@ function createApiClient({
         roomId: options.roomId
       }),
       {
-        userId: options.userId,
+        userId: options.mention.kind === "user" ? options.mention.id : void 0,
+        groupId: options.mention.kind === "group" ? options.mention.id : void 0,
+        userIds: options.mention.kind === "group" ? options.mention.userIds : void 0,
         mentionId: options.mentionId
       }
     );
@@ -2100,14 +2158,21 @@ function createApiClient({
   }
   async function getInboxNotifications(options) {
     const PAGE_SIZE = 50;
+    let query;
+    if (_optionalChain([options, 'optionalAccess', _20 => _20.query])) {
+      query = objectToQuery(options.query);
+    }
     const json = await httpClient.get(
       url`/v2/c/inbox-notifications`,
       await authManager.getAuthValue({ requestedScope: "comments:read" }),
       {
-        cursor: _optionalChain([options, 'optionalAccess', _17 => _17.cursor]),
-        limit: PAGE_SIZE
+        cursor: _optionalChain([options, 'optionalAccess', _21 => _21.cursor]),
+        limit: PAGE_SIZE,
+        query
       }
     );
+    const groups = json.groups.map(convertToGroupData);
+    groupsStore.setData(groups.map((group) => [group.id, group]));
     return {
       inboxNotifications: json.inboxNotifications.map(
         convertToInboxNotificationData
@@ -2119,10 +2184,14 @@ function createApiClient({
     };
   }
   async function getInboxNotificationsSince(options) {
+    let query;
+    if (_optionalChain([options, 'optionalAccess', _22 => _22.query])) {
+      query = objectToQuery(options.query);
+    }
     const json = await httpClient.get(
       url`/v2/c/inbox-notifications/delta`,
       await authManager.getAuthValue({ requestedScope: "comments:read" }),
-      { since: options.since.toISOString() },
+      { since: options.since.toISOString(), query },
       { signal: options.signal }
     );
     return {
@@ -2196,7 +2265,7 @@ function createApiClient({
       url`/v2/c/notification-settings`,
       await authManager.getAuthValue({ requestedScope: "comments:read" }),
       void 0,
-      { signal: _optionalChain([options, 'optionalAccess', _18 => _18.signal]) }
+      { signal: _optionalChain([options, 'optionalAccess', _23 => _23.signal]) }
     );
   }
   async function updateNotificationSettings(settings) {
@@ -2208,7 +2277,7 @@ function createApiClient({
   }
   async function getUserThreads_experimental(options) {
     let query;
-    if (_optionalChain([options, 'optionalAccess', _19 => _19.query])) {
+    if (_optionalChain([options, 'optionalAccess', _24 => _24.query])) {
       query = objectToQuery(options.query);
     }
     const PAGE_SIZE = 50;
@@ -2216,7 +2285,7 @@ function createApiClient({
       url`/v2/c/threads`,
       await authManager.getAuthValue({ requestedScope: "comments:read" }),
       {
-        cursor: _optionalChain([options, 'optionalAccess', _20 => _20.cursor]),
+        cursor: _optionalChain([options, 'optionalAccess', _25 => _25.cursor]),
         query,
         limit: PAGE_SIZE
       }
@@ -2258,6 +2327,28 @@ function createApiClient({
       permissionHints: json.meta.permissionHints
     };
   }
+  const batchedGetGroups = new Batch(
+    async (batchedGroupIds) => {
+      const groupIds = batchedGroupIds.flat();
+      const { groups: plainGroups } = await httpClient.post(
+        url`/v2/c/groups/find`,
+        await authManager.getAuthValue({
+          requestedScope: "comments:read"
+        }),
+        { groupIds }
+      );
+      const groups = /* @__PURE__ */ new Map();
+      for (const group of plainGroups) {
+        groups.set(group.id, convertToGroupData(group));
+      }
+      return groupIds.map((groupId) => groups.get(groupId));
+    },
+    { delay: 50 }
+  );
+  const groupsStore = createBatchStore(batchedGetGroups);
+  function getGroup(groupId) {
+    return batchedGetGroups.get(groupId);
+  }
   return {
     // Room threads
     getThreads,
@@ -2311,6 +2402,9 @@ function createApiClient({
     // User threads
     getUserThreads_experimental,
     getUserThreadsSince_experimental,
+    // Groups
+    groupsStore,
+    getGroup,
     // AI
     executeContextualPrompt
   };
@@ -2356,7 +2450,7 @@ var HttpClient = class {
         // These headers are default, but can be overriden by custom headers
         "Content-Type": "application/json; charset=utf-8",
         // Possible header overrides
-        ..._optionalChain([options, 'optionalAccess', _21 => _21.headers]),
+        ..._optionalChain([options, 'optionalAccess', _26 => _26.headers]),
         // Cannot be overriden by custom headers
         Authorization: `Bearer ${getBearerTokenFromAuthValue(authValue)}`,
         "X-LB-Client": PKG_VERSION || "dev"
@@ -2468,24 +2562,6 @@ var HttpClient = class {
   }
 };
 
-// src/lib/assert.ts
-function assertNever(_value, errmsg) {
-  throw new Error(errmsg);
-}
-function assert(condition, errmsg) {
-  if (process.env.NODE_ENV !== "production") {
-    if (!condition) {
-      const err = new Error(errmsg);
-      err.name = "Assertion failure";
-      throw err;
-    }
-  }
-}
-function nn(value, errmsg = "Expected value to be non-nullable") {
-  assert(value !== null && value !== void 0, errmsg);
-  return value;
-}
-
 // src/lib/fsm.ts
 function distance(state1, state2) {
   if (state1 === state2) {
@@ -2831,7 +2907,7 @@ var FSM = class {
     });
   }
   #getTargetFn(eventName) {
-    return _optionalChain([this, 'access', _22 => _22.#allowedTransitions, 'access', _23 => _23.get, 'call', _24 => _24(this.currentState), 'optionalAccess', _25 => _25.get, 'call', _26 => _26(eventName)]);
+    return _optionalChain([this, 'access', _27 => _27.#allowedTransitions, 'access', _28 => _28.get, 'call', _29 => _29(this.currentState), 'optionalAccess', _30 => _30.get, 'call', _31 => _31(eventName)]);
   }
   /**
    * Exits the current state, and executes any necessary cleanup functions.
@@ -2848,7 +2924,7 @@ var FSM = class {
     this.#currentContext.allowPatching((patchableContext) => {
       levels = _nullishCoalesce(levels, () => ( this.#cleanupStack.length));
       for (let i = 0; i < levels; i++) {
-        _optionalChain([this, 'access', _27 => _27.#cleanupStack, 'access', _28 => _28.pop, 'call', _29 => _29(), 'optionalCall', _30 => _30(patchableContext)]);
+        _optionalChain([this, 'access', _32 => _32.#cleanupStack, 'access', _33 => _33.pop, 'call', _34 => _34(), 'optionalCall', _35 => _35(patchableContext)]);
       }
     });
   }
@@ -2864,7 +2940,7 @@ var FSM = class {
     this.#currentContext.allowPatching((patchableContext) => {
       for (const pattern of enterPatterns) {
         const enterFn = this.#enterFns.get(pattern);
-        const cleanupFn = _optionalChain([enterFn, 'optionalCall', _31 => _31(patchableContext)]);
+        const cleanupFn = _optionalChain([enterFn, 'optionalCall', _36 => _36(patchableContext)]);
         if (typeof cleanupFn === "function") {
           this.#cleanupStack.push(cleanupFn);
         } else {
@@ -3258,7 +3334,7 @@ function createConnectionStateMachine(delegates, options) {
           }
           function waitForActorId(event) {
             const serverMsg = tryParseJson(event.data);
-            if (_optionalChain([serverMsg, 'optionalAccess', _32 => _32.type]) === 104 /* ROOM_STATE */) {
+            if (_optionalChain([serverMsg, 'optionalAccess', _37 => _37.type]) === 104 /* ROOM_STATE */) {
               didReceiveActor();
             }
           }
@@ -3367,12 +3443,12 @@ function createConnectionStateMachine(delegates, options) {
   const sendHeartbeat = {
     target: "@ok.awaiting-pong",
     effect: (ctx) => {
-      _optionalChain([ctx, 'access', _33 => _33.socket, 'optionalAccess', _34 => _34.send, 'call', _35 => _35("ping")]);
+      _optionalChain([ctx, 'access', _38 => _38.socket, 'optionalAccess', _39 => _39.send, 'call', _40 => _40("ping")]);
     }
   };
   const maybeHeartbeat = () => {
     const doc = typeof document !== "undefined" ? document : void 0;
-    const canZombie = _optionalChain([doc, 'optionalAccess', _36 => _36.visibilityState]) === "hidden" && delegates.canZombie();
+    const canZombie = _optionalChain([doc, 'optionalAccess', _41 => _41.visibilityState]) === "hidden" && delegates.canZombie();
     return canZombie ? "@idle.zombie" : sendHeartbeat;
   };
   machine.addTimedTransition("@ok.connected", HEARTBEAT_INTERVAL, maybeHeartbeat).addTransitions("@ok.connected", {
@@ -3411,7 +3487,7 @@ function createConnectionStateMachine(delegates, options) {
     // socket, or not. So always check to see if the socket is still OPEN or
     // not. When still OPEN, don't transition.
     EXPLICIT_SOCKET_ERROR: (_, context) => {
-      if (_optionalChain([context, 'access', _37 => _37.socket, 'optionalAccess', _38 => _38.readyState]) === 1) {
+      if (_optionalChain([context, 'access', _42 => _42.socket, 'optionalAccess', _43 => _43.readyState]) === 1) {
         return null;
       }
       return {
@@ -3463,17 +3539,17 @@ function createConnectionStateMachine(delegates, options) {
         machine.send({ type: "NAVIGATOR_ONLINE" });
       }
       function onVisibilityChange() {
-        if (_optionalChain([doc, 'optionalAccess', _39 => _39.visibilityState]) === "visible") {
+        if (_optionalChain([doc, 'optionalAccess', _44 => _44.visibilityState]) === "visible") {
           machine.send({ type: "WINDOW_GOT_FOCUS" });
         }
       }
-      _optionalChain([win, 'optionalAccess', _40 => _40.addEventListener, 'call', _41 => _41("online", onNetworkBackOnline)]);
-      _optionalChain([win, 'optionalAccess', _42 => _42.addEventListener, 'call', _43 => _43("offline", onNetworkOffline)]);
-      _optionalChain([root, 'optionalAccess', _44 => _44.addEventListener, 'call', _45 => _45("visibilitychange", onVisibilityChange)]);
+      _optionalChain([win, 'optionalAccess', _45 => _45.addEventListener, 'call', _46 => _46("online", onNetworkBackOnline)]);
+      _optionalChain([win, 'optionalAccess', _47 => _47.addEventListener, 'call', _48 => _48("offline", onNetworkOffline)]);
+      _optionalChain([root, 'optionalAccess', _49 => _49.addEventListener, 'call', _50 => _50("visibilitychange", onVisibilityChange)]);
       return () => {
-        _optionalChain([root, 'optionalAccess', _46 => _46.removeEventListener, 'call', _47 => _47("visibilitychange", onVisibilityChange)]);
-        _optionalChain([win, 'optionalAccess', _48 => _48.removeEventListener, 'call', _49 => _49("online", onNetworkBackOnline)]);
-        _optionalChain([win, 'optionalAccess', _50 => _50.removeEventListener, 'call', _51 => _51("offline", onNetworkOffline)]);
+        _optionalChain([root, 'optionalAccess', _51 => _51.removeEventListener, 'call', _52 => _52("visibilitychange", onVisibilityChange)]);
+        _optionalChain([win, 'optionalAccess', _53 => _53.removeEventListener, 'call', _54 => _54("online", onNetworkBackOnline)]);
+        _optionalChain([win, 'optionalAccess', _55 => _55.removeEventListener, 'call', _56 => _56("offline", onNetworkOffline)]);
         teardownSocket(ctx.socket);
       };
     });
@@ -3562,7 +3638,7 @@ var ManagedSocket = class {
    * message if this is somehow impossible.
    */
   send(data) {
-    const socket = _optionalChain([this, 'access', _52 => _52.#machine, 'access', _53 => _53.context, 'optionalAccess', _54 => _54.socket]);
+    const socket = _optionalChain([this, 'access', _57 => _57.#machine, 'access', _58 => _58.context, 'optionalAccess', _59 => _59.socket]);
     if (socket === null) {
       warn("Cannot send: not connected yet", data);
     } else if (socket.readyState !== 1) {
@@ -4000,7 +4076,7 @@ function replaceOrAppend(content, newItem, keyFn, now2) {
   }
 }
 function closePart(prevPart, endedAt) {
-  if (_optionalChain([prevPart, 'optionalAccess', _55 => _55.type]) === "reasoning") {
+  if (_optionalChain([prevPart, 'optionalAccess', _60 => _60.type]) === "reasoning") {
     prevPart.endedAt ??= endedAt;
   }
 }
@@ -4011,7 +4087,7 @@ function patchContentWithDelta(content, delta) {
   const lastPart = content[content.length - 1];
   switch (delta.type) {
     case "text-delta":
-      if (_optionalChain([lastPart, 'optionalAccess', _56 => _56.type]) === "text") {
+      if (_optionalChain([lastPart, 'optionalAccess', _61 => _61.type]) === "text") {
         lastPart.text += delta.textDelta;
       } else {
         closePart(lastPart, now2);
@@ -4019,13 +4095,13 @@ function patchContentWithDelta(content, delta) {
       }
       break;
     case "reasoning-delta":
-      if (_optionalChain([lastPart, 'optionalAccess', _57 => _57.type]) === "reasoning") {
+      if (_optionalChain([lastPart, 'optionalAccess', _62 => _62.type]) === "reasoning") {
         lastPart.text += delta.textDelta;
       } else {
         closePart(lastPart, now2);
         content.push({
           type: "reasoning",
-          text: _nullishCoalesce(delta.textDelta, () => ( "")),
+          text: delta.textDelta,
           startedAt: now2
         });
       }
@@ -4039,8 +4115,8 @@ function patchContentWithDelta(content, delta) {
       break;
     }
     case "tool-delta": {
-      if (_optionalChain([lastPart, 'optionalAccess', _58 => _58.type]) === "tool-invocation" && lastPart.stage === "receiving") {
-        _optionalChain([lastPart, 'access', _59 => _59.__appendDelta, 'optionalCall', _60 => _60(delta.delta)]);
+      if (_optionalChain([lastPart, 'optionalAccess', _63 => _63.type]) === "tool-invocation" && lastPart.stage === "receiving") {
+        _optionalChain([lastPart, 'access', _64 => _64.__appendDelta, 'optionalCall', _65 => _65(delta.delta)]);
       }
       break;
     }
@@ -4159,7 +4235,7 @@ function createStore_forTools() {
     return DerivedSignal.from(() => {
       return (
         // A tool that's registered and scoped to a specific chat ID...
-        _nullishCoalesce(_optionalChain([(chatId !== void 0 ? toolsByChatId\u03A3.getOrCreate(chatId).getOrCreate(name) : void 0), 'optionalAccess', _61 => _61.get, 'call', _62 => _62()]), () => ( // ...or a globally registered tool
+        _nullishCoalesce(_optionalChain([(chatId !== void 0 ? toolsByChatId\u03A3.getOrCreate(chatId).getOrCreate(name) : void 0), 'optionalAccess', _66 => _66.get, 'call', _67 => _67()]), () => ( // ...or a globally registered tool
         toolsByChatId\u03A3.getOrCreate(kWILDCARD).getOrCreate(name).get()))
       );
     });
@@ -4189,8 +4265,8 @@ function createStore_forTools() {
     const globalTools\u03A3 = toolsByChatId\u03A3.get(kWILDCARD);
     const scopedTools\u03A3 = toolsByChatId\u03A3.get(chatId);
     return Array.from([
-      ..._nullishCoalesce(_optionalChain([globalTools\u03A3, 'optionalAccess', _63 => _63.entries, 'call', _64 => _64()]), () => ( [])),
-      ..._nullishCoalesce(_optionalChain([scopedTools\u03A3, 'optionalAccess', _65 => _65.entries, 'call', _66 => _66()]), () => ( []))
+      ..._nullishCoalesce(_optionalChain([globalTools\u03A3, 'optionalAccess', _68 => _68.entries, 'call', _69 => _69()]), () => ( [])),
+      ..._nullishCoalesce(_optionalChain([scopedTools\u03A3, 'optionalAccess', _70 => _70.entries, 'call', _71 => _71()]), () => ( []))
     ]).flatMap(([name, tool\u03A3]) => {
       const tool = tool\u03A3.get();
       return tool && (_nullishCoalesce(tool.enabled, () => ( true))) ? [{ name, description: tool.description, parameters: tool.parameters }] : [];
@@ -4293,7 +4369,7 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
             } else {
               continue;
             }
-            const executeFn = _optionalChain([toolsStore, 'access', _67 => _67.getTool\u03A3, 'call', _68 => _68(toolInvocation.name, message.chatId), 'access', _69 => _69.get, 'call', _70 => _70(), 'optionalAccess', _71 => _71.execute]);
+            const executeFn = _optionalChain([toolsStore, 'access', _72 => _72.getTool\u03A3, 'call', _73 => _73(toolInvocation.name, message.chatId), 'access', _74 => _74.get, 'call', _75 => _75(), 'optionalAccess', _76 => _76.execute]);
             if (executeFn) {
               (async () => {
                 const result = await executeFn(toolInvocation.args, {
@@ -4392,8 +4468,8 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
       const spine = [];
       let lastVisitedMessage = null;
       for (const message2 of pool.walkUp(leaf.id)) {
-        const prev = _nullishCoalesce(_optionalChain([first, 'call', _72 => _72(pool.walkLeft(message2.id, isAlive)), 'optionalAccess', _73 => _73.id]), () => ( null));
-        const next = _nullishCoalesce(_optionalChain([first, 'call', _74 => _74(pool.walkRight(message2.id, isAlive)), 'optionalAccess', _75 => _75.id]), () => ( null));
+        const prev = _nullishCoalesce(_optionalChain([first, 'call', _77 => _77(pool.walkLeft(message2.id, isAlive)), 'optionalAccess', _78 => _78.id]), () => ( null));
+        const next = _nullishCoalesce(_optionalChain([first, 'call', _79 => _79(pool.walkRight(message2.id, isAlive)), 'optionalAccess', _80 => _80.id]), () => ( null));
         if (!message2.deletedAt || prev || next) {
           const node = {
             ...message2,
@@ -4459,7 +4535,7 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
     const latest = pool.sorted.findRight(
       (m) => m.role === "assistant" && !m.deletedAt
     );
-    return _optionalChain([latest, 'optionalAccess', _76 => _76.copilotId]);
+    return _optionalChain([latest, 'optionalAccess', _81 => _81.copilotId]);
   }
   return {
     // Readers
@@ -4490,11 +4566,11 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
     *getAutoExecutingMessageIds() {
       for (const messageId of myMessages) {
         const message = getMessageById(messageId);
-        if (_optionalChain([message, 'optionalAccess', _77 => _77.role]) === "assistant" && message.status === "awaiting-tool") {
+        if (_optionalChain([message, 'optionalAccess', _82 => _82.role]) === "assistant" && message.status === "awaiting-tool") {
           const isAutoExecuting = message.contentSoFar.some((part) => {
             if (part.type === "tool-invocation" && part.stage === "executing") {
               const tool = toolsStore.getTool\u03A3(part.name, message.chatId).get();
-              return typeof _optionalChain([tool, 'optionalAccess', _78 => _78.execute]) === "function";
+              return typeof _optionalChain([tool, 'optionalAccess', _83 => _83.execute]) === "function";
             }
             return false;
           });
@@ -4639,7 +4715,7 @@ function createAi(config) {
           flushPendingDeltas();
           switch (msg.event) {
             case "cmd-failed":
-              _optionalChain([pendingCmd, 'optionalAccess', _79 => _79.reject, 'call', _80 => _80(new Error(msg.error))]);
+              _optionalChain([pendingCmd, 'optionalAccess', _84 => _84.reject, 'call', _85 => _85(new Error(msg.error))]);
               break;
             case "settle": {
               context.messagesStore.upsert(msg.message);
@@ -4716,7 +4792,7 @@ function createAi(config) {
           return assertNever(msg, "Unhandled case");
       }
     }
-    _optionalChain([pendingCmd, 'optionalAccess', _81 => _81.resolve, 'call', _82 => _82(msg)]);
+    _optionalChain([pendingCmd, 'optionalAccess', _86 => _86.resolve, 'call', _87 => _87(msg)]);
   }
   managedSocket.events.onMessage.subscribe(handleServerMessage);
   managedSocket.events.statusDidChange.subscribe(onStatusDidChange);
@@ -4801,9 +4877,9 @@ function createAi(config) {
       invocationId,
       result,
       generationOptions: {
-        copilotId: _optionalChain([options, 'optionalAccess', _83 => _83.copilotId]),
-        stream: _optionalChain([options, 'optionalAccess', _84 => _84.stream]),
-        timeout: _optionalChain([options, 'optionalAccess', _85 => _85.timeout]),
+        copilotId: _optionalChain([options, 'optionalAccess', _88 => _88.copilotId]),
+        stream: _optionalChain([options, 'optionalAccess', _89 => _89.stream]),
+        timeout: _optionalChain([options, 'optionalAccess', _90 => _90.timeout]),
         // Knowledge and tools aren't coming from the options, but retrieved
         // from the global context
         knowledge: knowledge.length > 0 ? knowledge : void 0,
@@ -4821,7 +4897,7 @@ function createAi(config) {
     }
   }
   const win = typeof window !== "undefined" ? window : void 0;
-  _optionalChain([win, 'optionalAccess', _86 => _86.addEventListener, 'call', _87 => _87("beforeunload", handleBeforeUnload, { once: true })]);
+  _optionalChain([win, 'optionalAccess', _91 => _91.addEventListener, 'call', _92 => _92("beforeunload", handleBeforeUnload, { once: true })]);
   return Object.defineProperty(
     {
       [kInternal]: {
@@ -4840,7 +4916,7 @@ function createAi(config) {
       clearChat: (chatId) => sendClientMsgWithResponse({ cmd: "clear-chat", chatId }),
       askUserMessageInChat: async (chatId, userMessage, targetMessageId, options) => {
         const globalKnowledge = context.knowledge.get();
-        const requestKnowledge = _optionalChain([options, 'optionalAccess', _88 => _88.knowledge]) || [];
+        const requestKnowledge = _optionalChain([options, 'optionalAccess', _93 => _93.knowledge]) || [];
         const combinedKnowledge = [...globalKnowledge, ...requestKnowledge];
         const tools = context.toolsStore.getToolDescriptions(chatId);
         messagesStore.markMine(targetMessageId);
@@ -4850,9 +4926,9 @@ function createAi(config) {
           sourceMessage: userMessage,
           targetMessageId,
           generationOptions: {
-            copilotId: _optionalChain([options, 'optionalAccess', _89 => _89.copilotId]),
-            stream: _optionalChain([options, 'optionalAccess', _90 => _90.stream]),
-            timeout: _optionalChain([options, 'optionalAccess', _91 => _91.timeout]),
+            copilotId: _optionalChain([options, 'optionalAccess', _94 => _94.copilotId]),
+            stream: _optionalChain([options, 'optionalAccess', _95 => _95.stream]),
+            timeout: _optionalChain([options, 'optionalAccess', _96 => _96.timeout]),
             // Combine global knowledge with request-specific knowledge
             knowledge: combinedKnowledge.length > 0 ? combinedKnowledge : void 0,
             tools: tools.length > 0 ? tools : void 0
@@ -4953,7 +5029,7 @@ function createAuthManager(authOptions, onAuthenticate) {
     return void 0;
   }
   async function makeAuthRequest(options) {
-    const fetcher = _nullishCoalesce(_optionalChain([authOptions, 'access', _92 => _92.polyfills, 'optionalAccess', _93 => _93.fetch]), () => ( (typeof window === "undefined" ? void 0 : window.fetch)));
+    const fetcher = _nullishCoalesce(_optionalChain([authOptions, 'access', _97 => _97.polyfills, 'optionalAccess', _98 => _98.fetch]), () => ( (typeof window === "undefined" ? void 0 : window.fetch)));
     if (authentication.type === "private") {
       if (fetcher === void 0) {
         throw new StopRetrying(
@@ -4969,7 +5045,7 @@ function createAuthManager(authOptions, onAuthenticate) {
           "The same Liveblocks auth token was issued from the backend before. Caching Liveblocks tokens is not supported."
         );
       }
-      _optionalChain([onAuthenticate, 'optionalCall', _94 => _94(parsed.parsed)]);
+      _optionalChain([onAuthenticate, 'optionalCall', _99 => _99(parsed.parsed)]);
       return parsed;
     }
     if (authentication.type === "custom") {
@@ -4977,7 +5053,7 @@ function createAuthManager(authOptions, onAuthenticate) {
       if (response && typeof response === "object") {
         if (typeof response.token === "string") {
           const parsed = parseAuthToken(response.token);
-          _optionalChain([onAuthenticate, 'optionalCall', _95 => _95(parsed.parsed)]);
+          _optionalChain([onAuthenticate, 'optionalCall', _100 => _100(parsed.parsed)]);
           return parsed;
         } else if (typeof response.error === "string") {
           const reason = `Authentication failed: ${"reason" in response && typeof response.reason === "string" ? response.reason : "Forbidden"}`;
@@ -5121,6 +5197,7 @@ async function fetchAuthEndpoint(fetch, endpoint, body) {
 
 // src/constants.ts
 var DEFAULT_BASE_URL = "https://api.liveblocks.io";
+var MENTION_CHARACTER = "@";
 
 // src/devtools/bridge.ts
 var _bridgeActive = false;
@@ -5135,7 +5212,7 @@ function sendToPanel(message, options) {
     ...message,
     source: "liveblocks-devtools-client"
   };
-  if (!(_optionalChain([options, 'optionalAccess', _96 => _96.force]) || _bridgeActive)) {
+  if (!(_optionalChain([options, 'optionalAccess', _101 => _101.force]) || _bridgeActive)) {
     return;
   }
   window.postMessage(fullMsg, "*");
@@ -5143,7 +5220,7 @@ function sendToPanel(message, options) {
 var eventSource = makeEventSource();
 if (process.env.NODE_ENV !== "production" && typeof window !== "undefined") {
   window.addEventListener("message", (event) => {
-    if (event.source === window && _optionalChain([event, 'access', _97 => _97.data, 'optionalAccess', _98 => _98.source]) === "liveblocks-devtools-panel") {
+    if (event.source === window && _optionalChain([event, 'access', _102 => _102.data, 'optionalAccess', _103 => _103.source]) === "liveblocks-devtools-panel") {
       eventSource.notify(event.data);
     } else {
     }
@@ -5285,7 +5362,7 @@ function fullSync(room) {
     msg: "room::sync::full",
     roomId: room.id,
     status: room.getStatus(),
-    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _99 => _99.toTreeNode, 'call', _100 => _100("root"), 'access', _101 => _101.payload]), () => ( null)),
+    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _104 => _104.toTreeNode, 'call', _105 => _105("root"), 'access', _106 => _106.payload]), () => ( null)),
     me,
     others
   });
@@ -5340,6 +5417,22 @@ function unlinkDevTools(roomId) {
   });
 }
 
+// src/lib/warnings.ts
+var _emittedWarnings = /* @__PURE__ */ new Set();
+function warnOnce(message, key = message) {
+  if (process.env.NODE_ENV !== "production") {
+    if (!_emittedWarnings.has(key)) {
+      _emittedWarnings.add(key);
+      warn(message);
+    }
+  }
+}
+function warnOnceIf(condition, message, key = message) {
+  if (typeof condition === "function" ? condition() : condition) {
+    warnOnce(message, key);
+  }
+}
+
 // src/protocol/NotificationSettings.ts
 var kPlain = Symbol("notification-settings-plain");
 function createNotificationSettings(plain) {
@@ -5576,7 +5669,7 @@ function createManagedPool(roomId, options) {
     generateId: () => `${getCurrentConnectionId()}:${clock++}`,
     generateOpId: () => `${getCurrentConnectionId()}:${opClock++}`,
     dispatch(ops, reverse, storageUpdates) {
-      _optionalChain([onDispatch, 'optionalCall', _102 => _102(ops, reverse, storageUpdates)]);
+      _optionalChain([onDispatch, 'optionalCall', _107 => _107(ops, reverse, storageUpdates)]);
     },
     assertStorageIsWritable: () => {
       if (!isStorageWritable()) {
@@ -5803,7 +5896,7 @@ var LiveRegister = class _LiveRegister extends AbstractCrdt {
     return [
       {
         type: 8 /* CREATE_REGISTER */,
-        opId: _optionalChain([pool, 'optionalAccess', _103 => _103.generateOpId, 'call', _104 => _104()]),
+        opId: _optionalChain([pool, 'optionalAccess', _108 => _108.generateOpId, 'call', _109 => _109()]),
         id: this._id,
         parentId,
         parentKey,
@@ -5909,7 +6002,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     const ops = [];
     const op = {
       id: this._id,
-      opId: _optionalChain([pool, 'optionalAccess', _105 => _105.generateOpId, 'call', _106 => _106()]),
+      opId: _optionalChain([pool, 'optionalAccess', _110 => _110.generateOpId, 'call', _111 => _111()]),
       type: 2 /* CREATE_LIST */,
       parentId,
       parentKey
@@ -6180,7 +6273,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #applyInsertUndoRedo(op) {
     const { id, parentKey: key } = op;
     const child = creationOpToLiveNode(op);
-    if (_optionalChain([this, 'access', _107 => _107._pool, 'optionalAccess', _108 => _108.getNode, 'call', _109 => _109(id)]) !== void 0) {
+    if (_optionalChain([this, 'access', _112 => _112._pool, 'optionalAccess', _113 => _113.getNode, 'call', _114 => _114(id)]) !== void 0) {
       return { modified: false };
     }
     child._attach(id, nn(this._pool));
@@ -6188,8 +6281,8 @@ var LiveList = class _LiveList extends AbstractCrdt {
     const existingItemIndex = this._indexOfPosition(key);
     let newKey = key;
     if (existingItemIndex !== -1) {
-      const before2 = _optionalChain([this, 'access', _110 => _110.#items, 'access', _111 => _111[existingItemIndex], 'optionalAccess', _112 => _112._parentPos]);
-      const after2 = _optionalChain([this, 'access', _113 => _113.#items, 'access', _114 => _114[existingItemIndex + 1], 'optionalAccess', _115 => _115._parentPos]);
+      const before2 = _optionalChain([this, 'access', _115 => _115.#items, 'access', _116 => _116[existingItemIndex], 'optionalAccess', _117 => _117._parentPos]);
+      const after2 = _optionalChain([this, 'access', _118 => _118.#items, 'access', _119 => _119[existingItemIndex + 1], 'optionalAccess', _120 => _120._parentPos]);
       newKey = makePosition(before2, after2);
       child._setParentLink(this, newKey);
     }
@@ -6203,7 +6296,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #applySetUndoRedo(op) {
     const { id, parentKey: key } = op;
     const child = creationOpToLiveNode(op);
-    if (_optionalChain([this, 'access', _116 => _116._pool, 'optionalAccess', _117 => _117.getNode, 'call', _118 => _118(id)]) !== void 0) {
+    if (_optionalChain([this, 'access', _121 => _121._pool, 'optionalAccess', _122 => _122.getNode, 'call', _123 => _123(id)]) !== void 0) {
       return { modified: false };
     }
     this.#unacknowledgedSets.set(key, nn(op.opId));
@@ -6324,7 +6417,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     } else {
       this.#items[existingItemIndex]._setParentLink(
         this,
-        makePosition(newKey, _optionalChain([this, 'access', _119 => _119.#items, 'access', _120 => _120[existingItemIndex + 1], 'optionalAccess', _121 => _121._parentPos]))
+        makePosition(newKey, _optionalChain([this, 'access', _124 => _124.#items, 'access', _125 => _125[existingItemIndex + 1], 'optionalAccess', _126 => _126._parentPos]))
       );
       const previousIndex = this.#items.indexOf(child);
       child._setParentLink(this, newKey);
@@ -6349,7 +6442,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
       if (existingItemIndex !== -1) {
         this.#items[existingItemIndex]._setParentLink(
           this,
-          makePosition(newKey, _optionalChain([this, 'access', _122 => _122.#items, 'access', _123 => _123[existingItemIndex + 1], 'optionalAccess', _124 => _124._parentPos]))
+          makePosition(newKey, _optionalChain([this, 'access', _127 => _127.#items, 'access', _128 => _128[existingItemIndex + 1], 'optionalAccess', _129 => _129._parentPos]))
         );
       }
       child._setParentLink(this, newKey);
@@ -6368,7 +6461,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
       if (existingItemIndex !== -1) {
         this.#items[existingItemIndex]._setParentLink(
           this,
-          makePosition(newKey, _optionalChain([this, 'access', _125 => _125.#items, 'access', _126 => _126[existingItemIndex + 1], 'optionalAccess', _127 => _127._parentPos]))
+          makePosition(newKey, _optionalChain([this, 'access', _130 => _130.#items, 'access', _131 => _131[existingItemIndex + 1], 'optionalAccess', _132 => _132._parentPos]))
         );
       }
       child._setParentLink(this, newKey);
@@ -6396,7 +6489,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     if (existingItemIndex !== -1) {
       actualNewKey = makePosition(
         newKey,
-        _optionalChain([this, 'access', _128 => _128.#items, 'access', _129 => _129[existingItemIndex + 1], 'optionalAccess', _130 => _130._parentPos])
+        _optionalChain([this, 'access', _133 => _133.#items, 'access', _134 => _134[existingItemIndex + 1], 'optionalAccess', _135 => _135._parentPos])
       );
     }
     child._setParentLink(this, actualNewKey);
@@ -6454,7 +6547,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param element The element to add to the end of the LiveList.
    */
   push(element) {
-    _optionalChain([this, 'access', _131 => _131._pool, 'optionalAccess', _132 => _132.assertStorageIsWritable, 'call', _133 => _133()]);
+    _optionalChain([this, 'access', _136 => _136._pool, 'optionalAccess', _137 => _137.assertStorageIsWritable, 'call', _138 => _138()]);
     return this.insert(element, this.length);
   }
   /**
@@ -6463,7 +6556,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param index The index at which you want to insert the element.
    */
   insert(element, index) {
-    _optionalChain([this, 'access', _134 => _134._pool, 'optionalAccess', _135 => _135.assertStorageIsWritable, 'call', _136 => _136()]);
+    _optionalChain([this, 'access', _139 => _139._pool, 'optionalAccess', _140 => _140.assertStorageIsWritable, 'call', _141 => _141()]);
     if (index < 0 || index > this.#items.length) {
       throw new Error(
         `Cannot insert list item at index "${index}". index should be between 0 and ${this.#items.length}`
@@ -6493,7 +6586,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param targetIndex The index where the element should be after moving.
    */
   move(index, targetIndex) {
-    _optionalChain([this, 'access', _137 => _137._pool, 'optionalAccess', _138 => _138.assertStorageIsWritable, 'call', _139 => _139()]);
+    _optionalChain([this, 'access', _142 => _142._pool, 'optionalAccess', _143 => _143.assertStorageIsWritable, 'call', _144 => _144()]);
     if (targetIndex < 0) {
       throw new Error("targetIndex cannot be less than 0");
     }
@@ -6551,7 +6644,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param index The index of the element to delete
    */
   delete(index) {
-    _optionalChain([this, 'access', _140 => _140._pool, 'optionalAccess', _141 => _141.assertStorageIsWritable, 'call', _142 => _142()]);
+    _optionalChain([this, 'access', _145 => _145._pool, 'optionalAccess', _146 => _146.assertStorageIsWritable, 'call', _147 => _147()]);
     if (index < 0 || index >= this.#items.length) {
       throw new Error(
         `Cannot delete list item at index "${index}". index should be between 0 and ${this.#items.length - 1}`
@@ -6584,7 +6677,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   clear() {
-    _optionalChain([this, 'access', _143 => _143._pool, 'optionalAccess', _144 => _144.assertStorageIsWritable, 'call', _145 => _145()]);
+    _optionalChain([this, 'access', _148 => _148._pool, 'optionalAccess', _149 => _149.assertStorageIsWritable, 'call', _150 => _150()]);
     if (this._pool) {
       const ops = [];
       const reverseOps = [];
@@ -6618,7 +6711,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   set(index, item) {
-    _optionalChain([this, 'access', _146 => _146._pool, 'optionalAccess', _147 => _147.assertStorageIsWritable, 'call', _148 => _148()]);
+    _optionalChain([this, 'access', _151 => _151._pool, 'optionalAccess', _152 => _152.assertStorageIsWritable, 'call', _153 => _153()]);
     if (index < 0 || index >= this.#items.length) {
       throw new Error(
         `Cannot set list item at index "${index}". index should be between 0 and ${this.#items.length - 1}`
@@ -6764,7 +6857,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #shiftItemPosition(index, key) {
     const shiftedPosition = makePosition(
       key,
-      this.#items.length > index + 1 ? _optionalChain([this, 'access', _149 => _149.#items, 'access', _150 => _150[index + 1], 'optionalAccess', _151 => _151._parentPos]) : void 0
+      this.#items.length > index + 1 ? _optionalChain([this, 'access', _154 => _154.#items, 'access', _155 => _155[index + 1], 'optionalAccess', _156 => _156._parentPos]) : void 0
     );
     this.#items[index]._setParentLink(this, shiftedPosition);
   }
@@ -6889,7 +6982,7 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
     const ops = [];
     const op = {
       id: this._id,
-      opId: _optionalChain([pool, 'optionalAccess', _152 => _152.generateOpId, 'call', _153 => _153()]),
+      opId: _optionalChain([pool, 'optionalAccess', _157 => _157.generateOpId, 'call', _158 => _158()]),
       type: 7 /* CREATE_MAP */,
       parentId,
       parentKey
@@ -7024,7 +7117,7 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
    * @param value The value of the element to add. Should be serializable to JSON.
    */
   set(key, value) {
-    _optionalChain([this, 'access', _154 => _154._pool, 'optionalAccess', _155 => _155.assertStorageIsWritable, 'call', _156 => _156()]);
+    _optionalChain([this, 'access', _159 => _159._pool, 'optionalAccess', _160 => _160.assertStorageIsWritable, 'call', _161 => _161()]);
     const oldValue = this.#map.get(key);
     if (oldValue) {
       oldValue._detach();
@@ -7070,7 +7163,7 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
    * @returns true if an element existed and has been removed, or false if the element does not exist.
    */
   delete(key) {
-    _optionalChain([this, 'access', _157 => _157._pool, 'optionalAccess', _158 => _158.assertStorageIsWritable, 'call', _159 => _159()]);
+    _optionalChain([this, 'access', _162 => _162._pool, 'optionalAccess', _163 => _163.assertStorageIsWritable, 'call', _164 => _164()]);
     const item = this.#map.get(key);
     if (item === void 0) {
       return false;
@@ -7260,7 +7353,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
     if (this._id === void 0) {
       throw new Error("Cannot serialize item is not attached");
     }
-    const opId = _optionalChain([pool, 'optionalAccess', _160 => _160.generateOpId, 'call', _161 => _161()]);
+    const opId = _optionalChain([pool, 'optionalAccess', _165 => _165.generateOpId, 'call', _166 => _166()]);
     const ops = [];
     const op = {
       type: 4 /* CREATE_OBJECT */,
@@ -7532,7 +7625,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
    * @param value The value of the property to add
    */
   set(key, value) {
-    _optionalChain([this, 'access', _162 => _162._pool, 'optionalAccess', _163 => _163.assertStorageIsWritable, 'call', _164 => _164()]);
+    _optionalChain([this, 'access', _167 => _167._pool, 'optionalAccess', _168 => _168.assertStorageIsWritable, 'call', _169 => _169()]);
     this.update({ [key]: value });
   }
   /**
@@ -7547,7 +7640,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
    * @param key The key of the property to delete
    */
   delete(key) {
-    _optionalChain([this, 'access', _165 => _165._pool, 'optionalAccess', _166 => _166.assertStorageIsWritable, 'call', _167 => _167()]);
+    _optionalChain([this, 'access', _170 => _170._pool, 'optionalAccess', _171 => _171.assertStorageIsWritable, 'call', _172 => _172()]);
     const keyAsString = key;
     const oldValue = this.#map.get(keyAsString);
     if (oldValue === void 0) {
@@ -7600,7 +7693,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
    * @param patch The object used to overrides properties
    */
   update(patch) {
-    _optionalChain([this, 'access', _168 => _168._pool, 'optionalAccess', _169 => _169.assertStorageIsWritable, 'call', _170 => _170()]);
+    _optionalChain([this, 'access', _173 => _173._pool, 'optionalAccess', _174 => _174.assertStorageIsWritable, 'call', _175 => _175()]);
     if (_LiveObject.detectLargeObjects) {
       const data = {};
       for (const [key, value] of this.#map) {
@@ -8348,15 +8441,15 @@ function installBackgroundTabSpy() {
   const doc = typeof document !== "undefined" ? document : void 0;
   const inBackgroundSince = { current: null };
   function onVisibilityChange() {
-    if (_optionalChain([doc, 'optionalAccess', _171 => _171.visibilityState]) === "hidden") {
+    if (_optionalChain([doc, 'optionalAccess', _176 => _176.visibilityState]) === "hidden") {
       inBackgroundSince.current = _nullishCoalesce(inBackgroundSince.current, () => ( Date.now()));
     } else {
       inBackgroundSince.current = null;
     }
   }
-  _optionalChain([doc, 'optionalAccess', _172 => _172.addEventListener, 'call', _173 => _173("visibilitychange", onVisibilityChange)]);
+  _optionalChain([doc, 'optionalAccess', _177 => _177.addEventListener, 'call', _178 => _178("visibilitychange", onVisibilityChange)]);
   const unsub = () => {
-    _optionalChain([doc, 'optionalAccess', _174 => _174.removeEventListener, 'call', _175 => _175("visibilitychange", onVisibilityChange)]);
+    _optionalChain([doc, 'optionalAccess', _179 => _179.removeEventListener, 'call', _180 => _180("visibilitychange", onVisibilityChange)]);
   };
   return [inBackgroundSince, unsub];
 }
@@ -8536,7 +8629,7 @@ function createRoom(options, config) {
     }
   }
   function isStorageWritable() {
-    const scopes = _optionalChain([context, 'access', _176 => _176.dynamicSessionInfoSig, 'access', _177 => _177.get, 'call', _178 => _178(), 'optionalAccess', _179 => _179.scopes]);
+    const scopes = _optionalChain([context, 'access', _181 => _181.dynamicSessionInfoSig, 'access', _182 => _182.get, 'call', _183 => _183(), 'optionalAccess', _184 => _184.scopes]);
     return scopes !== void 0 ? canWriteStorage(scopes) : true;
   }
   const eventHub = {
@@ -8555,8 +8648,8 @@ function createRoom(options, config) {
     comments: makeEventSource(),
     roomWillDestroy: makeEventSource()
   };
-  async function createTextMention(userId, mentionId) {
-    return httpClient.createTextMention({ roomId, userId, mentionId });
+  async function createTextMention(mentionId, mention) {
+    return httpClient.createTextMention({ roomId, mentionId, mention });
   }
   async function deleteTextMention(mentionId) {
     return httpClient.deleteTextMention({ roomId, mentionId });
@@ -8662,7 +8755,7 @@ function createRoom(options, config) {
       }
       case "experimental-fallback-to-http": {
         warn("Message is too large for websockets, so sending over HTTP instead");
-        const nonce = _nullishCoalesce(_optionalChain([context, 'access', _180 => _180.dynamicSessionInfoSig, 'access', _181 => _181.get, 'call', _182 => _182(), 'optionalAccess', _183 => _183.nonce]), () => ( raise("Session is not authorized to send message over HTTP")));
+        const nonce = _nullishCoalesce(_optionalChain([context, 'access', _185 => _185.dynamicSessionInfoSig, 'access', _186 => _186.get, 'call', _187 => _187(), 'optionalAccess', _188 => _188.nonce]), () => ( raise("Session is not authorized to send message over HTTP")));
         void httpClient.sendMessages({ roomId, nonce, messages }).then((resp) => {
           if (!resp.ok && resp.status === 403) {
             managedSocket.reconnect();
@@ -8713,7 +8806,7 @@ function createRoom(options, config) {
     } else {
       context.root = LiveObject._fromItems(message.items, context.pool);
     }
-    const canWrite = _nullishCoalesce(_optionalChain([self, 'access', _184 => _184.get, 'call', _185 => _185(), 'optionalAccess', _186 => _186.canWrite]), () => ( true));
+    const canWrite = _nullishCoalesce(_optionalChain([self, 'access', _189 => _189.get, 'call', _190 => _190(), 'optionalAccess', _191 => _191.canWrite]), () => ( true));
     const stackSizeBefore = context.undoStack.length;
     for (const key in context.initialStorage) {
       if (context.root.get(key) === void 0) {
@@ -8916,7 +9009,7 @@ function createRoom(options, config) {
     }
     context.myPresence.patch(patch);
     if (context.activeBatch) {
-      if (_optionalChain([options2, 'optionalAccess', _187 => _187.addToHistory])) {
+      if (_optionalChain([options2, 'optionalAccess', _192 => _192.addToHistory])) {
         context.activeBatch.reverseOps.pushLeft({
           type: "presence",
           data: oldValues
@@ -8925,7 +9018,7 @@ function createRoom(options, config) {
       context.activeBatch.updates.presence = true;
     } else {
       flushNowOrSoon();
-      if (_optionalChain([options2, 'optionalAccess', _188 => _188.addToHistory])) {
+      if (_optionalChain([options2, 'optionalAccess', _193 => _193.addToHistory])) {
         addToUndoStack([{ type: "presence", data: oldValues }]);
       }
       notify({ presence: true });
@@ -9122,7 +9215,7 @@ function createRoom(options, config) {
           if (process.env.NODE_ENV !== "production") {
             const traces = /* @__PURE__ */ new Set();
             for (const opId of message.opIds) {
-              const trace = _optionalChain([context, 'access', _189 => _189.opStackTraces, 'optionalAccess', _190 => _190.get, 'call', _191 => _191(opId)]);
+              const trace = _optionalChain([context, 'access', _194 => _194.opStackTraces, 'optionalAccess', _195 => _195.get, 'call', _196 => _196(opId)]);
               if (trace) {
                 traces.add(trace);
               }
@@ -9256,7 +9349,7 @@ ${Array.from(traces).join("\n\n")}`
     const unacknowledgedOps = new Map(context.unacknowledgedOps);
     createOrUpdateRootFromMessage(message);
     applyAndSendOps(unacknowledgedOps);
-    _optionalChain([_resolveStoragePromise, 'optionalCall', _192 => _192()]);
+    _optionalChain([_resolveStoragePromise, 'optionalCall', _197 => _197()]);
     notifyStorageStatus();
     eventHub.storageDidLoad.notify();
   }
@@ -9477,8 +9570,8 @@ ${Array.from(traces).join("\n\n")}`
   async function getThreads(options2) {
     return httpClient.getThreads({
       roomId,
-      query: _optionalChain([options2, 'optionalAccess', _193 => _193.query]),
-      cursor: _optionalChain([options2, 'optionalAccess', _194 => _194.cursor])
+      query: _optionalChain([options2, 'optionalAccess', _198 => _198.query]),
+      cursor: _optionalChain([options2, 'optionalAccess', _199 => _199.cursor])
     });
   }
   async function getThread(threadId) {
@@ -9585,7 +9678,7 @@ ${Array.from(traces).join("\n\n")}`
   function getSubscriptionSettings(options2) {
     return httpClient.getSubscriptionSettings({
       roomId,
-      signal: _optionalChain([options2, 'optionalAccess', _195 => _195.signal])
+      signal: _optionalChain([options2, 'optionalAccess', _200 => _200.signal])
     });
   }
   function updateSubscriptionSettings(settings) {
@@ -9607,7 +9700,7 @@ ${Array.from(traces).join("\n\n")}`
     {
       [kInternal]: {
         get presenceBuffer() {
-          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _196 => _196.buffer, 'access', _197 => _197.presenceUpdates, 'optionalAccess', _198 => _198.data]), () => ( null)));
+          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _201 => _201.buffer, 'access', _202 => _202.presenceUpdates, 'optionalAccess', _203 => _203.data]), () => ( null)));
         },
         // prettier-ignore
         get undoStack() {
@@ -9622,9 +9715,9 @@ ${Array.from(traces).join("\n\n")}`
           return context.yjsProvider;
         },
         setYjsProvider(newProvider) {
-          _optionalChain([context, 'access', _199 => _199.yjsProvider, 'optionalAccess', _200 => _200.off, 'call', _201 => _201("status", yjsStatusDidChange)]);
+          _optionalChain([context, 'access', _204 => _204.yjsProvider, 'optionalAccess', _205 => _205.off, 'call', _206 => _206("status", yjsStatusDidChange)]);
           context.yjsProvider = newProvider;
-          _optionalChain([newProvider, 'optionalAccess', _202 => _202.on, 'call', _203 => _203("status", yjsStatusDidChange)]);
+          _optionalChain([newProvider, 'optionalAccess', _207 => _207.on, 'call', _208 => _208("status", yjsStatusDidChange)]);
           context.yjsProviderDidChange.notify();
         },
         yjsProviderDidChange: context.yjsProviderDidChange.observable,
@@ -9670,7 +9763,7 @@ ${Array.from(traces).join("\n\n")}`
           source.dispose();
         }
         eventHub.roomWillDestroy.notify();
-        _optionalChain([context, 'access', _204 => _204.yjsProvider, 'optionalAccess', _205 => _205.off, 'call', _206 => _206("status", yjsStatusDidChange)]);
+        _optionalChain([context, 'access', _209 => _209.yjsProvider, 'optionalAccess', _210 => _210.off, 'call', _211 => _211("status", yjsStatusDidChange)]);
         syncSourceForStorage.destroy();
         syncSourceForYjs.destroy();
         uninstallBgTabSpy();
@@ -9820,7 +9913,7 @@ function makeClassicSubscribeFn(roomId, events, errorEvents) {
     }
     if (isLiveNode(first)) {
       const node = first;
-      if (_optionalChain([options, 'optionalAccess', _207 => _207.isDeep])) {
+      if (_optionalChain([options, 'optionalAccess', _212 => _212.isDeep])) {
         const storageCallback = second;
         return subscribeToLiveStructureDeeply(node, storageCallback);
       } else {
@@ -9877,6 +9970,7 @@ var MAX_LOST_CONNECTION_TIMEOUT = 3e4;
 var DEFAULT_LOST_CONNECTION_TIMEOUT = 5e3;
 var RESOLVE_USERS_BATCH_DELAY = 50;
 var RESOLVE_ROOMS_INFO_BATCH_DELAY = 50;
+var RESOLVE_GROUPS_INFO_BATCH_DELAY = 50;
 function getBaseUrl(baseUrl) {
   if (typeof baseUrl === "string" && baseUrl.startsWith("http")) {
     return baseUrl;
@@ -9899,8 +9993,8 @@ function createClient(options) {
     const userId = token.k === "sec-legacy" /* SECRET_LEGACY */ ? token.id : token.uid;
     currentUserId.set(() => userId);
   });
-  const fetchPolyfill = _optionalChain([clientOptions, 'access', _208 => _208.polyfills, 'optionalAccess', _209 => _209.fetch]) || /* istanbul ignore next */
-  _optionalChain([globalThis, 'access', _210 => _210.fetch, 'optionalAccess', _211 => _211.bind, 'call', _212 => _212(globalThis)]);
+  const fetchPolyfill = _optionalChain([clientOptions, 'access', _213 => _213.polyfills, 'optionalAccess', _214 => _214.fetch]) || /* istanbul ignore next */
+  _optionalChain([globalThis, 'access', _215 => _215.fetch, 'optionalAccess', _216 => _216.bind, 'call', _217 => _217(globalThis)]);
   const httpClient = createApiClient({
     baseUrl,
     fetchPolyfill,
@@ -9918,7 +10012,7 @@ function createClient(options) {
     delegates: {
       createSocket: makeCreateSocketDelegateForAi(
         baseUrl,
-        _optionalChain([clientOptions, 'access', _213 => _213.polyfills, 'optionalAccess', _214 => _214.WebSocket])
+        _optionalChain([clientOptions, 'access', _218 => _218.polyfills, 'optionalAccess', _219 => _219.WebSocket])
       ),
       authenticate: async () => {
         const resp = await authManager.getAuthValue({
@@ -9986,7 +10080,7 @@ function createClient(options) {
           createSocket: makeCreateSocketDelegateForRoom(
             roomId,
             baseUrl,
-            _optionalChain([clientOptions, 'access', _215 => _215.polyfills, 'optionalAccess', _216 => _216.WebSocket])
+            _optionalChain([clientOptions, 'access', _220 => _220.polyfills, 'optionalAccess', _221 => _221.WebSocket])
           ),
           authenticate: makeAuthDelegateForRoom(roomId, authManager)
         })),
@@ -10009,7 +10103,7 @@ function createClient(options) {
     const shouldConnect = _nullishCoalesce(options2.autoConnect, () => ( true));
     if (shouldConnect) {
       if (typeof atob === "undefined") {
-        if (_optionalChain([clientOptions, 'access', _217 => _217.polyfills, 'optionalAccess', _218 => _218.atob]) === void 0) {
+        if (_optionalChain([clientOptions, 'access', _222 => _222.polyfills, 'optionalAccess', _223 => _223.atob]) === void 0) {
           throw new Error(
             "You need to polyfill atob to use the client in your environment. Please follow the instructions at https://liveblocks.io/docs/errors/liveblocks-client/atob-polyfill"
           );
@@ -10021,7 +10115,7 @@ function createClient(options) {
     return leaseRoom(newRoomDetails);
   }
   function getRoom(roomId) {
-    const room = _optionalChain([roomsById, 'access', _219 => _219.get, 'call', _220 => _220(roomId), 'optionalAccess', _221 => _221.room]);
+    const room = _optionalChain([roomsById, 'access', _224 => _224.get, 'call', _225 => _225(roomId), 'optionalAccess', _226 => _226.room]);
     return room ? room : null;
   }
   function logout() {
@@ -10034,15 +10128,14 @@ function createClient(options) {
     }
   }
   const resolveUsers = clientOptions.resolveUsers;
-  const warnIfNoResolveUsers = createDevelopmentWarning(
-    () => !resolveUsers,
-    "Set the resolveUsers option in createClient to specify user info."
-  );
   const batchedResolveUsers = new Batch(
     async (batchedUserIds) => {
       const userIds = batchedUserIds.flat();
-      const users = await _optionalChain([resolveUsers, 'optionalCall', _222 => _222({ userIds })]);
-      warnIfNoResolveUsers();
+      const users = await _optionalChain([resolveUsers, 'optionalCall', _227 => _227({ userIds })]);
+      warnOnceIf(
+        !resolveUsers,
+        "Set the resolveUsers option in createClient to specify user info."
+      );
       return _nullishCoalesce(users, () => ( userIds.map(() => void 0)));
     },
     { delay: RESOLVE_USERS_BATCH_DELAY }
@@ -10052,15 +10145,14 @@ function createClient(options) {
     usersStore.invalidate(userIds);
   }
   const resolveRoomsInfo = clientOptions.resolveRoomsInfo;
-  const warnIfNoResolveRoomsInfo = createDevelopmentWarning(
-    () => !resolveRoomsInfo,
-    "Set the resolveRoomsInfo option in createClient to specify room info."
-  );
   const batchedResolveRoomsInfo = new Batch(
     async (batchedRoomIds) => {
       const roomIds = batchedRoomIds.flat();
-      const roomsInfo = await _optionalChain([resolveRoomsInfo, 'optionalCall', _223 => _223({ roomIds })]);
-      warnIfNoResolveRoomsInfo();
+      const roomsInfo = await _optionalChain([resolveRoomsInfo, 'optionalCall', _228 => _228({ roomIds })]);
+      warnOnceIf(
+        !resolveRoomsInfo,
+        "Set the resolveRoomsInfo option in createClient to specify room info."
+      );
       return _nullishCoalesce(roomsInfo, () => ( roomIds.map(() => void 0)));
     },
     { delay: RESOLVE_ROOMS_INFO_BATCH_DELAY }
@@ -10069,6 +10161,23 @@ function createClient(options) {
   function invalidateResolvedRoomsInfo(roomIds) {
     roomsInfoStore.invalidate(roomIds);
   }
+  const resolveGroupsInfo = clientOptions.resolveGroupsInfo;
+  const batchedResolveGroupsInfo = new Batch(
+    async (batchedGroupIds) => {
+      const groupIds = batchedGroupIds.flat();
+      const groupsInfo = await _optionalChain([resolveGroupsInfo, 'optionalCall', _229 => _229({ groupIds })]);
+      warnOnceIf(
+        !resolveGroupsInfo,
+        "Set the resolveGroupsInfo option in createClient to specify group info."
+      );
+      return _nullishCoalesce(groupsInfo, () => ( groupIds.map(() => void 0)));
+    },
+    { delay: RESOLVE_GROUPS_INFO_BATCH_DELAY }
+  );
+  const groupsInfoStore = createBatchStore(batchedResolveGroupsInfo);
+  function invalidateResolvedGroupsInfo(groupIds) {
+    groupsInfoStore.invalidate(groupIds);
+  }
   const mentionSuggestionsCache = /* @__PURE__ */ new Map();
   function invalidateResolvedMentionSuggestions() {
     mentionSuggestionsCache.clear();
@@ -10112,7 +10221,7 @@ function createClient(options) {
       }
     };
     const win = typeof window !== "undefined" ? window : void 0;
-    _optionalChain([win, 'optionalAccess', _224 => _224.addEventListener, 'call', _225 => _225("beforeunload", maybePreventClose)]);
+    _optionalChain([win, 'optionalAccess', _230 => _230.addEventListener, 'call', _231 => _231("beforeunload", maybePreventClose)]);
   }
   async function getNotificationSettings(options2) {
     const plainSettings = await httpClient.getNotificationSettings(options2);
@@ -10144,6 +10253,7 @@ function createClient(options) {
       resolvers: {
         invalidateUsers: invalidateResolvedUsers,
         invalidateRoomsInfo: invalidateResolvedRoomsInfo,
+        invalidateGroupsInfo: invalidateResolvedGroupsInfo,
         invalidateMentionSuggestions: invalidateResolvedMentionSuggestions
       },
       getSyncStatus,
@@ -10159,6 +10269,7 @@ function createClient(options) {
         resolveMentionSuggestions: clientOptions.resolveMentionSuggestions,
         usersStore,
         roomsInfoStore,
+        groupsInfoStore,
         getRoomIds() {
           return Array.from(roomsById.keys());
         },
@@ -10210,20 +10321,6 @@ function getLostConnectionTimeout(value) {
     RECOMMENDED_MIN_LOST_CONNECTION_TIMEOUT
   );
 }
-function createDevelopmentWarning(condition, ...args) {
-  let hasWarned = false;
-  if (process.env.NODE_ENV !== "production") {
-    return () => {
-      if (!hasWarned && (typeof condition === "function" ? condition() : condition)) {
-        warn(...args);
-        hasWarned = true;
-      }
-    };
-  } else {
-    return () => {
-    };
-  }
-}
 
 // src/comments/comment-body.ts
 function isCommentBodyParagraph(element) {
@@ -10251,7 +10348,7 @@ var commentBodyElementsTypes = {
   mention: "inline"
 };
 function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
-  if (!body || !_optionalChain([body, 'optionalAccess', _226 => _226.content])) {
+  if (!body || !_optionalChain([body, 'optionalAccess', _232 => _232.content])) {
     return;
   }
   const element = typeof elementOrVisitor === "string" ? elementOrVisitor : void 0;
@@ -10261,13 +10358,13 @@ function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
   for (const block of body.content) {
     if (type === "all" || type === "block") {
       if (guard(block)) {
-        _optionalChain([visitor, 'optionalCall', _227 => _227(block)]);
+        _optionalChain([visitor, 'optionalCall', _233 => _233(block)]);
       }
     }
     if (type === "all" || type === "inline") {
       for (const inline of block.children) {
         if (guard(inline)) {
-          _optionalChain([visitor, 'optionalCall', _228 => _228(inline)]);
+          _optionalChain([visitor, 'optionalCall', _234 => _234(inline)]);
         }
       }
     }
@@ -10288,25 +10385,42 @@ function getMentionsFromCommentBody(body, predicate) {
   });
   return mentions;
 }
-async function resolveUsersInCommentBody(body, resolveUsers) {
+async function resolveMentionsInCommentBody(body, resolveUsers, resolveGroupsInfo) {
   const resolvedUsers = /* @__PURE__ */ new Map();
-  if (!resolveUsers) {
-    return resolvedUsers;
+  const resolvedGroupsInfo = /* @__PURE__ */ new Map();
+  if (!resolveUsers && !resolveGroupsInfo) {
+    return {
+      users: resolvedUsers,
+      groups: resolvedGroupsInfo
+    };
   }
-  const userIds = getMentionsFromCommentBody(
-    body,
-    (mention) => mention.kind === "user"
-  ).map((mention) => mention.id);
-  const users = await resolveUsers({
-    userIds
-  });
-  for (const [index, userId] of userIds.entries()) {
-    const user = _optionalChain([users, 'optionalAccess', _229 => _229[index]]);
-    if (user) {
-      resolvedUsers.set(userId, user);
+  const mentions = getMentionsFromCommentBody(body);
+  const userIds = mentions.filter((mention) => mention.kind === "user").map((mention) => mention.id);
+  const groupIds = mentions.filter((mention) => mention.kind === "group").map((mention) => mention.id);
+  const [users, groups] = await Promise.all([
+    resolveUsers && userIds.length > 0 ? resolveUsers({ userIds }) : void 0,
+    resolveGroupsInfo && groupIds.length > 0 ? resolveGroupsInfo({ groupIds }) : void 0
+  ]);
+  if (users) {
+    for (const [index, userId] of userIds.entries()) {
+      const user = users[index];
+      if (user) {
+        resolvedUsers.set(userId, user);
+      }
+    }
+  }
+  if (groups) {
+    for (const [index, groupId] of groupIds.entries()) {
+      const group = groups[index];
+      if (group) {
+        resolvedGroupsInfo.set(groupId, group);
+      }
     }
   }
-  return resolvedUsers;
+  return {
+    users: resolvedUsers,
+    groups: resolvedGroupsInfo
+  };
 }
 var htmlEscapables = {
   "&": "&amp;",
@@ -10419,8 +10533,8 @@ var stringifyCommentBodyPlainElements = {
   paragraph: ({ children }) => children,
   text: ({ element }) => element.text,
   link: ({ element }) => _nullishCoalesce(element.text, () => ( element.url)),
-  mention: ({ element, user }) => {
-    return `@${_nullishCoalesce(_optionalChain([user, 'optionalAccess', _230 => _230.name]), () => ( element.id))}`;
+  mention: ({ element, user, group }) => {
+    return `@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _235 => _235.name]), () => ( _optionalChain([group, 'optionalAccess', _236 => _236.name]))), () => ( element.id))}`;
   }
 };
 var stringifyCommentBodyHtmlElements = {
@@ -10449,8 +10563,8 @@ var stringifyCommentBodyHtmlElements = {
   link: ({ element, href }) => {
     return html`<a href="${href}" target="_blank" rel="noopener noreferrer">${element.text ? html`${element.text}` : element.url}</a>`;
   },
-  mention: ({ element, user }) => {
-    return html`<span data-mention>@${_optionalChain([user, 'optionalAccess', _231 => _231.name]) ? html`${_optionalChain([user, 'optionalAccess', _232 => _232.name])}` : element.id}</span>`;
+  mention: ({ element, user, group }) => {
+    return html`<span data-mention>@${_optionalChain([user, 'optionalAccess', _237 => _237.name]) ? html`${_optionalChain([user, 'optionalAccess', _238 => _238.name])}` : _optionalChain([group, 'optionalAccess', _239 => _239.name]) ? html`${_optionalChain([group, 'optionalAccess', _240 => _240.name])}` : element.id}</span>`;
   }
 };
 var stringifyCommentBodyMarkdownElements = {
@@ -10479,20 +10593,21 @@ var stringifyCommentBodyMarkdownElements = {
   link: ({ element, href }) => {
     return markdown`[${_nullishCoalesce(element.text, () => ( element.url))}](${href})`;
   },
-  mention: ({ element, user }) => {
-    return markdown`@${_nullishCoalesce(_optionalChain([user, 'optionalAccess', _233 => _233.name]), () => ( element.id))}`;
+  mention: ({ element, user, group }) => {
+    return markdown`@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _241 => _241.name]), () => ( _optionalChain([group, 'optionalAccess', _242 => _242.name]))), () => ( element.id))}`;
   }
 };
 async function stringifyCommentBody(body, options) {
-  const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _234 => _234.format]), () => ( "plain"));
-  const separator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _235 => _235.separator]), () => ( (format === "markdown" ? "\n\n" : "\n")));
+  const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _243 => _243.format]), () => ( "plain"));
+  const separator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _244 => _244.separator]), () => ( (format === "markdown" ? "\n\n" : "\n")));
   const elements = {
     ...format === "html" ? stringifyCommentBodyHtmlElements : format === "markdown" ? stringifyCommentBodyMarkdownElements : stringifyCommentBodyPlainElements,
-    ..._optionalChain([options, 'optionalAccess', _236 => _236.elements])
+    ..._optionalChain([options, 'optionalAccess', _245 => _245.elements])
   };
-  const resolvedUsers = await resolveUsersInCommentBody(
+  const { users: resolvedUsers, groups: resolvedGroupsInfo } = await resolveMentionsInCommentBody(
     body,
-    _optionalChain([options, 'optionalAccess', _237 => _237.resolveUsers])
+    _optionalChain([options, 'optionalAccess', _246 => _246.resolveUsers]),
+    _optionalChain([options, 'optionalAccess', _247 => _247.resolveGroupsInfo])
   );
   const blocks = body.content.flatMap((block, blockIndex) => {
     switch (block.type) {
@@ -10503,7 +10618,8 @@ async function stringifyCommentBody(body, options) {
               elements.mention(
                 {
                   element: inline,
-                  user: resolvedUsers.get(inline.id)
+                  user: inline.kind === "user" ? resolvedUsers.get(inline.id) : void 0,
+                  group: inline.kind === "group" ? resolvedGroupsInfo.get(inline.id) : void 0
                 },
                 inlineIndex
               )
@@ -10778,12 +10894,12 @@ function legacy_patchImmutableNode(state, path, update) {
         }
         const newState = Object.assign({}, state);
         for (const key in update.updates) {
-          if (_optionalChain([update, 'access', _238 => _238.updates, 'access', _239 => _239[key], 'optionalAccess', _240 => _240.type]) === "update") {
+          if (_optionalChain([update, 'access', _248 => _248.updates, 'access', _249 => _249[key], 'optionalAccess', _250 => _250.type]) === "update") {
             const val = update.node.get(key);
             if (val !== void 0) {
               newState[key] = lsonToJson(val);
             }
-          } else if (_optionalChain([update, 'access', _241 => _241.updates, 'access', _242 => _242[key], 'optionalAccess', _243 => _243.type]) === "delete") {
+          } else if (_optionalChain([update, 'access', _251 => _251.updates, 'access', _252 => _252[key], 'optionalAccess', _253 => _253.type]) === "delete") {
             delete newState[key];
           }
         }
@@ -10844,12 +10960,12 @@ function legacy_patchImmutableNode(state, path, update) {
         }
         const newState = Object.assign({}, state);
         for (const key in update.updates) {
-          if (_optionalChain([update, 'access', _244 => _244.updates, 'access', _245 => _245[key], 'optionalAccess', _246 => _246.type]) === "update") {
+          if (_optionalChain([update, 'access', _254 => _254.updates, 'access', _255 => _255[key], 'optionalAccess', _256 => _256.type]) === "update") {
             const value = update.node.get(key);
             if (value !== void 0) {
               newState[key] = lsonToJson(value);
             }
-          } else if (_optionalChain([update, 'access', _247 => _247.updates, 'access', _248 => _248[key], 'optionalAccess', _249 => _249.type]) === "delete") {
+          } else if (_optionalChain([update, 'access', _257 => _257.updates, 'access', _258 => _258[key], 'optionalAccess', _259 => _259.type]) === "delete") {
             delete newState[key];
           }
         }
@@ -10929,9 +11045,9 @@ function makePoller(callback, intervalMs, options) {
   const startTime = performance.now();
   const doc = typeof document !== "undefined" ? document : void 0;
   const win = typeof window !== "undefined" ? window : void 0;
-  const maxStaleTimeMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _250 => _250.maxStaleTimeMs]), () => ( Number.POSITIVE_INFINITY));
+  const maxStaleTimeMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _260 => _260.maxStaleTimeMs]), () => ( Number.POSITIVE_INFINITY));
   const context = {
-    inForeground: _optionalChain([doc, 'optionalAccess', _251 => _251.visibilityState]) !== "hidden",
+    inForeground: _optionalChain([doc, 'optionalAccess', _261 => _261.visibilityState]) !== "hidden",
     lastSuccessfulPollAt: startTime,
     count: 0,
     backoff: 0
@@ -11012,11 +11128,11 @@ function makePoller(callback, intervalMs, options) {
     pollNowIfStale();
   }
   function onVisibilityChange() {
-    setInForeground(_optionalChain([doc, 'optionalAccess', _252 => _252.visibilityState]) !== "hidden");
+    setInForeground(_optionalChain([doc, 'optionalAccess', _262 => _262.visibilityState]) !== "hidden");
   }
-  _optionalChain([doc, 'optionalAccess', _253 => _253.addEventListener, 'call', _254 => _254("visibilitychange", onVisibilityChange)]);
-  _optionalChain([win, 'optionalAccess', _255 => _255.addEventListener, 'call', _256 => _256("online", onVisibilityChange)]);
-  _optionalChain([win, 'optionalAccess', _257 => _257.addEventListener, 'call', _258 => _258("focus", pollNowIfStale)]);
+  _optionalChain([doc, 'optionalAccess', _263 => _263.addEventListener, 'call', _264 => _264("visibilitychange", onVisibilityChange)]);
+  _optionalChain([win, 'optionalAccess', _265 => _265.addEventListener, 'call', _266 => _266("online", onVisibilityChange)]);
+  _optionalChain([win, 'optionalAccess', _267 => _267.addEventListener, 'call', _268 => _268("focus", pollNowIfStale)]);
   fsm.start();
   return {
     inc,
@@ -11146,5 +11262,9 @@ detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
 
 
 
-exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.DefaultMap = DefaultMap; exports.Deque = Deque; exports.DerivedSignal = DerivedSignal; exports.HttpError = HttpError; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.LiveblocksError = LiveblocksError; exports.MutableSignal = MutableSignal; exports.OpCode = OpCode; exports.Permission = Permission; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.Signal = Signal; exports.SortedList = SortedList; exports.TextEditorType = TextEditorType; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.ackOp = ackOp; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.batch = batch; exports.checkBounds = checkBounds; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToSubscriptionData = convertToSubscriptionData; exports.convertToThreadData = convertToThreadData; exports.convertToUserSubscriptionData = convertToUserSubscriptionData; exports.createClient = createClient; exports.createCommentAttachmentId = createCommentAttachmentId; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createManagedPool = createManagedPool; exports.createNotificationSettings = createNotificationSettings; exports.createThreadId = createThreadId; exports.defineAiTool = defineAiTool; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.entries = entries; exports.errorIf = errorIf; exports.findLastIndex = findLastIndex; exports.freeze = freeze; exports.generateUrl = generateUrl; exports.getMentionsFromCommentBody = getMentionsFromCommentBody; exports.getSubscriptionKey = getSubscriptionKey; exports.html = html; exports.htmlSafe = htmlSafe; exports.isChildCrdt = isChildCrdt; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isLiveNode = isLiveNode; exports.isNotificationChannelEnabled = isNotificationChannelEnabled; exports.isPlainObject = isPlainObject; exports.isRootCrdt = isRootCrdt; exports.isStartsWithOperator = isStartsWithOperator; exports.isUrl = isUrl; exports.kInternal = kInternal; exports.keys = keys; exports.legacy_patchImmutableObject = legacy_patchImmutableObject; exports.lsonToJson = lsonToJson; exports.makeAbortController = makeAbortController; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.nanoid = nanoid; exports.nn = nn; exports.objectToQuery = objectToQuery; exports.patchLiveObjectKey = patchLiveObjectKey; exports.patchNotificationSettings = patchNotificationSettings; exports.raise = raise; exports.resolveUsersInCommentBody = resolveUsersInCommentBody; exports.sanitizeUrl = sanitizeUrl; exports.shallow = shallow; exports.shallow2 = shallow2; exports.stableStringify = stableStringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.wait = wait; exports.withTimeout = withTimeout;
+
+
+
+
+exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.DefaultMap = DefaultMap; exports.Deque = Deque; exports.DerivedSignal = DerivedSignal; exports.HttpError = HttpError; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.LiveblocksError = LiveblocksError; exports.MENTION_CHARACTER = MENTION_CHARACTER; exports.MutableSignal = MutableSignal; exports.OpCode = OpCode; exports.Permission = Permission; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.Signal = Signal; exports.SortedList = SortedList; exports.TextEditorType = TextEditorType; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.ackOp = ackOp; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.batch = batch; exports.checkBounds = checkBounds; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToGroupData = convertToGroupData; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToSubscriptionData = convertToSubscriptionData; exports.convertToThreadData = convertToThreadData; exports.convertToUserSubscriptionData = convertToUserSubscriptionData; exports.createClient = createClient; exports.createCommentAttachmentId = createCommentAttachmentId; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createManagedPool = createManagedPool; exports.createNotificationSettings = createNotificationSettings; exports.createThreadId = createThreadId; exports.defineAiTool = defineAiTool; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.entries = entries; exports.errorIf = errorIf; exports.findLastIndex = findLastIndex; exports.freeze = freeze; exports.generateUrl = generateUrl; exports.getMentionsFromCommentBody = getMentionsFromCommentBody; exports.getSubscriptionKey = getSubscriptionKey; exports.html = html; exports.htmlSafe = htmlSafe; exports.isChildCrdt = isChildCrdt; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isLiveNode = isLiveNode; exports.isNotificationChannelEnabled = isNotificationChannelEnabled; exports.isPlainObject = isPlainObject; exports.isRootCrdt = isRootCrdt; exports.isStartsWithOperator = isStartsWithOperator; exports.isUrl = isUrl; exports.kInternal = kInternal; exports.keys = keys; exports.legacy_patchImmutableObject = legacy_patchImmutableObject; exports.lsonToJson = lsonToJson; exports.makeAbortController = makeAbortController; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.nanoid = nanoid; exports.nn = nn; exports.objectToQuery = objectToQuery; exports.patchLiveObjectKey = patchLiveObjectKey; exports.patchNotificationSettings = patchNotificationSettings; exports.raise = raise; exports.resolveMentionsInCommentBody = resolveMentionsInCommentBody; exports.sanitizeUrl = sanitizeUrl; exports.shallow = shallow; exports.shallow2 = shallow2; exports.stableStringify = stableStringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.wait = wait; exports.warnOnce = warnOnce; exports.warnOnceIf = warnOnceIf; exports.withTimeout = withTimeout;
 //# sourceMappingURL=index.cjs.map