@openclaw/matrix 2026.8.1-beta.2 → 2026.9.1-beta.1

package/dist/api.js

@@ -1,9 +1,9 @@
 import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-CWuhuFn1.js";
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-dGqak9dN.js";
 import { a as resolveMatrixCredentialsPath, i as resolveMatrixCredentialsFilename, n as resolveMatrixAccountStorageRoot, o as resolveMatrixHomeserverKey, r as resolveMatrixCredentialsDir, s as sanitizeMatrixPathSegment, t as hashMatrixAccessToken } from "./storage-paths-gUmSydsW.js";
-import { t as matrixPlugin } from "./channel-VSrHgTON.js";
-import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-DQn6b5vi.js";
-import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, n as getMatrixThreadBindingManager, p as setMatrixThreadBindingMaxAgeBySessionKey, s as resetMatrixThreadBindingsForTests } from "./thread-bindings-shared-CKnY4LSd.js";
-import { n as matrixOnboardingAdapter } from "./setup-surface-DlhJdrNI.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-CcHZP3w2.js";
-export { createMatrixSetupWizardProxy, createMatrixThreadBindingManager, findMatrixAccountEntry, getMatrixScopedEnvVarNames, getMatrixThreadBindingManager, hashMatrixAccessToken, listMatrixEnvAccountIds, matrixOnboardingAdapter, matrixOnboardingAdapter as matrixSetupWizard, matrixPlugin, matrixSetupAdapter, requiresExplicitMatrixDefaultAccount, resetMatrixThreadBindingsForTests, resolveConfiguredMatrixAccountIds, resolveMatrixAccountStorageRoot, resolveMatrixChannelConfig, resolveMatrixCredentialsDir, resolveMatrixCredentialsFilename, resolveMatrixCredentialsPath, resolveMatrixDefaultOrOnlyAccountId, resolveMatrixEnvAccountToken, resolveMatrixHomeserverKey, sanitizeMatrixPathSegment, setMatrixThreadBindingIdleTimeoutBySessionKey, setMatrixThreadBindingMaxAgeBySessionKey };
+import { t as matrixPlugin } from "./channel-CBEvelTE.js";
+import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-CyvaCOOr.js";
+import { f as setMatrixThreadBindingMaxAgeBySessionKey, n as getMatrixThreadBindingManager, u as setMatrixThreadBindingIdleTimeoutBySessionKey } from "./thread-bindings-shared-oNPiyMWY.js";
+import { n as matrixOnboardingAdapter } from "./setup-surface-DtRvRcCT.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-BvyU66kE.js";
+export { createMatrixSetupWizardProxy, createMatrixThreadBindingManager, findMatrixAccountEntry, getMatrixScopedEnvVarNames, getMatrixThreadBindingManager, hashMatrixAccessToken, listMatrixEnvAccountIds, matrixOnboardingAdapter, matrixOnboardingAdapter as matrixSetupWizard, matrixPlugin, matrixSetupAdapter, requiresExplicitMatrixDefaultAccount, resolveConfiguredMatrixAccountIds, resolveMatrixAccountStorageRoot, resolveMatrixChannelConfig, resolveMatrixCredentialsDir, resolveMatrixCredentialsFilename, resolveMatrixCredentialsPath, resolveMatrixDefaultOrOnlyAccountId, resolveMatrixEnvAccountToken, resolveMatrixHomeserverKey, sanitizeMatrixPathSegment, setMatrixThreadBindingIdleTimeoutBySessionKey, setMatrixThreadBindingMaxAgeBySessionKey };

package/dist/{approval-handler.runtime-CJXCUdRg.js → approval-handler.runtime-G9fLHUWe.js}

@@ -1,9 +1,9 @@
 import { i as resolveMatrixAccount } from "./accounts-BCzyubQt.js";
-import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel-VSrHgTON.js";
-import { a as resolveMatrixTargetIdentity } from "./target-ids-B-5aQxwn.js";
-import { a as sendSingleTextMessageMatrix, n as reactMatrixMessage, r as sendMessageMatrix, w as repairMatrixDirectRooms } from "./send-ZDLU4JTk.js";
+import { C as shouldHandleMatrixApprovalRequest, S as isMatrixAnyApprovalClientEnabled } from "./channel-CBEvelTE.js";
+import { o as resolveMatrixTargetIdentity } from "./target-ids-Nwx7cMVE.js";
+import { a as sendSingleTextMessageMatrix, n as reactMatrixMessage, r as sendMessageMatrix, w as repairMatrixDirectRooms } from "./send-BKu9Ghi4.js";
 import { a as unregisterMatrixApprovalReactionTarget, n as listMatrixApprovalReactionBindings, r as registerMatrixApprovalReactionTarget, t as buildMatrixApprovalReactionHint } from "./approval-reactions-tXh9KYrW.js";
