@liveblocks/react 2.25.0-aiprivatebeta1 → 2.25.0-aiprivatebeta11

package/dist/{chunk-E6PCFJWE.js → chunk-X7TWWGKZ.js}

@@ -1,5 +1,13 @@
 // src/contexts.ts
+import { raise } from "@liveblocks/core";
 import { createContext, useContext } from "react";
+var ClientContext = createContext(null);
+function useClientOrNull() {
+  return useContext(ClientContext);
+}
+function useClient() {
+  return useClientOrNull() ?? raise("LiveblocksProvider is missing from the React tree.");
+}
 var RoomContext = createContext(null);
 function useRoomOrNull() {
   return useContext(RoomContext);
@@ -9,10 +17,54 @@ function useIsInsideRoom() {
   return room !== null;
 }
 
+// src/ai.tsx
+import { kInternal, nanoid } from "@liveblocks/core";
+import { memo, useEffect, useId, useState } from "react";
+function useAi() {
+  return useClient()[kInternal].ai;
+}
+function useRandom() {
+  return useState(nanoid)[0];
+}
+var RegisterAiKnowledge = memo(function RegisterAiKnowledge2(props) {
+  const layerId = useId();
+  const ai = useAi();
+  const { description, value } = props;
+  const [layerKey, setLayerKey] = useState();
+  useEffect(() => {
+    const layerKey2 = ai.registerKnowledgeLayer(layerId);
+    setLayerKey(layerKey2);
+    return () => {
+      ai.deregisterKnowledgeLayer(layerKey2);
+      setLayerKey(void 0);
+    };
+  }, [ai, layerId]);
+  const randomKey = useRandom();
+  const knowledgeKey = props.id ?? randomKey;
+  useEffect(() => {
+    if (layerKey !== void 0) {
+      ai.updateKnowledge(layerKey, { description, value }, knowledgeKey);
+    }
+  }, [ai, layerKey, knowledgeKey, description, value]);
+  return null;
+});
+var RegisterAiTool = memo(function RegisterAiTool2({
+  chatId,
+  name,
+  tool
+}) {
+  const client = useClient();
+  const ai = client[kInternal].ai;
+  useEffect(() => {
+    return ai.registerTool(name, tool, chatId);
+  }, [ai, chatId, name, tool]);
+  return null;
+});
+
 // src/use-sync-external-store-with-selector.ts
 import {
   useDebugValue,
-  useEffect,
+  useEffect as useEffect2,
   useMemo,
   useRef,
   useSyncExternalStore
@@ -77,7 +129,7 @@ function useSyncExternalStoreWithSelector(subscribe, getSnapshot, getServerSnaps
     getSelection,
     getServerSelection
   );
-  useEffect(() => {
+  useEffect2(() => {
     inst.hasValue = true;
     inst.value = value;
   }, [value]);
@@ -104,24 +156,20 @@ function useSignal(signal, selector, isEqual) {
 }
 
 // src/liveblocks.tsx
-import {
-  HttpError
-} from "@liveblocks/core";
 import {
   assert,
   createClient,
-  kInternal as kInternal2,
+  HttpError,
+  kInternal as kInternal3,
   makePoller,
-  raise,
+  raise as raise2,
   shallow as shallow3
 } from "@liveblocks/core";
 import {
-  createContext as createContext2,
   useCallback as useCallback2,
-  useContext as useContext2,
-  useEffect as useEffect3,
+  useEffect as useEffect4,
   useMemo as useMemo2,
-  useState,
+  useState as useState2,
   useSyncExternalStore as useSyncExternalStore2
 } from "react";
 
@@ -183,10 +231,10 @@ function ensureNotServerSide() {
 import { useCallback, useReducer } from "react";
 
 // src/lib/use-latest.ts
-import { useEffect as useEffect2, useRef as useRef2 } from "react";
+import { useEffect as useEffect3, useRef as useRef2 } from "react";
 function useLatest(value) {
   const ref = useRef2(value);
-  useEffect2(() => {
+  useEffect3(() => {
     ref.current = value;
   }, [value]);
   return ref;
@@ -248,9 +296,9 @@ import {
   DerivedSignal,
   getMentionedIdsFromCommentBody,
   getSubscriptionKey,
-  kInternal,
+  kInternal as kInternal2,
   MutableSignal as MutableSignal3,
-  nanoid,
+  nanoid as nanoid2,
   nn,
   patchNotificationSettings,
   shallow,
@@ -746,21 +794,26 @@ function createStore_forHistoryVersions() {
   };
 }
 function createStore_forPermissionHints() {
-  const signal = new MutableSignal3(
-    new DefaultMap(() => /* @__PURE__ */ new Set())
+  const permissionsByRoomId = new DefaultMap(
+    () => new Signal(/* @__PURE__ */ new Set())
   );
   function update(newHints) {
-    signal.mutate((lut) => {
-      for (const [roomId, newPermissions] of Object.entries(newHints)) {
-        const existing = lut.getOrCreate(roomId);
-        for (const permission of newPermissions) {
-          existing.add(permission);
+    batch2(() => {
+      for (const [roomId, permissions] of Object.entries(newHints)) {
+        const signal = permissionsByRoomId.getOrCreate(roomId);
+        const existingPermissions = new Set(signal.get());
+        for (const permission of permissions) {
+          existingPermissions.add(permission);
         }
+        signal.set(existingPermissions);
       }
     });
   }
+  function getPermissionForRoom\u03A3(roomId) {
+    return permissionsByRoomId.getOrCreate(roomId);
+  }
   return {
-    signal: signal.asReadonly(),
+    getPermissionForRoom\u03A3,
     // Mutations
     update
   };
@@ -784,14 +837,14 @@ function createStore_forNotificationSettings(updates) {
 }
 function createStore_forOptimistic(client) {
   const signal = new Signal([]);
-  const syncSource = client[kInternal].createSyncSource();
+  const syncSource = client[kInternal2].createSyncSource();
   signal.subscribe(
     () => syncSource.setSyncStatus(
       signal.get().length > 0 ? "synchronizing" : "synchronized"
     )
   );
   function add(optimisticUpdate) {
-    const id = nanoid();
+    const id = nanoid2();
     const newUpdate = { ...optimisticUpdate, id };
     signal.set((state) => [...state, newUpdate]);
     return id;
@@ -875,7 +928,7 @@ var UmbrellaStore = class {
   // Copilot chats
   #aiChats;
   constructor(client) {
-    this.#client = client[kInternal].as();
+    this.#client = client[kInternal2].as();
     this.optimisticUpdates = createStore_forOptimistic(this.#client);
     this.permissionHints = createStore_forPermissionHints();
     this.#notificationsPaginationState = new PaginatedResource(
@@ -904,7 +957,7 @@ var UmbrellaStore = class {
       notificationSettingsFetcher
     );
     this.#aiChats = new PaginatedResource(async (cursor) => {
-      const result = await this.#client[kInternal].ai.getChats({
+      const result = await this.#client[kInternal2].ai.getChats({
         cursor
       });
       return result.nextCursor;
@@ -946,7 +999,7 @@ var UmbrellaStore = class {
       (queryKey) => {
         const query = JSON.parse(queryKey);
         const resource = new PaginatedResource(async (cursor) => {
-          const result = await this.#client[kInternal].httpClient.getUserThreads_experimental({
+          const result = await this.#client[kInternal2].httpClient.getUserThreads_experimental({
             cursor,
             query
           });
@@ -989,7 +1042,7 @@ var UmbrellaStore = class {
       (queryKey) => {
         const [roomId, query] = JSON.parse(queryKey);
         const resource = new PaginatedResource(async (cursor) => {
-          const result = await this.#client[kInternal].httpClient.getThreads({
+          const result = await this.#client[kInternal2].httpClient.getThreads({
             roomId,
             cursor,
             query
@@ -1078,7 +1131,7 @@ var UmbrellaStore = class {
           if (room === null) {
             throw new Error(`Room '${roomId}' is not available on client`);
           }
-          const result = await room[kInternal].listTextVersions();
+          const result = await room[kInternal2].listTextVersions();
           this.historyVersions.update(roomId, result.versions);
           const lastRequestedAt = this.#roomVersionsLastRequestedAtByRoom.get(roomId);
           if (lastRequestedAt === void 0 || lastRequestedAt > result.requestedAt) {
@@ -1123,7 +1176,7 @@ var UmbrellaStore = class {
         }
         return {
           isLoading: false,
-          chats: this.#client[kInternal].ai.signals.chats\u03A3.get(),
+          chats: this.#client[kInternal2].ai.signals.chats\u03A3.get(),
           hasFetchedAll: result.data.hasFetchedAll,
           isFetchingMore: result.data.isFetchingMore,
           fetchMore: result.data.fetchMore,
@@ -1134,7 +1187,7 @@ var UmbrellaStore = class {
     };
     const messagesByChatId = new DefaultMap((chatId) => {
       const resource\u03A3 = new SinglePageResource(async () => {
-        await this.#client[kInternal].ai.getMessageTree(chatId);
+        await this.#client[kInternal2].ai.getMessageTree(chatId);
       });
       return new DefaultMap(
         (branch) => {
@@ -1145,13 +1198,38 @@ var UmbrellaStore = class {
             }
             return ASYNC_OK(
               "messages",
-              this.#client[kInternal].ai.signals.getChatMessagesForBranch\u03A3(chatId, branch ?? void 0).get()
+              this.#client[kInternal2].ai.signals.getChatMessagesForBranch\u03A3(chatId, branch ?? void 0).get()
             );
           });
           return { signal, waitUntilLoaded: resource\u03A3.waitUntilLoaded };
         }
       );
     });
+    const aiChatById = new DefaultMap((chatId) => {
+      const resource = new SinglePageResource(async () => {
+        await this.#client[kInternal2].ai.getOrCreateChat(chatId);
+      });
+      const signal = DerivedSignal.from(() => {
+        const chat = this.#client[kInternal2].ai.getChatById(chatId);
+        if (chat === void 0) {
+          const result = resource.get();
+          if (result.isLoading || result.error) {
+            return result;
+          } else {
+            return ASYNC_OK(
+              "chat",
+              nn(this.#client[kInternal2].ai.getChatById(chatId))
+            );
+          }
+        } else {
+          return ASYNC_OK(
+            "chat",
+            nn(this.#client[kInternal2].ai.getChatById(chatId))
+          );
+        }
+      }, shallow);
+      return { signal, waitUntilLoaded: resource.waitUntilLoaded };
+    });
     this.outputs = {
       threadifications,
       threads,
@@ -1164,7 +1242,8 @@ var UmbrellaStore = class {
       notificationSettings,
       threadSubscriptions,
       aiChats,
-      messagesByChatId
+      messagesByChatId,
+      aiChatById
     };
     autobind(this);
   }
@@ -1370,7 +1449,7 @@ var UmbrellaStore = class {
     if (lastRequestedAt === void 0) {
       return;
     }
-    const updates = await this.#client[kInternal].httpClient.getThreadsSince({
+    const updates = await this.#client[kInternal2].httpClient.getThreadsSince({
       roomId,
       since: lastRequestedAt,
       signal
@@ -1393,7 +1472,7 @@ var UmbrellaStore = class {
     if (lastRequestedAt === null) {
       return;
     }
-    const result = await this.#client[kInternal].httpClient.getUserThreadsSince_experimental({
+    const result = await this.#client[kInternal2].httpClient.getUserThreadsSince_experimental({
       since: lastRequestedAt,
       signal
     });
@@ -1419,7 +1498,7 @@ var UmbrellaStore = class {
       this.#client.getRoom(roomId),
       `Room with id ${roomId} is not available on client`
     );
-    const updates = await room[kInternal].listTextVersionsSince({
+    const updates = await room[kInternal2].listTextVersionsSince({
       since: lastRequestedAt,
       signal
     });
@@ -1885,7 +1964,6 @@ function isThreadParticipant(thread, userId) {
 
 // src/liveblocks.tsx
 import { jsx } from "react/jsx-runtime";
-var ClientContext = createContext2(null);
 function missingUserError(userId) {
   return new Error(`resolveUsers didn't return anything for user '${userId}'`);
 }
@@ -2044,9 +2122,11 @@ function makeLiveblocksContextBundle(client) {
     useInboxNotificationThread: useInboxNotificationThread2,
     useUserThreads_experimental,
     useAiChats,
+    useAiChat,
     useAiChatMessages,
     useCreateAiChat,
     useDeleteAiChat,
+    useSendAiMessage,
     ...shared.classic,
     suspense: {
       LiveblocksProvider: LiveblocksProvider2,
@@ -2061,9 +2141,11 @@ function makeLiveblocksContextBundle(client) {
       useUpdateNotificationSettings: useUpdateNotificationSettings2,
       useUserThreads_experimental: useUserThreadsSuspense_experimental,
       useAiChats: useAiChatsSuspense,
+      useAiChat: useAiChatSuspense,
       useAiChatMessages: useAiChatMessagesSuspense,
       useCreateAiChat,
       useDeleteAiChat,
+      useSendAiMessage,
       ...shared.suspense
     }
   };
@@ -2071,7 +2153,7 @@ function makeLiveblocksContextBundle(client) {
 }
 function useInboxNotifications_withClient(client, selector, isEqual) {
   const { store, notificationsPoller: poller } = getLiveblocksExtrasForClient(client);
-  useEffect3(
+  useEffect4(
     () => void store.outputs.loadingNotifications.waitUntilLoaded()
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -2082,7 +2164,7 @@ function useInboxNotifications_withClient(client, selector, isEqual) {
     // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
     //    *next* render after that, a *new* fetch/promise will get created.
   );
-  useEffect3(() => {
+  useEffect4(() => {
     poller.inc();
     poller.pollNowIfStale();
     return () => {
@@ -2140,7 +2222,7 @@ function useMarkInboxNotificationAsRead_withClient(client) {
         },
         (err) => {
           store.optimisticUpdates.remove(optimisticId);
-          client[kInternal2].emitError(
+          client[kInternal3].emitError(
             {
               type: "MARK_INBOX_NOTIFICATION_AS_READ_ERROR",
               inboxNotificationId
@@ -2167,7 +2249,7 @@ function useMarkAllInboxNotificationsAsRead_withClient(client) {
       },
       (err) => {
         store.optimisticUpdates.remove(optimisticId);
-        client[kInternal2].emitError(
+        client[kInternal3].emitError(
           // No roomId, threadId, commentId to include for this error
           { type: "MARK_ALL_INBOX_NOTIFICATIONS_AS_READ_ERROR" },
           err
@@ -2192,7 +2274,7 @@ function useDeleteInboxNotification_withClient(client) {
         },
         (err) => {
           store.optimisticUpdates.remove(optimisticId);
-          client[kInternal2].emitError(
+          client[kInternal3].emitError(
             { type: "DELETE_INBOX_NOTIFICATION_ERROR", inboxNotificationId },
             err
           );
@@ -2216,7 +2298,7 @@ function useDeleteAllInboxNotifications_withClient(client) {
       },
       (err) => {
         store.optimisticUpdates.remove(optimisticId);
-        client[kInternal2].emitError(
+        client[kInternal3].emitError(
           { type: "DELETE_ALL_INBOX_NOTIFICATIONS_ERROR" },
           err
         );
@@ -2230,15 +2312,15 @@ function useInboxNotificationThread_withClient(client, inboxNotificationId) {
     store.outputs.threadifications,
     useCallback2(
       (state) => {
-        const inboxNotification = state.notificationsById[inboxNotificationId] ?? raise(
+        const inboxNotification = state.notificationsById[inboxNotificationId] ?? raise2(
           `Inbox notification with ID "${inboxNotificationId}" not found`
         );
         if (inboxNotification.kind !== "thread") {
-          raise(
+          raise2(
             `Inbox notification with ID "${inboxNotificationId}" is not of kind "thread"`
           );
         }
-        const thread = state.threadsDB.get(inboxNotification.threadId) ?? raise(
+        const thread = state.threadsDB.get(inboxNotification.threadId) ?? raise2(
           `Thread with ID "${inboxNotification.threadId}" not found, this inbox notification might not be of kind "thread"`
         );
         return thread;
@@ -2269,7 +2351,7 @@ function useUpdateNotificationSettings_withClient(client) {
               const msg = [err.details?.error, err.details?.reason].filter(Boolean).join("\n");
               console.error(msg);
             }
-            client[kInternal2].emitError(
+            client[kInternal3].emitError(
               {
                 type: "UPDATE_USER_NOTIFICATION_SETTINGS_ERROR"
               },
@@ -2287,10 +2369,10 @@ function useUpdateNotificationSettings_withClient(client) {
 function useNotificationSettings_withClient(client) {
   const updateNotificationSettings = useUpdateNotificationSettings_withClient(client);
   const { store, notificationSettingsPoller: poller } = getLiveblocksExtrasForClient(client);
-  useEffect3(() => {
+  useEffect4(() => {
     void store.outputs.notificationSettings.waitUntilLoaded();
   });
-  useEffect3(() => {
+  useEffect4(() => {
     poller.inc();
     poller.pollNowIfStale();
     return () => {
@@ -2314,7 +2396,7 @@ function useNotificationSettingsSuspense_withClient(client) {
   }, [result, updateNotificationSettings]);
 }
 function useUser_withClient(client, userId) {
-  const usersStore = client[kInternal2].usersStore;
+  const usersStore = client[kInternal3].usersStore;
   const getUserState = useCallback2(
     () => usersStore.getItemState(userId),
     [usersStore, userId]
@@ -2330,7 +2412,7 @@ function useUser_withClient(client, userId) {
     selector,
     shallow3
   );
-  useEffect3(
+  useEffect4(
     () => void usersStore.enqueue(userId)
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -2345,7 +2427,7 @@ function useUser_withClient(client, userId) {
   return result;
 }
 function useUserSuspense_withClient(client, userId) {
-  const usersStore = client[kInternal2].usersStore;
+  const usersStore = client[kInternal3].usersStore;
   const getUserState = useCallback2(
     () => usersStore.getItemState(userId),
     [usersStore, userId]
@@ -2375,7 +2457,7 @@ function useUserSuspense_withClient(client, userId) {
   };
 }
 function useRoomInfo_withClient(client, roomId) {
-  const roomsInfoStore = client[kInternal2].roomsInfoStore;
+  const roomsInfoStore = client[kInternal3].roomsInfoStore;
   const getRoomInfoState = useCallback2(
     () => roomsInfoStore.getItemState(roomId),
     [roomsInfoStore, roomId]
@@ -2391,7 +2473,7 @@ function useRoomInfo_withClient(client, roomId) {
     selector,
     shallow3
   );
-  useEffect3(
+  useEffect4(
     () => void roomsInfoStore.enqueue(roomId)
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -2406,7 +2488,7 @@ function useRoomInfo_withClient(client, roomId) {
   return result;
 }
 function useRoomInfoSuspense_withClient(client, roomId) {
-  const roomsInfoStore = client[kInternal2].roomsInfoStore;
+  const roomsInfoStore = client[kInternal3].roomsInfoStore;
   const getRoomInfoState = useCallback2(
     () => roomsInfoStore.getItemState(roomId),
     [roomsInfoStore, roomId]
@@ -2439,7 +2521,7 @@ function useRoomInfoSuspense_withClient(client, roomId) {
 function useAiChats() {
   const client = useClient();
   const store = getUmbrellaStoreForClient(client);
-  useEffect3(
+  useEffect4(
     () => void store.outputs.aiChats.waitUntilLoaded()
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -2462,11 +2544,11 @@ function useAiChatsSuspense() {
   assert(!result.isLoading, "Did not expect loading");
   return result;
 }
-function useAiChatMessages(chatId, branch) {
+function useAiChatMessages(chatId, options) {
   const client = useClient();
   const store = getUmbrellaStoreForClient(client);
-  useEffect3(
-    () => void store.outputs.messagesByChatId.getOrCreate(chatId).getOrCreate(branch ?? null).waitUntilLoaded()
+  useEffect4(
+    () => void store.outputs.messagesByChatId.getOrCreate(chatId).getOrCreate(options?.branchId ?? null).waitUntilLoaded()
     // NOTE: Deliberately *not* using a dependency array here!
     //
     // It is important to call waitUntil on *every* render.
@@ -2477,17 +2559,43 @@ function useAiChatMessages(chatId, branch) {
     //    *next* render after that, a *new* fetch/promise will get created.
   );
   return useSignal(
-    store.outputs.messagesByChatId.getOrCreate(chatId).getOrCreate(branch ?? null).signal
+    store.outputs.messagesByChatId.getOrCreate(chatId).getOrCreate(options?.branchId ?? null).signal
   );
 }
-function useAiChatMessagesSuspense(chatId, branch) {
+function useAiChatMessagesSuspense(chatId, options) {
   ensureNotServerSide();
   const client = useClient();
   const store = getUmbrellaStoreForClient(client);
   use(
-    store.outputs.messagesByChatId.getOrCreate(chatId).getOrCreate(branch ?? null).waitUntilLoaded()
+    store.outputs.messagesByChatId.getOrCreate(chatId).getOrCreate(options?.branchId ?? null).waitUntilLoaded()
   );
-  const result = useAiChatMessages(chatId, branch);
+  const result = useAiChatMessages(chatId, options);
+  assert(!result.error, "Did not expect error");
+  assert(!result.isLoading, "Did not expect loading");
+  return result;
+}
+function useAiChat(chatId) {
+  const client = useClient();
+  const store = getUmbrellaStoreForClient(client);
+  useEffect4(
+    () => void store.outputs.aiChatById.getOrCreate(chatId).waitUntilLoaded()
+    // NOTE: Deliberately *not* using a dependency array here!
+    //
+    // It is important to call waitUntil on *every* render.
+    // This is harmless though, on most renders, except:
+    // 1. The very first render, in which case we'll want to trigger the initial page fetch.
+    // 2. All other subsequent renders now "just" return the same promise (a quick operation).
+    // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
+    //    *next* render after that, a *new* fetch/promise will get created.
+  );
+  return useSignal(store.outputs.aiChatById.getOrCreate(chatId).signal);
+}
+function useAiChatSuspense(chatId) {
+  ensureNotServerSide();
+  const client = useClient();
+  const store = getUmbrellaStoreForClient(client);
+  use(store.outputs.aiChatById.getOrCreate(chatId).waitUntilLoaded());
+  const result = useAiChat(chatId);
   assert(!result.error, "Did not expect error");
   assert(!result.isLoading, "Did not expect loading");
   return result;
@@ -2496,7 +2604,10 @@ function useCreateAiChat() {
   const client = useClient();
   return useCallback2(
     (options) => {
-      client[kInternal2].ai.createChat(options.id).catch((err) => {
+      client[kInternal3].ai.getOrCreateChat(options.id, {
+        title: options.title,
+        metadata: options.metadata
+      }).catch((err) => {
         console.error(
           `Failed to create chat with ID "${options.id}": ${String(err)}`
         );
@@ -2509,7 +2620,7 @@ function useDeleteAiChat() {
   const client = useClient();
   return useCallback2(
     (chatId) => {
-      client[kInternal2].ai.deleteChat(chatId).catch((err) => {
+      client[kInternal3].ai.deleteChat(chatId).catch((err) => {
         console.error(
           `Failed to delete chat with ID "${chatId}": ${String(err)}`
         );
@@ -2518,6 +2629,38 @@ function useDeleteAiChat() {
     [client]
   );
 }
+function useSendAiMessage(chatId, options) {
+  const client = useClient();
+  const copilotId = options?.copilotId;
+  return useCallback2(
+    (message) => {
+      const messages = client[kInternal3].ai.signals.getChatMessagesForBranch\u03A3(chatId).get();
+      const lastMessageId = messages[messages.length - 1]?.id ?? null;
+      const content = [{ type: "text", text: message }];
+      const newMessageId = client[kInternal3].ai[kInternal3].context.messagesStore.createOptimistically(
+        chatId,
+        "user",
+        lastMessageId,
+        content
+      );
+      const targetMessageId = client[kInternal3].ai[kInternal3].context.messagesStore.createOptimistically(
+        chatId,
+        "assistant",
+        newMessageId
+      );
+      void client[kInternal3].ai.askUserMessageInChat(
+        chatId,
+        { id: newMessageId, parentMessageId: lastMessageId, content },
+        targetMessageId,
+        {
+          stream: false,
+          copilotId
+        }
+      );
+    },
+    [client, chatId, copilotId]
+  );
+}
 function createSharedContext(client) {
   const useClient2 = () => client;
   function useSyncStatus2(options) {
@@ -2530,7 +2673,9 @@ function createSharedContext(client) {
       useRoomInfo: (roomId) => useRoomInfo_withClient(client, roomId),
       useIsInsideRoom,
       useErrorListener,
-      useSyncStatus: useSyncStatus2
+      useSyncStatus: useSyncStatus2,
+      RegisterAiKnowledge,
+      RegisterAiTool
     },
     suspense: {
       useClient: useClient2,
@@ -2538,7 +2683,9 @@ function createSharedContext(client) {
       useRoomInfo: (roomId) => useRoomInfoSuspense_withClient(client, roomId),
       useIsInsideRoom,
       useErrorListener,
-      useSyncStatus: useSyncStatus2
+      useSyncStatus: useSyncStatus2,
+      RegisterAiKnowledge,
+      RegisterAiTool
     }
   };
 }
@@ -2550,12 +2697,6 @@ function useEnsureNoLiveblocksProvider(options) {
     );
   }
 }
-function useClientOrNull() {
-  return useContext2(ClientContext);
-}
-function useClient() {
-  return useClientOrNull() ?? raise("LiveblocksProvider is missing from the React tree.");
-}
 function LiveblocksProviderWithClient(props) {
   useEnsureNoLiveblocksProvider(props);
   return /* @__PURE__ */ jsx(ClientContext.Provider, { value: props.client, children: props.children });
@@ -2588,10 +2729,10 @@ function LiveblocksProvider(props) {
     )
   };
   const client = useMemo2(() => createClient(options), []);
-  useEffect3(() => {
-    client[kInternal2].ai.connect();
+  useEffect4(() => {
+    client[kInternal3].ai.connect();
     return () => {
-      client[kInternal2].ai.disconnect();
+      client[kInternal3].ai.disconnect();
     };
   }, [client]);
   return /* @__PURE__ */ jsx(LiveblocksProviderWithClient, { client, children });
@@ -2603,7 +2744,7 @@ function useUserThreads_experimental(options = {}) {
   const client = useClient();
   const { store, userThreadsPoller: poller } = getLiveblocksExtrasForClient(client);
   const queryKey = makeUserThreadsQueryKey(options.query);
-  useEffect3(
+  useEffect4(
     () => void store.outputs.loadingUserThreads.getOrCreate(queryKey).waitUntilLoaded()
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -2614,7 +2755,7 @@ function useUserThreads_experimental(options = {}) {
     // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
     //    *next* render after that, a *new* fetch/promise will get created.
   );
-  useEffect3(() => {
+  useEffect4(() => {
     poller.inc();
     poller.pollNowIfStale();
     return () => {
@@ -2696,6 +2837,8 @@ var _useUserThreads_experimental = useUserThreads_experimental;
 var _useUserThreadsSuspense_experimental = useUserThreadsSuspense_experimental;
 var _useAiChats = useAiChats;
 var _useAiChatsSuspense = useAiChatsSuspense;
+var _useAiChat = useAiChat;
+var _useAiChatSuspense = useAiChatSuspense;
 var _useAiChatMessages = useAiChatMessages;
 var _useAiChatMessagesSuspense = useAiChatMessagesSuspense;
 function useSyncStatus_withClient(client, options) {
@@ -2715,9 +2858,9 @@ function useSyncStatusImmediate_withClient(client) {
 }
 function useSyncStatusSmooth_withClient(client) {
   const getter = client.getSyncStatus;
-  const [status, setStatus] = useState(getter);
+  const [status, setStatus] = useState2(getter);
   const oldStatus = useLatest(getter());
-  useEffect3(() => {
+  useEffect4(() => {
     let timeoutId;
     const unsub = client.events.syncStatus.subscribe(() => {
       const newStatus = getter();
@@ -2741,7 +2884,7 @@ function useSyncStatus(options) {
 function useErrorListener(callback) {
   const client = useClient();
   const savedCallback = useLatest(callback);
-  useEffect3(
+  useEffect4(
     () => client.events.error.subscribe((e) => savedCallback.current(e)),
     [client, savedCallback]
   );
@@ -2758,22 +2901,22 @@ import {
   errorIf,
   getSubscriptionKey as getSubscriptionKey2,
   HttpError as HttpError2,
-  kInternal as kInternal3,
+  kInternal as kInternal4,
   makePoller as makePoller2,
   ServerMsgCode
 } from "@liveblocks/core";
 import {
   useCallback as useCallback3,
-  useEffect as useEffect5,
+  useEffect as useEffect6,
   useMemo as useMemo3,
   useRef as useRef3,
-  useState as useState2,
+  useState as useState3,
   useSyncExternalStore as useSyncExternalStore3,
   version as reactVersion
 } from "react";
 
 // src/use-scroll-to-comment-on-load-effect.ts
-import { useEffect as useEffect4 } from "react";
+import { useEffect as useEffect5 } from "react";
 function handleScrollToCommentOnLoad(shouldScrollOnLoad, state) {
   if (shouldScrollOnLoad === false) return;
   if (!state.threads) return;
@@ -2792,7 +2935,7 @@ function handleScrollToCommentOnLoad(shouldScrollOnLoad, state) {
   comment.scrollIntoView();
 }
 function useScrollToCommentOnLoadEffect(shouldScrollOnLoad, state) {
-  useEffect4(
+  useEffect5(
     () => {
       handleScrollToCommentOnLoad(shouldScrollOnLoad, state);
     },
@@ -2846,7 +2989,7 @@ function makeMutationContext(room) {
   };
 }
 function getCurrentUserId(client) {
-  const userId = client[kInternal3].currentUserId.get();
+  const userId = client[kInternal4].currentUserId.get();
   if (userId === void 0) {
     return "anonymous";
   }
@@ -2883,7 +3026,7 @@ function makeRoomExtrasForClient(client) {
         ].filter(Boolean).join("\n");
         console3.error(detailedMessage);
       }
-      client[kInternal3].emitError(context, innerError);
+      client[kInternal4].emitError(context, innerError);
     } else {
       throw innerError;
     }
@@ -3054,13 +3197,13 @@ function makeRoomContextBundle(client) {
       ...shared.suspense
     }
   };
-  return Object.defineProperty(bundle, kInternal3, {
+  return Object.defineProperty(bundle, kInternal4, {
     enumerable: false
   });
 }
 function RoomProvider(props) {
   const client = useClient();
-  const [cache] = useState2(
+  const [cache] = useState3(
     () => /* @__PURE__ */ new Map()
   );
   const stableEnterRoom = useCallback3(
@@ -3110,14 +3253,14 @@ function RoomProviderInner(props) {
     initialStorage: props.initialStorage,
     autoConnect: props.autoConnect ?? typeof window !== "undefined"
   });
-  const [{ room }, setRoomLeavePair] = useState2(
+  const [{ room }, setRoomLeavePair] = useState3(
     () => stableEnterRoom(roomId, {
       ...frozenProps,
       autoConnect: false
       // Deliberately using false here on the first render, see below
     })
   );
-  useEffect5(() => {
+  useEffect6(() => {
     const { store } = getRoomExtrasForClient(client);
     async function handleCommentEvent(message) {
       if (message.type === ServerMsgCode.THREAD_DELETED) {
@@ -3164,7 +3307,7 @@ function RoomProviderInner(props) {
       (message) => void handleCommentEvent(message)
     );
   }, [client, room]);
-  useEffect5(() => {
+  useEffect6(() => {
     const pair = stableEnterRoom(roomId, frozenProps);
     setRoomLeavePair(pair);
     const { room: room2, leave } = pair;
@@ -3194,14 +3337,14 @@ function useStatus() {
 function useReportTextEditor(editor, rootKey) {
   const isReported = useRef3(false);
   const room = useRoom();
-  useEffect5(() => {
+  useEffect6(() => {
     if (isReported.current) {
       return;
     }
     const unsubscribe = room.events.status.subscribe((status) => {
       if (status === "connected" && !isReported.current) {
         isReported.current = true;
-        void room[kInternal3].reportTextEditor(editor, rootKey);
+        void room[kInternal4].reportTextEditor(editor, rootKey);
       }
     });
     return unsubscribe;
@@ -3211,12 +3354,12 @@ function useYjsProvider() {
   const room = useRoom();
   const subscribe = useCallback3(
     (onStoreChange) => {
-      return room[kInternal3].yjsProviderDidChange.subscribe(onStoreChange);
+      return room[kInternal4].yjsProviderDidChange.subscribe(onStoreChange);
     },
     [room]
   );
   const getSnapshot = useCallback3(() => {
-    return room[kInternal3].getYjsProvider();
+    return room[kInternal4].getYjsProvider();
   }, [room]);
   return useSyncExternalStore3(subscribe, getSnapshot, getSnapshot);
 }
@@ -3224,7 +3367,7 @@ function useCreateTextMention() {
   const room = useRoom();
   return useCallback3(
     (userId, mentionId) => {
-      room[kInternal3].createTextMention(userId, mentionId).catch((err) => {
+      room[kInternal4].createTextMention(userId, mentionId).catch((err) => {
         console3.error(
           `Cannot create text mention for user '${userId}' and mention '${mentionId}'`,
           err
@@ -3238,7 +3381,7 @@ function useDeleteTextMention() {
   const room = useRoom();
   return useCallback3(
     (mentionId) => {
-      room[kInternal3].deleteTextMention(mentionId).catch((err) => {
+      room[kInternal4].deleteTextMention(mentionId).catch((err) => {
         console3.error(`Cannot delete text mention '${mentionId}'`, err);
       });
     },
@@ -3247,11 +3390,11 @@ function useDeleteTextMention() {
 }
 function useResolveMentionSuggestions() {
   const client = useClient();
-  return client[kInternal3].resolveMentionSuggestions;
+  return client[kInternal4].resolveMentionSuggestions;
 }
 function useMentionSuggestionsCache() {
   const client = useClient();
-  return client[kInternal3].mentionSuggestionsCache;
+  return client[kInternal4].mentionSuggestionsCache;
 }
 function useStorageStatus(options) {
   const smooth = useInitial(options?.smooth ?? false);
@@ -3270,9 +3413,9 @@ function useStorageStatusImmediate() {
 }
 function useStorageStatusSmooth() {
   const room = useRoom();
-  const [status, setStatus] = useState2(room.getStorageStatus);
+  const [status, setStatus] = useState3(room.getStorageStatus);
   const oldStatus = useLatest(room.getStorageStatus());
-  useEffect5(() => {
+  useEffect6(() => {
     let timeoutId;
     const unsub = room.events.storageStatus.subscribe((newStatus) => {
       if (oldStatus.current === "synchronizing" && newStatus === "synchronized") {
@@ -3304,7 +3447,7 @@ function useBroadcastEvent() {
 function useOthersListener(callback) {
   const room = useRoom();
   const savedCallback = useLatest(callback);
-  useEffect5(
+  useEffect6(
     () => room.events.others.subscribe((event) => savedCallback.current(event)),
     [room, savedCallback]
   );
@@ -3312,7 +3455,7 @@ function useOthersListener(callback) {
 function useLostConnectionListener(callback) {
   const room = useRoom();
   const savedCallback = useLatest(callback);
-  useEffect5(
+  useEffect6(
     () => room.events.lostConnection.subscribe(
       (event) => savedCallback.current(event)
     ),
@@ -3322,7 +3465,7 @@ function useLostConnectionListener(callback) {
 function useEventListener(callback) {
   const room = useRoom();
   const savedCallback = useLatest(callback);
-  useEffect5(() => {
+  useEffect6(() => {
     const listener = (eventData) => {
       savedCallback.current(eventData);
     };
@@ -3506,7 +3649,7 @@ function useThreads(options = {}) {
   const { store, getOrCreateThreadsPollerForRoomId } = getRoomExtrasForClient(client);
   const queryKey = makeRoomThreadsQueryKey(room.id, options.query);
   const poller = getOrCreateThreadsPollerForRoomId(room.id);
-  useEffect5(
+  useEffect6(
     () => void store.outputs.loadingRoomThreads.getOrCreate(queryKey).waitUntilLoaded()
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -3517,7 +3660,7 @@ function useThreads(options = {}) {
     // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
     //    *next* render after that, a *new* fetch/promise will get created.
   );
-  useEffect5(() => {
+  useEffect6(() => {
     poller.inc();
     poller.pollNowIfStale();
     return () => poller.dec();
@@ -3569,7 +3712,7 @@ function useCreateRoomThread(roomId) {
         roomId
       });
       const attachmentIds = attachments?.map((attachment) => attachment.id);
-      client[kInternal3].httpClient.createThread({
+      client[kInternal4].httpClient.createThread({
         roomId,
         threadId,
         commentId,
@@ -3617,7 +3760,7 @@ function useDeleteRoomThread(roomId) {
         threadId,
         deletedAt: /* @__PURE__ */ new Date()
       });
-      client[kInternal3].httpClient.deleteThread({ roomId, threadId }).then(
+      client[kInternal4].httpClient.deleteThread({ roomId, threadId }).then(
         () => {
           store.deleteThread(threadId, optimisticId);
         },
@@ -3651,7 +3794,7 @@ function useEditRoomThreadMetadata(roomId) {
         threadId,
         updatedAt
       });
-      client[kInternal3].httpClient.editThreadMetadata({ roomId, threadId, metadata }).then(
+      client[kInternal4].httpClient.editThreadMetadata({ roomId, threadId, metadata }).then(
         (metadata2) => (
           // Replace the optimistic update by the real thing
           store.patchThread(threadId, optimisticId, { metadata: metadata2 }, updatedAt)
@@ -3697,7 +3840,7 @@ function useCreateRoomComment(roomId) {
         comment
       });
       const attachmentIds = attachments?.map((attachment) => attachment.id);
-      client[kInternal3].httpClient.createComment({ roomId, threadId, commentId, body, attachmentIds }).then(
+      client[kInternal4].httpClient.createComment({ roomId, threadId, commentId, body, attachmentIds }).then(
         (newComment) => {
           store.createComment(newComment, optimisticId);
         },
@@ -3753,7 +3896,7 @@ function useEditRoomComment(roomId) {
         }
       });
       const attachmentIds = attachments?.map((attachment) => attachment.id);
-      client[kInternal3].httpClient.editComment({ roomId, threadId, commentId, body, attachmentIds }).then(
+      client[kInternal4].httpClient.editComment({ roomId, threadId, commentId, body, attachmentIds }).then(
         (editedComment) => {
           store.editComment(threadId, optimisticId, editedComment);
         },
@@ -3783,7 +3926,7 @@ function useDeleteRoomComment(roomId) {
         deletedAt,
         roomId
       });
-      client[kInternal3].httpClient.deleteComment({ roomId, threadId, commentId }).then(
+      client[kInternal4].httpClient.deleteComment({ roomId, threadId, commentId }).then(
         () => {
           store.deleteComment(threadId, optimisticId, commentId, deletedAt);
         },
@@ -3817,7 +3960,7 @@ function useAddRoomCommentReaction(roomId) {
           createdAt
         }
       });
-      client[kInternal3].httpClient.addReaction({ roomId, threadId, commentId, emoji }).then(
+      client[kInternal4].httpClient.addReaction({ roomId, threadId, commentId, emoji }).then(
         (addedReaction) => {
           store.addReaction(
             threadId,
@@ -3861,7 +4004,7 @@ function useRemoveRoomCommentReaction(roomId) {
         userId,
         removedAt
       });
-      client[kInternal3].httpClient.removeReaction({ roomId, threadId, commentId, emoji }).then(
+      client[kInternal4].httpClient.removeReaction({ roomId, threadId, commentId, emoji }).then(
         () => {
           store.removeReaction(
             threadId,
@@ -3908,7 +4051,7 @@ function useMarkRoomThreadAsRead(roomId) {
         inboxNotificationId: inboxNotification.id,
         readAt: now
       });
-      client[kInternal3].httpClient.markRoomInboxNotificationAsRead({
+      client[kInternal4].httpClient.markRoomInboxNotificationAsRead({
         roomId,
         inboxNotificationId: inboxNotification.id
       }).then(
@@ -3950,7 +4093,7 @@ function useMarkRoomThreadAsResolved(roomId) {
         threadId,
         updatedAt
       });
-      client[kInternal3].httpClient.markThreadAsResolved({ roomId, threadId }).then(
+      client[kInternal4].httpClient.markThreadAsResolved({ roomId, threadId }).then(
         () => {
           store.patchThread(
             threadId,
@@ -3983,7 +4126,7 @@ function useMarkRoomThreadAsUnresolved(roomId) {
         threadId,
         updatedAt
       });
-      client[kInternal3].httpClient.markThreadAsUnresolved({ roomId, threadId }).then(
+      client[kInternal4].httpClient.markThreadAsUnresolved({ roomId, threadId }).then(
         () => {
           store.patchThread(
             threadId,
@@ -4016,7 +4159,7 @@ function useSubscribeToRoomThread(roomId) {
         threadId,
         subscribedAt
       });
-      client[kInternal3].httpClient.subscribeToThread({ roomId, threadId }).then(
+      client[kInternal4].httpClient.subscribeToThread({ roomId, threadId }).then(
         (subscription) => {
           store.createSubscription(subscription, optimisticId);
         },
@@ -4044,7 +4187,7 @@ function useUnsubscribeFromRoomThread(roomId) {
         threadId,
         unsubscribedAt
       });
-      client[kInternal3].httpClient.unsubscribeFromThread({ roomId, threadId }).then(
+      client[kInternal4].httpClient.unsubscribeFromThread({ roomId, threadId }).then(
         () => {
           store.deleteSubscription(
             getSubscriptionKey2("thread", threadId),
@@ -4108,7 +4251,7 @@ function useRoomNotificationSettings() {
   const room = useRoom();
   const { store, getOrCreateSubscriptionSettingsPollerForRoomId } = getRoomExtrasForClient(client);
   const poller = getOrCreateSubscriptionSettingsPollerForRoomId(room.id);
-  useEffect5(
+  useEffect6(
     () => void store.outputs.roomSubscriptionSettingsByRoomId.getOrCreate(room.id).waitUntilLoaded()
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -4119,7 +4262,7 @@ function useRoomNotificationSettings() {
     // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
     //    *next* render after that, a *new* fetch/promise will get created.
   );
-  useEffect5(() => {
+  useEffect6(() => {
     poller.inc();
     poller.pollNowIfStale();
     return () => {
@@ -4139,7 +4282,7 @@ function useRoomSubscriptionSettings() {
   const room = useRoom();
   const { store, getOrCreateSubscriptionSettingsPollerForRoomId } = getRoomExtrasForClient(client);
   const poller = getOrCreateSubscriptionSettingsPollerForRoomId(room.id);
-  useEffect5(
+  useEffect6(
     () => void store.outputs.roomSubscriptionSettingsByRoomId.getOrCreate(room.id).waitUntilLoaded()
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -4150,7 +4293,7 @@ function useRoomSubscriptionSettings() {
     // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
     //    *next* render after that, a *new* fetch/promise will get created.
   );
-  useEffect5(() => {
+  useEffect6(() => {
     poller.inc();
     poller.pollNowIfStale();
     return () => {
@@ -4195,15 +4338,15 @@ function useRoomSubscriptionSettingsSuspense() {
   }, [settings, updateRoomSubscriptionSettings]);
 }
 function useHistoryVersionData(versionId) {
-  const [state, setState] = useState2({
+  const [state, setState] = useState3({
     isLoading: true
   });
   const room = useRoom();
-  useEffect5(() => {
+  useEffect6(() => {
     setState({ isLoading: true });
     const load = async () => {
       try {
-        const response = await room[kInternal3].getTextVersion(versionId);
+        const response = await room[kInternal4].getTextVersion(versionId);
         const buffer = await response.arrayBuffer();
         const data = new Uint8Array(buffer);
         setState({
@@ -4228,12 +4371,12 @@ function useHistoryVersions() {
   const room = useRoom();
   const { store, getOrCreateVersionsPollerForRoomId } = getRoomExtrasForClient(client);
   const poller = getOrCreateVersionsPollerForRoomId(room.id);
-  useEffect5(() => {
+  useEffect6(() => {
     poller.inc();
     poller.pollNowIfStale();
     return () => poller.dec();
   }, [poller]);
-  useEffect5(
+  useEffect6(
     () => void store.outputs.versionsByRoomId.getOrCreate(room.id).waitUntilLoaded()
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -4406,12 +4549,12 @@ function useAttachmentUrl(attachmentId) {
 }
 function useRoomAttachmentUrl(attachmentId, roomId) {
   const client = useClient();
-  const store = client[kInternal3].httpClient.getOrCreateAttachmentUrlsStore(roomId);
+  const store = client[kInternal4].httpClient.getOrCreateAttachmentUrlsStore(roomId);
   const getAttachmentUrlState = useCallback3(
     () => store.getItemState(attachmentId),
     [store, attachmentId]
   );
-  useEffect5(() => {
+  useEffect6(() => {
     void store.enqueue(attachmentId);
   }, [store, attachmentId]);
   return useSyncExternalStoreWithSelector(
@@ -4424,7 +4567,7 @@ function useRoomAttachmentUrl(attachmentId, roomId) {
 }
 function useAttachmentUrlSuspense(attachmentId) {
   const room = useRoom();
-  const { attachmentUrlsStore } = room[kInternal3];
+  const { attachmentUrlsStore } = room[kInternal4];
   const getAttachmentUrlState = useCallback3(
     () => attachmentUrlsStore.getItemState(attachmentId),
     [attachmentUrlsStore, attachmentId]
@@ -4450,14 +4593,10 @@ function useAttachmentUrlSuspense(attachmentId) {
     error: void 0
   };
 }
-var NO_PERMISSIONS = /* @__PURE__ */ new Set();
 function useRoomPermissions(roomId) {
   const client = useClient();
   const store = getRoomExtrasForClient(client).store;
-  return useSignal(
-    store.permissionHints.signal,
-    (hints) => hints.get(roomId) ?? NO_PERMISSIONS
-  );
+  return useSignal(store.permissionHints.getPermissionForRoom\u03A3(roomId));
 }
 function createRoomContext(client) {
   return getOrCreateRoomContextBundle(client);
@@ -4504,15 +4643,18 @@ var _useStorageRoot = useStorageRoot;
 var _useUpdateMyPresence = useUpdateMyPresence;
 
 export {
+  ClientContext,
+  useClientOrNull,
+  useClient,
   RoomContext,
+  RegisterAiKnowledge,
+  RegisterAiTool,
   useSyncExternalStoreWithSelector,
   useSignal,
-  ClientContext,
   getUmbrellaStoreForClient,
   useCreateAiChat,
   useDeleteAiChat,
-  useClientOrNull,
-  useClient,
+  useSendAiMessage,
   LiveblocksProvider,
   createLiveblocksContext,
   useInboxNotifications,
@@ -4535,6 +4677,8 @@ export {
   _useUserThreadsSuspense_experimental,
   _useAiChats,
   _useAiChatsSuspense,
+  _useAiChat,
+  _useAiChatSuspense,
   _useAiChatMessages,
   _useAiChatMessagesSuspense,
   useSyncStatus,
@@ -4620,4 +4764,4 @@ export {
   _useStorageRoot,
   _useUpdateMyPresence
 };
-//# sourceMappingURL=chunk-E6PCFJWE.js.map
+//# sourceMappingURL=chunk-X7TWWGKZ.js.map