@easemob-community/callkit-vue3 2.0.1

package/dist/store/globalCall.d.ts

@@ -0,0 +1,34 @@
+/**
+ * GlobalCallStore
+ * 跨通话域的共享状态：用户资料映射、窗口模式等
+ * 单聊/群聊共用，但不属于任何特定通话域
+ */
+export declare const useGlobalCallStore: import('pinia').StoreDefinition<"globalCall", {
+    userInfoMap: Map<string, {
+        nickname?: string;
+        avatarURL?: string;
+    }>;
+    isMinimized: boolean;
+}, {
+    getUserInfo(): (userId: string) => {
+        nickname?: string;
+        avatarURL?: string;
+    };
+    getIsMinimized(): boolean;
+}, {
+    setUserInfo(userId: string, userInfo: {
+        nickname?: string;
+        avatarURL?: string;
+    }): void;
+    /**
+     * 批量设置用户信息
+     */
+    batchSetUserInfo(entries: Array<{
+        userId: string;
+        userInfo: {
+            nickname?: string;
+            avatarURL?: string;
+        };
+    }>): void;
+    setMinimized(value: boolean): void;
+}>;

package/dist/store/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/store/rtcChannel.d.ts

@@ -0,0 +1,42 @@
+import { IAgoraRTCClient } from 'agora-rtc-sdk-ng';
+import { RtcChannelState } from './types';
+import { RtcService } from '../services/RtcService';
+/**
+ * RtcChannelStore（简化版）
+ * 职责：管理 RtcService 单例、本地媒体流状态、音视频开关状态
+ * 注意：频道管理、远程流管理已由 RtcService / GroupCallStore 负责
+ */
+export declare const useRtcChannelStore: import('pinia').StoreDefinition<"rtcChannel", RtcChannelState, {}, {
+    /**
+     * 获取RTC服务实例（从模块级变量读取，非 state）
+     */
+    getRtcService(): RtcService | null;
+    /**
+     * 初始化RTC服务
+     */
+    initializeRtcService(agoraAppId: string, agoraClient?: IAgoraRTCClient): Promise<void>;
+    /**
+     * 销毁RTC服务
+     */
+    destroyRtcService(): Promise<void>;
+    /**
+     * 设置连接状态
+     */
+    setConnected(connected: boolean): void;
+    /**
+     * 设置本地媒体流
+     */
+    setLocalStream(stream: MediaStream | null): void;
+    /**
+     * 启用/禁用音频
+     */
+    setAudioEnabled(enabled: boolean): void;
+    /**
+     * 启用/禁用视频
+     */
+    setVideoEnabled(enabled: boolean): void;
+    /**
+     * 重置所有RTC状态
+     */
+    reset(): void;
+}>;

package/dist/store/types.d.ts

@@ -0,0 +1,50 @@
+import { Chat } from '../core/sdk/imSDK';
+import { CALL_STATUS, CALL_INFO, CALL_TYPE } from '../types/callstate.types';
+export type CallStatus = CALL_STATUS;
+export interface ChatClientState {
+    client: Chat.Connection | null;
+    /** 是否使用环信 IM SDK miniCore 版本（插件模式） */
+    isMiniCore: boolean;
+}
+export interface CallParticipant {
+    userId: string;
+    nickname?: string;
+    avatar?: string;
+    isAudioEnabled: boolean;
+    isVideoEnabled: boolean;
+    isLocalUser: boolean;
+    joinedAt: number;
+}
+export interface CurrentCallInfo {
+    callId: string;
+    callerId: string;
+    calleeIds: string[];
+    callType: "audio" | "video";
+    startTime: number;
+    duration: number;
+    status: CallStatus;
+    participants: CallParticipant[];
+    isGroupCall: boolean;
+    channelId?: string;
+}
+export interface INVITE_INFO {
+    type: CALL_TYPE;
+    calleeUserId: string;
+    groupId?: string;
+    groupName?: string;
+    groupAvatar?: string;
+    invitedMembers?: string[];
+}
+export interface CallState extends CALL_INFO {
+    status: CallStatus;
+    callType: "audio" | "video" | null;
+    inviteTimeout?: number;
+    inviteTimeoutTimer?: any | null;
+}
+export interface RtcChannelState {
+    isConnected: boolean;
+    localStream: MediaStream | null;
+    audioEnabled: boolean;
+    videoEnabled: boolean;
+    agoraAppId: string | null;
+}

package/dist/types/callstate.types.d.ts

@@ -0,0 +1,61 @@
+export type CallMode = "audio" | "video" | "group";
+export type CALL_STATUS_NAME = "idle" | "inviting" | "ringing" | "connecting" | "connected" | "ended";
+export type CALL_STATUS = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export declare const CALL_STATUS: {
+    readonly IDLE: 0;
+    readonly INVITING: 1;
+    readonly ALERTING: 2;
+    readonly CONFIRM_RING: 3;
+    readonly RECEIVED_CONFIRM_RING: 4;
+    readonly ANSWER_CALL: 5;
+    readonly CONFIRM_CALLEE: 6;
+    readonly IN_CALL: 7;
+};
+export type CALLKIT_CMD_MSG_RESULT_TYPE = "accept" | "refuse" | "busy";
+export declare const CALLKIT_CMD_MSG_RESULT_TYPE: {
+    readonly ACCEPT: "accept";
+    readonly REFUSE: "refuse";
+    readonly BUSY: "busy";
+};
+export type CALLKIT_ACTION_MSG_TYPE = "rtcCallWithAgora";
+export type CALLKIT_TEXT_MSG_ACTION = "invite";
+export type CALLKIT_CMD_MSG_ACTION_TYPE = "confirmRing" | "alert" | "answerCall" | "leaveCall" | "confirmCallee" | "cancelCall";
+export type CALL_TYPE = 0 | 1 | 2 | 3;
+export declare const CALL_TYPE: {
+    readonly AUDIO_1V1: 0;
+    readonly VIDEO_1V1: 1;
+    readonly VIDEO_MULTI: 2;
+    readonly AUDIO_MULTI: 3;
+};
+export interface CALL_INFO {
+    callId: string;
+    channel: string;
+    token?: string;
+    type: CALL_TYPE;
+    callerDevId: string;
+    calleeDevId?: string;
+    callerUserId: string;
+    calleeUserId?: string;
+    groupId?: string;
+    groupName?: string;
+    groupAvatar?: string;
+    callerNickname?: string;
+    invitedMembers?: string[];
+    joinedMembers?: any[];
+    inviteMessageId?: string;
+    duration?: string;
+    state?: CALL_STATUS;
+}
+export type HANGUP_REASON = "hangup" | "cancel" | "remoteCancel" | "refuse" | "remoteRefuse" | "busy" | "noResponse" | "remoteNoResponse" | "handleOnOtherDevice" | "abnormalEnd";
+export declare const HANGUP_REASON: {
+    readonly HANGUP: "hangup";
+    readonly CANCEL: "cancel";
+    readonly REMOTE_CANCEL: "remoteCancel";
+    readonly REFUSE: "refuse";
+    readonly REMOTE_REFUSE: "remoteRefuse";
+    readonly BUSY: "busy";
+    readonly NO_RESPONSE: "noResponse";
+    readonly REMOTE_NO_RESPONSE: "remoteNoResponse";
+    readonly HANDLE_ON_OTHER_DEVICE: "handleOnOtherDevice";
+    readonly ABNORMAL_END: "abnormalEnd";
+};

package/dist/types/signal.types.d.ts

@@ -0,0 +1,187 @@
+import { CALL_TYPE, CALLKIT_ACTION_MSG_TYPE } from './callstate.types';
+export interface SignalMessageInviteExt {
+    action: "invite";
+    callId: string;
+    calleeIMName: string;
+    callerDevId: string;
+    callerIMName: string;
+    channelName: string;
+    chatType: CALL_TYPE;
+    type: CALL_TYPE;
+    ts: number;
+    msgType: CALLKIT_ACTION_MSG_TYPE;
+    em_push_ext: {
+        type: "call";
+        custom: {
+            action: "invite";
+            channelName: string;
+            type: CALL_TYPE;
+            callerDevId: string;
+            callId: string;
+            ts: number;
+            msgType: CALLKIT_ACTION_MSG_TYPE;
+            callerIMName: string;
+            calleeIMName: string;
+            callerNickname: string;
+            chatType: CALL_TYPE;
+        };
+    };
+    em_apns_ext: {
+        em_push_type: "voip";
+    };
+    ease_chat_uikit_user_info?: {
+        nickname: string;
+        avatarURL: string;
+    };
+    callkitGroupInfo?: {
+        groupId: string;
+        groupName?: string;
+        groupAvatar?: string;
+    };
+}
+/**
+ * 基础信令消息扩展字段接口
+ */
+export interface BaseSignalingExt {
+    /** 操作类型 */
+    action: string;
+    /** 通话ID */
+    callId: string;
+    /** 时间戳 */
+    ts: number;
+    /** 消息类型 */
+    msgType: string;
+}
+/**
+ * 邀请消息扩展字段接口
+ */
+export interface InviteSignalingExt extends BaseSignalingExt {
+    action: "invite";
+    /** RTC频道名称 */
+    channelName: string;
+    /** 通话类型 */
+    type: number;
+    /** 主叫设备ID */
+    callerDevId: string;
+    /** 主叫IM用户名 */
+    callerIMName: string;
+    /** 被叫IM用户名 */
+    calleeIMName: string;
+    /** 聊天类型 */
+    chatType: number;
+    /** 推送扩展字段 */
+    em_push_ext: {
+        type: string;
+        custom: {
+            action: string;
+            channelName: string;
+            type: number;
+            callerDevId: string;
+            callId: string;
+            ts: number;
+            msgType: string;
+            callerIMName: string;
+            calleeIMName: string;
+            callerNickname: string;
+            chatType: number;
+            ext?: Record<string, any>;
+        };
+    };
+    /** APNS推送扩展字段 */
+    em_apns_ext: {
+        em_push_type: string;
+    };
+    /** 自定义扩展字段 */
+    ext?: Record<string, any>;
+    /** 被邀请成员列表（群组通话时使用） */
+    invitedMembers?: string[];
+    /** 用户信息（发送方 caller 资料） */
+    ease_chat_uikit_user_info?: {
+        nickname: string;
+        avatarURL: string;
+    };
+    /** 群组通话信息 */
+    callkitGroupInfo?: {
+        groupId: string;
+        groupName?: string;
+        groupAvatar?: string;
+    };
+}
+/**
+ * 响铃消息扩展字段接口
+ */
+export interface AlertSignalingExt extends BaseSignalingExt {
+    action: "alert";
+    /** 被叫设备ID */
+    calleeDevId: string;
+    /** 主叫设备ID */
+    callerDevId: string;
+}
+/**
+ * 确认响铃消息扩展字段接口
+ */
+export interface ConfirmRingSignalingExt extends BaseSignalingExt {
+    action: "confirmRing";
+    /** 确认状态 */
+    status: boolean;
+    /** 主叫设备ID */
+    callerDevId: string;
+    /** 被叫设备ID */
+    calleeDevId: string;
+}
+/**
+ * 应答消息扩展字段接口
+ */
+export interface AnswerCallSignalingExt extends BaseSignalingExt {
+    action: "answerCall";
+    /** 应答结果 */
+    result: "accept" | "refuse" | "busy";
+    /** 主叫设备ID */
+    callerDevId: string;
+    /** 被叫设备ID */
+    calleeDevId: string;
+}
+/**
+ * 确认被叫方消息扩展字段接口
+ */
+export interface ConfirmCalleeSignalingExt extends BaseSignalingExt {
+    action: "confirmCallee";
+    /** 确认结果 */
+    result: string;
+    /** 主叫设备ID */
+    callerDevId: string;
+    /** 被叫设备ID */
+    calleeDevId: string;
+}
+/**
+ * 取消通话消息扩展字段接口
+ */
+export interface CancelCallSignalingExt extends BaseSignalingExt {
+    action: "cancelCall";
+    /** 主叫设备ID */
+    callerDevId: string;
+}
+/**
+ * 挂断通话消息扩展字段接口
+ */
+export interface LeaveCallSignalingExt extends BaseSignalingExt {
+    action: "leaveCall";
+}
+/**
+ * 所有信令消息扩展字段的联合类型
+ */
+export type SignalingExt = AlertSignalingExt | ConfirmRingSignalingExt | AnswerCallSignalingExt | ConfirmCalleeSignalingExt | CancelCallSignalingExt | LeaveCallSignalingExt;
+/**
+ * 信令消息配置接口
+ */
+export interface SignalingMessageOptions {
+    type: "cmd";
+    chatType: "singleChat" | "groupChat";
+    to: string;
+    action: string;
+    ext: SignalingExt;
+    receiverList?: string[];
+    /** 是否直投在线用户 */
+    deliverOnlineOnly: boolean;
+}
+export type CALLKIT_SIGNALING_CMD_ACTION = "rtcCall";

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+import { Chat } from './core/sdk/imSDK';
+import { IAgoraRTCClient } from 'agora-rtc-sdk-ng';
+import { HANGUP_REASON } from './types/callstate.types';
+import { LogLevel } from './utils/logger';
+export interface EasemobChatCallKitOptions {
+    appKey: string;
+    userId?: string;
+    accessToken?: string;
+    debug?: boolean;
+    enableRingtone?: boolean;
+    resizable?: boolean;
+    draggable?: boolean;
+    chatClient?: any;
+}
+export interface CallKitInstance {
+    startCall: (targetId: string, type: "audio" | "video") => void;
+    endCall: () => void;
+    startChat: (targetId: string) => void;
+    isInCall: boolean;
+    callType: "audio" | "video" | null;
+    targetUser: string;
+    config: any;
+}
+export interface ProviderConfig {
+    chatClient?: Chat.Connection;
+    agoraClient?: IAgoraRTCClient;
+    agoraAppId?: string;
+    /**
+     * 是否使用环信 IM SDK miniCore 版本（插件模式）
+     * 启用后 callkit 内部将使用命名空间 API（client.contact.* / client.group.* / client.Message.create）
+     * 默认 false，使用 full 版本 API（实例直调）
+     */
+    isMiniCore?: boolean;
+    initConfig?: {
+        debug?: boolean;
+        logLevel?: LogLevel;
+        enableIDBLog?: boolean;
+        enableRingtone?: boolean;
+        resizable?: boolean;
+        draggable?: boolean;
+        inviteTimeout?: number;
+    };
+    /**
+     * 用户信息查询 Provider
+     * 用于获取通话参与者的昵称和头像
+     * @param userIds 用户ID数组
+     * @returns 用户信息数组 { userId, nickname?, avatarUrl? }
+     */
+    getUserInfo?: (userIds: string[]) => Promise<Array<{
+        userId: string;
+        nickname?: string;
+        avatarUrl?: string;
+    }>>;
+    /**
+     * 群组信息查询 Provider
+     * 用于获取群组的名称和头像
+     * @param groupIds 群组ID数组
+     * @returns 群组信息数组 { groupId, groupName?, groupAvatar? }
+     */
+    getGroupInfo?: (groupIds: string[]) => Promise<Array<{
+        groupId: string;
+        groupName?: string;
+        groupAvatar?: string;
+    }>>;
+}
+export interface CallParams {
+    targetId: string;
+    type: "audio" | "video";
+    msg?: string;
+    userInfo?: {
+        nickname?: string;
+        avatarURL?: string;
+    };
+}
+export interface GroupCallParams {
+    groupId: string;
+    members: string[];
+    type: "audio" | "video";
+    msg?: string;
+    groupName?: string;
+    groupAvatar?: string;
+    userInfo?: {
+        nickname?: string;
+        avatarURL?: string;
+    };
+}
+export type EasemobChatCallKitInstance = CallKitInstance;
+export interface UseCallKitReturn {
+    /** 发起单人通话 */
+    call: (params: CallParams) => Promise<void>;
+    /** 发起群组通话 */
+    groupCall: (params: GroupCallParams) => Promise<void>;
+    /** 挂断/结束通话 */
+    hangup: (reason?: HANGUP_REASON) => Promise<void>;
+    /** 取消通话邀请 */
+    cancel: () => Promise<void>;
+    /** 接听通话 */
+    accept: () => Promise<void>;
+    /** 拒绝通话 */
+    reject: () => Promise<void>;
+    /** 忙碌拒绝通话 */
+    rejectBusy: () => Promise<void>;
+}

