@alemonjs/qq-bot 2.1.33 → 2.1.34

package/lib/sdk/message.public.d.ts

@@ -1,6 +1,9 @@
-import { ERROR_TYPE } from '../message/ERROR';
-import { INTERACTION_CREATE_TYPE } from '../message/INTERACTION_CREATE';
-export type QQBotPublicEventMap = {
-    INTERACTION_CREATE: INTERACTION_CREATE_TYPE;
-    ERROR: ERROR_TYPE;
+import { INTERACTION_CREATE_TYPE } from "../message/INTERACTION_CREATE.js";
+import { ERROR_TYPE } from "../message/ERROR.js";
+//#region src/sdk/message.public.d.ts
+type QQBotPublicEventMap = {
+  INTERACTION_CREATE: INTERACTION_CREATE_TYPE;
+  ERROR: ERROR_TYPE;
 };
+//#endregion
+export { QQBotPublicEventMap };

package/lib/sdk/message.public.js

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

package/lib/sdk/qr-auth.d.ts

@@ -0,0 +1,55 @@
+//#region src/sdk/qr-auth.d.ts
+/** 绑定任务状态码（与平台返回一致） */
+declare const BindStatus: {
+  readonly NONE: 0;
+  readonly PENDING: 1;
+  readonly COMPLETED: 2;
+  readonly EXPIRED: 3;
+};
+type PortalResponse = {
+  retcode: number;
+  msg?: string;
+  data?: Record<string, any>;
+};
+/** 门户请求函数；可注入替换用于测试 */
+type PortalRequest = (path: string, body: Record<string, any>) => Promise<PortalResponse>;
+/**
+ * 解密平台下发的机器人密钥：AES-256-GCM，密文结构为 Base64(IV(12字节) + 密文 + AuthTag(16字节))，
+ * 密钥为创建绑定任务时本地生成并提交的 key
+ */
+declare const decryptSecret: (encryptedBase64: string, keyBase64: string) => string;
+/** 构造扫码授权页链接（手机 QQ 扫码后打开） */
+declare const buildConnectUrl: (taskId: string) => string;
+type QRLoginResult = {
+  loginId: string;
+  appId: string;
+  clientSecret: string;
+  userOpenid: string;
+};
+type QRLoginOptions = {
+  /** 整个扫码流程的总超时（秒） */
+  timeoutSeconds?: number;
+  /** 二维码过期后的最大刷新次数 */
+  maxRefreshes?: number;
+  /** 轮询间隔（毫秒） */
+  pollInterval?: number;
+  /** 注入门户请求（测试用） */
+  request?: PortalRequest;
+  /** 二维码生成回调（默认同时终端出码并保存图片到运行目录） */
+  onQRCode?: (qrBuffer: Buffer, url: string, qrImagePath: string | undefined, loginId: string, refresh: number) => void | Promise<void>;
+  /** 状态变化回调 */
+  onStatus?: (message: string) => void | Promise<void>;
+};
+/**
+ * 扫码登录流程：
+ * 创建绑定任务 → 终端出码并保存二维码图片到运行目录 → 轮询授权结果 → 解密 AppSecret。
+ * 成功返回 { appId, clientSecret, userOpenid }；超时/失败/刷新次数用尽返回 null
+ */
+declare const qrLogin: (options?: QRLoginOptions) => Promise<QRLoginResult | null>;
+/**
+ * 将扫码得到的 app_id/secret 写入 alemon 配置文件。
+ * 使用 YAML.parseDocument 在文档节点上仅更新目标键值，文件中已有的注释与原有格式保持不变
+ */
+declare const saveBotCredentials: (appId: string, secret: string) => boolean;
+//#endregion
+export { BindStatus, PortalRequest, PortalResponse, QRLoginOptions, QRLoginResult, buildConnectUrl, decryptSecret, qrLogin, saveBotCredentials };

package/lib/sdk/qr-auth.js

@@ -0,0 +1,169 @@
+import { getConfig, logger } from "alemonjs";
+import axios from "axios";
+import { createDecipheriv, randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import QRCode from "qrcode";
+import YAML from "yaml";
+
+//#region src/sdk/qr-auth.ts
+/** QQ 门户扫码绑定接口（社区通用入口，官方未公开文档，改版可能失效） */
+const PORTAL_HOST = process.env.QQ_PORTAL_HOST || "q.qq.com";
+const CONNECT_URL_TEMPLATE = "https://q.qq.com/qqbot/openclaw/connect.html?task_id={task_id}&_wv=2&source=alemonjs";
+const REQUEST_TIMEOUT = 1e4;
+const PORTAL_USER_AGENT = "QQBotAdapter/alemonjs (Node.js)";
+/** 绑定任务状态码（与平台返回一致） */
+const BindStatus = {
+	NONE: 0,
+	PENDING: 1,
+	COMPLETED: 2,
+	EXPIRED: 3
+};
+const defaultPortalRequest = async (path, body) => {
+	return (await axios.post(`https://${PORTAL_HOST}${path}`, body, {
+		timeout: REQUEST_TIMEOUT,
+		headers: {
+			"Content-Type": "application/json",
+			Accept: "application/json",
+			"User-Agent": PORTAL_USER_AGENT
+		}
+	})).data;
+};
+/**
+* 解密平台下发的机器人密钥：AES-256-GCM，密文结构为 Base64(IV(12字节) + 密文 + AuthTag(16字节))，
+* 密钥为创建绑定任务时本地生成并提交的 key
+*/
+const decryptSecret = (encryptedBase64, keyBase64) => {
+	const key = Buffer.from(keyBase64, "base64");
+	const raw = Buffer.from(encryptedBase64, "base64");
+	const iv = raw.subarray(0, 12);
+	const ciphertext = raw.subarray(12);
+	const authTag = ciphertext.subarray(ciphertext.length - 16);
+	const encryptedData = ciphertext.subarray(0, ciphertext.length - 16);
+	const decipher = createDecipheriv("aes-256-gcm", key, iv);
+	decipher.setAuthTag(authTag);
+	return Buffer.concat([decipher.update(encryptedData), decipher.final()]).toString("utf-8");
+};
+/** 构造扫码授权页链接（手机 QQ 扫码后打开） */
+const buildConnectUrl = (taskId) => {
+	return CONNECT_URL_TEMPLATE.replace("{task_id}", encodeURIComponent(taskId));
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+* 扫码登录流程：
+* 创建绑定任务 → 终端出码并保存二维码图片到运行目录 → 轮询授权结果 → 解密 AppSecret。
+* 成功返回 { appId, clientSecret, userOpenid }；超时/失败/刷新次数用尽返回 null
+*/
+const qrLogin = async (options = {}) => {
+	const { timeoutSeconds = 600, maxRefreshes = 3, pollInterval = 2e3, request = defaultPortalRequest, onQRCode, onStatus } = options;
+	const deadline = Date.now() + timeoutSeconds * 1e3;
+	for (let refresh = 0; refresh <= maxRefreshes; refresh++) try {
+		const key = randomBytes(32).toString("base64");
+		const created = await request("/lite/create_bind_task", { key });
+		if (created.retcode !== 0) {
+			await onStatus?.(`创建绑定任务失败：${created.msg || `retcode=${created.retcode}`}`);
+			return null;
+		}
+		const taskId = created.data?.task_id;
+		if (!taskId) {
+			await onStatus?.("创建绑定任务失败：响应缺少 task_id");
+			return null;
+		}
+		const url = buildConnectUrl(taskId);
+		let qrImagePath = null;
+		let qrBuffer = null;
+		try {
+			qrBuffer = await QRCode.toBuffer(url, {
+				type: "png",
+				width: 320,
+				margin: 2
+			});
+			qrImagePath = join(process.cwd(), "qqbot-login-qr.png");
+			writeFileSync(qrImagePath, qrBuffer);
+		} catch (err) {
+			logger.warn(`[qq-bot] 二维码图片保存失败：${err?.message ?? err}`);
+		}
+		if (qrBuffer && onQRCode) await onQRCode(qrBuffer, url, qrImagePath ?? void 0, taskId, refresh);
+		await onStatus?.("请使用手机 QQ 扫描二维码并确认授权");
+		logger.warn("[qq-bot] 注意：扫码授权完成后平台将重置机器人密钥，旧密钥会立即失效；若该机器人已在其他实例中运行，请更新其配置");
+		while (Date.now() < deadline) {
+			let polled;
+			try {
+				polled = await request("/lite/poll_bind_result", { task_id: taskId });
+			} catch {
+				await sleep(pollInterval);
+				continue;
+			}
+			if (polled.retcode !== 0) {
+				await onStatus?.(`轮询返回异常：${polled.msg || `retcode=${polled.retcode}`}，继续等待…`);
+				await sleep(pollInterval);
+				continue;
+			}
+			const data = polled.data ?? {};
+			const status = data.status ?? BindStatus.NONE;
+			if (status === BindStatus.COMPLETED) {
+				const clientSecret = decryptSecret(String(data.bot_encrypt_secret ?? ""), key);
+				await onStatus?.("扫码授权成功");
+				logger.info(`[qq-bot] 扫码登录成功：AppID=${data.bot_appid}`);
+				return {
+					loginId: taskId,
+					appId: String(data.bot_appid ?? ""),
+					clientSecret,
+					userOpenid: String(data.user_openid ?? "")
+				};
+			}
+			if (status === BindStatus.EXPIRED) {
+				await onStatus?.(`二维码已过期，正在刷新（${refresh + 1}/${maxRefreshes + 1}）`);
+				break;
+			}
+			await sleep(pollInterval);
+		}
+	} catch (err) {
+		logger.error(`[qq-bot] 扫码登录异常：${err?.message ?? err}`);
+		return null;
+	}
+	await onStatus?.("扫码授权超时");
+	logger.warn("[qq-bot] 扫码登录超时");
+	return null;
+};
+/**
+* 将扫码得到的 app_id/secret 写入 alemon 配置文件。
+* 使用 YAML.parseDocument 在文档节点上仅更新目标键值，文件中已有的注释与原有格式保持不变
+*/
+const saveBotCredentials = (appId, secret) => {
+	try {
+		const config = getConfig();
+		const filePath = config.path;
+		if (!filePath) {
+			logger.warn("[qq-bot] 配置文件路径不可用，无法保存扫码登录凭证");
+			return false;
+		}
+		const raw = existsSync(filePath) ? readFileSync(filePath, "utf-8") : "";
+		const doc = YAML.parseDocument(raw);
+		if (doc.errors.length > 0) {
+			logger.error(`[qq-bot] 配置文件存在 YAML 语法错误，无法安全写入凭证（${filePath}），请先修复语法错误后重试`);
+			return false;
+		}
+		const section = doc.has("@alemonjs/qq-bot") ? "@alemonjs/qq-bot" : "qq-bot";
+		const existing = doc.get(section, true);
+		if (existing === void 0 || !YAML.isMap(existing)) doc.set(section, {
+			app_id: appId,
+			secret
+		});
+		else {
+			doc.setIn([section, "app_id"], appId);
+			doc.setIn([section, "secret"], secret);
+		}
+		const dirPath = dirname(filePath);
+		if (!existsSync(dirPath)) mkdirSync(dirPath, { recursive: true });
+		writeFileSync(filePath, doc.toString(), "utf-8");
+		config.reload();
+		return true;
+	} catch (err) {
+		logger.error(`[qq-bot] 保存扫码登录凭证失败：${err?.message ?? err}`);
+		return false;
+	}
+};
+
+//#endregion
+export { BindStatus, buildConnectUrl, decryptSecret, qrLogin, saveBotCredentials };

package/lib/sdk/registry.d.ts

@@ -1,25 +1,35 @@
-import { cbpPlatform } from 'alemonjs';
-import { QQBotClients } from './client.websoket.js';
-import type { Options } from './typing.js';
-export declare class QQBotRegistry {
-    #private;
-    constructor(defaultBot?: string, cbp?: ReturnType<typeof cbpPlatform>);
-    add(botId: string, options: Options): QQBotClients;
-    get(botId?: string): QQBotClients;
-    getConnectionStatus(botId?: string): {
-        Platform: string;
-        state: import("./api.js").QQBotConnectionState;
-        bots: {
-            state: import("./api.js").QQBotConnectionState;
-            transport: "websocket" | "webhook" | "proxy" | null;
-            reconnectAttempts: number;
-            heartbeatAcknowledged: boolean;
-            sessionId?: string;
-            sequence?: number;
-            resumed: boolean;
-            lastError?: string;
-            BotId: string;
-        }[];
-    };
-    disconnect(): void;
+import { Options } from "./typing.js";
+import { QQBotConnectionState } from "./api.js";
+import { QQBotClients } from "./client.websoket.js";
+import { ConnectionLoginStatus, cbpPlatform } from "alemonjs";
+//#region src/sdk/registry.d.ts
+/**
+ * The only CBP dispatcher for QQ WebSocket mode.  It keeps bot credentials,
+ * message sequence state and action routing isolated while exposing one
+ * platform connection to AlemonJS.
+ */
+declare class QQBotRegistry {
+  #private;
+  constructor(defaultBot?: string, cbp?: ReturnType<typeof cbpPlatform>, getLoginStatus?: () => ConnectionLoginStatus);
+  add(botId: string, options: Options): QQBotClients;
+  get(botId?: string): QQBotClients;
+  getConnectionStatus(botId?: string): {
+    Platform: string;
+    state: QQBotConnectionState;
+    bots: {
+      state: QQBotConnectionState;
+      transport: 'websocket' | 'webhook' | 'proxy' | null;
+      reconnectAttempts: number;
+      heartbeatAcknowledged: boolean;
+      sessionId?: string;
+      sequence?: number;
+      resumed: boolean;
+      lastError?: string;
+      BotId: string;
+    }[];
+    login?: ConnectionLoginStatus;
+  };
+  disconnect(): void;
 }
+//#endregion
+export { QQBotRegistry };

package/lib/sdk/registry.js

@@ -1,116 +1,136 @@
-import { cbpPlatform, createResult, ResultCode } from 'alemonjs';
-import { getQQBotConfig } from '../config.js';
-import { register } from '../register.js';
-import { QQBotClients } from './client.websoket.js';
+import { getQQBotConfig } from "../config.js";
+import { register } from "../register.js";
+import { QQBotClients } from "./client.websoket.js";
+import { ResultCode, cbpPlatform, createResult } from "alemonjs";
 
-class QQBotRegistry {
-    #bots = new Map();
-    #streams = new Map();
-    #defaultBot;
-    #cbp;
-    constructor(defaultBot, cbp) {
-        this.#defaultBot = defaultBot;
-        if (cbp) {
-            this.#cbp = cbp;
-        }
-        else {
-            const config = getQQBotConfig();
-            const port = process.env.port || config.port || 17117;
-            this.#cbp = cbpPlatform(`ws://127.0.0.1:${port}`);
-        }
-        this.#cbp.onactions((data, consume) => void this.#onAction(data, consume));
-        this.#cbp.onapis((data, consume) => void this.#onApi(data, consume));
-    }
-    add(botId, options) {
-        if (!botId)
-            throw new Error('QQ BotId is required');
-        if (this.#bots.has(botId))
-            throw new Error(`Duplicate QQ BotId: ${botId}`);
-        const client = new QQBotClients({ ...options, app_id: botId });
-        client.setStreamLifecycleListener(streamId => this.#streams.delete(streamId));
-        const adapter = register(client, { botId, cbp: this.#cbp, bindActions: false });
-        this.#bots.set(botId, { client, adapter });
-        return client;
-    }
-    get(botId) {
-        return botId ? this.#bots.get(botId)?.client : undefined;
-    }
-    getConnectionStatus(botId) {
-        const bots = [...this.#bots].flatMap(([BotId, entry]) => {
-            if (botId && botId !== BotId)
-                return [];
-            return [{ BotId, ...entry.client.getConnectionStatus() }];
-        });
-        const state = bots.some(item => item.state === 'ready')
-            ? 'ready'
-            : bots.some(item => item.state === 'connecting' || item.state === 'reconnecting')
-                ? 'connecting'
-                : bots[0]?.state || 'idle';
-        return { Platform: 'qq-bot', state, bots };
-    }
-    disconnect() {
-        for (const { client } of this.#bots.values())
-            client.disconnect();
-        this.#streams.clear();
-    }
-    #requestedBotId(data) {
-        const payload = data?.payload || {};
-        return payload.target?.BotId || payload.BotId || payload.event?.BotId || payload.event?.Platform?.BotId;
-    }
-    #select(data) {
-        const requested = this.#requestedBotId(data);
-        if (requested) {
-            const entry = this.#bots.get(String(requested));
-            return entry ? { entry } : { error: `BotId ${requested} is not configured (available: ${[...this.#bots.keys()].join(', ') || 'none'})` };
-        }
-        if (this.#bots.size === 1)
-            return { entry: this.#bots.values().next().value };
-        if (this.#defaultBot)
-            return { entry: this.#bots.get(this.#defaultBot) };
-        return { error: 'BotId is required because multiple QQ bots are active and no default_bot is configured' };
-    }
-    async #onAction(data, consume) {
-        if (data?.action === 'connection.status') {
-            const botId = data?.payload?.BotId;
-            const status = this.getConnectionStatus(botId);
-            if (botId && !status.bots.length) {
-                consume([createResult(ResultCode.FailParams, `BotId ${botId} is not configured`, null)]);
-            }
-            else {
-                consume([createResult(ResultCode.Ok, data.action, status)]);
-            }
-            return;
-        }
-        const { entry, error } = this.#select(data);
-        if (!entry) {
-            consume([createResult(ResultCode.FailParams, error || 'QQ Bot is unavailable', null)]);
-            return;
-        }
-        await entry.adapter.onAction(data, consume);
-    }
-    async #onApi(data, consume) {
-        const params = data?.payload?.params;
-        const key = String(data?.payload?.key || '');
-        const method = key.split('.').at(-1);
-        const streamId = method === 'streamUpdate' || method === 'streamComplete' || method === 'streamCancel' ? params?.[0] : undefined;
-        const requested = (Array.isArray(params) ? params[0]?.BotId : undefined) || (streamId ? this.#streams.get(String(streamId)) : undefined);
-        const { entry, error } = this.#select({ payload: { BotId: requested, event: data?.payload?.event } });
-        if (!entry) {
-            consume([createResult(ResultCode.FailParams, error || 'QQ Bot is unavailable', null)]);
-            return;
-        }
-        await entry.adapter.onApi(data, results => {
-            const result = results.find((item) => item.code === ResultCode.Ok)?.data;
-            if (method === 'streamOpen' && result?.streamId)
-                this.#streams.set(String(result.streamId), requested || this.#botIdFor(entry));
-            if (streamId && (method === 'streamComplete' || method === 'streamCancel'))
-                this.#streams.delete(String(streamId));
-            consume(results);
-        });
-    }
-    #botIdFor(entry) {
-        return [...this.#bots.entries()].find(([, value]) => value === entry)?.[0] || '';
-    }
-}
+//#region src/sdk/registry.ts
+/**
+* The only CBP dispatcher for QQ WebSocket mode.  It keeps bot credentials,
+* message sequence state and action routing isolated while exposing one
+* platform connection to AlemonJS.
+*/
+var QQBotRegistry = class {
+	#bots = /* @__PURE__ */ new Map();
+	#streams = /* @__PURE__ */ new Map();
+	#defaultBot;
+	#cbp;
+	#getLoginStatus;
+	constructor(defaultBot, cbp, getLoginStatus) {
+		this.#defaultBot = defaultBot;
+		this.#getLoginStatus = getLoginStatus;
+		if (cbp) this.#cbp = cbp;
+		else {
+			const config = getQQBotConfig();
+			const port = process.env.port || config.port || 17117;
+			this.#cbp = cbpPlatform(`ws://127.0.0.1:${port}`);
+		}
+		this.#cbp.onactions((data, consume) => void this.#onAction(data, consume));
+		this.#cbp.onapis((data, consume) => void this.#onApi(data, consume));
+	}
+	add(botId, options) {
+		if (!botId) throw new Error("QQ BotId is required");
+		if (this.#bots.has(botId)) throw new Error(`Duplicate QQ BotId: ${botId}`);
+		const client = new QQBotClients({
+			...options,
+			app_id: botId
+		});
+		client.setStreamLifecycleListener((streamId) => this.#streams.delete(streamId));
+		client.setConnectionStatusListener((status, previous) => {
+			if (status.state === "ready" && previous.state !== "ready") this.#cbp.send({
+				name: "connection.ready",
+				value: "",
+				Platform: "qq-bot",
+				BotId: botId,
+				transport: status.transport,
+				resumed: status.resumed
+			});
+		});
+		const adapter = register(client, {
+			botId,
+			cbp: this.#cbp,
+			bindActions: false
+		});
+		this.#bots.set(botId, {
+			client,
+			adapter
+		});
+		return client;
+	}
+	get(botId) {
+		return botId ? this.#bots.get(botId)?.client : void 0;
+	}
+	getConnectionStatus(botId) {
+		const bots = [...this.#bots].flatMap(([BotId, entry]) => {
+			if (botId && botId !== BotId) return [];
+			return [{
+				BotId,
+				...entry.client.getConnectionStatus()
+			}];
+		});
+		return {
+			Platform: "qq-bot",
+			state: bots.some((item) => item.state === "ready") ? "ready" : bots.some((item) => item.state === "connecting" || item.state === "reconnecting") ? "connecting" : bots[0]?.state || "idle",
+			bots,
+			...this.#getLoginStatus ? { login: this.#getLoginStatus() } : {}
+		};
+	}
+	disconnect() {
+		for (const { client } of this.#bots.values()) client.disconnect();
+		this.#streams.clear();
+	}
+	#requestedBotId(data) {
+		const payload = data?.payload || {};
+		return payload.target?.BotId || payload.BotId || payload.event?.BotId || payload.event?.Platform?.BotId;
+	}
+	#select(data) {
+		const requested = this.#requestedBotId(data);
+		if (requested) {
+			const entry = this.#bots.get(String(requested));
+			return entry ? { entry } : { error: `BotId ${requested} is not configured (available: ${[...this.#bots.keys()].join(", ") || "none"})` };
+		}
+		if (this.#bots.size === 1) return { entry: this.#bots.values().next().value };
+		if (this.#defaultBot) return { entry: this.#bots.get(this.#defaultBot) };
+		return { error: "BotId is required because multiple QQ bots are active and no default_bot is configured" };
+	}
+	async #onAction(data, consume) {
+		if (data?.action === "connection.status") {
+			const botId = data?.payload?.BotId;
+			const status = this.getConnectionStatus(botId);
+			if (botId && !status.bots.length) consume([createResult(ResultCode.FailParams, `BotId ${botId} is not configured`, null)]);
+			else consume([createResult(ResultCode.Ok, data.action, status)]);
+			return;
+		}
+		const { entry, error } = this.#select(data);
+		if (!entry) {
+			consume([createResult(ResultCode.FailParams, error || "QQ Bot is unavailable", null)]);
+			return;
+		}
+		await entry.adapter.onAction(data, consume);
+	}
+	async #onApi(data, consume) {
+		const params = data?.payload?.params;
+		const method = String(data?.payload?.key || "").split(".").at(-1);
+		const streamId = method === "streamUpdate" || method === "streamComplete" || method === "streamCancel" ? params?.[0] : void 0;
+		const requested = (Array.isArray(params) ? params[0]?.BotId : void 0) || (streamId ? this.#streams.get(String(streamId)) : void 0);
+		const { entry, error } = this.#select({ payload: {
+			BotId: requested,
+			event: data?.payload?.event
+		} });
+		if (!entry) {
+			consume([createResult(ResultCode.FailParams, error || "QQ Bot is unavailable", null)]);
+			return;
+		}
+		await entry.adapter.onApi(data, (results) => {
+			const result = results.find((item) => item.code === ResultCode.Ok)?.data;
+			if (method === "streamOpen" && result?.streamId) this.#streams.set(String(result.streamId), requested || this.#botIdFor(entry));
+			if (streamId && (method === "streamComplete" || method === "streamCancel")) this.#streams.delete(String(streamId));
+			consume(results);
+		});
+	}
+	#botIdFor(entry) {
+		return [...this.#bots.entries()].find(([, value]) => value === entry)?.[0] || "";
+	}
+};
 
-export { QQBotRegistry };
+//#endregion
+export { QQBotRegistry };

package/lib/sdk/session.d.ts

@@ -1,18 +1,22 @@
-export type PersistedSession = {
-    botId: string;
-    sessionId: string;
-    sequence: number;
+//#region src/sdk/session.d.ts
+type PersistedSession = {
+  botId: string;
+  sessionId: string;
+  sequence: number;
 };
-export interface SessionStore {
-    load(botId: string): Promise<PersistedSession | null>;
-    save(session: PersistedSession): Promise<void>;
-    clear(botId: string): Promise<void>;
+interface SessionStore {
+  load(botId: string): Promise<PersistedSession | null>;
+  save(session: PersistedSession): Promise<void>;
+  clear(botId: string): Promise<void>;
 }
-export declare class FileSessionStore implements SessionStore {
-    #private;
-    private readonly root;
-    constructor(root?: string);
-    load(botId: string): Promise<PersistedSession | null>;
-    save(session: PersistedSession): Promise<void>;
-    clear(botId: string): Promise<void>;
+/** Default store. Sessions contain no access token or application secret. */
+declare class FileSessionStore implements SessionStore {
+  #private;
+  private readonly root;
+  constructor(root?: string);
+  load(botId: string): Promise<PersistedSession | null>;
+  save(session: PersistedSession): Promise<void>;
+  clear(botId: string): Promise<void>;
 }
+//#endregion
+export { FileSessionStore, PersistedSession, SessionStore };