@xopcai/xopc 0.0.285 → 0.0.286

package/dist/extensions/telegram/src/inbound-processor.js

@@ -8,7 +8,7 @@ import { buildTelegramUpdateKey, telegramUpdateDedupe } from "./dedupe.js";
 import "../../../src/routing/index.js";
 import { resolveTelegramGroupContext } from "./group-config-resolver.js";
 import { buildTelegramConversationId } from "./conversation-id.js";
-import { resolveTelegramFocusedSessionKey } from "./focus-handler.js";
+import { resolveTelegramFocusedConversationId } from "./focus-handler.js";
 //#region extensions/telegram/src/inbound-processor.ts
 init_logger();
 const log = createLogger("TelegramInboundProcessor");
@@ -161,7 +161,7 @@ async function processAllMedia(media, bot, botToken, accountApiRoot, message, st
 * Create inbound message processor
 */
 function createInboundProcessor(deps) {
-	const { bus, config, accountManager, accessControl, sessionKeyService, sttService, mediaUtils } = deps;
+	const { bus, config, accountManager, accessControl, conversationIdService, sttService, mediaUtils } = deps;
 	const messageQueues = /* @__PURE__ */ new Map();
 	const processingLocks = /* @__PURE__ */ new Map();
 	const getChatKey = (accountId, chatId) => `${accountId}:${chatId}`;
@@ -301,7 +301,7 @@ function createInboundProcessor(deps) {
 			threadId: threadId ? String(threadId) : null
 		});
 		const routedAgentId = groupCtx.agentId ?? route.agentId;
-		const defaultSessionKey = sessionKeyService.generateSessionKey({
+		const defaultConversationId = conversationIdService.generateConversationId({
 			source: "telegram",
 			chatId,
 			senderId,
@@ -310,12 +310,12 @@ function createInboundProcessor(deps) {
 			accountId,
 			agentId: routedAgentId
 		});
-		const sessionKey = resolveTelegramFocusedSessionKey({
+		const conversationId = resolveTelegramFocusedConversationId({
 			chatId,
 			threadId: threadId ? String(threadId) : void 0,
-			defaultSessionKey
+			defaultConversationId
 		});
-		const conversationId = buildTelegramConversationId(chatId, threadId);
+		const externalConversationId = buildTelegramConversationId(chatId, threadId);
 		const media = extractMediaItems(message);
 		const bot = accountManager.getBot(accountId);
 		const botToken = account.botToken;
@@ -336,13 +336,13 @@ function createInboundProcessor(deps) {
 			chatId,
 			senderId,
 			isGroup,
-			sessionKey,
+			conversationId,
 			contentLength: finalContent.length,
 			attachmentCount: attachments.length,
 			isCommand
 		}, "Processing Telegram message");
-		if (finalContent.trim().length > 0 && !isCommand && answerClarificationTextFromChannel(sessionKey, finalContent.trim(), `telegram:${accountId}:${chatId}:message:${message.message_id}`)) {
-			log.debug({ sessionKey }, "Telegram: consumed message as clarify reply");
+		if (finalContent.trim().length > 0 && !isCommand && answerClarificationTextFromChannel(conversationId, finalContent.trim(), `telegram:${accountId}:${chatId}:message:${message.message_id}`)) {
+			log.debug({ conversationId }, "Telegram: consumed message as clarify reply");
 			return;
 		}
 		await bus.publishInbound({
@@ -352,13 +352,13 @@ function createInboundProcessor(deps) {
 			content: finalContent,
 			metadata: {
 				accountId,
-				sessionKey,
+				conversationId,
 				senderUsername,
 				messageId: String(message.message_id),
 				isGroup,
 				isCommand,
 				threadId: threadId ? String(threadId) : void 0,
-				conversationId,
+				externalConversationId,
 				channelSystemPrompt: groupCtx.systemPrompt,
 				channelAgentId: routedAgentId,
 				media: media.length > 0 ? media : void 0,

package/dist/extensions/telegram/src/plugin.js

@@ -3,7 +3,7 @@ import { init_logger } from "../../../src/utils/logger.js";
 import { TelegramConfigSchema, init_config_schema } from "./config-schema.js";
 import { registerChannelExecApprovalHandler } from "../../../src/channels/exec-approval-runtime.js";
 import { isSTTAvailable } from "../../../src/voice/stt/availability.js";
-import { generateSessionKey } from "../../../src/chat-commands/session-key.js";
+import { generateConversationId } from "../../../src/chat-commands/session-key.js";
 import { resolveStandardPairingPath } from "../../../src/channels/pairing/paths.js";
 import { issuePairingChallenge } from "../../../src/channels/pairing/pairing-challenge.js";
 import { createStandardPairingAdapter } from "../../../src/channels/pairing/pairing-store-adapter.js";
@@ -184,10 +184,10 @@ var TelegramChannelPlugin = class {
 			bus: this.bus,
 			config: this.cfg,
 			accountManager: this.accountManager,
-			getSessionModel: (sessionKey) => sm?.getModelForSession(sessionKey),
-			setSessionModel: (sessionKey, modelId) => {
+			getSessionModel: (conversationId) => sm?.getModelForSession(conversationId),
+			setSessionModel: (conversationId, modelId) => {
 				if (!sm) return;
-				sm.switchModelForSession(sessionKey, modelId);
+				sm.switchModelForSession(conversationId, modelId);
 			}
 		});
 		const adapters = createTelegramPluginAdapters({ accountManager: this.accountManager });
@@ -200,7 +200,7 @@ var TelegramChannelPlugin = class {
 			config: this.cfg,
 			accountManager: this.accountManager,
 			accessControl,
-			sessionKeyService: { generateSessionKey: (opts) => generateSessionKey({
+			conversationIdService: { generateConversationId: (opts) => generateConversationId({
 				source: "telegram",
 				chatId: opts.chatId,
 				senderId: opts.senderId,

package/dist/extensions/telegram/src/routing-integration.d.ts

@@ -24,7 +24,7 @@ export interface TelegramRoutingContext {
 /**
  * Generate session key with routing integration
  */
-export declare function generateSessionKeyWithRouting(ctx: TelegramRoutingContext, config: Config): string;
+export declare function generateConversationIdWithRouting(ctx: TelegramRoutingContext, config: Config): string;
 /**
  * Extract member role IDs from Telegram chat member
  * (Currently returns empty array as Telegram doesn't have direct role mapping)

package/dist/extensions/telegram/src/routing-integration.js

@@ -1,7 +1,6 @@
 import { createLogger } from "../../../src/utils/logger/index.js";
 import { init_logger } from "../../../src/utils/logger.js";
-import { buildSessionKey } from "../../../src/routing/session-key.js";
-import { applyIdentityLinks, resolveRoute } from "../../../src/routing/resolve-route.js";
+import { resolveRoute } from "../../../src/routing/resolve-route.js";
 import "../../../src/routing/index.js";
 //#region extensions/telegram/src/routing-integration.ts
 init_logger();
@@ -9,37 +8,36 @@ const log = createLogger("TelegramRouting");
 /**
 * Generate session key with routing integration
 */
-function generateSessionKeyWithRouting(ctx, config) {
-	const channel = ctx.channel ?? "telegram";
-	const route = resolveRoute({
-		config,
-		channel,
+function generateConversationIdWithRouting(ctx, config) {
+	const routeInput = {
+		channel: ctx.channel ?? "telegram",
 		accountId: ctx.accountId,
 		peerKind: ctx.isGroup ? "group" : "dm",
 		peerId: ctx.isGroup ? ctx.chatId : ctx.senderId,
 		guildId: ctx.guildId ?? null,
 		teamId: null,
-		memberRoleIds: ctx.memberRoleIds ?? [],
-		threadId: ctx.threadId
-	});
-	const identityLinks = config.session?.identityLinks ?? {};
-	const finalPeerId = applyIdentityLinks(ctx.isGroup ? ctx.chatId : ctx.senderId, channel, identityLinks);
-	const finalSessionKey = buildSessionKey({
-		agentId: route.agentId,
-		source: channel,
-		accountId: route.accountId,
-		peerKind: ctx.isGroup ? "group" : "dm",
-		peerId: finalPeerId,
+		memberRoleIds: ctx.memberRoleIds ?? []
+	};
+	const route = resolveRoute({
+		config: {
+			...config,
+			session: {
+				...config.session,
+				dmScope: "per-account-channel-peer"
+			}
+		},
+		...routeInput,
 		threadId: ctx.threadId
 	});
+	const finalConversationId = route.conversationId;
 	log.debug({
 		accountId: ctx.accountId,
 		chatId: ctx.chatId,
 		senderId: ctx.senderId,
-		sessionKey: finalSessionKey,
+		conversationId: finalConversationId,
 		agentId: route.agentId
 	}, "Generated session key with routing");
-	return finalSessionKey;
+	return finalConversationId;
 }
 /**
 * Extract member role IDs from Telegram chat member
@@ -55,4 +53,4 @@ function extractMemberRoleIds(ctx) {
 	return roles;
 }
 //#endregion
-export { extractMemberRoleIds, generateSessionKeyWithRouting };
+export { extractMemberRoleIds, generateConversationIdWithRouting };

package/dist/extensions/telegram/src/thread-bindings.d.ts

@@ -3,7 +3,7 @@
  * Full implementation requires subagent spawn + session focus routing.
  */
 export interface TelegramThreadBinding {
-    sessionKey: string;
+    conversationId: string;
     chatId: string;
     threadId?: string;
     createdAtMs: number;

package/dist/extensions/telegram/src/workflow-progress.js

@@ -1,6 +1,7 @@
 import { createLogger } from "../../../src/utils/logger/index.js";
 import { init_logger } from "../../../src/utils/logger.js";
-import { init_session_key, parseSessionKey } from "../../../src/routing/session-key.js";
+import { getConversationRouting } from "../../../src/storage/sqlite/conversation-repository.js";
+import { init_session_key } from "../../../src/routing/session-key.js";
 //#region extensions/telegram/src/workflow-progress.ts
 init_session_key();
 init_logger();
@@ -16,10 +17,10 @@ function createTelegramWorkflowProgressCapability(accountManager) {
 		defaultThrottleMs: DEFAULT_THROTTLE_MS,
 		defaultMode: "edit",
 		async postProgress(input) {
-			const target = resolveTarget(input.sessionKey);
-			if (!target) throw new Error(`telegram workflow progress: cannot route sessionKey "${input.sessionKey}"`);
+			const target = resolveTarget(input.conversationId);
+			if (!target) throw new Error(`telegram workflow progress: cannot route conversationId "${input.conversationId}"`);
 			const bot = accountManager.getBot(target.accountId);
-			if (!bot) throw new Error(`telegram workflow progress: no bot for accountId "${target.accountId}" (sessionKey "${input.sessionKey}")`);
+			if (!bot) throw new Error(`telegram workflow progress: no bot for accountId "${target.accountId}" (conversationId "${input.conversationId}")`);
 			const text = clampForTelegram(input.text);
 			if (input.previousMessageId && !input.isFinal) try {
 				await bot.api.editMessageText(target.chatId, Number(input.previousMessageId), text);
@@ -27,7 +28,7 @@ function createTelegramWorkflowProgressCapability(accountManager) {
 			} catch (err) {
 				if (isMessageNotModified(err)) return { messageId: input.previousMessageId };
 				if (isEditTargetGone(err)) log.debug({
-					sessionKey: input.sessionKey,
+					conversationId: input.conversationId,
 					previousMessageId: input.previousMessageId
 				}, "edit target gone; falling back to sendMessage");
 				else throw err;
@@ -40,8 +41,8 @@ function createTelegramWorkflowProgressCapability(accountManager) {
 		}
 	};
 }
-function resolveTarget(sessionKey) {
-	const parsed = parseSessionKey(sessionKey);
+function resolveTarget(conversationId) {
+	const parsed = getConversationRouting(conversationId);
 	if (!parsed) return null;
 	if (parsed.source !== "telegram") return null;
 	if (!parsed.peerId) return null;

package/dist/extensions/telegram/xopc.extension.json

@@ -2,7 +2,7 @@
   "id": "telegram",
   "name": "Telegram Channel",
   "description": "Bundled Telegram Bot channel (private workspace sources; ships inside @xopcai/xopc dist/)",
-  "version": "0.0.285",
+  "version": "0.0.286",
   "kind": "channel",
   "main": "src/index.js",
   "channels": [

package/dist/extensions/weixin/src/auth/login-qr.d.ts

@@ -1,5 +1,5 @@
 type ActiveLogin = {
-    sessionKey: string;
+    conversationId: string;
     id: string;
     qrcode: string;
     qrcodeUrl: string;
@@ -15,7 +15,7 @@ export declare const DEFAULT_ILINK_BOT_TYPE = "3";
 export type WeixinQrStartResult = {
     qrcodeUrl?: string;
     message: string;
-    sessionKey: string;
+    conversationId: string;
 };
 export type WeixinQrWaitResult = {
     connected: boolean;
@@ -34,7 +34,7 @@ export declare function startWeixinLoginWithQr(opts: {
     botType?: string;
     routeTag?: string;
 }): Promise<WeixinQrStartResult>;
-export declare function getWeixinActiveLoginSnapshot(sessionKey: string): {
+export declare function getWeixinActiveLoginSnapshot(conversationId: string): {
     qrcodeUrl: string;
     status?: ActiveLogin["status"];
 } | null;
@@ -43,7 +43,7 @@ export declare function waitForWeixinLogin(opts: {
     verbose?: boolean;
     /** When true, do not write to stdout (browser / gateway QR flow). */
     silent?: boolean;
-    sessionKey: string;
+    conversationId: string;
     botType?: string;
     routeTag?: string;
 }): Promise<WeixinQrWaitResult>;

package/dist/extensions/weixin/src/auth/login-qr.js

@@ -50,13 +50,13 @@ async function pollQRStatus(apiBaseUrl, qrcode, routeTag) {
 	}
 }
 async function startWeixinLoginWithQr(opts) {
-	const sessionKey = opts.accountId || randomUUID();
+	const conversationId = opts.accountId || randomUUID();
 	purgeExpiredLogins();
-	const existing = activeLogins.get(sessionKey);
+	const existing = activeLogins.get(conversationId);
 	if (!opts.force && existing && isLoginFresh(existing) && existing.qrcodeUrl) return {
 		qrcodeUrl: existing.qrcodeUrl,
 		message: "二维码已就绪，请使用微信扫描。",
-		sessionKey
+		conversationId
 	};
 	try {
 		const botType = opts.botType || "3";
@@ -65,29 +65,29 @@ async function startWeixinLoginWithQr(opts) {
 		logger.info(`QR code received, qrcode=${redactToken(qrResponse.qrcode)} imgContentLen=${qrResponse.qrcode_img_content?.length ?? 0}`);
 		logger.info(`二维码链接: ${qrResponse.qrcode_img_content}`);
 		const login = {
-			sessionKey,
+			conversationId,
 			id: randomUUID(),
 			qrcode: qrResponse.qrcode,
 			qrcodeUrl: qrResponse.qrcode_img_content,
 			startedAt: Date.now()
 		};
-		activeLogins.set(sessionKey, login);
+		activeLogins.set(conversationId, login);
 		return {
 			qrcodeUrl: qrResponse.qrcode_img_content,
 			message: "使用微信扫描以下二维码，以完成连接。",
-			sessionKey
+			conversationId
 		};
 	} catch (err) {
 		logger.error(`Failed to start Weixin login: ${String(err)}`);
 		return {
 			message: `Failed to start login: ${String(err)}`,
-			sessionKey
+			conversationId
 		};
 	}
 }
 const MAX_QR_REFRESH_COUNT = 3;
-function getWeixinActiveLoginSnapshot(sessionKey) {
-	const login = activeLogins.get(sessionKey);
+function getWeixinActiveLoginSnapshot(conversationId) {
+	const login = activeLogins.get(conversationId);
 	if (!login || !isLoginFresh(login)) return null;
 	return {
 		qrcodeUrl: login.qrcodeUrl,
@@ -95,17 +95,17 @@ function getWeixinActiveLoginSnapshot(sessionKey) {
 	};
 }
 async function waitForWeixinLogin(opts) {
-	let activeLogin = activeLogins.get(opts.sessionKey);
+	let activeLogin = activeLogins.get(opts.conversationId);
 	if (!activeLogin) {
-		logger.warn(`waitForWeixinLogin: no active login sessionKey=${opts.sessionKey}`);
+		logger.warn(`waitForWeixinLogin: no active login conversationId=${opts.conversationId}`);
 		return {
 			connected: false,
 			message: "当前没有进行中的登录，请先发起登录。"
 		};
 	}
 	if (!isLoginFresh(activeLogin)) {
-		logger.warn(`waitForWeixinLogin: login QR expired sessionKey=${opts.sessionKey}`);
-		activeLogins.delete(opts.sessionKey);
+		logger.warn(`waitForWeixinLogin: login QR expired conversationId=${opts.conversationId}`);
+		activeLogins.delete(opts.conversationId);
 		return {
 			connected: false,
 			message: "二维码已过期，请重新生成。"
@@ -136,8 +136,8 @@ async function waitForWeixinLogin(opts) {
 				case "expired":
 					qrRefreshCount++;
 					if (qrRefreshCount > MAX_QR_REFRESH_COUNT) {
-						logger.warn(`waitForWeixinLogin: QR expired ${MAX_QR_REFRESH_COUNT} times, giving up sessionKey=${opts.sessionKey}`);
-						activeLogins.delete(opts.sessionKey);
+						logger.warn(`waitForWeixinLogin: QR expired ${MAX_QR_REFRESH_COUNT} times, giving up conversationId=${opts.conversationId}`);
+						activeLogins.delete(opts.conversationId);
 						return {
 							connected: false,
 							message: "登录超时：二维码多次过期，请重新开始登录流程。"
@@ -168,7 +168,7 @@ async function waitForWeixinLogin(opts) {
 						}
 					} catch (refreshErr) {
 						logger.error(`waitForWeixinLogin: failed to refresh QR code: ${String(refreshErr)}`);
-						activeLogins.delete(opts.sessionKey);
+						activeLogins.delete(opts.conversationId);
 						return {
 							connected: false,
 							message: `刷新二维码失败: ${String(refreshErr)}`
@@ -185,7 +185,7 @@ async function waitForWeixinLogin(opts) {
 				}
 				case "confirmed":
 					if (!statusResponse.ilink_bot_id) {
-						activeLogins.delete(opts.sessionKey);
+						activeLogins.delete(opts.conversationId);
 						logger.error("Login confirmed but ilink_bot_id missing from response");
 						return {
 							connected: false,
@@ -193,7 +193,7 @@ async function waitForWeixinLogin(opts) {
 						};
 					}
 					activeLogin.botToken = statusResponse.bot_token;
-					activeLogins.delete(opts.sessionKey);
+					activeLogins.delete(opts.conversationId);
 					logger.info(`✅ Login confirmed! ilink_bot_id=${statusResponse.ilink_bot_id} ilink_user_id=${redactToken(statusResponse.ilink_user_id)}`);
 					return {
 						connected: true,
@@ -206,7 +206,7 @@ async function waitForWeixinLogin(opts) {
 			}
 		} catch (err) {
 			logger.error(`Error polling QR status: ${String(err)}`);
-			activeLogins.delete(opts.sessionKey);
+			activeLogins.delete(opts.conversationId);
 			return {
 				connected: false,
 				message: `Login failed: ${String(err)}`
@@ -214,8 +214,8 @@ async function waitForWeixinLogin(opts) {
 		}
 		await new Promise((r) => setTimeout(r, 1e3));
 	}
-	logger.warn(`waitForWeixinLogin: timed out waiting for QR scan sessionKey=${opts.sessionKey} timeoutMs=${timeoutMs}`);
-	activeLogins.delete(opts.sessionKey);
+	logger.warn(`waitForWeixinLogin: timed out waiting for QR scan conversationId=${opts.conversationId} timeoutMs=${timeoutMs}`);
+	activeLogins.delete(opts.conversationId);
 	return {
 		connected: false,
 		message: "登录超时，请重试。"

package/dist/extensions/weixin/src/auth/weixin-account-id.d.ts

@@ -4,7 +4,7 @@
  */
 export declare function normalizeWeixinAccountId(raw: string): string;
 /**
- * Peer id as in session keys / context-token map (same rules as `buildSessionKey` peer segment).
+ * Peer id as in session keys / context-token map (same rules as `resolveConversationId` peer segment).
  */
 export declare function canonicalWeixinPeerId(rawPeerId: string): string;
 /**

package/dist/extensions/weixin/src/auth/weixin-account-id.js

@@ -9,7 +9,7 @@ function normalizeWeixinAccountId(raw) {
 	return raw.trim().toLowerCase().replace(/@/g, "-").replace(/\./g, "-").replace(/[^a-z0-9_-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
 }
 /**
-* Peer id as in session keys / context-token map (same rules as `buildSessionKey` peer segment).
+* Peer id as in session keys / context-token map (same rules as `resolveConversationId` peer segment).
 */
 function canonicalWeixinPeerId(rawPeerId) {
 	const t = rawPeerId.trim();

package/dist/extensions/weixin/src/cli/gateway-qr-login.d.ts

@@ -19,7 +19,7 @@ export type WeixinGatewayQrLoginStatus = {
     phase: "unknown";
     message: string;
 };
-export declare function getWeixinGatewayQrLoginStatus(sessionKey: string): WeixinGatewayQrLoginStatus;
+export declare function getWeixinGatewayQrLoginStatus(conversationId: string): WeixinGatewayQrLoginStatus;
 export type WeixinGatewayQrLoginStartOptions = {
     configPath?: string;
     account?: string;
@@ -40,7 +40,7 @@ export type WeixinGatewayQrLoginStartOptions = {
  */
 export declare function startWeixinGatewayQrLogin(opts: WeixinGatewayQrLoginStartOptions): Promise<{
     ok: true;
-    sessionKey: string;
+    conversationId: string;
     qrcodeUrl: string;
 } | {
     ok: false;

package/dist/extensions/weixin/src/cli/gateway-qr-login.js

@@ -23,12 +23,12 @@ function saveConfigSnapshot(configPath, config) {
 	if (!configPath) return;
 	writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
 }
-function rememberCompleted(sessionKey, state) {
-	completedSessions.set(sessionKey, state);
-	setTimeout(() => completedSessions.delete(sessionKey), 10 * 6e4);
+function rememberCompleted(conversationId, state) {
+	completedSessions.set(conversationId, state);
+	setTimeout(() => completedSessions.delete(conversationId), 10 * 6e4);
 }
-function getWeixinGatewayQrLoginStatus(sessionKey) {
-	const done = completedSessions.get(sessionKey);
+function getWeixinGatewayQrLoginStatus(conversationId) {
+	const done = completedSessions.get(conversationId);
 	if (done) {
 		if (done.ok === true) return {
 			phase: "done",
@@ -41,7 +41,7 @@ function getWeixinGatewayQrLoginStatus(sessionKey) {
 			message: done.message
 		};
 	}
-	const snap = getWeixinActiveLoginSnapshot(sessionKey);
+	const snap = getWeixinActiveLoginSnapshot(conversationId);
 	if (snap) return {
 		phase: "polling",
 		qrcodeUrl: snap.qrcodeUrl,
@@ -71,10 +71,10 @@ async function startWeixinGatewayQrLogin(opts) {
 		ok: false,
 		message: startResult.message || "Failed to get QR code"
 	};
-	const sessionKey = startResult.sessionKey;
+	const conversationId = startResult.conversationId;
 	(async () => {
 		const waitResult = await waitForWeixinLogin({
-			sessionKey,
+			conversationId,
 			timeoutMs,
 			verbose,
 			routeTag,
@@ -83,7 +83,7 @@ async function startWeixinGatewayQrLogin(opts) {
 		});
 		if (!waitResult.connected || !waitResult.botToken || !waitResult.accountId) {
 			const message = waitResult.message || "Login did not complete";
-			rememberCompleted(sessionKey, {
+			rememberCompleted(conversationId, {
 				phase: "done",
 				ok: false,
 				message
@@ -106,7 +106,7 @@ async function startWeixinGatewayQrLogin(opts) {
 		} catch (err) {
 			const message = `Saved login failed: ${String(err)}`;
 			logger.error(message);
-			rememberCompleted(sessionKey, {
+			rememberCompleted(conversationId, {
 				phase: "done",
 				ok: false,
 				message
@@ -126,7 +126,7 @@ async function startWeixinGatewayQrLogin(opts) {
 				message: "OK",
 				config: nextCfg
 			});
-			rememberCompleted(sessionKey, {
+			rememberCompleted(conversationId, {
 				phase: "done",
 				ok: true,
 				accountId: normalizedId
@@ -141,7 +141,7 @@ async function startWeixinGatewayQrLogin(opts) {
 			message: "OK",
 			config: cfg
 		});
-		rememberCompleted(sessionKey, {
+		rememberCompleted(conversationId, {
 			phase: "done",
 			ok: true,
 			accountId: normalizedId
@@ -149,7 +149,7 @@ async function startWeixinGatewayQrLogin(opts) {
 	})();
 	return {
 		ok: true,
-		sessionKey,
+		conversationId,
 		qrcodeUrl: startResult.qrcodeUrl
 	};
 }

package/dist/extensions/weixin/src/cli/qr-login.js

@@ -83,7 +83,7 @@ async function runWeixinQrLoginCli(opts) {
 	}
 	console.log("\nWaiting for confirmation...\n");
 	const waitResult = await waitForWeixinLogin({
-		sessionKey: startResult.sessionKey,
+		conversationId: startResult.conversationId,
 		timeoutMs,
 		verbose,
 		routeTag,

package/dist/extensions/weixin/src/delivery-to.js

@@ -1,5 +1,9 @@
-import { init_session_key, parseSessionKey } from "../../../src/routing/session-key.js";
+import { conversationIdSchema } from "../../../packages/gateway-contract/src/conversation-identity.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { getConversationRouting } from "../../../src/storage/sqlite/conversation-repository.js";
+import { init_session_key } from "../../../src/routing/session-key.js";
 //#region extensions/weixin/src/delivery-to.ts
+init_src();
 init_session_key();
 /**
 * Resolves Weixin ilink `chat_id` and optional `accountId` from cron / UI `delivery.to`.
@@ -7,7 +11,7 @@ init_session_key();
 function normalizeWeixinCronDeliveryTo(to) {
 	const trimmed = to.trim();
 	if (!trimmed) return { chatId: trimmed };
-	const parsed = parseSessionKey(trimmed);
+	const parsed = conversationIdSchema.safeParse(trimmed).success ? getConversationRouting(trimmed) : null;
 	if (parsed?.source === "weixin" && (parsed.peerKind === "direct" || parsed.peerKind === "dm") && parsed.peerId) {
 		const accountId = parsed.accountId && parsed.accountId !== "_" ? parsed.accountId : void 0;
 		return {

package/dist/extensions/weixin/src/messaging/inbound.d.ts

@@ -51,7 +51,7 @@ export type WeixinMsgContext = {
     Provider: "weixin";
     ChatType: "direct";
     /** Set by monitor after resolveAgentRoute so dispatchReplyFromConfig uses the correct session. */
-    SessionKey?: string;
+    ConversationId?: string;
     context_token?: string;
     MediaUrl?: string;
     MediaPath?: string;

package/dist/extensions/weixin/src/messaging/inbound.js

@@ -29,7 +29,7 @@ function parsePersistedPeerVal(val) {
 	return null;
 }
 /**
-* Session keys use {@link canonicalWeixinPeerId} (same as `buildSessionKey`); cron `delivery.to`
+* Session keys use {@link canonicalWeixinPeerId} (same as `resolveConversationId`); cron `delivery.to`
 * and outbound `ctx.to` use that shape. ilink `from_user_id` is often `…@im.wechat` while the
 * session peer is `…-im-wechat`. Normalize so context_token cache keys match lookups.
 */

package/dist/extensions/weixin/src/messaging/process-message.js

@@ -10,7 +10,7 @@ import { downloadMediaFromItem } from "../media/media-download.js";
 import { isDebugMode } from "./debug-mode.js";
 import { sendMessageWeixin } from "./send.js";
 import { handleSlashCommand } from "./slash-commands.js";
-import { generateWeixinSessionKeyWithRouting } from "../routing-integration.js";
+import { generateWeixinConversationIdWithRouting } from "../routing-integration.js";
 import path from "node:path";
 import { randomBytes } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
@@ -112,7 +112,7 @@ async function processWeixinInboundMessage(full, deps) {
 	}
 	const ctx = weixinMessageToMsgContext(full, deps.accountId, mediaOpts);
 	const body = ctx.Body?.trim() ?? "";
-	const sessionKey = generateWeixinSessionKeyWithRouting({
+	const conversationId = generateWeixinConversationIdWithRouting({
 		accountId: deps.accountId,
 		senderId
 	}, deps.config);
@@ -158,7 +158,7 @@ async function processWeixinInboundMessage(full, deps) {
 		content: body,
 		metadata: {
 			accountId: deps.accountId,
-			sessionKey,
+			conversationId,
 			messageId: full.message_id != null ? String(full.message_id) : void 0,
 			isGroup: false,
 			isCommand: body.trim().startsWith("/"),

package/dist/extensions/weixin/src/plugin.js

@@ -91,7 +91,7 @@ var WeixinChannelPlugin = class {
 				ok: true,
 				payload: {
 					type: "qr",
-					sessionKey: start.sessionKey,
+					conversationId: start.conversationId,
 					qrcodeUrl: start.qrcodeUrl,
 					statusAction: "login.status",
 					pollIntervalMs: 2500,
@@ -101,13 +101,13 @@ var WeixinChannelPlugin = class {
 		}
 		if (actionId === "login.status") {
 			const inputRecord = input && typeof input === "object" && !Array.isArray(input) ? input : {};
-			const sessionKey = typeof inputRecord.sessionKey === "string" ? inputRecord.sessionKey : "";
-			if (!sessionKey) return {
+			const conversationId = typeof inputRecord.conversationId === "string" ? inputRecord.conversationId : "";
+			if (!conversationId) return {
 				ok: false,
-				message: zh ? "缺少登录 sessionKey" : "Missing login sessionKey"
+				message: zh ? "缺少登录 conversationId" : "Missing login conversationId"
 			};
 			const { getWeixinGatewayQrLoginStatus } = await import("./cli/gateway-qr-login.js");
-			const status = getWeixinGatewayQrLoginStatus(sessionKey);
+			const status = getWeixinGatewayQrLoginStatus(conversationId);
 			if (status.phase === "polling") return {
 				ok: true,
 				payload: {

package/dist/extensions/weixin/src/routing-integration.d.ts

@@ -4,4 +4,4 @@ export type WeixinRoutingContext = {
     senderId: string;
 };
 /** Resolve a direct-message session key through the shared channel binding rules. */
-export declare function generateWeixinSessionKeyWithRouting(context: WeixinRoutingContext, config: Config): string;
+export declare function generateWeixinConversationIdWithRouting(context: WeixinRoutingContext, config: Config): string;