k2-im 0.1.29 → 0.1.31

package/dist/browser.js

@@ -1 +1 @@
-export{A as createLazyBrowserApiProtocolClient}from'./chunk-TKWU3IO7.js';import'./chunk-XICYFDN4.js';import'./chunk-WOT6VMZA.js';
+export{B as createLazyBrowserApiProtocolClient}from'./chunk-SMWPQSGR.js';import'./chunk-CIY4WBFJ.js';import'./chunk-WOT6VMZA.js';

package/dist/chat-kit-pinia.d.ts

@@ -4,8 +4,8 @@ import { Pinia, Store } from 'pinia';
 /** 媒体业务类型：实现据此选对象存储逻辑桶；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` 的领域内唯一。
  *
@@ -42,8 +42,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）；
@@ -112,6 +112,8 @@ type LastMessageSummary = {
     gameType: ImGameType;
 } | {
     kind: 'transfer';
+} | {
+    kind: 'gift';
 } | {
     kind: 'call';
     callKind: ImCallKind;
@@ -311,13 +313,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。
  */
@@ -341,6 +344,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`）。
@@ -419,6 +428,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';
 /**
@@ -577,6 +620,8 @@ interface ImMessageBody {
     game?: ImGameBody;
     /** contentType==='transfer' 时的转账卡片。 */
     transfer?: ImTransferBody;
+    /** contentType==='gift' 时的礼品/刮刮卡卡片。 */
+    gift?: ImGiftBody;
     /** contentType==='call' 时的单聊通话记录。 */
     call?: ImCallRecordBody;
     /** contentType==='redPacket' 时的红包卡片。 */
@@ -965,7 +1010,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;
@@ -1852,6 +1897,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）。 */
@@ -2000,6 +2083,8 @@ type StoredConversationBackground = {
  * 失败经 `error` 事件（scope:'storage'）暴露、不静默吞、不阻塞内存主流程。
  */
 interface ImStoragePort {
+    /** 可选的最近页持久缓存；缺少该能力时 SDK 必须明确跳过持久预取。 */
+    recentHistoryCache?: ImRecentHistoryCachePort;
     /** 打开/创建账号库并跑迁移（幂等）。open 前的读写应视为未就绪并抛错（不静默兜底）。 */
     open: (options: ImStorageOpenOptions) => Promise<void>;
     /** 关闭库句柄（登出/切账号）。 */
@@ -2161,6 +2246,10 @@ interface ImStoragePort {
 type ImEvent = {
     type: 'connection:changed';
     state: ImConnectionState;
+}
+/** 同账号已由另一个浏览器页面接管；本页会话不可复用，但宿主登录仍有效。 */
+ | {
+    type: 'session:replaced';
 } | {
     type: 'message:received';
     message: ImMessage;
@@ -2783,10 +2872,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`。
@@ -2835,8 +2925,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()` 释放句柄。
@@ -3027,6 +3117,10 @@ interface MiniProgramMessageOptions {
 interface TransferMessageOptions {
     replyToMessageId?: string;
 }
+/** 礼品卡片发送选项；正文必须已含福利中心赠送后的流水号与卡面。 */
+interface GiftMessageOptions {
+    replyToMessageId?: string;
+}
 /**
  * 媒体合集里的一项：一张图片或一个视频。
  *
@@ -3438,6 +3532,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 是唯一真相；附件尚未闭合时非空输入明确拒绝。
@@ -3475,7 +3584,7 @@ interface ConversationDraftApi {
     subscribe: (listener: (draft: ConversationDraft | null) => void) => () => void;
 }
 /**
- * 当前账号的跨组件草稿 API；所有动作都要求 direct/GROUP/CHANNEL 精确复合身份。
+ * 当前账号的跨组件草稿 API；所有动作都要求 direct / GROUP / CHANNEL / robot 精确复合身份。
  *
  * @example
  * ```ts
@@ -3499,11 +3608,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 中唯一命中时可用。
  *
