@liveblocks/core 3.13.0-vincent3 → 3.13.1-hackathon

package/dist/index.d.cts

@@ -331,6 +331,80 @@ type ContextualPromptContext = {
     afterSelection: string;
 };
 
+declare const brand: unique symbol;
+type Brand<T, TBrand extends string> = T & {
+    [brand]: TBrand;
+};
+type ISODateString = Brand<string, "ISODateString">;
+type DistributiveOmit<T, K extends PropertyKey> = T extends any ? Omit<T, K> : never;
+type WithRequired<T, K extends keyof T> = T & {
+    [P in K]-?: T[P];
+};
+type WithOptional<T, K extends keyof T> = Omit<T, K> & {
+    [P in K]?: T[P];
+};
+/**
+ * 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.
+ */
+declare function mapValues<V, O extends Record<string, unknown>>(obj: O, mapFn: (value: O[keyof O], key: keyof O) => V): {
+    [K in keyof O]: V;
+};
+/**
+ * Alternative to JSON.parse() that will not throw in production. If the passed
+ * string cannot be parsed, this will return `undefined`.
+ */
+declare function tryParseJson(rawMessage: string): Json | undefined;
+/**
+ * Decode base64 string.
+ */
+declare function b64decode(b64value: string): string;
+type RemoveUndefinedValues<T> = {
+    [K in keyof T]-?: Exclude<T[K], undefined>;
+};
+/**
+ * Returns a new object instance where all explictly-undefined values are
+ * removed.
+ */
+declare function compactObject<O extends Record<string, unknown>>(obj: O): RemoveUndefinedValues<O>;
+/**
+ * Returns a promise that resolves after the given number of milliseconds.
+ */
+declare function wait(millis: number): Promise<void>;
+/**
+ * Returns whatever the given promise returns, but will be rejected with
+ * a "Timed out" error if the given promise does not return or reject within
+ * the given timeout period (in milliseconds).
+ */
+declare function withTimeout<T>(promise: Promise<T>, millis: number, errmsg: string): Promise<T>;
+/**
+ * Memoize a promise factory, so that each subsequent call will return the same
+ * pending or success promise. If the promise rejects, will retain that failed
+ * promise for a small time period, after which the next attempt will reset the
+ * memoized value.
+ */
+declare function memoizeOnSuccess<T>(factoryFn: () => Promise<T>): () => Promise<T>;
+/**
+ * Polyfill for Array.prototype.findLastIndex()
+ */
+declare function findLastIndex<T>(arr: T[], predicate: (value: T, index: number, obj: T[]) => boolean): number;
+
 type OpCode = (typeof OpCode)[keyof typeof OpCode];
 declare const OpCode: Readonly<{
     INIT: 0;
@@ -358,7 +432,7 @@ declare namespace OpCode {
  * These operations are the payload for {@link UpdateStorageServerMsg} messages
  * only.
  */
-type Op = CreateOp | UpdateObjectOp | DeleteCrdtOp | SetParentKeyOp | DeleteObjectKeyOp | AckOp;
+type Op = CreateOp | UpdateObjectOp | DeleteCrdtOp | SetParentKeyOp | DeleteObjectKeyOp;
 type CreateOp = CreateObjectOp | CreateRegisterOp | CreateMapOp | CreateListOp;
 type UpdateObjectOp = {
     readonly opId?: string;
@@ -426,6 +500,24 @@ type DeleteObjectKeyOp = {
     readonly type: OpCode.DELETE_OBJECT_KEY;
     readonly key: string;
 };
+type HasOpId = {
+    opId: string;
+};
+/**
+ * Ops sent from client → server. Always includes an opId so the server can
+ * acknowledge the receipt.
+ */
+type ClientWireOp = Op & HasOpId;
+/**
+ * ServerWireOp: Ops sent from server → client. Three variants:
+ * 1. ClientWireOp — Full echo back of our own op, confirming it was applied
+ * 2. AckOp — Our op was seen but intentionally ignored (still counts as ack)
+ * 3. Op without opId — Another client's op being forwarded to us
+ */
+type ServerWireOp = ClientWireOp | AckOp | TheirOp;
+type TheirOp = DistributiveOmit<Op, "opId"> & {
+    opId?: undefined;
+};
 
 type ClientMsgCode = (typeof ClientMsgCode)[keyof typeof ClientMsgCode];
 declare const ClientMsgCode: Readonly<{
@@ -435,6 +527,8 @@ declare const ClientMsgCode: Readonly<{
     UPDATE_STORAGE: 201;
     FETCH_YDOC: 300;
     UPDATE_YDOC: 301;
+    FETCH_AGENT_SESSIONS: 500;
+    FETCH_AGENT_MESSAGES: 502;
 }>;
 declare namespace ClientMsgCode {
     type UPDATE_PRESENCE = typeof ClientMsgCode.UPDATE_PRESENCE;
@@ -443,11 +537,13 @@ declare namespace ClientMsgCode {
     type UPDATE_STORAGE = typeof ClientMsgCode.UPDATE_STORAGE;
     type FETCH_YDOC = typeof ClientMsgCode.FETCH_YDOC;
     type UPDATE_YDOC = typeof ClientMsgCode.UPDATE_YDOC;
+    type FETCH_AGENT_SESSIONS = typeof ClientMsgCode.FETCH_AGENT_SESSIONS;
+    type FETCH_AGENT_MESSAGES = typeof ClientMsgCode.FETCH_AGENT_MESSAGES;
 }
 /**
  * Messages that can be sent from the client to the server.
  */
-type ClientMsg<P extends JsonObject, E extends Json> = BroadcastEventClientMsg<E> | UpdatePresenceClientMsg<P> | UpdateStorageClientMsg | FetchStorageClientMsg | FetchYDocClientMsg | UpdateYDocClientMsg;
+type ClientMsg<P extends JsonObject, E extends Json> = BroadcastEventClientMsg<E> | UpdatePresenceClientMsg<P> | UpdateStorageClientMsg | FetchStorageClientMsg | FetchYDocClientMsg | UpdateYDocClientMsg | FetchAgentSessionsClientMsg | FetchAgentMessagesClientMsg;
 type BroadcastEventClientMsg<E extends Json> = {
     type: ClientMsgCode.BROADCAST_EVENT;
     event: E;
@@ -480,7 +576,7 @@ type UpdatePresenceClientMsg<P extends JsonObject> = {
 };
 type UpdateStorageClientMsg = {
     readonly type: ClientMsgCode.UPDATE_STORAGE;
-    readonly ops: Op[];
+    readonly ops: ClientWireOp[];
 };
 type FetchStorageClientMsg = {
     readonly type: ClientMsgCode.FETCH_STORAGE;
@@ -497,6 +593,20 @@ type UpdateYDocClientMsg = {
     readonly guid?: string;
     readonly v2?: boolean;
 };
+type FetchAgentSessionsClientMsg = {
+    readonly type: ClientMsgCode.FETCH_AGENT_SESSIONS;
+    readonly cursor?: string;
+    readonly since?: number;
+    readonly limit?: number;
+    readonly metadata?: Record<string, string>;
+};
+type FetchAgentMessagesClientMsg = {
+    readonly type: ClientMsgCode.FETCH_AGENT_MESSAGES;
+    readonly sessionId: string;
+    readonly cursor?: string;
+    readonly since?: number;
+    readonly limit?: number;
+};
 
 /**
  * Represents an indefinitely deep arbitrary immutable data
@@ -590,7 +700,6 @@ declare namespace CrdtType {
 }
 type SerializedCrdt = SerializedRootObject | SerializedChild;
 type SerializedChild = SerializedObject | SerializedList | SerializedMap | SerializedRegister;
-type NodeStream = Iterable<IdTuple<SerializedCrdt>>;
 type SerializedRootObject = {
     readonly type: CrdtType.OBJECT;
     readonly data: JsonObject;
@@ -619,36 +728,6 @@ type SerializedRegister = {
     readonly parentKey: string;
     readonly data: Json;
 };
-type CompactNode = CompactRootNode | CompactChildNode;
-type CompactChildNode = CompactObjectNode | CompactListNode | CompactMapNode | CompactRegisterNode;
-type CompactRootNode = readonly [id: "root", data: JsonObject];
-type CompactObjectNode = readonly [
-    id: string,
-    type: CrdtType.OBJECT,
-    parentId: string,
-    parentKey: string,
-    data: JsonObject
-];
-type CompactListNode = readonly [
-    id: string,
-    type: CrdtType.LIST,
-    parentId: string,
-    parentKey: string
-];
-type CompactMapNode = readonly [
-    id: string,
-    type: CrdtType.MAP,
-    parentId: string,
-    parentKey: string
-];
-type CompactRegisterNode = readonly [
-    id: string,
-    type: CrdtType.REGISTER,
-    parentId: string,
-    parentKey: string,
-    data: Json
-];
-declare function nodeStreamToCompactNodes(nodes: NodeStream): Iterable<CompactNode>;
 
 type LiveObjectUpdateDelta<O extends {
     [key: string]: unknown;
@@ -682,7 +761,7 @@ declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
      */
     static detectLargeObjects: boolean;
     /** @private Do not use this API directly */
-    static _fromItems<O extends LsonObject>(nodes: NodeStream, pool: ManagedPool): LiveObject<O>;
+    static _fromItems<O extends LsonObject>(items: IdTuple<SerializedCrdt>[], pool: ManagedPool): LiveObject<O>;
     constructor(obj?: O);
     /**
      * Transform the LiveObject into a javascript object
@@ -838,7 +917,7 @@ interface ManagedPool {
      * - Add reverse operations to the undo/redo stack
      * - Notify room subscribers with updates (in-client, no networking)
      */
-    dispatch: (ops: Op[], reverseOps: Op[], storageUpdates: Map<string, StorageUpdate>) => void;
+    dispatch: (ops: ClientWireOp[], reverseOps: Op[], storageUpdates: Map<string, StorageUpdate>) => void;
     /**
      * Ensures storage can be written to else throws an error.
      * This is used to prevent writing to storage when the user does not have
@@ -858,7 +937,7 @@ type CreateManagedPoolOptions = {
     /**
      * Will get invoked when any Live structure calls .dispatch() on the pool.
      */
-    onDispatch?: (ops: Op[], reverse: Op[], storageUpdates: Map<string, StorageUpdate>) => void;
+    onDispatch?: (ops: ClientWireOp[], reverse: Op[], storageUpdates: Map<string, StorageUpdate>) => void;
     /**
      * Will get invoked when any Live structure calls .assertStorageIsWritable()
      * on the pool. Defaults to true when not provided. Return false if you want
@@ -1169,7 +1248,7 @@ declare global {
         [key: string]: unknown;
     }
 }
-type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "GroupInfo" | "ActivitiesData";
+type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "CommentMetadata" | "RoomInfo" | "GroupInfo" | "ActivitiesData";
 type MakeErrorString<K extends ExtendableTypes, Reason extends string = "does not match its requirements"> = `The type you provided for '${K}' ${Reason}. To learn how to fix this, see https://liveblocks.io/docs/errors/${K}`;
 type GetOverride<K extends ExtendableTypes, B, Reason extends string = "does not match its requirements"> = GetOverrideOrErrorValue<K, B, MakeErrorString<K, Reason>>;
 type GetOverrideOrErrorValue<K extends ExtendableTypes, B, ErrorType> = unknown extends Liveblocks[K] ? B : Liveblocks[K] extends B ? Liveblocks[K] : ErrorType;
@@ -1177,7 +1256,8 @@ type DP = GetOverride<"Presence", JsonObject, "is not a valid JSON object">;
 type DS = GetOverride<"Storage", LsonObject, "is not a valid LSON value">;
 type DU = GetOverrideOrErrorValue<"UserMeta", BaseUserMeta, Record<"id" | "info", MakeErrorString<"UserMeta">>>;
 type DE = GetOverride<"RoomEvent", Json, "is not a valid JSON value">;
-type DM = GetOverride<"ThreadMetadata", BaseMetadata>;
+type DTM = GetOverride<"ThreadMetadata", BaseMetadata>;
+type DCM = GetOverride<"CommentMetadata", BaseMetadata>;
 type DRI = GetOverride<"RoomInfo", BaseRoomInfo>;
 type DGI = GetOverride<"GroupInfo", BaseGroupInfo>;
 type DAD = GetOverrideOrErrorValue<"ActivitiesData", BaseActivitiesData, {
@@ -1242,7 +1322,7 @@ type CommentMixedAttachment = CommentAttachment | CommentLocalAttachment;
 /**
  * Represents a comment.
  */
-type CommentData = {
+type CommentData<CM extends BaseMetadata = DCM> = {
     type: "comment";
     id: string;
     threadId: string;
@@ -1252,13 +1332,15 @@ type CommentData = {
     editedAt?: Date;
     reactions: CommentReaction[];
     attachments: CommentAttachment[];
+    metadata: CM;
 } & Relax<{
     body: CommentBody;
 } | {
     deletedAt: Date;
 }>;
-type CommentDataPlain = Omit<DateToString<CommentData>, "reactions" | "body"> & {
+type CommentDataPlain<CM extends BaseMetadata = DCM> = Omit<DateToString<CommentData<CM>>, "reactions" | "body" | "metadata"> & {
     reactions: DateToString<CommentReaction>[];
+    metadata: CM;
 } & Relax<{
     body: CommentBody;
 } | {
@@ -1288,13 +1370,15 @@ type CommentBodyLink = {
     url: string;
     text?: string;
 };
-type CommentBodyText = {
+type CommentBodyText = Resolve<{
     bold?: boolean;
     italic?: boolean;
     strikethrough?: boolean;
     code?: boolean;
     text: string;
-};
+} & {
+    [K in Exclude<keyof Relax<CommentBodyMention | CommentBodyLink>, "text">]?: never;
+}>;
 type CommentBody = {
     version: 1;
     content: CommentBodyBlockElement[];
@@ -1313,22 +1397,22 @@ type SearchCommentsResult = {
 /**
  * Represents a thread of comments.
  */
-type ThreadData<M extends BaseMetadata = DM> = {
+type ThreadData<TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM> = {
     type: "thread";
     id: string;
     roomId: string;
     createdAt: Date;
     updatedAt: Date;
-    comments: CommentData[];
-    metadata: M;
+    comments: CommentData<CM>[];
+    metadata: TM;
     resolved: boolean;
 };
-interface ThreadDataWithDeleteInfo<M extends BaseMetadata = DM> extends ThreadData<M> {
+interface ThreadDataWithDeleteInfo<TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM> extends ThreadData<TM, CM> {
     deletedAt?: Date;
 }
-type ThreadDataPlain<M extends BaseMetadata> = Omit<DateToString<ThreadData<M>>, "comments" | "metadata"> & {
-    comments: CommentDataPlain[];
-    metadata: M;
+type ThreadDataPlain<TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM> = Omit<DateToString<ThreadData<TM, CM>>, "comments" | "metadata"> & {
+    comments: CommentDataPlain<CM>[];
+    metadata: TM;
 };
 type ThreadDeleteInfo = {
     type: "deletedThread";
@@ -1566,17 +1650,17 @@ type MakeOptionalFieldsNullable<T> = {
 };
 type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
 
-interface RoomHttpApi<M extends BaseMetadata> {
+interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
     getThreads(options: {
         roomId: string;
         cursor?: string;
         query?: {
             resolved?: boolean;
             subscribed?: boolean;
-            metadata?: Partial<QueryMetadata<M>>;
+            metadata?: Partial<QueryMetadata<TM>>;
         };
     }): Promise<{
-        threads: ThreadData<M>[];
+        threads: ThreadData<TM, CM>[];
         inboxNotifications: InboxNotificationData[];
         subscriptions: SubscriptionData[];
         requestedAt: Date;
@@ -1589,7 +1673,7 @@ interface RoomHttpApi<M extends BaseMetadata> {
         signal?: AbortSignal;
     }): Promise<{
         threads: {
-            updated: ThreadData<M>[];
+            updated: ThreadData<TM, CM>[];
             deleted: ThreadDeleteInfo[];
         };
         inboxNotifications: {
@@ -1606,7 +1690,7 @@ interface RoomHttpApi<M extends BaseMetadata> {
     searchComments(options: {
         roomId: string;
         query: {
-            threadMetadata?: Partial<QueryMetadata<M>>;
+            threadMetadata?: Partial<QueryMetadata<TM>>;
             threadResolved?: boolean;
             hasAttachments?: boolean;
             hasMentions?: boolean;
@@ -1617,19 +1701,20 @@ interface RoomHttpApi<M extends BaseMetadata> {
     }): Promise<{
         data: Array<SearchCommentsResult>;
     }>;
-    createThread({ roomId, metadata, body, commentId, threadId, attachmentIds, }: {
+    createThread({ roomId, metadata, body, commentId, threadId, commentMetadata, attachmentIds, }: {
         roomId: string;
         threadId?: string;
         commentId?: string;
-        metadata: M | undefined;
+        metadata: TM | undefined;
+        commentMetadata: CM | undefined;
         body: CommentBody;
         attachmentIds?: string[];
-    }): Promise<ThreadData<M>>;
+    }): Promise<ThreadData<TM, CM>>;
     getThread(options: {
         roomId: string;
         threadId: string;
     }): Promise<{
-        thread?: ThreadData<M>;
+        thread?: ThreadData<TM, CM>;
         inboxNotification?: InboxNotificationData;
         subscription?: SubscriptionData;
     }>;
@@ -1639,23 +1724,31 @@ interface RoomHttpApi<M extends BaseMetadata> {
     }): Promise<void>;
     editThreadMetadata({ roomId, metadata, threadId, }: {
         roomId: string;
-        metadata: Patchable<M>;
+        metadata: Patchable<TM>;
+        threadId: string;
+    }): Promise<TM>;
+    editCommentMetadata({ roomId, threadId, commentId, metadata, }: {
+        roomId: string;
         threadId: string;
-    }): Promise<M>;
-    createComment({ roomId, threadId, commentId, body, attachmentIds, }: {
+        commentId: string;
+        metadata: Patchable<CM>;
+    }): Promise<CM>;
+    createComment({ roomId, threadId, commentId, body, metadata, attachmentIds, }: {
         roomId: string;
         threadId: string;
         commentId?: string;
         body: CommentBody;
+        metadata?: CM;
         attachmentIds?: string[];
-    }): Promise<CommentData>;
-    editComment({ roomId, threadId, commentId, body, attachmentIds, }: {
+    }): Promise<CommentData<CM>>;
+    editComment({ roomId, threadId, commentId, body, attachmentIds, metadata, }: {
         roomId: string;
         threadId: string;
         commentId: string;
         body: CommentBody;
         attachmentIds?: string[];
-    }): Promise<CommentData>;
+        metadata?: Patchable<CM>;
+    }): Promise<CommentData<CM>>;
     deleteComment({ roomId, threadId, commentId, }: {
         roomId: string;
         threadId: string;
@@ -1793,7 +1886,7 @@ interface RoomHttpApi<M extends BaseMetadata> {
         signal: AbortSignal;
     }): Promise<string>;
 }
-interface NotificationHttpApi<M extends BaseMetadata> {
+interface NotificationHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
     getInboxNotifications(options?: {
         cursor?: string;
         query?: {
@@ -1802,7 +1895,7 @@ interface NotificationHttpApi<M extends BaseMetadata> {
         };
     }): Promise<{
         inboxNotifications: InboxNotificationData[];
-        threads: ThreadData<M>[];
+        threads: ThreadData<TM, CM>[];
         subscriptions: SubscriptionData[];
         nextCursor: string | null;
         requestedAt: Date;
@@ -1820,7 +1913,7 @@ interface NotificationHttpApi<M extends BaseMetadata> {
             deleted: InboxNotificationDeleteInfo[];
         };
         threads: {
-            updated: ThreadData<M>[];
+            updated: ThreadData<TM, CM>[];
             deleted: ThreadDeleteInfo[];
         };
         subscriptions: {
@@ -1845,16 +1938,16 @@ interface NotificationHttpApi<M extends BaseMetadata> {
     }): Promise<NotificationSettingsPlain>;
     updateNotificationSettings(settings: PartialNotificationSettings): Promise<NotificationSettingsPlain>;
 }
-interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, NotificationHttpApi<M> {
+interface LiveblocksHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> extends RoomHttpApi<TM, CM>, NotificationHttpApi<TM, CM> {
     getUrlMetadata(url: string): Promise<UrlMetadata>;
     getUserThreads_experimental(options?: {
         cursor?: string;
         query?: {
             resolved?: boolean;
-            metadata?: Partial<QueryMetadata<M>>;
+            metadata?: Partial<QueryMetadata<TM>>;
         };
     }): Promise<{
-        threads: ThreadData<M>[];
+        threads: ThreadData<TM, CM>[];
         inboxNotifications: InboxNotificationData[];
         subscriptions: SubscriptionData[];
         nextCursor: string | null;
@@ -1870,7 +1963,7 @@ interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, Noti
             deleted: InboxNotificationDeleteInfo[];
         };
         threads: {
-            updated: ThreadData<M>[];
+            updated: ThreadData<TM, CM>[];
             deleted: ThreadDeleteInfo[];
         };
         subscriptions: {
@@ -1930,6 +2023,7 @@ type CommentsOrNotificationsErrorContext = {
     commentId: string;
     body: CommentBody;
     metadata: BaseMetadata;
+    commentMetadata: BaseMetadata;
 } | {
     type: "DELETE_THREAD_ERROR";
     roomId: string;
@@ -1939,6 +2033,12 @@ type CommentsOrNotificationsErrorContext = {
     roomId: string;
     threadId: string;
     metadata: Patchable<BaseMetadata>;
+} | {
+    type: "EDIT_COMMENT_METADATA_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    metadata: Patchable<BaseMetadata>;
 } | {
     type: "MARK_THREAD_AS_RESOLVED_ERROR" | "MARK_THREAD_AS_UNRESOLVED_ERROR" | "SUBSCRIBE_TO_THREAD_ERROR" | "UNSUBSCRIBE_FROM_THREAD_ERROR";
     roomId: string;
@@ -1949,6 +2049,7 @@ type CommentsOrNotificationsErrorContext = {
     threadId: string;
     commentId: string;
     body: CommentBody;
+    metadata: BaseMetadata;
 } | {
     type: "DELETE_COMMENT_ERROR";
     roomId: string;
@@ -2059,7 +2160,7 @@ type InternalSyncStatus = SyncStatus | "has-local-changes";
  * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
  * will probably happen if you do.
  */
-type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
+type PrivateClientApi<U extends BaseUserMeta, TM extends BaseMetadata, CM extends BaseMetadata> = {
     readonly currentUserId: Signal<string | undefined>;
     readonly mentionSuggestionsCache: Map<string, MentionData[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
@@ -2067,13 +2168,13 @@ type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly roomsInfoStore: BatchStore<DRI | undefined, string>;
     readonly groupsInfoStore: BatchStore<DGI | undefined, string>;
     readonly getRoomIds: () => string[];
-    readonly httpClient: LiveblocksHttpApi<M>;
-    as<M2 extends BaseMetadata>(): Client<U, M2>;
+    readonly httpClient: LiveblocksHttpApi<TM, CM>;
+    as<TM2 extends BaseMetadata, CM2 extends BaseMetadata>(): Client<U, TM2, CM2>;
     createSyncSource(): SyncSource;
     emitError(context: LiveblocksErrorContext, cause?: Error): void;
     ai: Ai;
 };
-type NotificationsApi<M extends BaseMetadata> = {
+type NotificationsApi<TM extends BaseMetadata, CM extends BaseMetadata> = {
     /**
      * Gets a page (or the initial page) for user inbox notifications and their
      * associated threads and thread subscriptions.
@@ -2100,7 +2201,7 @@ type NotificationsApi<M extends BaseMetadata> = {
         };
     }): Promise<{
         inboxNotifications: InboxNotificationData[];
-        threads: ThreadData<M>[];
+        threads: ThreadData<TM, CM>[];
         subscriptions: SubscriptionData[];
         nextCursor: string | null;
         requestedAt: Date;
@@ -2141,7 +2242,7 @@ type NotificationsApi<M extends BaseMetadata> = {
             deleted: InboxNotificationDeleteInfo[];
         };
         threads: {
-            updated: ThreadData<M>[];
+            updated: ThreadData<TM, CM>[];
             deleted: ThreadDeleteInfo[];
         };
         subscriptions: {
@@ -2221,23 +2322,23 @@ type NotificationsApi<M extends BaseMetadata> = {
  * narrower.
  */
 type OpaqueClient = Client<BaseUserMeta>;
-type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
+type Client<U extends BaseUserMeta = DU, TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM> = {
     /**
      * Gets a room. Returns null if {@link Client.enter} has not been called previously.
      *
      * @param roomId The id of the room
      */
-    getRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, M2 extends BaseMetadata = M>(roomId: string): Room<P, S, U, E, M2> | null;
+    getRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, TM2 extends BaseMetadata = TM, CM2 extends BaseMetadata = CM>(roomId: string): Room<P, S, U, E, TM2, CM2> | null;
     /**
      * Enter a room.
      * @param roomId The id of the room
      * @param options Optional. You can provide initializers for the Presence or Storage when entering the Room.
      * @returns The room and a leave function. Call the returned leave() function when you no longer need the room.
      */
-    enterRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, M2 extends BaseMetadata = M>(roomId: string, ...args: OptionalTupleUnless<P & S, [
+    enterRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, TM2 extends BaseMetadata = TM, CM2 extends BaseMetadata = CM>(roomId: string, ...args: OptionalTupleUnless<P & S, [
         options: EnterOptions<NoInfr<P>, NoInfr<S>>
     ]>): {
-        room: Room<P, S, U, E, M2>;
+        room: Room<P, S, U, E, TM2, CM2>;
         leave: () => void;
     };
     /**
@@ -2303,7 +2404,7 @@ type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
      * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
      * will probably happen if you do.
      */
-    readonly [kInternal]: PrivateClientApi<U, M>;
+    readonly [kInternal]: PrivateClientApi<U, TM, CM>;
     /**
      * Returns the current global sync status of the Liveblocks client. If any
      * part of Liveblocks has any local pending changes that haven't been
@@ -2327,7 +2428,7 @@ type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
         readonly error: Observable<LiveblocksError>;
         readonly syncStatus: Observable<void>;
     };
-} & NotificationsApi<M>;
+} & NotificationsApi<TM, CM>;
 type AuthEndpoint = string | ((room?: string) => Promise<CustomAuthenticationResult>);
 /**
  * The authentication endpoint that is called to ensure that the current user has access to a room.
@@ -2514,6 +2615,17 @@ type Delegates<T extends BaseAuthResult> = {
     canZombie: () => boolean;
 };
 
+type AgentSession = {
+    sessionId: string;
+    metadata: Json;
+    timestamp: number;
+};
+type AgentMessage = {
+    id: string;
+    timestamp: number;
+    data: Json;
+};
+
 type ServerMsgCode = (typeof ServerMsgCode)[keyof typeof ServerMsgCode];
 declare const ServerMsgCode: Readonly<{
     UPDATE_PRESENCE: 100;
@@ -2521,9 +2633,7 @@ declare const ServerMsgCode: Readonly<{
     USER_LEFT: 102;
     BROADCASTED_EVENT: 103;
     ROOM_STATE: 104;
-    STORAGE_STATE_V7: 200;
-    STORAGE_CHUNK: 210;
-    STORAGE_STREAM_END: 211;
+    STORAGE_STATE: 200;
     UPDATE_STORAGE: 201;
     UPDATE_YDOC: 300;
     THREAD_CREATED: 400;
@@ -2535,6 +2645,9 @@ declare const ServerMsgCode: Readonly<{
     COMMENT_DELETED: 404;
     COMMENT_REACTION_ADDED: 405;
     COMMENT_REACTION_REMOVED: 406;
+    COMMENT_METADATA_UPDATED: 409;
+    AGENT_SESSIONS: 501;
+    AGENT_MESSAGES: 503;
     REJECT_STORAGE_OP: 299;
 }>;
 declare namespace ServerMsgCode {
@@ -2543,9 +2656,7 @@ declare namespace ServerMsgCode {
     type USER_LEFT = typeof ServerMsgCode.USER_LEFT;
     type BROADCASTED_EVENT = typeof ServerMsgCode.BROADCASTED_EVENT;
     type ROOM_STATE = typeof ServerMsgCode.ROOM_STATE;
-    type STORAGE_STATE_V7 = typeof ServerMsgCode.STORAGE_STATE_V7;
-    type STORAGE_CHUNK = typeof ServerMsgCode.STORAGE_CHUNK;
-    type STORAGE_STREAM_END = typeof ServerMsgCode.STORAGE_STREAM_END;
+    type STORAGE_STATE = typeof ServerMsgCode.STORAGE_STATE;
     type UPDATE_STORAGE = typeof ServerMsgCode.UPDATE_STORAGE;
     type UPDATE_YDOC = typeof ServerMsgCode.UPDATE_YDOC;
     type THREAD_CREATED = typeof ServerMsgCode.THREAD_CREATED;
@@ -2557,13 +2668,16 @@ declare namespace ServerMsgCode {
     type COMMENT_DELETED = typeof ServerMsgCode.COMMENT_DELETED;
     type COMMENT_REACTION_ADDED = typeof ServerMsgCode.COMMENT_REACTION_ADDED;
     type COMMENT_REACTION_REMOVED = typeof ServerMsgCode.COMMENT_REACTION_REMOVED;
+    type AGENT_SESSIONS = typeof ServerMsgCode.AGENT_SESSIONS;
+    type AGENT_MESSAGES = typeof ServerMsgCode.AGENT_MESSAGES;
+    type COMMENT_METADATA_UPDATED = typeof ServerMsgCode.COMMENT_METADATA_UPDATED;
     type REJECT_STORAGE_OP = typeof ServerMsgCode.REJECT_STORAGE_OP;
 }
 /**
  * Messages that can be sent from the server to the client.
  */
-type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | StorageStateServerMsg_V7 | StorageChunkServerMsg | StorageEndServerMsg | UpdateStorageServerMsg | YDocUpdateServerMsg | RejectedStorageOpServerMsg | CommentsEventServerMsg;
-type CommentsEventServerMsg = ThreadCreatedEvent | ThreadDeletedEvent | ThreadMetadataUpdatedEvent | ThreadUpdatedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved;
+type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | StorageStateServerMsg | UpdateStorageServerMsg | YDocUpdateServerMsg | RejectedStorageOpServerMsg | CommentsEventServerMsg | AgentSessionsServerMsg | AgentMessagesServerMsg;
+type CommentsEventServerMsg = ThreadCreatedEvent | ThreadDeletedEvent | ThreadMetadataUpdatedEvent | ThreadUpdatedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved | CommentMetadataUpdatedEvent;
 type ThreadCreatedEvent = {
     type: ServerMsgCode.THREAD_CREATED;
     threadId: string;
@@ -2607,6 +2721,11 @@ type CommentReactionRemoved = {
     commentId: string;
     emoji: string;
 };
+type CommentMetadataUpdatedEvent = {
+    type: ServerMsgCode.COMMENT_METADATA_UPDATED;
+    threadId: string;
+    commentId: string;
+};
 /**
  * Sent by the WebSocket server and broadcasted to all clients to announce that
  * a User updated their presence. For example, when a user moves their cursor.
@@ -2726,46 +2845,39 @@ type BroadcastedEventServerMsg<E extends Json> = {
  */
 type RoomStateServerMsg<U extends BaseUserMeta> = {
     readonly type: ServerMsgCode.ROOM_STATE;
-    /** Informs the client what their actor ID is going to be. */
+    /**
+     * Informs the client what their actor ID is going to be.
+     * @since v1.2 (WS API v7)
+     */
     readonly actor: number;
-    /** Secure nonce for the current session. */
+    /**
+     * Secure nonce for the current session.
+     * @since v1.2 (WS API v7)
+     */
     readonly nonce: string;
-    /** Informs the client what permissions the current User (self) has. */
+    /**
+     * Informs the client what permissions the current User (self) has.
+     * @since v1.2 (WS API v7)
+     */
     readonly scopes: string[];
     readonly users: {
         readonly [otherActor: number]: U & {
             scopes: string[];
         };
     };
-    /** Metadata sent from the server to the client. */
+    /**
+     * Metadata sent from the server to the client.
+     */
     readonly meta: JsonObject;
 };
-/**
- * No longer used as of WS API v8.
- */
-type StorageStateServerMsg_V7 = {
-    readonly type: ServerMsgCode.STORAGE_STATE_V7;
-    readonly items: IdTuple<SerializedCrdt>[];
-};
 /**
  * Sent by the WebSocket server to a single client in response to the client
- * sending a FetchStorageClientMsg message, to provide one chunk of the initial
- * Storage state of the Room.
- *
- * The server will respond with 1+ STORAGE_CHUNK messages, followed by exactly
- * one STORAGE_STREAM_END message to mark the end of the transmission.
- *
- * If the room is using the new storage engine that supports streaming, then
- * potentially multiple chunks might get sent. If the room is using the old
- * storage engine, then all nodes will be sent in a single/large chunk
- * (non-streaming).
+ * sending a FetchStorageClientMsg message, to provide the initial Storage
+ * state of the Room. The payload includes the entire Storage document.
  */
-type StorageChunkServerMsg = {
-    readonly type: ServerMsgCode.STORAGE_CHUNK;
-    readonly nodes: CompactNode[];
-};
-type StorageEndServerMsg = {
-    readonly type: ServerMsgCode.STORAGE_STREAM_END;
+type StorageStateServerMsg = {
+    readonly type: ServerMsgCode.STORAGE_STATE;
+    readonly items: IdTuple<SerializedCrdt>[];
 };
 /**
  * Sent by the WebSocket server and broadcasted to all clients to announce that
@@ -2776,7 +2888,7 @@ type StorageEndServerMsg = {
  */
 type UpdateStorageServerMsg = {
     readonly type: ServerMsgCode.UPDATE_STORAGE;
-    readonly ops: Op[];
+    readonly ops: ServerWireOp[];
 };
 /**
  * Sent by the WebSocket server to the client to indicate that certain opIds
@@ -2788,6 +2900,19 @@ type RejectedStorageOpServerMsg = {
     readonly opIds: string[];
     readonly reason: string;
 };
+type AgentSessionsServerMsg = {
+    readonly type: ServerMsgCode.AGENT_SESSIONS;
+    readonly sessions: AgentSession[];
+    readonly nextCursor?: string;
+    readonly operation: "list" | "added" | "updated" | "deleted";
+};
+type AgentMessagesServerMsg = {
+    readonly type: ServerMsgCode.AGENT_MESSAGES;
+    readonly sessionId: string;
+    readonly messages: AgentMessage[];
+    readonly nextCursor?: string;
+    readonly operation: "list" | "added" | "updated" | "deleted";
+};
 
 type HistoryVersion = {
     type: "historyVersion";
@@ -3095,12 +3220,12 @@ type SubscribeFn<P extends JsonObject, _TStorage extends LsonObject, U extends B
     (type: "storage-status", listener: Callback<StorageStatus>): () => void;
     (type: "comments", listener: Callback<CommentsEventServerMsg>): () => void;
 };
-type GetThreadsOptions<M extends BaseMetadata> = {
+type GetThreadsOptions<TM extends BaseMetadata> = {
     cursor?: string;
     query?: {
         resolved?: boolean;
         subscribed?: boolean;
-        metadata?: Partial<QueryMetadata<M>>;
+        metadata?: Partial<QueryMetadata<TM>>;
     };
 };
 type GetThreadsSinceOptions = {
@@ -3123,7 +3248,7 @@ type GetSubscriptionSettingsOptions = {
  * a Room instance using globally augmented types only, which is narrower.
  */
 type OpaqueRoom = Room<JsonObject, LsonObject, BaseUserMeta, Json, BaseMetadata>;
-type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUserMeta = DU, E extends Json = DE, M extends BaseMetadata = DM> = {
+type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUserMeta = DU, E extends Json = DE, TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM> = {
     /**
      * @private
      *
@@ -3196,6 +3321,29 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * Sends a request for the current document from liveblocks server
      */
     fetchYDoc(stateVector: string, guid?: string, isV2?: boolean): void;
+    /**
+     * Fetches agent sessions for the room.
+     */
+    fetchAgentSessions(options?: {
+        cursor?: string;
+        since?: number;
+        limit?: number;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        sessions: AgentSession[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Fetches agent messages for a specific session.
+     */
+    fetchAgentMessages(sessionId: string, options?: {
+        cursor?: string;
+        since?: number;
+        limit?: number;
+    }): Promise<{
+        messages: AgentMessage[];
+        nextCursor?: string;
+    }>;
     /**
      * Broadcasts an event to other users in the room. Event broadcasted to the room can be listened with {@link Room.subscribe}("event").
      * @param {any} event the event to broadcast. Should be serializable to JSON
@@ -3254,6 +3402,7 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         readonly storageStatus: Observable<StorageStatus>;
         readonly ydoc: Observable<YDocUpdateServerMsg | UpdateYDocClientMsg>;
         readonly comments: Observable<CommentsEventServerMsg>;
+        readonly agentSessions: Observable<AgentSessionsServerMsg | AgentMessagesServerMsg>;
         /**
          * Called right before the room is destroyed. The event cannot be used to
          * prevent the room from being destroyed, only to be informed that this is
@@ -3337,8 +3486,8 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      *   requestedAt
      * } = await room.getThreads({ query: { resolved: false }});
      */
-    getThreads(options?: GetThreadsOptions<M>): Promise<{
-        threads: ThreadData<M>[];
+    getThreads(options?: GetThreadsOptions<TM>): Promise<{
+        threads: ThreadData<TM, CM>[];
         inboxNotifications: InboxNotificationData[];
         subscriptions: SubscriptionData[];
         requestedAt: Date;
@@ -3355,7 +3504,7 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      */
     getThreadsSince(options: GetThreadsSinceOptions): Promise<{
         threads: {
-            updated: ThreadData<M>[];
+            updated: ThreadData<TM, CM>[];
             deleted: ThreadDeleteInfo[];
         };
         inboxNotifications: {
@@ -3376,7 +3525,7 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * const { thread, inboxNotification, subscription } = await room.getThread("th_xxx");
      */
     getThread(threadId: string): Promise<{
-        thread?: ThreadData<M>;
+        thread?: ThreadData<TM, CM>;
         inboxNotification?: InboxNotificationData;
         subscription?: SubscriptionData;
     }>;
@@ -3394,10 +3543,11 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
     createThread(options: {
         threadId?: string;
         commentId?: string;
-        metadata: M | undefined;
+        metadata: TM | undefined;
         body: CommentBody;
+        commentMetadata?: CM;
         attachmentIds?: string[];
-    }): Promise<ThreadData<M>>;
+    }): Promise<ThreadData<TM, CM>>;
     /**
      * Deletes a thread.
      *
@@ -3413,9 +3563,21 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * await room.editThreadMetadata({ threadId: "th_xxx", metadata: { x: 100, y: 100 } })
      */
     editThreadMetadata(options: {
-        metadata: Patchable<M>;
+        metadata: Patchable<TM>;
         threadId: string;
-    }): Promise<M>;
+    }): Promise<TM>;
+    /**
+     * Edits a comment's metadata.
+     * To delete an existing metadata property, set its value to `null`.
+     *
+     * @example
+     * await room.editCommentMetadata({ threadId: "th_xxx", commentId: "cm_xxx", metadata: { tag: "important", externalId: 1234 } })
+     */
+    editCommentMetadata(options: {
+        threadId: string;
+        commentId: string;
+        metadata: Patchable<CM>;
+    }): Promise<CM>;
     /**
      * Marks a thread as resolved.
      *
@@ -3460,8 +3622,9 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         threadId: string;
         commentId?: string;
         body: CommentBody;
+        metadata?: CM;
         attachmentIds?: string[];
-    }): Promise<CommentData>;
+    }): Promise<CommentData<CM>>;
     /**
      * Edits a comment.
      *
@@ -3479,8 +3642,9 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         threadId: string;
         commentId: string;
         body: CommentBody;
+        metadata?: Patchable<CM>;
         attachmentIds?: string[];
-    }): Promise<CommentData>;
+    }): Promise<CommentData<CM>>;
     /**
      * Deletes a comment.
      * If it is the last non-deleted comment, the thread also gets deleted.
@@ -3595,7 +3759,7 @@ interface SyncSource {
  */
 type PrivateRoomApi = {
     presenceBuffer: Json | undefined;
-    undoStack: readonly (readonly Readonly<HistoryOp<JsonObject>>[])[];
+    undoStack: readonly (readonly Readonly<Stackframe<JsonObject>>[])[];
     nodeCount: number;
     getYjsProvider(): IYjsProvider | undefined;
     setYjsProvider(provider: IYjsProvider | undefined): void;
@@ -3630,7 +3794,8 @@ type PrivateRoomApi = {
     };
     attachmentUrlsStore: BatchStore<string, string>;
 };
-type HistoryOp<P extends JsonObject> = Op | {
+type Stackframe<P extends JsonObject> = Op | PresenceStackframe<P>;
+type PresenceStackframe<P extends JsonObject> = {
     readonly type: "presence";
     readonly data: P;
 };
@@ -3673,80 +3838,6 @@ type OptionalTupleUnless<C, T extends any[]> = Record<string, never> extends C ?
 ] extends [never] ? OptionalTuple<T> : T;
 type LargeMessageStrategy = "default" | "split" | "experimental-fallback-to-http";
 
-declare const brand: unique symbol;
-type Brand<T, TBrand extends string> = T & {
-    [brand]: TBrand;
-};
-type ISODateString = Brand<string, "ISODateString">;
-type DistributiveOmit<T, K extends PropertyKey> = T extends any ? Omit<T, K> : never;
-type WithRequired<T, K extends keyof T> = T & {
-    [P in K]-?: T[P];
-};
-type WithOptional<T, K extends keyof T> = Omit<T, K> & {
-    [P in K]?: T[P];
-};
-/**
- * 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.
- */
-declare function mapValues<V, O extends Record<string, unknown>>(obj: O, mapFn: (value: O[keyof O], key: keyof O) => V): {
-    [K in keyof O]: V;
-};
-/**
- * Alternative to JSON.parse() that will not throw in production. If the passed
- * string cannot be parsed, this will return `undefined`.
- */
-declare function tryParseJson(rawMessage: string): Json | undefined;
-/**
- * Decode base64 string.
- */
-declare function b64decode(b64value: string): string;
-type RemoveUndefinedValues<T> = {
-    [K in keyof T]-?: Exclude<T[K], undefined>;
-};
-/**
- * Returns a new object instance where all explictly-undefined values are
- * removed.
- */
-declare function compactObject<O extends Record<string, unknown>>(obj: O): RemoveUndefinedValues<O>;
-/**
- * Returns a promise that resolves after the given number of milliseconds.
- */
-declare function wait(millis: number): Promise<void>;
-/**
- * Returns whatever the given promise returns, but will be rejected with
- * a "Timed out" error if the given promise does not return or reject within
- * the given timeout period (in milliseconds).
- */
-declare function withTimeout<T>(promise: Promise<T>, millis: number, errmsg: string): Promise<T>;
-/**
- * Memoize a promise factory, so that each subsequent call will return the same
- * pending or success promise. If the promise rejects, will retain that failed
- * promise for a small time period, after which the next attempt will reset the
- * memoized value.
- */
-declare function memoizeOnSuccess<T>(factoryFn: () => Promise<T>): () => Promise<T>;
-/**
- * Polyfill for Array.prototype.findLastIndex()
- */
-declare function findLastIndex<T>(arr: T[], predicate: (value: T, index: number, obj: T[]) => boolean): number;
-
 type Cursor = Brand<string, "Cursor">;
 type ChatId = string;
 type MessageId = Brand<`ms_${string}`, "MessageId">;
@@ -4499,14 +4590,14 @@ declare const MENTION_CHARACTER = "@";
  * @param data The plain comment data object (usually returned by the API)
  * @returns The rich comment data object that can be used by the client.
  */
-declare function convertToCommentData(data: CommentDataPlain): CommentData;
+declare function convertToCommentData<CM extends BaseMetadata>(data: CommentDataPlain<CM>): CommentData<CM>;
 /**
  * Converts a plain thread data object (usually returned by the API) to a thread data object that can be used by the client.
  * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
  * @param data The plain thread data object (usually returned by the API)
  * @returns The rich thread data object that can be used by the client.
  */
-declare function convertToThreadData<M extends BaseMetadata>(data: ThreadDataPlain<M>): ThreadData<M>;
+declare function convertToThreadData<TM extends BaseMetadata, CM extends BaseMetadata>(data: ThreadDataPlain<TM, CM>): ThreadData<TM, CM>;
 /**
  * Converts a plain comment reaction object (usually returned by the API) to a comment reaction object that can be used by the client.
  * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
@@ -5090,6 +5181,34 @@ declare function warnOnce(message: string, key?: string): void;
  */
 declare function warnOnceIf(condition: boolean | (() => boolean), message: string, key?: string): void;
 
+/**
+ * Generates operations to mutate an existing Live storage structure.
+ *
+ * This function attempts to merge mutation data into an existing Live structure,
+ * preserving nested LiveObjects, LiveMaps, and LiveLists. For example, if you have
+ * a LiveObject with a nested LiveObject (engine), and you pass a plain object
+ * mutation, it will preserve the nested LiveObject structure and only update the
+ * specified fields.
+ *
+ * @param nodes - The existing storage nodes as IdTuple<SerializedCrdt>[]
+ * @param mutation - The mutation data (can be partial JSON or LSON)
+ * @param actorId - Optional actor/connection ID to use for generating op IDs. Defaults to 1.
+ * @returns Array of operations that can be applied to achieve the mutation
+ *
+ * @example
+ * ```typescript
+ * const nodes: IdTuple<SerializedCrdt>[] = [
+ *   ["0:0", { type: CrdtType.OBJECT, data: {} }],
+ *   ["0:1", { type: CrdtType.OBJECT, data: { displacement: 1 }, parentId: "0:0", parentKey: "engine" }]
+ * ];
+ *
+ * const ops = generateOpsFromJson(nodes, {
+ *   engine: { displacement: 2 } // Preserves engine as LiveObject, only updates displacement
+ * }, 42); // Use actor ID 42 for generated ops
+ * ```
+ */
+declare function generateOpsFromJson<S extends LsonObject>(nodes: IdTuple<SerializedCrdt>[], mutation: Partial<S> | Json, actorId?: number): Op[];
+
 /**
  * Definition of all messages the Panel can send to the Client.
  */
@@ -5222,4 +5341,4 @@ type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
 };
 
-export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeRetrievalPart, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiSourcesPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUrlSource, type AiUserMessage, type AiWebRetrievalPart, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, 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, type CommentsEventServerMsg, type CompactChildNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DGI, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type History, type HistoryVersion, HttpError, type ISODateString, 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 InferFromSchema, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, type LayerKey, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, 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 RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SearchCommentsResult, 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 StorageChunkServerMsg, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type UrlMetadata, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isNumberOperator, isPlainObject, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, nodeStreamToCompactNodes, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };
+export { type AckOp, type ActivityData, type AgentMessage, type AgentMessagesServerMsg, type AgentSession, type AgentSessionsServerMsg, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeRetrievalPart, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiSourcesPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUrlSource, type AiUserMessage, type AiWebRetrievalPart, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type ClientWireOp, 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, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DCM, type DE, type DGI, type DP, type DRI, type DS, type DTM, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type HasOpId, type History, type HistoryVersion, HttpError, type ISODateString, 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 InferFromSchema, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, type LayerKey, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, 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 RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SearchCommentsResult, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type ServerWireOp, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStateServerMsg, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type UrlMetadata, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateOpsFromJson, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isNumberOperator, isPlainObject, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };