@liveblocks/core 2.17.0-usrnotsettings2 → 2.17.0

package/dist/index.d.mts

@@ -1127,6 +1127,22 @@ type BatchStore<O, I> = {
     invalidate: (inputs?: I[]) => void;
 };
 
+type ContextualPromptResponse = Relax<{
+    type: "insert";
+    text: string;
+} | {
+    type: "replace";
+    text: string;
+} | {
+    type: "other";
+    text: string;
+}>;
+type ContextualPromptContext = {
+    beforeSelection: string;
+    selection: string;
+    afterSelection: string;
+};
+
 declare enum ClientMsgCode {
     UPDATE_PRESENCE = 100,
     BROADCAST_EVENT = 103,
@@ -2404,6 +2420,15 @@ type PrivateRoomApi = {
     }>;
     getTextVersion(versionId: string): Promise<Response>;
     createTextVersion(): Promise<void>;
+    executeContextualPrompt(options: {
+        prompt: string;
+        context: ContextualPromptContext;
+        previous?: {
+            prompt: string;
+            response: ContextualPromptResponse;
+        };
+        signal: AbortSignal;
+    }): Promise<string>;
     simulate: {
         explicitClose(event: IWebSocketCloseEvent): void;
         rawSend(data: string): void;
@@ -2441,55 +2466,7 @@ type PartialUnless<C, T> = Record<string, never> extends C ? Partial<T> : [
 type OptionalTupleUnless<C, T extends any[]> = Record<string, never> extends C ? OptionalTuple<T> : [
     C
 ] extends [never] ? OptionalTuple<T> : T;
-
-/**
- * Pre-defined notification channels support list.
- */
-type NotificationChannel = "email" | "slack" | "teams" | "webPush";
-/**
- * `K` represents custom notification kinds
- * defined in the augmentation `ActivitiesData` (e.g `liveblocks.config.ts`).
- * It means the type `NotificationKind` will be shaped like:
- * thread | textMention | $customKind1 | $customKind2 | ...
- */
-type NotificationKind<K extends keyof DAD = keyof DAD> = "thread" | "textMention" | K;
-/**
- * A notification channel settings is a set of notification kinds.
- * One setting can have multiple kinds (+ augmentation)
- */
-type NotificationChannelSettings = {
-    [K in NotificationKind]: boolean;
-};
-/**
- * User notification settings are a set of notification channel setting.
- * One channel for one set of settings.
- */
-type UserNotificationSettings = {
-    [C in NotificationChannel]: NotificationChannelSettings;
-};
-/**
- * It creates a deep partial specific for `UserNotificationSettings`
- * to offer a nice DX when updating the settings (e.g not being forced to define every keys)
- * and at the same the some preserver the augmentation for custom kinds (e.g `liveblocks.config.ts`).
- */
-type DeepPartialWithAugmentation<T> = T extends object ? {
-    [P in keyof T]?: T[P] extends {
-        [K in NotificationKind]: boolean;
-    } ? Partial<T[P]> & {
-        [K in keyof DAD]?: boolean;
-    } : DeepPartialWithAugmentation<T[P]>;
-} : T;
-/**
- * Partial user notification settings
- * with augmentation preserved gracefully
- */
-type PartialUserNotificationSettings = DeepPartialWithAugmentation<UserNotificationSettings>;
-/**
- *
- * Utility to check if a notification channel settings
- * is enabled for every notification kinds.
- */
-declare function isNotificationChannelEnabled(settings: NotificationChannelSettings): boolean;
+type LargeMessageStrategy = "default" | "split" | "experimental-fallback-to-http";
 
 interface RoomHttpApi<M extends BaseMetadata> {
     getThreads(options: {
@@ -2666,6 +2643,16 @@ interface RoomHttpApi<M extends BaseMetadata> {
         nonce: string | undefined;
         messages: ClientMsg<P, E>[];
     }): Promise<Response>;
+    executeContextualPrompt({ roomId, prompt, context, signal, }: {
+        roomId: string;
+        prompt: string;
+        context: ContextualPromptContext;
+        previous?: {
+            prompt: string;
+            response: ContextualPromptResponse;
+        };
+        signal: AbortSignal;
+    }): Promise<string>;
 }
 interface NotificationHttpApi<M extends BaseMetadata> {
     getInboxNotifications(options?: {
@@ -2695,8 +2682,6 @@ interface NotificationHttpApi<M extends BaseMetadata> {
     markInboxNotificationAsRead(inboxNotificationId: string): Promise<void>;
     deleteAllInboxNotifications(): Promise<void>;
     deleteInboxNotification(inboxNotificationId: string): Promise<void>;
-    getUserNotificationSettings(): Promise<UserNotificationSettings>;
-    updateUserNotificationSettings(settings: PartialUserNotificationSettings): Promise<UserNotificationSettings>;
 }
 interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, NotificationHttpApi<M> {
     getUserThreads_experimental(options?: {
@@ -2819,7 +2804,7 @@ declare class MutableSignal<T extends object> extends AbstractSignal<T> {
     mutate(callback?: (state: T) => void | boolean): void;
 }
 
-type OptionalPromise<T> = T | Promise<T>;
+type Awaitable<T> = T | PromiseLike<T>;
 
 type ResolveMentionSuggestionsArgs = {
     /**
@@ -2986,28 +2971,6 @@ type NotificationsApi<M extends BaseMetadata> = {
      * await client.deleteInboxNotification("in_xxx");
      */
     deleteInboxNotification(inboxNotificationId: string): Promise<void>;
-    /**
-     * Gets notifications settings for a user for a project.
-     *
-     * @example
-     * const notificationSettings = await client.getNotificationSettings();
-     */
-    getNotificationSettings(options?: {
-        signal?: AbortSignal;
-    }): Promise<UserNotificationSettings>;
-    /**
-     * Update notifications settings for a user for a project.
-     *
-     * @example
-     * await client.updateNotificationSettings({
-     *  email: {
-     *    thread: true,
-     *    textMention: false,
-     *    $customKind1: true,
-     *  }
-     * })
-     */
-    updateNotificationSettings(settings: PartialUserNotificationSettings): Promise<UserNotificationSettings>;
 };
 /**
  * @private Widest-possible Client type, matching _any_ Client instance. Note
@@ -3121,22 +3084,24 @@ type ClientOptions<U extends BaseUserMeta = DU> = {
     lostConnectionTimeout?: number;
     backgroundKeepAliveTimeout?: number;
     polyfills?: Polyfills;
+    largeMessageStrategy?: LargeMessageStrategy;
+    /** @deprecated Use `largeMessageStrategy="experimental-fallback-to-http"` instead. */
     unstable_fallbackToHTTP?: boolean;
     unstable_streamData?: boolean;
     /**
      * A function that returns a list of user IDs matching a string.
      */
-    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => OptionalPromise<string[]>;
+    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => Awaitable<string[]>;
     /**
      * A function that returns user info from user IDs.
      * You should return a list of user objects of the same size, in the same order.
      */
-    resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>;
+    resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
     /**
      * A function that returns room info from room IDs.
      * You should return a list of room info objects of the same size, in the same order.
      */
-    resolveRoomsInfo?: (args: ResolveRoomsInfoArgs) => OptionalPromise<(DRI | undefined)[] | undefined>;
+    resolveRoomsInfo?: (args: ResolveRoomsInfoArgs) => Awaitable<(DRI | undefined)[] | undefined>;
     /**
      * Prevent the current browser tab from being closed if there are any locally
      * pending Liveblocks changes that haven't been submitted to or confirmed by
@@ -3247,7 +3212,7 @@ type StringifyCommentBodyOptions<U extends BaseUserMeta = DU> = {
      * A function that returns user info from user IDs.
      * You should return a list of user objects of the same size, in the same order.
      */
-    resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>;
+    resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
 };
 declare function isCommentBodyText(element: CommentBodyElement): element is CommentBodyText;
 declare function isCommentBodyMention(element: CommentBodyElement): element is CommentBodyMention;
@@ -3256,7 +3221,7 @@ declare function isCommentBodyLink(element: CommentBodyElement): element is Comm
  * Get an array of each user's ID that has been mentioned in a `CommentBody`.
  */
 declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
-declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
+declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
 declare function htmlSafe(value: string): HtmlSafeString;
 declare class HtmlSafeString {
     #private;
@@ -3597,18 +3562,6 @@ type DistributiveOmit<T, K extends PropertyKey> = T extends any ? Omit<T, K> : n
  * Throw an error, but as an expression instead of a statement.
  */
 declare function raise(msg: string): never;
-/**
- * Drop-in replacement for Object.entries() that retains better types.
- */
-declare function entries<O extends {
-    [key: string]: unknown;
-}, K extends keyof O>(obj: O): [K, O[K]][];
-/**
- * Drop-in replacement for Object.keys() that retains better types.
- */
-declare function keys<O extends {
-    [key: string]: unknown;
-}, K extends keyof O>(obj: O): K[];
 /**
  * Creates a new object by mapping a function over all values. Keys remain the
  * same. Think Array.prototype.map(), but for values in an object.
@@ -3926,4 +3879,4 @@ declare const CommentsApiError: typeof HttpError;
 /** @deprecated Use HttpError instead. */
 declare const NotificationsApiError: typeof HttpError;
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type PartialUserNotificationSettings, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserNotificationSettings, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, entries, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };

package/dist/index.d.ts

@@ -1127,6 +1127,22 @@ type BatchStore<O, I> = {
     invalidate: (inputs?: I[]) => void;
 };
 
+type ContextualPromptResponse = Relax<{
+    type: "insert";
+    text: string;
+} | {
+    type: "replace";
+    text: string;
+} | {
+    type: "other";
+    text: string;
+}>;
+type ContextualPromptContext = {
+    beforeSelection: string;
+    selection: string;
+    afterSelection: string;
+};
+
 declare enum ClientMsgCode {
     UPDATE_PRESENCE = 100,
     BROADCAST_EVENT = 103,
@@ -2404,6 +2420,15 @@ type PrivateRoomApi = {
     }>;
     getTextVersion(versionId: string): Promise<Response>;
     createTextVersion(): Promise<void>;
+    executeContextualPrompt(options: {
+        prompt: string;
+        context: ContextualPromptContext;
+        previous?: {
+            prompt: string;
+            response: ContextualPromptResponse;
+        };
+        signal: AbortSignal;
+    }): Promise<string>;
     simulate: {
         explicitClose(event: IWebSocketCloseEvent): void;
         rawSend(data: string): void;
@@ -2441,55 +2466,7 @@ type PartialUnless<C, T> = Record<string, never> extends C ? Partial<T> : [
 type OptionalTupleUnless<C, T extends any[]> = Record<string, never> extends C ? OptionalTuple<T> : [
     C
 ] extends [never] ? OptionalTuple<T> : T;
-
-/**
- * Pre-defined notification channels support list.
- */
-type NotificationChannel = "email" | "slack" | "teams" | "webPush";
-/**
- * `K` represents custom notification kinds
- * defined in the augmentation `ActivitiesData` (e.g `liveblocks.config.ts`).
- * It means the type `NotificationKind` will be shaped like:
- * thread | textMention | $customKind1 | $customKind2 | ...
- */
-type NotificationKind<K extends keyof DAD = keyof DAD> = "thread" | "textMention" | K;
-/**
- * A notification channel settings is a set of notification kinds.
- * One setting can have multiple kinds (+ augmentation)
- */
-type NotificationChannelSettings = {
-    [K in NotificationKind]: boolean;
-};
-/**
- * User notification settings are a set of notification channel setting.
- * One channel for one set of settings.
- */
-type UserNotificationSettings = {
-    [C in NotificationChannel]: NotificationChannelSettings;
-};
-/**
- * It creates a deep partial specific for `UserNotificationSettings`
- * to offer a nice DX when updating the settings (e.g not being forced to define every keys)
- * and at the same the some preserver the augmentation for custom kinds (e.g `liveblocks.config.ts`).
- */
-type DeepPartialWithAugmentation<T> = T extends object ? {
-    [P in keyof T]?: T[P] extends {
-        [K in NotificationKind]: boolean;
-    } ? Partial<T[P]> & {
-        [K in keyof DAD]?: boolean;
-    } : DeepPartialWithAugmentation<T[P]>;
-} : T;
-/**
- * Partial user notification settings
- * with augmentation preserved gracefully
- */
-type PartialUserNotificationSettings = DeepPartialWithAugmentation<UserNotificationSettings>;
-/**
- *
- * Utility to check if a notification channel settings
- * is enabled for every notification kinds.
- */
-declare function isNotificationChannelEnabled(settings: NotificationChannelSettings): boolean;
+type LargeMessageStrategy = "default" | "split" | "experimental-fallback-to-http";
 
 interface RoomHttpApi<M extends BaseMetadata> {
     getThreads(options: {
@@ -2666,6 +2643,16 @@ interface RoomHttpApi<M extends BaseMetadata> {
         nonce: string | undefined;
         messages: ClientMsg<P, E>[];
     }): Promise<Response>;
+    executeContextualPrompt({ roomId, prompt, context, signal, }: {
+        roomId: string;
+        prompt: string;
+        context: ContextualPromptContext;
+        previous?: {
+            prompt: string;
+            response: ContextualPromptResponse;
+        };
+        signal: AbortSignal;
+    }): Promise<string>;
 }
 interface NotificationHttpApi<M extends BaseMetadata> {
     getInboxNotifications(options?: {
@@ -2695,8 +2682,6 @@ interface NotificationHttpApi<M extends BaseMetadata> {
     markInboxNotificationAsRead(inboxNotificationId: string): Promise<void>;
     deleteAllInboxNotifications(): Promise<void>;
     deleteInboxNotification(inboxNotificationId: string): Promise<void>;
-    getUserNotificationSettings(): Promise<UserNotificationSettings>;
-    updateUserNotificationSettings(settings: PartialUserNotificationSettings): Promise<UserNotificationSettings>;
 }
 interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, NotificationHttpApi<M> {
     getUserThreads_experimental(options?: {
@@ -2819,7 +2804,7 @@ declare class MutableSignal<T extends object> extends AbstractSignal<T> {
     mutate(callback?: (state: T) => void | boolean): void;
 }
 
-type OptionalPromise<T> = T | Promise<T>;
+type Awaitable<T> = T | PromiseLike<T>;
 
 type ResolveMentionSuggestionsArgs = {
     /**
@@ -2986,28 +2971,6 @@ type NotificationsApi<M extends BaseMetadata> = {
      * await client.deleteInboxNotification("in_xxx");
      */
     deleteInboxNotification(inboxNotificationId: string): Promise<void>;
-    /**
-     * Gets notifications settings for a user for a project.
-     *
-     * @example
-     * const notificationSettings = await client.getNotificationSettings();
-     */
-    getNotificationSettings(options?: {
-        signal?: AbortSignal;
-    }): Promise<UserNotificationSettings>;
-    /**
-     * Update notifications settings for a user for a project.
-     *
-     * @example
-     * await client.updateNotificationSettings({
-     *  email: {
-     *    thread: true,
-     *    textMention: false,
-     *    $customKind1: true,
-     *  }
-     * })
-     */
-    updateNotificationSettings(settings: PartialUserNotificationSettings): Promise<UserNotificationSettings>;
 };
 /**
  * @private Widest-possible Client type, matching _any_ Client instance. Note
@@ -3121,22 +3084,24 @@ type ClientOptions<U extends BaseUserMeta = DU> = {
     lostConnectionTimeout?: number;
     backgroundKeepAliveTimeout?: number;
     polyfills?: Polyfills;
+    largeMessageStrategy?: LargeMessageStrategy;
+    /** @deprecated Use `largeMessageStrategy="experimental-fallback-to-http"` instead. */
     unstable_fallbackToHTTP?: boolean;
     unstable_streamData?: boolean;
     /**
      * A function that returns a list of user IDs matching a string.
      */
-    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => OptionalPromise<string[]>;
+    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => Awaitable<string[]>;
     /**
      * A function that returns user info from user IDs.
      * You should return a list of user objects of the same size, in the same order.
      */
-    resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>;
+    resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
     /**
      * A function that returns room info from room IDs.
      * You should return a list of room info objects of the same size, in the same order.
      */
-    resolveRoomsInfo?: (args: ResolveRoomsInfoArgs) => OptionalPromise<(DRI | undefined)[] | undefined>;
+    resolveRoomsInfo?: (args: ResolveRoomsInfoArgs) => Awaitable<(DRI | undefined)[] | undefined>;
     /**
      * Prevent the current browser tab from being closed if there are any locally
      * pending Liveblocks changes that haven't been submitted to or confirmed by
@@ -3247,7 +3212,7 @@ type StringifyCommentBodyOptions<U extends BaseUserMeta = DU> = {
      * A function that returns user info from user IDs.
      * You should return a list of user objects of the same size, in the same order.
      */
-    resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>;
+    resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
 };
 declare function isCommentBodyText(element: CommentBodyElement): element is CommentBodyText;
 declare function isCommentBodyMention(element: CommentBodyElement): element is CommentBodyMention;
@@ -3256,7 +3221,7 @@ declare function isCommentBodyLink(element: CommentBodyElement): element is Comm
  * Get an array of each user's ID that has been mentioned in a `CommentBody`.
  */
 declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
-declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
+declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
 declare function htmlSafe(value: string): HtmlSafeString;
 declare class HtmlSafeString {
     #private;
@@ -3597,18 +3562,6 @@ type DistributiveOmit<T, K extends PropertyKey> = T extends any ? Omit<T, K> : n
  * Throw an error, but as an expression instead of a statement.
  */
 declare function raise(msg: string): never;
-/**
- * Drop-in replacement for Object.entries() that retains better types.
- */
-declare function entries<O extends {
-    [key: string]: unknown;
-}, K extends keyof O>(obj: O): [K, O[K]][];
-/**
- * Drop-in replacement for Object.keys() that retains better types.
- */
-declare function keys<O extends {
-    [key: string]: unknown;
-}, K extends keyof O>(obj: O): K[];
 /**
  * Creates a new object by mapping a function over all values. Keys remain the
  * same. Think Array.prototype.map(), but for values in an object.
@@ -3926,4 +3879,4 @@ declare const CommentsApiError: typeof HttpError;
 /** @deprecated Use HttpError instead. */
 declare const NotificationsApiError: typeof HttpError;
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type PartialUserNotificationSettings, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserNotificationSettings, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, entries, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };