@hchuanz/pocket-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1352 @@
+interface PocketUser {
+    userId?: number;
+    nickname?: string;
+    name?: string;
+    phone?: string;
+    avatar?: string;
+    level?: number;
+    money?: number;
+    token?: string;
+    lastLoginTime?: number;
+}
+interface MemberInfo {
+    teamName: string;
+    teamId: number;
+    serverIcon: string;
+    serverId: number;
+    serverName: string;
+    memberId: number;
+    memberName: string;
+}
+interface MemberFlipCustom {
+    anonymityCost: number;
+    answerType: 1 | 2 | 3;
+    baseCost: number;
+    normalCost: number;
+    privateCost: number;
+    status: number;
+}
+interface MemberFlipInfo {
+    customs: MemberFlipCustom[];
+}
+interface FlipRecord {
+    answerId: string;
+    /** 提问 ID：每条翻牌恒定且非空，是唯一可靠的去重键 */
+    questionId?: string;
+    cost: number;
+    answerType: number;
+    answerTime: string;
+    qtime: string;
+    type: number;
+    status: number;
+    content: string;
+    answerContent?: string;
+    baseUserInfo?: {
+        userId: number;
+        nickname: string;
+        avatar: string;
+    };
+}
+interface FlipCardGroup {
+    xoxId: number;
+    xoxNickname: string;
+    cards: Array<{
+        answerId: string;
+        cost: number;
+        answerType: number;
+        answerTime: string;
+        qtime: string;
+        type: number;
+    }>;
+}
+interface DashboardInfo {
+    totalFlipCount: number;
+    runningCount: number;
+    returnedCount: number;
+    costTotal: number;
+}
+interface FlipCacheMeta {
+    syncedAt: number;
+    recordCount: number;
+}
+interface FlipUserCache {
+    userId: string;
+    records: FlipRecord[];
+    groupedDataById: Record<string, FlipCardGroup>;
+    dashboardInfo: DashboardInfo;
+    meta: FlipCacheMeta;
+}
+type FlipSyncMode = 'incremental' | 'full';
+interface FlipSearchParams {
+    pageSize?: number;
+    pageNum?: number;
+    xoxId?: number;
+    startTimeMs?: number;
+    endTimeMs?: number;
+    type?: number;
+    status?: number;
+    answerType?: number;
+    keyword?: string;
+}
+interface FlipSendParams {
+    memberId: string;
+    content: string;
+    type: number;
+    cost: string;
+    answerType: number;
+}
+interface MemberSearchParams {
+    teamId?: number;
+    memberName?: string;
+    isFavorite?: boolean;
+}
+interface RoomJumpResult {
+    channelId: number;
+    serverId?: number;
+}
+interface RoomChannelInfo {
+    channelId: number;
+    channelName: string;
+    serverId: number;
+    teamId: number;
+    ownerId: number;
+    ownerName: string;
+    channelPocketType: number;
+    channelStatus: number;
+    serverType: number;
+    functionType: string;
+    bgImg: string;
+    pocketAccessMode: number;
+    hasMsgBoard: number;
+    activitySwitch: boolean;
+}
+interface RoomMessageSender {
+    userId: number;
+    nickName: string;
+    avatar: string;
+    level?: number;
+}
+interface RoomLiveInfo {
+    liveId?: string;
+    liveTitle?: string;
+    liveCover?: string;
+    shortPath?: string;
+}
+interface RoomGiftInfo {
+    giftName?: string;
+    giftNum?: number;
+    giftPic?: string;
+}
+interface RoomReplyInfo {
+    replyName?: string;
+    replyText?: string;
+    replyMessageId?: string;
+}
+interface RoomMessage {
+    msgId: string;
+    msgTime: number;
+    msgType: string;
+    text?: string;
+    mediaUrl?: string;
+    mediaDuration?: number;
+    liveInfo?: RoomLiveInfo;
+    giftInfo?: RoomGiftInfo;
+    replyInfo?: RoomReplyInfo;
+    sender?: RoomMessageSender;
+}
+interface RoomMessagePage {
+    messages: RoomMessage[];
+    nextTime: number;
+}
+interface PocketApiResponse<T = unknown> {
+    success?: boolean;
+    status?: number;
+    message?: string;
+    content?: T;
+    data?: {
+        content?: T;
+    };
+}
+/** 网易云信 IM 登录凭证（/im/api/v1/im/userinfo 下发），用于登 NIM 长连接 */
+interface ImUserInfo {
+    accid: string;
+    pwd: string;
+    userId: number;
+}
+
+interface ModelConfig {
+    baseUrl: string;
+    apiKey: string;
+    chatModel: string;
+    reasoningModel: string;
+    embeddingModel: string;
+    lightweightModel: string;
+    mirrorMode: string;
+    analysisTemperature?: number;
+    chatTemperature?: number;
+}
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    tool_call_id?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+interface ChatCompletionChunk {
+    content: string;
+    toolCalls: Array<{
+        index: number;
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    isDone: boolean;
+}
+type MirrorMode = 'economy' | 'performance';
+
+interface MirrorPersona {
+    personalityTraits: string[];
+    speechPatterns: string[];
+    signaturePhrases: string[];
+    emotionalTone: string;
+    personaSummary: string;
+    relationship?: MirrorRelationship;
+    recentActivity?: MirrorRecentActivity;
+}
+interface MirrorRelationship {
+    dynamic: string;
+    closeness: number;
+    howSheAddressesMe: string;
+    topicsWeDiscuss: string[];
+    evolution: string;
+}
+interface MirrorRecentActivity {
+    topics: string[];
+    mood: string;
+    events: string[];
+}
+interface MirrorProfile {
+    xoxId: number;
+    xoxNickname: string;
+    persona: MirrorPersona;
+    previousPersona?: MirrorPersona;
+    fewShotExamples: Array<{
+        userQuestion: string;
+        idolReply: string;
+        relevance: number;
+    }>;
+    meta: {
+        totalSamplesUsed: number;
+        lastUpdatedAt: number;
+        dataRangeMs: [number, number];
+        maturityScore: number;
+    };
+    growthLog?: GrowthEvent[];
+}
+interface GrowthEvent {
+    timestamp: number;
+    reason: string;
+    changes: string[];
+}
+interface ChatSession {
+    sessionId: string;
+    xoxId: number;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    createdAt: number;
+    lastActiveAt: number;
+}
+/**
+ * Normalize a persona from disk or LLM output.
+ * Old profiles / incomplete LLM responses may miss fields; fill in safe defaults
+ * so downstream consumers (chat prompt builder, frontend render) never crash.
+ */
+declare function normalizePersona(persona: Partial<MirrorPersona> | null | undefined): MirrorPersona;
+interface MirrorConfig {
+    /** LLM analysis: max flip records to sample for persona extraction */
+    llmSampleSize: number;
+    /** LLM analysis: max_tokens for the analysis response */
+    llmMaxTokens: number;
+    /** LLM analysis: temperature (0=deterministic, 1=creative) */
+    analysisTemperature: number;
+    /** Chat: max rounds of conversation history to keep */
+    chatHistoryRounds: number;
+    /** Chat: temperature (0=deterministic, 1=creative) */
+    chatTemperature: number;
+    /** RAG: top-K results to retrieve from vector index */
+    ragTopK: number;
+    /** RAG: minimum cosine similarity score to include a result */
+    ragMinScore: number;
+    /** Episodic memory: max recent conversation summaries to inject */
+    memoryEpisodes: number;
+    /** Embedding: max records to build vector index for (0 = unlimited) */
+    embeddingMaxRecords: number;
+}
+
+/**
+ * Pocket48 客户端常量
+ *
+ * 来自反编译的 Android APK（com.pocket.snh48），
+ * 这些是客户端签名常量，不是用户密码或 API Key。
+ *
+ * ⚠ 安全提示：真实 token / apiKey / 用户密码不得写入此文件。
+ *   apiKey 仅由 ISecureStorage 管理，token 由 IConfigStore 管理。
+ */
+/** 所有业务接口前缀 */
+declare const POCKET_API_BASE = "https://pocketapi.48.cn";
+/** 头像/图片相对路径必须拼此前缀（如 /content/images/xxx.png → https://source.48.cn/content/images/xxx.png） */
+declare const AVA_BASE_URL = "https://source.48.cn";
+/** 客户端描述 JSON（deviceId 为固定值，非用户设备） */
+declare const POCKET_APP_INFO: string;
+/** 客户端签名 pa 头（静态值，非密码学签名） */
+declare const POCKET_PA = "MTc4MjM3NDEwNjAwMCw3NzE1LEIwODM5QzdEMjZFQzJFOTFERTExNDVERDU2NTlBRjk5LA==";
+/** User-Agent */
+declare const POCKET_USER_AGENT = "PocketFans201807/7.1.37 (iPhone; iOS 26.4; Scale/3.00)";
+/** token 本地过期时间 */
+declare const SESSION_EXPIRE_MS: number;
+
+/**
+ * 日志端口。
+ *
+ * 对应原 hchuanz-pocket-helper 中的 `ee-core/log` 的 logger
+ * （`logger.debug/info/warn/error`）。core 只消费本接口，不依赖任何日志库。
+ */
+interface ILogger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+
+/**
+ * 存储端口。
+ *
+ * 抽象 Electron 的 `app.getPath('userData')` + Node `fs`/`path`。
+ * core 内所有镜像/翻牌/会话/群聊的 JSON 持久化都收敛到本接口，
+ * 业务模块禁止直接 import `fs` / `path`。
+ *
+ * subpath 相对 `root`，对应原代码里 `path.join(app.getPath('userData'), ...)` 的相对部分。
+ */
+interface IStorage {
+    /** 存储根路径（对应 userData 目录） */
+    readonly root: string;
+    /** 读取 JSON 文件，不存在或解析失败返回 null */
+    readJson<T = unknown>(subpath: string): T | null;
+    /** 写入 JSON（缩进 2 空格，对齐原 writeFileSync(..., JSON.stringify(x, null, 2))） */
+    writeJson(subpath: string, data: unknown): void;
+    exists(subpath: string): boolean;
+    delete(subpath: string): void;
+    /** 列出目录下所有文件名（不含子目录） */
+    list(dirSubpath: string): string[];
+    /** 递归创建目录 */
+    mkdir(dirSubpath: string): void;
+}
+
+/**
+ * 安全存储端口。
+ *
+ * 抽象 Electron 的 `safeStorage`（`encryptString/decryptString`），
+ * 用于加密用户 LLM API Key。core 只消费本接口，Electron 实现留在原仓库。
+ *
+ * 返回 base64 字符串，对齐 `safeStorage.encryptString(...).toString('base64')`。
+ */
+interface ISecureStorage {
+    /** 是否可用（对应 safeStorage.isEncryptionAvailable()） */
+    isAvailable(): boolean;
+    encryptString(plain: string): string;
+    decryptString(encoded: string): string;
+}
+
+/**
+ * KV 配置存储端口。
+ *
+ * 抽象原 hchuanz-pocket-helper 的 `storeService`（ee-core），
+ * 用于保存模型配置、推送配置、token 等 key-value 数据。
+ *
+ * 原 `set` 有 `persist` 参数（内存/持久分层），新接口简化为默认持久化；
+ * 纯内存场景由 adapters 的 MemoryConfigStore 单独提供。
+ */
+interface IConfigStore {
+    get<T = unknown>(key: string): T | undefined;
+    set(key: string, value: unknown): void;
+    remove(key: string): void;
+    has(key: string): boolean;
+    clear(): void;
+}
+
+/**
+ * 翻牌数据源端口。
+ *
+ * 抽象原 hchuanz-pocket-helper 的 `flipCacheService`，
+ * 只保留裸读写（按 userId 分桶）；dashboard 统计、groupDataById 聚合等纯逻辑
+ * 由 core 内业务模块负责。
+ */
+interface IFlipDataSource {
+    get(userId: string): FlipUserCache | null;
+    set(cache: FlipUserCache): void;
+    clear(userId: string): void;
+}
+
+interface ChatCompletionOptions {
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    timeoutMs?: number;
+}
+interface ChatCompletionResult {
+    content: string;
+    toolCalls: ChatMessage['tool_calls'];
+}
+/**
+ * LLM 客户端端口。
+ *
+ * 抽象原 hchuanz-pocket-helper 的 `common/providers.ts`（OpenAI 兼容 API）。
+ * core 通过本接口完成对话/流式/embedding/连通性测试，
+ * 具体实现走原生 fetch（OpenAICompatibleClient）。
+ */
+interface ILlmClient {
+    chatCompletion(config: ModelConfig, messages: ChatMessage[], tools?: ToolDefinition[], options?: ChatCompletionOptions): Promise<ChatCompletionResult>;
+    chatCompletionStream(config: ModelConfig, messages: ChatMessage[], onChunk: (chunk: ChatCompletionChunk) => void, tools?: ToolDefinition[], options?: ChatCompletionOptions): Promise<ChatMessage['tool_calls']>;
+    embed(config: ModelConfig, texts: string[], model?: string): Promise<number[][]>;
+    testConnection(config: ModelConfig): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+
+/**
+ * 流式聊天输出端口。
+ *
+ * 抽象原 hchuanz-pocket-helper 里 mirrorChat 的流式回调
+ * （`onChunk(content, isDone, newSessionId)`）。
+ * Electron 侧把 `IChatStreamSink` 包一层 `webContents.send`。
+ */
+interface IChatStreamSink {
+    onChunk(content: string, isDone: boolean, newSessionId?: string): void;
+}
+/**
+ * 事件推送端口。
+ *
+ * 抽象 Electron 的 `BrowserWindow.webContents.send(channel, payload)`，
+ * 用于群聊等场景把结构化事件推给渲染进程。
+ */
+interface IEventSink {
+    emit(channel: string, payload: unknown): void;
+}
+
+/**
+ * 认证过期处理端口。
+ *
+ * 抽象原 hchuanz-pocket-helper 中 `kickToLogin()` 的逻辑：
+ * toast 提示 + 清登录态 + 跳登录页。core 只定义回调接口，
+ * 具体实现由宿主（Electron / MCP CLI）注入。
+ */
+interface IAuthExpiredHandler {
+    /** 登录过期回调。宿主负责 toast + 清登录态 + 跳登录页 */
+    onAuthExpired(): void;
+}
+
+/** 直打 console，适用本地/CLI/MCP 场景 */
+declare class ConsoleLogger implements ILogger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+/** 空实现，测试或静默场景 */
+declare class NoopLogger implements ILogger {
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+}
+
+/**
+ * Node JSON 文件存储。
+ *
+ * 对齐原 hchuanz-pocket-helper 的 `mirrorStore` / `flipCache` 等 fs 读写习惯：
+ * JSON 缩进 2 空格、不存在返回 null、读取失败返回 null。
+ */
+declare class NodeJsonFileStorage implements IStorage {
+    readonly root: string;
+    constructor(root: string);
+    private resolve;
+    readJson<T = unknown>(subpath: string): T | null;
+    writeJson(subpath: string, data: unknown): void;
+    exists(subpath: string): boolean;
+    delete(subpath: string): void;
+    list(dirSubpath: string): string[];
+    mkdir(dirSubpath: string): void;
+}
+
+/**
+ * 明文安全存储（dev/test 参考实现）。
+ *
+ * ⚠ 仅 base64 编码，**不是真加密**，禁止用于生产环境敏感数据。
+ * 生产用 Electron 的 safeStorage 实现（留在原仓库）。
+ */
+declare class PlainTextSecureStorage implements ISecureStorage {
+    isAvailable(): boolean;
+    encryptString(plain: string): string;
+    decryptString(encoded: string): string;
+}
+
+/**
+ * Node JSON KV 配置存储。
+ *
+ * 对齐原 hchuanz-pocket-helper 的 `storeService`：持久化到单个 `app-store.json`，
+ * get 不存在返回 undefined。
+ */
+declare class NodeJsonConfigStore implements IConfigStore {
+    private readonly filePath;
+    private data;
+    private loaded;
+    constructor(root: string, filename?: string);
+    private ensureLoaded;
+    private save;
+    get<T = unknown>(key: string): T | undefined;
+    set(key: string, value: unknown): void;
+    remove(key: string): void;
+    has(key: string): boolean;
+    clear(): void;
+}
+
+/** 纯内存 KV 存储，给 MCP 无磁盘场景 / 测试 */
+declare class MemoryConfigStore implements IConfigStore {
+    private data;
+    get<T = unknown>(key: string): T | undefined;
+    set(key: string, value: unknown): void;
+    remove(key: string): void;
+    has(key: string): boolean;
+    clear(): void;
+}
+
+/** 兼容旧存储的读取器（allUserData/groupedDataById/dashboardInfo 迁移），可空 */
+type LegacyFlipReader = () => {
+    allUserData?: Record<string, unknown[]>;
+    groupedDataById?: Record<string, unknown>;
+    dashboardInfo?: FlipUserCache['dashboardInfo'];
+} | null;
+/**
+ * Node JSON 翻牌数据源。
+ *
+ * 对齐原 hchuanz-pocket-helper 的 `flipCacheService`：
+ * `flip-cache/{userId}.json`，构造可注入 legacy 读取器做旧数据迁移。
+ */
+declare class NodeJsonFlipDataSource implements IFlipDataSource {
+    private readonly storage;
+    private readonly readLegacy?;
+    constructor(storage: IStorage, readLegacy?: LegacyFlipReader);
+    private filePath;
+    get(userId: string): FlipUserCache | null;
+    set(cache: FlipUserCache): void;
+    clear(userId: string): void;
+    private migrateFromLegacy;
+}
+
+/** 纯内存翻牌数据源，给 MCP 无磁盘场景 / 测试 */
+declare class MemoryFlipDataSource implements IFlipDataSource {
+    private data;
+    get(userId: string): FlipUserCache | null;
+    set(cache: FlipUserCache): void;
+    clear(userId: string): void;
+}
+
+/**
+ * OpenAI 兼容 LLM 客户端。
+ *
+ * 对齐原 hchuanz-pocket-helper 的 `common/providers.ts`：
+ * chatCompletion / chatCompletionStream / embed / testConnection，
+ * 全部走原生 fetch，零依赖。
+ */
+declare class OpenAICompatibleClient implements ILlmClient {
+    private readonly logger;
+    constructor(logger: ILogger);
+    chatCompletion(config: ModelConfig, messages: ChatMessage[], tools?: ToolDefinition[], options?: ChatCompletionOptions): Promise<ChatCompletionResult>;
+    chatCompletionStream(config: ModelConfig, messages: ChatMessage[], onChunk: (chunk: ChatCompletionChunk) => void, tools?: ToolDefinition[], options?: ChatCompletionOptions): Promise<ChatMessage['tool_calls']>;
+    embed(config: ModelConfig, texts: string[], model?: string): Promise<number[][]>;
+    testConnection(config: ModelConfig): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+
+/**
+ * 回调流输出。
+ *
+ * 把 `IChatStreamSink` 桥接到回调函数，供测试或直接消费（非 IPC）。
+ */
+declare class CallbackStreamSink implements IChatStreamSink {
+    private readonly onChunkCb;
+    constructor(cb: (content: string, isDone: boolean, newSessionId?: string) => void);
+    onChunk(content: string, isDone: boolean, newSessionId?: string): void;
+}
+/**
+ * 事件推送空实现（MCP/测试场景无 UI 渲染进程）。
+ */
+declare class NoopEventSink implements IEventSink {
+    emit(): void;
+}
+
+/**
+ * Runtime tool descriptor with handler
+ */
+interface RegisteredTool extends ToolDefinition {
+    category: 'platform' | 'mirror' | 'user' | 'pocket';
+    handler: (args: Record<string, unknown>, context: ToolContext) => Promise<unknown>;
+}
+interface ToolContext {
+    userId: string;
+    signal?: AbortSignal;
+}
+/**
+ * 工具注册中心。
+ *
+ * 负责注册、查询、执行 Agent 工具。通过依赖注入接收 ILogger，
+ * 替代原 hchuanz-pocket-helper 中直接 import ee-core/log 的实现。
+ */
+declare class ToolRegistry {
+    private logger;
+    private tools;
+    constructor(logger: ILogger);
+    /**
+     * Register a tool (platform / agent / user MCP)
+     */
+    register(tool: RegisteredTool): void;
+    /**
+     * Bulk register tools from an array
+     */
+    registerAll(tools: RegisteredTool[]): void;
+    /**
+     * Unregister a tool by name
+     */
+    unregister(name: string): void;
+    /**
+     * Unregister all tools with a given prefix (e.g. MCP server name)
+     */
+    unregisterByPrefix(prefix: string): void;
+    /**
+     * Get a single tool by name
+     */
+    get(name: string): RegisteredTool | undefined;
+    /**
+     * Get all tools in OpenAI function-calling format
+     */
+    getOpenAIFormat(): ToolDefinition[];
+    /**
+     * Get tools filtered by category
+     */
+    getByCategory(category: RegisteredTool['category']): ToolDefinition[];
+    /**
+     * Execute a tool by name
+     */
+    execute(name: string, args: Record<string, unknown>, context: ToolContext): Promise<unknown>;
+    /**
+     * List all registered tool names
+     */
+    listNames(): string[];
+    /**
+     * Clear all tools
+     */
+    clear(): void;
+}
+
+/**
+ * 镜像档案与聊天会话持久化存储。
+ *
+ * 通过 IStorage 抽象底层文件系统，替代原 hchuanz-pocket-helper 中
+ * `app.getPath('userData')` + `fs` 的直接调用。
+ */
+declare class MirrorStore {
+    private storage;
+    private logger;
+    constructor(storage: IStorage, logger: ILogger);
+    getProfile(xoxId: number, userId: string): MirrorProfile | null;
+    saveProfile(profile: MirrorProfile, userId: string): void;
+    deleteProfile(xoxId: number, userId: string): void;
+    listProfiles(userId: string): MirrorProfile[];
+    getSession(sessionId: string, userId: string): ChatSession | null;
+    saveSession(session: ChatSession, userId: string): void;
+    /**
+     * Find the most recently active chat session for an idol
+     */
+    getLatestSessionForXox(xoxId: number, userId: string): ChatSession | null;
+    deleteSession(sessionId: string, userId: string): void;
+    /**
+     * Delete all chat sessions for an idol (keeps profile)
+     */
+    deleteSessionsForXox(xoxId: number, userId: string): void;
+}
+
+interface FlipRecordVector {
+    answerId: string;
+    content: string;
+    answerContent: string;
+    qtime: number;
+    hash: string;
+    vector: number[];
+}
+interface SearchHit {
+    record: FlipRecordVector;
+    score: number;
+}
+interface IndexFile {
+    xoxId: number;
+    model: string;
+    updatedAt: number;
+    vectors: FlipRecordVector[];
+}
+/**
+ * 向量索引服务。
+ *
+ * 通过 ILlmClient 调用 embedding API 构建/搜索翻牌记录的语义向量索引，
+ * 支持 cosine + MMR 的 top-K 检索。
+ * 底层持久化通过 IStorage，替代原 hchuanz-pocket-helper 中 `fs` + `app.getPath`。
+ */
+declare class MirrorIndex {
+    private storage;
+    private logger;
+    private llmClient;
+    constructor(storage: IStorage, logger: ILogger, llmClient: ILlmClient);
+    /**
+     * Load index from disk (returns null if not exists)
+     */
+    load(xoxId: number): IndexFile | null;
+    /**
+     * Build / incrementally update the vector index for an idol's flip records.
+     * Records with unchanged hash reuse existing embeddings.
+     */
+    buildIndex(xoxId: number, config: ModelConfig, records: Array<{
+        answerId?: string;
+        content?: string;
+        answerContent?: string;
+        qtime?: number | string;
+    }>): Promise<{
+        indexed: number;
+        reused: number;
+    }>;
+    /**
+     * Delete index for an idol
+     */
+    deleteIndex(xoxId: number): void;
+    /**
+     * Search with cosine top-K + MMR dedup
+     */
+    search(xoxId: number, config: ModelConfig, query: string, topK?: number): Promise<SearchHit[]>;
+    /**
+     * Get index stats
+     */
+    getStats(xoxId: number): {
+        total: number;
+        updatedAt: number;
+    } | null;
+}
+
+interface EpisodicEntry {
+    id: string;
+    topic: string;
+    summary: string;
+    turns: number;
+    createdAt: number;
+}
+interface MemoryFile {
+    xoxId: number;
+    totalTurns: number;
+    episodes: EpisodicEntry[];
+    updatedAt: number;
+}
+/**
+ * 情节记忆服务。
+ *
+ * 记录对话轮次，定期调用 LLM 将对话压缩为情节记忆条目，提供检索和清理。
+ * 底层持久化通过 IStorage，LLM 调用通过 ILlmClient。
+ */
+declare class MirrorMemory {
+    private storage;
+    private logger;
+    private llmClient;
+    constructor(storage: IStorage, logger: ILogger, llmClient: ILlmClient);
+    private ensureDir;
+    /**
+     * Load memory file
+     */
+    load(xoxId: number): MemoryFile;
+    private save;
+    /**
+     * Increment turn counter (called after each chat round)
+     */
+    addTurn(xoxId: number): number;
+    getTotalTurns(xoxId: number): number;
+    /**
+     * Summarize a batch of conversation messages into an episodic memory entry.
+     * Uses LLM to extract topic + summary.
+     */
+    recordEpisode(xoxId: number, config: ModelConfig, messages: Array<{
+        role: string;
+        content: string;
+    }>): Promise<EpisodicEntry | null>;
+    /**
+     * Get recent episodes for prompt injection
+     */
+    getRecentEpisodes(xoxId: number, count?: number): EpisodicEntry[];
+    /**
+     * Search episodes by keyword (simple substring match on topic + summary)
+     */
+    searchEpisodes(xoxId: number, keyword: string, count?: number): EpisodicEntry[];
+    /**
+     * Clear all episodic memory (keeps totalTurns for maturity continuity)
+     */
+    clearEpisodes(xoxId: number): void;
+    /**
+     * Delete memory file entirely
+     */
+    deleteMemory(xoxId: number): void;
+    getStats(xoxId: number): {
+        totalTurns: number;
+        episodeCount: number;
+        updatedAt: number;
+    };
+}
+
+interface GroupChatMember {
+    xoxId: number;
+    nickname: string;
+}
+interface GroupChatMessage {
+    msgId: string;
+    speakerId: number;
+    speakerName: string;
+    content: string;
+    timestamp: number;
+}
+interface GroupChatSession {
+    sessionId: string;
+    name: string;
+    members: GroupChatMember[];
+    topic: string | null;
+    mode: 'observer' | 'participant';
+    messages: GroupChatMessage[];
+    createdAt: number;
+    lastActiveAt: number;
+}
+/**
+ * 群聊会话持久化存储。
+ *
+ * 通过 IStorage 抽象底层文件系统，替代原 hchuanz-pocket-helper 中
+ * `app.getPath('userData')` + `fs` 的直接调用。
+ */
+declare class GroupChatStore {
+    private storage;
+    private logger;
+    constructor(storage: IStorage, logger: ILogger);
+    private ensureDir;
+    saveSession(session: GroupChatSession): void;
+    getSession(sessionId: string): GroupChatSession | null;
+    listSessions(): GroupChatSession[];
+    deleteSession(sessionId: string): void;
+    /**
+     * Append a message to a session (read → push → write back)
+     */
+    appendMessage(sessionId: string, msg: GroupChatMessage): void;
+}
+
+/**
+ * 翻牌数据缓存服务。
+ *
+ * 通过 IStorage + IConfigStore 抽象底层持久化，替代原 hchuanz-pocket-helper 中
+ * `app.getPath('userData')` + `fs` + `storeService` 的直接调用。
+ */
+declare class FlipCacheService {
+    private storage;
+    private logger;
+    private configStore;
+    constructor(storage: IStorage, logger: ILogger, configStore: IConfigStore);
+    /** 计算仪表盘数据（纯逻辑） */
+    static calcDashboard(records: Array<{
+        status?: number;
+        cost?: number;
+    }>): DashboardInfo;
+    /** 按偶像分组（纯逻辑） */
+    static groupDataById(records: Array<{
+        answerId?: string;
+        cost?: number;
+        answerType?: number;
+        answerTime?: string;
+        qtime?: string;
+        type?: number;
+        baseUserInfo?: {
+            userId?: number;
+            nickname?: string;
+        };
+    }>): Record<string, FlipCardGroup>;
+    private writeCache;
+    /** 从旧版 storeService 迁移数据 */
+    private migrateFromLegacy;
+    get(userId: string): FlipUserCache | null;
+    set(cache: FlipUserCache): void;
+    clear(userId: string): void;
+}
+
+/** Thrown when Pocket API returns 401004 (auth expired) */
+declare class PocketAuthExpiredError extends Error {
+    constructor();
+}
+/**
+ * Pocket48 API HTTP 客户端。
+ *
+ * 负责签名头构造、请求发送、auth 过期检测。
+ * 通过 IAuthExpiredHandler 回调通知宿主（替代原 ant-design-vue message/router 依赖）。
+ */
+declare class PocketClient {
+    private baseUrl;
+    private appInfo;
+    private pa;
+    private authExpiredHandler?;
+    private lastAuthWarnAt;
+    private lastKickAt;
+    constructor(baseUrl: string, appInfo: string, pa: string, authExpiredHandler?: IAuthExpiredHandler | undefined);
+    /** 登录态过期的单一出口：防抖调用 authExpiredHandler + 抛错 */
+    kickToLogin(): void;
+    /** 检查响应是否 auth 过期 */
+    checkAuthExpired(res: PocketApiResponse): void;
+    private buildSignedHeaders;
+    private buildPlainHeaders;
+    request<T = unknown>(path: string, data: unknown, token?: string, signed?: boolean): Promise<PocketApiResponse<T>>;
+    /** 登录前接口调用（不签名，不检测 auth 过期） */
+    requestBeforeLogin<T = unknown>(path: string, data: unknown): Promise<PocketApiResponse<T>>;
+}
+
+/**
+ * Build a digital mirror by analyzing flip records with LLM
+ */
+interface RoomMessageEntry {
+    msgId: string;
+    msgTime: number;
+    text: string;
+}
+declare function buildMirror(xoxId: number, userId: string, config: ModelConfig, params: {
+    logger: ILogger;
+    llmClient: ILlmClient;
+    flipDataSource: IFlipDataSource;
+    mirrorStore: MirrorStore;
+    mirrorIndex: MirrorIndex;
+    xoxNickname?: string;
+    startTimeMs?: number;
+    endTimeMs?: number;
+    deepAnalysis?: boolean;
+    roomMessages?: RoomMessageEntry[];
+}): Promise<{
+    ok: boolean;
+    message: string;
+    profile?: MirrorProfile;
+}>;
+
+/**
+ * Chat with a digital mirror using streaming + RAG + episodic memory.
+ *
+ * 重构要点：
+ * - ModelConfig 由调用方传入，不再从 storeService + safeStorage 读取
+ * - 所有依赖通过参数注入
+ */
+declare function chat(xoxId: number, userId: string, message: string, sessionId: string | null, config: ModelConfig, params: {
+    logger: ILogger;
+    llmClient: ILlmClient;
+    mirrorStore: MirrorStore;
+    mirrorIndex: MirrorIndex;
+    mirrorMemory: MirrorMemory;
+}, onChunk: (content: string, isDone: boolean, newSessionId: string) => void, modelOverride?: string): Promise<void>;
+/**
+ * Save assistant message to session (called after streaming is complete)
+ */
+declare function saveAssistantMessage(sessionId: string, userId: string, content: string, mirrorStore: MirrorStore): void;
+/**
+ * Clear chat memory for a session
+ */
+declare function clearChatMemory(sessionId: string, userId: string, mirrorStore: MirrorStore): void;
+
+type GrowthPhase = 'chatting' | 'reflecting' | 'updating';
+interface GrowthResult {
+    ok: boolean;
+    message: string;
+    updated: boolean;
+    changes?: string[];
+    newPersona?: MirrorPersona;
+}
+/**
+ * Check whether auto-growth should be triggered for this mirror
+ */
+declare function shouldTriggerGrowth(xoxId: number, userId: string, mirrorStore: MirrorStore, mirrorMemory: MirrorMemory): boolean;
+/**
+ * Run the growth state machine:
+ *   chatting → reflecting (LLM review) → updating (merge persona) → chatting
+ */
+declare function triggerGrowth(xoxId: number, userId: string, config: ModelConfig, params: {
+    logger: ILogger;
+    llmClient: ILlmClient;
+    mirrorStore: MirrorStore;
+    mirrorMemory: MirrorMemory;
+}, force?: boolean): Promise<GrowthResult>;
+/**
+ * Rollback to previous persona
+ */
+declare function rollbackPersona(xoxId: number, userId: string, mirrorStore: MirrorStore): {
+    ok: boolean;
+    message: string;
+};
+/**
+ * Clear all memory of a mirror: episodic memory + chat sessions (keeps persona)
+ */
+declare function clearMirrorMemory(xoxId: number, userId: string, mirrorStore: MirrorStore, mirrorMemory: MirrorMemory): {
+    ok: boolean;
+    message: string;
+};
+
+/**
+ * Digital mirror configuration — dual-mode presets
+ *
+ * Model assignment:
+ *   Mirror generation → DeepSeek-V4-Pro (1M context, 1.6T/49B MoE)
+ *   Chat             → Qwen3.6-35B-A3B   (262K context, MoE)
+ *
+ * Token estimation (per flip record):
+ *   Fan ≤200 chars + Idol ≤500 chars = ≤700 chars ≈ 350 tokens
+ *
+ * All limits are tunable here.  To adjust, edit the numbers below
+ * and restart; no code changes needed.
+ */
+/**
+ * Context budget reference:
+ *   Economy:   ~280K tokens (800×350) — 28% of V4-Pro 1M window
+ *   Performance: ~700K tokens (2000×350) — 70% of V4-Pro 1M window
+ */
+declare const MIRROR_PRESETS: Record<MirrorMode, MirrorConfig>;
+/** Resolve effective config for a given mode, with optional user overrides */
+declare function getMirrorConfig(mode?: MirrorMode, overrides?: {
+    analysisTemperature?: number;
+    chatTemperature?: number;
+}): MirrorConfig;
+
+/**
+ * Platform-level built-in tools available to all agents.
+ *
+ * 重构要点：
+ * - `flipCacheService` → 参数注入 `IFlipDataSource`
+ * - `fs.readFileSync` → Node 内置 `fs`（平台工具 readFile 设计如此）
+ */
+declare function createPlatformTools(flipDataSource: IFlipDataSource): RegisteredTool[];
+
+/**
+ * Mirror-specific tools available to the mirror agent.
+ *
+ * 重构要点：
+ * - `mirrorStore` 模块单例 → 参数注入 MirrorStore 实例
+ */
+declare function createMirrorTools(mirrorStore: MirrorStore): RegisteredTool[];
+
+/**
+ * Pocket48 在线 API 工具集。
+ *
+ * 包装 pocket-core 的 Pocket48 API 模块为 MCP 工具，支持：
+ * - 短信验证码 + Token 双路径登录
+ * - 用户信息查询
+ * - 成员/队伍查询与搜索
+ * - 房间消息查询
+ * - 翻牌数据同步、搜索、发送、历史
+ */
+declare function createPocketTools(params: {
+    pocketClient: PocketClient;
+    configStore: IConfigStore;
+    flipDataSource: IFlipDataSource;
+    logger: ILogger;
+}): RegisteredTool[];
+
+declare function sendVerificationCode(client: PocketClient, phone: string): Promise<void>;
+declare function loginWithCode(client: PocketClient, phone: string, code: string): Promise<Record<string, unknown>>;
+/** 未读消息数。GET body 传空对象。返回 content: { notice, user, atme, comment } */
+declare function getUnreadMessageNum(client: PocketClient, token: string): Promise<PocketApiResponse<{
+    notice: number;
+    user: number;
+    atme: number;
+    comment: number;
+}>>;
+declare function loginWithToken(client: PocketClient, token: string): Promise<{
+    [x: string]: unknown;
+} | null>;
+declare function normalizePocketUser(raw: Record<string, unknown>, token: string, phone?: string): PocketUser;
+
+declare const pocketUser_getUnreadMessageNum: typeof getUnreadMessageNum;
+declare const pocketUser_loginWithCode: typeof loginWithCode;
+declare const pocketUser_loginWithToken: typeof loginWithToken;
+declare const pocketUser_normalizePocketUser: typeof normalizePocketUser;
+declare const pocketUser_sendVerificationCode: typeof sendVerificationCode;
+declare namespace pocketUser {
+  export { pocketUser_getUnreadMessageNum as getUnreadMessageNum, pocketUser_loginWithCode as loginWithCode, pocketUser_loginWithToken as loginWithToken, pocketUser_normalizePocketUser as normalizePocketUser, pocketUser_sendVerificationCode as sendVerificationCode };
+}
+
+declare function syncFlips(client: PocketClient, token: string, userId: string, flipDataSource: IFlipDataSource, logger: ILogger, mode?: FlipSyncMode, onProgress?: (count: number) => void): Promise<{
+    allUserData: FlipRecord[];
+    dashboardInfo: DashboardInfo | null;
+}>;
+declare function getAllFlips(client: PocketClient, token: string, userId: string, flipDataSource: IFlipDataSource, logger: ILogger): Promise<{
+    allUserData: FlipRecord[];
+    dashboardInfo: DashboardInfo | null;
+}>;
+declare function getDataSourcePage(searchParams: FlipSearchParams, flipDataSource: IFlipDataSource, userId: string): Promise<{
+    data: FlipRecord[];
+    total: number;
+}>;
+declare function sendFlip(client: PocketClient, params: FlipSendParams, token: string): Promise<boolean>;
+interface FlipHistoryPage {
+    records: FlipRecord[];
+    hasMore: boolean;
+}
+/**
+ * 查询指定成员的翻牌历史（对话样式展示用）。
+ * 分页：beginLimit 从 10 起，每次 +limit；content 可能是数组或含 flipCompleteList/answerList/list 的对象。
+ */
+declare function getMemberFlipHistory(client: PocketClient, token: string, memberId: string | number, beginLimit?: number, limit?: number): Promise<FlipHistoryPage>;
+
+type pocketFlip_FlipHistoryPage = FlipHistoryPage;
+declare const pocketFlip_getAllFlips: typeof getAllFlips;
+declare const pocketFlip_getDataSourcePage: typeof getDataSourcePage;
+declare const pocketFlip_getMemberFlipHistory: typeof getMemberFlipHistory;
+declare const pocketFlip_sendFlip: typeof sendFlip;
+declare const pocketFlip_syncFlips: typeof syncFlips;
+declare namespace pocketFlip {
+  export { type pocketFlip_FlipHistoryPage as FlipHistoryPage, pocketFlip_getAllFlips as getAllFlips, pocketFlip_getDataSourcePage as getDataSourcePage, pocketFlip_getMemberFlipHistory as getMemberFlipHistory, pocketFlip_sendFlip as sendFlip, pocketFlip_syncFlips as syncFlips };
+}
+
+/**
+ * 获取网易云信 IM 登录凭证（accid/pwd），用于登 NIM 长连接（房间消息实时推送）。
+ *
+ * 来源：POST /im/api/v1/im/userinfo（无 body），服务端按 token 下发。
+ * 完整 URL = https://pocketapi.48.cn/im/api/v1/im/userinfo。
+ *
+ * 注意：accid/pwd ≠ HTTP token。前者是网易云信 IM 的账号/密码，后者是 Pocket48 业务 token。
+ */
+declare function getImUserInfo(client: PocketClient, token: string): Promise<ImUserInfo | null>;
+
+declare const pocketIm_getImUserInfo: typeof getImUserInfo;
+declare namespace pocketIm {
+  export { pocketIm_getImUserInfo as getImUserInfo };
+}
+
+declare function getTeamListInfo(client: PocketClient, token: string): Promise<{
+    serverTabList: Array<{
+        tabId: number;
+        tabName: string;
+    }>;
+} | undefined>;
+declare function getMemberListByTab(client: PocketClient, token: string, tabId: number): Promise<{
+    serverApiList: Array<Record<string, unknown>>;
+} | undefined>;
+declare function fetchMemberList(client: PocketClient, token: string): Promise<MemberInfo[]>;
+declare function getMemberFlipPriceInfo(client: PocketClient, token: string, memberId: string): Promise<MemberFlipInfo>;
+
+declare const pocketMember_fetchMemberList: typeof fetchMemberList;
+declare const pocketMember_getMemberFlipPriceInfo: typeof getMemberFlipPriceInfo;
+declare const pocketMember_getMemberListByTab: typeof getMemberListByTab;
+declare const pocketMember_getTeamListInfo: typeof getTeamListInfo;
+declare namespace pocketMember {
+  export { pocketMember_fetchMemberList as fetchMemberList, pocketMember_getMemberFlipPriceInfo as getMemberFlipPriceInfo, pocketMember_getMemberListByTab as getMemberListByTab, pocketMember_getTeamListInfo as getTeamListInfo };
+}
+
+/** 通过成员 starId 跳转到主房间，拿到 channelId */
+declare function getRoomChannelByStar(client: PocketClient, token: string, starId: number): Promise<RoomJumpResult>;
+/** 获取房间基础信息 */
+declare function getRoomInfo(client: PocketClient, token: string, channelId: number): Promise<RoomChannelInfo | null>;
+/**
+ * 分页拉取房间消息。
+ * nextTime=0 拉最新一页；之后带上次的 nextTime 拉更早的消息。
+ * 接口返回的消息为倒序（最新在前），此处统一转成正序（最旧在前）。
+ */
+declare function getRoomMessages(client: PocketClient, token: string, serverId: number, channelId: number, nextTime: number): Promise<RoomMessagePage>;
+
+declare const pocketRoom_getRoomChannelByStar: typeof getRoomChannelByStar;
+declare const pocketRoom_getRoomInfo: typeof getRoomInfo;
+declare const pocketRoom_getRoomMessages: typeof getRoomMessages;
+declare namespace pocketRoom {
+  export { pocketRoom_getRoomChannelByStar as getRoomChannelByStar, pocketRoom_getRoomInfo as getRoomInfo, pocketRoom_getRoomMessages as getRoomMessages };
+}
+
+interface AgentLoopOptions {
+    config: ModelConfig;
+    systemPrompt: string;
+    userMessage: string;
+    history?: ChatMessage[];
+    maxIterations?: number;
+    model?: string;
+    onChunk?: (chunk: string) => void;
+    onToolCall?: (name: string, args: Record<string, unknown>) => void;
+    context: ToolContext;
+    llmClient: ILlmClient;
+    toolRegistry: ToolRegistry;
+}
+/**
+ * Non-streaming agent loop: LLM <-> tool calling
+ */
+declare function agentLoop(options: AgentLoopOptions): Promise<string>;
+/**
+ * Streaming agent loop with tool calling
+ */
+declare function agentLoopStream(options: AgentLoopOptions): Promise<void>;
+
+/**
+ * 组合根：core 对运行时依赖的完整声明。
+ *
+ * Electron 侧（hchuanz-pocket-helper）用自己的适配器（ElectronStorage/
+ * ElectronSecureStorage/ElectronIpcStreamSink）组装；MCP/CLI 用 adapters/ 下的
+ * Node 参考实现。core 本身不 import 任何框架。
+ */
+interface CoreDependencies {
+    logger: ILogger;
+    storage: IStorage;
+    secureStorage: ISecureStorage;
+    configStore: IConfigStore;
+    flipDataSource: IFlipDataSource;
+    llmClient: ILlmClient;
+    /** 流式聊天输出；Electron 用 IPC，MCP 用回调 */
+    chatStreamSink?: IChatStreamSink;
+    /** 事件推送；Electron 用 webContents，MCP 用空实现 */
+    eventSink?: IEventSink;
+    /** 认证过期回调 */
+    authExpiredHandler?: IAuthExpiredHandler;
+}
+/**
+ * 面向外部的高层 API。
+ */
+interface PocketCore {
+    deps: CoreDependencies;
+    toolRegistry: ToolRegistry;
+    pocketClient: PocketClient;
+    mirrorStore: MirrorStore;
+    flipCacheService: FlipCacheService;
+    groupChatStore: GroupChatStore;
+    mirrorIndex: MirrorIndex;
+    mirrorMemory: MirrorMemory;
+    buildMirror: typeof buildMirror;
+    /** 镜像聊天 */
+    mirrorChat: typeof chat;
+    /** 保存助手回复到 session */
+    mirrorSaveAssistantMessage: typeof saveAssistantMessage;
+    /** 清除聊天记忆 */
+    mirrorClearChatMemory: typeof clearChatMemory;
+    /** 触发人格成长 */
+    mirrorTriggerGrowth: typeof triggerGrowth;
+    /** 检测是否需要触发成长 */
+    mirrorShouldTriggerGrowth: typeof shouldTriggerGrowth;
+    /** 回退人格 */
+    mirrorRollbackPersona: typeof rollbackPersona;
+    /** 清除镜像记忆 */
+    mirrorClearMemory: typeof clearMirrorMemory;
+    getMirrorConfig: typeof getMirrorConfig;
+    createPlatformTools: () => ReturnType<typeof createPlatformTools>;
+    createMirrorTools: () => ReturnType<typeof createMirrorTools>;
+    createPocketTools: () => ReturnType<typeof createPocketTools>;
+    pocketUser: typeof pocketUser;
+    pocketFlip: typeof pocketFlip;
+    pocketIm: typeof pocketIm;
+    pocketMember: typeof pocketMember;
+    pocketRoom: typeof pocketRoom;
+    agentLoop: typeof agentLoop;
+    agentLoopStream: typeof agentLoopStream;
+}
+/**
+ * 创建 PocketCore 实例，组装所有业务模块。
+ */
+declare function createPocketCore(deps: CoreDependencies): PocketCore;
+
+declare const PRESET_PROVIDERS: Record<string, {
+    label: string;
+    baseUrl: string;
+}>;
+declare const PRESET_MODELS: {
+    chat: {
+        id: string;
+        label: string;
+        desc: string;
+    }[];
+    reasoning: {
+        id: string;
+        label: string;
+        desc: string;
+    }[];
+    embedding: {
+        id: string;
+        label: string;
+        desc: string;
+    }[];
+};
+declare function defaultModelConfig(): ModelConfig;
+
+/**
+ * Build the "inner monologue" prompt for a mirror to evaluate whether it wants to speak.
+ * Uses lightweight model, expects JSON output.
+ */
+declare function buildInnerMonologuePrompt(profile: MirrorProfile, lastMessages: Array<{
+    speakerId: number;
+    speakerName: string;
+    content: string;
+}>, topic: string | null): string;
+/**
+ * Build the speech prompt for a mirror to generate its group chat reply.
+ * Uses full persona + group context.
+ */
+declare function buildSpeakPrompt(profile: MirrorProfile, params: {
+    name: string;
+    topic: string | null;
+    otherMembers: string;
+    lastMessages: Array<{
+        speakerName: string;
+        content: string;
+    }>;
+}): string;
+
+interface SpeakDecision {
+    xoxId: number;
+    shouldSpeak: boolean;
+    urgency: number;
+    trigger: string;
+}
+interface GroupChatMessageEvent {
+    sessionId: string;
+    msgId: string;
+    speakerId: number;
+    speakerName: string;
+    content: string;
+    isDone: boolean;
+    roundDone: boolean;
+}
+interface GroupChatDeps {
+    logger: ILogger;
+    llmClient: ILlmClient;
+    mirrorStore: MirrorStore;
+    groupChatStore: GroupChatStore;
+    config: ModelConfig;
+}
+/**
+ * Run a full round of group chat: evaluate → select → generate → push.
+ *
+ * @param session - The current group chat session (mutated: messages appended)
+ * @param onEvent - Callback to push events to frontend
+ * @returns Array of new messages generated this round
+ */
+declare function runRound(deps: GroupChatDeps, session: GroupChatSession, userId: string, onEvent: (event: GroupChatMessageEvent) => void): Promise<GroupChatMessage[]>;
+
+export { AVA_BASE_URL, type AgentLoopOptions, CallbackStreamSink, type ChatCompletionChunk, type ChatCompletionOptions, type ChatCompletionResult, type ChatMessage, type ChatSession, ConsoleLogger, type CoreDependencies, type DashboardInfo, type EpisodicEntry, type FlipCacheMeta, FlipCacheService, type FlipCardGroup, type FlipHistoryPage, type FlipRecord, type FlipRecordVector, type FlipSearchParams, type FlipSendParams, type FlipSyncMode, type FlipUserCache, type GroupChatDeps, type GroupChatMember, type GroupChatMessage, type GroupChatMessageEvent, type GroupChatSession, GroupChatStore, type GrowthEvent, type GrowthPhase, type GrowthResult, type IAuthExpiredHandler, type IChatStreamSink, type IConfigStore, type IEventSink, type IFlipDataSource, type ILlmClient, type ILogger, type ISecureStorage, type IStorage, type ImUserInfo, type LegacyFlipReader, MIRROR_PRESETS, type MemberFlipCustom, type MemberFlipInfo, type MemberInfo, type MemberSearchParams, MemoryConfigStore, MemoryFlipDataSource, type MirrorConfig, MirrorIndex, MirrorMemory, type MirrorMode, type MirrorPersona, type MirrorProfile, type MirrorRecentActivity, type MirrorRelationship, MirrorStore, type ModelConfig, NodeJsonConfigStore, NodeJsonFileStorage, NodeJsonFlipDataSource, NoopEventSink, NoopLogger, OpenAICompatibleClient, POCKET_API_BASE, POCKET_APP_INFO, POCKET_PA, POCKET_USER_AGENT, PRESET_MODELS, PRESET_PROVIDERS, PlainTextSecureStorage, type PocketApiResponse, PocketAuthExpiredError, PocketClient, type PocketCore, type PocketUser, type RegisteredTool, type RoomChannelInfo, type RoomGiftInfo, type RoomJumpResult, type RoomLiveInfo, type RoomMessage, type RoomMessageEntry, type RoomMessagePage, type RoomMessageSender, type RoomReplyInfo, SESSION_EXPIRE_MS, type SearchHit, type SpeakDecision, type ToolContext, type ToolDefinition, ToolRegistry, agentLoop, agentLoopStream, buildInnerMonologuePrompt, buildMirror, buildSpeakPrompt, chat, clearChatMemory, clearMirrorMemory, createMirrorTools, createPlatformTools, createPocketCore, createPocketTools, defaultModelConfig, fetchMemberList, getAllFlips, getDataSourcePage, getImUserInfo, getMemberFlipHistory, getMemberFlipPriceInfo, getMemberListByTab, getMirrorConfig, getRoomChannelByStar, getRoomInfo, getRoomMessages, getTeamListInfo, getUnreadMessageNum, loginWithCode, loginWithToken, normalizePersona, normalizePocketUser, rollbackPersona, runRound, saveAssistantMessage, sendFlip, sendVerificationCode, shouldTriggerGrowth, syncFlips, triggerGrowth };