k2-im 0.1.29 → 0.1.31

package/dist/chat-kit.d.ts

@@ -1,8 +1,8 @@
 /** 媒体业务类型：实现据此选对象存储逻辑桶；sticker 对应 app-sticker。 */
 type MediaKind = 'image' | 'video' | 'voice' | 'file' | 'sticker';
 
-/** 会话类型。P0 只用 direct / group。 */
-type ConversationType = 'direct' | 'group' | 'channel' | 'supergroup';
+/** 会话类型。P0 只用 direct / group；`robot` 是独立私聊 sibling，不得并入 direct。 */
+type ConversationType = 'direct' | 'group' | 'channel' | 'supergroup' | 'robot';
 /**
  * 会话复合身份；`conversationId` 只在对应 `conversationType` 的领域内唯一。
  *
@@ -39,8 +39,8 @@ interface ConversationDraft$1 {
     attachments: readonly [];
     updatedAt: number;
 }
-/** 消息内容类型。sticker=表情/贴图（BMessage contentType=7）；call=单聊通话记录（contentType=10）；transfer=转账（contentType=16）；robot=机器人卡片（contentType=18）；miniProgram=小程序分享卡（contentType=22）；redPacket=红包卡（contentType=25）；game=小游戏（contentType=27）；未知 wire 正文统一归一为 unknown。 */
-type MessageContentType = 'text' | 'system' | 'image' | 'video' | 'voice' | 'file' | 'sticker' | 'contact' | 'miniProgram' | 'game' | 'transfer' | 'call' | 'redPacket' | 'mediaAlbum' | 'robot' | 'unknown';
+/** 消息内容类型。sticker=表情/贴图（BMessage contentType=7）；call=单聊通话记录（contentType=10）；transfer=转账（contentType=16）；gift=礼品/刮刮卡（contentType=17）；robot=机器人卡片（contentType=18）；miniProgram=小程序分享卡（contentType=22）；redPacket=红包卡（contentType=25）；game=小游戏（contentType=27）；未知 wire 正文统一归一为 unknown。 */
+type MessageContentType = 'text' | 'system' | 'image' | 'video' | 'voice' | 'file' | 'sticker' | 'contact' | 'miniProgram' | 'game' | 'transfer' | 'gift' | 'call' | 'redPacket' | 'mediaAlbum' | 'robot' | 'unknown';
 /**
  * 发送态（客户端态）：消息从本地创建到服务端确认的生命周期。
  * `uploading` 仅媒体消息使用：文件上传阶段（uploading→pending→sending→sent）；
@@ -109,6 +109,8 @@ type LastMessageSummary = {
     gameType: ImGameType;
 } | {
     kind: 'transfer';
+} | {
+    kind: 'gift';
 } | {
     kind: 'call';
     callKind: ImCallKind;
@@ -308,13 +310,14 @@ type ImGameBody = {
  * - `default`：0，普通可点卡片
  * - `board-game`：1，棋牌样式且不可点
  * - `board-game-link`：2，棋牌样式且可点
+ * - `game-preview`：3，气泡内嵌游戏预览 WebView
  * - `unknown`：必须同时保留 `rawShowType`，不得猜成可点/不可点
  */
-type ImMiniProgramShowType = 'default' | 'board-game' | 'board-game-link' | 'unknown';
+type ImMiniProgramShowType = 'default' | 'board-game' | 'board-game-link' | 'game-preview' | 'unknown';
 /**
  * 小程序分享卡片正文（contentType==='miniProgram'，协议 BMessage.contentType=22）。
  *
- * @remarks 字段来自 iOS `IMMiniProgramMessageBody` / proto 61-67、80-82、90-93。
+ * @remarks 字段来自 iOS `IMMiniProgramMessageBody` / proto 61-67、80-82、90-96。
  * `currencySource` 对应 proto field 90（无 miniProgram 前缀）：`xj` 现金公司、`xy` 信用公司。
  * `subGameName` 保持服务端 JSON 字符串，不在 Core 解析语种表。打开小程序与 X 币/信用 ID 属于宿主，不进本 DTO。
  */
@@ -338,6 +341,12 @@ interface ImMiniProgramBody {
     gamePath?: string;
     /** 多语言子游戏名 JSON 字符串，例如 `{"ch":"...","en":"..."}`。 */
     subGameName?: string;
+    /** 游戏预览页地址（BMessage.miniProgramGamePreviewUrl，showType=3）。 */
+    gamePreviewUrl?: string;
+    /** 游戏预览设计宽（BMessage.miniProgramGamePreviewWidth）。 */
+    gamePreviewWidth?: number;
+    /** 游戏预览设计高（BMessage.miniProgramGamePreviewHeight）。 */
+    gamePreviewHeight?: number;
 }
 /**
  * 机器人卡片文本模块（wire `section`）。
@@ -416,6 +425,40 @@ interface ImTransferBody {
     coinName?: string;
     coinIcon?: string;
 }
+/** 礼品类型。协议注释为刮刮卡 1 / 奖品 2；Android 当前会把 WelfareGiftType=0 写进消息，入站必须接受 0。 */
+type ImGiftType = 0 | 1 | 2;
+/** 礼品状态。0 待领取 / 1 已收款 / 2 已退还 / 3 已过期（对齐 iOS IMGiftMessageBody）。 */
+type ImGiftStatus = 0 | 1 | 2 | 3;
+/** 礼品会话类型。1 个人 / 2 群（BMessage.sessionType）。 */
+type ImGiftSessionType = 1 | 2;
+/**
+ * 礼品卡片正文（contentType==='gift'，协议 BMessage.contentType=17）。
+ *
+ * @remarks 字段来自 iOS `IMGiftMessageBody` / proto 51-59，并复用转账字段族的 fromUid/toUid/serialNumber。
+ * 赠卡 HTTP 属于宿主；本 DTO 只承载会话卡片。H5 出站刮刮卡写 giftType=1。
+ */
+interface ImGiftBody {
+    fromUid: string;
+    toUid: string;
+    fromUserName?: string;
+    toUserName?: string;
+    giftType: ImGiftType;
+    giftName: string;
+    giftIcon?: string;
+    explain?: string;
+    state: ImGiftStatus;
+    serialNumber: string;
+    sessionType: ImGiftSessionType;
+    initiateTime: number;
+    /** 单张金额的十进制字符串；0 或缺省表示未带金额。 */
+    amount?: string;
+    receiveTime?: number;
+    returnTime?: number;
+    isRead?: boolean;
+    zhangCount?: string;
+    benCount?: string;
+    fissionNumber?: string;
+}
 /** 领域通话媒体类型；已从各端 wire 0/1 对调口径归一，宿主禁止再读 raw callType。 */
 type ImCallKind = 'audio' | 'video';
 /**
@@ -574,6 +617,8 @@ interface ImMessageBody {
     game?: ImGameBody;
     /** contentType==='transfer' 时的转账卡片。 */
     transfer?: ImTransferBody;
+    /** contentType==='gift' 时的礼品/刮刮卡卡片。 */
+    gift?: ImGiftBody;
     /** contentType==='call' 时的单聊通话记录。 */
     call?: ImCallRecordBody;
     /** contentType==='redPacket' 时的红包卡片。 */
@@ -962,7 +1007,7 @@ interface OutboxMessage {
     resumePolicy?: 'automatic' | 'manual';
 }
 /** 当前 SDK 已注册发送策略、因此可作为转发目标的会话类型；supergroup 未注册，继续在编译期排除。 */