@@ -3527,6 +3636,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;
@@ -3900,7 +4011,7 @@ interface ImDirectCallsApi {
  * Blob 只经 storage 持久化。异步读取使用运行时代际防止切会话/切账号晚返回，宿主负责最终渲染与 URL 释放。
  */
 
-type ConversationBackgroundConversationType = 'direct' | 'group' | 'channel';
+type ConversationBackgroundConversationType = 'direct' | 'group' | 'channel' | 'robot';
 interface ConversationBackgroundPreset {
     id: string;
     url: string;
@@ -4060,7 +4171,7 @@ interface ImChannelProfile {
  */
 
 /** default 会话列表支持的精确类型；`supergroup` 继续受产品 Gate 约束。 */
-type ProductConversationListType = 'direct' | 'group' | 'channel';
+type ProductConversationListType = 'direct' | 'group' | 'channel' | 'robot';
 /** GROUP 会话限制状态；与 CHANNEL 状态保持独立 sibling。 */
 type ImGroupConversationState = GroupSessionState;
 /**
@@ -4119,6 +4230,8 @@ type ConversationLastMessageSummary = {
     kind: 'robot';
 } | {
     kind: 'transfer';
+} | {
+    kind: 'gift';
 } | {
     kind: 'redPacket';
 } | {
@@ -4232,6 +4345,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;
@@ -4272,6 +4387,12 @@ interface DirectConversationCapabilities {
     canUseMessageActions: CapabilityDecision;
     canManageRelationship: CapabilityDecision;
 }
+interface RobotConversationCapabilities {
+    canSendMessages: CapabilityDecision;
+    canOpenProfile: CapabilityDecision;
+    canUseMessageActions: CapabilityDecision;
+    canReadHistory: CapabilityDecision;
+}
 /**
  * 普通群能力快照。
  *
@@ -4338,6 +4459,8 @@ type ConversationCapabilitySnapshot = (ConversationCapabilityBase<'direct'> & {
     value: GroupConversationCapabilities;
 }) | (ConversationCapabilityBase<'channel'> & {
     value: ChannelConversationCapabilities;
+}) | (ConversationCapabilityBase<'robot'> & {
+    value: RobotConversationCapabilities;
 });
 interface ImConversationCapabilitiesApi {
     /** 只读取 SDK 当前本机真相与已刷新过的资料/关系投影，不隐式联网。 */
@@ -4504,7 +4627,7 @@ interface ImMessagesByIdResult<TMessage> {
  */
 
 /** 当前已接线的产品 handle 会话类型；三者只在无会话语义原子层复用。 */
-type ProductHandleConversationType = 'direct' | 'group' | 'channel';
+type ProductHandleConversationType = 'direct' | 'group' | 'channel' | 'robot';
 /**
  * 会话 handle 初始打开位置。
  *
@@ -4517,6 +4640,8 @@ type ConversationInitialPosition = 'latest' | 'first-unread';
  * @remarks 选项只影响初始连续窗口和 `entryUnread` 快照；发送、历史分页、已读和 close 语义保持不变。
  */
 interface ConversationOpenOptions {
+    /** 取消尚未交付的会话打开及其历史请求；句柄交付后由 close 管理生命周期。 */
+    signal?: AbortSignal;
     /**
      * 初始连续窗口位置。
      *
@@ -4637,6 +4762,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 猜动作的产品交互。 */
@@ -5146,6 +5277,8 @@ interface ImProductEventMap {
     'connection:changed': Readonly<{
         snapshot: ImLifecycleSnapshot;
     }>;
+    /** 另一个页面接管聊天；宿主可提示刷新此页重新接管，不应退出业务登录。 */
+    'session:replaced': Readonly<Record<never, never>>;
     'message:received': Readonly<{
         ref: ConversationRef<ProductConversationListType>;
         message: ImProductMessage;
@@ -5474,6 +5607,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>;
+}
+
 /**
  * 当前账号本地会话与消息的分场景产品搜索运行时。
  *
@@ -5536,6 +5720,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'>>;
     /** 只搜索文件消息；省略或传空白关键词时按文件分类浏览。 */
@@ -6065,7 +6251,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。
@@ -6089,6 +6275,8 @@ interface ImProductClient {
     readonly conversations: ImConversationListApi;
     /** 当前账号完整联系人、群组和社群目录的统一搜索。 */
     readonly directory: ImDirectorySearchApi;
+    /** 机器人公开目录；通讯录查找与群/社群绑定列表共用分页合同。 */
+    readonly robots: ImRobotsApi;
     readonly contacts: ImContactsApi;
     readonly groups: ImGroupsApi;
     readonly channels: ImChannelsApi;
@@ -6138,6 +6326,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;
@@ -6289,7 +6478,7 @@ declare function useImApplicationsStore(pinia?: Pinia): ImApplicationsStore;
  * 二期收敛：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';
 
 /**
  * 本文件管理图片和视频本地预览地址的完整生命周期。
@@ -6589,7 +6778,8 @@ interface ChatRuntime {
     /**
      * 在账号或 token 发生变化时，立即停止并清理旧账号运行资源。
      *
-     * 它会断开旧连接，关闭本机消息库，丢弃 SDK Client、资料缓存和媒体资源，并递增账号版本号；
+     * 它会立即停止旧连接并丢弃页面资源，异步销毁 SDK Client、关闭消息库和释放浏览器锁；
+     * 新 prepare/connect 等待清理完成，账号版本号同步递增；
      * 已注册的 Store 监听器会保留，以便新账号重新连接后继续接收事件。通常由 `applySession` 自动调用。
      */
     resetForAuthChange: () => void;
@@ -6650,7 +6840,7 @@ interface ChatRuntime {
     /** 撤销当前账号创建的全部媒体预览地址并释放 Blob 内存，切账号、退出或销毁时调用。 */
     cleanupLocalMediaBlobs: () => void;
     /** 删除会话时释放该会话绑定的本地媒体预览/播放缓存。 */
-    cleanupConversationMediaBlobs: (conversation: ConversationRef<'direct' | 'group' | 'channel'>) => void;
+    cleanupConversationMediaBlobs: (conversation: ConversationRef<'direct' | 'group' | 'channel' | 'robot'>) => void;
 }
 
 /** 当前置顶消息的稳定资料；普通群和社群各自保留明确会话身份。 */
@@ -6996,6 +7186,8 @@ interface ImConversationListStore {
     readonly items: readonly ConversationListItem[];
     readonly state: ImConversationListState;
     readonly totalUnread: number;
+    /** 菜单角标使用的非免打扰未读会话数；totalUnread 仍为 SDK 原始未读消息条数。 */
+    readonly unreadConversationCount: number;
     readonly error: ImSdkErrorShape | null;
     start: () => void;
     reset: () => void;
@@ -7033,6 +7225,7 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     items: any;
     state: any;
     totalUnread: any;
+    unreadConversationCount: any;
     error: any;
     start: () => void;
     reset: () => void;
@@ -7047,6 +7240,7 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     items: any;
     state: any;
     totalUnread: any;
+    unreadConversationCount: any;
     error: any;
     start: () => void;
     reset: () => void;
@@ -7061,6 +7255,7 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     items: any;
     state: any;
     totalUnread: any;
+    unreadConversationCount: any;
     error: any;
     start: () => void;
     reset: () => void;