@openclaw/matrix 2026.10.5-beta.3 → 2026.10.10-beta.1

package/dist/.setup/{approval-handler.runtime-rxLn8CbP.mjs → approval-handler.runtime-CsqMdj7h.mjs}

@@ -1,18 +1,18 @@
 import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.mjs";
-import { c as shouldHandleMatrixApprovalRequest, r as isMatrixAnyApprovalClientEnabled } from "./exec-approvals-BgNWWJg1.mjs";
+import { r as isMatrixAnyApprovalClientEnabled, s as shouldHandleMatrixApprovalRequest } from "./exec-approvals-DaM-5OA5.mjs";
 import { s as resolveMatrixTargetIdentity } from "./target-ids-HhcaKX1n.mjs";
 import { a as repairMatrixDirectRooms } from "./direct-management-B3wYhx_M.mjs";
-import { a as sendSingleTextMessageMatrix, n as reactMatrixMessage, r as sendMessageMatrix } from "./send-LCOuTVc1.mjs";
-import { a as unregisterMatrixApprovalReactionTarget, n as listMatrixApprovalReactionBindings, r as registerMatrixApprovalReactionTarget, t as buildMatrixApprovalReactionHint } from "./approval-reactions-DhB6gNPU.mjs";
-import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-B1CZqU8u.mjs";
+import { a as sendSingleTextMessageMatrix, n as reactMatrixMessage, r as sendMessageMatrix } from "./send-BprM-Wmx.mjs";
+import { a as unregisterMatrixApprovalReactionTarget, n as listMatrixApprovalReactionBindings, r as registerMatrixApprovalReactionTarget, t as buildMatrixApprovalReactionHint } from "./approval-reactions-D2pEUrFS.mjs";
+import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-_XHVg3do.mjs";
 import { listMessageReceiptPlatformIds, resolveMessageReceiptPrimaryId } from "openclaw/plugin-sdk/channel-outbound";
 import { normalizeStringifiedOptionalString, normalizeUniqueStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { buildChannelApprovalNativeTargetKey } from "openclaw/plugin-sdk/approval-native-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/routing";
-import { createChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-runtime";
+import { retryAsync } from "openclaw/plugin-sdk/retry-runtime";
+import { createChannelApprovalNativeRuntimeAdapterAsync } from "openclaw/plugin-sdk/approval-handler-runtime";
 import { buildExecApprovalPendingReplyPayload, buildPluginApprovalPendingReplyPayload } from "openclaw/plugin-sdk/approval-reply-runtime";
 import { buildApprovalPendingReplyPayload, buildPluginApprovalResolvedReplyPayload, formatChannelApprovalResolvedLabel } from "openclaw/plugin-sdk/approval-runtime";
-import { retryAsync } from "openclaw/plugin-sdk/retry-runtime";
 //#region extensions/matrix/src/approval-handler.runtime.ts
 const MATRIX_APPROVAL_METADATA_KEY = "com.openclaw.approval";
 const MATRIX_APPROVAL_DELIVERY_ATTEMPTS = 3;
@@ -192,14 +192,14 @@ function buildMarkdownCodeBlock(text) {
 		fence
 	].join("\n");
 }
-const matrixApprovalNativeRuntime = createChannelApprovalNativeRuntimeAdapter({
+const matrixApprovalNativeRuntime = createChannelApprovalNativeRuntimeAdapterAsync({
 	eventKinds: [
 		"exec",
 		"plugin",
 		"system-agent"
 	],
 	availability: {
-		isConfigured: ({ cfg, accountId, context }) => {
+		isConfigured: async ({ cfg, accountId, context }) => {
 			const resolved = resolveHandlerContext({
 				cfg,
 				accountId,
@@ -211,7 +211,7 @@ const matrixApprovalNativeRuntime = createChannelApprovalNativeRuntimeAdapter({
 				accountId: resolved.accountId
 			});
 		},
-		shouldHandle: ({ cfg, accountId, approvalKind, request, context }) => {
+		shouldHandle: async ({ cfg, accountId, approvalKind, request, context }) => {
 			const resolved = resolveHandlerContext({
 				cfg,
 				accountId,

package/dist/.setup/{approval-reactions-DhB6gNPU.mjs → approval-reactions-D2pEUrFS.mjs}

@@ -42,7 +42,7 @@ function readPersistedTarget(target) {
 	};
 }
 function openPersistentMatrixApprovalReactionStore() {
-	return getOptionalMatrixRuntime()?.state.openKeyedStore({
+	return getOptionalMatrixRuntime()?.state.openKeyedStoreV2({
 		namespace: PERSISTENT_NAMESPACE,
 		maxEntries: PERSISTENT_MAX_ENTRIES,
 		defaultTtlMs: DEFAULT_REACTION_TARGET_TTL_MS

package/dist/.setup/{channel-BcwGspPw.mjs → channel-Dw4_imdd.mjs}

@@ -1,12 +1,12 @@
 import { i as __exportAll, n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-CsTNmbMa.mjs";
 import { i as requiresExplicitMatrixDefaultAccount, n as findMatrixAccountEntry, r as hasImplicitMatrixAccountConfig } from "./account-selection-Bs_jCAaG.mjs";
 import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.mjs";
-import { _ as resolveMatrixAccount, g as resolveDefaultMatrixAccountId, m as listMatrixAccountIds, v as resolveMatrixAccountAsync } from "./setup-core-CKnNTfgD.mjs";
-import { i as normalizeMatrixUserId, t as matrixPluginBase } from "./channel.setup-CwuYD_CT.mjs";
-import { a as isMatrixExecApprovalAuthorizedSender, c as shouldHandleMatrixApprovalRequest, d as matrixApprovalAuth, f as normalizeMatrixApproverId, i as isMatrixApprovalClientEnabled, l as shouldSuppressLocalMatrixExecApprovalPrompt, n as getMatrixExecApprovalApprovers, o as isMatrixExecApprovalClientEnabled, r as isMatrixAnyApprovalClientEnabled, s as resolveMatrixExecApprovalTarget, t as getMatrixApprovalApprovers, u as getMatrixApprovalAuthApprovers } from "./exec-approvals-BgNWWJg1.mjs";
+import { _ as resolveMatrixAccount, g as resolveDefaultMatrixAccountId, m as listMatrixAccountIds, v as resolveMatrixAccountAsync } from "./setup-core-DcCk1_Tv.mjs";
+import { i as normalizeMatrixUserId, t as matrixPluginBase } from "./channel.setup-Be8TYKMA.mjs";
+import { a as isMatrixExecApprovalAuthorizedSender, c as shouldSuppressLocalMatrixExecApprovalPrompt, d as normalizeMatrixApproverId, i as isMatrixApprovalClientEnabled, l as getMatrixApprovalAuthApprovers, n as getMatrixExecApprovalApprovers, o as resolveMatrixExecApprovalTarget, r as isMatrixAnyApprovalClientEnabled, s as shouldHandleMatrixApprovalRequest, t as getMatrixApprovalApprovers, u as matrixApprovalAuth } from "./exec-approvals-DaM-5OA5.mjs";
 import { a as normalizeMatrixResolvableTarget, i as normalizeMatrixMessagingTarget, n as isMatrixQualifiedUserId, o as resolveMatrixDirectUserId, r as isMatrixRoomId, s as resolveMatrixTargetIdentity } from "./target-ids-HhcaKX1n.mjs";
-import { d as setMatrixThreadBindingMaxAgeBySessionKey, l as setMatrixThreadBindingIdleTimeoutBySessionKey } from "./thread-bindings-shared-CbsFNbAY.mjs";
-import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-DSBRvhdZ.mjs";
+import { f as setMatrixThreadBindingMaxAgeBySessionKey, l as setMatrixThreadBindingIdleTimeoutBySessionKey, p as setMatrixThreadBindingMaxAgeBySessionKeyAsync, u as setMatrixThreadBindingIdleTimeoutBySessionKeyAsync } from "./thread-bindings-shared-CPjUA0Ib.mjs";
+import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-DxyzKSzf.mjs";
 import { n as resolveMatrixInboundConversation, t as defaultTopLevelPlacement } from "./thread-binding-api-BvuaKpd0.mjs";
 import { createLazyRuntimeModule, createLazyRuntimeNamedExport } from "openclaw/plugin-sdk/lazy-runtime";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
@@ -25,15 +25,15 @@ import { chunkTextForOutbound, sanitizeAssistantVisibleText } from "openclaw/plu
 import { createActionGate } from "openclaw/plugin-sdk/channel-actions";
 import { extractToolSend } from "openclaw/plugin-sdk/tool-send";
 import { Type } from "typebox";
-import { createApproverRestrictedNativeApprovalCapability, createChannelApprovalCapability, splitChannelApprovalCapability } from "openclaw/plugin-sdk/approval-delivery-runtime";
-import { createLazyChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
-import { createChannelNativeOriginTargetResolver, resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
+import { createApproverRestrictedNativeApprovalCapabilityAsync, createChannelApprovalCapability, splitChannelApprovalCapability } from "openclaw/plugin-sdk/approval-delivery-runtime";
+import { createLazyChannelApprovalNativeRuntimeAdapterAsync } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
+import { createChannelNativeOriginTargetResolverAsync, resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
 import { buildAgentSessionKey, deriveLastRoutePolicy, parseThreadSessionSuffix, resolveAgentIdFromSessionKey, resolveAgentRoute, resolveThreadSessionKeys } from "openclaw/plugin-sdk/routing";
 import { buildChannelKeyCandidates } from "openclaw/plugin-sdk/channel-targets";
 import { resolveConfiguredAcpBindingRecord } from "openclaw/plugin-sdk/acp-binding-resolve-runtime";
-import { inspectConversationBinding } from "openclaw/plugin-sdk/conversation-binding-inspection-runtime";
+import { inspectConversationBindingAsync } from "openclaw/plugin-sdk/conversation-binding-inspection-runtime";
 import { inspectRuntimeConversationBindingRoute } from "openclaw/plugin-sdk/conversation-binding-runtime";
-import { deliveryContextFromSession, getSessionEntry, resolveStorePath, sessionDeliveryOrigin } from "openclaw/plugin-sdk/session-store-runtime";
+import { deliveryContextFromSession, getSessionEntryAsync, resolveStorePath, sessionDeliveryOrigin } from "openclaw/plugin-sdk/session-store-runtime";
 //#region extensions/matrix/src/actions.ts
 const MATRIX_PLUGIN_HANDLED_ACTIONS = /* @__PURE__ */ new Set([
 	"send",
@@ -91,6 +91,30 @@ function resolveMatrixActionAccount(params) {
 	});
 	return account.enabled && account.configured ? account : null;
 }
+function describeMatrixMessageTool(account, senderIsOwner) {
+	if (!account?.enabled || !account.configured) return {
+		actions: [],
+		capabilities: []
+	};
+	const actions = createMatrixExposedActions({
+		gate: createActionGate(account.config.actions),
+		encryptionEnabled: account.config.encryption === true,
+		senderIsOwner
+	});
+	const listedActions = Array.from(actions);
+	const schema = [];
+	if (actions.has("set-profile")) schema.push(buildMatrixProfileToolSchema());
+	if (actions.has("react")) schema.push({
+		actions: ["react", "reactions"],
+		properties: { emoji: Type.Optional(Type.String({ description: `Unicode emoji or custom emote shortcode.${actions.has("emoji-list") ? " Discover room and personal custom emotes with action:\"emoji-list\"." : ""}` })) }
+	});
+	return {
+		actions: listedActions,
+		capabilities: ["presentation"],
+		schema: schema.length > 1 ? schema : schema[0] ?? null,
+		mediaSourceParams: listedActions.includes("set-profile") ? { "set-profile": MATRIX_PROFILE_MEDIA_SOURCE_PARAMS } : null
+	};
+}
 const matrixMessageActions = {
 	providerOwnedReadGates: true,
 	readAuthorityActions: [
@@ -101,33 +125,19 @@ const matrixMessageActions = {
 		"member-info",
 		"channel-info"
 	],
+	/** @deprecated Use describeMessageToolAsync. Final compatibility day: 2026-12-31. */
 	describeMessageTool: ({ cfg, accountId, senderIsOwner }) => {
-		const account = resolveMatrixActionAccount({
+		return describeMatrixMessageTool(resolveMatrixActionAccount({
 			cfg,
 			accountId
-		});
-		if (!account) return {
-			actions: [],
-			capabilities: []
-		};
-		const actions = createMatrixExposedActions({
-			gate: createActionGate(account.config.actions),
-			encryptionEnabled: account.config.encryption === true,
-			senderIsOwner
-		});
-		const listedActions = Array.from(actions);
-		const schema = [];
-		if (actions.has("set-profile")) schema.push(buildMatrixProfileToolSchema());
-		if (actions.has("react")) schema.push({
-			actions: ["react", "reactions"],
-			properties: { emoji: Type.Optional(Type.String({ description: `Unicode emoji or custom emote shortcode.${actions.has("emoji-list") ? " Discover room and personal custom emotes with action:\"emoji-list\"." : ""}` })) }
-		});
-		return {
-			actions: listedActions,
-			capabilities: ["presentation"],
-			schema: schema.length > 1 ? schema : schema[0] ?? null,
-			mediaSourceParams: listedActions.includes("set-profile") ? { "set-profile": MATRIX_PROFILE_MEDIA_SOURCE_PARAMS } : null
-		};
+		}), senderIsOwner);
+	},
+	describeMessageToolAsync: async ({ cfg, accountId, senderIsOwner }) => {
+		const resolvedCfg = cfg;
+		return describeMatrixMessageTool(!accountId && requiresExplicitMatrixDefaultAccount(resolvedCfg) ? null : await resolveMatrixAccountAsync({
+			cfg: resolvedCfg,
+			accountId: accountId ?? resolveDefaultMatrixAccountId(resolvedCfg)
+		}), senderIsOwner);
 	},
 	supportsAction: ({ action }) => MATRIX_PLUGIN_HANDLED_ACTIONS.has(action),
 	extractToolSend: ({ args }) => {
@@ -144,7 +154,7 @@ const matrixMessageActions = {
 		return account.enabled && account.configured && createActionGate(account.config.actions)("messages") ? payload : null;
 	},
 	handleAction: async (ctx) => {
-		const { handleMatrixAction } = await import("./tool-actions-DAp6_XSJ.mjs");
+		const { handleMatrixAction } = await import("./tool-actions-DBrk6Yei.mjs");
 		return await handleMatrixAction(ctx);
 	}
 };
@@ -207,17 +217,8 @@ function hasAnyMatrixApprovalApprovers(params) {
 function resolveSuppressionAccountId(params) {
 	return params.target.accountId?.trim() || params.request.request.turnSourceAccountId?.trim() || void 0;
 }
-const resolveMatrixOriginTarget = createChannelNativeOriginTargetResolver({
+const resolveMatrixOriginTargetBase = createChannelNativeOriginTargetResolverAsync({
 	channel: "matrix",
-	shouldHandleRequest: ({ cfg, accountId, approvalKind, request }) => {
-		if (approvalKind !== "exec" && approvalKind !== "plugin" && approvalKind !== "system-agent") return false;
-		return shouldHandleMatrixApprovalRequest({
-			cfg,
-			accountId,
-			approvalKind,
-			request
-		});
-	},
 	resolveTurnSourceTarget: resolveTurnSourceMatrixOriginTarget,
 	resolveSessionTarget: resolveSessionMatrixOriginTarget,
 	normalizeTargetForMatch: normalizeMatrixOriginTarget,
@@ -233,14 +234,22 @@ const resolveMatrixOriginTarget = createChannelNativeOriginTargetResolver({
 		});
 	}
 });
-function resolveMatrixApproverDmTargets(params) {
-	if (!shouldHandleMatrixApprovalRequest(params)) return [];
+async function resolveMatrixOriginTarget(params) {
+	const approvalKind = params.approvalKind;
+	if (!approvalKind) return null;
+	return await shouldHandleMatrixApprovalRequest({
+		...params,
+		approvalKind
+	}) ? resolveMatrixOriginTargetBase(params) : null;
+}
+async function resolveMatrixApproverDmTargets(params) {
+	if (!await shouldHandleMatrixApprovalRequest(params)) return [];
 	return getMatrixApprovalApprovers(params).map((approver) => {
 		const normalized = normalizeMatrixUserId(approver);
 		return normalized ? { to: `user:${normalized}` } : null;
 	}).filter((target) => target !== null);
 }
-const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCapability({
+const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCapabilityAsync({
 	channel: "matrix",
 	channelLabel: "Matrix",
 	describeExecApprovalSetup: ({ accountId }) => {
@@ -259,14 +268,17 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 		senderId,
 		approvalKind: "plugin"
 	}),
-	isNativeDeliveryEnabled: isMatrixExecApprovalClientEnabled,
+	isNativeDeliveryEnabled: ({ approvalKind, ...params }) => isMatrixApprovalClientEnabled({
+		...params,
+		approvalKind: approvalKind ?? "exec"
+	}),
 	resolveNativeDeliveryMode: resolveMatrixExecApprovalTarget,
 	requireMatchingTurnSourceChannel: true,
 	resolveSuppressionAccountId,
 	resolveOriginTarget: resolveMatrixOriginTarget,
 	resolveApproverDmTargets: resolveMatrixApproverDmTargets,
 	notifyOriginWhenDmOnly: true,
-	nativeRuntime: createLazyChannelApprovalNativeRuntimeAdapter({
+	nativeRuntimeAsync: createLazyChannelApprovalNativeRuntimeAdapterAsync({
 		capabilityBoundary: true,
 		eventKinds: [
 			"exec",
@@ -275,15 +287,15 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 		],
 		isConfigured: isMatrixAnyApprovalClientEnabled,
 		shouldHandle: shouldHandleMatrixApprovalRequest,
-		load: async () => (await import("./approval-handler.runtime-rxLn8CbP.mjs")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-CsqMdj7h.mjs")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
-const matrixBaseNativeApprovalAdapter = splitMatrixApprovalCapability.native;
+const matrixBaseNativeApprovalAdapter = splitMatrixApprovalCapability.nativeAsync;
 const matrixBaseDeliveryAdapter = splitMatrixApprovalCapability.delivery;
 const matrixDeliveryAdapter = matrixBaseDeliveryAdapter && {
 	...matrixBaseDeliveryAdapter,
-	shouldSuppressForwardingFallback: (params) => {
+	shouldSuppressForwardingFallbackAsync: async (params) => {
 		const accountId = resolveSuppressionAccountId(params);
 		if (!hasMatrixApprovalApprovers({
 			cfg: params.cfg,
@@ -293,40 +305,19 @@ const matrixDeliveryAdapter = matrixBaseDeliveryAdapter && {
 		if (params.approvalKind === "plugin") {
 			const targetChannel = normalizeLowercaseStringOrEmpty(params.target.channel);
 			const turnSourceChannel = normalizeLowercaseStringOrEmpty(params.request.request.turnSourceChannel);
-			return targetChannel === "matrix" && turnSourceChannel === "matrix" && shouldHandleMatrixApprovalRequest({
+			return targetChannel === "matrix" && turnSourceChannel === "matrix" && await shouldHandleMatrixApprovalRequest({
 				cfg: params.cfg,
 				accountId,
 				approvalKind: "plugin",
 				request: params.request
 			});
 		}
-		return matrixBaseDeliveryAdapter.shouldSuppressForwardingFallback?.(params) ?? false;
+		return matrixBaseDeliveryAdapter.shouldSuppressForwardingFallbackAsync?.(params) ?? false;
 	}
 };
-const matrixNativeAdapter = matrixBaseNativeApprovalAdapter && {
-	describeDeliveryCapabilities: (params) => {
-		const capabilities = matrixBaseNativeApprovalAdapter.describeDeliveryCapabilities(params);
-		const hasApprovers = hasMatrixApprovalApprovers({
-			cfg: params.cfg,
-			accountId: params.accountId,
-			approvalKind: params.approvalKind
-		});
-		const clientEnabled = isMatrixApprovalClientEnabled({
-			cfg: params.cfg,
-			accountId: params.accountId,
-			approvalKind: params.approvalKind
-		});
-		return {
-			...capabilities,
-			enabled: hasApprovers && clientEnabled
-		};
-	},
-	resolveOriginTarget: matrixBaseNativeApprovalAdapter.resolveOriginTarget,
-	resolveApproverDmTargets: matrixBaseNativeApprovalAdapter.resolveApproverDmTargets
-};
 const matrixApprovalCapability = createChannelApprovalCapability({
-	authorizeActorAction: (params) => {
-		if (params.approvalKind !== "plugin") return matrixNativeApprovalCapability.authorizeActorAction?.(params) ?? { authorized: true };
+	authorizeActorActionAsync: async (params) => {
+		if (params.approvalKind !== "plugin") return await matrixNativeApprovalCapability.authorizeActorActionAsync?.(params) ?? { authorized: true };
 		if (!hasMatrixPluginApprovers({
 			cfg: params.cfg,
 			accountId: params.accountId
@@ -343,11 +334,11 @@ const matrixApprovalCapability = createChannelApprovalCapability({
 		}));
 		return matrixNativeApprovalCapability.getActionAvailabilityState?.(params) ?? { kind: "disabled" };
 	},
-	getExecInitiatingSurfaceState: (params) => matrixNativeApprovalCapability.getExecInitiatingSurfaceState?.(params) ?? { kind: "disabled" },
+	getExecInitiatingSurfaceStateAsync: async (params) => await matrixNativeApprovalCapability.getExecInitiatingSurfaceStateAsync?.(params) ?? { kind: "disabled" },
 	describeExecApprovalSetup: matrixNativeApprovalCapability.describeExecApprovalSetup,
 	delivery: matrixDeliveryAdapter,
-	nativeRuntime: matrixNativeApprovalCapability.nativeRuntime,
-	native: matrixNativeAdapter,
+	nativeRuntimeAsync: matrixNativeApprovalCapability.nativeRuntimeAsync,
+	nativeAsync: matrixBaseNativeApprovalAdapter,
 	render: matrixNativeApprovalCapability.render
 });
 //#endregion
@@ -447,7 +438,7 @@ function resolveMatrixGroupScope(params) {
 		path: resolveMatrixRoomScopePath({
 			tree,
 			roomId,
-			aliases: groupChannel ? [groupChannel] : []
+			aliases: roomId && groupChannel.toLowerCase() === roomId.toLowerCase() ? [groupChannel] : []
 		})
 	};
 }
@@ -486,7 +477,18 @@ function resolveMatrixDmSessionKey(params) {
 		}
 	});
 }
-function resolveMatrixInboundRoute(params) {
+function resolveMatrixBindingRef(params) {
+	return {
+		channel: "matrix",
+		accountId: params.accountId,
+		conversationId: params.threadId ?? params.roomId,
+		parentConversationId: params.threadId ? params.roomId : void 0
+	};
+}
+async function resolveMatrixInboundRouteAsync(params) {
+	return projectMatrixInboundRoute(params, await inspectConversationBindingAsync(resolveMatrixBindingRef(params)));
+}
+function projectMatrixInboundRoute(params, inspection) {
 	const baseRoute = params.resolveAgentRoute({
 		cfg: params.cfg,
 		channel: "matrix",
@@ -502,13 +504,6 @@ function resolveMatrixInboundRoute(params) {
 	});
 	const bindingConversationId = params.threadId ?? params.roomId;
 	const bindingParentConversationId = params.threadId ? params.roomId : void 0;
-	const bindingRef = {
-		channel: "matrix",
-		accountId: params.accountId,
-		conversationId: bindingConversationId,
-		parentConversationId: bindingParentConversationId
-	};
-	const inspection = inspectConversationBinding(bindingRef);
 	const runtimeRoute = inspectRuntimeConversationBindingRoute({
 		route: baseRoute,
 		inspection
@@ -580,7 +575,7 @@ function resolveMatrixInboundRoute(params) {
 }
 //#endregion
 //#region extensions/matrix/src/matrix/conversation-route-owner.ts
-function resolveMatrixConversationRouteOwner(params) {
+function prepareMatrixConversationRouteOwner(params) {
 	const { cfg, conversation } = params;
 	const accountId = normalizeAccountId(params.accountId);
 	const accountConfig = findMatrixAccountEntry(cfg, accountId);
@@ -588,7 +583,7 @@ function resolveMatrixConversationRouteOwner(params) {
 	const roomId = conversation.nativeChannelId?.trim() || (conversation.kind === "direct" ? "" : conversation.peerId.trim());
 	if (!roomId) return null;
 	const isDirectMessage = conversation.kind === "direct";
-	const result = resolveMatrixInboundRoute({
+	const route = {
 		cfg,
 		accountId,
 		roomId,
@@ -596,18 +591,34 @@ function resolveMatrixConversationRouteOwner(params) {
 		isDirectMessage,
 		threadId: conversation.threadId,
 		resolveAgentRoute
-	});
-	if (!result.bindingOwnerAvailable) return { kind: "unavailable" };
-	if (result.pluginId) return {
-		kind: "plugin",
-		pluginId: result.pluginId,
-		fallbackAgentId: result.route.agentId
 	};
 	return {
-		kind: "agent",
-		agentId: result.route.agentId
+		conversation: resolveMatrixBindingRef(route),
+		resolve(inspection) {
+			const result = projectMatrixInboundRoute(route, inspection);
+			if (!result.bindingOwnerAvailable) return { kind: "unavailable" };
+			if (result.pluginId) return {
+				kind: "plugin",
+				pluginId: result.pluginId,
+				fallbackAgentId: result.route.agentId
+			};
+			return {
+				kind: "agent",
+				agentId: result.route.agentId
+			};
+		}
 	};
 }
+async function prepareMatrixConversationRouteOwnersAsync(inputs, inspectBindings) {
+	const prepared = inputs.map(prepareMatrixConversationRouteOwner);
+	const inspect = await inspectBindings(prepared.flatMap((item) => item ? [item.conversation] : []));
+	let index = 0;
+	return prepared.map((item) => {
+		if (!item) return () => null;
+		const position = index++;
+		return () => item.resolve(inspect()[position]);
+	});
+}
 //#endregion
 //#region extensions/matrix/src/presentation-capabilities.ts
 const matrixPresentationCapabilities = {
@@ -623,7 +634,7 @@ const matrixPresentationCapabilities = {
 };
 //#endregion
 //#region extensions/matrix/src/resolver.ts
-const loadMatrixResolver = createLazyRuntimeNamedExport(() => import("./resolve-targets-BVVbbvP6.mjs").then((n) => n.n), "resolveMatrixTargets");
+const loadMatrixResolver = createLazyRuntimeNamedExport(() => import("./resolve-targets-BJ5sIKeM.mjs").then((n) => n.n), "resolveMatrixTargets");
 const matrixResolverAdapter = { resolveTargets: async (params) => (await loadMatrixResolver())(params) };
 //#endregion
 //#region extensions/matrix/src/matrix/session-store-metadata.ts
@@ -666,12 +677,12 @@ function resolveMatrixDmSessionScope(params) {
 		accountId: params.accountId
 	}).dm?.sessionScope ?? "per-user";
 }
-function resolveMatrixCurrentDmRoomId(params) {
+async function resolveMatrixCurrentDmRoomId(params) {
 	const sessionKey = parseThreadSessionSuffix(params.currentSessionKey).baseSessionKey ?? params.currentSessionKey?.trim();
 	if (!sessionKey) return;
 	try {
 		const storePath = resolveStorePath(params.cfg.session?.store, { agentId: params.agentId });
-		const currentSession = resolveMatrixStoredSessionMeta(getSessionEntry({
+		const currentSession = resolveMatrixStoredSessionMeta(await getSessionEntryAsync({
 			storePath,
 			sessionKey
 		}));
@@ -683,7 +694,7 @@ function resolveMatrixCurrentDmRoomId(params) {
 		return;
 	}
 }
-function resolveMatrixOutboundSessionRoute(params) {
+async function resolveMatrixOutboundSessionRoute(params) {
 	const target = resolveMatrixTargetIdentity(params.resolvedTarget?.to ?? params.target) ?? resolveMatrixTargetIdentity(params.target);
 	if (!target) return null;
 	const effectiveAccountId = resolveEffectiveMatrixAccountId(params);
@@ -691,7 +702,7 @@ function resolveMatrixOutboundSessionRoute(params) {
 		cfg: params.cfg,
 		accountId: effectiveAccountId
 	});
-	const roomScopedDmId = target.kind === "user" && dmSessionScope === "per-room" ? resolveMatrixCurrentDmRoomId({
+	const roomScopedDmId = target.kind === "user" && dmSessionScope === "per-room" ? await resolveMatrixCurrentDmRoomId({
 		cfg: params.cfg,
 		agentId: params.agentId,
 		accountId: effectiveAccountId,
@@ -735,8 +746,8 @@ function resolveMatrixOutboundSessionRoute(params) {
 }
 //#endregion
 //#region extensions/matrix/src/channel.ts
-const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-CUc6rbu1.mjs"), "matrixChannelRuntime");
-const loadMatrixMonitorModule = createLazyRuntimeModule(() => import("./monitor-Dk_fQL1k.mjs").catch((error) => {
+const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-2EEtIlyu.mjs"), "matrixChannelRuntime");
+const loadMatrixMonitorModule = createLazyRuntimeModule(() => import("./monitor-DRUSJ_Ev.mjs").catch((error) => {
 	loadMatrixMonitorModule.clear();
 	throw error;
 }));
@@ -908,7 +919,7 @@ const matrixChannelOutbound = {
 		reconcileUnknownSend: true
 	} },
 	presentationCapabilities: matrixPresentationCapabilities,
-	shouldSuppressLocalPayloadPrompt: shouldSuppressLocalMatrixExecApprovalPrompt,
+	shouldSuppressLocalPayloadPromptAsync: shouldSuppressLocalMatrixExecApprovalPrompt,
 	...createRuntimeOutboundDelegates({
 		getRuntime: loadMatrixChannelRuntime,
 		renderPresentation: {
@@ -966,7 +977,17 @@ const matrixPlugin = createChatChannelPlugin({
 				targetSessionKey,
 				accountId: accountId ?? "",
 				maxAgeMs
-			}).map(projectMatrixConversationBinding)
+			}).map(projectMatrixConversationBinding),
+			setIdleTimeoutBySessionKeyAsync: async ({ targetSessionKey, accountId, idleTimeoutMs }) => (await setMatrixThreadBindingIdleTimeoutBySessionKeyAsync({
+				targetSessionKey,
+				accountId: accountId ?? "",
+				idleTimeoutMs
+			})).map(projectMatrixConversationBinding),
+			setMaxAgeBySessionKeyAsync: async ({ targetSessionKey, accountId, maxAgeMs }) => (await setMatrixThreadBindingMaxAgeBySessionKeyAsync({
+				targetSessionKey,
+				accountId: accountId ?? "",
+				maxAgeMs
+			})).map(projectMatrixConversationBinding)
 		},
 		messaging: {
 			defaultMarkdownTableMode: "block",
@@ -980,7 +1001,7 @@ const matrixPlugin = createChatChannelPlugin({
 			resolveInboundConversation: resolveMatrixInboundConversation,
 			resolveDeliveryTarget: resolveMatrixDeliveryTarget,
 			resolveOutboundSessionRoute: resolveMatrixOutboundSessionRoute,
-			resolveConversationRouteOwner: resolveMatrixConversationRouteOwner,
+			prepareConversationRouteOwnersAsync: prepareMatrixConversationRouteOwnersAsync,
 			targetResolver: {
 				looksLikeId: (raw) => {
 					const trimmed = raw.trim();
@@ -1138,4 +1159,4 @@ const matrixPlugin = createChatChannelPlugin({
 	outbound: matrixChannelOutbound
 });
 //#endregion
-export { resolveMatrixThreadRouting as a, resolveMatrixInboundRoute as i, resolveMatrixStoredSessionMeta as n, resolveMatrixRoomConfig as o, matrixPresentationCapabilities as r, approval_reaction_auth_exports as s, matrixPlugin as t };
+export { resolveMatrixThreadRouting as a, resolveMatrixInboundRouteAsync as i, resolveMatrixStoredSessionMeta as n, resolveMatrixRoomConfig as o, matrixPresentationCapabilities as r, approval_reaction_auth_exports as s, matrixPlugin as t };

package/dist/.setup/{channel.runtime-CUc6rbu1.mjs → channel.runtime-2EEtIlyu.mjs}

@@ -1,14 +1,14 @@
-import { S as reconcileMatrixUnknownSend, o as sendTypingMatrix, r as sendMessageMatrix, x as cleanupMatrixDeliveryPlans } from "./send-LCOuTVc1.mjs";
-import { u as resolveMatrixAuth } from "./client-vPPbaxNp.mjs";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-B1WbfSHo.mjs";
-import { t as matrixOutbound } from "./outbound-LR3SqPIq.mjs";
-import { t as resolveMatrixTargets } from "./resolve-targets-BVVbbvP6.mjs";
+import { S as reconcileMatrixUnknownSend, o as sendTypingMatrix, r as sendMessageMatrix, x as cleanupMatrixDeliveryPlans } from "./send-BprM-Wmx.mjs";
+import { u as resolveMatrixAuth } from "./client-C4Gibhzl.mjs";
+import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-BpSz-FQB.mjs";
+import { t as matrixOutbound } from "./outbound-D5Z_4FBg.mjs";
+import { t as resolveMatrixTargets } from "./resolve-targets-BJ5sIKeM.mjs";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { runChannelProbe } from "openclaw/plugin-sdk/text-utility-runtime";
 //#region extensions/matrix/src/matrix/probe.ts
-const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./client-vPPbaxNp.mjs").then((n) => n.t));
+const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./client-C4Gibhzl.mjs").then((n) => n.t));
 async function probeMatrix(params) {
 	return await runChannelProbe(void 0, async () => {
 		const result = {

package/dist/.setup/{channel.setup-CwuYD_CT.mjs → channel.setup-Be8TYKMA.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.mjs";
-import { _ as resolveMatrixAccount, g as resolveDefaultMatrixAccountId, i as matrixSetupContract, m as listMatrixAccountIds, t as createMatrixSetupWizardProxy, v as resolveMatrixAccountAsync } from "./setup-core-CKnNTfgD.mjs";
+import { _ as resolveMatrixAccount, g as resolveDefaultMatrixAccountId, i as matrixSetupContract, m as listMatrixAccountIds, t as createMatrixSetupWizardProxy, v as resolveMatrixAccountAsync } from "./setup-core-DcCk1_Tv.mjs";
 import { adaptScopedAccountAccessor, createScopedChannelConfigAdapter } from "openclaw/plugin-sdk/channel-config-helpers";
 import { createChannelConfigUiHints } from "openclaw/plugin-sdk/channel-core";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
@@ -70,6 +70,7 @@ const matrixConfigAdapter = {
 	...createScopedChannelConfigAdapter({
 		sectionKey: "matrix",
 		listAccountIds: listMatrixAccountIds,
+		/** @deprecated Use resolveAccountAsync. Final compatibility day: 2026-12-31. */
 		resolveAccount: adaptScopedAccountAccessor(resolveMatrixAccount),
 		resolveAccessorAccount: resolveMatrixAccountConfig,
 		defaultAccountId: resolveDefaultMatrixAccountId,
@@ -314,7 +315,7 @@ const matrixPluginBase = {
 		order: 70,
 		quickstartAllowFrom: true
 	},
-	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./onboarding-CrSexor_.mjs").then((n) => n.n)).matrixOnboardingAdapter })),
+	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./onboarding-CK9Ksgio.mjs").then((n) => n.n)).matrixOnboardingAdapter })),
 	setupContract: matrixSetupContract,
 	capabilities: {
 		chatTypes: [
@@ -346,7 +347,11 @@ const matrixSetupPlugin = {
 	...matrixPluginBase,
 	config: {
 		...matrixPluginBase.config,
-		hasConfiguredState: ({ cfg }) => resolveMatrixAccount({ cfg }).configured,
+		/** @deprecated Use hasConfiguredStateAsync. Final compatibility day: 2026-12-31. */
+		hasConfiguredState: ({ cfg, env }) => resolveMatrixAccount({
+			cfg,
+			env
+		}).configured,
 		hasConfiguredStateAsync: async ({ cfg, env }) => (await resolveMatrixAccountAsync({
 			cfg,
 			env