-type ForwardTargetConversationType = Extract<ConversationType, 'direct' | 'group' | 'channel'>;
+type ForwardTargetConversationType = Extract<ConversationType, 'direct' | 'group' | 'channel' | 'robot'>;
 /** 转发目标会话；运行时仍由 SendStrategyRegistry 复核，避免类型声明与实际装配漂移。 */
 interface ForwardTarget {
     conversationId: string;
@@ -1849,6 +1894,44 @@ interface ImSessionFavoritePort {
     delete: (collectIds: readonly string[]) => Promise<void>;
 }
 
+/**
+ * SDK 已取得的最近一页请求结果；只是可重建缓存，不代表消息已进入 DomainState 或处理过入站副作用。
+ * 消息、Reaction 与分页边界必须整页原子保存，只有前台实际消费时才进入正常消息流程。
+ */
+interface ImRecentHistoryPage {
+    /**
+     * 缓存记录格式版本；不认识的版本不能当作有效页使用。
+     * v2：小程序 showType=3 / proto 94-96 进入领域正文，旧页必须重新拉网解析。
+     */
+    version: 2;
+    /** 当前账号内的精确 GROUP/CHANNEL 会话；direct 没有此远端最近页能力。 */
+    conversation: ConversationRef<'group' | 'channel'>;
+    /** 成功获取页面的毫秒时间，用于保留期限和按获取时间淘汰。 */
+    fetchedAt: number;
+    /** SDK 生成的请求与会话状态指纹；存储层不解释其内容。 */
+    fingerprint: string;
+    /** 已净化的消息事实，缓存保存不得发布消息或已读事件。 */
+    messages: readonly ImMessage[];
+    /** 解码时暂存的 Reaction 事实，预取阶段不得提前应用。 */
+    reactions: readonly ImReactionEvent[];
+    /** 服务端是否明确没有更早一页，空页也保留这一结果。 */
+    exhausted: boolean;
+    /** 服务端返回的向旧游标，存储层仅原样保存。 */
+    nextCursor?: string;
+    /** SDK 按净化后的整页计算的字节数，用于存储预算。 */
+    byteLength: number;
+}
+/** 账号隔离的最近页缓存；过期、淘汰或清理后重新请求即可，不影响消息真相。 */
+interface ImRecentHistoryCachePort {
+    /** 读取精确会话的整页；不存在或超过保留期限时返回 null。 */
+    get: (conversation: ConversationRef<'group' | 'channel'>) => Promise<ImRecentHistoryPage | null>;
+    /** 原子保存整页；仅 durable 事务提交后返回 true，预算或保留期限不允许时返回 false。 */
+    put: (page: ImRecentHistoryPage) => Promise<boolean>;
+    /** 删除精确会话的缓存页，不删除正常历史或会话。 */
+    delete: (conversation: ConversationRef<'group' | 'channel'>) => Promise<void>;
+    /** 清空当前账号的最近页缓存。 */
+    clear: () => Promise<void>;
+}
 /** 迁移期存储会话入参；新代码使用 ref，string 仅兼容唯一命中的旧调用。 */
 type ImStorageConversation = ConversationRef | string;
 /** 打开账号库的选项。namespace = 账号隔离键（登录 userId）。 */
@@ -1997,6 +2080,8 @@ type StoredConversationBackground = {
  * 失败经 `error` 事件（scope:'storage'）暴露、不静默吞、不阻塞内存主流程。
  */
 interface ImStoragePort {
+    /** 可选的最近页持久缓存；缺少该能力时 SDK 必须明确跳过持久预取。 */
+    recentHistoryCache?: ImRecentHistoryCachePort;
     /** 打开/创建账号库并跑迁移（幂等）。open 前的读写应视为未就绪并抛错（不静默兜底）。 */
     open: (options: ImStorageOpenOptions) => Promise<void>;
     /** 关闭库句柄（登出/切账号）。 */
@@ -2158,6 +2243,10 @@ interface ImStoragePort {
 type ImEvent = {
     type: 'connection:changed';
     state: ImConnectionState;
+}
+/** 同账号已由另一个浏览器页面接管；本页会话不可复用，但宿主登录仍有效。 */
+ | {
+    type: 'session:replaced';
 } | {
     type: 'message:received';
     message: ImMessage;
@@ -2869,10 +2958,11 @@ interface MediaTransferAdapterConfig {
      */
     rangeDownload?: boolean;
     /**
-     * 媒体发送阶段的并发上限；由 im-core 消费，adapter 本身仍只负责单个上传任务。
+     * 媒体发送阶段的并发上限；由 im-core 消费，限制媒体任务数而非分片请求数。
      *
-     * 并发按媒体体积分两档：图片与不超过分片阈值（16 MiB）的小文件走单次 PutObject、不占分片缓冲，
-     * 缺省 5；视频与超过阈值（或字节数未知）的文件走分片，每路各带分片缓冲，缺省 3。
+     * 并发按媒体体积分两档：不超过分片阈值（16 MiB）的非视频媒体走小文件档，
+     * 缺省 5；视频与超过阈值（或字节数未知）的内容走大文件档，缺省 3。
+     * 分档只限制媒体任务数；实际 PUT/UploadPart 另受 adapter 的六路数据请求限制。
      * 两档都只接受 1-6 的整数，超出范围由 core 显式报错。
      * - 传一个数字：所有媒体共用这一个并发数，与分档前的语义一致。
      * - 传 `{ total, largeFiles }`：显式分档，`largeFiles` 不得超过 `total`。
@@ -2921,8 +3011,8 @@ interface IndexedDbStorageAdapterOptions {
         maxPendingWriteBytes?: number;
     };
 }
-/** 官方浏览器 adapter 始终提供完整背景持久化能力；可选只存在于通用 `ImStoragePort` 兼容边界。 */
-type IndexedDbStorageAdapter = ImStoragePort & MediaAssetCachePort & Required<Pick<ImStoragePort, 'getConversationBackground' | 'saveConversationBackground' | 'deleteConversationBackground' | 'getDefaultConversationBackground' | 'saveDefaultConversationBackground' | 'deleteDefaultConversationBackground'>>;
+/** 官方浏览器 adapter 始终提供背景和最近历史缓存；可选只存在于通用 `ImStoragePort` 兼容边界。 */
+type IndexedDbStorageAdapter = ImStoragePort & MediaAssetCachePort & Required<Pick<ImStoragePort, 'getConversationBackground' | 'recentHistoryCache' | 'saveConversationBackground' | 'deleteConversationBackground' | 'getDefaultConversationBackground' | 'saveDefaultConversationBackground' | 'deleteDefaultConversationBackground'>>;
 /**
  * 创建 IndexedDB 存储 adapter（实现 ImStoragePort）。
  * 生命周期：先 `open({ namespace })`（幂等，跑 schema 迁移），再读写；`close()` 释放句柄。
@@ -3113,6 +3203,10 @@ interface MiniProgramMessageOptions {
 interface TransferMessageOptions {
     replyToMessageId?: string;
 }
+/** 礼品卡片发送选项；正文必须已含福利中心赠送后的流水号与卡面。 */
+interface GiftMessageOptions {
+    replyToMessageId?: string;
+}
 /**
  * 媒体合集里的一项：一张图片或一个视频。
  *
@@ -3524,6 +3618,21 @@ interface ImContactApi extends ImDirectoryApi<'individual'> {
     deleteFriendship: (userId: string) => Promise<void>;
 }
 
+/** 后台最近页预取的取消条件；取消不影响正在复用同一请求的前台会话。 */
+interface ConversationPrefetchOptions {
+    signal?: AbortSignal;
+}
+/**
+ * 单个会话的后台预取结果。ready 只在完整页面已写入当前账号缓存后返回。
+ * skipped 表示当前类型、权限、存储或预算不允许预取；失败不改变正常打开会话的行为。
+ */
+interface ConversationPrefetchResult {
+    ref: ConversationRef<'direct' | 'group' | 'channel' | 'robot'>;
+    status: 'ready' | 'skipped' | 'failed' | 'cancelled';
+    reason?: 'unsupported' | 'unavailable' | 'storage-unavailable' | 'budget' | 'page-too-large' | 'decrypt-failed' | 'invalidated' | 'cancelled';
+    error?: ImSdkErrorShape;
+}
+
 /**
  * 当前账号草稿的产品 DTO、跨组件 API 与 handle 绑定门面。
  * 草稿按复合会话身份串行持久化，SDK DomainState 是唯一真相；附件尚未闭合时非空输入明确拒绝。
@@ -3561,7 +3670,7 @@ interface ConversationDraftApi {
     subscribe: (listener: (draft: ConversationDraft | null) => void) => () => void;
 }
 /**
- * 当前账号的跨组件草稿 API；所有动作都要求 direct/GROUP/CHANNEL 精确复合身份。
+ * 当前账号的跨组件草稿 API；所有动作都要求 direct / GROUP / CHANNEL / robot 精确复合身份。
  *
  * @example
  * ```ts
@@ -3585,11 +3694,11 @@ interface ImDraftsApi {
 
 /**
  * SDK 会话列表内部 sibling 路由与会话级写动作。
- * 置顶、免打扰、已读和本地删除都要求精确 `ConversationRef`，并按 direct/GROUP/CHANNEL 独立协议分流。
+ * 置顶、免打扰、已读和本地删除都要求精确 `ConversationRef`，并按 direct/GROUP/CHANNEL/robot 独立协议分流。
  */
 
 /** 当前兼容门面支持的精确会话 ref。 */
-type ImSupportedConversationRef = ConversationRef<'direct' | 'group' | 'channel'>;
+type ImSupportedConversationRef = ConversationRef<'direct' | 'group' | 'channel' | 'robot'>;
 /**
  * 会话 API 的迁移期入参。优先传完整 ref；旧 string 仅在当前 session 中唯一命中时可用。
  *
@@ -3613,6 +3722,8 @@ interface ImConversationsApi {
     pullOffline: () => Promise<ImMessage[]>;
     /** 运行 direct/GROUP/CHANNEL sibling 离线同步。 */
     sync: () => Promise<void>;
+    /** 静默准备最近页；结果成功表示当前账号缓存事务已提交。 */
+    prefetchRecent: (refs: readonly ImSupportedConversationRef[], options?: ConversationPrefetchOptions) => Promise<readonly ConversationPrefetchResult[]>;
     /** 聚合总未读；默认排除 muted 会话。 */
     getTotalUnread: (options?: {
         includeMuted?: boolean;
@@ -3986,7 +4097,7 @@ interface ImDirectCallsApi {
  * Blob 只经 storage 持久化。异步读取使用运行时代际防止切会话/切账号晚返回，宿主负责最终渲染与 URL 释放。
  */
 
-type ConversationBackgroundConversationType = 'direct' | 'group' | 'channel';
+type ConversationBackgroundConversationType = 'direct' | 'group' | 'channel' | 'robot';
 interface ConversationBackgroundPreset {
     id: string;
     url: string;
@@ -4148,7 +4259,7 @@ interface ImChannelProfile {
  */
 
 /** default 会话列表支持的精确类型；`supergroup` 继续受产品 Gate 约束。 */
-type ProductConversationListType = 'direct' | 'group' | 'channel';
+type ProductConversationListType = 'direct' | 'group' | 'channel' | 'robot';
 /** GROUP 会话限制状态；与 CHANNEL 状态保持独立 sibling。 */
 type ImGroupConversationState = GroupSessionState;
 /**
@@ -4207,6 +4318,8 @@ type ConversationLastMessageSummary = {
     kind: 'robot';
 } | {
     kind: 'transfer';
+} | {
+    kind: 'gift';
 } | {
     kind: 'redPacket';
 } | {
@@ -4320,6 +4433,8 @@ interface ImConversationListApi extends ImConversationBackgroundApi {
     subscribe: (listener: (snapshot: ImConversationListSnapshot) => void) => () => void;
     /** 显式运行 direct/GROUP/CHANNEL sibling 同步；失败抛稳定产品错误并进入 error 快照。 */
     refresh: () => Promise<void>;
+    /** 静默预取各会话最近一页；不激活线程，ready 只表示持久缓存已完成。 */
+    prefetchRecent: (refs: readonly ConversationRef<ProductConversationListType>[], options?: ConversationPrefetchOptions) => Promise<readonly ConversationPrefetchResult[]>;
     /** 读取总未读；默认排除 muted 会话。 */
     getTotalUnread: (options?: {
         includeMuted?: boolean;
@@ -4360,6 +4475,12 @@ interface DirectConversationCapabilities {
     canUseMessageActions: CapabilityDecision;
     canManageRelationship: CapabilityDecision;
 }
+interface RobotConversationCapabilities {
+    canSendMessages: CapabilityDecision;
+    canOpenProfile: CapabilityDecision;
+    canUseMessageActions: CapabilityDecision;
+    canReadHistory: CapabilityDecision;
+}
 /**
  * 普通群能力快照。
  *
@@ -4426,6 +4547,8 @@ type ConversationCapabilitySnapshot = (ConversationCapabilityBase<'direct'> & {
     value: GroupConversationCapabilities;
 }) | (ConversationCapabilityBase<'channel'> & {
     value: ChannelConversationCapabilities;
+}) | (ConversationCapabilityBase<'robot'> & {
+    value: RobotConversationCapabilities;
 });
 interface ImConversationCapabilitiesApi {
     /** 只读取 SDK 当前本机真相与已刷新过的资料/关系投影，不隐式联网。 */
@@ -4592,7 +4715,7 @@ interface ImMessagesByIdResult<TMessage> {
  */
 
 /** 当前已接线的产品 handle 会话类型；三者只在无会话语义原子层复用。 */
-type ProductHandleConversationType = 'direct' | 'group' | 'channel';
+type ProductHandleConversationType = 'direct' | 'group' | 'channel' | 'robot';
 /**
  * 会话 handle 初始打开位置。
  *
@@ -4605,6 +4728,8 @@ type ConversationInitialPosition = 'latest' | 'first-unread';
  * @remarks 选项只影响初始连续窗口和 `entryUnread` 快照；发送、历史分页、已读和 close 语义保持不变。
  */
 interface ConversationOpenOptions {
+    /** 取消尚未交付的会话打开及其历史请求；句柄交付后由 close 管理生命周期。 */
+    signal?: AbortSignal;
     /**
      * 初始连续窗口位置。
      *
@@ -4725,6 +4850,12 @@ interface ConversationMessageApi {
      * @remarks CHANNEL 当前产品入口不发送转账，会返回 unsupported。消息固定明文。
      */
     sendTransfer: (transfer: ImTransferBody, options?: TransferMessageOptions) => Promise<SendMessageResult>;
+    /**
+     * 发送礼品卡片。调用方必须先完成福利中心 HTTP 赠送。
+     *
+     * @remarks CHANNEL 当前产品入口不发送礼物，会返回 unsupported。消息固定明文。
+     */
+    sendGift: (gift: ImGiftBody, options?: GiftMessageOptions) => Promise<SendMessageResult>;
     /** 当前用户已选相同 emoji 时移除，否则添加或替换。emoji 必须是协议 token，例如 `[Great]`。 */
     toggleReaction: (messageId: string, emoji: string) => Promise<ImReactionChangeResult>;
     /** 显式添加/替换或移除，供参与者详情等不能用 toggle 猜动作的产品交互。 */
@@ -5234,6 +5365,8 @@ interface ImProductEventMap {
     'connection:changed': Readonly<{
         snapshot: ImLifecycleSnapshot;
     }>;
+    /** 另一个页面接管聊天；宿主可提示刷新此页重新接管，不应退出业务登录。 */
+    'session:replaced': Readonly<Record<never, never>>;
     'message:received': Readonly<{
         ref: ConversationRef<ProductConversationListType>;
         message: ImProductMessage;
@@ -5562,6 +5695,57 @@ interface ImRequestError {
  */
 type ImRequestErrorHandler = (issue: ImRequestError) => void | Promise<void>;
 
+/**
+ * 机器人目录产品分页运行时。
+ * 服务端页码封装为绑定账号 runtime 与查询条件的 opaque token；伪造、跨筛选或已消费 token 显式失败。
+ */
+
+/**
+ * 机器人目录查询范围。
+ *
+ * `catalog` 对齐通讯录「查找机器人」；`conversation` 对齐群/社群资料添加与输入栏已绑定列表。
+ */
+type ImRobotDirectoryScope = {
+    kind: 'catalog';
+} | {
+    kind: 'conversation';
+    conversationType: 'group' | 'channel';
+    conversationId: string;
+    /** `bound` 对齐 iOS 输入栏 `search_type=1`。 */
+    filter?: 'bound';
+};
+/** 机器人目录项；只保留打开私聊和列表展示所需字段。 */
+interface ImRobotDirectoryItem {
+    id: string;
+    displayName: string;
+    username?: string;
+    avatarUrl?: string;
+    bound?: boolean;
+}
+/** 把机器人绑定或解绑到普通群/社群。 */
+interface ImRobotConversationBindInput {
+    robotId: string;
+    conversationType: 'group' | 'channel';
+    conversationId: string;
+}
+/** 机器人目录页；服务端页码由 SDK token 封装，UI 只能原样续页。 */
+interface ImRobotDirectoryPage {
+    items: readonly ImRobotDirectoryItem[];
+    nextPageToken?: ImPageToken;
+    exhausted: boolean;
+}
+/** 机器人目录产品分页面。 */
+interface ImRobotsApi {
+    listFirstPage: (options?: {
+        scope?: ImRobotDirectoryScope;
+        keyword?: string;
+        pageSize?: number;
+    }) => Promise<ImRobotDirectoryPage>;
+    listNextPage: (pageToken: ImPageToken) => Promise<ImRobotDirectoryPage>;
+    bindToConversation: (input: ImRobotConversationBindInput) => Promise<void>;
+    unbindFromConversation: (input: ImRobotConversationBindInput) => Promise<void>;
+}
+
 /**
  * 当前账号本地会话与消息的分场景产品搜索运行时。
  *
@@ -5624,6 +5808,8 @@ interface ImMessageSearchApi {
     inGroup: (conversation: ConversationRef<'group'>, keyword: string) => Promise<ProductMessageSearchPage<MessageContentType>>;
     /** 搜索 CHANNEL 本地历史；当前不调用未闭合的远端 CHANNEL 搜索/定位协议。 */
     inChannel: (conversation: ConversationRef<'channel'>, keyword: string) => Promise<ProductMessageSearchPage<MessageContentType>>;
+    /** 搜索 robot 本地历史；无远端历史，不得回退 direct。 */
+    inRobot: (conversation: ConversationRef<'robot'>, keyword: string) => Promise<ProductMessageSearchPage<MessageContentType>>;
     /** 只搜索文本消息；关键词必填且不能为空。 */
     texts: (conversation: ConversationRef<ProductHandleConversationType>, keyword: string) => Promise<ProductMessageSearchPage<'text'>>;
     /** 只搜索文件消息；省略或传空白关键词时按文件分类浏览。 */
@@ -6160,7 +6346,7 @@ interface AdvancedConversationsApi extends ImConversationsApi, ImConversationBac
      *
      * @internal
      */
-    ensureOpenableConversation: (ref: ConversationRef) => Promise<ConversationRef<'direct' | 'group' | 'channel'>>;
+    ensureOpenableConversation: (ref: ConversationRef) => Promise<ConversationRef<'direct' | 'group' | 'channel' | 'robot'>>;
 }
 /**
  * 普通宿主的真实 default client。
@@ -6184,6 +6370,8 @@ interface ImProductClient {
     readonly conversations: ImConversationListApi;
     /** 当前账号完整联系人、群组和社群目录的统一搜索。 */
     readonly directory: ImDirectorySearchApi;
+    /** 机器人公开目录；通讯录查找与群/社群绑定列表共用分页合同。 */
+    readonly robots: ImRobotsApi;
     readonly contacts: ImContactsApi;
     readonly groups: ImGroupsApi;
     readonly channels: ImChannelsApi;
@@ -6233,6 +6421,7 @@ interface ImClient extends Omit<ImProductClient, 'capabilities' | 'channels' | '
         (ref: ConversationRef<'direct'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'direct'>>;
         (ref: ConversationRef<'group'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'group'>>;
         (ref: ConversationRef<'channel'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'channel'>>;
+        (ref: ConversationRef<'robot'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'robot'>>;
     };
     /** 当前账号草稿产品面；按复合身份持久化，handle.draft 委托同一状态源。 */
     drafts: ImDraftsApi;
@@ -6381,7 +6570,7 @@ type ImLocale = 'en-US' | 'th-TH' | 'vi-VN' | 'zh-CN' | 'zh-TW';
  * 二期收敛：kit 框架无关层不再直接产中文，改产本联合里的码 + 参数（如 {reason}/{label}/{size}），由宿主经 im-i18n 渲染。
  * 动态原始报错（error.message）作为 `{reason}` 参数拼接，不入 catalog（属诊断，不翻译）。
  */
-type ImServiceTextKey = 'common.notConnected' | 'common.selectOrOpenConversation' | 'common.conversationTypeNotReady' | 'common.conversationNotReady' | `recall.${RecallFailReason}` | `edit.${EditFailReason}` | 'localDelete.done' | 'localDelete.notFound' | 'localDelete.inFlight' | 'localDelete.failed' | 'channelDelete.notFound' | 'channelDelete.unsupported' | 'channelDelete.notSent' | 'channelDelete.unavailable' | 'channelDelete.forbidden' | 'channelDelete.timeout' | 'channelDelete.failed' | 'channelDelete.disconnected' | 'directBlock.contactRequired' | 'groupBlock.left' | 'groupBlock.removed' | 'groupBlock.dismissed' | 'groupBlock.unknownRestricted' | 'channelBlock.guest' | 'channelBlock.left' | 'channelBlock.removed' | 'channelBlock.dismissed' | 'channelBlock.muted' | 'channelBlock.allMembersMuted' | 'channelBlock.currentUserMuted' | 'channelBlock.blacklisted' | 'channelBlock.unknownRestricted' | 'channelProfile.loadFailed' | 'channelProfile.notFound' | 'channelProfile.retryAction' | 'channelMembers.title' | 'channelMembers.searchPlaceholder' | 'channelMembers.loading' | 'channelMembers.loadFailed' | 'channelMembers.retryAction' | 'channelMembers.empty' | 'channelMembers.loadingMore' | 'channelMembers.loadMoreFailed' | 'channelMembers.exhausted' | 'channelMembers.loadMoreAction' | 'label.image' | 'label.video' | 'label.file' | 'label.sticker' | 'send.failed' | 'send.retryFailed' | 'send.cancelFailed' | 'send.mediaFailed' | 'send.mediaEmpty' | 'send.mediaCancelled' | 'send.mediaCountLimit' | 'send.mediaTooLarge' | 'send.mediaFormatMismatch' | 'send.imageFormatUnsupported' | 'send.videoTooLong' | 'send.videoDurationUnavailable' | 'send.voiceEmpty' | 'send.voiceStorageNotConfigured' | 'send.voiceCancelled' | 'send.voiceFailed' | 'media.uploadWaiting' | 'media.voiceNotReady' | 'media.voiceLoadEmpty' | 'media.voiceLoadFailed' | 'media.videoOpenEmpty' | 'media.videoLoadFailed' | 'media.imageInvalid' | 'media.imageLoadFailed' | 'media.fileDownloadEmpty' | 'media.fileDownloadFailed' | 'conversation.muteEnableFailed' | 'conversation.muteDisableFailed' | 'conversation.backgroundLoadFailed' | 'read.markReadFailed' | 'storage.failed' | 'sync.failed' | 'draft.saveFailed' | 'history.returnLatestFailed' | 'pinned.forbidden' | 'pinned.network' | 'pinned.contract' | 'pinned.unsupported' | 'pinned.failed' | 'pinned.previewUnavailable' | 'pinned.locateFailed' | 'pinned.recalled' | 'pinned.deleted' | 'pinned.protected' | 'pinned.pinAction' | 'pinned.unpinAction' | 'pinned.unpinConfirm' | 'pinned.cancelAction' | 'lifecycle.missingLoginState' | 'lifecycle.prepareFailed' | 'lifecycle.missingConnectParams' | 'lifecycle.connectFailed' | 'lifecycle.disposed' | 'forward.emptyInput' | 'forward.allSkipped' | 'forward.partialSkipped' | 'forward.done' | 'forward.failed';
+type ImServiceTextKey = 'common.notConnected' | 'common.selectOrOpenConversation' | 'common.conversationTypeNotReady' | 'common.conversationNotReady' | `recall.${RecallFailReason}` | `edit.${EditFailReason}` | 'localDelete.done' | 'localDelete.notFound' | 'localDelete.inFlight' | 'localDelete.failed' | 'channelDelete.notFound' | 'channelDelete.unsupported' | 'channelDelete.notSent' | 'channelDelete.unavailable' | 'channelDelete.forbidden' | 'channelDelete.timeout' | 'channelDelete.failed' | 'channelDelete.disconnected' | 'directBlock.contactRequired' | 'groupBlock.left' | 'groupBlock.removed' | 'groupBlock.dismissed' | 'groupBlock.unknownRestricted' | 'channelBlock.guest' | 'channelBlock.left' | 'channelBlock.removed' | 'channelBlock.dismissed' | 'channelBlock.muted' | 'channelBlock.allMembersMuted' | 'channelBlock.currentUserMuted' | 'channelBlock.blacklisted' | 'channelBlock.unknownRestricted' | 'channelProfile.loadFailed' | 'channelProfile.notFound' | 'channelProfile.retryAction' | 'channelMembers.title' | 'channelMembers.searchPlaceholder' | 'channelMembers.loading' | 'channelMembers.loadFailed' | 'channelMembers.retryAction' | 'channelMembers.empty' | 'channelMembers.loadingMore' | 'channelMembers.loadMoreFailed' | 'channelMembers.exhausted' | 'channelMembers.loadMoreAction' | 'label.image' | 'label.video' | 'label.file' | 'label.sticker' | 'send.failed' | 'send.retryFailed' | 'send.cancelFailed' | 'send.mediaFailed' | 'send.mediaEmpty' | 'send.mediaCancelled' | 'send.mediaCountLimit' | 'send.mediaTooLarge' | 'send.mediaFormatMismatch' | 'send.imageFormatUnsupported' | 'send.videoTooLong' | 'send.videoDurationUnavailable' | 'send.voiceEmpty' | 'send.voiceStorageNotConfigured' | 'send.voiceCancelled' | 'send.voiceFailed' | 'media.uploadWaiting' | 'media.voiceNotReady' | 'media.voiceLoadEmpty' | 'media.voiceLoadFailed' | 'media.videoOpenEmpty' | 'media.videoLoadFailed' | 'media.imageInvalid' | 'media.imageLoadFailed' | 'media.fileDownloadEmpty' | 'media.fileDownloadFailed' | 'conversation.muteEnableFailed' | 'conversation.muteDisableFailed' | 'conversation.backgroundLoadFailed' | 'read.markReadFailed' | 'storage.failed' | 'sync.failed' | 'draft.saveFailed' | 'history.returnLatestFailed' | 'pinned.forbidden' | 'pinned.network' | 'pinned.contract' | 'pinned.unsupported' | 'pinned.failed' | 'pinned.previewUnavailable' | 'pinned.locateFailed' | 'pinned.recalled' | 'pinned.deleted' | 'pinned.protected' | 'pinned.pinAction' | 'pinned.unpinAction' | 'pinned.unpinConfirm' | 'pinned.cancelAction' | 'lifecycle.missingLoginState' | 'lifecycle.prepareFailed' | 'lifecycle.missingConnectParams' | 'lifecycle.connectFailed' | 'lifecycle.disposed' | 'lifecycle.connectionOccupied' | 'lifecycle.connectionCoordinationUnavailable' | 'forward.emptyInput' | 'forward.allSkipped' | 'forward.partialSkipped' | 'forward.done' | 'forward.failed';
 
 /** 会话列表摘要的框架无关分段；宿主可自行决定表情使用图片、文本或其它组件呈现。 */
 type ConversationListPreviewSegment = {
@@ -6472,6 +6661,20 @@ interface ConversationListPresentation {
  */
 declare function resolveConversationListPresentation(item: ConversationListItem, options: ConversationListPresentationOptions): ConversationListPresentation;
 
+/**
+ * PC/H5 会话行与菜单角标共用的显示规则；不修改 SDK 未读消息条数。
+ *
+ * @example `999 → '999'`、`1249 → '1k'`、`10000 → '10k'`、`10001 → '10k+'`。
+ * 会话内的未读提示有独立的 999+ 规则，不使用本函数。
+ */
+declare function formatConversationUnreadBadge(count: number): string;
+/**
+ * 从 SDK 完整会话列表计算菜单未读会话数：每个非免打扰且有未读的会话只计一次。
+ *
+ * SDK 已把手动未读提醒投影到 unreadCount；这里不重新解释消息状态，也不使用宿主筛选后的列表。
+ */
+declare function countUnreadConversations(items: readonly Pick<ConversationListItem, 'unreadCount' | 'muted'>[]): number;
+
 interface DelayedLoadingIndicatorOptions {
     /** loading 持续超过该时间后才显示，缓存快速命中不会闪出提示。 */
     showDelayMs?: number;
@@ -6538,15 +6741,62 @@ type MessageNotificationDecision = {
 /** PC/H5 共用的实时消息提醒规则；离线历史回放不逐条弹通知。 */
 declare function resolveMessageNotificationDecision(input: MessageNotificationInput): MessageNotificationDecision;
 
+/**
+ * 小程序游戏预览卡（消息 22 且 `showType=game-preview`）的呈现判定。
+ *
+ * 三端契约一致：BMessage proto 94 是一个远程页面地址，95/96 是它的作者尺寸。
+ * 安卓用 WebView、iOS 用 WKWebView 顶层加载它，都不回退 `icon`。Web 宿主用 iframe 对应，
+ * 但多了一个原生没有的问题——同一个字段偶尔指向的是图片资源，iframe 装图片会丢掉缩放控制。
+ * 这个判定因此属于 Chat Kit 而不是某个宿主：两端要给出同一个答案，各写一份必然漂移。
+ */
+/** proto 95/96 缺失时的源尺寸，与安卓 `bg_default_applet` 的 280×180 一致。 */
+declare const MINI_PROGRAM_GAME_PREVIEW_FALLBACK_WIDTH = 280;
+declare const MINI_PROGRAM_GAME_PREVIEW_FALLBACK_HEIGHT = 180;
+interface MiniProgramGamePreviewInput {
+    gamePreviewUrl?: string;
+    gamePreviewWidth?: number;
+    gamePreviewHeight?: number;
+    /** 宿主已经观察到 `<img>` 加载失败，说明该地址其实是文档，翻回 document。 */
+    imageLoadFailed?: boolean;
+}
+interface MiniProgramGamePreviewLayout {
+    /** 去空白后的 proto 94；为空串时 `render` 恒为 `empty`。 */
+    url: string;
+    /** 按源尺寸等比缩放用的作者宽高，永远是正数。 */
+    sourceWidth: number;
+    sourceHeight: number;
+    /**
+     * `document` 顶层加载远程页面（对应原生 WebView）；`image` 地址明确是图片资源；
+     * `empty` 无地址，画占位卡——占位本身是合法终态，不是待修复状态。
+     */
+    render: 'document' | 'image' | 'empty';
+}
+/**
+ * 默认按 document 处理：线上真实地址形如 `…/p2p-share?lang=zh&banker_order_id=905`，
+ * 既没有 `.html` 后缀也没有图片后缀，按后缀白名单猜 iframe 会把它错判成图片。
+ */
+declare function resolveMiniProgramGamePreviewLayout(input: MiniProgramGamePreviewInput): MiniProgramGamePreviewLayout;
+
 /**
  * 拼装频道 rel / 消息 22 打开小程序用的地址。
  * 有 host 时按大厅规则拼 suffix；只有 suffix 时只接受完整 URL 或带点的主机名，
  * 不能把 `/path` 当成域名。
  */
+/** `board-game` / `unknown` 不可点；默认卡、棋牌可点卡、游戏预览卡可以点开。 */
+declare function isMiniProgramShowTypeOpenable(showType: string): boolean;
 interface MiniProgramOpenUrlInput {
     domain?: string;
     suffixAddress?: string;
     h5Url?: string;
+    /**
+     * 正文字段 92 `miniProgramGamePath`，分享方写入的落地定位参数。
+     *
+     * 原样并进入口地址的 query，与 iOS `mergedSuffixAddressWithHost:suffixAddress:miniProgramGamePath:`
+     * 同形：宿主据此得到的 `suffix_address` 才是 gameserver 认的载体（它从 suffix 里取
+     * `game_params` 覆盖 `req.GameParams`）。值的编码由分享方负责，这里不再编解码，
+     * 否则会多编或少编一层，`buildAppendUrlParams` 只解一次就会解坏。
+     */
+    gamePath?: string;
 }
 declare function resolveMiniProgramOpenUrl(input: MiniProgramOpenUrlInput): string;
 /** 悬浮外链：suffix 已是完整地址或主机名时直接用；只有路径时必须拼到 domain 上。 */
@@ -6888,7 +7138,8 @@ interface ChatRuntime {
     /**
      * 在账号或 token 发生变化时，立即停止并清理旧账号运行资源。
      *
-     * 它会断开旧连接，关闭本机消息库，丢弃 SDK Client、资料缓存和媒体资源，并递增账号版本号；
+     * 它会立即停止旧连接并丢弃页面资源，异步销毁 SDK Client、关闭消息库和释放浏览器锁；
+     * 新 prepare/connect 等待清理完成，账号版本号同步递增；
      * 已注册的 Store 监听器会保留，以便新账号重新连接后继续接收事件。通常由 `applySession` 自动调用。
      */
     resetForAuthChange: () => void;
@@ -6949,7 +7200,7 @@ interface ChatRuntime {
     /** 撤销当前账号创建的全部媒体预览地址并释放 Blob 内存，切账号、退出或销毁时调用。 */
     cleanupLocalMediaBlobs: () => void;
     /** 删除会话时释放该会话绑定的本地媒体预览/播放缓存。 */
-    cleanupConversationMediaBlobs: (conversation: ConversationRef<'direct' | 'group' | 'channel'>) => void;
+    cleanupConversationMediaBlobs: (conversation: ConversationRef<'direct' | 'group' | 'channel' | 'robot'>) => void;
 }
 /**
  * 创建一个可承载当前及后续登录账号的 IM 运行环境。
@@ -6970,6 +7221,43 @@ interface ChatRuntime {
  */
 declare function createChatRuntime(factories: ChatRuntimeFactories): ChatRuntime;
 
+type PrefetchClient = Pick<ImProductClient, 'conversations'>;
+/** 宿主只提供当前投影和调度许可；请求去重、网络预算与持久化仍由 SDK 管理。 */
+interface ConversationPrefetchControllerOptions {
+    /** 当前账号公开 Client；未准备好时返回 null，不在后台主动创建 Client。 */
+    getClient: () => PrefetchClient | null;
+    /** SDK 会话列表当前顺序；控制器只挑常用会话，不维护消息副本。 */
+    getCandidates: () => readonly ConversationListItem[];
+    /** 前台正在阅读的精确会话；它的历史由正常打开流程负责。 */
+    getActiveRef: () => ConversationRef | null;
+    /** 宿主判断开关、账号、连接、页面可见性和网络策略是否允许预取。 */
+    getRunnable: () => boolean;
+    /** 在首屏绘制后的浏览器空闲期执行，返回取消尚未开始任务的函数。 */
+    scheduleIdle: (task: () => void) => () => void;
+    /** 意外拒绝的结构化诊断出口；预取失败不能转成前台通知。 */
+    onError: (cause: unknown) => void;
+    /** 可选的统一诊断端口；只记录调度状态，不存消息，也不作为运行许可。 */
+    diagnostics?: ImDiagnosticWriter;
+}
+/** 应用级常用会话预取控制器；不依赖 Vue、Pinia 或浏览器页面资源。 */
+interface ConversationPrefetchController {
+    /** 列表、活动会话或运行条件改变时调用；普通刷新复用在途请求。 */
+    refresh: () => void;
+    /** 换账号或退出时取消任务并清除本轮请求记录；后续 refresh 可重新开始。 */
+    reset: () => void;
+    /** 应用卸载时永久释放；后续 refresh 不再调度。 */
+    dispose: () => void;
+}
+/**
+ * 创建常用会话预取编排：每次空闲只提交一个候选，完成后重读列表再选下一项。
+ *
+ * 页间重新等待宿主空闲调度，使置顶、未读、删除和活动会话变化及时影响下一页，
+ * SDK 仍负责请求去重、前台优先与本次账号 Runtime 的网络总预算。
+ * 同一 Client 下完成或失败的候选本轮不自动重试；取消项可在运行条件恢复后重新排队。
+ * reset/client 更换会作废旧请求，旧 Promise 完成后不能修改新账号的请求记录。
+ */
+declare function createConversationPrefetchController(options: ConversationPrefetchControllerOptions): ConversationPrefetchController;
+
 /**
  * 一次异步业务操作发起时捕获的账号生命周期。
  *
@@ -8797,5 +9085,5 @@ declare function resampleWaveform(data: readonly number[], targetCount: number):
  */
 declare function placeholderWaveform(seed: string, count: number): number[];
 
-export { DEFAULT_EMOJI_ASSET_BASE, DEFAULT_LOADING_MINIMUM_VISIBLE_MS, DEFAULT_LOADING_SHOW_DELAY_MS, EMOJI_CATALOG, EMOJI_GAME_DICE_STABLE_KEY, EMOJI_GAME_RPS_STABLE_KEY, EMOJI_TOKEN_RE, MAX_BATCH_FILES, MAX_RECENT_EMOJI_COUNT, MINI_PROGRAM_LANG_NUMBERS, SPIKE_STEP, UNICODE_EMOJI_CATALOG, blockReasonForChannelSession, blockReasonForChannelState, blockReasonForGroupState, blockReasonForSession, calculateMediaBox, canEditMessage, canPinChannelMessage, canPinGroupMessage, canPinMessage, canPromoteMediaPresentationSource, canRecallMessage, canTransmit, canTransmitByType, canTransmitContent, cancelMediaUpload, captureRuntimeClientOperation, captureRuntimeOperation, channelMiniProgramRelKey, classifyGifFile, classifyMediaFile, createChatRuntime, createDelayedLoadingIndicator, createEmojiMatcher, createLinkMatcher, createNewMessageBadgeController, createThreadItems, csvIncludes, decideChannelMiniProgramRelOpen, decideConversationAction, decideMemberTargetAction, decideMessageAction, emojiAssetUrl, emojiUrlByCode, fetchConversationFileBatch, fetchConversationImageBatch, fetchConversationMessageBatch, fetchConversationVideoBatch, fetchConversationVoiceBatch, fetchNextConversationSearchBatch, formatChatDateSeparator, formatConversationDisplayTime, formatFileSize, formatMediaDuration, forward_service as forwardService, getFileExtension, getLocalDayKey, hasEmojiCandidate, hasLinkCandidate, highlightSegments, isGifFile, isMessageLocateScrollProtected, isMessageTailChangeFromOlderWindowTrim, isMessageViewportMeasurable, isMessageVisibleForNewMessageBadge, isPinnedMessageProtected, isVoiceStorageConfigured, loadOlderUntilBoundary, mediaBatchBudgetBytes, media_service as mediaService, message_service as messageService, normalizeLinkHref, parseUnicodeEmojiCode, pinnedMessage_service as pinnedMessageService, placeholderWaveform, prependRecentEmoji, profile_service as profileService, read_service as readService, refreshPrependMessageAnchorPosition, replaceInterruptedMediaFile, requiresConversationEncryption, requiresForwardTypeConfirmation, resampleWaveform, resolveBestMediaPresentationSource, resolveCenteredMessageScrollTop, resolveChannelMemberAvatarUrl, resolveChannelMemberDisplayName, resolveChannelMiniProgramRelIcon, resolveChannelMiniProgramRelName, resolveChannelMiniProgramRelOpenSurface, resolveChannelMiniProgramRelUrl, resolveChannelPinnedGameCopy, resolveConversationListPresentation, resolveDisplayTimestamp, resolveEmojiToken, resolveFriendDisplayName, resolveImProfileAccessDestination, resolveImThreadActiveDate, resolveMediaPresentation, resolveMemberDisplayName, resolveMessageBodyKind, resolveMessageNotificationDecision, resolveMessageTimelineTimestamp, resolveMiniProgramFloatLinkUrl, resolveMiniProgramOpenUrl, resolvePrependMessageAnchor, resolvePrependMessageAnchorAdjustment, resolvePrependMessageAnchorPosition, resolvePublicNickname, resolveQuotedMessagePresentation, resolveSenderAvatarUrl, resolveStandaloneEmojiMessage, resolveSurvivingMessageAnchorAdjustment, resolveUnicodeEmoji, resolveVisibleChannelMiniProgramRels, resolveVisibleMessageAnchorPositions, retryMessage, runMediaSendBatch, sendAsFilesBatch, sendBlockReasonForDecision, sendMediaAlbum, sendMediaFile, sendMediaFilesBatch, sendText, sendVoice, shouldCompleteInitialViewport, shouldFillInitialHistoryViewport, shouldFollowIncomingMessage, shouldLoadNewerHistoryPage, shouldPrefetchOlderHistory, shouldRestoreMessageViewportFocus, shouldShowChatDateSeparator, shouldTrackRemoteMessageForBadge, sortChannelMiniProgramFloatingItems, spikeCountForDuration, supportsConversationMention, unicodeEmojiTextFromCode };
-export type { ApplySessionResult, BrowseMessagesInput, CanPinMessageInput, CenteredMessageScrollInput, ChannelMiniProgramOpenGame, ChannelMiniProgramRelOpenDecision, ChannelMiniProgramRelOpenSurface, ChatMediaMessageRef, ChatProfileAdapter, ChatRuntime, ChatRuntimeCredentials, ChatRuntimeFactories, ChatRuntimeHostDeps, ChatRuntimeOpResult, ConversationCapabilityAction, ConversationListPresentation, ConversationListPresentationLabels, ConversationListPresentationOptions, ConversationListPreviewMediaKind, ConversationListPreviewSegment, ConversationSearchCategory, CreateThreadItemsInput, DelayedLoadingIndicator, DelayedLoadingIndicatorOptions, EmojiEntry, EmojiRecentItem, EmojiSegment, FormatTimeDisplayContext, ForwardCommandHooks, GifFileClassification, HighlightSegment, ImChannelMemberPresentation, ImChannelMentionPresentation, ImChannelProfilePresentation, ImForwardOperationResult, ImGroupMemberPresentation, ImMediaBatchSendResult, ImMessageActionResult, ImMessageBodyKind, ImMessageView, ImPinnedMessageActionResult, ImPinnedMessageSnapshot, ImProfileAccessDestination, ImQuotedMessagePresentation, ImTextResolver, ImThreadActiveDateSnapshot, ImThreadDateMarkerMetric, ImThreadDecoration, ImThreadEncryptionItem, ImThreadIntent, ImThreadItem, ImThreadPresentationAdapter, ImThreadReadActions, ImThreadReadTargetResolver, ImThreadViewportMetrics, IncomingMessageFollowInput, InitialHistoryViewportFillInput, InitialViewportCompletionInput, LinkSegment, MediaBatchBudgetOptions, MediaBatchLimitInfo, MediaFileClassification, MediaLimitItem, MediaObjectUrlLease, MediaPresentationFit, MediaPresentationPolicy, MediaPresentationRule, MediaPresentationSourceCandidate, MediaPresentationSourceQuality, MediaSendBatchResult, MemberTargetCapabilityAction, MemberTargetCapabilityInput, MessageCapabilityAction, MessageCapabilityInput, MessageLocateScrollProtectionInput, MessageNotificationDecision, MessageNotificationInput, MiniProgramHostLocale, MiniProgramOpenUrlInput, NewMessageBadgeController, NewMessageBadgeCountListener, NewMessageBadgeVisibilityInput, NewerHistoryPageTriggerInput, OlderHistoryPrefetchInput, PrependAnchorCandidate, PrependAnchorViewport, PrependMessageAnchorPosition, RemoteMessageBadgeTrackingInput, ResolveMediaPresentationInput, ResolvedMediaPresentation, RichExtraSegment, RuntimeClientOperation, RuntimeOperation, SearchBatchResult, SearchFilesInput, SearchMessagesInput, SearchTextMessagesInput, SendCapabilityMode, SendCommandHooks, SendVoicePayload, SenderProfileEntry, ServiceNoteHooks, StandaloneEmojiMessage, UnicodeEmojiEntry, VisibleChannelMiniProgramRels };
+export { DEFAULT_EMOJI_ASSET_BASE, DEFAULT_LOADING_MINIMUM_VISIBLE_MS, DEFAULT_LOADING_SHOW_DELAY_MS, EMOJI_CATALOG, EMOJI_GAME_DICE_STABLE_KEY, EMOJI_GAME_RPS_STABLE_KEY, EMOJI_TOKEN_RE, MAX_BATCH_FILES, MAX_RECENT_EMOJI_COUNT, MINI_PROGRAM_GAME_PREVIEW_FALLBACK_HEIGHT, MINI_PROGRAM_GAME_PREVIEW_FALLBACK_WIDTH, MINI_PROGRAM_LANG_NUMBERS, SPIKE_STEP, UNICODE_EMOJI_CATALOG, blockReasonForChannelSession, blockReasonForChannelState, blockReasonForGroupState, blockReasonForSession, calculateMediaBox, canEditMessage, canPinChannelMessage, canPinGroupMessage, canPinMessage, canPromoteMediaPresentationSource, canRecallMessage, canTransmit, canTransmitByType, canTransmitContent, cancelMediaUpload, captureRuntimeClientOperation, captureRuntimeOperation, channelMiniProgramRelKey, classifyGifFile, classifyMediaFile, countUnreadConversations, createChatRuntime, createConversationPrefetchController, createDelayedLoadingIndicator, createEmojiMatcher, createLinkMatcher, createNewMessageBadgeController, createThreadItems, csvIncludes, decideChannelMiniProgramRelOpen, decideConversationAction, decideMemberTargetAction, decideMessageAction, emojiAssetUrl, emojiUrlByCode, fetchConversationFileBatch, fetchConversationImageBatch, fetchConversationMessageBatch, fetchConversationVideoBatch, fetchConversationVoiceBatch, fetchNextConversationSearchBatch, formatChatDateSeparator, formatConversationDisplayTime, formatConversationUnreadBadge, formatFileSize, formatMediaDuration, forward_service as forwardService, getFileExtension, getLocalDayKey, hasEmojiCandidate, hasLinkCandidate, highlightSegments, isGifFile, isMessageLocateScrollProtected, isMessageTailChangeFromOlderWindowTrim, isMessageViewportMeasurable, isMessageVisibleForNewMessageBadge, isMiniProgramShowTypeOpenable, isPinnedMessageProtected, isVoiceStorageConfigured, loadOlderUntilBoundary, mediaBatchBudgetBytes, media_service as mediaService, message_service as messageService, normalizeLinkHref, parseUnicodeEmojiCode, pinnedMessage_service as pinnedMessageService, placeholderWaveform, prependRecentEmoji, profile_service as profileService, read_service as readService, refreshPrependMessageAnchorPosition, replaceInterruptedMediaFile, requiresConversationEncryption, requiresForwardTypeConfirmation, resampleWaveform, resolveBestMediaPresentationSource, resolveCenteredMessageScrollTop, resolveChannelMemberAvatarUrl, resolveChannelMemberDisplayName, resolveChannelMiniProgramRelIcon, resolveChannelMiniProgramRelName, resolveChannelMiniProgramRelOpenSurface, resolveChannelMiniProgramRelUrl, resolveChannelPinnedGameCopy, resolveConversationListPresentation, resolveDisplayTimestamp, resolveEmojiToken, resolveFriendDisplayName, resolveImProfileAccessDestination, resolveImThreadActiveDate, resolveMediaPresentation, resolveMemberDisplayName, resolveMessageBodyKind, resolveMessageNotificationDecision, resolveMessageTimelineTimestamp, resolveMiniProgramFloatLinkUrl, resolveMiniProgramGamePreviewLayout, resolveMiniProgramOpenUrl, resolvePrependMessageAnchor, resolvePrependMessageAnchorAdjustment, resolvePrependMessageAnchorPosition, resolvePublicNickname, resolveQuotedMessagePresentation, resolveSenderAvatarUrl, resolveStandaloneEmojiMessage, resolveSurvivingMessageAnchorAdjustment, resolveUnicodeEmoji, resolveVisibleChannelMiniProgramRels, resolveVisibleMessageAnchorPositions, retryMessage, runMediaSendBatch, sendAsFilesBatch, sendBlockReasonForDecision, sendMediaAlbum, sendMediaFile, sendMediaFilesBatch, sendText, sendVoice, shouldCompleteInitialViewport, shouldFillInitialHistoryViewport, shouldFollowIncomingMessage, shouldLoadNewerHistoryPage, shouldPrefetchOlderHistory, shouldRestoreMessageViewportFocus, shouldShowChatDateSeparator, shouldTrackRemoteMessageForBadge, sortChannelMiniProgramFloatingItems, spikeCountForDuration, supportsConversationMention, unicodeEmojiTextFromCode };
+export type { ApplySessionResult, BrowseMessagesInput, CanPinMessageInput, CenteredMessageScrollInput, ChannelMiniProgramOpenGame, ChannelMiniProgramRelOpenDecision, ChannelMiniProgramRelOpenSurface, ChatMediaMessageRef, ChatProfileAdapter, ChatRuntime, ChatRuntimeCredentials, ChatRuntimeFactories, ChatRuntimeHostDeps, ChatRuntimeOpResult, ConversationCapabilityAction, ConversationListPresentation, ConversationListPresentationLabels, ConversationListPresentationOptions, ConversationListPreviewMediaKind, ConversationListPreviewSegment, ConversationPrefetchController, ConversationPrefetchControllerOptions, ConversationSearchCategory, CreateThreadItemsInput, DelayedLoadingIndicator, DelayedLoadingIndicatorOptions, EmojiEntry, EmojiRecentItem, EmojiSegment, FormatTimeDisplayContext, ForwardCommandHooks, GifFileClassification, HighlightSegment, ImChannelMemberPresentation, ImChannelMentionPresentation, ImChannelProfilePresentation, ImForwardOperationResult, ImGroupMemberPresentation, ImMediaBatchSendResult, ImMessageActionResult, ImMessageBodyKind, ImMessageView, ImPinnedMessageActionResult, ImPinnedMessageSnapshot, ImProfileAccessDestination, ImQuotedMessagePresentation, ImTextResolver, ImThreadActiveDateSnapshot, ImThreadDateMarkerMetric, ImThreadDecoration, ImThreadEncryptionItem, ImThreadIntent, ImThreadItem, ImThreadPresentationAdapter, ImThreadReadActions, ImThreadReadTargetResolver, ImThreadViewportMetrics, IncomingMessageFollowInput, InitialHistoryViewportFillInput, InitialViewportCompletionInput, LinkSegment, MediaBatchBudgetOptions, MediaBatchLimitInfo, MediaFileClassification, MediaLimitItem, MediaObjectUrlLease, MediaPresentationFit, MediaPresentationPolicy, MediaPresentationRule, MediaPresentationSourceCandidate, MediaPresentationSourceQuality, MediaSendBatchResult, MemberTargetCapabilityAction, MemberTargetCapabilityInput, MessageCapabilityAction, MessageCapabilityInput, MessageLocateScrollProtectionInput, MessageNotificationDecision, MessageNotificationInput, MiniProgramGamePreviewInput, MiniProgramGamePreviewLayout, MiniProgramHostLocale, MiniProgramOpenUrlInput, NewMessageBadgeController, NewMessageBadgeCountListener, NewMessageBadgeVisibilityInput, NewerHistoryPageTriggerInput, OlderHistoryPrefetchInput, PrependAnchorCandidate, PrependAnchorViewport, PrependMessageAnchorPosition, RemoteMessageBadgeTrackingInput, ResolveMediaPresentationInput, ResolvedMediaPresentation, RichExtraSegment, RuntimeClientOperation, RuntimeOperation, SearchBatchResult, SearchFilesInput, SearchMessagesInput, SearchTextMessagesInput, SendCapabilityMode, SendCommandHooks, SendVoicePayload, SenderProfileEntry, ServiceNoteHooks, StandaloneEmojiMessage, UnicodeEmojiEntry, VisibleChannelMiniProgramRels };