-import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-BW0s-6Y9.js";
+import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-Dow9EOoJ.js";
 import { listMessageReceiptPlatformIds, resolveMessageReceiptPrimaryId } from "openclaw/plugin-sdk/channel-outbound";
 import { normalizeUniqueStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { buildChannelApprovalNativeTargetKey } from "openclaw/plugin-sdk/approval-native-runtime";
@@ -128,6 +128,7 @@ function buildPendingApprovalContent(params) {
 	const allowedDecisions = params.view.actions.map((action) => action.decision);
 	const payload = params.view.approvalKind === "plugin" ? buildPluginApprovalPendingReplyPayload({
 		request: {
+			approvalKind: "plugin",
 			id: params.view.approvalId,
 			request: {
 				title: params.view.title,
@@ -135,7 +136,8 @@ function buildPendingApprovalContent(params) {
 				severity: params.view.severity,
 				toolName: params.view.toolName ?? void 0,
 				pluginId: params.view.pluginId ?? void 0,
-				agentId: params.view.agentId ?? void 0
+				agentId: params.view.agentId ?? void 0,
+				scope: params.view.scope ?? void 0
 			},
 			createdAtMs: 0,
 			expiresAtMs: params.view.expiresAtMs
@@ -153,6 +155,7 @@ function buildPendingApprovalContent(params) {
 		cwd: params.view.cwd ?? void 0,
 		host: params.view.host === "node" ? "node" : "gateway",
 		nodeId: params.view.nodeId ?? void 0,
+		scope: params.view.scope ?? void 0,
 		sessionKey: params.view.sessionKey ?? void 0,
 		expiresAtMs: params.view.expiresAtMs,
 		nowMs: params.nowMs

package/dist/{approval-ids-7rf7etWE.js → approval-ids-C6FD3pVY.js}

@@ -1,4 +1,4 @@
-import { a as normalizeMatrixUserId } from "./channel.setup-PpxRP9Du.js";
+import { a as normalizeMatrixUserId } from "./channel.setup-sWPOGyQG.js";
 //#region extensions/matrix/src/approval-ids.ts
 function normalizeMatrixApproverId(value) {
 	return normalizeMatrixUserId(String(value)) || void 0;

package/dist/{approval-reaction-auth-wBwbEDpZ.js → approval-reaction-auth-60xHiDtQ.js}

@@ -1,5 +1,5 @@
 import { i as resolveMatrixAccount } from "./accounts-BCzyubQt.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-7rf7etWE.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-C6FD3pVY.js";
 import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 //#region extensions/matrix/src/approval-reaction-auth.ts
 function normalizeMatrixExecApproverId(value) {

package/dist/{channel-VSrHgTON.js → channel-CBEvelTE.js}

@@ -1,18 +1,19 @@
 import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-CWuhuFn1.js";
 import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
 import { i as resolveMatrixAccount, r as resolveDefaultMatrixAccountId, t as listMatrixAccountIds } from "./accounts-BCzyubQt.js";
-import { a as normalizeMatrixUserId, r as DEFAULT_ACCOUNT_ID$2, t as matrixPluginBase } from "./channel.setup-PpxRP9Du.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-7rf7etWE.js";
-import { a as resolveMatrixTargetIdentity, i as resolveMatrixDirectUserId, n as normalizeMatrixMessagingTarget, r as normalizeMatrixResolvableTarget, t as isMatrixQualifiedUserId } from "./target-ids-B-5aQxwn.js";
+import { a as normalizeMatrixUserId, r as DEFAULT_ACCOUNT_ID$2, t as matrixPluginBase } from "./channel.setup-sWPOGyQG.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-C6FD3pVY.js";
+import { a as resolveMatrixDirectUserId, i as normalizeMatrixResolvableTarget, n as isMatrixRoomId, o as resolveMatrixTargetIdentity, r as normalizeMatrixMessagingTarget, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
 import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-DEt4O4Zt.js";
-import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, p as setMatrixThreadBindingMaxAgeBySessionKey } from "./thread-bindings-shared-CKnY4LSd.js";
+import { n as MATRIX_REACTION_EVENT_TYPE } from "./reaction-common-DkrQdBSZ.js";
+import { f as setMatrixThreadBindingMaxAgeBySessionKey, u as setMatrixThreadBindingIdleTimeoutBySessionKey } from "./thread-bindings-shared-oNPiyMWY.js";
 import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-CufozuyJ.js";
-import { n as resolveMatrixInboundConversation, t as defaultTopLevelPlacement } from "./thread-binding-api-DRbBZlhS.js";
+import { n as resolveMatrixInboundConversation, t as defaultTopLevelPlacement } from "./thread-binding-api-CzkeLZCU.js";
 import { createLazyRuntimeModule, createLazyRuntimeNamedExport } from "openclaw/plugin-sdk/lazy-runtime";
 import { adaptScopedAccountAccessor, createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import { buildChannelOutboundSessionRoute, buildThreadAwareOutboundSessionRoute, createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createChannelMessageAdapterFromOutbound, createReplyPrefixOptions, createRuntimeOutboundDelegates, createTypingCallbacks, logTypingFailure } from "openclaw/plugin-sdk/channel-outbound";
-import { createAllowlistProviderOpenWarningCollector, projectAccountConfigWarningCollector, resolveScopeRequireMention, resolveScopeToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
+import { createAllowlistProviderOpenWarningCollector, createConditionalWarningCollector, resolveScopeRequireMention, resolveScopeToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
 import { createScopedAccountReplyToModeResolver } from "openclaw/plugin-sdk/conversation-runtime";
 import { createChannelDirectoryAdapter, createResolvedDirectoryEntriesLister, createRuntimeDirectoryLiveAdapter } from "openclaw/plugin-sdk/directory-runtime";
 import { buildProbeChannelStatusSummary, collectStatusIssuesFromLastError, createComputedAccountStatusAdapter, createDefaultChannelRuntimeState } from "openclaw/plugin-sdk/status-helpers";
@@ -31,10 +32,12 @@ import { createChannelExecApprovalProfile, getExecApprovalReplyMetadata, isChann
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
-import { parseThreadSessionSuffix } from "openclaw/plugin-sdk/routing";
+import { buildAgentSessionKey, deriveLastRoutePolicy, parseAgentSessionKey, parseThreadSessionSuffix, resolveAgentIdFromSessionKey, resolveAgentRoute, resolveThreadSessionKeys } from "openclaw/plugin-sdk/routing";
 import { formatLocationText, logInboundDrop, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
 import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/media-local-roots";
 import { buildChannelKeyCandidates } from "openclaw/plugin-sdk/channel-targets";
+import { resolveConfiguredAcpBindingRecord } from "openclaw/plugin-sdk/acp-binding-resolve-runtime";
+import { inspectSessionBindingByConversation } from "openclaw/plugin-sdk/session-binding-runtime";
 import { deliveryContextFromSession, getSessionEntry, resolveStorePath, sessionDeliveryOrigin } from "openclaw/plugin-sdk/session-store-runtime";
 //#region extensions/matrix/src/actions.ts
 const MATRIX_PLUGIN_HANDLED_ACTIONS = /* @__PURE__ */ new Set([
@@ -42,6 +45,7 @@ const MATRIX_PLUGIN_HANDLED_ACTIONS = /* @__PURE__ */ new Set([
 	"poll-vote",
 	"react",
 	"reactions",
+	"emoji-list",
 	"read",
 	"edit",
 	"delete",
@@ -71,6 +75,7 @@ function createMatrixExposedActions(params) {
 	if (params.gate("reactions")) {
 		actions.add("react");
 		actions.add("reactions");
+		actions.add("emoji-list");
 	}
 	if (params.gate("pins")) {
 		actions.add("pin");
@@ -102,6 +107,7 @@ function resolveMatrixActionAccount(params) {
 	return account.enabled && account.configured ? account : null;
 }
 const matrixMessageActions = {
+	providerOwnedReadGates: true,
 	describeMessageTool: ({ cfg, accountId, senderIsOwner }) => {
 		const account = resolveMatrixActionAccount({
 			cfg,
@@ -117,10 +123,16 @@ const matrixMessageActions = {
 			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: listedActions.includes("set-profile") ? buildMatrixProfileToolSchema() : null,
+			schema: schema.length > 1 ? schema : schema[0] ?? null,
 			mediaSourceParams: listedActions.includes("set-profile") ? { "set-profile": MATRIX_PROFILE_MEDIA_SOURCE_PARAMS } : null
 		};
 	},
@@ -137,7 +149,7 @@ const matrixMessageActions = {
 		return account && createActionGate(account.config.actions)("messages") ? payload : null;
 	},
 	handleAction: async (ctx) => {
-		const { handleMatrixAction } = await import("./tool-actions.runtime-DmdRL0bN.js");
+		const { handleMatrixAction } = await import("./tool-actions.runtime-DD6jUxFK.js");
 		const { action, params, cfg, accountId, mediaLocalRoots } = ctx;
 		const dispatch = async (actionParams) => await handleMatrixAction({
 			...actionParams,
@@ -202,6 +214,15 @@ const matrixMessageActions = {
 				limit
 			});
 		}
+		if (action === "emoji-list") {
+			const roomId = readStringParam(params, "roomId") ?? readStringParam(params, "channelId") ?? readStringParam(params, "to") ?? (ctx.toolContext?.currentChannelProvider === "matrix" ? ctx.toolContext.currentChannelId : void 0);
+			if (!roomId) throw new Error("Matrix emoji-list requires a roomId or current Matrix conversation.");
+			return await dispatch({
+				action: "emoji-list",
+				roomId,
+				limit: readPositiveIntegerParam(params, "limit", { message: "limit must be a positive integer." })
+			});
+		}
 		if (action === "read") {
 			const limit = readPositiveIntegerParam(params, "limit", { message: "limit must be a positive integer." });
 			return await dispatch({
@@ -428,6 +449,7 @@ function shouldHandleMatrixApprovalRequest(params) {
 }
 function buildFilterCheckRequest(params) {
 	if (params.metadata.approvalKind === "plugin") return {
+		approvalKind: "plugin",
 		id: params.metadata.approvalId,
 		request: {
 			title: "Plugin Approval Required",
@@ -439,6 +461,7 @@ function buildFilterCheckRequest(params) {
 		expiresAtMs: 0
 	};
 	return {
+		approvalKind: "exec",
 		id: params.metadata.approvalId,
 		request: {
 			command: "",
@@ -603,7 +626,7 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 			approvalKind,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-CJXCUdRg.js")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-G9fLHUWe.js")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
@@ -828,8 +851,195 @@ function resolveMatrixGroupToolPolicy(params) {
 	return resolveScopeToolsPolicy(resolveMatrixGroupScope(params));
 }
 //#endregion
+//#region extensions/matrix/src/matrix/monitor/types.ts
+const EventType = {
+	RoomMessage: "m.room.message",
+	RoomMessageEncrypted: "m.room.encrypted",
+	RoomMember: "m.room.member",
+	Location: "m.location",
+	Reaction: MATRIX_REACTION_EVENT_TYPE
+};
+const RelationType = {
+	Replace: "m.replace",
+	Thread: "m.thread"
+};
+//#endregion
+//#region extensions/matrix/src/matrix/monitor/threads.ts
+function resolveMatrixThreadSessionKeys(params) {
+	return resolveThreadSessionKeys({
+		...params,
+		normalizeThreadId: (threadId) => threadId
+	});
+}
+function resolveMatrixRelatedReplyToEventId(relates) {
+	if (!relates || typeof relates !== "object") return;
+	if ("m.in_reply_to" in relates && typeof relates["m.in_reply_to"] === "object" && relates["m.in_reply_to"] && "event_id" in relates["m.in_reply_to"] && typeof relates["m.in_reply_to"].event_id === "string") return relates["m.in_reply_to"].event_id;
+}
+function resolveMatrixThreadRouting(params) {
+	const effectiveThreadReplies = params.isDirectMessage && params.dmThreadReplies !== void 0 ? params.dmThreadReplies : params.threadReplies;
+	const messageId = params.messageId.trim();
+	const threadRootId = params.threadRootId?.trim();
+	const inboundThreadId = threadRootId && threadRootId !== messageId ? threadRootId : void 0;
+	return { threadId: effectiveThreadReplies === "off" ? void 0 : effectiveThreadReplies === "inbound" ? inboundThreadId : inboundThreadId ?? (messageId || void 0) };
+}
+function resolveMatrixThreadRootId(params) {
+	const relates = params.content["m.relates_to"];
+	if (!relates || typeof relates !== "object") return;
+	if ("rel_type" in relates && relates.rel_type === RelationType.Thread) {
+		if ("event_id" in relates && typeof relates.event_id === "string") return relates.event_id;
+		return resolveMatrixRelatedReplyToEventId(relates);
+	}
+}
+function resolveMatrixReplyToEventId(content) {
+	return resolveMatrixRelatedReplyToEventId(content["m.relates_to"]);
+}
+//#endregion
+//#region extensions/matrix/src/matrix/monitor/route.ts
+function resolveMatrixDmSessionKey(params) {
+	if (params.dmSessionScope !== "per-room") return params.fallbackSessionKey;
+	return buildAgentSessionKey({
+		agentId: params.agentId,
+		channel: "matrix",
+		accountId: params.accountId,
+		peer: {
+			kind: "channel",
+			id: params.roomId
+		}
+	});
+}
+function shouldApplyMatrixPerRoomDmSessionScope(params) {
+	return params.isDirectMessage && !params.configuredSessionKey;
+}
+function resolveMatrixInboundRoute(params) {
+	const baseRoute = params.resolveAgentRoute({
+		cfg: params.cfg,
+		channel: "matrix",
+		accountId: params.accountId,
+		peer: {
+			kind: params.isDirectMessage ? "direct" : "channel",
+			id: params.isDirectMessage ? params.senderId : params.roomId
+		},
+		parentPeer: params.isDirectMessage ? {
+			kind: "channel",
+			id: params.roomId
+		} : void 0
+	});
+	const bindingConversationId = params.threadId ?? params.roomId;
+	const bindingParentConversationId = params.threadId ? params.roomId : void 0;
+	const bindingInspection = inspectSessionBindingByConversation({
+		channel: "matrix",
+		accountId: params.accountId,
+		conversationId: bindingConversationId,
+		parentConversationId: bindingParentConversationId
+	});
+	const runtimeBinding = bindingInspection.status === "available" ? bindingInspection.binding : null;
+	const boundSessionKey = runtimeBinding?.targetSessionKey?.trim();
+	if (runtimeBinding && boundSessionKey) return {
+		route: {
+			...baseRoute,
+			sessionKey: boundSessionKey,
+			agentId: resolveAgentIdFromSessionKey(boundSessionKey) || baseRoute.agentId,
+			lastRoutePolicy: deriveLastRoutePolicy({
+				sessionKey: boundSessionKey,
+				mainSessionKey: baseRoute.mainSessionKey
+			}),
+			matchedBy: "binding.channel"
+		},
+		configuredBinding: null,
+		bindingOwnerAvailable: true,
+		runtimeBindingId: runtimeBinding.bindingId
+	};
+	const configuredBinding = runtimeBinding == null ? resolveConfiguredAcpBindingRecord({
+		cfg: params.cfg,
+		channel: "matrix",
+		accountId: params.accountId,
+		conversationId: bindingConversationId,
+		parentConversationId: bindingParentConversationId
+	}) : null;
+	const configuredSessionKey = configuredBinding?.record.targetSessionKey?.trim();
+	const effectiveRoute = configuredBinding && configuredSessionKey ? {
+		...baseRoute,
+		sessionKey: configuredSessionKey,
+		agentId: resolveAgentIdFromSessionKey(configuredSessionKey) || configuredBinding.spec.agentId || baseRoute.agentId,
+		lastRoutePolicy: deriveLastRoutePolicy({
+			sessionKey: configuredSessionKey,
+			mainSessionKey: baseRoute.mainSessionKey
+		}),
+		matchedBy: "binding.channel"
+	} : baseRoute;
+	const dmSessionKey = shouldApplyMatrixPerRoomDmSessionScope({
+		isDirectMessage: params.isDirectMessage,
+		configuredSessionKey
+	}) ? resolveMatrixDmSessionKey({
+		accountId: params.accountId,
+		agentId: effectiveRoute.agentId,
+		roomId: params.roomId,
+		dmSessionScope: params.dmSessionScope,
+		fallbackSessionKey: effectiveRoute.sessionKey
+	}) : effectiveRoute.sessionKey;
+	const routeWithDmScope = dmSessionKey === effectiveRoute.sessionKey ? effectiveRoute : {
+		...effectiveRoute,
+		sessionKey: dmSessionKey,
+		lastRoutePolicy: "session"
+	};
+	if (!configuredBinding && !configuredSessionKey && params.threadId) {
+		const threadKeys = resolveMatrixThreadSessionKeys({
+			baseSessionKey: routeWithDmScope.sessionKey,
+			threadId: params.threadId,
+			parentSessionKey: routeWithDmScope.sessionKey
+		});
+		return {
+			route: {
+				...routeWithDmScope,
+				sessionKey: threadKeys.sessionKey,
+				mainSessionKey: threadKeys.parentSessionKey ?? routeWithDmScope.sessionKey,
+				lastRoutePolicy: deriveLastRoutePolicy({
+					sessionKey: threadKeys.sessionKey,
+					mainSessionKey: threadKeys.parentSessionKey ?? routeWithDmScope.sessionKey
+				})
+			},
+			configuredBinding,
+			bindingOwnerAvailable: bindingInspection.status === "available",
+			runtimeBindingId: runtimeBinding?.bindingId ?? null
+		};
+	}
+	return {
+		route: routeWithDmScope,
+		configuredBinding,
+		bindingOwnerAvailable: bindingInspection.status === "available",
+		runtimeBindingId: runtimeBinding?.bindingId ?? null
+	};
+}
+//#endregion
+//#region extensions/matrix/src/matrix/conversation-route-owner.ts
+function resolveMatrixConversationRouteOwner(params) {
+	const { cfg, accountId, conversation } = params;
+	const roomId = conversation.nativeChannelId?.trim() || (conversation.kind === "direct" ? "" : conversation.peerId.trim());
+	if (!roomId) return null;
+	const isDirectMessage = conversation.kind === "direct";
+	const result = resolveMatrixInboundRoute({
+		cfg,
+		accountId,
+		roomId,
+		senderId: conversation.peerId,
+		isDirectMessage,
+		dmSessionScope: resolveMatrixAccount({
+			cfg,
+			accountId
+		}).config.dm?.sessionScope,
+		threadId: conversation.threadId,
+		resolveAgentRoute
+	});
+	if (!result.bindingOwnerAvailable) return { kind: "unavailable" };
+	if (result.runtimeBindingId && !parseAgentSessionKey(result.route.sessionKey)?.agentId) return null;
+	return {
+		kind: "agent",
+		agentId: result.route.agentId
+	};
+}
+//#endregion
 //#region extensions/matrix/src/resolver.ts
-const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-LWJELYq5.js"), "matrixResolverRuntime");
+const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-p5qJ3Kst.js"), "matrixResolverRuntime");
 const matrixResolverAdapter = { resolveTargets: async ({ cfg, accountId, inputs, kind, runtime }) => (await loadMatrixChannelRuntime$1()).resolveMatrixTargets({
 	cfg,
 	accountId,
@@ -935,7 +1145,7 @@ function resolveMatrixOutboundSessionRoute(params) {
 			agentId: params.agentId,
 			channel: "matrix",
 			accountId: effectiveAccountId,
-			recipientSessionExact: target.kind === "room" ? dmSessionScope === "per-room" && target.id.startsWith("!") && target.id.includes(":") : dmSessionScope === "per-user" ? isMatrixQualifiedUserId(target.id) : roomScopedDmId !== void 0,
+			recipientSessionExact: target.kind === "room" ? dmSessionScope === "per-room" && isMatrixRoomId(target.id) : dmSessionScope === "per-user" ? isMatrixQualifiedUserId(target.id) : roomScopedDmId !== void 0,
 			peer,
 			chatType,
 			from,
@@ -956,7 +1166,7 @@ function resolveMatrixOutboundSessionRoute(params) {
 //#endregion
 //#region extensions/matrix/src/channel.ts
 let matrixStartupLock = Promise.resolve();
-const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-pOOL0uT_.js"), "matrixChannelRuntime");
+const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-CiDl9deX.js"), "matrixChannelRuntime");
 const loadMatrixDoctorModule = createLazyRuntimeModule(() => import("./doctor-EWf9CDso.js"));
 function buildMatrixTrafficStatusSummary(snapshot) {
 	return {
@@ -1020,7 +1230,7 @@ const resolveMatrixDmPolicy = createScopedDmSecurityResolver({
 	allowFromPathSuffix: "dm.",
 	normalizeEntry: (raw) => normalizeMatrixUserId(raw)
 });
-const collectMatrixSecurityWarnings = createAllowlistProviderOpenWarningCollector({
+const collectMatrixGroupPolicyWarnings = createAllowlistProviderOpenWarningCollector({
 	providerConfigPresent: (cfg) => cfg.channels?.matrix !== void 0,
 	resolveGroupPolicy: (account) => account.config.groupPolicy,
 	buildOpenWarning: {
@@ -1032,18 +1242,28 @@ const collectMatrixSecurityWarnings = createAllowlistProviderOpenWarningCollecto
 function resolveMatrixAccountConfigPath(accountId, field) {
 	return accountId === DEFAULT_ACCOUNT_ID$2 ? `channels.matrix.${field}` : `channels.matrix.accounts.${accountId}.${field}`;
 }
-function collectMatrixSecurityWarningsForAccount(params) {
-	const warnings = collectMatrixSecurityWarnings(params);
+function collectMatrixGroupPolicyWarningsForAccount(params) {
+	const warnings = collectMatrixGroupPolicyWarnings(params);
 	if (params.account.accountId !== DEFAULT_ACCOUNT_ID$2) {
 		const groupPolicyPath = resolveMatrixAccountConfigPath(params.account.accountId, "groupPolicy");
 		const groupsPath = resolveMatrixAccountConfigPath(params.account.accountId, "groups");
 		const groupAllowFromPath = resolveMatrixAccountConfigPath(params.account.accountId, "groupAllowFrom");
 		return warnings.map((warning) => warning.replace("channels.matrix.groupPolicy", groupPolicyPath).replace("channels.matrix.groups", groupsPath).replace("channels.matrix.groupAllowFrom", groupAllowFromPath));
 	}
-	if (params.account.config.autoJoin !== "always") return warnings;
+	return warnings;
+}
+const collectMatrixOpenGroupFindings = createConditionalWarningCollector.findings({
+	collectWarnings: collectMatrixGroupPolicyWarningsForAccount,
+	checkId: "channels.matrix.groups.open",
+	severity: "critical",
+	title: "Matrix security warning"
+});
+function collectMatrixSecurityWarningsForAccount(params) {
+	const findings = collectMatrixOpenGroupFindings(params);
+	if (params.account.accountId !== DEFAULT_ACCOUNT_ID$2 || params.account.config.autoJoin !== "always") return findings;
 	const autoJoinPath = resolveMatrixAccountConfigPath(params.account.accountId, "autoJoin");
 	const autoJoinAllowlistPath = resolveMatrixAccountConfigPath(params.account.accountId, "autoJoinAllowlist");
-	return [...warnings, `- Matrix invites: autoJoin="always" joins any invited room before message policy applies. Set ${autoJoinPath}="allowlist" + ${autoJoinAllowlistPath} (or ${autoJoinPath}="off") to restrict joins.`];
+	return [...findings, `- Matrix invites: autoJoin="always" joins any invited room before message policy applies. Set ${autoJoinPath}="allowlist" + ${autoJoinAllowlistPath} (or ${autoJoinPath}="off") to restrict joins.`];
 }
 function normalizeMatrixAcpConversationId(conversationId) {
 	const target = resolveMatrixTargetIdentity(conversationId);
@@ -1177,6 +1397,7 @@ const matrixPlugin = createChatChannelPlugin({
 		},
 		conversationBindings: {
 			supportsCurrentConversationBinding: true,
+			bindingStore: "adapter",
 			defaultTopLevelPlacement,
 			setIdleTimeoutBySessionKey: ({ targetSessionKey, accountId, idleTimeoutMs }) => setMatrixThreadBindingIdleTimeoutBySessionKey({
 				targetSessionKey,
@@ -1208,6 +1429,7 @@ const matrixPlugin = createChatChannelPlugin({
 				parentConversationId
 			}),
 			resolveOutboundSessionRoute: (params) => resolveMatrixOutboundSessionRoute(params),
+			resolveConversationRouteOwner: resolveMatrixConversationRouteOwner,
 			targetResolver: {
 				looksLikeId: (raw) => {
 					const trimmed = raw.trim();
@@ -1295,7 +1517,7 @@ const matrixPlugin = createChatChannelPlugin({
 			await previousLock;
 			let monitorMatrixProvider;
 			try {
-				monitorMatrixProvider = (await import("./monitor-Ddfc-vjX.js")).monitorMatrixProvider;
+				monitorMatrixProvider = (await import("./monitor-DBB47wTy.js")).monitorMatrixProvider;
 			} finally {
 				releaseLock();
 			}
@@ -1328,7 +1550,10 @@ const matrixPlugin = createChatChannelPlugin({
 	},
 	security: {
 		resolveDmPolicy: resolveMatrixDmPolicy,
-		collectWarnings: projectAccountConfigWarningCollector((cfg) => cfg, collectMatrixSecurityWarningsForAccount)
+		collectWarnings: ({ account, cfg }) => collectMatrixSecurityWarningsForAccount({
+			account,
+			cfg
+		})
 	},
 	pairing: { text: createMatrixPairingText(async (to, message, options) => await (await loadMatrixChannelRuntime()).sendMessageMatrix(to, message, options)) },
 	threading: {
@@ -1362,4 +1587,4 @@ const matrixPlugin = createChatChannelPlugin({
 	outbound: matrixChannelOutbound
 });
 //#endregion
-export { shouldHandleMatrixApprovalRequest as _, buildAllowlistResolutionSummary as a, createTypingCallbacks as c, logInboundDrop as d, logTypingFailure as f, isMatrixAnyApprovalClientEnabled as g, toLocationContext as h, addAllowlistUserEntriesFromConfigEntry as i, formatLocationText as l, summarizeMapping as m, resolveMatrixStoredSessionMeta as n, canonicalizeAllowlistWithResolvedIds as o, patchAllowlistUsersInConfigEntries as p, resolveMatrixRoomConfig as r, createReplyPrefixOptions as s, matrixPlugin as t, getAgentScopedMediaLocalRoots as u };
+export { shouldHandleMatrixApprovalRequest as C, isMatrixAnyApprovalClientEnabled as S, logInboundDrop as _, resolveMatrixThreadRootId as a, summarizeMapping as b, RelationType as c, buildAllowlistResolutionSummary as d, canonicalizeAllowlistWithResolvedIds as f, getAgentScopedMediaLocalRoots as g, formatLocationText as h, resolveMatrixReplyToEventId as i, resolveMatrixRoomConfig as l, createTypingCallbacks as m, resolveMatrixStoredSessionMeta as n, resolveMatrixThreadRouting as o, createReplyPrefixOptions as p, resolveMatrixInboundRoute as r, EventType as s, matrixPlugin as t, addAllowlistUserEntriesFromConfigEntry as u, logTypingFailure as v, toLocationContext as x, patchAllowlistUsersInConfigEntries as y };

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as matrixPlugin } from "./channel-VSrHgTON.js";
+import { t as matrixPlugin } from "./channel-CBEvelTE.js";
 export { matrixPlugin };

package/dist/{channel.runtime-pOOL0uT_.js → channel.runtime-CiDl9deX.js}

@@ -1,19 +1,19 @@
-import { b as reconcileMatrixUnknownSend, i as sendPollMatrix, o as sendTypingMatrix, r as sendMessageMatrix, y as cleanupMatrixDeliveryPlans } from "./send-ZDLU4JTk.js";
+import { b as reconcileMatrixUnknownSend, i as sendPollMatrix, o as sendTypingMatrix, r as sendMessageMatrix, y as cleanupMatrixDeliveryPlans } from "./send-BKu9Ghi4.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { c as resolveMatrixAuth } from "./client-CeGw0G5S.js";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-Bvg2wAnR.js";
-import { p as resolveOutboundSendDep, r as chunkTextForOutbound } from "./runtime-api-BGO16Fu8.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-BJAPY4Vb.js";
+import { c as resolveMatrixAuth } from "./client-hs1ePy2O.js";
+import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-D0KfJlby.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-DXzZwsIY.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
-import { createMessageReceiptFromOutboundResults, createReplyToFanout } from "openclaw/plugin-sdk/channel-outbound";
+import { createMessageReceiptFromOutboundResults, createReplyToFanout, resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
 import { asOptionalRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { chunkTextForOutbound } from "openclaw/plugin-sdk/text-chunking";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { runChannelProbe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { attachChannelToResult } from "openclaw/plugin-sdk/channel-send-result";
 import { renderMessagePresentationFallbackText } from "openclaw/plugin-sdk/interactive-runtime";
 import { resolveSendableOutboundReplyParts, sendPayloadMediaSequence } from "openclaw/plugin-sdk/reply-payload";
 //#region extensions/matrix/src/matrix/probe.ts
-const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./probe.runtime-Dr91B_X3.js").then((runtimeModule) => ({ createMatrixClient: runtimeModule.createMatrixClient })));
+const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./probe.runtime-CRM7RIrB.js").then((runtimeModule) => ({ createMatrixClient: runtimeModule.createMatrixClient })));
 async function probeMatrix(params) {
 	return await runChannelProbe(void 0, async () => {
 		const result = {
@@ -67,6 +67,16 @@ async function probeMatrix(params) {
 const MATRIX_OPENCLAW_PRESENTATION_KEY = "com.openclaw.presentation";
 const MATRIX_OPENCLAW_PRESENTATION_TYPE = "message.presentation";
 const MATRIX_EMPTY_PRESENTATION_FALLBACK_TEXT = "---";
+function toMatrixOutboundResult(result) {
+	const { roomId, ...delivery } = result;
+	return {
+		...delivery,
+		target: {
+			kind: "room",
+			id: roomId
+		}
+	};
+}
 function resolveMatrixChannelData(payload) {
 	const raw = asOptionalRecord(payload.channelData)?.matrix;
 	return asOptionalRecord(raw) ?? {};
@@ -113,7 +123,7 @@ function resolveMatrixExtraContent(payload) {
 }
 function resolveMatrixDeliveryProgress(onDeliveryResult) {
 	return onDeliveryResult ? async (result) => {
-		await onDeliveryResult(attachChannelToResult("matrix", result));
+		await onDeliveryResult(attachChannelToResult("matrix", toMatrixOutboundResult(result)));
 	} : void 0;
 }
 //#endregion
@@ -184,15 +194,15 @@ const matrixChannelRuntime = {
 						...part,
 						index
 					}));
-					return attachChannelToResult("matrix", {
+					return attachChannelToResult("matrix", toMatrixOutboundResult({
 						...lastResult,
 						primaryMessageId: receipt.primaryPlatformMessageId,
 						receipt,
 						content: sentResults.map((result) => result.content).join("\n")
-					});
+					}));
 				}
 			}
-			return attachChannelToResult("matrix", await send(to, payloadText, {
+			return attachChannelToResult("matrix", toMatrixOutboundResult(await send(to, payloadText, {
 				cfg,
 				mediaAccess,
 				mediaLocalRoots,
@@ -207,10 +217,10 @@ const matrixChannelRuntime = {
 				onPlatformSendDispatch,
 				extraContent: resolveMatrixExtraContent(payload),
 				onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
-			}));
+			})));
 		},
 		sendText: async ({ cfg, to, text, deps, replyToId, threadId, accountId, audioAsVoice, deliveryQueueId, deliveryPartIndex, deliveryPartCount, onPlatformSendDispatch, onDeliveryResult }) => {
-			return attachChannelToResult("matrix", await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
+			return attachChannelToResult("matrix", toMatrixOutboundResult(await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
 				cfg,
 				replyToId: replyToId ?? void 0,
 				threadId: threadId !== void 0 && threadId !== null ? String(threadId) : void 0,
@@ -221,10 +231,10 @@ const matrixChannelRuntime = {
 				...deliveryQueueId !== void 0 ? { deliveryPartCount } : {},
 				onPlatformSendDispatch,
 				onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
-			}));
+			})));
 		},
 		sendMedia: async ({ cfg, to, text, mediaUrl, mediaLocalRoots, mediaReadFile, mediaAccess, deps, replyToId, threadId, accountId, audioAsVoice, deliveryQueueId, deliveryPartIndex, deliveryPartCount, onPlatformSendDispatch, onDeliveryResult }) => {
-			return attachChannelToResult("matrix", await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
+			return attachChannelToResult("matrix", toMatrixOutboundResult(await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
 				cfg,
 				mediaUrl,
 				mediaLocalRoots,
@@ -239,7 +249,7 @@ const matrixChannelRuntime = {
 				...deliveryQueueId !== void 0 ? { deliveryPartCount } : {},
 				onPlatformSendDispatch,
 				onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
-			}));
+			})));
 		},
 		sendPoll: async ({ cfg, to, poll, threadId, accountId }) => {
 			const result = await sendPollMatrix(to, poll, {

package/dist/{channel.setup-PpxRP9Du.js → channel.setup-sWPOGyQG.js}

@@ -1,6 +1,6 @@
 import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
 import { i as resolveMatrixAccount, r as resolveDefaultMatrixAccountId, t as listMatrixAccountIds } from "./accounts-BCzyubQt.js";
-import { r as matrixSetupContract, t as createMatrixSetupWizardProxy } from "./setup-core-DQn6b5vi.js";
+import { r as matrixSetupContract, t as createMatrixSetupWizardProxy } from "./setup-core-CyvaCOOr.js";
 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";
@@ -19,13 +19,7 @@ function normalizeMatrixUser(raw) {
 	const value = (raw ?? "").trim();
 	if (!value) return "";
 	if (!value.startsWith("@") || !value.includes(":")) return normalizeLowercaseStringOrEmpty(value);
-	const withoutAt = value.slice(1);
-	const splitIndex = withoutAt.indexOf(":");
-	if (splitIndex === -1) return normalizeLowercaseStringOrEmpty(value);
-	const localpart = normalizeLowercaseStringOrEmpty(withoutAt.slice(0, splitIndex));
-	const server = normalizeLowercaseStringOrEmpty(withoutAt.slice(splitIndex + 1));
-	if (!server) return normalizeLowercaseStringOrEmpty(value);
-	return `@${localpart}:${server}`;
+	return value;
 }
 function normalizeMatrixUserId(raw) {
 	const trimmed = (raw ?? "").trim();
@@ -313,7 +307,7 @@ const matrixPluginBase = {
 		order: 70,
 		quickstartAllowFrom: true
 	},
-	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./setup-surface-DlhJdrNI.js").then((n) => n.t)).matrixSetupWizard })),
+	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./setup-surface-DtRvRcCT.js").then((n) => n.t)).matrixSetupWizard })),
 	setupContract: matrixSetupContract,
 	capabilities: {
 		chatTypes: [