package/dist/utils/callUtils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CallKit工具函数
+ */
+/**
+ * 生成随机channel字符串
+ * @param length 字符串长度，默认8位
+ * @returns 随机字符串
+ */
+export declare const generateRandomChannel: (length?: number) => string;
+/**
+ * 格式化通话时间
+ * @param seconds 秒数
+ * @returns 格式化的时间字符串 (HH:MM:SS 或 MM:SS)
+ */
+export declare const formatCallDuration: (seconds: number) => string;

package/dist/utils/imSdkAdapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * IM SDK 兼容适配层
+ *
+ * 通过外层传入的 isMiniCore 标志显式切换调用方式：
+ * - isMiniCore = false (默认): 使用 full 版 API，直接挂在 Connection 实例上
+ * - isMiniCore = true: 使用 miniCore 插件模式 API，挂在命名空间下
+ */
+/**
+ * 获取用户资料（昵称、头像等）
+ * full: client.fetchUserInfoById(userIds, properties)
+ * miniCore(插件): client.contact.fetchUserInfoById(userIds, properties)
+ */
+export declare function fetchUserInfoById(client: any, userIds: string[], properties?: string[], isMiniCore?: boolean): Promise<any>;
+/**
+ * 获取群成员列表
+ * full: client.getGroupMembers(params)
+ * miniCore(插件): client.group.getGroupMembers(params)
+ */
+export declare function getGroupMembers(client: any, params: {
+    groupId: string;
+    pageSize: number;
+    cursor?: string | null;
+}, isMiniCore?: boolean): Promise<any>;
+/**
+ * 获取好友列表（如需扩展）
+ * full: client.getContacts(params)
+ * miniCore(插件): client.contact.getContacts(params)
+ */
+export declare function getContacts(client: any, params?: any, isMiniCore?: boolean): Promise<any>;

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './callUtils';
+export * from './logger';

package/dist/utils/logger.d.ts

@@ -0,0 +1,122 @@
+export declare const LogLevel: {
+    readonly ERROR: 0;
+    readonly WARN: 1;
+    readonly INFO: 2;
+    readonly DEBUG: 3;
+    readonly VERBOSE: 4;
+};
+export type LogLevel = typeof LogLevel[keyof typeof LogLevel];
+export declare const ANSI_COLORS: {
+    RESET: string;
+    RED: string;
+    YELLOW: string;
+    GREEN: string;
+    BLUE: string;
+    GRAY: string;
+};
+export declare const LogLevelNames: {
+    0: string;
+    1: string;
+    2: string;
+    3: string;
+    4: string;
+};
+export declare const LogLevelColors: {
+    0: string;
+    1: string;
+    2: string;
+    3: string;
+    4: string;
+};
+export interface LoggerConfig {
+    level: LogLevel;
+    enableConsole: boolean;
+    enablePrefix: boolean;
+    prefix?: string;
+    debug?: boolean;
+    enableIDB?: boolean;
+    idbLevel?: LogLevel;
+    idbRetentionDays?: number;
+    idbMaxSizeMB?: number;
+}
+export declare class Logger {
+    private static instance;
+    private config;
+    private db;
+    private sessionId;
+    private constructor();
+    static getInstance(config?: Partial<LoggerConfig>): Logger;
+    updateConfig(config: Partial<LoggerConfig>): void;
+    setDebug(debug: boolean): void;
+    getConfig(): LoggerConfig;
+    setLevel(level: LogLevel): void;
+    setConsoleEnabled(enabled: boolean): void;
+    setPrefixEnabled(enabled: boolean): void;
+    setPrefix(prefix: string): void;
+    setIDBEnabled(enabled: boolean): void;
+    setIDBLevel(level: LogLevel): void;
+    setSessionId(id: string | undefined): void;
+    getSessionId(): string | undefined;
+    private shouldLog;
+    private shouldWriteToIDB;
+    private formatMessage;
+    private initDB;
+    private extractMeta;
+    private writeToIDB;
+    error(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    verbose(message: string, ...args: any[]): void;
+    log(message: string, ...args: any[]): void;
+    console(message: string, ...args: any[]): void;
+    getCurrentLevelName(): string;
+    isLevelEnabled(level: LogLevel): boolean;
+    /**
+     * 信令日志
+     * @param direction 'send' | 'recv'
+     * @param action 信令 action
+     * @param meta 结构化数据（from/to/callId/result 等）
+     */
+    signal(direction: 'send' | 'recv', action: string, meta?: Record<string, any>): void;
+    /**
+     * 状态变更日志
+     * @param from 原状态
+     * @param to 新状态
+     * @param meta 触发上下文
+     */
+    stateChange(from: any, to: any, meta?: Record<string, any>): void;
+    /**
+     * RTC 事件日志
+     * @param event 事件名
+     * @param meta 结构化数据
+     */
+    rtc(event: string, meta?: Record<string, any>): void;
+    /**
+     * 业务事件日志
+     * @param event 事件名
+     * @param meta 结构化数据
+     */
+    event(event: string, meta?: Record<string, any>): void;
+    /** 按 sessionId 导出日志（不传则导出全部） */
+    exportLogsBySession(sessionId?: string): Promise<import('./loggerDb').CallKitLogEntry[]>;
+    /** 按时间范围导出日志 */
+    exportLogsByTimeRange(start: number, end: number): Promise<import('./loggerDb').CallKitLogEntry[]>;
+    /** 获取最近有日志的 sessionId 列表 */
+    getSessions(): Promise<string[]>;
+    /** 清理日志（默认按配置中的保留天数） */
+    clearLogs(days?: number): Promise<number>;
+    /** 导出为 JSON 字符串（便于下载/上报） */
+    exportLogsAsJSON(sessionId?: string): Promise<string>;
+    /** 导出为纯文本字符串（便于直接阅读） */
+    exportLogsAsText(sessionId?: string): Promise<string>;
+    /** 格式化为易读的本地时间 */
+    private formatReadableTime;
+}
+export declare const logger: Logger;
+export declare const logError: (message: string, ...args: any[]) => void;
+export declare const logWarn: (message: string, ...args: any[]) => void;
+export declare const logInfo: (message: string, ...args: any[]) => void;
+export declare const logDebug: (message: string, ...args: any[]) => void;
+export declare const logVerbose: (message: string, ...args: any[]) => void;
+export declare const log: (message: string, ...args: any[]) => void;

package/dist/utils/loggerDb.d.ts

@@ -0,0 +1,41 @@
+import { default as Dexie, Table } from 'dexie';
+import { LogLevel } from './logger';
+export type LogCategory = 'signal' | 'state' | 'rtc' | 'event' | 'error' | 'general';
+/**
+ * CallKit 单条日志结构
+ * 设计目标：支持按通话(callId)维度还原完整信令时序与状态流转
+ */
+export interface CallKitLogEntry {
+    id?: number;
+    timestamp: number;
+    level: LogLevel;
+    category: LogCategory;
+    tag: string;
+    message: string;
+    sessionId?: string;
+    meta?: Record<string, any>;
+}
+/**
+ * CallKitLogDB
+ * 基于 Dexie 的 IndexedDB 封装
+ * 职责：结构化存储日志，支持按会话/时间范围导出，自带容量上限控制
+ */
+export declare class CallKitLogDB extends Dexie {
+    logs: Table<CallKitLogEntry, number>;
+    constructor();
+    write(entry: Omit<CallKitLogEntry, 'id'>, maxSizeMB?: number): Promise<void>;
+    /** 按容量上限清理最旧的日志 */
+    enforceSizeLimit(maxSizeMB: number): Promise<void>;
+    /** 按 sessionId 导出（正序，最近 2000 条） */
+    exportBySession(sessionId: string, limit?: number): Promise<CallKitLogEntry[]>;
+    /** 按时间范围导出（正序） */
+    exportByTimeRange(start: number, end: number, limit?: number): Promise<CallKitLogEntry[]>;
+    /** 导出全部（倒序，最近 5000 条） */
+    exportAll(limit?: number): Promise<CallKitLogEntry[]>;
+    /** 清理 N 天前的日志 */
+    clearBefore(days?: number): Promise<number>;
+    /** 按 sessionId 清理 */
+    clearBySession(sessionId: string): Promise<number>;
+    /** 获取最近有日志的 sessionId 列表（去重） */
+    getSessions(limit?: number): Promise<string[]>;
+}