@liveblocks/core 2.17.0-usrnotsettings3 → 2.18.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,
@@ -2406,6 +2422,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;
@@ -2443,6 +2468,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;
+type LargeMessageStrategy = "default" | "split" | "experimental-fallback-to-http";
 
 /**
  * Pre-defined notification channels support list.
@@ -2668,6 +2694,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?: {
@@ -2821,7 +2857,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 = {
     /**
@@ -3123,22 +3159,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
@@ -3249,7 +3287,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;
@@ -3258,7 +3296,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;
@@ -3928,4 +3966,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, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, 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 };

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,
@@ -2406,6 +2422,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;
@@ -2443,6 +2468,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;
+type LargeMessageStrategy = "default" | "split" | "experimental-fallback-to-http";
 
 /**
  * Pre-defined notification channels support list.
@@ -2668,6 +2694,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?: {
@@ -2821,7 +2857,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 = {
     /**
@@ -3123,22 +3159,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
@@ -3249,7 +3287,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;
@@ -3258,7 +3296,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;
@@ -3928,4 +3966,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, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, 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 };

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "2.17.0-usrnotsettings3";
+var PKG_VERSION = "2.18.0";
 var PKG_FORMAT = "cjs";
 
 // src/dupe-detection.ts
@@ -1562,6 +1562,29 @@ function createApiClient({
       }
     );
   }
+  async function executeContextualPrompt(options) {
+    const result = await httpClient.post(
+      url`/v2/c/rooms/${options.roomId}/ai/contextual-prompt`,
+      await authManager.getAuthValue({
+        requestedScope: "room:read",
+        roomId: options.roomId
+      }),
+      {
+        prompt: options.prompt,
+        context: {
+          beforeSelection: options.context.beforeSelection,
+          selection: options.context.selection,
+          afterSelection: options.context.afterSelection
+        },
+        previous: options.previous
+      },
+      { signal: options.signal }
+    );
+    if (!result || result.content.length === 0) {
+      throw new Error("No content returned from server");
+    }
+    return result.content[0].text;
+  }
   async function listTextVersions(options) {
     const result = await httpClient.get(
       url`/v2/c/rooms/${options.roomId}/versions`,
@@ -1819,7 +1842,9 @@ function createApiClient({
     updateUserNotificationSettings,
     // User threads
     getUserThreads_experimental,
-    getUserThreadsSince_experimental
+    getUserThreadsSince_experimental,
+    // AI
+    executeContextualPrompt
   };
 }
 function getBearerTokenFromAuthValue(authValue) {
@@ -6345,7 +6370,7 @@ function defaultMessageFromContext(context) {
 }
 
 // src/room.ts
-var MAX_SOCKET_MESSAGE_SIZE = 1024 * 1024 - 1024;
+var MAX_SOCKET_MESSAGE_SIZE = 1024 * 1024 - 512;
 function makeIdFactory(connectionId) {
   let count = 0;
   return () => `${connectionId}:${count++}`;
@@ -6614,24 +6639,88 @@ function createRoom(options, config) {
   async function createTextVersion() {
     return httpClient.createTextVersion({ roomId });
   }
+  async function executeContextualPrompt(options2) {
+    return httpClient.executeContextualPrompt({
+      roomId,
+      ...options2
+    });
+  }
+  function* chunkOps(msg) {
+    const { ops, ...rest } = msg;
+    if (ops.length < 2) {
+      throw new Error("Cannot split ops into smaller chunks");
+    }
+    const mid = Math.floor(ops.length / 2);
+    const firstHalf = ops.slice(0, mid);
+    const secondHalf = ops.slice(mid);
+    for (const halfOps of [firstHalf, secondHalf]) {
+      const half = { ops: halfOps, ...rest };
+      const text = JSON.stringify([half]);
+      if (!isTooBigForWebSocket(text)) {
+        yield text;
+      } else {
+        yield* chunkOps(half);
+      }
+    }
+  }
+  function* chunkMessages(messages) {
+    if (messages.length < 2) {
+      if (messages[0].type === 201 /* UPDATE_STORAGE */) {
+        yield* chunkOps(messages[0]);
+        return;
+      } else {
+        throw new Error(
+          "Cannot split into chunks smaller than the allowed message size"
+        );
+      }
+    }
+    const mid = Math.floor(messages.length / 2);
+    const firstHalf = messages.slice(0, mid);
+    const secondHalf = messages.slice(mid);
+    for (const half of [firstHalf, secondHalf]) {
+      const text = JSON.stringify(half);
+      if (!isTooBigForWebSocket(text)) {
+        yield text;
+      } else {
+        yield* chunkMessages(half);
+      }
+    }
+  }
+  function isTooBigForWebSocket(text) {
+    if (text.length * 4 < MAX_SOCKET_MESSAGE_SIZE) {
+      return false;
+    }
+    return new TextEncoder().encode(text).length >= MAX_SOCKET_MESSAGE_SIZE;
+  }
   function sendMessages(messages) {
-    const serializedPayload = JSON.stringify(messages);
-    const nonce = _optionalChain([context, 'access', _142 => _142.dynamicSessionInfoSig, 'access', _143 => _143.get, 'call', _144 => _144(), 'optionalAccess', _145 => _145.nonce]);
-    if (config.unstable_fallbackToHTTP && nonce) {
-      const size = new TextEncoder().encode(serializedPayload).length;
-      if (size > MAX_SOCKET_MESSAGE_SIZE) {
+    const strategy = _nullishCoalesce(config.largeMessageStrategy, () => ( "default"));
+    const text = JSON.stringify(messages);
+    if (!isTooBigForWebSocket(text)) {
+      return managedSocket.send(text);
+    }
+    switch (strategy) {
+      case "default": {
+        error2("Message is too large for websockets, not sending. Configure largeMessageStrategy option to deal with this.");
+        return;
+      }
+      case "split": {
+        warn("Message is too large for websockets, splitting into smaller chunks");
+        for (const chunk2 of chunkMessages(messages)) {
+          managedSocket.send(chunk2);
+        }
+        return;
+      }
+      case "experimental-fallback-to-http": {
+        warn("Message is too large for websockets, so sending over HTTP instead");
+        const nonce = _nullishCoalesce(_optionalChain([context, 'access', _142 => _142.dynamicSessionInfoSig, 'access', _143 => _143.get, 'call', _144 => _144(), 'optionalAccess', _145 => _145.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();
           }
         });
-        warn(
-          "Message was too large for websockets and sent over HTTP instead"
-        );
         return;
       }
     }
-    managedSocket.send(serializedPayload);
   }
   const self = DerivedSignal.from(
     context.staticSessionInfoSig,
@@ -7598,6 +7687,8 @@ ${Array.from(traces).join("\n\n")}`
         getTextVersion,
         // create a version
         createTextVersion,
+        // execute a contextual prompt
+        executeContextualPrompt,
         // Support for the Liveblocks browser extension
         getSelf_forDevTools: () => selfAsTreeNode.get(),
         getOthers_forDevTools: () => others_forDevTools.get(),
@@ -7902,7 +7993,7 @@ function createClient(options) {
         enableDebugLogging: clientOptions.enableDebugLogging,
         baseUrl,
         errorEventSource: liveblocksErrorSource,
-        unstable_fallbackToHTTP: !!clientOptions.unstable_fallbackToHTTP,
+        largeMessageStrategy: _nullishCoalesce(clientOptions.largeMessageStrategy, () => ( (clientOptions.unstable_fallbackToHTTP ? "experimental-fallback-to-http" : void 0))),
         unstable_streamData: !!clientOptions.unstable_streamData,
         roomHttpClient: httpClient,
         createSyncSource